chore(@nestjs) publish v10.2.8 release

chore(deps-dev): bump @nestjs/apollo from 12.0.4 to 12.0.9

.circleci/config.yml

@@ -1,9 +1,31 @@
-version: 2
+version: 2.1
+
+parameters:
+  check-legacy-node-version:
+    type: boolean
+    default: false
+  legacy-node-version:
+    type: string
+    default: '14.21.3'
+  maintenance-node-version:
+    type: string
+    default: '16.20'
+  active-node-version:
+    type: string
+    default: '18.17'
+  current-node-version:
+    type: string
+    default: '20.5'
 
 aliases:
   - &restore-cache
     restore_cache:
       key: dependency-cache-{{ checksum "package.json" }}
+  - &save-cache
+    save_cache:
+      key: dependency-cache-{{ checksum "package.json" }}
+      paths:
+        - ./node_modules
   - &install-deps
     run:
       name: Install dependencies
@@ -17,70 +39,89 @@ aliases:
       name: Test
       command: npm run test
 
-unit-tests-template: &unit-tests-template
-  working_directory: ~/nest
-  steps:
-    - checkout
-    - *restore-cache
-    - *install-deps
-    - *build-packages
-    - *run-unit-tests
-
 jobs:
   build:
     working_directory: ~/nest
     docker:
-      - image: cimg/node:16.20
+      - image: cimg/node:<< pipeline.parameters.maintenance-node-version >>
     steps:
       - checkout
       - run:
           name: Update NPM version
-          command: 'sudo npm install -g npm@^8'
-      - restore_cache:
-          key: dependency-cache-{{ checksum "package.json" }}
-      - run:
-          name: Install dependencies
-          command: npm ci --legacy-peer-deps
-      - save_cache:
-          key: dependency-cache-{{ checksum "package.json" }}
-          paths:
-            - ./node_modules
-      - run:
-          name: Build
-          command: npm run build
-
-  test_node_16:
-    working_directory: ~/nest
-    docker:
-      - image: cimg/node:16.20
-    steps:
-      - checkout
+          command: 'sudo npm install -g npm@^9'
       - *restore-cache
       - *install-deps
+      - *save-cache
       - *build-packages
-      - run:
-          name: Test (coverage)
-          command: npm run test:cov
-      - run:
-          name: Collect coverage
-          command: npm run coverage
-      - store_artifacts:
-          path: coverage
 
-  test_node_18:
-    <<: *unit-tests-template
+  test:
+    parameters:
+      node-version:
+        type: string
+    working_directory: ~/nest
     docker:
-      - image: cimg/node:18.16
-
-  test_node_19:
-    <<: *unit-tests-template
-    docker:
-      - image: cimg/node:19.9
+      - image: cimg/node:<< parameters.node-version >>
+    steps:
+      - when:
+          condition:
+            and:
+              - equal:
+                  [
+                    '<< parameters.node-version >>',
+                    '<< pipeline.parameters.legacy-node-version >>',
+                  ]
+              - not: << pipeline.parameters.check-legacy-node-version >>
+          steps:
+            - run:
+                name: Skip
+                command: |
+                  echo Skipping
+      - when:
+          condition:
+            or:
+              - not:
+                  equal:
+                    [
+                      '<< parameters.node-version >>',
+                      '<< pipeline.parameters.legacy-node-version >>',
+                    ]
+              - << pipeline.parameters.check-legacy-node-version >>
+          steps:
+            - checkout
+            - *restore-cache
+            - *install-deps
+            - *build-packages
+            - when:
+                condition:
+                  equal:
+                    [
+                      '<< parameters.node-version >>',
+                      '<< pipeline.parameters.maintenance-node-version >>',
+                    ]
+                steps:
+                  - run:
+                      name: Test (coverage)
+                      command: npm run test:cov
+                  - run:
+                      name: Collect coverage
+                      command: npm run coverage
+                  - store_artifacts:
+                      path: coverage
+            - when:
+                condition:
+                  not:
+                    equal:
+                      [
+                        '<< parameters.node-version >>',
+                        '<< pipeline.parameters.maintenance-node-version >>',
+                      ]
+                steps:
+                  - *run-unit-tests
 
   lint:
     working_directory: ~/nest
     docker:
-      - image: circleci/node:16
+      - image: cimg/node:<< pipeline.parameters.maintenance-node-version >>
     steps:
       - checkout
       - *restore-cache
@@ -105,9 +146,9 @@ jobs:
       - run:
           name: Upgrade Node.js
           command: |
-            nvm install v16
+            nvm install << pipeline.parameters.maintenance-node-version >>
             node -v
-            nvm alias default v16
+            nvm alias default << pipeline.parameters.maintenance-node-version >>
       - run:
           name: Install Docker Compose
           command: |
@@ -130,7 +171,7 @@ jobs:
   codechecks_benchmarks:
     working_directory: ~/nest
     docker:
-      - image: cimg/node:16.20
+      - image: cimg/node:<< pipeline.parameters.maintenance-node-version >>
     steps:
       - checkout
       - *restore-cache
@@ -146,9 +187,9 @@ jobs:
   samples:
     working_directory: ~/nest
     docker:
-      - image: cimg/node:16.20
+      - image: cimg/node:<< pipeline.parameters.maintenance-node-version >>
     environment:
-      - DISABLE_OPENCOLLECTIVE: true
+      DISABLE_OPENCOLLECTIVE: 'true'
     steps:
       - checkout
       - *restore-cache
@@ -158,16 +199,21 @@ jobs:
           command: npm run build:samples
 
 workflows:
-  version: 2
   build-and-test:
     jobs:
       - build
-      - test_node_16:
-          requires:
-            - build
-      - test_node_18:
+      - test:
           requires:
             - build
+          matrix:
+            parameters:
+              node-version:
+                [
+                  '<< pipeline.parameters.legacy-node-version >>',
+                  '<< pipeline.parameters.maintenance-node-version >>',
+                  '<< pipeline.parameters.active-node-version >>',
+                  '<< pipeline.parameters.current-node-version >>',
+                ]
       - lint:
           requires:
             - build

.eslintrc.js

