Merge branch 'master' into docs/update-migration-page

Author: Tony133

.github/workflows/lighthouse.yml

@@ -11,10 +11,10 @@ jobs:
 
     steps:
       - uses: actions/checkout@v3
-      - name: Use Node.js 12.x
+      - name: Use Node.js 16.x
         uses: actions/setup-node@v3
         with:
-          node-version: 12.x
+          node-version: 16.x
       # Build needs around 400 seconds on Netlify.
       # We can not rely on "Waiting for 200", since the user
       # might push another commit to an existing PR, meaning

angular.json

@@ -27,8 +27,7 @@
               "src/_redirects"
             ],
             "styles": [
-              "src/styles.scss",
-              "src/assets/css/perfect-scrollbar.min.css"
+              "src/styles.scss"
             ]
           },
           "configurations": {
@@ -110,31 +109,6 @@
           }
         }
       }
-    },
-    "docs.nestjs.com-e2e": {
-      "root": "e2e",
-      "sourceRoot": "e2e",
-      "projectType": "application",
-      "architect": {
-        "e2e": {
-          "builder": "@angular-devkit/build-angular:protractor",
-          "options": {
-            "protractorConfig": "./protractor.conf.js",
-            "devServerTarget": "docs.nestjs.com:serve"
-          }
-        },
-        "lint": {
-          "builder": "@angular-devkit/build-angular:tslint",
-          "options": {
-            "tsConfig": [
-              "e2e/tsconfig.e2e.json"
-            ],
-            "exclude": [
-              "**/node_modules/**"
-            ]
-          }
-        }
-      }
     }
   },
   "defaultProject": "docs.nestjs.com",

content/cli/workspaces.md