@@ -23,6 +23,7 @@ module.exports = {
         '@typescript-eslint/explicit-module-boundary-types': 'off',
         '@typescript-eslint/no-unused-vars': 'off',
         '@typescript-eslint/ban-types': 'off',
+        '@typescript-eslint/no-array-constructor': 'off',
       },
     },
     {

.github/ISSUE_TEMPLATE/Bug_report.yml

@@ -46,7 +46,7 @@ body:
       label: "Steps to reproduce"
       description: |
         How the issue manifests?
-        You could leave this blank if you alread write this in your reproduction code
+        You could leave this blank if you already write this in your reproduction code
       placeholder: |
         1. `npm ci`
         2. `npm start:dev`

.github/workflows/codeql-analysis.yml

@@ -21,7 +21,7 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
       with:
         # We must fetch at least the immediate parents so that if this is
         # a pull request then we can checkout the head.

CONTRIBUTING.md

@@ -164,7 +164,7 @@ You will need [Node.js](https://nodejs.org) version >= 10.13.0 (except for v13).
 1. After cloning the repo, run:
 
 ```bash
-$ npm ci # (or yarn install)
+$ npm ci --legacy-peer-deps # (or yarn install)
 ```
 
 2. In order to prepare your environment run `prepare.sh` shell script:

Readme.md

@@ -23,7 +23,7 @@
 
 ## Description
 
-Nest is a framework for building efficient, scalable <a href="https://nodejs.org" target="_blank">Node.js</a> server-side applications. It uses modern JavaScript, is built with  <a href="https://www.typescriptlang.org" target="_blank">TypeScript</a> (preserves compatibility with pure JavaScript) and combines elements of OOP (Object Oriented Programming), FP (Functional Programming), and FRP (Functional Reactive Programming).
+Nest is a framework for building efficient, scalable <a href="https://nodejs.org" target="_blank">Node.js</a> server-side applications. It uses modern JavaScript, is built with <a href="https://www.typescriptlang.org" target="_blank">TypeScript</a> (preserves compatibility with pure JavaScript) and combines elements of OOP (Object Oriented Programming), FP (Functional Programming), and FRP (Functional Reactive Programming).
 
 <p>Under the hood, Nest makes use of <a href="https://expressjs.com/" target="_blank">Express</a>, but also, provides compatibility with a wide range of other libraries, like e.g. <a href="https://github.com/fastify/fastify" target="_blank">Fastify</a>, allowing for easy use of the myriad third-party plugins which are available.</p>
 
@@ -34,10 +34,10 @@ Nest is a framework for building efficient, scalable <a href="https://nodejs.org
 
 ## Getting started
 
-* To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
-* 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:
-* [가이드](readme_kr.md) 문서는 [docs.nestjs.com](https://docs.nestjs.com)에서 확인하실 수 있습니다. :books:
-* [ガイド](readme_jp.md)は [docs.nestjs.com](https://docs.nestjs.com)でご確認ください。 :books:
+- To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
+- 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:
+- [가이드](readme_kr.md) 문서는 [docs.nestjs.com](https://docs.nestjs.com)에서 확인하실 수 있습니다. :books:
+- [ガイド](readme_jp.md)は [docs.nestjs.com](https://docs.nestjs.com)でご確認ください。 :books:
 
 ## Questions
 
@@ -56,10 +56,13 @@ With official support, you can get expert help straight from Nest core team. We
 Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support from the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support).
 
 #### Principal Sponsors
+
 <table style="text-align:center;"><tr>
   <td><a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="200" valign="middle" /></a></td>
     <td>
 <a href="https://valor-software.com/" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="170" valign="middle" /></a></td>
+<td>
+<a href="https://amplication.com/" target="_blank"><img src="https://nestjs.com/img/amplication-logo.svg" width="190" valign="middle" /></a></td>
 </tr></table>
 
 #### Gold Sponsors
@@ -69,8 +72,7 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <td>
 <a href="https://github.com/Sanofi-IADC" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/sanofi.png" width="180" valign="middle" /></a></td>
 <td>
-<a href="https://nx.dev" target="_blank"><img src="https://nestjs.com/img/nx-logo.png" height="45" valign="middle" /></a></td><td>
-  <a href="https://amplication.com/" target="_blank"><img src="https://nestjs.com/img/amplication-logo.svg" width="190" valign="middle" /></a></td>
+<a href="https://nx.dev" target="_blank"><img src="https://nestjs.com/img/nx-logo.png" height="45" valign="middle" /></a></td>
   <td>
 <a href="https://weld.app/" target="_blank"><img src="https://nestjs.com/img/weld-logo.svg" width="140" valign="middle" /></a></td>
 <td>
@@ -86,7 +88,10 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 #### Silver Sponsors
 
 <table style="text-align:center;"><tr>
-<td><a href="https://n.inc" target="_blank"><img src="https://nestjs.com/img/n-inc-logo.svg" width="120" valign="middle" /></td></tr>
+<td><a href="https://n.inc" target="_blank"><img src="https://nestjs.com/img/n-inc-logo.svg" width="120" valign="middle" /></td>
+<td><a href="https://twistag.com/" target="_blank"><img src="https://nestjs.com/img/twistag-logo.png" width="120" valign="middle" /></td>
+<td><a href="https://immediateedgeapp.org/" target="_blank"><img src="https://nestjs.com/img/immediate-edge-logo.png" width="120" valign="middle" /></td>
+</tr>
 </table>
 
 #### Sponsors
@@ -111,6 +116,9 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
  <td align="center" valign="middle"><a href="https://nordbot.app/" target="_blank"><img src="https://nestjs.com/img/nordbot-logo.png" width="120" valign="middle" /></a></td></tr><tr>
  <td align="center" valign="middle"><a href="https://doppio.sh/" target="_blank"><img src="https://nestjs.com/img/dopiosh-logo.png" width="50" valign="middle" /></a></td>
    <td align="center" valign="middle"><a href="https://www.hingehealth.com/" target="_blank"><img src="https://nestjs.com/img/hinge-health-logo.svg" width="100" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://julienferand.dev/" target="_blank"><img src="https://nestjs.com/img/julienferand-logo.jpeg" width="65" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://www.tripoffice.com/" target="_blank"><img src="https://nestjs.com/img/tripoffice-logo.png" width="140" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://solcellsforetag.se/" target="_blank"><img src="https://nestjs.com/img/solcellsforetag-logo.svg" width="140" valign="middle" /></a></td>
   </tr></table>
 
 ## Backers
@@ -119,9 +127,9 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 
 ## Stay in touch
 
-* Author - [Kamil Myśliwiec](https://twitter.com/kammysliwiec)
-* Website - [https://nestjs.com](https://nestjs.com/)
-* Twitter - [@nestframework](https://twitter.com/nestframework)
+- Author - [Kamil Myśliwiec](https://x.com/kammysliwiec)
+- Website - [https://nestjs.com](https://nestjs.com/)
+- X - [@nestframework](https://x.com/nestframework)
 
 ## License
 

integration/discovery/e2e/discover-by-meta.spec.ts

@@ -0,0 +1,59 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { DiscoveryService } from '@nestjs/core';
+import { expect } from 'chai';
+import { AppModule } from '../src/app.module';
+import { WebhooksExplorer } from '../src/webhooks.explorer';
+import { NonAppliedDecorator } from '../src/decorators/non-applied.decorator';
+
+describe('DiscoveryModule', () => {
+  let moduleRef: TestingModule;
+
+  beforeEach(async () => {
+    moduleRef = await Test.createTestingModule({
+      imports: [AppModule],
+    }).compile();
+  });
+
+  it('should discover all providers & handlers with corresponding annotations', async () => {
+    const webhooksExplorer = moduleRef.get(WebhooksExplorer);
+
+    expect(webhooksExplorer.getWebhooks()).to.be.eql([
+      {
+        handlers: [
+          {
+            event: 'start',
+            methodName: 'onStart',
+          },
+        ],
+        name: 'cleanup',
+      },
+      {
+        handlers: [
+          {
+            event: 'start',
+            methodName: 'onStart',
+          },
+        ],
+        name: 'flush',
+      },
+    ]);
+  });
+
+  it('should return an empty array if no providers were found for a given discoverable decorator', () => {
+    const discoveryService = moduleRef.get(DiscoveryService);
+
+    const providers = discoveryService.getProviders({
+      metadataKey: NonAppliedDecorator.KEY,
+    });
+    expect(providers).to.be.eql([]);
+  });
+
+  it('should return an empty array if no controllers were found for a given discoverable decorator', () => {
+    const discoveryService = moduleRef.get(DiscoveryService);
+
+    const controllers = discoveryService.getControllers({
+      metadataKey: NonAppliedDecorator.KEY,
+    });
+    expect(controllers).to.be.eql([]);
+  });
+});

integration/discovery/src/app.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+import { DiscoveryModule } from '@nestjs/core';
+import { MyWebhookModule } from './my-webhook/my-webhook.module';
+import { WebhooksExplorer } from './webhooks.explorer';
+
+@Module({
+  imports: [MyWebhookModule, DiscoveryModule],
+  providers: [WebhooksExplorer],
+})
+export class AppModule {}

integration/discovery/src/decorators/non-applied.decorator.ts

@@ -0,0 +1,9 @@
+import { DiscoveryService } from '@nestjs/core';
+
+/**
+ * This decorator must not be used anywhere!
+ *
+ * This will be used to test the scenario where we are trying to retrieving
+ * metadata for a discoverable decorator that was not applied to any class.
+ */
+export const NonAppliedDecorator = DiscoveryService.createDecorator();

integration/discovery/src/decorators/webhook.decorators.ts

@@ -0,0 +1,6 @@
+import { DiscoveryService } from '@nestjs/core';
+
+export const Webhook = DiscoveryService.createDecorator<{ name: string }>();
+export const WebhookHandler = DiscoveryService.createDecorator<{
+  event: string;
+}>();

integration/discovery/src/my-webhook/cleanup.webhook.ts

@@ -0,0 +1,9 @@
+import { Webhook, WebhookHandler } from '../decorators/webhook.decorators';
+
+@Webhook({ name: 'cleanup' })
+export class CleanupWebhook {
+  @WebhookHandler({ event: 'start' })
+  onStart() {
+    console.log('cleanup started');
+  }
+}

integration/discovery/src/my-webhook/flush.webhook.ts

@@ -0,0 +1,9 @@
+import { Webhook, WebhookHandler } from '../decorators/webhook.decorators';
+
+@Webhook({ name: 'flush' })
+export class FlushWebhook {
+  @WebhookHandler({ event: 'start' })
+  onStart() {
+    console.log('flush started');
+  }
+}

integration/discovery/src/my-webhook/my-webhook.module.ts

@@ -0,0 +1,6 @@
+import { Module } from '@nestjs/common';
+import { CleanupWebhook } from './cleanup.webhook';
+import { FlushWebhook } from './flush.webhook';
+
+@Module({ providers: [CleanupWebhook, FlushWebhook] })
+export class MyWebhookModule {}

integration/discovery/src/webhooks.explorer.ts

@@ -0,0 +1,39 @@
+import { Injectable } from '@nestjs/common';
+import { DiscoveryService, MetadataScanner } from '@nestjs/core';
+import { Webhook, WebhookHandler } from './decorators/webhook.decorators';
+
+@Injectable()
+export class WebhooksExplorer {
+  constructor(
+    private readonly discoveryService: DiscoveryService,
+    private readonly metadataScanner: MetadataScanner,
+  ) {}
+
+  getWebhooks() {
+    const webhooks = this.discoveryService.getProviders({
+      metadataKey: Webhook.KEY,
+    });
+    return webhooks.map(wrapper => {
+      const { name } = this.discoveryService.getMetadataByDecorator(
+        Webhook,
+        wrapper,
+      );
+      return {
+        name,
+        handlers: this.metadataScanner
+          .getAllMethodNames(wrapper.metatype.prototype)
+          .map(methodName => {
+            const { event } = this.discoveryService.getMetadataByDecorator(
+              WebhookHandler,
+              wrapper,
+              methodName,
+            );
+            return {
+              methodName,
+              event,
+            };
+          }),
+      };
+    });
+  }
+}

integration/discovery/tsconfig.json

@@ -0,0 +1,40 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": false,
+    "noImplicitAny": false,
+    "removeComments": true,
+    "noLib": false,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "target": "ES2021",
+    "sourceMap": true,
+    "allowJs": true,
+    "outDir": "./dist",
+    "paths": {
+      "@nestjs/common": ["../../packages/common"],
+      "@nestjs/common/*": ["../../packages/common/*"],
+      "@nestjs/core": ["../../packages/core"],
+      "@nestjs/core/*": ["../../packages/core/*"],
+      "@nestjs/microservices": ["../../packages/microservices"],
+      "@nestjs/microservices/*": ["../../packages/microservices/*"],
+      "@nestjs/websockets": ["../../packages/websockets"],
+      "@nestjs/websockets/*": ["../../packages/websockets/*"],
+      "@nestjs/testing": ["../../packages/testing"],
+      "@nestjs/testing/*": ["../../packages/testing/*"],
+      "@nestjs/platform-express": ["../../packages/platform-express"],
+      "@nestjs/platform-express/*": ["../../packages/platform-express/*"],
+      "@nestjs/platform-socket.io": ["../../packages/platform-socket.io"],
+      "@nestjs/platform-socket.io/*": ["../../packages/platform-socket.io/*"],
+      "@nestjs/platform-ws": ["../../packages/platform-ws"],
+      "@nestjs/platform-ws/*": ["../../packages/platform-ws/*"]
+    }
+  },
+  "include": [
+    "src/**/*",
+    "e2e/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+  ]
+}

integration/docker-compose.yml

@@ -25,7 +25,7 @@ services:
       - "9001:9001"
     restart: always
   mysql:
-    image: mysql:8.0.33
+    image: mysql:8.1.0
     environment:
       MYSQL_ROOT_PASSWORD: root
       MYSQL_DATABASE: test
@@ -50,7 +50,7 @@ services:
   zookeeper:
     container_name: test-zookeeper
     hostname: zookeeper
-    image: confluentinc/cp-zookeeper:7.4.0
+    image: confluentinc/cp-zookeeper:7.4.1
     ports:
       - "2181:2181"
     environment:
@@ -59,7 +59,7 @@ services:
   kafka:
     container_name: test-kafka
     hostname: kafka
-    image: confluentinc/cp-kafka:7.4.0
+    image: confluentinc/cp-kafka:7.4.1
     depends_on:
       - zookeeper
     ports:

integration/injector/e2e/optional-factory-provider-dep.spec.ts

@@ -118,14 +118,14 @@ describe('Optional factory provider deps', () => {
       } catch (err) {
         expect(err).to.be.instanceOf(UnknownDependenciesException);
         expect(err.message).to
-          .equal(`Nest can't resolve dependencies of the POSSIBLY_MISSING_DEP (?). Please make sure that the argument MISSING_DEP at index [0] is available in the RootTestModule context.
+          .equal(`Nest can't resolve dependencies of the POSSIBLY_MISSING_DEP (?). Please make sure that the argument "MISSING_DEP" at index [0] is available in the RootTestModule context.
 
 Potential solutions:
 - Is RootTestModule a valid NestJS module?
-- If MISSING_DEP is a provider, is it part of the current RootTestModule?
-- If MISSING_DEP is exported from a separate @Module, is that module imported within RootTestModule?
+- If "MISSING_DEP" is a provider, is it part of the current RootTestModule?
+- If "MISSING_DEP" is exported from a separate @Module, is that module imported within RootTestModule?
   @Module({
-    imports: [ /* the Module containing MISSING_DEP */ ]
+    imports: [ /* the Module containing "MISSING_DEP" */ ]
   })
 `);
       }

integration/nest-application/sse/src/app.controller.ts

@@ -6,7 +6,7 @@ export class AppController {
   @Sse('sse')
   sse(): Observable<MessageEvent> {
     return interval(1000).pipe(
-      map(_ => ({ data: { hello: 'world' } } as MessageEvent)),
+      map(_ => ({ data: { hello: 'world' } }) as MessageEvent),
     );
   }
 }

integration/websockets/e2e/gateway.spec.ts

@@ -82,5 +82,21 @@ describe('WebSocketGateway', () => {
     );
   });
 
+  it(`should be able to get the pattern in a filter (when the error comes from a known handler)`, async () => {
+    app = await createNestApp(ApplicationGateway);
+    await app.listen(3000);
+
+    ws = io('http://localhost:8080');
+    ws.emit('getClientWithError', {
+      test: 'test',
+    });
+    await new Promise<void>(resolve =>
+      ws.on('exception', data => {
+        expect(data.pattern).to.be.eql('getClientWithError');
+        resolve();
+      }),
+    );
+  });
+
   afterEach(() => app.close());
 });

integration/websockets/src/app.gateway.ts

@@ -1,10 +1,13 @@
-import { UseInterceptors } from '@nestjs/common';
+import { UseFilters, UseInterceptors } from '@nestjs/common';
 import {
   MessageBody,
   SubscribeMessage,
   WebSocketGateway,
+  WsException,
 } from '@nestjs/websockets';
 import { RequestInterceptor } from './request.interceptor';
+import { throwError } from 'rxjs';
+import { RequestFilter } from './request.filter';
 
 @WebSocketGateway(8080)
 export class ApplicationGateway {
@@ -24,4 +27,10 @@ export class ApplicationGateway {
       data: { ...data, path: client.pattern },
     };
   }
+
+  @UseFilters(RequestFilter)
+  @SubscribeMessage('getClientWithError')
+  getPathCalledWithError() {
+    return throwError(() => new WsException('This is an error'));
+  }
 }

integration/websockets/src/request.filter.ts

@@ -0,0 +1,12 @@
+import { ArgumentsHost, Catch, ExceptionFilter } from '@nestjs/common';
+import { WsException } from '@nestjs/websockets';
+
+@Catch(WsException)
+export class RequestFilter implements ExceptionFilter {
+  catch(exception: WsException, host: ArgumentsHost) {
+    const wsCtx = host.switchToWs();
+    const pattern = wsCtx.getPattern();
+    const client = wsCtx.getClient();
+    client.emit('exception', { pattern, message: exception.message });
+  }
+}

lerna.json

@@ -3,5 +3,5 @@
   "packages": [
     "packages/*"
   ],
-  "version": "10.1.2"
+  "version": "10.2.8"
 }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/core",
-  "version": "10.0.0",
+  "version": "10.2.7",
   "description": "Modern, fast, powerful node.js web framework",
   "homepage": "https://nestjs.com",
   "repository": {
@@ -64,7 +64,7 @@
     "cli-color": "2.0.3",
     "cors": "2.8.5",
     "express": "4.18.2",
-    "fast-json-stringify": "5.7.0",
+    "fast-json-stringify": "5.8.0",
     "fast-safe-stringify": "2.1.1",
     "graphql-subscriptions": "2.0.0",
     "iterare": "1.2.1",
@@ -72,67 +72,67 @@
     "path-to-regexp": "3.2.0",
     "reflect-metadata": "0.1.13",
     "rxjs": "7.8.1",
-    "socket.io": "4.7.1",
-    "tslib": "2.6.1",
+    "socket.io": "4.7.2",
+    "tslib": "2.6.2",
     "uid": "2.0.2",
-    "uuid": "9.0.0"
+    "uuid": "9.0.1"
   },
   "devDependencies": {
-    "@apollo/server": "4.7.5",
+    "@apollo/server": "4.9.5",
     "@codechecks/client": "0.1.12",
-    "@commitlint/cli": "17.6.7",
-    "@commitlint/config-angular": "17.6.7",
-    "@fastify/cors": "8.3.0",
+    "@commitlint/cli": "18.2.0",
+    "@commitlint/config-angular": "18.1.0",
+    "@fastify/cors": "8.4.0",
     "@fastify/formbody": "7.4.0",
     "@fastify/middie": "8.3.0",
-    "@fastify/multipart": "7.7.3",
-    "@fastify/static": "6.10.2",
-    "@fastify/view": "8.0.0",
-    "@grpc/grpc-js": "1.8.18",
-    "@grpc/proto-loader": "0.7.8",
-    "@nestjs/apollo": "12.0.4",
-    "@nestjs/graphql": "12.0.7",
+    "@fastify/multipart": "8.0.0",
+    "@fastify/static": "6.12.0",
+    "@fastify/view": "8.2.0",
+    "@grpc/grpc-js": "1.9.7",
+    "@grpc/proto-loader": "0.7.10",
+    "@nestjs/apollo": "12.0.9",
+    "@nestjs/graphql": "12.0.9",
     "@nestjs/mongoose": "10.0.1",
     "@nestjs/typeorm": "10.0.0",
-    "@types/amqplib": "0.10.1",
-    "@types/bytes": "3.1.1",
-    "@types/chai": "4.3.5",
-    "@types/chai-as-promised": "7.1.5",
-    "@types/cors": "2.8.13",
-    "@types/express": "4.17.17",
-    "@types/gulp": "4.0.13",
-    "@types/http-errors": "2.0.1",
-    "@types/mocha": "10.0.1",
-    "@types/node": "20.4.4",
-    "@types/sinon": "10.0.15",
-    "@types/supertest": "2.0.12",
-    "@types/ws": "8.5.5",
-    "@typescript-eslint/eslint-plugin": "5.61.0",
-    "@typescript-eslint/parser": "5.62.0",
-    "amqp-connection-manager": "4.1.13",
+    "@types/amqplib": "0.10.3",
+    "@types/bytes": "3.1.3",
+    "@types/chai": "4.3.9",
+    "@types/chai-as-promised": "7.1.7",
+    "@types/cors": "2.8.15",
+    "@types/express": "4.17.20",
+    "@types/gulp": "4.0.16",
+    "@types/http-errors": "2.0.3",
+    "@types/mocha": "10.0.3",
+    "@types/node": "20.8.10",
+    "@types/sinon": "10.0.20",
+    "@types/supertest": "2.0.15",
+    "@types/ws": "8.5.8",
+    "@typescript-eslint/eslint-plugin": "6.9.0",
+    "@typescript-eslint/parser": "6.9.0",
+    "amqp-connection-manager": "4.1.14",
     "amqplib": "0.10.3",
     "artillery": "1.7.9",
     "body-parser": "1.20.2",
     "bytes": "3.1.2",
-    "cache-manager": "5.2.3",
+    "cache-manager": "5.2.4",
     "cache-manager-redis-store": "3.0.1",
-    "chai": "4.3.7",
+    "chai": "4.3.10",
     "chai-as-promised": "7.1.1",
     "clang-format": "1.8.0",
     "commitlint-circle": "1.0.0",
-    "concurrently": "8.2.0",
-    "conventional-changelog": "4.0.0",
-    "core-js": "3.31.1",
+    "concurrently": "8.2.2",
+    "conventional-changelog": "5.1.0",
+    "core-js": "3.33.1",
     "coveralls": "3.1.1",
     "delete-empty": "3.0.0",
-    "engine.io-client": "6.5.1",
-    "eslint": "8.45.0",
-    "eslint-config-prettier": "8.8.0",
-    "eslint-plugin-import": "2.27.5",
+    "engine.io-client": "6.5.2",
+    "eslint": "8.52.0",
+    "eslint-config-prettier": "9.0.0",
+    "eslint-plugin-import": "2.29.0",
     "eventsource": "2.0.2",
     "fancy-log": "2.0.0",
-    "fastify": "4.20.0",
-    "graphql": "16.7.1",
+    "fastify": "4.24.3",
+    "graphql": "16.8.1",
     "graphql-tools": "9.0.0",
     "gulp": "4.0.2",
     "gulp-clang-format": "1.0.27",
@@ -148,32 +148,32 @@
     "kafkajs": "2.2.4",
     "lerna": "2.11.0",
     "lerna-changelog": "2.2.0",
-    "light-my-request": "5.10.0",
-    "lint-staged": "13.2.3",
+    "light-my-request": "5.11.0",
+    "lint-staged": "15.0.2",
     "markdown-table": "2.0.0",
     "merge-graphql-schemas": "1.7.8",
     "mocha": "10.2.0",
-    "mongoose": "7.4.1",
-    "mqtt": "4.3.7",
+    "mongoose": "7.6.3",
+    "mqtt": "5.1.3",
     "multer": "1.4.4",
-    "mysql2": "3.5.2",
-    "nats": "2.15.1",
+    "mysql2": "3.6.2",
+    "nats": "2.17.0",
     "nodemon": "3.0.1",
-    "nyc": "15.1.0",
-    "prettier": "3.0.0",
-    "redis": "4.6.7",
+    "nyc": "14.1.1",
+    "prettier": "3.0.3",
+    "redis": "4.6.10",
     "rxjs-compat": "6.6.7",
-    "sinon": "15.2.0",
+    "sinon": "17.0.0",
     "sinon-chai": "3.7.0",
-    "socket.io-client": "4.7.1",
+    "socket.io-client": "4.7.2",
     "subscriptions-transport-ws": "0.11.0",
     "supertest": "6.3.3",
-    "ts-morph": "19.0.0",
+    "ts-morph": "20.0.0",
     "ts-node": "10.9.1",
     "typeorm": "0.3.17",
-    "typescript": "5.1.6",
+    "typescript": "5.2.2",
     "wrk": "1.2.1",
-    "ws": "8.13.0"
+    "ws": "8.14.2"
   },
   "engines": {
     "node": ">= 16"

packages/common/Readme.md

@@ -23,7 +23,7 @@
 
 ## Description
 
-Nest is a framework for building efficient, scalable <a href="https://nodejs.org" target="_blank">Node.js</a> server-side applications. It uses modern JavaScript, is built with  <a href="https://www.typescriptlang.org" target="_blank">TypeScript</a> (preserves compatibility with pure JavaScript) and combines elements of OOP (Object Oriented Programming), FP (Functional Programming), and FRP (Functional Reactive Programming).
+Nest is a framework for building efficient, scalable <a href="https://nodejs.org" target="_blank">Node.js</a> server-side applications. It uses modern JavaScript, is built with <a href="https://www.typescriptlang.org" target="_blank">TypeScript</a> (preserves compatibility with pure JavaScript) and combines elements of OOP (Object Oriented Programming), FP (Functional Programming), and FRP (Functional Reactive Programming).
 
 <p>Under the hood, Nest makes use of <a href="https://expressjs.com/" target="_blank">Express</a>, but also, provides compatibility with a wide range of other libraries, like e.g. <a href="https://github.com/fastify/fastify" target="_blank">Fastify</a>, allowing for easy use of the myriad third-party plugins which are available.</p>
 
@@ -34,10 +34,10 @@ Nest is a framework for building efficient, scalable <a href="https://nodejs.org
 
 ## Getting started
 
-* To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
-* 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:
-* [가이드](readme_kr.md) 문서는 [docs.nestjs.com](https://docs.nestjs.com)에서 확인하실 수 있습니다. :books:
-* [ガイド](readme_jp.md)は [docs.nestjs.com](https://docs.nestjs.com)でご確認ください。 :books:
+- To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
+- 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:
+- [가이드](readme_kr.md) 문서는 [docs.nestjs.com](https://docs.nestjs.com)에서 확인하실 수 있습니다. :books:
+- [ガイド](readme_jp.md)は [docs.nestjs.com](https://docs.nestjs.com)でご確認ください。 :books:
 
 ## Questions
 
@@ -56,10 +56,13 @@ With official support, you can get expert help straight from Nest core team. We
 Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support from the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support).
 
 #### Principal Sponsors
+
 <table style="text-align:center;"><tr>
   <td><a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="200" valign="middle" /></a></td>
     <td>
 <a href="https://valor-software.com/" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="170" valign="middle" /></a></td>
+<td>
+<a href="https://amplication.com/" target="_blank"><img src="https://nestjs.com/img/amplication-logo.svg" width="190" valign="middle" /></a></td>
 </tr></table>
 
 #### Gold Sponsors
@@ -69,8 +72,7 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <td>
 <a href="https://github.com/Sanofi-IADC" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/sanofi.png" width="180" valign="middle" /></a></td>
 <td>
-<a href="https://nx.dev" target="_blank"><img src="https://nestjs.com/img/nx-logo.png" height="45" valign="middle" /></a></td><td>
-  <a href="https://amplication.com/" target="_blank"><img src="https://nestjs.com/img/amplication-logo.svg" width="190" valign="middle" /></a></td>
+<a href="https://nx.dev" target="_blank"><img src="https://nestjs.com/img/nx-logo.png" height="45" valign="middle" /></a></td>
   <td>
 <a href="https://weld.app/" target="_blank"><img src="https://nestjs.com/img/weld-logo.svg" width="140" valign="middle" /></a></td>
 <td>
@@ -86,7 +88,10 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 #### Silver Sponsors
 
 <table style="text-align:center;"><tr>
-<td><a href="https://n.inc" target="_blank"><img src="https://nestjs.com/img/n-inc-logo.svg" width="120" valign="middle" /></td></tr>
+<td><a href="https://n.inc" target="_blank"><img src="https://nestjs.com/img/n-inc-logo.svg" width="120" valign="middle" /></td>
+<td><a href="https://twistag.com/" target="_blank"><img src="https://nestjs.com/img/twistag-logo.png" width="120" valign="middle" /></td>
+<td><a href="https://immediateedgeapp.org/" target="_blank"><img src="https://nestjs.com/img/immediate-edge-logo.png" width="120" valign="middle" /></td>
+</tr>
 </table>
 
 #### Sponsors
@@ -111,6 +116,9 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
  <td align="center" valign="middle"><a href="https://nordbot.app/" target="_blank"><img src="https://nestjs.com/img/nordbot-logo.png" width="120" valign="middle" /></a></td></tr><tr>
  <td align="center" valign="middle"><a href="https://doppio.sh/" target="_blank"><img src="https://nestjs.com/img/dopiosh-logo.png" width="50" valign="middle" /></a></td>
    <td align="center" valign="middle"><a href="https://www.hingehealth.com/" target="_blank"><img src="https://nestjs.com/img/hinge-health-logo.svg" width="100" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://julienferand.dev/" target="_blank"><img src="https://nestjs.com/img/julienferand-logo.jpeg" width="65" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://www.tripoffice.com/" target="_blank"><img src="https://nestjs.com/img/tripoffice-logo.png" width="140" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://solcellsforetag.se/" target="_blank"><img src="https://nestjs.com/img/solcellsforetag-logo.svg" width="140" valign="middle" /></a></td>
   </tr></table>
 
 ## Backers
@@ -119,9 +127,9 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 
 ## Stay in touch
 
-* Author - [Kamil Myśliwiec](https://twitter.com/kammysliwiec)
-* Website - [https://nestjs.com](https://nestjs.com/)
-* Twitter - [@nestframework](https://twitter.com/nestframework)
+- Author - [Kamil Myśliwiec](https://x.com/kammysliwiec)
+- Website - [https://nestjs.com](https://nestjs.com/)
+- X - [@nestframework](https://x.com/nestframework)
 
 ## License
 

packages/common/decorators/http/request-mapping.decorator.ts

@@ -111,7 +111,7 @@ export const Head = createMappingDecorator(RequestMethod.HEAD);
 export const All = createMappingDecorator(RequestMethod.ALL);
 
 /**
- * Route handler (method) Decorator. Routes all HTTP requests to the specified path.
+ * Route handler (method) Decorator. Routes HTTP SEARCH requests to the specified path.
  *
  * @see [Routing](https://docs.nestjs.com/controllers#routing)
  *

packages/common/file-stream/streamable-file.ts

@@ -3,6 +3,7 @@ import { types } from 'util';
 import { HttpStatus } from '../enums';
 import { isFunction } from '../utils/shared.utils';
 import { StreamableFileOptions, StreamableHandlerResponse } from './interfaces';
+import { Logger } from '../services';
 
 /**
  * @see [Streaming files](https://docs.nestjs.com/techniques/streaming-files)
@@ -11,6 +12,7 @@ import { StreamableFileOptions, StreamableHandlerResponse } from './interfaces';
  */
 export class StreamableFile {
   private readonly stream: Readable;
+  protected logger = new Logger('StreamableFile');
 
   protected handleError: (
     err: Error,
@@ -28,6 +30,10 @@ export class StreamableFile {
     res.send(err.message);
   };
 
+  protected logError: (err: Error) => void = (err: Error) => {
+    this.logger.error(err.message, err.stack);
+  };
+
   constructor(buffer: Uint8Array, options?: StreamableFileOptions);
   constructor(readable: Readable, options?: StreamableFileOptions);
   constructor(
@@ -74,4 +80,13 @@ export class StreamableFile {
     this.handleError = handler;
     return this;
   }
+
+  get errorLogger() {
+    return this.logError;
+  }
+
+  setErrorLogger(handler: (err: Error) => void) {
+    this.logError = handler;
+    return this;
+  }
 }

packages/common/index.ts

@@ -28,6 +28,7 @@ export {
   HttpServer,
   HttpExceptionBody,
   HttpExceptionBodyMessage,
+  HttpRedirectResponse,
   INestApplication,
   INestApplicationContext,
   INestMicroservice,

packages/common/interfaces/http/http-redirect-response.interface.ts

@@ -0,0 +1,6 @@
+import { HttpStatus } from '../../enums';
+
+export interface HttpRedirectResponse {
+  url: string;
+  statusCode: HttpStatus;
+}

packages/common/interfaces/http/index.ts

@@ -1,4 +1,5 @@
 export * from './http-exception-body.interface';
+export * from './http-redirect-response.interface';
 export * from './http-server.interface';
 export * from './message-event.interface';
 export * from './raw-body-request.interface';

packages/common/module-utils/configurable-module.builder.ts

@@ -51,7 +51,8 @@ export interface ConfigurableModuleBuilderOptions {
 export class ConfigurableModuleBuilder<
   ModuleOptions,
   StaticMethodKey extends string = typeof DEFAULT_METHOD_KEY,
-  FactoryClassMethodKey extends string = typeof DEFAULT_FACTORY_CLASS_METHOD_KEY,
+  FactoryClassMethodKey extends
+    string = typeof DEFAULT_FACTORY_CLASS_METHOD_KEY,
   ExtraModuleDefinitionOptions = {},
 > {
   protected staticMethodKey: StaticMethodKey;

packages/common/module-utils/interfaces/configurable-module-async-options.interface.ts

@@ -28,7 +28,8 @@ export type ConfigurableModuleOptionsFactory<
  */
 export interface ConfigurableModuleAsyncOptions<
   ModuleOptions,
-  FactoryClassMethodKey extends string = typeof DEFAULT_FACTORY_CLASS_METHOD_KEY,
+  FactoryClassMethodKey extends
+    string = typeof DEFAULT_FACTORY_CLASS_METHOD_KEY,
 > extends Pick<ModuleMetadata, 'imports'> {
   /**
    * Injection token resolving to an existing provider. The provider must implement

packages/common/module-utils/interfaces/configurable-module-cls.interface.ts

@@ -15,7 +15,8 @@ import { ConfigurableModuleAsyncOptions } from './configurable-module-async-opti
 export type ConfigurableModuleCls<
   ModuleOptions,
   MethodKey extends string = typeof DEFAULT_METHOD_KEY,
-  FactoryClassMethodKey extends string = typeof DEFAULT_FACTORY_CLASS_METHOD_KEY,
+  FactoryClassMethodKey extends
+    string = typeof DEFAULT_FACTORY_CLASS_METHOD_KEY,
   ExtraModuleDefinitionOptions = {},
 > = {
   new (): any;

packages/common/module-utils/utils/get-injection-providers.util.ts

@@ -42,8 +42,7 @@ export function getInjectionProviders(
     // get injection tokens of the matched providers, if any
     search = match
       .filter(p => (p as any)?.inject)
-      .map(p => (p as FactoryProvider).inject)
-      .flat()
+      .flatMap(p => (p as FactoryProvider).inject)
       .map(mapInjectToTokens);
   }
   return result;

packages/common/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/common",
-  "version": "10.1.2",
+  "version": "10.2.8",
   "description": "Nest - modern, fast, powerful node.js web framework (@common)",
   "author": "Kamil Mysliwiec",
   "homepage": "https://nestjs.com",
@@ -19,7 +19,7 @@
   "license": "MIT",
   "dependencies": {
     "iterare": "1.2.1",
-    "tslib": "2.6.1",
+    "tslib": "2.6.2",
     "uid": "2.0.2"
   },
   "peerDependencies": {

packages/common/pipes/file/file-validator.interface.ts

@@ -16,7 +16,9 @@ export abstract class FileValidator<
    * Indicates if this file should be considered valid, according to the options passed in the constructor.
    * @param file the file from the request object
    */
-  abstract isValid(file?: TFile): boolean | Promise<boolean>;
+  abstract isValid(
+    file?: TFile | TFile[] | Record<string, TFile[]>,
+  ): boolean | Promise<boolean>;
 
   /**
    * Builds an error message in case the validation fails.

packages/common/pipes/validation.pipe.ts

@@ -179,7 +179,7 @@ export class ValidationPipe implements PipeTransform<any> {
     if (type === 'custom' && !this.validateCustomDecorators) {
       return false;
     }
-    const types = [String, Boolean, Number, Array, Object, Buffer];
+    const types = [String, Boolean, Number, Array, Object, Buffer, Date];
     return !types.some(t => metatype === t) && !isNil(metatype);
   }
 

packages/common/services/console-logger.service.ts

@@ -26,6 +26,7 @@ const DEFAULT_LOG_LEVELS: LogLevel[] = [
   'warn',
   'debug',
   'verbose',
+  'fatal',
 ];
 
 const dateTimeFormatter = new Intl.DateTimeFormat(undefined, {
@@ -145,6 +146,23 @@ export class ConsoleLogger implements LoggerService {
     this.printMessages(messages, context, 'verbose');
   }
 
+  /**
+   * Write a 'fatal' level log, if the configured level allows for it.
+   * Prints to `stdout` with newline.
+   */
+  fatal(message: any, context?: string): void;
+  fatal(message: any, ...optionalParams: [...any, string?]): void;
+  fatal(message: any, ...optionalParams: any[]) {
+    if (!this.isLevelEnabled('fatal')) {
+      return;
+    }
+    const { messages, context } = this.getContextAndMessagesToPrint([
+      message,
+      ...optionalParams,
+    ]);
+    this.printMessages(messages, context, 'fatal');
+  }
+
   /**
    * Set log levels
    * @param levels log levels
@@ -227,10 +245,18 @@ export class ConsoleLogger implements LoggerService {
   }
 
   protected stringifyMessage(message: unknown, logLevel: LogLevel) {
-    // If the message is a function, call it and re-resolve its value.
-    return isFunction(message)
-      ? this.stringifyMessage(message(), logLevel)
-      : isPlainObject(message) || Array.isArray(message)
+    if (isFunction(message)) {
+      const messageAsStr = Function.prototype.toString.call(message);
+      const isClass = messageAsStr.startsWith('class ');
+      if (isClass) {
+        // If the message is a class, we will display the class name.
+        return this.stringifyMessage(message.name, logLevel);
+      }
+      // If the message is a non-class function, call it and re-resolve its value.
+      return this.stringifyMessage(message(), logLevel);
+    }
+
+    return isPlainObject(message) || Array.isArray(message)
       ? `${this.colorize('Object:', logLevel)}\n${JSON.stringify(
           message,
           (key, value) =>
@@ -330,6 +356,8 @@ export class ConsoleLogger implements LoggerService {
         return clc.red;
       case 'verbose':
         return clc.cyanBright;
+      case 'fatal':
+        return clc.bold;
       default:
         return clc.green;
     }

packages/common/services/logger.service.ts

@@ -6,7 +6,7 @@ import { isLogLevelEnabled } from './utils';
 /**
  * @publicApi
  */
-export type LogLevel = 'log' | 'error' | 'warn' | 'debug' | 'verbose';
+export type LogLevel = 'log' | 'error' | 'warn' | 'debug' | 'verbose' | 'fatal';
 
 /**
  * @publicApi
@@ -37,6 +37,11 @@ export interface LoggerService {
    */
   verbose?(message: any, ...optionalParams: any[]): any;
 
+  /**
+   * Write a 'fatal' level log.
+   */
+  fatal?(message: any, ...optionalParams: any[]): any;
+
   /**
    * Set log levels.
    * @param levels log levels
@@ -185,6 +190,19 @@ export class Logger implements LoggerService {
     this.localInstance?.verbose?.(message, ...optionalParams);
   }
 
+  /**
+   * Write a 'fatal' level log.
+   */
+  fatal(message: any, context?: string): void;
+  fatal(message: any, ...optionalParams: [...any, string?]): void;
+  @Logger.WrapBuffer
+  fatal(message: any, ...optionalParams: any[]) {
+    optionalParams = this.context
+      ? optionalParams.concat(this.context)
+      : optionalParams;
+    this.localInstance?.fatal?.(message, ...optionalParams);
+  }
+
   /**
    * Write an 'error' level log.
    */
@@ -241,6 +259,16 @@ export class Logger implements LoggerService {
     this.staticInstanceRef?.verbose?.(message, ...optionalParams);
   }
 
+  /**
+   * Write a 'fatal' level log.
+   */
+  static fatal(message: any, context?: string): void;
+  static fatal(message: any, ...optionalParams: [...any, string?]): void;
+  @Logger.WrapBuffer
+  static fatal(message: any, ...optionalParams: any[]) {
+    this.staticInstanceRef?.fatal?.(message, ...optionalParams);
+  }
+
   /**
    * Print buffered logs and detach buffer.
    */

packages/common/services/utils/is-log-level-enabled.util.ts

@@ -6,6 +6,7 @@ const LOG_LEVEL_VALUES: Record<LogLevel, number> = {
   log: 2,
   warn: 3,
   error: 4,
+  fatal: 5,
 };
 
 /**

packages/common/test/decorators/route-params.decorator.spec.ts

@@ -1,7 +1,9 @@
 import { expect } from 'chai';
 import { Body, HostParam, Param, Query, Search } from '../../decorators';
 import { RequestMethod } from '../../enums/request-method.enum';
-import { All, Delete, Get, Patch, Post, Put } from '../../index';
+import { All, Delete, Get, ParseIntPipe, Patch, Post, Put } from '../../index';
+import { ROUTE_ARGS_METADATA } from '../../constants';
+import { RouteParamtypes } from '../../enums/route-paramtypes.enum';
 
 describe('@Get', () => {
   const requestPath = 'test';
@@ -19,18 +21,28 @@ describe('@Get', () => {
   it('should enhance class with expected request metadata', () => {
     class Test {
       @Get(requestPath)
-      public static test(@Param('id') params) {}
+      public static test(@Param('id', ParseIntPipe) params) {}
 
       @Get(requestPathUsingArray)
       public static testUsingArray(@Param('id') params) {}
     }
 
     const path = Reflect.getMetadata('path', Test.test);
+    const args = Reflect.getMetadata(
+      ROUTE_ARGS_METADATA,
+      Test.constructor,
+      'test',
+    );
     const method = Reflect.getMetadata('method', Test.test);
     const pathUsingArray = Reflect.getMetadata('path', Test.testUsingArray);
     const methodUsingArray = Reflect.getMetadata('method', Test.testUsingArray);
 
     expect(path).to.be.eql(requestPath);
+    expect(args[`${RouteParamtypes.PARAM}:0`]).to.be.eql({
+      index: 0,
+      data: 'id',
+      pipes: [ParseIntPipe],
+    });
     expect(method).to.be.eql(requestProps.method);
     expect(pathUsingArray).to.be.eql(requestPathUsingArray);
     expect(methodUsingArray).to.be.eql(requestPropsUsingArray.method);

packages/common/test/services/logger.service.spec.ts

@@ -298,6 +298,34 @@ describe('Logger', () => {
         );
       });
     });
+
+    describe('classes for message', () => {
+      let processStdoutWriteSpy: sinon.SinonSpy;
+
+      beforeEach(() => {
+        processStdoutWriteSpy = sinon.spy(process.stdout, 'write');
+      });
+      afterEach(() => {
+        processStdoutWriteSpy.restore();
+      });
+
+      it("should display class's name or empty for anonymous classes", () => {
+        const logger = new ConsoleLogger();
+
+        // in-line anonymous class
+        logger.log(class {});
+
+        // named class
+        class Test {
+          #privateField = 'private field';
+          publicField = 'public field';
+        }
+        logger.log(Test);
+
+        expect(processStdoutWriteSpy.firstCall.firstArg).to.include('');
+        expect(processStdoutWriteSpy.secondCall.firstArg).to.include(Test.name);
+      });
+    });
   });
 
   describe('[instance methods]', () => {

packages/core/Readme.md

@@ -23,7 +23,7 @@
 
 ## Description
 
-Nest is a framework for building efficient, scalable <a href="https://nodejs.org" target="_blank">Node.js</a> server-side applications. It uses modern JavaScript, is built with  <a href="https://www.typescriptlang.org" target="_blank">TypeScript</a> (preserves compatibility with pure JavaScript) and combines elements of OOP (Object Oriented Programming), FP (Functional Programming), and FRP (Functional Reactive Programming).
+Nest is a framework for building efficient, scalable <a href="https://nodejs.org" target="_blank">Node.js</a> server-side applications. It uses modern JavaScript, is built with <a href="https://www.typescriptlang.org" target="_blank">TypeScript</a> (preserves compatibility with pure JavaScript) and combines elements of OOP (Object Oriented Programming), FP (Functional Programming), and FRP (Functional Reactive Programming).
 
 <p>Under the hood, Nest makes use of <a href="https://expressjs.com/" target="_blank">Express</a>, but also, provides compatibility with a wide range of other libraries, like e.g. <a href="https://github.com/fastify/fastify" target="_blank">Fastify</a>, allowing for easy use of the myriad third-party plugins which are available.</p>
 
@@ -34,10 +34,10 @@ Nest is a framework for building efficient, scalable <a href="https://nodejs.org
 
 ## Getting started
 
-* To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
-* 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:
-* [가이드](readme_kr.md) 문서는 [docs.nestjs.com](https://docs.nestjs.com)에서 확인하실 수 있습니다. :books:
-* [ガイド](readme_jp.md)は [docs.nestjs.com](https://docs.nestjs.com)でご確認ください。 :books:
+- To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
+- 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:
+- [가이드](readme_kr.md) 문서는 [docs.nestjs.com](https://docs.nestjs.com)에서 확인하실 수 있습니다. :books:
+- [ガイド](readme_jp.md)は [docs.nestjs.com](https://docs.nestjs.com)でご確認ください。 :books:
 
 ## Questions
 
@@ -56,10 +56,13 @@ With official support, you can get expert help straight from Nest core team. We
 Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support from the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support).
 
 #### Principal Sponsors
+
 <table style="text-align:center;"><tr>
   <td><a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="200" valign="middle" /></a></td>
     <td>
 <a href="https://valor-software.com/" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="170" valign="middle" /></a></td>
+<td>
+<a href="https://amplication.com/" target="_blank"><img src="https://nestjs.com/img/amplication-logo.svg" width="190" valign="middle" /></a></td>
 </tr></table>
 
 #### Gold Sponsors
@@ -69,8 +72,7 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <td>
 <a href="https://github.com/Sanofi-IADC" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/sanofi.png" width="180" valign="middle" /></a></td>
 <td>
-<a href="https://nx.dev" target="_blank"><img src="https://nestjs.com/img/nx-logo.png" height="45" valign="middle" /></a></td><td>
-  <a href="https://amplication.com/" target="_blank"><img src="https://nestjs.com/img/amplication-logo.svg" width="190" valign="middle" /></a></td>
+<a href="https://nx.dev" target="_blank"><img src="https://nestjs.com/img/nx-logo.png" height="45" valign="middle" /></a></td>
   <td>
 <a href="https://weld.app/" target="_blank"><img src="https://nestjs.com/img/weld-logo.svg" width="140" valign="middle" /></a></td>
 <td>
@@ -86,7 +88,10 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 #### Silver Sponsors
 
 <table style="text-align:center;"><tr>
-<td><a href="https://n.inc" target="_blank"><img src="https://nestjs.com/img/n-inc-logo.svg" width="120" valign="middle" /></td></tr>
+<td><a href="https://n.inc" target="_blank"><img src="https://nestjs.com/img/n-inc-logo.svg" width="120" valign="middle" /></td>
+<td><a href="https://twistag.com/" target="_blank"><img src="https://nestjs.com/img/twistag-logo.png" width="120" valign="middle" /></td>
+<td><a href="https://immediateedgeapp.org/" target="_blank"><img src="https://nestjs.com/img/immediate-edge-logo.png" width="120" valign="middle" /></td>
+</tr>
 </table>
 
 #### Sponsors
@@ -111,6 +116,9 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
  <td align="center" valign="middle"><a href="https://nordbot.app/" target="_blank"><img src="https://nestjs.com/img/nordbot-logo.png" width="120" valign="middle" /></a></td></tr><tr>
  <td align="center" valign="middle"><a href="https://doppio.sh/" target="_blank"><img src="https://nestjs.com/img/dopiosh-logo.png" width="50" valign="middle" /></a></td>
    <td align="center" valign="middle"><a href="https://www.hingehealth.com/" target="_blank"><img src="https://nestjs.com/img/hinge-health-logo.svg" width="100" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://julienferand.dev/" target="_blank"><img src="https://nestjs.com/img/julienferand-logo.jpeg" width="65" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://www.tripoffice.com/" target="_blank"><img src="https://nestjs.com/img/tripoffice-logo.png" width="140" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://solcellsforetag.se/" target="_blank"><img src="https://nestjs.com/img/solcellsforetag-logo.svg" width="140" valign="middle" /></a></td>
   </tr></table>
 
 ## Backers
@@ -119,9 +127,9 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 
 ## Stay in touch
 
-* Author - [Kamil Myśliwiec](https://twitter.com/kammysliwiec)
-* Website - [https://nestjs.com](https://nestjs.com/)
-* Twitter - [@nestframework](https://twitter.com/nestframework)
+- Author - [Kamil Myśliwiec](https://x.com/kammysliwiec)
+- Website - [https://nestjs.com](https://nestjs.com/)
+- X - [@nestframework](https://x.com/nestframework)
 
 ## License
 

packages/core/discovery/discoverable-meta-host-collection.ts

@@ -0,0 +1,153 @@
+import { Type } from '@nestjs/common';
+import { InstanceWrapper } from '../injector/instance-wrapper';
+import { ModulesContainer } from '../injector/modules-container';
+
+export class DiscoverableMetaHostCollection {
+  /**
+   * A map of class references to metadata keys.
+   */
+  public static readonly metaHostLinks = new Map<Type | Function, string>();
+
+  /**
+   * A map of metadata keys to instance wrappers (providers) with the corresponding metadata key.
+   * The map is weakly referenced by the modules container (unique per application).
+   */
+  private static readonly providersByMetaKey = new WeakMap<
+    ModulesContainer,
+    Map<string, Set<InstanceWrapper>>
+  >();
+
+  /**
+   * A map of metadata keys to instance wrappers (controllers) with the corresponding metadata key.
+   * The map is weakly referenced by the modules container (unique per application).
+   */
+  private static readonly controllersByMetaKey = new WeakMap<
+    ModulesContainer,
+    Map<string, Set<InstanceWrapper>>
+  >();
+
+  /**
+   * Adds a link between a class reference and a metadata key.
+   * @param target The class reference.
+   * @param metadataKey The metadata key.
+   */
+  public static addClassMetaHostLink(
+    target: Type | Function,
+    metadataKey: string,
+  ) {
+    this.metaHostLinks.set(target, metadataKey);
+  }
+
+  /**
+   * Inspects a provider instance wrapper and adds it to the collection of providers
+   * if it has a metadata key.
+   * @param hostContainerRef A reference to the modules container.
+   * @param instanceWrapper A provider instance wrapper.
+   * @returns void
+   */
+  public static inspectProvider(
+    hostContainerRef: ModulesContainer,
+    instanceWrapper: InstanceWrapper,
+  ) {
+    return this.inspectInstanceWrapper(
+      hostContainerRef,
+      instanceWrapper,
+      this.providersByMetaKey,
+    );
+  }
+
+  /**
+   * Inspects a controller instance wrapper and adds it to the collection of controllers
+   * if it has a metadata key.
+   * @param hostContainerRef A reference to the modules container.
+   * @param instanceWrapper A controller's instance wrapper.
+   * @returns void
+   */
+  public static inspectController(
+    hostContainerRef: ModulesContainer,
+    instanceWrapper: InstanceWrapper,
+  ) {
+    return this.inspectInstanceWrapper(
+      hostContainerRef,
+      instanceWrapper,
+      this.controllersByMetaKey,
+    );
+  }
+
+  public static insertByMetaKey(
+    metaKey: string,
+    instanceWrapper: InstanceWrapper,
+    collection: Map<string, Set<InstanceWrapper>>,
+  ) {
+    if (collection.has(metaKey)) {
+      const wrappers = collection.get(metaKey);
+      wrappers.add(instanceWrapper);
+    } else {
+      const wrappers = new Set<InstanceWrapper>();
+      wrappers.add(instanceWrapper);
+      collection.set(metaKey, wrappers);
+    }
+  }
+
+  public static getProvidersByMetaKey(
+    hostContainerRef: ModulesContainer,
+    metaKey: string,
+  ): Set<InstanceWrapper> {
+    const wrappersByMetaKey = this.providersByMetaKey.get(hostContainerRef);
+    return wrappersByMetaKey?.get(metaKey) ?? new Set<InstanceWrapper>();
+  }
+
+  public static getControllersByMetaKey(
+    hostContainerRef: ModulesContainer,
+    metaKey: string,
+  ): Set<InstanceWrapper> {
+    const wrappersByMetaKey = this.controllersByMetaKey.get(hostContainerRef);
+    return wrappersByMetaKey?.get(metaKey) ?? new Set<InstanceWrapper>();
+  }
+
+  private static inspectInstanceWrapper(
+    hostContainerRef: ModulesContainer,
+    instanceWrapper: InstanceWrapper,
+    wrapperByMetaKeyMap: WeakMap<
+      ModulesContainer,
+      Map<string, Set<InstanceWrapper>>
+    >,
+  ) {
+    const metaKey =
+      DiscoverableMetaHostCollection.getMetaKeyByInstanceWrapper(
+        instanceWrapper,
+      );
+    if (!metaKey) {
+      return;
+    }
+
+    let collection: Map<string, Set<InstanceWrapper>>;
+    if (wrapperByMetaKeyMap.has(hostContainerRef)) {
+      collection = wrapperByMetaKeyMap.get(hostContainerRef);
+    } else {
+      collection = new Map<string, Set<InstanceWrapper>>();
+      wrapperByMetaKeyMap.set(hostContainerRef, collection);
+    }
+    this.insertByMetaKey(metaKey, instanceWrapper, collection);
+  }
+
+  private static getMetaKeyByInstanceWrapper(
+    instanceWrapper: InstanceWrapper<any>,
+  ) {
+    return this.metaHostLinks.get(
+      // NOTE: Regarding the ternary statement below,
+      // - The condition `!wrapper.metatype` is needed because when we use `useValue`
+      // the value of `wrapper.metatype` will be `null`.
+      // - The condition `wrapper.inject` is needed here because when we use
+      // `useFactory`, the value of `wrapper.metatype` will be the supplied
+      // factory function.
+      // For both cases, we should use `wrapper.instance.constructor` instead
+      // of `wrapper.metatype` to resolve processor's class properly.
+      // But since calling `wrapper.instance` could degrade overall performance
+      // we must defer it as much we can.
+      instanceWrapper.metatype || instanceWrapper.inject
+        ? instanceWrapper.instance?.constructor ?? instanceWrapper.metatype
+        : instanceWrapper.metatype,
+    );
+  }
+}

packages/core/discovery/discovery-service.ts

@@ -1,15 +1,48 @@
-import { flatten, Injectable } from '@nestjs/common';
+import {
+  CustomDecorator,
+  flatten,
+  Injectable,
+  SetMetadata,
+} from '@nestjs/common';
+import { uid } from 'uid';
 import { InstanceWrapper } from '../injector/instance-wrapper';
 import { Module } from '../injector/module';
 import { ModulesContainer } from '../injector/modules-container';
+import { DiscoverableMetaHostCollection } from './discoverable-meta-host-collection';
 
 /**
  * @publicApi
  */
-export interface DiscoveryOptions {
+export interface FilterByInclude {
+  /**
+   * List of modules to include (whitelist) into the discovery process.
+   */
   include?: Function[];
 }
 
+/**
+ * @publicApi
+ */
+export interface FilterByMetadataKey {
+  /**
+   * A key to filter controllers and providers by.
+   * Only instance wrappers with the specified metadata key will be returned.
+   */
+  metadataKey?: string;
+}
+
+/**
+ * @publicApi
+ */
+export type DiscoveryOptions = FilterByInclude | FilterByMetadataKey;
+
+/**
+ * @publicApi
+ */
+export type DiscoverableDecorator<T> = ((opts?: T) => CustomDecorator) & {
+  KEY: string;
+};
+
 /**
  * @publicApi
  */
@@ -17,24 +50,107 @@ export interface DiscoveryOptions {
 export class DiscoveryService {
   constructor(private readonly modulesContainer: ModulesContainer) {}
 
-  getProviders(
+  /**
+   * Creates a decorator that can be used to decorate classes and methods with metadata.
+   * The decorator will also add the class to the collection of discoverable classes (by metadata key).
+   * Decorated classes can be discovered using the `getProviders` and `getControllers` methods.
+   * @returns A decorator function.
+   */
+  static createDecorator<T>(): DiscoverableDecorator<T> {
+    const metadataKey = uid(21);
+    const decoratorFn =
+      (opts: T) =>
+      (target: object | Function, key?: string | symbol, descriptor?: any) => {
+        if (!descriptor) {
+          DiscoverableMetaHostCollection.addClassMetaHostLink(
+            target as Function,
+            metadataKey,
+          );
+        }
+        SetMetadata(metadataKey, opts ?? {})(target, key, descriptor);
+      };
+
+    decoratorFn.KEY = metadataKey;
+    return decoratorFn as DiscoverableDecorator<T>;
+  }
+
+  /**
+   * Returns an array of instance wrappers (providers).
+   * Depending on the options, the array will contain either all providers or only providers with the specified metadata key.
+   * @param options Discovery options.
+   * @param modules A list of modules to filter by.
+   * @returns An array of instance wrappers (providers).
+   */
+  public getProviders(
     options: DiscoveryOptions = {},
     modules: Module[] = this.getModules(options),
   ): InstanceWrapper[] {
+    if ('metadataKey' in options) {
+      const providers = DiscoverableMetaHostCollection.getProvidersByMetaKey(
+        this.modulesContainer,
+        options.metadataKey,
+      );
+      return Array.from(providers);
+    }
+
     const providers = modules.map(item => [...item.providers.values()]);
     return flatten(providers);
   }
 
-  getControllers(
+  /**
+   * Returns an array of instance wrappers (controllers).
+   * Depending on the options, the array will contain either all controllers or only controllers with the specified metadata key.
+   * @param options Discovery options.
+   * @param modules A list of modules to filter by.
+   * @returns An array of instance wrappers (controllers).
+   */
+  public getControllers(
     options: DiscoveryOptions = {},
     modules: Module[] = this.getModules(options),
   ): InstanceWrapper[] {
+    if ('metadataKey' in options) {
+      const controllers =
+        DiscoverableMetaHostCollection.getControllersByMetaKey(
+          this.modulesContainer,
+          options.metadataKey,
+        );
+      return Array.from(controllers);
+    }
+
     const controllers = modules.map(item => [...item.controllers.values()]);
     return flatten(controllers);
   }
 
+  /**
+   * Retrieves metadata from the specified instance wrapper.
+   * @param decorator The decorator to retrieve metadata of.
+   * @param instanceWrapper Reference to the instance wrapper.
+   * @param methodKey An optional method key to retrieve metadata from.
+   * @returns Discovered metadata.
+   */
+  public getMetadataByDecorator<T extends DiscoverableDecorator<any>>(
+    decorator: T,
+    instanceWrapper: InstanceWrapper,
+    methodKey?: string,
+  ): T extends DiscoverableDecorator<infer R> ? R | undefined : T | undefined {
+    if (methodKey) {
+      return Reflect.getMetadata(
+        decorator.KEY,
+        instanceWrapper.instance[methodKey],
+      );
+    }
+
+    const clsRef =
+      instanceWrapper.instance?.constructor ?? instanceWrapper.metatype;
+    return Reflect.getMetadata(decorator.KEY, clsRef);
+  }
+
+  /**
+   * Returns a list of modules to be used for discovery.
+   */
   protected getModules(options: DiscoveryOptions = {}): Module[] {
-    if (!options.include) {
+    const includeInOpts = 'include' in options;
+    if (!includeInOpts) {
       const moduleRefs = [...this.modulesContainer.values()];
       return moduleRefs;
     }

packages/core/errors/messages.ts

@@ -23,20 +23,31 @@ const getInstanceName = (instance: unknown): string => {
 };
 
 /**
- * Returns the name of the dependency
+ * Returns the name of the dependency.
  * Tries to get the class name, otherwise the string value
- * (= injection token). As fallback it returns '+'
+ * (= injection token). As fallback to any falsy value for `dependency`, it
+ * returns `fallbackValue`
  * @param dependency The name of the dependency to be displayed
+ * @param fallbackValue The fallback value if the dependency is falsy
+ * @param disambiguated Whether dependency's name is disambiguated with double quotes
  */
-const getDependencyName = (dependency: InjectorDependency): string =>
+const getDependencyName = (
+  dependency: InjectorDependency | undefined,
+  fallbackValue: string,
+  disambiguated = true,
+): string =>
   // use class name
   getInstanceName(dependency) ||
   // use injection token (symbol)
   (isSymbol(dependency) && dependency.toString()) ||
   // use string directly
-  (dependency as string) ||
+  (dependency
+    ? disambiguated
+      ? `"${dependency as string}"`
+      : (dependency as string)
+    : undefined) ||
   // otherwise
-  '+';
+  fallbackValue;
 
 /**
  * Returns the name of the module
@@ -54,14 +65,9 @@ export const UNKNOWN_DEPENDENCIES_MESSAGE = (
   unknownDependencyContext: InjectorDependencyContext,
   module: Module,
 ) => {
-  const {
-    index,
-    name = 'dependency',
-    dependencies,
-    key,
-  } = unknownDependencyContext;
+  const { index, name, dependencies, key } = unknownDependencyContext;
   const moduleName = getModuleName(module);
-  const dependencyName = getDependencyName(name);
+  const dependencyName = getDependencyName(name, 'dependency');
 
   const potentialSolutions =
     // If module's name is well defined
@@ -90,7 +96,9 @@ Potential solutions:
     message += `. Please make sure that the "${key.toString()}" property is available in the current context.${potentialSolutions}`;
     return message;
   }
-  const dependenciesName = (dependencies || []).map(getDependencyName);
+  const dependenciesName = (dependencies || []).map(dependencyName =>
+    getDependencyName(dependencyName, '+', false),
+  );
   dependenciesName[index] = '?';
 
   message += ` (`;

packages/core/injector/container.ts

@@ -5,6 +5,7 @@ import {
 } from '@nestjs/common/constants';
 import { Injectable, Type } from '@nestjs/common/interfaces';
 import { ApplicationConfig } from '../application-config';
+import { DiscoverableMetaHostCollection } from '../discovery/discoverable-meta-host-collection';
 import {
   CircularDependencyException,
   UndefinedForwardRefException,
@@ -82,9 +83,8 @@ export class NestContainer {
     if (!metatype) {
       throw new UndefinedForwardRefException(scope);
     }
-    const { type, dynamicMetadata, token } = await this.moduleCompiler.compile(
-      metatype,
-    );
+    const { type, dynamicMetadata, token } =
+      await this.moduleCompiler.compile(metatype);
     if (this.modules.has(token)) {
       return {
         moduleRef: this.modules.get(token),
@@ -123,9 +123,8 @@ export class NestContainer {
     }
 
     const { token } = await this.moduleCompiler.compile(metatypeToReplace);
-    const { type, dynamicMetadata } = await this.moduleCompiler.compile(
-      newMetatype,
-    );
+    const { type, dynamicMetadata } =
+      await this.moduleCompiler.compile(newMetatype);
 
     return {
       moduleRef: await this.setModule(
@@ -219,11 +218,10 @@ export class NestContainer {
       return;
     }
     const moduleRef = this.modules.get(token);
-    const { token: relatedModuleToken } = await this.moduleCompiler.compile(
-      relatedModule,
-    );
+    const { token: relatedModuleToken } =
+      await this.moduleCompiler.compile(relatedModule);
     const related = this.modules.get(relatedModuleToken);
-    moduleRef.addRelatedModule(related);
+    moduleRef.addImport(related);
   }
 
   public addProvider(
@@ -238,7 +236,12 @@ export class NestContainer {
     if (!moduleRef) {
       throw new UnknownModuleException();
     }
-    return moduleRef.addProvider(provider, enhancerSubtype) as Function;
+    const providerKey = moduleRef.addProvider(provider, enhancerSubtype);
+    const providerRef = moduleRef.getProviderByKey(providerKey);
+
+    DiscoverableMetaHostCollection.inspectProvider(this.modules, providerRef);
+
+    return providerKey as Function;
   }
 
   public addInjectable(
@@ -268,6 +271,12 @@ export class NestContainer {
     }
     const moduleRef = this.modules.get(token);
     moduleRef.addController(controller);
+
+    const controllerRef = moduleRef.controllers.get(controller);
+    DiscoverableMetaHostCollection.inspectController(
+      this.modules,
+      controllerRef,
+    );
   }
 
   public clear() {
@@ -292,7 +301,7 @@ export class NestContainer {
     if (target === globalModule || target === this.internalCoreModule) {
       return;
     }
-    target.addRelatedModule(globalModule);
+    target.addImport(globalModule);
   }
 
   public getDynamicMetadataByToken(token: string): Partial<DynamicModule>;

packages/core/injector/helpers/silent-logger.ts

@@ -8,5 +8,6 @@ export class SilentLogger extends Logger {
   warn = noop;
   debug = noop;
   verbose = noop;
+  fatal = noop;
   setLogLevels = noop;
 }

packages/core/injector/module-ref.ts

@@ -128,7 +128,10 @@ export abstract class ModuleRef extends AbstractInstanceResolver {
     options?: ModuleRefGetOrResolveOpts,
   ): Promise<TResult | Array<TResult>>;
 
-  public abstract create<T = any>(type: Type<T>): Promise<T>;
+  public abstract create<T = any>(
+    type: Type<T>,
+    contextId?: ContextId,
+  ): Promise<T>;
 
   public introspect<T = any>(
     token: Type<T> | string | symbol,
@@ -151,6 +154,7 @@ export abstract class ModuleRef extends AbstractInstanceResolver {
   protected async instantiateClass<T = any>(
     type: Type<T>,
     moduleRef: Module,
+    contextId?: ContextId,
   ): Promise<T> {
     const wrapper = new InstanceWrapper({
       name: type && type.name,
@@ -166,6 +170,8 @@ export abstract class ModuleRef extends AbstractInstanceResolver {
           const properties = await this.injector.resolveProperties(
             wrapper,
             moduleRef,
+            undefined,
+            contextId,
           );
           const instance = new type(...instances);
           this.injector.applyProperties(instance, properties);
@@ -176,6 +182,7 @@ export abstract class ModuleRef extends AbstractInstanceResolver {
           moduleRef,
           undefined,
           callback,
+          contextId,
         );
       } catch (err) {
         reject(err);

packages/core/injector/module.ts

@@ -37,7 +37,7 @@ import { isDurable } from '../helpers/is-durable';
 import { UuidFactory } from '../inspector/uuid-factory';
 import { CONTROLLER_ID_KEY } from './constants';
 import { NestContainer } from './container';
-import { InstanceWrapper } from './instance-wrapper';
+import { ContextId, InstanceWrapper } from './instance-wrapper';
 import { ModuleRef, ModuleRefGetOrResolveOpts } from './module-ref';
 
 export class Module {
@@ -240,11 +240,11 @@ export class Module {
     return instanceWrapper;
   }
 
-  public addProvider(provider: Provider): Provider | InjectionToken;
+  public addProvider(provider: Provider): InjectionToken;
   public addProvider(
     provider: Provider,
     enhancerSubtype: EnhancerSubtype,
-  ): Provider | InjectionToken;
+  ): InjectionToken;
   public addProvider(provider: Provider, enhancerSubtype?: EnhancerSubtype) {
     if (this.isCustomProvider(provider)) {
       if (this.isEntryProvider(provider.provide)) {
@@ -517,6 +517,13 @@ export class Module {
     });
   }
 
+  public addImport(moduleRef: Module) {
+    this._imports.add(moduleRef);
+  }
+
+  /**
+   * @deprecated
+   */
   public addRelatedModule(module: Module) {
     this._imports.add(module);
   }
@@ -626,11 +633,14 @@ export class Module {
         );
       }
 
-      public async create<T = any>(type: Type<T>): Promise<T> {
+      public async create<T = any>(
+        type: Type<T>,
+        contextId?: ContextId,
+      ): Promise<T> {
         if (!(type && isFunction(type) && type.prototype)) {
           throw new InvalidClassException(type);
         }
-        return this.instantiateClass<T>(type, self);
+        return this.instantiateClass<T>(type, self, contextId);
       }
     };
   }

packages/core/injector/settlement-signal.ts

@@ -7,6 +7,7 @@ export class SettlementSignal {
   private readonly _refs = new Set();
   private readonly settledPromise: Promise<unknown>;
   private settleFn!: (err?: unknown) => void;
+  private completed = false;
 
   constructor() {
     this.settledPromise = new Promise<unknown>(resolve => {
@@ -18,6 +19,7 @@ export class SettlementSignal {
    * Resolves the promise returned by `asPromise`.
    */
   public complete() {
+    this.completed = true;
     this.settleFn();
   }
 
@@ -26,6 +28,7 @@ export class SettlementSignal {
    * @param err Error to reject the promise returned by `asPromise` with.
    */
   public error(err: unknown) {
+    this.completed = true;
     this.settleFn(err);
   }
 
@@ -51,6 +54,6 @@ export class SettlementSignal {
    * @returns True if relationship is circular, false otherwise.
    */
   public isCycle(wrapperId: string) {
-    return this._refs.has(wrapperId);
+    return !this.completed && this._refs.has(wrapperId);
   }
 }

packages/core/middleware/middleware-module.ts

@@ -33,7 +33,8 @@ import { RouteInfoPathExtractor } from './route-info-path-extractor';
 import { RoutesMapper } from './routes-mapper';
 
 export class MiddlewareModule<
-  TAppOptions extends NestApplicationContextOptions = NestApplicationContextOptions,
+  TAppOptions extends
+    NestApplicationContextOptions = NestApplicationContextOptions,
 > {
   private readonly routerProxy = new RouterProxy();
   private readonly exceptionFiltersCache = new WeakMap();

packages/core/middleware/routes-mapper.ts

@@ -87,29 +87,27 @@ export class RoutesMapper {
       version === VERSION_NEUTRAL ? undefined : version;
 
     const toRouteInfo = (item: RouteDefinition, prefix: string) =>
-      item.path
-        ?.map(p => {
-          let endpointPath = modulePath ?? '';
-          endpointPath += this.normalizeGlobalPath(prefix) + addLeadingSlash(p);
+      item.path?.flatMap(p => {
+        let endpointPath = modulePath ?? '';
+        endpointPath += this.normalizeGlobalPath(prefix) + addLeadingSlash(p);
 
-          const routeInfo: RouteInfo = {
-            path: endpointPath,
-            method: item.requestMethod,
-          };
-          const version = item.version ?? controllerVersion;
-          if (version && versioningConfig) {
-            if (typeof version !== 'string' && Array.isArray(version)) {
-              return version.map(v => ({
-                ...routeInfo,
-                version: toUndefinedIfNeural(v),
-              }));
-            }
-            routeInfo.version = toUndefinedIfNeural(version);
+        const routeInfo: RouteInfo = {
+          path: endpointPath,
+          method: item.requestMethod,
+        };
+        const version = item.version ?? controllerVersion;
+        if (version && versioningConfig) {
+          if (typeof version !== 'string' && Array.isArray(version)) {
+            return version.map(v => ({
+              ...routeInfo,
+              version: toUndefinedIfNeural(v),
+            }));
           }
+          routeInfo.version = toUndefinedIfNeural(version);
+        }
 
-          return routeInfo;
-        })
-        .flat() as RouteInfo[];
+        return routeInfo;
+      });
 
     return []
       .concat(routePath)

packages/core/nest-application-context.ts

@@ -36,7 +36,8 @@ import { Module } from './injector/module';
  * @publicApi
  */
 export class NestApplicationContext<
-    TOptions extends NestApplicationContextOptions = NestApplicationContextOptions,
+    TOptions extends
+      NestApplicationContextOptions = NestApplicationContextOptions,
   >
   extends AbstractInstanceResolver
   implements INestApplicationContext

packages/core/nest-factory.ts

@@ -157,13 +157,13 @@ export class NestFactoryStatic {
     moduleCls: any,
     options?: NestApplicationContextOptions,
   ): Promise<INestApplicationContext> {
-    const container = new NestContainer();
+    const applicationConfig = new ApplicationConfig();
+    const container = new NestContainer(applicationConfig);
     const graphInspector = this.createGraphInspector(options, container);
 
     this.setAbortOnError(options);
     this.registerLoggerConfiguration(options);
 
-    const applicationConfig = undefined;
     await this.initialize(
       moduleCls,
       container,

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/core",
-  "version": "10.1.2",
+  "version": "10.2.8",
   "description": "Nest - modern, fast, powerful node.js web framework (@core)",
   "author": "Kamil Mysliwiec",
   "license": "MIT",
@@ -32,11 +32,11 @@
     "fast-safe-stringify": "2.1.1",
     "iterare": "1.2.1",
     "path-to-regexp": "3.2.0",
-    "tslib": "2.6.1",
+    "tslib": "2.6.2",
     "uid": "2.0.2"
   },
   "devDependencies": {
-    "@nestjs/common": "10.1.2"
+    "@nestjs/common": "10.2.8"
   },
   "peerDependencies": {
     "@nestjs/common": "^10.0.0",

packages/core/router/router-explorer.ts

@@ -231,6 +231,7 @@ export class RouterExplorer {
           },
         };
 
+        this.copyMetadataToCallback(targetCallback, routeHandler);
         routerMethodRef(path, routeHandler);
 
         this.graphInspector.insertEntrypointDefinition<HttpEntrypointMetadata>(
@@ -422,4 +423,17 @@ export class RouterExplorer {
     }
     return contextId;
   }
+
+  private copyMetadataToCallback(
+    originalCallback: RouterProxyCallback,
+    targetCallback: Function,
+  ) {
+    for (const key of Reflect.getMetadataKeys(originalCallback)) {
+      Reflect.defineMetadata(
+        key,
+        Reflect.getMetadata(key, originalCallback),
+        targetCallback,
+      );
+    }
+  }
 }

packages/core/services/reflector.service.ts

@@ -1,5 +1,38 @@
-import { Type } from '@nestjs/common';
+import { CustomDecorator, SetMetadata, Type } from '@nestjs/common';
 import { isEmpty, isObject } from '@nestjs/common/utils/shared.utils';
+import { uid } from 'uid';
+
+/**
+ * @publicApi
+ */
+export interface CreateDecoratorOptions<TParam = any, TTransformed = TParam> {
+  /**
+   * The key for the metadata.
+   * @default uid(21)
+   */
+  key?: string;
+
+  /**
+   * The transform function to apply to the metadata value.
+   * @default value => value
+   */
+  transform?: (value: TParam) => TTransformed;
+}
+
+type CreateDecoratorWithTransformOptions<
+  TParam,
+  TTransformed = TParam,
+> = CreateDecoratorOptions<TParam, TTransformed> &
+  Required<Pick<CreateDecoratorOptions<TParam, TTransformed>, 'transform'>>;
+
+/**
+ * @publicApi
+ */
+export type ReflectableDecorator<TParam, TTransformed = TParam> = ((
+  opts?: TParam,
+) => CustomDecorator) & {
+  KEY: string;
+};
 
 /**
  * Helper class providing Nest reflection capabilities.
@@ -9,6 +42,49 @@ import { isEmpty, isObject } from '@nestjs/common/utils/shared.utils';
  * @publicApi
  */
 export class Reflector {
+  /**
+   * Creates a decorator that can be used to decorate classes and methods with metadata.
+   * Can be used as a strongly-typed alternative to `@SetMetadata`.
+   * @param options Decorator options.
+   * @returns A decorator function.
+   */
+  static createDecorator<TParam>(
+    options?: CreateDecoratorOptions<TParam>,
+  ): ReflectableDecorator<TParam>;
+  static createDecorator<TParam, TTransformed>(
+    options: CreateDecoratorWithTransformOptions<TParam, TTransformed>,
+  ): ReflectableDecorator<TParam, TTransformed>;
+  static createDecorator<TParam, TTransformed = TParam>(
+    options: CreateDecoratorOptions<TParam, TTransformed> = {},
+  ): ReflectableDecorator<TParam, TTransformed> {
+    const metadataKey = options.key ?? uid(21);
+    const decoratorFn =
+      (metadataValue: TParam) =>
+      (target: object | Function, key?: string | symbol, descriptor?: any) => {
+        const value = options.transform
+          ? options.transform(metadataValue)
+          : metadataValue;
+        SetMetadata(metadataKey, value ?? {})(target, key, descriptor);
+      };
+
+    decoratorFn.KEY = metadataKey;
+    return decoratorFn as ReflectableDecorator<TParam, TTransformed>;
+  }
+
+  /**
+   * Retrieve metadata for a reflectable decorator for a specified target.
+   *
+   * @example
+   * `const roles = this.reflector.get(Roles, context.getHandler());`
+   *
+   * @param decorator reflectable decorator created through `Reflector.createDecorator`
+   * @param target context (decorated object) to retrieve metadata from
+   *
+   */
+  public get<T extends ReflectableDecorator<any>>(
+    decorator: T,
+    target: Type<any> | Function,
+  ): T extends ReflectableDecorator<any, infer R> ? R : unknown;
   /**
    * Retrieve metadata for a specified key for a specified target.
    *
@@ -22,10 +98,43 @@ export class Reflector {
   public get<TResult = any, TKey = any>(
     metadataKey: TKey,
     target: Type<any> | Function,
+  ): TResult;
+  /**
+   * Retrieve metadata for a specified key or decorator for a specified target.
+   *
+   * @example
+   * `const roles = this.reflector.get<string[]>('roles', context.getHandler());`
+   *
+   * @param metadataKey lookup key or decorator for metadata to retrieve
+   * @param target context (decorated object) to retrieve metadata from
+   *
+   */
+  public get<TResult = any, TKey = any>(
+    metadataKeyOrDecorator: TKey,
+    target: Type<any> | Function,
   ): TResult {
+    const metadataKey =
+      (metadataKeyOrDecorator as ReflectableDecorator<unknown>).KEY ??
+      metadataKeyOrDecorator;
+
     return Reflect.getMetadata(metadataKey, target);
   }
 
+  /**
+   * Retrieve metadata for a specified decorator for a specified set of targets.
+   *
+   * @param decorator lookup decorator for metadata to retrieve
+   * @param targets context (decorated objects) to retrieve metadata from
+   *
+   */
+  public getAll<T extends ReflectableDecorator<any>>(
+    decorator: T,
+    targets: (Type<any> | Function)[],
+  ): T extends ReflectableDecorator<infer R>
+    ? R extends Array<any>
+      ? R
+      : R[]
+    : unknown;
   /**
    * Retrieve metadata for a specified key for a specified set of targets.
    *
@@ -36,12 +145,34 @@ export class Reflector {
   public getAll<TResult extends any[] = any[], TKey = any>(
     metadataKey: TKey,
     targets: (Type<any> | Function)[],
+  ): TResult;
+  /**
+   * Retrieve metadata for a specified key or decorator for a specified set of targets.
+   *
+   * @param metadataKeyOrDecorator lookup key or decorator for metadata to retrieve
+   * @param targets context (decorated objects) to retrieve metadata from
+   *
+   */
+  public getAll<TResult extends any[] = any[], TKey = any>(
+    metadataKeyOrDecorator: TKey,
+    targets: (Type<any> | Function)[],
   ): TResult {
     return (targets || []).map(target =>
-      this.get(metadataKey, target),
+      this.get(metadataKeyOrDecorator, target),
     ) as TResult;
   }
 
+  /**
+   * Retrieve metadata for a specified decorator for a specified set of targets and merge results.
+   *
+   * @param decorator lookup decorator for metadata to retrieve
+   * @param targets context (decorated objects) to retrieve metadata from
+   *
+   */
+  public getAllAndMerge<T extends ReflectableDecorator<any>>(
+    decorator: T,
+    targets: (Type<any> | Function)[],
+  ): T extends ReflectableDecorator<infer R> ? R : unknown;
   /**
    * Retrieve metadata for a specified key for a specified set of targets and merge results.
    *
@@ -49,12 +180,23 @@ export class Reflector {
    * @param targets context (decorated objects) to retrieve metadata from
    *
    */
-  public getAllAndMerge<TResult extends any[] = any[], TKey = any>(
+  public getAllAndMerge<TResult extends any[] | object = any[], TKey = any>(
     metadataKey: TKey,
     targets: (Type<any> | Function)[],
+  ): TResult;
+  /**
+   * Retrieve metadata for a specified key or decorator for a specified set of targets and merge results.
+   *
+   * @param metadataKeyOrDecorator lookup key for metadata to retrieve
+   * @param targets context (decorated objects) to retrieve metadata from
+   *
+   */
+  public getAllAndMerge<TResult extends any[] | object = any[], TKey = any>(
+    metadataKeyOrDecorator: TKey,
+    targets: (Type<any> | Function)[],
   ): TResult {
-    const metadataCollection = this.getAll<TResult, TKey>(
-      metadataKey,
+    const metadataCollection = this.getAll<any[], TKey>(
+      metadataKeyOrDecorator,
       targets,
     ).filter(item => item !== undefined);
 
@@ -75,6 +217,17 @@ export class Reflector {
     });
   }
 
+  /**
+   * Retrieve metadata for a specified decorator for a specified set of targets and return a first not undefined value.
+   *
+   * @param decorator lookup decorator for metadata to retrieve
+   * @param targets context (decorated objects) to retrieve metadata from
+   *
+   */
+  public getAllAndOverride<T extends ReflectableDecorator<any>>(
+    decorator: T,
+    targets: (Type<any> | Function)[],
+  ): T extends ReflectableDecorator<infer R> ? R : unknown;
   /**
    * Retrieve metadata for a specified key for a specified set of targets and return a first not undefined value.
    *
@@ -85,9 +238,20 @@ export class Reflector {
   public getAllAndOverride<TResult = any, TKey = any>(
     metadataKey: TKey,
     targets: (Type<any> | Function)[],
+  ): TResult;
+  /**
+   * Retrieve metadata for a specified key or decorator for a specified set of targets and return a first not undefined value.
+   *
+   * @param metadataKeyOrDecorator lookup key or metadata for metadata to retrieve
+   * @param targets context (decorated objects) to retrieve metadata from
+   *
+   */
+  public getAllAndOverride<TResult = any, TKey = any>(
+    metadataKeyOrDecorator: TKey,
+    targets: (Type<any> | Function)[],
   ): TResult {
     for (const target of targets) {
-      const result = this.get(metadataKey, target);
+      const result = this.get(metadataKeyOrDecorator, target);
       if (result !== undefined) {
         return result;
       }

packages/core/test/errors/test/messages.spec.ts

@@ -57,6 +57,28 @@ describe('Error Messages', () => {
 
       expect(actualMessage).to.equal(expectedResult);
     });
+    it('should display the provide token as double-quoted string for string-based tokens', () => {
+      const expectedResult =
+        stringCleaner(`Nest can't resolve dependencies of the CatService (?). Please make sure that the argument "FooRepository" at index [0] is available in the current context.
+
+      Potential solutions:
+      - If "FooRepository" is a provider, is it part of the current Module?
+      - If "FooRepository" is exported from a separate @Module, is that module imported within Module?
+      @Module({
+      imports: [ /* the Module containing "FooRepository" */ ]
+      })
+      `);
+
+      const actualMessage = stringCleaner(
+        new UnknownDependenciesException('CatService', {
+          index: 0,
+          dependencies: ['FooRepository'],
+          name: 'FooRepository',
+        }).message,
+      );
+
+      expect(actualMessage).to.equal(expectedResult);
+    });
     it('should display the function name', () => {
       const expectedResult =
         stringCleaner(`Nest can't resolve dependencies of the CatService (?, CatFunction). Please make sure that the argument dependency at index [0] is available in the current context.

packages/core/test/exceptions/external-exception-filter-context.spec.ts

@@ -37,7 +37,7 @@ describe('ExternalExceptionFilterContext', () => {
       it('should return plain ExceptionHandler object', () => {
         const filter = exceptionFilter.create(
           new EmptyMetadata(),
-          () => ({} as any),
+          () => ({}) as any,
           undefined,
         );
         expect((filter as any).filters).to.be.empty;
@@ -50,7 +50,7 @@ describe('ExternalExceptionFilterContext', () => {
       it('should return ExceptionHandler object with exception filters', () => {
         const filter = exceptionFilter.create(
           new WithMetadata(),
-          () => ({} as any),
+          () => ({}) as any,
           undefined,
         );
         expect((filter as any).filters).to.not.be.empty;
@@ -105,7 +105,7 @@ describe('ExternalExceptionFilterContext', () => {
           .callsFake(() => scopedFilterWrappers);
         sinon
           .stub(instanceWrapper, 'getInstanceByContextId')
-          .callsFake(() => ({ instance } as any));
+          .callsFake(() => ({ instance }) as any);
 
         expect(exceptionFilter.getGlobalMetadata({ id: 3 })).to.contains(
           instance,

packages/core/test/guards/guards-context-creator.spec.ts

@@ -154,7 +154,7 @@ describe('GuardsContextCreator', () => {
           .callsFake(() => scopedGuardWrappers);
         sinon
           .stub(instanceWrapper, 'getInstanceByContextId')
-          .callsFake(() => ({ instance } as any));
+          .callsFake(() => ({ instance }) as any);
 
         expect(guardsContextCreator.getGlobalMetadata({ id: 3 })).to.contains(
           instance,

packages/core/test/injector/container.spec.ts

@@ -144,7 +144,7 @@ describe('NestContainer', () => {
         'bindGlobalModuleToModule',
       );
       container.bindGlobalsToImports({
-        addRelatedModule: sinon.spy(),
+        addImport: sinon.spy(),
       } as any);
       expect(bindGlobalModuleToModuleSpy.calledTwice).to.be.true;
     });
@@ -152,17 +152,17 @@ describe('NestContainer', () => {
 
   describe('bindGlobalModuleToModule', () => {
     describe('when "module" is not "globalModule"', () => {
-      it('should call "addRelatedModule"', () => {
-        const module = { addRelatedModule: sinon.spy() };
+      it('should call "addImport"', () => {
+        const module = { addImport: sinon.spy() };
         container.bindGlobalModuleToModule(module as any, null);
-        expect(module.addRelatedModule.calledOnce).to.be.true;
+        expect(module.addImport.calledOnce).to.be.true;
       });
     });
     describe('when "module" is "globalModule"', () => {
-      it('should not call "addRelatedModule"', () => {
-        const module = { addRelatedModule: sinon.spy() };
+      it('should not call "addImport"', () => {
+        const module = { addImport: sinon.spy() };
         container.bindGlobalModuleToModule(module as any, module as any);
-        expect(module.addRelatedModule.calledOnce).to.be.false;
+        expect(module.addImport.calledOnce).to.be.false;
       });
     });
   });

packages/core/test/injector/injector.spec.ts

@@ -32,7 +32,10 @@ describe('Injector', () => {
     class MainTest {
       @Inject() property: DependencyOne;
 
-      constructor(public one: DependencyOne, public two: DependencyTwo) {}
+      constructor(
+        public one: DependencyOne,
+        public two: DependencyTwo,
+      ) {}
     }
 
     let moduleDeps: Module;
@@ -743,7 +746,7 @@ describe('Injector', () => {
 
       const loadInstanceStub = sinon
         .stub(injector, 'loadInstance')
-        .callsFake(async () => ({} as any));
+        .callsFake(async () => ({}) as any);
 
       await injector.loadEnhancersPerContext(wrapper, STATIC_CONTEXT);
       expect(loadInstanceStub.calledTwice).to.be.true;

packages/core/test/interceptors/interceptors-consumer.spec.ts

@@ -174,7 +174,7 @@ describe('InterceptorsConsumer', () => {
         const val = 3;
         const next = async () => of(val);
         expect(
-          await await lastValueFrom(consumer.transformDeferred(next) as any),
+          await lastValueFrom(consumer.transformDeferred(next) as any),
         ).to.be.eql(val);
       });
     });

packages/core/test/interceptors/interceptors-context-creator.spec.ts

@@ -160,7 +160,7 @@ describe('InterceptorsContextCreator', () => {
           .callsFake(() => scopedInterceptorWrappers);
         sinon
           .stub(instanceWrapper, 'getInstanceByContextId')
-          .callsFake(() => ({ instance } as any));
+          .callsFake(() => ({ instance }) as any);
 
         expect(
           interceptorsContextCreator.getGlobalMetadata({ id: 3 }),

packages/core/test/pipes/pipes-context-creator.spec.ts

@@ -111,7 +111,7 @@ describe('PipesContextCreator', () => {
           .callsFake(() => scopedPipeWrappers);
         sinon
           .stub(instanceWrapper, 'getInstanceByContextId')
-          .callsFake(() => ({ instance } as any));
+          .callsFake(() => ({ instance }) as any);
 
         expect(creator.getGlobalMetadata({ id: 3 })).to.contains(
           instance,

packages/core/test/router/router-exception-filters.spec.ts

@@ -35,7 +35,7 @@ describe('RouterExceptionFilters', () => {
       it('should return plain ExceptionHandler object', () => {
         const filter = exceptionFilter.create(
           new EmptyMetadata(),
-          () => ({} as any),
+          () => ({}) as any,
           undefined,
         );
         expect((filter as any).filters).to.be.empty;
@@ -48,7 +48,7 @@ describe('RouterExceptionFilters', () => {
       it('should return ExceptionHandler object with exception filters', () => {
         const filter = exceptionFilter.create(
           new WithMetadata(),
-          () => ({} as any),
+          () => ({}) as any,
           undefined,
         );
         expect((filter as any).filters).to.not.be.empty;
@@ -97,7 +97,7 @@ describe('RouterExceptionFilters', () => {
           .callsFake(() => scopedFilterWrappers);
         sinon
           .stub(instanceWrapper, 'getInstanceByContextId')
-          .callsFake(() => ({ instance } as any));
+          .callsFake(() => ({ instance }) as any);
 
         expect(exceptionFilter.getGlobalMetadata({ id: 3 })).to.contains(
           instance,

packages/core/test/router/router-explorer.spec.ts

@@ -175,7 +175,7 @@ describe('RouterExplorer', () => {
         () =>
           ({
             next: nextSpy,
-          } as any),
+          }) as any,
       );
     });
 
@@ -239,4 +239,27 @@ describe('RouterExplorer', () => {
       );
     });
   });
+
+  describe('copyMetadataToCallback', () => {
+    it('should then copy the metadata from the original callback to the target callback', () => {
+      const originalCallback = () => {};
+      Reflect.defineMetadata(
+        'test_metadata_key',
+        'test_metadata_value',
+        originalCallback,
+      );
+
+      const targetCallback = () => {};
+
+      // We're using type assertion here because `copyMetadataToCallback` is private
+      (routerBuilder as any).copyMetadataToCallback(
+        originalCallback,
+        targetCallback,
+      );
+
+      expect(
+        Reflect.getMetadata('test_metadata_key', targetCallback),
+      ).to.be.equal('test_metadata_value');
+    });
+  });
 });

packages/core/test/services/reflector.service.spec.ts

@@ -1,19 +1,66 @@
 import { expect } from 'chai';
 import { Reflector } from '../../services/reflector.service';
 
+const transformDecorator = Reflector.createDecorator<string[], number>({
+  transform: value => value.length,
+});
+
 describe('Reflector', () => {
   let reflector: Reflector;
+
   class Test {}
+
+  @transformDecorator(['a', 'b', 'c'])
+  class TestTransform {}
+
   beforeEach(() => {
     reflector = new Reflector();
   });
+
   describe('get', () => {
-    it('should reflect metadata', () => {
+    it('should reflect metadata by key', () => {
       const key = 'key';
       const value = 'value';
       Reflect.defineMetadata(key, value, Test);
       expect(reflector.get(key, Test)).to.eql(value);
     });
+
+    it('should reflect metadata by decorator', () => {
+      const decorator = Reflector.createDecorator<string>();
+      const value = 'value';
+      Reflect.defineMetadata(decorator.KEY, value, Test);
+
+      let reflectedValue = reflector.get(decorator, Test);
+      expect(reflectedValue).to.eql(value);
+
+      // @ts-expect-error 'value' is not assignable to parameter of type 'string'
+      reflectedValue = true;
+    });
+
+    it('should reflect metadata by decorator (custom key)', () => {
+      const decorator = Reflector.createDecorator<string[]>({ key: 'custom' });
+      const value = ['value'];
+      Reflect.defineMetadata('custom', value, Test);
+
+      let reflectedValue = reflector.get(decorator, Test);
+      expect(reflectedValue).to.eql(value);
+
+      // @ts-expect-error 'value' is not assignable to parameter of type 'string[]'
+      reflectedValue = true;
+    });
+
+    it('should reflect metadata by decorator (with transform option)', () => {
+      let reflectedValue = reflector.get(transformDecorator, TestTransform);
+      expect(reflectedValue).to.eql(3);
+
+      // @ts-expect-error 'value' is not assignable to type 'number'
+      reflectedValue = [];
+    });
+
+    it('should require transform option when second generic type is provided', () => {
+      // @ts-expect-error Property 'transform' is missing in type {} but required in type
+      const decorator = Reflector.createDecorator<string[], number>({});
+    });
   });
 
   describe('getAll', () => {

packages/index.ts

@@ -1,6 +1,6 @@
 /*
  * Nest
- * Copyright(c) 2017 - 2021 Kamil Mysliwiec
+ * Copyright(c) 2017 - 2023 Kamil Mysliwiec
  * https://nestjs.com
  * MIT Licensed
  */

packages/microservices/Readme.md

@@ -23,7 +23,7 @@
 
 ## Description
 
-Nest is a framework for building efficient, scalable <a href="https://nodejs.org" target="_blank">Node.js</a> server-side applications. It uses modern JavaScript, is built with  <a href="https://www.typescriptlang.org" target="_blank">TypeScript</a> (preserves compatibility with pure JavaScript) and combines elements of OOP (Object Oriented Programming), FP (Functional Programming), and FRP (Functional Reactive Programming).
+Nest is a framework for building efficient, scalable <a href="https://nodejs.org" target="_blank">Node.js</a> server-side applications. It uses modern JavaScript, is built with <a href="https://www.typescriptlang.org" target="_blank">TypeScript</a> (preserves compatibility with pure JavaScript) and combines elements of OOP (Object Oriented Programming), FP (Functional Programming), and FRP (Functional Reactive Programming).
 
 <p>Under the hood, Nest makes use of <a href="https://expressjs.com/" target="_blank">Express</a>, but also, provides compatibility with a wide range of other libraries, like e.g. <a href="https://github.com/fastify/fastify" target="_blank">Fastify</a>, allowing for easy use of the myriad third-party plugins which are available.</p>
 
@@ -34,10 +34,10 @@ Nest is a framework for building efficient, scalable <a href="https://nodejs.org
 
 ## Getting started
 
-* To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
-* 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:
-* [가이드](readme_kr.md) 문서는 [docs.nestjs.com](https://docs.nestjs.com)에서 확인하실 수 있습니다. :books:
-* [ガイド](readme_jp.md)は [docs.nestjs.com](https://docs.nestjs.com)でご確認ください。 :books:
+- To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
+- 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:
+- [가이드](readme_kr.md) 문서는 [docs.nestjs.com](https://docs.nestjs.com)에서 확인하실 수 있습니다. :books:
+- [ガイド](readme_jp.md)は [docs.nestjs.com](https://docs.nestjs.com)でご確認ください。 :books:
 
 ## Questions
 
@@ -56,10 +56,13 @@ With official support, you can get expert help straight from Nest core team. We
 Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support from the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support).
 
 #### Principal Sponsors
+
 <table style="text-align:center;"><tr>
   <td><a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="200" valign="middle" /></a></td>
     <td>
 <a href="https://valor-software.com/" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="170" valign="middle" /></a></td>
+<td>
+<a href="https://amplication.com/" target="_blank"><img src="https://nestjs.com/img/amplication-logo.svg" width="190" valign="middle" /></a></td>
 </tr></table>
 
 #### Gold Sponsors
@@ -69,8 +72,7 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <td>
 <a href="https://github.com/Sanofi-IADC" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/sanofi.png" width="180" valign="middle" /></a></td>
 <td>
-<a href="https://nx.dev" target="_blank"><img src="https://nestjs.com/img/nx-logo.png" height="45" valign="middle" /></a></td><td>
-  <a href="https://amplication.com/" target="_blank"><img src="https://nestjs.com/img/amplication-logo.svg" width="190" valign="middle" /></a></td>
+<a href="https://nx.dev" target="_blank"><img src="https://nestjs.com/img/nx-logo.png" height="45" valign="middle" /></a></td>
   <td>
 <a href="https://weld.app/" target="_blank"><img src="https://nestjs.com/img/weld-logo.svg" width="140" valign="middle" /></a></td>
 <td>
@@ -86,7 +88,10 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 #### Silver Sponsors
 
 <table style="text-align:center;"><tr>
-<td><a href="https://n.inc" target="_blank"><img src="https://nestjs.com/img/n-inc-logo.svg" width="120" valign="middle" /></td></tr>
+<td><a href="https://n.inc" target="_blank"><img src="https://nestjs.com/img/n-inc-logo.svg" width="120" valign="middle" /></td>
+<td><a href="https://twistag.com/" target="_blank"><img src="https://nestjs.com/img/twistag-logo.png" width="120" valign="middle" /></td>
+<td><a href="https://immediateedgeapp.org/" target="_blank"><img src="https://nestjs.com/img/immediate-edge-logo.png" width="120" valign="middle" /></td>
+</tr>
 </table>
 
 #### Sponsors
@@ -111,6 +116,9 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
  <td align="center" valign="middle"><a href="https://nordbot.app/" target="_blank"><img src="https://nestjs.com/img/nordbot-logo.png" width="120" valign="middle" /></a></td></tr><tr>
  <td align="center" valign="middle"><a href="https://doppio.sh/" target="_blank"><img src="https://nestjs.com/img/dopiosh-logo.png" width="50" valign="middle" /></a></td>
    <td align="center" valign="middle"><a href="https://www.hingehealth.com/" target="_blank"><img src="https://nestjs.com/img/hinge-health-logo.svg" width="100" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://julienferand.dev/" target="_blank"><img src="https://nestjs.com/img/julienferand-logo.jpeg" width="65" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://www.tripoffice.com/" target="_blank"><img src="https://nestjs.com/img/tripoffice-logo.png" width="140" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://solcellsforetag.se/" target="_blank"><img src="https://nestjs.com/img/solcellsforetag-logo.svg" width="140" valign="middle" /></a></td>
   </tr></table>
 
 ## Backers
@@ -119,9 +127,9 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 
 ## Stay in touch
 
-* Author - [Kamil Myśliwiec](https://twitter.com/kammysliwiec)
-* Website - [https://nestjs.com](https://nestjs.com/)
-* Twitter - [@nestframework](https://twitter.com/nestframework)
+- Author - [Kamil Myśliwiec](https://x.com/kammysliwiec)
+- Website - [https://nestjs.com](https://nestjs.com/)
+- X - [@nestframework](https://x.com/nestframework)
 
 ## License
 

packages/microservices/client/client-rmq.ts

@@ -15,12 +15,12 @@ import { first, map, retryWhen, scan, skip, switchMap } from 'rxjs/operators';
 import {
   CONNECT_EVENT,
   CONNECT_FAILED_EVENT,
-  DISCONNECTED_RMQ_MESSAGE,
   DISCONNECT_EVENT,
+  DISCONNECTED_RMQ_MESSAGE,
   ERROR_EVENT,
   RQM_DEFAULT_IS_GLOBAL_PREFETCH_COUNT,
-  RQM_DEFAULT_NOACK,
   RQM_DEFAULT_NO_ASSERT,
+  RQM_DEFAULT_NOACK,
   RQM_DEFAULT_PERSISTENT,
   RQM_DEFAULT_PREFETCH_COUNT,
   RQM_DEFAULT_QUEUE,
@@ -267,7 +267,11 @@ export class ClientRMQ extends ClientProxy {
         content: Buffer;
         options: Record<string, unknown>;
       }) =>
-        this.handleMessage(JSON.parse(content.toString()), options, callback);
+        this.handleMessage(
+          this.parseMessageContent(content),
+          options,
+          callback,
+        );
 
       Object.assign(message, { id: correlationId });
       const serializedPacket: ReadPacket & Partial<RmqRecord> =
@@ -333,4 +337,13 @@ export class ClientRMQ extends ClientProxy {
       ...requestHeaders,
     };
   }
+
+  protected parseMessageContent(content: Buffer) {
+    const rawContent = content.toString();
+    try {
+      return JSON.parse(rawContent);
+    } catch {
+      return rawContent;
+    }
+  }
 }

packages/microservices/external/mqtt-options.interface.ts

@@ -60,6 +60,47 @@ export interface MqttClientOptions extends ISecureClientOptions {
    */
   outgoingStore?: any;
   queueQoSZero?: boolean;
+  /**
+   *  properties MQTT 5.0.
+   */
+  properties?: {
+    /**
+     * representing the Session Expiry Interval in seconds
+     */
+    sessionExpiryInterval?: number;
+    /**
+     * representing the Receive Maximum
+     */
+    receiveMaximum?: number;
+    /**
+     * representing the Maximum Packet Size the Client is willing to accept
+     */
+    maximumPacketSize?: number;
+    /**
+     * representing the Topic Alias Maximum value indicates the highest value that the Client will accept as a Topic Alias sent by the Server
+     */
+    topicAliasMaximum?: number;
+    /**
+     * The Client uses this value to request the Server to return Response Information in the CONNACK
+     */
+    requestResponseInformation?: boolean;
+    /**
+     * The Client uses this value to indicate whether the Reason String or User Properties are sent in the case of failures
+     */
+    requestProblemInformation?: boolean;
+    /**
+     * The User Property is allowed to appear multiple times to represent multiple name, value pairs
+     */
+    userProperties?: object;
+    /**
+     * the name of the authentication method used for extended authentication
+     */
+    authenticationMethod?: string;
+    /**
+     * * Binary Data containing authentication data (binary type)
+     * */
+    authenticationData?: any;
+  };
   reschedulePings?: boolean;
   servers?: Array<{
     host: string;

packages/microservices/interfaces/message-handler.interface.ts

@@ -4,9 +4,10 @@ import { Observable } from 'rxjs';
  * @publicApi
  */
 export interface MessageHandler<TInput = any, TContext = any, TResult = any> {
-  (data: TInput, ctx?: TContext):
-    | Promise<Observable<TResult>>
-    | Promise<TResult>;
+  (
+    data: TInput,
+    ctx?: TContext,
+  ): Promise<Observable<TResult>> | Promise<TResult>;
   next?: (
     data: TInput,
     ctx?: TContext,

packages/microservices/microservices-module.ts

@@ -22,7 +22,8 @@ import { ListenersController } from './listeners-controller';
 import { Server } from './server/server';
 
 export class MicroservicesModule<
-  TAppOptions extends NestApplicationContextOptions = NestApplicationContextOptions,
+  TAppOptions extends
+    NestApplicationContextOptions = NestApplicationContextOptions,
 > {
   private readonly clientsContainer = new ClientsContainer();
   private listenersController: ListenersController;

packages/microservices/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/microservices",
-  "version": "10.1.2",
+  "version": "10.2.8",
   "description": "Nest - modern, fast, powerful node.js web framework (@microservices)",
   "author": "Kamil Mysliwiec",
   "license": "MIT",
@@ -19,11 +19,11 @@
   },
   "dependencies": {
     "iterare": "1.2.1",
-    "tslib": "2.6.1"
+    "tslib": "2.6.2"
   },
   "devDependencies": {
-    "@nestjs/common": "10.1.2",
-    "@nestjs/core": "10.1.2"
+    "@nestjs/common": "10.2.8",
+    "@nestjs/core": "10.2.8"
   },
   "peerDependencies": {
     "@grpc/grpc-js": "*",

packages/microservices/record-builders/rmq.record-builder.ts

@@ -17,7 +17,10 @@ export interface RmqRecordOptions {
 }
 
 export class RmqRecord<TData = any> {
-  constructor(public readonly data: TData, public options?: RmqRecordOptions) {}
+  constructor(
+    public readonly data: TData,
+    public options?: RmqRecordOptions,
+  ) {}
 }
 
 export class RmqRecordBuilder<TData> {

packages/microservices/server/server-grpc.ts

@@ -3,7 +3,15 @@ import {
   isString,
   isUndefined,
 } from '@nestjs/common/utils/shared.utils';
-import { EMPTY, fromEvent, lastValueFrom, Subject } from 'rxjs';
+import {
+  EMPTY,
+  Observable,
+  Subject,
+  Subscription,
+  defaultIfEmpty,
+  fromEvent,
+  lastValueFrom,
+} from 'rxjs';
 import { catchError, takeUntil } from 'rxjs/operators';
 import {
   CANCEL_EVENT,
@@ -29,6 +37,7 @@ interface GrpcCall<TRequest = any, TMetadata = any> {
   end: Function;
   write: Function;
   on: Function;
+  off: Function;
   emit: Function;
 }
 
@@ -231,19 +240,119 @@ export class ServerGrpc extends Server implements CustomTransportStrategy {
     return async (call: GrpcCall, callback: Function) => {
       const handler = methodHandler(call.request, call.metadata, call);
       const result$ = this.transformToObservable(await handler);
-      await result$
-        .pipe(
-          takeUntil(fromEvent(call as any, CANCEL_EVENT)),
-          catchError(err => {
-            call.emit('error', err);
-            return EMPTY;
-          }),
-        )
-        .forEach(data => call.write(data));
-      call.end();
+
+      try {
+        await this.writeObservableToGrpc(result$, call);
+      } catch (err) {
+        call.emit('error', err);
+        return;
+      }
     };
   }
 
+  /**
+   * Writes an observable to a GRPC call.
+   *
+   * This function will ensure that backpressure is managed while writing values
+   * that come from an observable to a GRPC call.
+   *
+   * @param source The observable we want to write out to the GRPC call.
+   * @param call The GRPC call we want to write to.
+   * @returns A promise that resolves when we're done writing to the call.
+   */
+  public writeObservableToGrpc<T>(
+    source: Observable<T>,
+    call: GrpcCall<T>,
+  ): Promise<void> {
+    return new Promise((resolve, reject) => {
+      // This buffer is used to house values that arrive
+      // while the call is in the process of writing and draining.
+      const buffer: T[] = [];
+      let isComplete = false;
+      let clearToWrite = true;
+
+      const cleanups: (() => void)[] = [];
+      const cleanup = () => {
+        for (const cleanup of cleanups) {
+          cleanup();
+        }
+      };
+
+      const write = (value: T) => {
+        // If the stream `write` returns `false`, we have
+        // to wait for a drain event before writing again.
+        // This is done to handle backpressure.
+        clearToWrite = call.write(value);
+      };
+
+      const done = () => {
+        call.end();
+        resolve();
+        cleanup();
+      };
+
+      // Handling backpressure by waiting for drain event
+      const drainHandler = () => {
+        if (!clearToWrite) {
+          clearToWrite = true;
+          if (buffer.length > 0) {
+            // Write any queued values we have in our buffer.
+            write(buffer.shift()!);
+          } else if (isComplete) {
+            // Otherwise, if we're complete, end the call.
+            done();
+          }
+        }
+      };
+
+      call.on('drain', drainHandler);
+      cleanups.push(() => {
+        call.off('drain', drainHandler);
+      });
+
+      const subscription = new Subscription();
+
+      // Make sure that a cancel event unsubscribes from
+      // the source observable.
+      const cancelHandler = () => {
+        subscription.unsubscribe();
+        done();
+      };
+
+      call.on(CANCEL_EVENT, cancelHandler);
+      cleanups.push(() => {
+        call.off(CANCEL_EVENT, cancelHandler);
+      });
+
+      subscription.add(
+        source.subscribe({
+          next: (value: T) => {
+            if (clearToWrite) {
+              // If we're not currently writing, then
+              // we can write the value immediately.
+              write(value);
+            } else {
+              // If a value arrives while we're writing
+              // then we queue it up to be processed FIFO.
+              buffer.push(value);
+            }
+          },
+          error: (err: any) => {
+            call.emit('error', err);
+            reject(err);
+            cleanup();
+          },
+          complete: () => {
+            isComplete = true;
+            if (buffer.length === 0) {
+              done();
+            }
+          },
+        }),
+      );
+    });
+  }
+
   public createRequestStreamMethod(
     methodHandler: Function,
     isResponseStream: boolean,
@@ -270,17 +379,7 @@ export class ServerGrpc extends Server implements CustomTransportStrategy {
       const handler = methodHandler(req.asObservable(), call.metadata, call);
       const res = this.transformToObservable(await handler);
       if (isResponseStream) {
-        await res
-          .pipe(
-            takeUntil(fromEvent(call as any, CANCEL_EVENT)),
-            catchError(err => {
-              call.emit('error', err);
-              return EMPTY;
-            }),
-          )
-          .forEach(m => call.write(m));
-
-        call.end();
+        await this.writeObservableToGrpc(res, call);
       } else {
         const response = await lastValueFrom(
           res.pipe(
@@ -289,6 +388,7 @@ export class ServerGrpc extends Server implements CustomTransportStrategy {
               callback(err, null);
               return EMPTY;
             }),
+            defaultIfEmpty(undefined),
           ),
         );
 

packages/microservices/server/server-mqtt.ts

@@ -191,12 +191,6 @@ export class ServerMqtt extends Server implements CustomTransportStrategy {
     }
 
     for (const [key, value] of this.messageHandlers) {
-      if (
-        !key.includes(MQTT_WILDCARD_SINGLE) &&
-        !key.includes(MQTT_WILDCARD_ALL)
-      ) {
-        continue;
-      }
       const keyWithoutSharedPrefix = this.removeHandlerKeySharedPrefix(key);
       if (this.matchMqttPattern(keyWithoutSharedPrefix, route)) {
         return value;

packages/microservices/server/server-redis.ts

@@ -64,7 +64,7 @@ export class ServerRedis extends Server implements CustomTransportStrategy {
 
   public bindEvents(subClient: Redis, pubClient: Redis) {
     subClient.on(
-      this.options.wildcards ? 'pmessage' : MESSAGE_EVENT,
+      this.options?.wildcards ? 'pmessage' : MESSAGE_EVENT,
       this.getMessageHandler(pubClient).bind(this),
     );
     const subscribePatterns = [...this.messageHandlers.keys()];
@@ -75,7 +75,7 @@ export class ServerRedis extends Server implements CustomTransportStrategy {
         ? pattern
         : this.getRequestPattern(pattern);
 
-      if (this.options.wildcards) {
+      if (this.options?.wildcards) {
         subClient.psubscribe(channel);
       } else {
         subClient.subscribe(channel);
@@ -99,7 +99,7 @@ export class ServerRedis extends Server implements CustomTransportStrategy {
   }
 
   public getMessageHandler(pub: Redis) {
-    return this.options.wildcards
+    return this.options?.wildcards
       ? (channel: string, pattern: string, buffer: string | any) =>
           this.handleMessage(channel, buffer, pub, pattern)
       : (channel: string, buffer: string | any) =>

packages/microservices/test/client/client-mqtt.spec.ts

@@ -255,7 +255,7 @@ describe('ClientMqtt', () => {
           ({
             addListener: () => ({}),
             removeListener: () => ({}),
-          } as any),
+          }) as any,
       );
       handleErrorsSpy = sinon.spy(client, 'handleError');
       connect$Stub = sinon.stub(client, 'connect$' as any).callsFake(() => ({

packages/microservices/test/client/client-nats.spec.ts

@@ -241,7 +241,7 @@ describe('ClientNats', () => {
     beforeEach(async () => {
       createClientSpy = sinon
         .stub(client, 'createClient')
-        .callsFake(() => ({} as any));
+        .callsFake(() => ({}) as any);
       handleStatusUpdatesSpy = sinon.spy(client, 'handleStatusUpdates');
 
       await client.connect();

packages/microservices/test/client/client-redis.spec.ts

@@ -221,7 +221,7 @@ describe('ClientRedis', () => {
           ({
             addListener: () => null,
             removeListener: () => null,
-          } as any),
+          }) as any,
       );
       handleErrorsSpy = sinon.spy(client, 'handleError');
 

packages/microservices/test/context/exception-filters-context.spec.ts

@@ -33,7 +33,7 @@ describe('ExceptionFiltersContext', () => {
       it('should return plain ExceptionHandler object', () => {
         const filter = exceptionFilter.create(
           new EmptyMetadata(),
-          () => ({} as any),
+          () => ({}) as any,
           undefined,
         );
         expect((filter as any).filters).to.be.empty;
@@ -46,7 +46,7 @@ describe('ExceptionFiltersContext', () => {
       it('should return ExceptionHandler object with exception filters', () => {
         const filter = exceptionFilter.create(
           new WithMetadata(),
-          () => ({} as any),
+          () => ({}) as any,
           undefined,
         );
         expect((filter as any).filters).to.not.be.empty;
@@ -76,7 +76,7 @@ describe('ExceptionFiltersContext', () => {
           .callsFake(() => scopedFilterWrappers);
         sinon
           .stub(instanceWrapper, 'getInstanceByContextId')
-          .callsFake(() => ({ instance } as any));
+          .callsFake(() => ({ instance }) as any);
 
         expect(exceptionFilter.getGlobalMetadata({ id: 3 })).to.contains(
           instance,

packages/microservices/test/json-socket/message-parsing.spec.ts

@@ -107,7 +107,8 @@ describe('JsonSocket message parsing', () => {
 
   describe('Error handling', () => {
     describe('JSON Error', () => {
-      const errorMsg = `Could not parse JSON: Unexpected end of JSON input\nRequest data: "Hel`;
+      const errorMsgNodeBelowV20 = `Could not parse JSON: Unexpected end of JSON input\nRequest data: "Hel`;
+      const errorMsg = `Could not parse JSON: Unterminated string in JSON at position 4\nRequest data: "Hel`;
       const packetString = '4#"Hel';
       const packet = Buffer.from(packetString);
 
@@ -115,7 +116,7 @@ describe('JsonSocket message parsing', () => {
         try {
           socket['handleData']('4#"Hel');
         } catch (err) {
-          expect(err.message).to.deep.equal(errorMsg);
+          expect([errorMsgNodeBelowV20, errorMsg]).to.include(err.message);
         }
         expect(messages.length).to.deep.equal(0);
         expect(socket['buffer']).to.deep.equal('');
@@ -129,8 +130,17 @@ describe('JsonSocket message parsing', () => {
 
         socket['onData'](packet);
 
-        expect(socketEmitSpy.calledOnceWithExactly(ERROR_EVENT, errorMsg)).to.be
-          .true;
+        try {
+          expect(socketEmitSpy.calledOnceWithExactly(ERROR_EVENT, errorMsg)).to
+            .be.true;
+        } catch (err) {
+          expect(
+            socketEmitSpy.calledOnceWithExactly(
+              ERROR_EVENT,
+              errorMsgNodeBelowV20,
+            ),
+          ).to.be.true;
+        }
         socketEmitSpy.restore();
       });
 

packages/microservices/test/listeners-controller.spec.ts

@@ -87,7 +87,7 @@ describe('ListenersController', () => {
     ];
 
     beforeEach(() => {
-      sinon.stub(container, 'getModuleByKey').callsFake(() => ({} as any));
+      sinon.stub(container, 'getModuleByKey').callsFake(() => ({}) as any);
     });
     it(`should call "addHandler" method of server for each pattern handler`, () => {
       explorer.expects('explore').returns(handlers);
@@ -203,12 +203,12 @@ describe('ListenersController', () => {
         () =>
           ({
             handle: handleSpy,
-          } as any),
+          }) as any,
       );
 
       sinon
         .stub((instance as any).container, 'registerRequestProvider')
-        .callsFake(() => ({} as any));
+        .callsFake(() => ({}) as any);
     });
 
     describe('when "loadPerContext" resolves', () => {

packages/microservices/test/server/server-grpc.spec.ts

@@ -1,7 +1,14 @@
 import { Logger } from '@nestjs/common';
 import { expect } from 'chai';
 import { join } from 'path';
-import { of, ReplaySubject, Subject } from 'rxjs';
+import {
+  async,
+  Observable,
+  of,
+  ReplaySubject,
+  Subject,
+  throwError,
+} from 'rxjs';
 import * as sinon from 'sinon';
 import { CANCEL_EVENT } from '../../constants';
 import { InvalidGrpcPackageException } from '../../errors/invalid-grpc-package.exception';
@@ -41,7 +48,7 @@ describe('ServerGrpc', () => {
       callback = sinon.spy();
       bindEventsStub = sinon
         .stub(server, 'bindEvents')
-        .callsFake(() => ({} as any));
+        .callsFake(() => ({}) as any);
     });
 
     it('should call "bindEvents"', async () => {
@@ -85,7 +92,7 @@ describe('ServerGrpc', () => {
       callback = sinon.spy();
       bindEventsStub = sinon
         .stub(serverMulti, 'bindEvents')
-        .callsFake(() => ({} as any));
+        .callsFake(() => ({}) as any);
     });
 
     it('should call "bindEvents"', async () => {
@@ -224,7 +231,7 @@ describe('ServerGrpc', () => {
 
       const spy = sinon
         .stub(server, 'createServiceMethod')
-        .callsFake(() => ({} as any));
+        .callsFake(() => ({}) as any);
       (server as any).messageHandlers = handlers;
       await server.createService(
         {
@@ -246,7 +253,7 @@ describe('ServerGrpc', () => {
           .onFirstCall()
           .returns('test2');
 
-        sinon.stub(server, 'createServiceMethod').callsFake(() => ({} as any));
+        sinon.stub(server, 'createServiceMethod').callsFake(() => ({}) as any);
         (server as any).messageHandlers = handlers;
         await server.createService(
           {
@@ -281,7 +288,7 @@ describe('ServerGrpc', () => {
           .onSecondCall()
           .returns('test2');
 
-        sinon.stub(server, 'createServiceMethod').callsFake(() => ({} as any));
+        sinon.stub(server, 'createServiceMethod').callsFake(() => ({}) as any);
         (server as any).messageHandlers = handlers;
         await server.createService(
           {
@@ -391,29 +398,40 @@ describe('ServerGrpc', () => {
         const call = {
           write: sinon.spy(),
           end: sinon.spy(),
-          addListener: sinon.spy(),
-          removeListener: sinon.spy(),
+          on: sinon.spy(),
+          off: sinon.spy(),
         };
         const callback = sinon.spy();
         const native = sinon.spy();
 
         await server.createStreamServiceMethod(native)(call, callback);
         expect(native.called).to.be.true;
-        expect(call.addListener.calledWith('cancelled')).to.be.true;
-        expect(call.removeListener.calledWith('cancelled')).to.be.true;
+        expect(call.on.calledWith('cancelled')).to.be.true;
+        expect(call.off.calledWith('cancelled')).to.be.true;
       });
 
       it(`should close the result observable when receiving an 'cancelled' event from the client`, async () => {
-        let cancelCb: () => void;
+        const et = new EventTarget();
+        let calls = 0;
         const call = {
-          write: sinon
-            .stub()
-            .onSecondCall()
-            .callsFake(() => cancelCb()),
+          write: sinon.spy((value: any) => {
+            calls++;
+            if (calls === 2) {
+              et.dispatchEvent(new Event('cancelled'));
+            }
+            // automatically drain the call stream after this returns false.
+            Promise.resolve().then(() => et.dispatchEvent(new Event('drain')));
+            return false;
+          }),
           end: sinon.spy(),
-          addListener: (name, cb) => (cancelCb = cb),
-          removeListener: sinon.spy(),
+          on: sinon.spy((name, cb) => {
+            et.addEventListener(name, cb);
+          }),
+          off: sinon.spy((name, cb) => {
+            et.removeEventListener(name, cb);
+          }),
         };
+
         const result$ = of(1, 2, 3);
         const callback = sinon.spy();
         const native = sinon
@@ -421,8 +439,13 @@ describe('ServerGrpc', () => {
           .returns(new Promise((resolve, reject) => resolve(result$)));
 
         await server.createStreamServiceMethod(native)(call, callback);
-        expect(call.write.calledTwice).to.be.true;
+        expect(call.write.callCount).to.equal(2);
         expect(call.end.called).to.be.true;
+
+        expect(call.on.calledWith('cancelled')).to.be.true;
+        expect(call.on.calledWith('drain')).to.be.true;
+        expect(call.off.calledWith('cancelled')).to.be.true;
+        expect(call.off.calledWith('drain')).to.be.true;
       });
     });
   });
@@ -500,10 +523,32 @@ describe('ServerGrpc', () => {
       expect(handler.called).to.be.true;
       expect(handler.args[0][1]).to.eq(call.metadata);
     });
+
     describe('when response is not a stream', () => {
       it('should call callback', async () => {
         const handler = async () => ({ test: true });
         const fn = server.createRequestStreamMethod(handler, false);
+        const call = {
+          on: (event, callback) => {
+            if (event !== CANCEL_EVENT) {
+              callback();
+            }
+          },
+          off: sinon.spy(),
+          end: sinon.spy(),
+          write: sinon.spy(() => false),
+        };
+
+        const responseCallback = sinon.spy();
+        await fn(call as any, responseCallback);
+
+        expect(responseCallback.called).to.be.true;
+      });
+
+      it('should handle error thrown in handler', async () => {
+        const error = new Error('Error');
+        const handler = async () => throwError(() => error);
+        const fn = server.createRequestStreamMethod(handler, false);
         const call = {
           on: (event, callback) => {
             if (event !== CANCEL_EVENT) {
@@ -518,8 +563,10 @@ describe('ServerGrpc', () => {
         const responseCallback = sinon.spy();
         await fn(call as any, responseCallback);
 
-        expect(responseCallback.called).to.be.true;
+        expect(responseCallback.calledOnce).to.be.true;
+        expect(responseCallback.firstCall.args).to.eql([error, null]);
       });
+
       describe('when response is a stream', () => {
         it('should call write() and end()', async () => {
           const handler = async () => ({ test: true });
@@ -532,7 +579,7 @@ describe('ServerGrpc', () => {
             },
             off: sinon.spy(),
             end: sinon.spy(),
-            write: sinon.spy(),
+            write: sinon.spy(() => false),
           };
 
           await fn(call as any, null);
@@ -540,6 +587,284 @@ describe('ServerGrpc', () => {
           expect(call.write.called).to.be.true;
           expect(call.end.called).to.be.true;
         });
+
+        it('should wait for a drain event from the GRPC call before writing more data from the observable', async () => {
+          const emitter = new EventTarget();
+
+          const drain = () => {
+            emitter.dispatchEvent(new Event('drain'));
+          };
+
+          const call = {
+            write: sinon.spy(() => false),
+            end: sinon.spy(),
+            emit: sinon.spy(),
+            request: sinon.spy(),
+            metadata: sinon.spy(),
+            sendMetadata: sinon.spy(),
+            on: (name, cb) => {
+              emitter.addEventListener(name, cb);
+            },
+            off: (name, cb) => {
+              emitter.removeEventListener(name, cb);
+            },
+          };
+
+          const callback = sinon.spy();
+
+          const subject = new Subject<string>();
+          const handlerResult = Promise.resolve(subject);
+          const methodHandler = () => handlerResult;
+
+          const serviceMethod = await server.createRequestStreamMethod(
+            methodHandler,
+            true,
+          );
+
+          const result = serviceMethod(call, callback);
+
+          await handlerResult;
+
+          // Nothing has arrived from the observable yet.
+          expect(call.write.notCalled).to.be.true;
+
+          // When the observable emits the first value, it will
+          // write immediately, because the GRPC call is not being
+          // written to yet.
+          subject.next('a');
+          expect(call.write.calledOnce).to.be.true;
+
+          // The second emission from the observable will not cause
+          // a write yet, because the GRPC call has not been drained.
+          subject.next('b');
+          expect(call.write.calledOnce).to.be.true;
+
+          // Once we drain the GRPC call, "b" will be written
+          drain();
+          expect(call.write.calledTwice).to.be.true;
+
+          // After writing "b" drains, we shouldn't have written
+          // anything else yet, because we haven't gotten any more values.
+          drain();
+          expect(call.write.calledTwice).to.be.true;
+
+          // When the observable emits the third value, it will
+          // write immediately, because the GRPC call is not being
+          // written to yet.
+          subject.next('c');
+          expect(call.write.calledThrice).to.be.true;
+          drain();
+
+          // It shouldn't end until it's complete.
+          expect(call.end.notCalled).to.be.true;
+
+          subject.complete();
+          expect(call.end.called).to.be.true;
+          return result;
+        });
+
+        it('should end the subscription to the source if the call is cancelled', async () => {
+          const emitter = new EventTarget();
+
+          const drain = () => {
+            emitter.dispatchEvent(new Event('drain'));
+          };
+
+          const cancel = () => {
+            emitter.dispatchEvent(new Event(CANCEL_EVENT));
+          };
+
+          const call = {
+            write: sinon.spy(() => false),
+            end: sinon.spy(),
+            emit: sinon.spy(),
+            request: sinon.spy(),
+            metadata: sinon.spy(),
+            sendMetadata: sinon.spy(),
+            on: (name, cb) => {
+              emitter.addEventListener(name, cb);
+            },
+            off: (name, cb) => {
+              emitter.removeEventListener(name, cb);
+            },
+          };
+
+          const callback = sinon.spy();
+
+          let cancelled = false;
+          const subject = new Observable<string>(subscriber => {
+            subscriber.next('a');
+            subscriber.next('b');
+            return () => {
+              cancelled = true;
+            };
+          });
+
+          const handlerResult = Promise.resolve(subject);
+          const methodHandler = () => handlerResult;
+
+          const serviceMethod = await server.createRequestStreamMethod(
+            methodHandler,
+            true,
+          );
+
+          const result = serviceMethod(call, callback);
+
+          await handlerResult;
+
+          // The first value is written because the GRPC call
+          // is not being written to yet.
+          expect(call.write.calledOnce).to.be.true; // a
+
+          // "b" can't be written until the GRPC call is drained.
+          drain();
+          expect(call.write.calledTwice).to.be.true; // b
+
+          // We shouldn't be cancelled yet.
+          expect(cancelled).to.be.false;
+
+          // Signal that the GRPC call is cancelled.
+          cancel();
+          // we should have only written twice at this point.
+          expect(call.write.calledTwice).to.be.true;
+          expect(cancelled).to.be.true;
+
+          return result;
+        });
+
+        it('should wait to end until all values from the source have been written', async () => {
+          const emitter = new EventTarget();
+
+          const drain = () => {
+            emitter.dispatchEvent(new Event('drain'));
+          };
+
+          const call = {
+            write: sinon.spy(() => false),
+            end: sinon.spy(),
+            emit: sinon.spy(),
+            request: sinon.spy(),
+            metadata: sinon.spy(),
+            sendMetadata: sinon.spy(),
+            on: (name, cb) => {
+              emitter.addEventListener(name, cb);
+            },
+            off: (name, cb) => {
+              emitter.removeEventListener(name, cb);
+            },
+          };
+
+          const callback = sinon.spy();
+
+          const subject = new Subject<string>();
+          const handlerResult = Promise.resolve(subject);
+          const methodHandler = () => handlerResult;
+
+          const serviceMethod = await server.createRequestStreamMethod(
+            methodHandler,
+            true,
+          );
+
+          const result = serviceMethod(call, callback);
+
+          await handlerResult;
+
+          // Nothing has arrived from the observable yet.
+          expect(call.write.notCalled).to.be.true;
+
+          subject.next('a');
+          subject.next('b');
+          subject.next('c');
+          subject.complete();
+
+          expect(call.write.calledOnce).to.be.true; // a
+          expect(call.end.notCalled).to.be.true;
+
+          drain();
+          expect(call.write.calledTwice).to.be.true; // b
+          expect(call.end.notCalled).to.be.true;
+
+          drain();
+          expect(call.write.calledThrice).to.be.true; // c
+          expect(call.end.notCalled).to.be.true;
+
+          drain();
+          expect(call.end.called).to.be.true;
+          return result;
+        });
+
+        it('should only wait for drain events if the write call returns false', async () => {
+          const emitter = new EventTarget();
+
+          const drain = () => {
+            emitter.dispatchEvent(new Event('drain'));
+          };
+
+          const writeReturn = {
+            value: false,
+          };
+
+          const call = {
+            write: sinon.spy(() => writeReturn.value),
+            end: sinon.spy(),
+            emit: sinon.spy(),
+            request: sinon.spy(),
+            metadata: sinon.spy(),
+            sendMetadata: sinon.spy(),
+            on: (name, cb) => {
+              emitter.addEventListener(name, cb);
+            },
+            off: (name, cb) => {
+              emitter.removeEventListener(name, cb);
+            },
+          };
+
+          const callback = sinon.spy();
+
+          const subject = new Subject<string>();
+          const handlerResult = Promise.resolve(subject);
+          const methodHandler = () => handlerResult;
+
+          const serviceMethod = await server.createRequestStreamMethod(
+            methodHandler,
+            true,
+          );
+
+          const result = serviceMethod(call, callback);
+
+          await handlerResult;
+
+          // Nothing has arrived from the observable yet.
+          expect(call.write.notCalled).to.be.true;
+
+          writeReturn.value = true; // no drain needed
+
+          subject.next('a');
+
+          expect(call.write.calledOnce).to.be.true; // a
+          expect(call.end.notCalled).to.be.true;
+
+          writeReturn.value = false; // drain needed
+          subject.next('b');
+
+          expect(call.write.calledTwice).to.be.true; // b
+          expect(call.end.notCalled).to.be.true;
+
+          subject.next('c');
+
+          expect(call.write.calledTwice).to.be.true; // drain not called yet.
+          expect(call.end.notCalled).to.be.true;
+
+          drain();
+          expect(call.write.calledThrice).to.be.true; // c
+          expect(call.end.notCalled).to.be.true;
+
+          subject.complete();
+
+          drain();
+          expect(call.end.called).to.be.true;
+          return result;
+        });
       });
     });
   });

packages/microservices/test/server/server-kafka.spec.ts

@@ -126,7 +126,7 @@ describe('ServerKafka', () => {
     it('should call "bindEvents"', async () => {
       bindEventsStub = sinon
         .stub(server, 'bindEvents')
-        .callsFake(() => ({} as any));
+        .callsFake(() => ({}) as any);
       await server.listen(callback);
       expect(bindEventsStub.called).to.be.true;
     });

packages/microservices/test/server/server-redis.spec.ts

@@ -134,13 +134,13 @@ describe('ServerRedis', () => {
     });
     it('should call "handleEvent" if identifier is not present', async () => {
       const handleEventSpy = sinon.spy(server, 'handleEvent');
-      sinon.stub(server, 'parseMessage').callsFake(() => ({ data } as any));
+      sinon.stub(server, 'parseMessage').callsFake(() => ({ data }) as any);
 
       await server.handleMessage(channel, JSON.stringify({}), null, channel);
       expect(handleEventSpy.called).to.be.true;
     });
     it(`should publish NO_MESSAGE_HANDLER if pattern not exists in messageHandlers object`, async () => {
-      sinon.stub(server, 'parseMessage').callsFake(() => ({ id, data } as any));
+      sinon.stub(server, 'parseMessage').callsFake(() => ({ id, data }) as any);
       await server.handleMessage(
         channel,
         JSON.stringify({ id }),
@@ -160,7 +160,7 @@ describe('ServerRedis', () => {
       (server as any).messageHandlers = objectToMap({
         [channel]: handler,
       });
-      sinon.stub(server, 'parseMessage').callsFake(() => ({ id, data } as any));
+      sinon.stub(server, 'parseMessage').callsFake(() => ({ id, data }) as any);
 
       await server.handleMessage(channel, {}, null, channel);
       expect(handler.calledWith(data)).to.be.true;

packages/microservices/test/server/server-rmq.spec.ts

@@ -29,7 +29,7 @@ describe('ServerRMQ', () => {
       createChannelStub = sinon.stub().callsFake(({ setup }) => setup());
       setupChannelStub = sinon
         .stub(server, 'setupChannel')
-        .callsFake(() => ({} as any));
+        .callsFake(() => ({}) as any);
 
       client = {
         on: onStub,

packages/platform-express/Readme.md

@@ -23,7 +23,7 @@
 
 ## Description
 
-Nest is a framework for building efficient, scalable <a href="https://nodejs.org" target="_blank">Node.js</a> server-side applications. It uses modern JavaScript, is built with  <a href="https://www.typescriptlang.org" target="_blank">TypeScript</a> (preserves compatibility with pure JavaScript) and combines elements of OOP (Object Oriented Programming), FP (Functional Programming), and FRP (Functional Reactive Programming).
+Nest is a framework for building efficient, scalable <a href="https://nodejs.org" target="_blank">Node.js</a> server-side applications. It uses modern JavaScript, is built with <a href="https://www.typescriptlang.org" target="_blank">TypeScript</a> (preserves compatibility with pure JavaScript) and combines elements of OOP (Object Oriented Programming), FP (Functional Programming), and FRP (Functional Reactive Programming).
 
 <p>Under the hood, Nest makes use of <a href="https://expressjs.com/" target="_blank">Express</a>, but also, provides compatibility with a wide range of other libraries, like e.g. <a href="https://github.com/fastify/fastify" target="_blank">Fastify</a>, allowing for easy use of the myriad third-party plugins which are available.</p>
 
@@ -34,10 +34,10 @@ Nest is a framework for building efficient, scalable <a href="https://nodejs.org
 
 ## Getting started
 
-* To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
-* 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:
-* [가이드](readme_kr.md) 문서는 [docs.nestjs.com](https://docs.nestjs.com)에서 확인하실 수 있습니다. :books:
-* [ガイド](readme_jp.md)は [docs.nestjs.com](https://docs.nestjs.com)でご確認ください。 :books:
+- To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
+- 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:
+- [가이드](readme_kr.md) 문서는 [docs.nestjs.com](https://docs.nestjs.com)에서 확인하실 수 있습니다. :books:
+- [ガイド](readme_jp.md)は [docs.nestjs.com](https://docs.nestjs.com)でご確認ください。 :books:
 
 ## Questions
 
@@ -56,10 +56,13 @@ With official support, you can get expert help straight from Nest core team. We
 Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support from the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support).
 
 #### Principal Sponsors
+
 <table style="text-align:center;"><tr>
   <td><a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="200" valign="middle" /></a></td>
     <td>
 <a href="https://valor-software.com/" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="170" valign="middle" /></a></td>
+<td>
+<a href="https://amplication.com/" target="_blank"><img src="https://nestjs.com/img/amplication-logo.svg" width="190" valign="middle" /></a></td>
 </tr></table>
 
 #### Gold Sponsors
@@ -69,8 +72,7 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <td>
 <a href="https://github.com/Sanofi-IADC" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/sanofi.png" width="180" valign="middle" /></a></td>
 <td>
-<a href="https://nx.dev" target="_blank"><img src="https://nestjs.com/img/nx-logo.png" height="45" valign="middle" /></a></td><td>
-  <a href="https://amplication.com/" target="_blank"><img src="https://nestjs.com/img/amplication-logo.svg" width="190" valign="middle" /></a></td>
+<a href="https://nx.dev" target="_blank"><img src="https://nestjs.com/img/nx-logo.png" height="45" valign="middle" /></a></td>
   <td>
 <a href="https://weld.app/" target="_blank"><img src="https://nestjs.com/img/weld-logo.svg" width="140" valign="middle" /></a></td>
 <td>
@@ -86,7 +88,10 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 #### Silver Sponsors
 
 <table style="text-align:center;"><tr>
-<td><a href="https://n.inc" target="_blank"><img src="https://nestjs.com/img/n-inc-logo.svg" width="120" valign="middle" /></td></tr>
+<td><a href="https://n.inc" target="_blank"><img src="https://nestjs.com/img/n-inc-logo.svg" width="120" valign="middle" /></td>
+<td><a href="https://twistag.com/" target="_blank"><img src="https://nestjs.com/img/twistag-logo.png" width="120" valign="middle" /></td>
+<td><a href="https://immediateedgeapp.org/" target="_blank"><img src="https://nestjs.com/img/immediate-edge-logo.png" width="120" valign="middle" /></td>
+</tr>
 </table>
 
 #### Sponsors
@@ -111,6 +116,9 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
  <td align="center" valign="middle"><a href="https://nordbot.app/" target="_blank"><img src="https://nestjs.com/img/nordbot-logo.png" width="120" valign="middle" /></a></td></tr><tr>
  <td align="center" valign="middle"><a href="https://doppio.sh/" target="_blank"><img src="https://nestjs.com/img/dopiosh-logo.png" width="50" valign="middle" /></a></td>
    <td align="center" valign="middle"><a href="https://www.hingehealth.com/" target="_blank"><img src="https://nestjs.com/img/hinge-health-logo.svg" width="100" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://julienferand.dev/" target="_blank"><img src="https://nestjs.com/img/julienferand-logo.jpeg" width="65" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://www.tripoffice.com/" target="_blank"><img src="https://nestjs.com/img/tripoffice-logo.png" width="140" valign="middle" /></a></td>
+   <td align="center" valign="middle"><a href="https://solcellsforetag.se/" target="_blank"><img src="https://nestjs.com/img/solcellsforetag-logo.svg" width="140" valign="middle" /></a></td>
   </tr></table>
 
 ## Backers
@@ -119,9 +127,9 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 
 ## Stay in touch
 
-* Author - [Kamil Myśliwiec](https://twitter.com/kammysliwiec)
-* Website - [https://nestjs.com](https://nestjs.com/)
-* Twitter - [@nestframework](https://twitter.com/nestframework)
+- Author - [Kamil Myśliwiec](https://x.com/kammysliwiec)
+- Website - [https://nestjs.com](https://nestjs.com/)
+- X - [@nestframework](https://x.com/nestframework)
 
 ## License
 

packages/platform-express/adapters/express-adapter.ts

@@ -96,14 +96,15 @@ export class ExpressAdapter extends AbstractHttpAdapter<
         response,
         (err: Error) => {
           if (err) {
-            this.logger.error(err.message, err.stack);
+            body.errorLogger(err);
           }
         },
       );
     }
+    const responseContentType = response.getHeader('Content-Type');
     if (
-      response.getHeader('Content-Type') !== undefined &&
-      !response.getHeader('Content-Type').startsWith('application/json') &&
+      typeof responseContentType === 'string' &&
+      !responseContentType.startsWith('application/json') &&
       body?.statusCode >= HttpStatus.BAD_REQUEST
     ) {
       this.logger.warn(

packages/platform-express/multer/interceptors/any-files.interceptor.ts

@@ -17,8 +17,8 @@ import { transformException } from '../multer/multer.utils';
 type MulterInstance = any;
 
 /**
- * @param localOptions 
- * 
+ * @param localOptions
+ *
  * @publicApi
  */
 export function AnyFilesInterceptor(

packages/platform-express/multer/interceptors/file-fields.interceptor.ts

@@ -20,8 +20,8 @@ import { transformException } from '../multer/multer.utils';
 type MulterInstance = any;
 
 /**
- * @param uploadFields 
- * @param localOptions 
+ * @param uploadFields
+ * @param localOptions
  * @publicApi
  */
 export function FileFieldsInterceptor(

packages/platform-express/multer/interceptors/file.interceptor.ts

@@ -17,9 +17,9 @@ import { transformException } from '../multer/multer.utils';
 type MulterInstance = any;
 
 /**
- * @param fieldName 
- * @param localOptions 
- * 
+ * @param fieldName
+ * @param localOptions
+ *
  * @publicApi
  */
 export function FileInterceptor(

packages/platform-express/multer/interceptors/files.interceptor.ts

@@ -17,12 +17,12 @@ import { transformException } from '../multer/multer.utils';
 type MulterInstance = any;
 
 /**
- * 
- * @param fieldName 
- * @param maxCount 
- * @param localOptions 
- * 
- * @publicApi 
+ *
+ * @param fieldName
+ * @param maxCount
+ * @param localOptions
+ *
+ * @publicApi
  */
 export function FilesInterceptor(
   fieldName: string,

packages/platform-express/multer/interceptors/no-files.interceptor.ts

@@ -17,8 +17,8 @@ import { transformException } from '../multer/multer.utils';
 type MulterInstance = any;
 
 /**
- * 
- * @param localOptions 
+ *
+ * @param localOptions
  * @publicApi
  */
 export function NoFilesInterceptor(

packages/platform-express/multer/interfaces/files-upload-module.interface.ts

@@ -10,7 +10,6 @@ export interface MulterOptionsFactory {
   createMulterOptions(): Promise<MulterModuleOptions> | MulterModuleOptions;
 }
 
-
 /**
  * @publicApi
  */

packages/platform-express/multer/interfaces/multer-options.interface.ts

@@ -1,10 +1,10 @@
 /**
  * @see https://github.com/expressjs/multer
- * 
+ *
  * @publicApi
  */
 export interface MulterOptions {
-  dest?: string;
+  dest?: string | Function;
   /** The storage engine to use for uploaded files. */
   storage?: any;
   /**

packages/platform-express/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/platform-express",
-  "version": "10.1.2",
+  "version": "10.2.8",
   "description": "Nest - modern, fast, powerful node.js web framework (@platform-express)",
   "author": "Kamil Mysliwiec",
   "license": "MIT",
@@ -22,11 +22,11 @@
     "cors": "2.8.5",
     "express": "4.18.2",
     "multer": "1.4.4-lts.1",
-    "tslib": "2.6.1"
+    "tslib": "2.6.2"
   },
   "devDependencies": {
-    "@nestjs/common": "10.1.2",
-    "@nestjs/core": "10.1.2"
+    "@nestjs/common": "10.2.8",
+    "@nestjs/core": "10.2.8"
   },
   "peerDependencies": {
     "@nestjs/common": "^10.0.0",