@@ -192,7 +192,7 @@ These properties specify the compiler to use as well as various options that aff
 | `assets`            | array               | Enables automatically distributing non-TypeScript assets whenever a compilation step begins (asset distribution does **not** happen on incremental compiles in `--watch` mode). See below for details.                                                                    |
 | `watchAssets`       | boolean             | If `true`, run in watch-mode, watching **all** non-TypeScript assets. (For more fine-grained control of the assets to watch, see [Assets](cli/monorepo#assets) section below).                                                                                            |
 | `manualRestart`     | boolean             | If `true`, enables the shortcut `rs` to manually restart the server. Default value is `false`.                                                                                                                                                                            |
-| `builder`           | string              | Instructs CLI on what `builder` to use to compile the project (`tsc`, `swc`, or `webpack`)                                                                                                                                                                                |
+| `builder`           | string/object       | Instructs CLI on what `builder` to use to compile the project (`tsc`, `swc`, or `webpack`). To customize builder's behavior, you can pass an object containing two attributes: `type` (`tsc`, `swc`, or `webpack`) and `options`.                                         |
 | `typeCheck`         | boolean             | If `true`, enables type checking for SWC-driven projects (when `builder` is `swc`). Default value is `false`.                                                                                                                                                             |
 
 #### Global generate options

content/controllers.md

@@ -202,6 +202,8 @@ findAll() {
 
 The `'ab*cd'` route path will match `abcd`, `ab_cd`, `abecd`, and so on. The characters `?`, `+`, `*`, and `()` may be used in a route path, and are subsets of their regular expression counterparts. The hyphen ( `-`) and the dot (`.`) are interpreted literally by string-based paths.
 
+> warning **Warning** A wildcard in the middle of the route is only supported by express.
+
 #### Status code
 
 As mentioned, the response **status code** is always **200** by default, except for POST requests which are **201**. We can easily change this behavior by adding the `@HttpCode(...)` decorator at a handler level.
@@ -510,8 +512,6 @@ export class AppModule {}
 
 We attached the metadata to the module class using the `@Module()` decorator, and Nest can now easily reflect which controllers have to be mounted.
 
-<app-banner-shop></app-banner-shop>
-
 #### Library-specific approach
 
 So far we've discussed the Nest standard way of manipulating responses. The second way of manipulating the response is to use a library-specific [response object](https://expressjs.com/en/api.html#res). In order to inject a particular response object, we need to use the `@Res()` decorator. To show the differences, let's rewrite the `CatsController` to the following:

content/devtools/overview.md

@@ -191,7 +191,7 @@ fs.writeFileSync('./graph.json', app.get(SerializedGraph).toString());
 
 > info **Hint** `SerializedGraph` is exported from the `@nestjs/core` package.
 
-Then you can drag and drop this/upload this file:
+Then you can drag and drop/upload this file:
 
 <figure><img src="/assets/devtools/drag-and-drop.png" /></figure>
 

content/discover/who-uses.json

@@ -36,169 +36,57 @@
       "url": "https://www.neo4j.com/"
     },
     {
-      "logo": "/assets/logo/shipt.png",
-      "url": "https://www.shipt.com/"
-    },
-    {
-      "logo": "/assets/logo/sanofi.png",
-      "url": "https://github.com/Sanofi-IADC"
-    },
-    {
-      "logo": "https://nestjs.com/img/valor-software.png",
-      "url": "https://valor-software.com/"
-    },
-    {
-      "logo": "/assets/logo/sitepen.svg",
-      "url": "https://sitepen.com"
-    },
-    {
-      "logo": "https://nestjs.com/img/gojob-logo.png",
-      "url": "https://gojob.com/",
-      "width": "100px"
-    },
-    {
-      "logo": "https://nestjs.com/img/neoteric.png",
-      "url": "https://neoteric.eu/"
-    },
-    {
-      "logo": "/assets/logo/trellis.png",
-      "url": "https://trellis.org/",
-      "width": "70px"
+      "logo": "/assets/logo/bmw.svg",
+      "url": "https://bmw.com"
     },
     {
-      "logo": "https://nestjs.com/img/scalio-logo.svg",
-      "url": "https://scal.io",
-      "width": "120px"
-    },
-    {
-      "logo": "https://nestjs.com/img/swingdev-logo.svg",
-      "url": "https://swingdev.io/"
-    },
-    {
-      "logo": "/assets/logo/cultura-colectiva.png",
-      "url": "https://culturacolectiva.com",
-      "width": "90px"
-    },
-    {
-      "logo": "https://nestjs.com/img/trilon.png",
-      "url": "https://trilon.io"
+      "logo": "/assets/logo/gitlab.png",
+      "url": "https://gitlab.com/"
     },
     {
-      "logo": "/assets/logo/architectnow.png",
-      "url": "http://architectnow.net",
-      "width": "150px"
+      "logo": "/assets/logo/ibm.svg",
+      "url": "https://www.ibm.com/"
     },
     {
-      "logo": "/assets/logo/iflix.svg",
-      "url": "https://www.iflix.com",
-      "width": "70px"
+      "logo": "/assets/logo/jetbrains.svg",
+      "url": "https://www.jetbrains.com/"
     },
     {
-      "logo": "https://nestjs.com/img/genuinebee.svg",
-      "url": "https://genuinebee.com/"
+      "logo": "/assets/logo/mercedes.png",
+      "url": "https://www.mercedes-benz.com/"
     },
     {
-      "logo": "/assets/logo/run-players-league.png",
-      "url": "https://runplayersleague.com",
-      "width": "80px"
+      "logo": "/assets/logo/totalenergies.svg",
+      "url": "https://totalenergies.com/"
     },
     {
-      "logo": "/assets/logo/yanrongyun.svg",
-      "url": "http://www.yanrongyun.com",
-      "width": "120px"
+      "logo": "/assets/logo/bytedance.png",
+      "url": "https://www.bytedance.com"
     },
     {
-      "logo": "/assets/logo/sclable.svg",
-      "url": "https://sclable.com",
-      "width": "120px"
-    },
-    {
-      "logo": "/assets/logo/dozto.png",
-      "url": "https://www.dozto.com",
-      "width": "117px"
-    },
-    {
-      "logo": "/assets/logo/qingtui.png",
-      "url": "https://www.qingtui.cn/",
-      "width": "90px"
+      "logo": "/assets/logo/ibm.svg",
+      "url": "https://www.ibm.com/"
     },
     {
-      "logo": "/assets/logo/crowdlinker.svg",
-      "url": "https://crowdlinker.com/",
-      "width": "110px"
-    },
-    {
-      "logo": "/assets/logo/nothing.svg",
-      "url": "https://nothing.ch/",
-      "width": "110px"
-    },
-    {
-      "logo": "/assets/logo/swissdevjobs-devops-logo.png",
-      "url": "https://swissdevjobs.ch/jobs/Dev-Ops/All",
-      "width": "65px"
-    },
-    {
-      "logo": "/assets/logo/zeoagency.svg",
-      "url": "https://zeo.org/tr/",
-      "width": "80px"
-    },
-    {
-      "logo": "/assets/logo/valueadd.png",
-      "url": "https://valueadd.pl/",
-      "width": "120px"
-    },
-    {
-      "logo": "/assets/logo/bedu.svg",
-      "url": "https://bedu.org",
-      "width": "100px"
-    },
-    {
-      "logo": "/assets/logo/shopback.png",
-      "url": "https://shopback.com",
-      "width": "100px"
-    },
-    {
-      "logo": "/assets/logo/facile.png",
-      "url": "https://www.facile.it",
-      "width": "100px"
-    },
-    {
-      "logo": "/assets/logo/interfacewerk.png",
-      "url": "https://interfacewerk.de",
-      "width": "130px"
-    },
-    {
-      "logo": "/assets/logo/ottonova.png",
-      "url": "https://www.ottonova.de",
-      "width": "130px"
+      "logo": "/assets/logo/shipt.png",
+      "url": "https://www.shipt.com/"
     },
     {
-      "logo": "/assets/logo/radity.png",
-      "url": "https://radity.com",
-      "width": "120px"
+      "logo": "/assets/logo/sanofi.png",
+      "url": "https://github.com/Sanofi-IADC"
     },
     {
-      "logo": "/assets/logo/global-cto-forum.png",
-      "url": "https://globalctoforum.org/",
-      "width": "120px"
+      "logo": "/assets/logo/sitepen.svg",
+      "url": "https://sitepen.com"
     },
     {
-      "logo": "/assets/logo/rivvy.png",
-      "url": "https://rivvy.app",
-      "width": "120px"
+      "logo": "https://nestjs.com/img/trilon.png",
+      "url": "https://trilon.io"
     },
     {
       "logo": "/assets/logo/vue-storefront.png",
       "url": "https://www.vuestorefront.io/"
     },
-    {
-      "logo": "/assets/logo/fuse-logo.svg",
-      "url": "https://fuseautotech.com"
-    },
-    {
-      "logo": "/assets/logo/amplication.svg",
-      "url": "https://amplication.com"
-    },
     {
       "logo": "/assets/logo/hingehealth.png",
       "url": "https://hingehealth.com",
@@ -280,6 +168,8 @@
     "https://tarken.com.br",
     "https://remato.com",
     "https://remberg.de/en",
-    "https://uninterrupted.tech"
+    "https://uninterrupted.tech",
+    "https://www.digando.com",
+    "https://novu.co"
   ]
 }

content/exception-filters.md

@@ -260,7 +260,8 @@ async create(createCatDto) {
 
 > info **Hint** Prefer applying filters by using classes instead of instances when possible. It reduces **memory usage** since Nest can easily reuse instances of the same class across your entire module.
 
-In the example above, the `HttpExceptionFilter` is applied only to the single `create()` route handler, making it method-scoped. Exception filters can be scoped at different levels: method-scoped, controller-scoped, or global-scoped. For example, to set up a filter as controller-scoped, you would do the following:
+In the example above, the `HttpExceptionFilter` is applied only to the single `create()` route handler, making it method-scoped. Exception filters can be scoped at different levels: method-scoped of the controller/resolver/gateway, controller-scoped, or global-scoped.  
+For example, to set up a filter as controller-scoped, you would do the following:
 
 ```typescript
 @@filename(cats.controller)

content/faq/multiple-servers.md

@@ -39,8 +39,41 @@ const app = await NestFactory.create(
 );
 await app.init();
 
-http.createServer(server).listen(3000);
-https.createServer(httpsOptions, server).listen(443);
+const httpServer = http.createServer(server).listen(3000);
+const httpsServer = https.createServer(httpsOptions, server).listen(443);
+```
+
+Because we called `http.createServer` / `https.createServer` ourselves, NestJS doesn't close them when calling `app.close` / on termination signal. We need to do this ourselves:
+
+```typescript
+@Injectable()
+export class ShutdownObserver implements OnApplicationShutdown {
+  private httpServers: http.Server[] = [];
+
+  public addHttpServer(server: http.Server): void {
+    this.httpServers.push(server);
+  }
+
+  public async onApplicationShutdown(): Promise<void> {
+    await Promise.all(
+      this.httpServers.map((server) =>
+        new Promise((resolve, reject) => {
+          server.close((error) => {
+            if (error) {
+              reject(error);
+            } else {
+              resolve(null);
+            }
+          });
+        })
+      ),
+    );
+  }
+}
+
+const shutdownObserver = app.get(ShutdownObserver);
+shutdownObserver.addHttpServer(httpServer);
+shutdownObserver.addHttpServer(httpsServer);
 ```
 
 > info **Hint** The `ExpressAdapter` is imported from the `@nestjs/platform-express` package. The `http` and `https` packages are native Node.js packages.

content/first-steps.md

@@ -114,3 +114,21 @@ $ npm run start:dev
 ```
 
 This command will watch your files, automatically recompiling and reloading the server.
+
+#### Linting and formatting
+
+[CLI](/cli/overview) provides best effort to scaffold a reliable development workflow at scale. Thus, a generated Nest project comes with both a code **linter** and **formatter** preinstalled (respectively [eslint](https://eslint.org/) and [prettier](https://prettier.io/)).
+
+> info **Hint** Not sure about the role of formatters vs linters? Learn the difference [here](https://prettier.io/docs/en/comparison.html).
+
+To ensure maximum stability and extensibility, we use the base [`eslint`](https://www.npmjs.com/package/eslint) and [`prettier`](https://www.npmjs.com/package/prettier) cli packages. This setup allows neat IDE integration with official extensions by design.
+
+For headless environments where an IDE is not relevant (Continuous Integration, Git hooks, etc.) a Nest project comes with ready-to-use `npm` scripts.
+
+```bash
+# Lint and autofix with eslint
+$ npm run lint
+
+# Format with prettier
+$ npm run format
+```