style(): auto-organise import statements

feat: timestemp inside LoggerSerivce can be overridden

.github/dependabot.yml

@@ -0,0 +1,7 @@
+version: 2
+updates:
+- package-ecosystem: npm
+  directory: "/"
+  schedule:
+    interval: daily
+  open-pull-requests-limit: 10

CONTRIBUTING.md

@@ -237,7 +237,7 @@ Samples: (even more [samples](https://github.com/nestjs/nest/commits/master))
 
 ```
 docs(changelog): update change log to beta.5
-bugfix(core): need to depend on latest rxjs and zone.js
+fix(core): need to depend on latest rxjs and zone.js
 ```
 
 ### Revert
@@ -249,14 +249,16 @@ If the commit reverts a previous commit, it should begin with `revert:`, followe
 Must be one of the following:
 
 - **build**: Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)
+- **chore**: Updating tasks etc; no production code change
 - **ci**: Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)
 - **docs**: Documentation only changes
-- **feature**: A new feature
+- **feat**: A new feature
 - **fix**: A bug fix
 - **perf**: A code change that improves performance
 - **refactor**: A code change that neither fixes a bug nor adds a feature
 - **style**: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
 - **test**: Adding missing tests or correcting existing tests
+- **sample**: A change to the samples
 
 ### Scope
 

Readme.md

@@ -66,7 +66,8 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <a href="https://neoteric.eu/" target="_blank"><img src="https://nestjs.com/img/neoteric-cut.png" width="120" valign="middle" /></a> </td><td>
   <a href="http://gojob.com" target="_blank"><img src="http://nestjs.com/img/gojob-logo.png" valign="middle" width="100" /></a> </td><td>
     <a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="170" valign="middle" /></a> </td><td>
-<a href="http://www.leogistics.com" target="_blank"><img src="https://nestjs.com/img/leogistics-logo.jpeg" width="150" valign="middle" /></td></tr></table>
+<a href="http://www.leogistics.com" target="_blank"><img src="https://nestjs.com/img/leogistics-logo.jpeg" width="150" valign="middle" /></td><td>
+<a href="http://www.meetdandy.com" target="_blank"><img src="https://nestjs.com/img/dandy-wide-logo.png" width="150" valign="middle" /></td></tr></table>
 
 #### Sponsors
 
@@ -84,12 +85,11 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <a href="https://clay.global/" target="_blank"><img src="https://nestjs.com/img/clay-logo.svg" width="75" valign="middle" /></a> </td><td align="center" valign="middle">
 <a href="https://firesticktricks.com" target="_blank"><img src="https://nestjs.com/img/firesticktricks-logo.png" width="120" valign="middle" /></a></td></tr><tr><td align="center" valign="middle">
 <a href="https://www.codeguesser.co.uk" target="_blank"><img src="https://nestjs.com/img/codeguesser-logo.svg" width="120" valign="middle" /></a> </td><td align="center" valign="middle">
-<a href="https://tekhattan.com" target="_blank"><img src="https://nestjs.com/img/tekhattan-logo.png" width="110" valign="middle" /></a> </td><td align="center" valign="middle">
 <a href="https://f-a.nz/" target="_blank"><img src="https://nestjs.com/img/franz.svg" width="80" valign="middle" /></a> </td><td align="center" valign="middle">
 <a href="https://sparkfabrik.com/" target="_blank"><img src="https://nestjs.com/img/sparkfabrik-logo.png" width="120" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://www.thebigphonestore.co.uk/" target="_blank"><img src="https://nestjs.com/img/the-big-phone-store-logo.png" width="65" valign="middle" /></a></td>
   <td align="center" valign="middle">
-  <a href="https://genuinebee.com/" target="_blank"><img src="https://nestjs.com/img/genuinebee.svg" width="97" valign="middle" /></a> </td></tr>
-<tr><td align="center" valign="middle"><a href="https://sanyodigital.com/" target="_blank"><img src="https://nestjs.com/img/sanyo-digital.png" width="130" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://vpn-review.com/vpn-for-torrenting" target="_blank"><img src="https://nestjs.com/img/vpn-review-logo.png" width="85" valign="middle" /></a></td>
+  <a href="https://genuinebee.com/" target="_blank"><img src="https://nestjs.com/img/genuinebee.svg" width="97" valign="middle" /></a> </td>
+<td align="center" valign="middle"><a href="https://sanyodigital.com/" target="_blank"><img src="https://nestjs.com/img/sanyo-digital.png" width="130" valign="middle" /></a></td></tr><tr><td align="center" valign="middle"><a href="https://vpn-review.com/vpn-for-torrenting" target="_blank"><img src="https://nestjs.com/img/vpn-review-logo.png" width="85" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://lambda-it.ch/" target="_blank"><img src="https://nestjs.com/img/lambda-it-logo.svg" width="115" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://pickwriters.com/top-10-translation-services" target="_blank"><img src="https://nestjs.com/img/pickwriters-logo.png" width="40" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://thewordpoint.com/services/localization" target="_blank"><img src="https://nestjs.com/img/thewordpoint-logo.png" width="40" valign="middle" /></a></td>
   </tr></table>
 
 ## Backers

integration/docker-compose.yml

@@ -23,7 +23,7 @@ services:
       - "9001:9001"
     restart: always
   mysql:
-    image: mysql:5.7.31
+    image: mysql:5.7.32
     environment:
       MYSQL_ROOT_PASSWORD: root
       MYSQL_DATABASE: test
@@ -48,7 +48,7 @@ services:
   zookeeper:
     container_name: test-zookeeper
     hostname: zookeeper
-    image: confluentinc/cp-zookeeper:5.3.2
+    image: confluentinc/cp-zookeeper:5.5.2
     ports:
       - "2181:2181"
     environment:
@@ -57,7 +57,7 @@ services:
   kafka:
     container_name: test-kafka
     hostname: kafka
-    image: confluentinc/cp-kafka:5.5.1
+    image: confluentinc/cp-kafka:5.5.2
     depends_on:
       - zookeeper
     ports:

integration/hello-world/e2e/fastify-adapter.spec.ts

@@ -63,6 +63,14 @@ describe('Hello world (fastify adapter)', () => {
       });
   });
 
+  it(`/GET inject with LightMyRequest chaining API`, () => {
+    return app
+      .inject()
+      .get('/hello')
+      .end()
+      .then(({ payload }) => expect(payload).to.be.eql('Hello world!'));
+  });
+
   afterEach(async () => {
     await app.close();
   });

integration/microservices/e2e/orders-grpc.spec.ts

@@ -113,6 +113,11 @@ describe('Advanced GRPC transport', () => {
   it('GRPC Sending and receiving Stream from RX handler', async () => {
     const callHandler = client.sync();
 
+    // Get Set-Cookie from Metadata
+    callHandler.on('metadata', (metadata: GRPC.Metadata) => {
+      expect(metadata.get('Set-Cookie')[0]).to.eq('test_cookie=abcd');
+    });
+
     callHandler.on('data', (msg: number) => {
       // Do deep comparison (to.eql)
       expect(msg).to.eql({

integration/microservices/src/grpc-advanced/advanced.grpc.controller.ts

@@ -9,6 +9,7 @@ import {
 } from '@nestjs/microservices';
 import { join } from 'path';
 import { Observable, of, ReplaySubject, Subject } from 'rxjs';
+import { Metadata } from 'grpc';
 
 @Controller()
 export class AdvancedGrpcController {
@@ -84,7 +85,16 @@ export class AdvancedGrpcController {
    * @param messages
    */
   @GrpcStreamMethod('orders.OrderService')
-  async sync(messages: Observable<any>): Promise<any> {
+  async sync(
+    messages: Observable<any>,
+    metadata: Metadata,
+    call: any,
+  ): Promise<any> {
+    // Set Set-Cookie from Metadata
+    const srvMetadata = new Metadata();
+    srvMetadata.add('Set-Cookie', 'test_cookie=abcd');
+    call.sendMetadata(srvMetadata);
+
     const s = new Subject();
     const o = s.asObservable();
     messages.subscribe(msg => {

integration/nest-application/app-locals/e2e/express.spec.ts

@@ -0,0 +1,38 @@
+import { NestExpressApplication } from '@nestjs/platform-express';
+import { Test, TestingModule } from '@nestjs/testing';
+import { expect } from 'chai';
+import * as request from 'supertest';
+import { AppModule } from '../src/app.module';
+
+describe('App-level globals (Express Application)', () => {
+  let moduleFixture: TestingModule;
+  let app: NestExpressApplication;
+
+  beforeEach(async () => {
+    moduleFixture = await Test.createTestingModule({
+      imports: [AppModule],
+    }).compile();
+  });
+
+  beforeEach(() => {
+    app = moduleFixture.createNestApplication<NestExpressApplication>();
+  });
+
+  it('should get "title" from "app.locals"', async () => {
+    app.setLocal('title', 'My Website');
+    await app.init();
+    const response = await request(app.getHttpServer()).get('/').expect(200);
+    expect(response.body.title).to.equal('My Website');
+  });
+
+  it('should get "email" from "app.locals"', async () => {
+    app.setLocal('email', 'admin@example.com');
+    await app.listen(4444);
+    const response = await request(app.getHttpServer()).get('/').expect(200);
+    expect(response.body.email).to.equal('admin@example.com');
+  });
+
+  afterEach(async () => {
+    await app.close();
+  });
+});

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

@@ -0,0 +1,10 @@
+import { Controller, Get, Req } from '@nestjs/common';
+import { Request } from 'express';
+
+@Controller()
+export class AppController {
+  @Get()
+  getGlobals(@Req() req: Request) {
+    return req.app.locals;
+  }
+}

integration/nest-application/app-locals/src/app.module.ts

@@ -0,0 +1,7 @@
+import { Module } from '@nestjs/common';
+import { AppController } from './app.controller';
+
+@Module({
+  controllers: [AppController],
+})
+export class AppModule {}

integration/nest-application/app-locals/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": false,
+    "noImplicitAny": false,
+    "removeComments": true,
+    "noLib": false,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "target": "es6",
+    "sourceMap": true,
+    "allowJs": true,
+    "outDir": "./dist"
+  },
+  "include": [
+    "src/**/*",
+    "e2e/**/*"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

integration/nest-application/get-url/e2e/express.spec.ts

@@ -37,6 +37,13 @@ describe('Get URL (Express Application)', () => {
     expect(await app.getUrl()).to.be.eql(`http://127.0.0.1:${port}`);
     await app.close();
   });
+  it('should return 127.0.0.1 even in a callback', () => {
+    const app = testModule.createNestApplication(new ExpressAdapter(express()));
+    return app.listen(port, async () => {
+      expect(await app.getUrl()).to.be.eql(`http://127.0.0.1:${port}`);
+      await app.close();
+    });
+  });
   it('should throw an error for calling getUrl before listen', async () => {
     const app = testModule.createNestApplication(new ExpressAdapter(express()));
     try {

integration/nest-application/get-url/e2e/fastify.spec.ts

@@ -30,6 +30,13 @@ describe('Get URL (Fastify Application)', () => {
     expect(await app.getUrl()).to.be.eql(`http://127.0.0.1:${port}`);
     await app.close();
   });
+  it('should return 127.0.0.1 even in a callback', () => {
+    const app = testModule.createNestApplication(new FastifyAdapter());
+    return app.listen(port, async () => {
+      expect(await app.getUrl()).to.be.eql(`http://127.0.0.1:${port}`);
+      await app.close();
+    });
+  });
   it('should throw an error for calling getUrl before listen', async () => {
     const app = testModule.createNestApplication(new FastifyAdapter());
     try {

integration/websockets/e2e/gateway-ack.spec.ts

@@ -28,5 +28,18 @@ describe('WebSocketGateway (ack)', () => {
     );
   });
 
+  it(`should handle message with ack & without data (http)`, async () => {
+    app = await createNestApp(AckGateway);
+    await app.listenAsync(3000);
+
+    ws = io.connect('http://localhost:8080');
+    await new Promise(resolve =>
+      ws.emit('push', data => {
+        expect(data).to.be.eql('pong');
+        resolve();
+      }),
+    );
+  });
+
   afterEach(() => app.close());
 });

lerna.json

@@ -3,5 +3,5 @@
   "packages": [
     "packages/*"
   ],
-  "version": "7.4.4"
+  "version": "7.5.5"
 }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/core",
-  "version": "7.4.0",
+  "version": "7.5.3",
   "description": "Modern, fast, powerful node.js web framework",
   "homepage": "https://nestjs.com",
   "repository": {
@@ -51,119 +51,120 @@
     ]
   },
   "dependencies": {
-    "@nuxtjs/opencollective": "0.2.2",
-    "axios": "0.20.0",
+    "@nuxtjs/opencollective": "0.3.2",
+    "axios": "0.21.0",
     "class-transformer": "0.3.1",
     "class-validator": "0.12.2",
     "cli-color": "2.0.0",
     "cors": "2.8.5",
     "express": "4.17.1",
-    "fast-json-stringify": "2.2.3",
+    "fast-json-stringify": "2.2.10",
     "fast-safe-stringify": "2.0.7",
     "iterare": "1.2.1",
     "object-hash": "2.0.3",
     "path-to-regexp": "3.2.0",
     "reflect-metadata": "0.1.13",
-    "rxjs": "6.6.2",
+    "rxjs": "6.6.3",
     "socket.io": "2.3.0",
-    "uuid": "8.3.0",
-    "tslib": "2.0.1"
+    "uuid": "8.3.1",
+    "tslib": "2.0.3"
   },
   "devDependencies": {
     "@codechecks/client": "0.1.10",
-    "@commitlint/cli": "9.1.2",
-    "@commitlint/config-angular": "9.1.2",
+    "@commitlint/cli": "11.0.0",
+    "@commitlint/config-angular": "11.0.0",
     "@grpc/proto-loader": "0.5.5",
-    "@nestjs/graphql": "7.6.0",
-    "@nestjs/mongoose": "7.0.2",
-    "@nestjs/typeorm": "7.1.1",
-    "@types/amqplib": "0.5.13",
+    "@nestjs/graphql": "7.9.1",
+    "@nestjs/mongoose": "7.1.2",
+    "@nestjs/typeorm": "7.1.5",
+    "@types/amqplib": "0.5.16",
     "@types/bytes": "3.1.0",
     "@types/cache-manager": "2.10.3",
-    "@types/chai": "4.2.12",
+    "@types/chai": "4.2.14",
     "@types/chai-as-promised": "7.1.3",
-    "@types/cors": "2.8.7",
-    "@types/express": "4.17.7",
-    "@types/gulp": "4.0.6",
-    "@types/mocha": "8.0.3",
-    "@types/mongoose": "5.7.36",
-    "@types/node": "10.17.3",
-    "@types/redis": "2.8.26",
-    "@types/reflect-metadata": "0.0.5",
-    "@types/sinon": "9.0.5",
-    "@types/socket.io": "2.1.11",
-    "@types/ws": "7.2.6",
-    "@typescript-eslint/eslint-plugin": "3.10.1",
-    "@typescript-eslint/parser": "3.10.1",
-    "amqp-connection-manager": "3.2.0",
+    "@types/cors": "2.8.8",
+    "@types/express": "4.17.9",
+    "@types/gulp": "4.0.7",
+    "@types/mocha": "8.0.4",
+    "@types/mongoose": "5.10.2",
+    "@types/node": "14.14.10",
+    "@types/redis": "2.8.28",
+    "@types/reflect-metadata": "0.1.0",
+    "@types/sinon": "9.0.9",
+    "@types/socket.io": "2.1.12",
+    "@types/ws": "7.4.0",
+    "@typescript-eslint/eslint-plugin": "4.9.1",
+    "@typescript-eslint/parser": "4.9.0",
+    "amqp-connection-manager": "3.2.1",
     "amqplib": "0.6.0",
-    "apollo-server-express": "2.17.0",
+    "apollo-server-express": "2.19.0",
     "artillery": "1.6.1",
     "awesome-typescript-loader": "5.2.1",
     "body-parser": "1.19.0",
     "bytes": "3.1.0",
-    "cache-manager": "3.3.0",
+    "cache-manager": "3.4.0",
     "chai": "4.2.0",
     "chai-as-promised": "7.1.1",
     "clang-format": "1.4.0",
     "commitlint-circle": "1.0.0",
     "concurrently": "5.3.0",
-    "conventional-changelog": "3.1.23",
-    "core-js": "3.6.5",
+    "conventional-changelog": "3.1.24",
+    "core-js": "3.8.1",
     "coveralls": "3.1.0",
     "delete-empty": "3.0.0",
-    "engine.io-client": "3.4.3",
-    "eslint": "7.7.0",
-    "eslint-config-prettier": "6.11.0",
-    "eslint-plugin-import": "2.22.0",
+    "engine.io-client": "4.0.4",
+    "eslint": "7.15.0",
+    "eslint-config-prettier": "7.0.0",
+    "eslint-plugin-import": "2.22.1",
+    "eventsource": "1.0.7",
     "fancy-log": "1.3.3",
-    "fastify": "3.3.0",
-    "fastify-cors": "4.1.0",
+    "fastify": "3.9.1",
+    "fastify-cors": "5.0.0",
     "fastify-formbody": "5.0.0",
-    "fastify-multipart": "3.1.0",
-    "fastify-static": "3.2.0",
-    "graphql": "15.3.0",
-    "graphql-tools": "6.1.0",
-    "grpc": "1.24.3",
+    "fastify-multipart": "3.3.1",
+    "fastify-static": "3.3.0",
+    "graphql": "15.4.0",
+    "graphql-tools": "7.0.2",
+    "grpc": "1.24.4",
     "gulp": "4.0.2",
     "gulp-clang-format": "1.0.27",
     "gulp-clean": "0.4.0",
-    "gulp-sourcemaps": "2.6.5",
+    "gulp-sourcemaps": "3.0.0",
     "gulp-typescript": "5.0.1",
     "gulp-watch": "5.0.1",
-    "husky": "4.2.5",
-    "imports-loader": "1.1.0",
+    "husky": "4.3.5",
+    "imports-loader": "1.2.0",
     "json-loader": "0.5.7",
     "kafkajs": "1.12.0",
     "lerna": "2.11.0",
-    "light-my-request": "4.0.2",
-    "lint-staged": "10.2.13",
+    "light-my-request": "4.3.0",
+    "lint-staged": "10.5.3",
     "markdown-table": "2.0.0",
     "merge-graphql-schemas": "1.7.8",
-    "middie": "5.1.0",
-    "mocha": "8.1.3",
-    "mongoose": "5.10.2",
-    "mqtt": "4.2.1",
+    "middie": "5.2.0",
+    "mocha": "8.2.1",
+    "mongoose": "5.11.5",
+    "mqtt": "4.2.6",
     "multer": "1.4.2",
     "mysql": "2.18.1",
     "nats": "1.4.12",
-    "nodemon": "2.0.4",
+    "nodemon": "2.0.6",
     "nyc": "15.1.0",
-    "point-of-view": "4.4.0",
-    "prettier": "2.1.1",
+    "point-of-view": "4.7.0",
+    "prettier": "2.2.1",
     "redis": "3.0.2",
-    "rxjs-compat": "6.6.2",
-    "sinon": "9.0.3",
+    "rxjs-compat": "6.6.3",
+    "sinon": "9.2.1",
     "sinon-chai": "3.5.0",
-    "socket.io-client": "2.3.0",
+    "socket.io-client": "2.3.1",
     "subscriptions-transport-ws": "0.9.18",
-    "supertest": "4.0.2",
-    "ts-morph": "8.1.0",
-    "ts-node": "9.0.0",
-    "typeorm": "0.2.25",
-    "typescript": "4.0.2",
-    "wrk": "1.2.0",
-    "ws": "7.3.1"
+    "supertest": "6.0.1",
+    "ts-morph": "9.1.0",
+    "ts-node": "9.1.1",
+    "typeorm": "0.2.29",
+    "typescript": "4.0.3",
+    "wrk": "1.2.1",
+    "ws": "7.4.1"
   },
   "engines": {
     "node": ">= 10.13.0"

packages/common/Readme.md

@@ -66,7 +66,8 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <a href="https://neoteric.eu/" target="_blank"><img src="https://nestjs.com/img/neoteric-cut.png" width="120" valign="middle" /></a> </td><td>
   <a href="http://gojob.com" target="_blank"><img src="http://nestjs.com/img/gojob-logo.png" valign="middle" width="100" /></a> </td><td>
     <a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="170" valign="middle" /></a> </td><td>
-<a href="http://www.leogistics.com" target="_blank"><img src="https://nestjs.com/img/leogistics-logo.jpeg" width="150" valign="middle" /></td></tr></table>
+<a href="http://www.leogistics.com" target="_blank"><img src="https://nestjs.com/img/leogistics-logo.jpeg" width="150" valign="middle" /></td><td>
+<a href="http://www.meetdandy.com" target="_blank"><img src="https://nestjs.com/img/dandy-wide-logo.png" width="150" valign="middle" /></td></tr></table>
 
 #### Sponsors
 
@@ -84,12 +85,11 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <a href="https://clay.global/" target="_blank"><img src="https://nestjs.com/img/clay-logo.svg" width="75" valign="middle" /></a> </td><td align="center" valign="middle">
 <a href="https://firesticktricks.com" target="_blank"><img src="https://nestjs.com/img/firesticktricks-logo.png" width="120" valign="middle" /></a></td></tr><tr><td align="center" valign="middle">
 <a href="https://www.codeguesser.co.uk" target="_blank"><img src="https://nestjs.com/img/codeguesser-logo.svg" width="120" valign="middle" /></a> </td><td align="center" valign="middle">
-<a href="https://tekhattan.com" target="_blank"><img src="https://nestjs.com/img/tekhattan-logo.png" width="110" valign="middle" /></a> </td><td align="center" valign="middle">
 <a href="https://f-a.nz/" target="_blank"><img src="https://nestjs.com/img/franz.svg" width="80" valign="middle" /></a> </td><td align="center" valign="middle">
 <a href="https://sparkfabrik.com/" target="_blank"><img src="https://nestjs.com/img/sparkfabrik-logo.png" width="120" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://www.thebigphonestore.co.uk/" target="_blank"><img src="https://nestjs.com/img/the-big-phone-store-logo.png" width="65" valign="middle" /></a></td>
   <td align="center" valign="middle">
-  <a href="https://genuinebee.com/" target="_blank"><img src="https://nestjs.com/img/genuinebee.svg" width="97" valign="middle" /></a> </td></tr>
-<tr><td align="center" valign="middle"><a href="https://sanyodigital.com/" target="_blank"><img src="https://nestjs.com/img/sanyo-digital.png" width="130" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://vpn-review.com/vpn-for-torrenting" target="_blank"><img src="https://nestjs.com/img/vpn-review-logo.png" width="85" valign="middle" /></a></td>
+  <a href="https://genuinebee.com/" target="_blank"><img src="https://nestjs.com/img/genuinebee.svg" width="97" valign="middle" /></a> </td>
+<td align="center" valign="middle"><a href="https://sanyodigital.com/" target="_blank"><img src="https://nestjs.com/img/sanyo-digital.png" width="130" valign="middle" /></a></td></tr><tr><td align="center" valign="middle"><a href="https://vpn-review.com/vpn-for-torrenting" target="_blank"><img src="https://nestjs.com/img/vpn-review-logo.png" width="85" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://lambda-it.ch/" target="_blank"><img src="https://nestjs.com/img/lambda-it-logo.svg" width="115" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://pickwriters.com/top-10-translation-services" target="_blank"><img src="https://nestjs.com/img/pickwriters-logo.png" width="40" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://thewordpoint.com/services/localization" target="_blank"><img src="https://nestjs.com/img/thewordpoint-logo.png" width="40" valign="middle" /></a></td>
   </tr></table>
 
 ## Backers

packages/common/cache/decorators/cache-ttl.decorator.ts

@@ -1,4 +1,5 @@
 import { SetMetadata } from '../../decorators';
+import { ExecutionContext } from '../../interfaces/features/execution-context.interface';
 import { CACHE_TTL_METADATA } from '../cache.constants';
 
 /**
@@ -12,4 +13,6 @@ import { CACHE_TTL_METADATA } from '../cache.constants';
  *
  * @publicApi
  */
-export const CacheTTL = (ttl: number) => SetMetadata(CACHE_TTL_METADATA, ttl);
+type CacheTTLFactory = (ctx: ExecutionContext) => Promise<number> | number;
+export const CacheTTL = (ttl: number | CacheTTLFactory) =>
+  SetMetadata(CACHE_TTL_METADATA, ttl);

packages/common/cache/index.ts

@@ -1,4 +1,4 @@
-export { CACHE_MANAGER } from './cache.constants';
+export * from './cache.constants';
 export * from './cache.module';
 export * from './decorators';
 export * from './interceptors';

packages/common/cache/interceptors/cache.interceptor.ts

@@ -7,7 +7,7 @@ import {
   HttpServer,
   NestInterceptor,
 } from '../../interfaces';
-import { isNil } from '../../utils/shared.utils';
+import { isFunction, isNil } from '../../utils/shared.utils';
 import {
   CACHE_KEY_METADATA,
   CACHE_MANAGER,
@@ -37,7 +37,7 @@ export class CacheInterceptor implements NestInterceptor {
     next: CallHandler,
   ): Promise<Observable<any>> {
     const key = this.trackBy(context);
-    const ttl =
+    const ttlValueOrFactory =
       this.reflector.get(CACHE_TTL_METADATA, context.getHandler()) || null;
 
     if (!key) {
@@ -48,7 +48,9 @@ export class CacheInterceptor implements NestInterceptor {
       if (!isNil(value)) {
         return of(value);
       }
-
+      const ttl = isFunction(ttlValueOrFactory)
+        ? await ttlValueOrFactory(context)
+        : ttlValueOrFactory;
       return next.handle().pipe(
         tap(response => {
           const args = isNil(ttl) ? [key, response] : [key, response, { ttl }];

packages/common/constants.ts

@@ -26,3 +26,5 @@ export const HTTP_CODE_METADATA = '__httpCode__';
 export const MODULE_PATH = '__module_path__';
 export const HEADERS_METADATA = '__headers__';
 export const REDIRECT_METADATA = '__redirect__';
+export const RESPONSE_PASSTHROUGH_METADATA = '__responsePassthrough__';
+export const SSE_METADATA = '__sse__';

packages/common/decorators/core/controller.decorator.ts

@@ -3,8 +3,8 @@ import {
   PATH_METADATA,
   SCOPE_OPTIONS_METADATA,
 } from '../../constants';
-import { isString, isUndefined } from '../../utils/shared.utils';
 import { ScopeOptions } from '../../interfaces/scope-options.interface';
+import { isString, isUndefined } from '../../utils/shared.utils';
 
 /**
  * Interface defining options that can be passed to `@Controller()` decorator
@@ -18,7 +18,7 @@ export interface ControllerOptions extends ScopeOptions {
    *
    * @see [Routing](https://docs.nestjs.com/controllers#routing)
    */
-  path?: string;
+  path?: string | string[];
 
   /**
    * Specifies an optional HTTP Request host filter.  When configured, methods
@@ -65,7 +65,7 @@ export function Controller(): ClassDecorator;
  * It defines a class that provides a context for one or more message or event
  * handlers.
  *
- * @param {string} prefix string that defines a `route path prefix`.  The prefix
+ * @param {string, Array} prefix string that defines a `route path prefix`.  The prefix
  * is pre-pended to the path specified in any request decorator in the class.
  *
  * @see [Routing](https://docs.nestjs.com/controllers#routing)
@@ -74,7 +74,7 @@ export function Controller(): ClassDecorator;
  *
  * @publicApi
  */
-export function Controller(prefix: string): ClassDecorator;
+export function Controller(prefix: string | string[]): ClassDecorator;
 
 /**
  * Decorator that marks a class as a Nest controller that can receive inbound
@@ -137,12 +137,13 @@ export function Controller(options: ControllerOptions): ClassDecorator;
  * @publicApi
  */
 export function Controller(
-  prefixOrOptions?: string | ControllerOptions,
+  prefixOrOptions?: string | string[] | ControllerOptions,
 ): ClassDecorator {
   const defaultPath = '/';
+
   const [path, host, scopeOptions] = isUndefined(prefixOrOptions)
     ? [defaultPath, undefined, undefined]
-    : isString(prefixOrOptions)
+    : isString(prefixOrOptions) || Array.isArray(prefixOrOptions)
     ? [prefixOrOptions, undefined, undefined]
     : [
         prefixOrOptions.path || defaultPath,

packages/common/decorators/http/index.ts

@@ -5,3 +5,4 @@ export * from './create-route-param-metadata.decorator';
 export * from './render.decorator';
 export * from './header.decorator';
 export * from './redirect.decorator';
+export * from './sse.decorator';

packages/common/decorators/http/route-params.decorator.ts

@@ -1,9 +1,26 @@
-import { ROUTE_ARGS_METADATA } from '../../constants';
+import {
+  RESPONSE_PASSTHROUGH_METADATA,
+  ROUTE_ARGS_METADATA,
+} from '../../constants';
 import { RouteParamtypes } from '../../enums/route-paramtypes.enum';
 import { PipeTransform } from '../../index';
 import { Type } from '../../interfaces';
 import { isNil, isString } from '../../utils/shared.utils';
 
+/**
+ * The `@Response()`/`@Res` parameter decorator options.
+ */
+export interface ResponseDecoratorOptions {
+  /**
+   * Determines whether the response will be sent manually within the route handler,
+   * with the use of native response handling methods exposed by the platform-specific response object,
+   * or if it should passthrough Nest response processing pipeline.
+   *
+   * @default false
+   */
+  passthrough: boolean;
+}
+
 export type ParamData = object | string | number;
 export interface RouteParamMetadata {
   index: number;
@@ -85,21 +102,35 @@ export const Request: () => ParameterDecorator = createRouteParamDecorator(
  *
  * Example: `logout(@Response() res)`
  *
- * @see [Request object](https://docs.nestjs.com/controllers#request-object)
- *
  * @publicApi
  */
-export const Response: () => ParameterDecorator = createRouteParamDecorator(
-  RouteParamtypes.RESPONSE,
-);
+export const Response: (
+  options?: ResponseDecoratorOptions,
+) => ParameterDecorator = (options?: ResponseDecoratorOptions) => (
+  target,
+  key,
+  index,
+) => {
+  if (options?.passthrough) {
+    Reflect.defineMetadata(
+      RESPONSE_PASSTHROUGH_METADATA,
+      options?.passthrough,
+      target.constructor,
+      key,
+    );
+  }
+  return createRouteParamDecorator(RouteParamtypes.RESPONSE)()(
+    target,
+    key,
+    index,
+  );
+};
 
 /**
  * Route handler parameter decorator. Extracts reference to the `Next` function
  * from the underlying platform and populates the decorated
  * parameter with the value of `Next`.
  *
- * @see [Request object](https://docs.nestjs.com/controllers#request-object)
- *
  * @publicApi
  */
 export const Next: () => ParameterDecorator = createRouteParamDecorator(

packages/common/decorators/http/sse.decorator.ts

@@ -0,0 +1,26 @@
+import { METHOD_METADATA, PATH_METADATA, SSE_METADATA } from '../../constants';
+import { RequestMethod } from '../../enums/request-method.enum';
+
+/**
+ * Declares this route as a Server-Sent-Events endpoint
+ *
+ * @publicApi
+ */
+export function Sse(path?: string): MethodDecorator {
+  return (
+    target: object,
+    key: string | symbol,
+    descriptor: TypedPropertyDescriptor<any>,
+  ) => {
+    path = path && path.length ? path : '/';
+
+    Reflect.defineMetadata(PATH_METADATA, path, descriptor.value);
+    Reflect.defineMetadata(
+      METHOD_METADATA,
+      RequestMethod.GET,
+      descriptor.value,
+    );
+    Reflect.defineMetadata(SSE_METADATA, true, descriptor.value);
+    return descriptor;
+  };
+}

packages/common/enums/http-status.enum.ts

@@ -2,6 +2,7 @@ export enum HttpStatus {
   CONTINUE = 100,
   SWITCHING_PROTOCOLS = 101,
   PROCESSING = 102,
+  EARLYHINTS = 103,
   OK = 200,
   CREATED = 201,
   ACCEPTED = 202,
@@ -35,6 +36,7 @@ export enum HttpStatus {
   REQUESTED_RANGE_NOT_SATISFIABLE = 416,
   EXPECTATION_FAILED = 417,
   I_AM_A_TEAPOT = 418,
+  MISDIRECTED = 421,
   UNPROCESSABLE_ENTITY = 422,
   FAILED_DEPENDENCY = 424,
   TOO_MANY_REQUESTS = 429,

packages/common/exceptions/gateway-timeout.exception.ts

@@ -2,7 +2,7 @@ import { HttpStatus } from '../enums/http-status.enum';
 import { HttpException } from './http.exception';
 
 /**
- * Defines an HTTP exception for *Gatway Timeout* type errors.
+ * Defines an HTTP exception for *Gateway Timeout* type errors.
  *
  * @see [Base Exceptions](https://docs.nestjs.com/exception-filters#base-exceptions)
  *

packages/common/exceptions/http.exception.ts

@@ -67,14 +67,15 @@ export class HttpException extends Error {
 
   public static createBody(
     objectOrError: object | string,
-    message?: string,
+    description?: string,
     statusCode?: number,
   ) {
     if (!objectOrError) {
-      return { statusCode, message };
+      return { statusCode, message: description };
     }
     return isObject(objectOrError) && !Array.isArray(objectOrError)
       ? objectOrError
-      : { statusCode, message: objectOrError, error: message };
+      : { statusCode, message: objectOrError, error: description };
   }
 }
+

packages/common/exceptions/index.ts

@@ -19,3 +19,4 @@ export * from './service-unavailable.exception';
 export * from './gateway-timeout.exception';
 export * from './im-a-teapot.exception';
 export * from './precondition-failed.exception';
+export * from './misdirected.exception';

packages/common/exceptions/misdirected.exception.ts

@@ -0,0 +1,49 @@
+import { HttpStatus } from '../enums/http-status.enum';
+import { HttpException } from './http.exception';
+
+/**
+ * Defines an HTTP exception for *Misdirected* type errors.
+ *
+ * @see [Base Exceptions](https://docs.nestjs.com/exception-filters#base-exceptions)
+ *
+ * @publicApi
+ */
+export class MisdirectedException extends HttpException {
+  /**
+   * Instantiate a `MisdirectedException` Exception.
+   *
+   * @example
+   * `throw new MisdirectedException()`
+   *
+   * @usageNotes
+   * The HTTP response status code will be 421.
+   * - The `objectOrError` argument defines the JSON response body or the message string.
+   * - The `description` argument contains a short description of the HTTP error.
+   *
+   * By default, the JSON response body contains two properties:
+   * - `statusCode`: this will be the value 421.
+   * - `message`: the string `'Bad Gateway'` by default; override this by supplying
+   * a string in the `objectOrError` parameter.
+   *
+   * If the parameter `objectOrError` is a string, the response body will contain an
+   * additional property, `error`, with a short description of the HTTP error. To override the
+   * entire JSON response body, pass an object instead. Nest will serialize the object
+   * and return it as the JSON response body.
+   *
+   * @param objectOrError string or object describing the error condition.
+   * @param description a short description of the HTTP error.
+   */
+  constructor(
+    objectOrError?: string | object | any,
+    description = 'Misdirected',
+  ) {
+    super(
+      HttpException.createBody(
+        objectOrError,
+        description,
+        HttpStatus.MISDIRECTED,
+      ),
+      HttpStatus.MISDIRECTED,
+    );
+  }
+}

packages/common/index.ts

@@ -31,6 +31,7 @@ export {
   INestApplicationContext,
   INestMicroservice,
   IntrospectionResult,
+  MessageEvent,
   MiddlewareConsumer,
   ModuleMetadata,
   NestApplicationOptions,

packages/common/interfaces/http/index.ts

@@ -0,0 +1,2 @@
+export * from './http-server.interface';
+export * from './message-event.interface';

packages/common/interfaces/http/message-event.interface.ts

@@ -0,0 +1,6 @@
+export interface MessageEvent {
+  data: string | object;
+  id?: string;
+  type?: string;
+  retry?: number;
+}

packages/common/interfaces/index.ts

@@ -13,7 +13,7 @@ export * from './features/nest-interceptor.interface';
 export * from './features/paramtype.interface';
 export * from './features/pipe-transform.interface';
 export * from './hooks';
-export * from './http/http-server.interface';
+export * from './http';
 export * from './injectable.interface';
 export * from './microservices/nest-hybrid-application-options.interface';
 export * from './middleware';

packages/common/interfaces/middleware/middleware-config-proxy.interface.ts

@@ -6,7 +6,7 @@ export interface MiddlewareConfigProxy {
   /**
    * Excludes routes from the currently processed middleware.
    *
-   * @param  {} ...routes
+   * @param {(string | RouteInfo)[]} routes
    * @returns {MiddlewareConfigProxy}
    */
   exclude(...routes: (string | RouteInfo)[]): MiddlewareConfigProxy;
@@ -15,7 +15,7 @@ export interface MiddlewareConfigProxy {
    * Attaches passed either routes or controllers to the currently configured middleware.
    * If you pass a class, Nest would attach middleware to every path defined within this controller.
    *
-   * @param  {} ...routes
+   * @param {(string | Type | RouteInfo)[]} routes
    * @returns {MiddlewareConsumer}
    */
   forRoutes(...routes: (string | Type<any> | RouteInfo)[]): MiddlewareConsumer;

packages/common/interfaces/middleware/middleware-consumer.interface.ts

@@ -10,7 +10,7 @@ import { MiddlewareConfigProxy } from './middleware-config-proxy.interface';
  */
 export interface MiddlewareConsumer {
   /**
-   * @param  middleware middleware class/function or array of classes/functions
+   * @param {...(Type | Function)} middleware middleware class/function or array of classes/functions
    * to be attached to the passed routes.
    *
    * @returns {MiddlewareConfigProxy}

packages/common/interfaces/modules/dynamic-module.interface.ts

@@ -21,7 +21,7 @@ export interface DynamicModule extends ModuleMetadata {
    * in all modules. Thereafter, modules that wish to inject a service exported
    * from a global module do not need to import the provider module.
    *
-   * Default: false
+   * @default false
    */
   global?: boolean;
 }

packages/common/interfaces/nest-application-context-options.interface.ts

@@ -8,4 +8,11 @@ export class NestApplicationContextOptions {
    * Specifies the logger to use.  Pass `false` to turn off logging.
    */
   logger?: LoggerService | LogLevel[] | boolean;
+
+  /**
+   * Whether to abort the process on Error. By default, the process is exited.
+   * Pass `false` to override the default behavior. If `false` is passed, Nest will not exit
+   * the application and instead will rethrow the exception.
+   */
+  abortOnError?: boolean | undefined;
 }

packages/common/interfaces/nest-application-context.interface.ts

@@ -1,5 +1,5 @@
 import { ShutdownSignal } from '../enums/shutdown-signal.enum';
-import { LoggerService } from '../services/logger.service';
+import { LoggerService, LogLevel } from '../services/logger.service';
 import { Abstract } from './abstract.interface';
 import { Type } from './type.interface';
 
@@ -53,7 +53,7 @@ export interface INestApplicationContext {
    * Sets custom logger service
    * @returns {void}
    */
-  useLogger(logger: LoggerService): void;
+  useLogger(logger: LoggerService | LogLevel[] | false): void;
 
   /**
    * Enables the usage of shutdown hooks. Will call the

packages/common/interfaces/nest-application.interface.ts

@@ -21,7 +21,7 @@ export interface INestApplication extends INestApplicationContext {
    * A wrapper function around HTTP adapter method: `adapter.use()`.
    * Example `app.use(cors())`
    *
-   * @returns {void}
+   * @returns {this}
    */
   use(...args: any[]): this;
 
@@ -35,10 +35,10 @@ export interface INestApplication extends INestApplicationContext {
   /**
    * Starts the application.
    *
-   * @param  {number} port
-   * @param  {string} hostname
-   * @param  {Function} callback Optional callback
-   * @returns A Promise that, when resolved, is a reference to the underlying HttpServer.
+   * @param {number|string} port
+   * @param {string} [hostname]
+   * @param {Function} [callback] Optional callback
+   * @returns {Promise} A Promise that, when resolved, is a reference to the underlying HttpServer.
    */
   listen(port: number | string, callback?: () => void): Promise<any>;
   listen(
@@ -50,15 +50,15 @@ export interface INestApplication extends INestApplicationContext {
   /**
    * Returns the url the application is listening at, based on OS and IP version. Returns as an IP value either in IPv6 or IPv4
    *
-   * @returns The IP where the server is listening
+   * @returns {Promise<string>} The IP where the server is listening
    */
   getUrl(): Promise<string>;
 
   /**
    * Starts the application (can be awaited).
    *
-   * @param  {number} port
-   * @param  {string} hostname (optional)
+   * @param {number|string} port
+   * @param {string} [hostname]
    * @returns {Promise}
    */
   listenAsync(port: number | string, hostname?: string): Promise<any>;
@@ -66,17 +66,17 @@ export interface INestApplication extends INestApplicationContext {
   /**
    * Registers a prefix for every HTTP route path.
    *
-   * @param  {string} prefix The prefix for every HTTP route path (for example `/v1/api`)
-   * @returns {void}
+   * @param {string} prefix The prefix for every HTTP route path (for example `/v1/api`)
+   * @returns {this}
    */
   setGlobalPrefix(prefix: string): this;
 
   /**
-   * Setup Ws Adapter which will be used inside Gateways.
+   * Register Ws Adapter which will be used inside Gateways.
    * Use when you want to override default `socket.io` library.
    *
-   * @param  {WebSocketAdapter} adapter
-   * @returns {void}
+   * @param {WebSocketAdapter} adapter
+   * @returns {this}
    */
   useWebSocketAdapter(adapter: WebSocketAdapter): this;
 
@@ -84,8 +84,9 @@ export interface INestApplication extends INestApplicationContext {
    * Connects microservice to the NestApplication instance. Transforms application
    * to a hybrid instance.
    *
-   * @param  {T} options Microservice options object
-   * @param  {NestHybridApplicationOptions} hybridOptions Hybrid options object
+   * @template {object} T
+   * @param {T} options Microservice options object
+   * @param {NestHybridApplicationOptions} hybridOptions Hybrid options object
    * @returns {INestMicroservice}
    */
   connectMicroservice<T extends object = any>(
@@ -103,7 +104,7 @@ export interface INestApplication extends INestApplicationContext {
   /**
    * Returns the underlying native HTTP server.
    *
-   * @returns {any}
+   * @returns {*}
    */
   getHttpServer(): any;
 
@@ -117,8 +118,8 @@ export interface INestApplication extends INestApplicationContext {
   /**
    * Starts all connected microservices asynchronously.
    *
-   * @param  {Function} callback Optional callback function
-   * @returns {void}
+   * @param {Function} [callback] Optional callback function
+   * @returns {this}
    */
   startAllMicroservices(callback?: () => void): this;
 
@@ -133,14 +134,14 @@ export interface INestApplication extends INestApplicationContext {
    * Registers exception filters as global filters (will be used within
    * every HTTP route handler)
    *
-   * @param  {ExceptionFilter[]} ...filters
+   * @param {...ExceptionFilter} filters
    */
   useGlobalFilters(...filters: ExceptionFilter[]): this;
 
   /**
    * Registers pipes as global pipes (will be used within every HTTP route handler)
    *
-   * @param  {PipeTransform[]} ...pipes
+   * @param {...PipeTransform} pipes
    */
   useGlobalPipes(...pipes: PipeTransform<any>[]): this;
 
@@ -148,14 +149,14 @@ export interface INestApplication extends INestApplicationContext {
    * Registers interceptors as global interceptors (will be used within
    * every HTTP route handler)
    *
-   * @param  {NestInterceptor[]} ...interceptors
+   * @param {...NestInterceptor} interceptors
    */
   useGlobalInterceptors(...interceptors: NestInterceptor[]): this;
 
   /**
    * Registers guards as global guards (will be used within every HTTP route handler)
    *
-   * @param  {CanActivate[]} ...guards
+   * @param {...CanActivate} guards
    */
   useGlobalGuards(...guards: CanActivate[]): this;
 

packages/common/interfaces/nest-microservice.interface.ts

@@ -14,11 +14,10 @@ export interface INestMicroservice extends INestApplicationContext {
   /**
    * Starts the microservice.
    *
-   * @param  {Function} callback
-   * @returns {Promise}
-   *
+   * @param {Function} callback
+   * @returns {void}
    */
-  listen(callback: () => void): any;
+  listen(callback: () => void): void;
 
   /**
    * Starts the microservice (can be awaited).
@@ -29,38 +28,38 @@ export interface INestMicroservice extends INestApplicationContext {
 
   /**
    * Register Ws Adapter which will be used inside Gateways.
-   * Use, when you want to override default `socket.io` library.
+   * Use when you want to override default `socket.io` library.
    *
-   * @param  {WebSocketAdapter} adapter
-   * @returns {void}
+   * @param {WebSocketAdapter} adapter
+   * @returns {this}
    */
   useWebSocketAdapter(adapter: WebSocketAdapter): this;
 
   /**
-   * Registers exception filters as a global filters (will be used within every message pattern handler)
+   * Registers exception filters as global filters (will be used within every message pattern handler)
    *
-   * @param  {ExceptionFilter[]} ...filters
+   * @param {...ExceptionFilter} filters
    */
   useGlobalFilters(...filters: ExceptionFilter[]): this;
 
   /**
-   * Registers pipes as a global pipes (will be used within every message pattern handler)
+   * Registers pipes as global pipes (will be used within every message pattern handler)
    *
-   * @param  {PipeTransform[]} ...pipes
+   * @param {...PipeTransform} pipes
    */
   useGlobalPipes(...pipes: PipeTransform<any>[]): this;
 
   /**
-   * Registers interceptors as a global interceptors (will be used within every message pattern handler)
+   * Registers interceptors as global interceptors (will be used within every message pattern handler)
    *
-   * @param  {NestInterceptor[]} ...interceptors
+   * @param {...NestInterceptor} interceptors
    */
   useGlobalInterceptors(...interceptors: NestInterceptor[]): this;
 
   /**
-   * Registers guards as a global guards (will be used within every message pattern handler)
+   * Registers guards as global guards (will be used within every message pattern handler)
    *
-   * @param  {CanActivate[]} ...guards
+   * @param {...CanActivate} guards
    */
   useGlobalGuards(...guards: CanActivate[]): this;
 

packages/common/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/common",
-  "version": "7.4.4",
+  "version": "7.5.5",
   "description": "Nest - modern, fast, powerful node.js web framework (@common)",
   "author": "Kamil Mysliwiec",
   "homepage": "https://nestjs.com",
@@ -17,11 +17,10 @@
   },
   "license": "MIT",
   "dependencies": {
-    "axios": "0.20.0",
-    "cli-color": "2.0.0",
+    "axios": "0.21.0",
     "iterare": "1.2.1",
-    "tslib": "2.0.1",
-    "uuid": "8.3.0"
+    "tslib": "2.0.3",
+    "uuid": "8.3.1"
   },
   "peerDependencies": {
     "reflect-metadata": "^0.1.12",

packages/common/pipes/validation.pipe.ts

@@ -60,16 +60,28 @@ export class ValidationPipe implements PipeTransform<any> {
     this.exceptionFactory =
       options.exceptionFactory || this.createExceptionFactory();
 
-    classValidator = loadPackage('class-validator', 'ValidationPipe', () =>
+    classValidator = this.loadValidator();
+    classTransformer = this.loadTransformer();
+  }
+
+  protected loadValidator() {
+    return loadPackage('class-validator', 'ValidationPipe', () =>
       require('class-validator'),
     );
-    classTransformer = loadPackage('class-transformer', 'ValidationPipe', () =>
+  }
+
+  protected loadTransformer() {
+    return loadPackage('class-transformer', 'ValidationPipe', () =>
       require('class-transformer'),
     );
   }
 
   public async transform(value: any, metadata: ArgumentMetadata) {
-    const metatype = this.expectedType || metadata.metatype;
+    if (this.expectedType) {
+      metadata = { ...metadata, metatype: this.expectedType };
+    }
+
+    const metatype = metadata.metatype;
     if (!metatype || !this.toValidate(metadata)) {
       return this.isTransformEnabled
         ? this.transformPrimitive(value, metadata)
@@ -101,7 +113,7 @@ export class ValidationPipe implements PipeTransform<any> {
 
     const errors = await classValidator.validate(entity, this.validatorOptions);
     if (errors.length > 0) {
-      throw this.exceptionFactory(errors);
+      throw await this.exceptionFactory(errors);
     }
     if (isPrimitive) {
       // if the value is a primitive value and the validation process has been successfully completed
@@ -130,16 +142,16 @@ export class ValidationPipe implements PipeTransform<any> {
     };
   }
 
-  private toValidate(metadata: ArgumentMetadata): boolean {
+  protected toValidate(metadata: ArgumentMetadata): boolean {
     const { metatype, type } = metadata;
     if (type === 'custom' && !this.validateCustomDecorators) {
       return false;
     }
-    const types = [String, Boolean, Number, Array, Object];
+    const types = [String, Boolean, Number, Array, Object, Buffer];
     return !types.some(t => metatype === t) && !isNil(metatype);
   }
 
-  private transformPrimitive(value: any, metadata: ArgumentMetadata) {
+  protected transformPrimitive(value: any, metadata: ArgumentMetadata) {
     if (!metadata.data) {
       // leave top-level query/param objects unmodified
       return value;
@@ -157,11 +169,11 @@ export class ValidationPipe implements PipeTransform<any> {
     return value;
   }
 
-  private toEmptyIfNil<T = any, R = any>(value: T): R | {} {
+  protected toEmptyIfNil<T = any, R = any>(value: T): R | {} {
     return isNil(value) ? {} : value;
   }
 
-  private stripProtoKeys(value: Record<string, any>) {
+  protected stripProtoKeys(value: Record<string, any>) {
     delete value.__proto__;
     const keys = Object.keys(value);
     iterate(keys)
@@ -169,11 +181,11 @@ export class ValidationPipe implements PipeTransform<any> {
       .forEach(key => this.stripProtoKeys(value[key]));
   }
 
-  private isPrimitive(value: unknown): boolean {
+  protected isPrimitive(value: unknown): boolean {
     return ['number', 'boolean', 'string'].includes(typeof value);
   }
 
-  private flattenValidationErrors(
+  protected flattenValidationErrors(
     validationErrors: ValidationError[],
   ): string[] {
     return iterate(validationErrors)
@@ -185,7 +197,7 @@ export class ValidationPipe implements PipeTransform<any> {
       .toArray();
   }
 
-  private mapChildrenToValidationErrors(
+  protected mapChildrenToValidationErrors(
     error: ValidationError,
   ): ValidationError[] {
     if (!(error.children && error.children.length)) {
@@ -201,7 +213,7 @@ export class ValidationPipe implements PipeTransform<any> {
     return validationErrors;
   }
 
-  private prependConstraintsWithParentProp(
+  protected prependConstraintsWithParentProp(
     parentError: ValidationError,
     error: ValidationError,
   ): ValidationError {

packages/common/services/logger.service.ts

@@ -1,10 +1,9 @@
-import * as clc from 'cli-color';
 import { Injectable } from '../decorators/core/injectable.decorator';
 import { Optional } from '../decorators/core/optional.decorator';
+import { clc, yellow } from '../utils/cli-colors.util';
 import { isObject } from '../utils/shared.utils';
 
 declare const process: any;
-const yellow = clc.xterm(3);
 
 export type LogLevel = 'log' | 'error' | 'warn' | 'debug' | 'verbose';
 
@@ -26,7 +25,7 @@ export class Logger implements LoggerService {
     'verbose',
   ];
   private static lastTimestamp?: number;
-  private static instance?: typeof Logger | LoggerService = Logger;
+  protected static instance?: typeof Logger | LoggerService = Logger;
 
   constructor(
     @Optional() protected context?: string,
@@ -62,6 +61,10 @@ export class Logger implements LoggerService {
     this.context = context;
   }
 
+  getTimestamp() {
+    return Logger.getTimestamp();
+  }
+
   static overrideLogger(logger: LoggerService | LogLevel[] | boolean) {
     if (Array.isArray(logger)) {
       this.logLevels = logger;
@@ -96,6 +99,18 @@ export class Logger implements LoggerService {
     this.printMessage(message, clc.cyanBright, context, isTimeDiffEnabled);
   }
 
+  static getTimestamp() {
+    const localeStringOptions = {
+      year: 'numeric',
+      hour: 'numeric',
+      minute: 'numeric',
+      second: 'numeric',
+      day: '2-digit',
+      month: '2-digit',
+    };
+    return new Date(Date.now()).toLocaleString(undefined, localeStringOptions);
+  }
+
   private callFunction(
     name: 'log' | 'warn' | 'debug' | 'verbose',
     message: any,
@@ -115,7 +130,7 @@ export class Logger implements LoggerService {
       );
   }
 
-  private getInstance(): typeof Logger | LoggerService {
+  protected getInstance(): typeof Logger | LoggerService {
     const { instance } = Logger;
     return instance === this ? Logger : instance;
   }
@@ -134,25 +149,12 @@ export class Logger implements LoggerService {
       ? `${color('Object:')}\n${JSON.stringify(message, null, 2)}\n`
       : color(message);
 
-    const localeStringOptions = {
-      year: 'numeric',
-      hour: 'numeric',
-      minute: 'numeric',
-      second: 'numeric',
-      day: '2-digit',
-      month: '2-digit',
-    };
-    const timestamp = new Date(Date.now()).toLocaleString(
-      undefined,
-      localeStringOptions,
-    );
-
     const pidMessage = color(`[Nest] ${process.pid}   - `);
     const contextMessage = context ? yellow(`[${context}] `) : '';
     const timestampDiff = this.updateAndGetTimestampDiff(isTimeDiffEnabled);
-
+    const instance = this.instance as typeof Logger;
     process.stdout.write(
-      `${pidMessage}${timestamp}   ${contextMessage}${output}${timestampDiff}\n`,
+      `${pidMessage}${instance.getTimestamp()}   ${contextMessage}${output}${timestampDiff}\n`,
     );
   }
 

packages/common/test/decorators/sse.decorator.spec.ts

@@ -0,0 +1,23 @@
+import { expect } from 'chai';
+import { METHOD_METADATA, PATH_METADATA, SSE_METADATA } from '../../constants';
+import { Sse } from '../../decorators/http/sse.decorator';
+import { RequestMethod } from '../../enums/request-method.enum';
+
+describe('@Sse', () => {
+  const prefix = '/prefix';
+  class Test {
+    @Sse(prefix)
+    public static test() {}
+  }
+
+  it('should enhance method with expected http status code', () => {
+    const path = Reflect.getMetadata(PATH_METADATA, Test.test);
+    expect(path).to.be.eql('/prefix');
+
+    const method = Reflect.getMetadata(METHOD_METADATA, Test.test);
+    expect(method).to.be.eql(RequestMethod.GET);
+
+    const metadata = Reflect.getMetadata(SSE_METADATA, Test.test);
+    expect(metadata).to.be.eql(true);
+  });
+});

packages/common/test/decorators/use-guards.decorator.spec.ts

@@ -32,12 +32,12 @@ describe('@UseGuards', () => {
     expect(metadata).to.be.eql(guards);
   });
 
-  it('should enhance class with multiple guards array', () => {
+  it('should enhance method with multiple guards array', () => {
     const metadata = Reflect.getMetadata(GUARDS_METADATA, Test2.test);
     expect(metadata).to.be.eql(guards.concat(guards));
   });
 
-  it('when object is invalid should throw exception', () => {
+  it('should throw exception when object is invalid', () => {
     try {
       UseGuards('test' as any)(() => {});
     } catch (e) {

packages/common/test/pipes/validation.pipe.spec.ts

@@ -403,7 +403,7 @@ describe('ValidationPipe', () => {
       public prop1: string;
 
       @IsBoolean()
-      public prop2: string;
+      public prop2: boolean;
 
       @IsOptional()
       @IsString()
@@ -422,5 +422,18 @@ describe('ValidationPipe', () => {
 
       expect(await target.transform(testObj, m)).to.equal(testObj);
     });
+
+    it('should validate against the expected type if presented and metatype is primitive type', async () => {
+      const m: ArgumentMetadata = {
+        type: 'body',
+        metatype: String,
+        data: '',
+      };
+
+      target = new ValidationPipe({ expectedType: TestModel });
+      const testObj = { prop1: 'value1', prop2: 'value2' };
+
+      expect(await target.transform(testObj, m)).to.equal(testObj);
+    });
   });
 });

packages/common/test/utils/shared.utils.spec.ts

@@ -1,14 +1,14 @@
 import { expect } from 'chai';
 import {
-  isUndefined,
-  isFunction,
-  isObject,
-  isString,
+  addLeadingSlash,
   isConstructor,
-  validatePath,
-  isNil,
   isEmpty,
+  isFunction,
+  isNil,
+  isObject,
   isPlainObject,
+  isString,
+  isUndefined,
 } from '../../utils/shared.utils';
 
 function Foo(a) {
@@ -81,17 +81,17 @@ describe('Shared utils', () => {
       expect(isConstructor('nope')).to.be.false;
     });
   });
-  describe('validatePath', () => {
+  describe('addLeadingSlash', () => {
     it('should returns validated path ("add / if not exists")', () => {
-      expect(validatePath('nope')).to.be.eql('/nope');
+      expect(addLeadingSlash('nope')).to.be.eql('/nope');
     });
     it('should returns same path', () => {
-      expect(validatePath('/nope')).to.be.eql('/nope');
+      expect(addLeadingSlash('/nope')).to.be.eql('/nope');
     });
     it('should returns empty path', () => {
-      expect(validatePath('')).to.be.eql('');
-      expect(validatePath(null)).to.be.eql('');
-      expect(validatePath(undefined)).to.be.eql('');
+      expect(addLeadingSlash('')).to.be.eql('');
+      expect(addLeadingSlash(null)).to.be.eql('');
+      expect(addLeadingSlash(undefined)).to.be.eql('');
     });
   });
   describe('isNil', () => {

packages/common/utils/cli-colors.util.ts

@@ -0,0 +1,16 @@
+type ColorTextFn = (text: string) => string;
+
+const isColorAllowed = () => !process.env.NO_COLOR;
+const colorIfAllowed = (colorFn: ColorTextFn) => (text: string) =>
+  isColorAllowed() ? colorFn(text) : text;
+
+export const clc = {
+  green: colorIfAllowed((text: string) => `\x1B[32m${text}\x1B[39m`),
+  yellow: colorIfAllowed((text: string) => `\x1B[33m${text}\x1B[39m`),
+  red: colorIfAllowed((text: string) => `\x1B[31m${text}\x1B[39m`),
+  magentaBright: colorIfAllowed((text: string) => `\x1B[95m${text}\x1B[39m`),
+  cyanBright: colorIfAllowed((text: string) => `\x1B[96m${text}\x1B[39m`),
+};
+export const yellow = colorIfAllowed(
+  (text: string) => `\x1B[38;5;3m${text}\x1B[39m`,
+);

packages/common/utils/shared.utils.ts

@@ -24,7 +24,7 @@ export const isPlainObject = (fn: any): fn is object => {
   );
 };
 
-export const validatePath = (path?: string): string =>
+export const addLeadingSlash = (path?: string): string =>
   path ? (path.charAt(0) !== '/' ? '/' + path : path) : '';
 
 export const isFunction = (fn: any): boolean => typeof fn === 'function';

packages/core/Readme.md

@@ -66,7 +66,8 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <a href="https://neoteric.eu/" target="_blank"><img src="https://nestjs.com/img/neoteric-cut.png" width="120" valign="middle" /></a> </td><td>
   <a href="http://gojob.com" target="_blank"><img src="http://nestjs.com/img/gojob-logo.png" valign="middle" width="100" /></a> </td><td>
     <a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="170" valign="middle" /></a> </td><td>
-<a href="http://www.leogistics.com" target="_blank"><img src="https://nestjs.com/img/leogistics-logo.jpeg" width="150" valign="middle" /></td></tr></table>
+<a href="http://www.leogistics.com" target="_blank"><img src="https://nestjs.com/img/leogistics-logo.jpeg" width="150" valign="middle" /></td><td>
+<a href="http://www.meetdandy.com" target="_blank"><img src="https://nestjs.com/img/dandy-wide-logo.png" width="150" valign="middle" /></td></tr></table>
 
 #### Sponsors
 
@@ -84,12 +85,11 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <a href="https://clay.global/" target="_blank"><img src="https://nestjs.com/img/clay-logo.svg" width="75" valign="middle" /></a> </td><td align="center" valign="middle">
 <a href="https://firesticktricks.com" target="_blank"><img src="https://nestjs.com/img/firesticktricks-logo.png" width="120" valign="middle" /></a></td></tr><tr><td align="center" valign="middle">
 <a href="https://www.codeguesser.co.uk" target="_blank"><img src="https://nestjs.com/img/codeguesser-logo.svg" width="120" valign="middle" /></a> </td><td align="center" valign="middle">
-<a href="https://tekhattan.com" target="_blank"><img src="https://nestjs.com/img/tekhattan-logo.png" width="110" valign="middle" /></a> </td><td align="center" valign="middle">
 <a href="https://f-a.nz/" target="_blank"><img src="https://nestjs.com/img/franz.svg" width="80" valign="middle" /></a> </td><td align="center" valign="middle">
 <a href="https://sparkfabrik.com/" target="_blank"><img src="https://nestjs.com/img/sparkfabrik-logo.png" width="120" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://www.thebigphonestore.co.uk/" target="_blank"><img src="https://nestjs.com/img/the-big-phone-store-logo.png" width="65" valign="middle" /></a></td>
   <td align="center" valign="middle">
-  <a href="https://genuinebee.com/" target="_blank"><img src="https://nestjs.com/img/genuinebee.svg" width="97" valign="middle" /></a> </td></tr>
-<tr><td align="center" valign="middle"><a href="https://sanyodigital.com/" target="_blank"><img src="https://nestjs.com/img/sanyo-digital.png" width="130" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://vpn-review.com/vpn-for-torrenting" target="_blank"><img src="https://nestjs.com/img/vpn-review-logo.png" width="85" valign="middle" /></a></td>
+  <a href="https://genuinebee.com/" target="_blank"><img src="https://nestjs.com/img/genuinebee.svg" width="97" valign="middle" /></a> </td>
+<td align="center" valign="middle"><a href="https://sanyodigital.com/" target="_blank"><img src="https://nestjs.com/img/sanyo-digital.png" width="130" valign="middle" /></a></td></tr><tr><td align="center" valign="middle"><a href="https://vpn-review.com/vpn-for-torrenting" target="_blank"><img src="https://nestjs.com/img/vpn-review-logo.png" width="85" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://lambda-it.ch/" target="_blank"><img src="https://nestjs.com/img/lambda-it-logo.svg" width="115" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://pickwriters.com/top-10-translation-services" target="_blank"><img src="https://nestjs.com/img/pickwriters-logo.png" width="40" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://thewordpoint.com/services/localization" target="_blank"><img src="https://nestjs.com/img/thewordpoint-logo.png" width="40" valign="middle" /></a></td>
   </tr></table>
 
 ## Backers

packages/core/helpers/context-utils.ts

@@ -1,5 +1,8 @@
 import { ParamData } from '@nestjs/common';
-import { PARAMTYPES_METADATA } from '@nestjs/common/constants';
+import {
+  PARAMTYPES_METADATA,
+  RESPONSE_PASSTHROUGH_METADATA,
+} from '@nestjs/common/constants';
 import {
   ContextType,
   Controller,
@@ -38,6 +41,14 @@ export class ContextUtils {
     return Reflect.getMetadata(metadataKey, instance.constructor, methodName);
   }
 
+  public reflectPassthrough(instance: Controller, methodName: string): boolean {
+    return Reflect.getMetadata(
+      RESPONSE_PASSTHROUGH_METADATA,
+      instance.constructor,
+      methodName,
+    );
+  }
+
   public getArgumentsLength<T>(keys: string[], metadata: T): number {
     return Math.max(...keys.map(key => metadata[key].index)) + 1;
   }

packages/core/helpers/handler-metadata-storage.ts

@@ -1,11 +1,32 @@
 import { Type } from '@nestjs/common';
 import { Controller } from '@nestjs/common/interfaces';
+import { IncomingMessage } from 'http';
+import { Observable } from 'rxjs';
 import { CONTROLLER_ID_KEY } from '../injector/constants';
 import { ContextId } from '../injector/instance-wrapper';
+import { HeaderStream } from '../router/sse-stream';
 import { ParamProperties } from './context-utils';
 
 export const HANDLER_METADATA_SYMBOL = Symbol.for('handler_metadata:cache');
 
+export type HandleResponseFn = HandlerResponseBasicFn | HandleSseResponseFn;
+
+export type HandlerResponseBasicFn = <TResult, TResponse>(
+  result: TResult,
+  res: TResponse,
+  req?: any,
+) => any;
+
+export type HandleSseResponseFn = <
+  TResult extends Observable<unknown> = any,
+  TResponse extends HeaderStream = any,
+  TRequest extends IncomingMessage = any
+>(
+  result: TResult,
+  res: TResponse,
+  req: TRequest,
+) => any;
+
 export interface HandlerMetadata {
   argsLength: number;
   paramtypes: any[];
@@ -17,10 +38,7 @@ export interface HandlerMetadata {
     contextId?: ContextId,
     inquirerId?: string,
   ) => (ParamProperties & { metatype?: any })[];
-  fnHandleResponse: <TResult, TResponse>(
-    result: TResult,
-    res: TResponse,
-  ) => any;
+  fnHandleResponse: HandleResponseFn;
 }
 
 export class HandlerMetadataStorage<

packages/core/helpers/rethrow.ts

@@ -0,0 +1,3 @@
+export const rethrow = (err: unknown) => {
+  throw err;
+};

packages/core/injector/module-token-factory.ts

@@ -47,7 +47,11 @@ export class ModuleTokenFactory {
 
   private replacer(key: string, value: any) {
     if (typeof value === 'function') {
-      return value.name;
+      const isClass = /^class\s/.test(Function.prototype.toString.call(value));
+      if (isClass) {
+        return value.name;
+      }
+      return hash(value.toString(), { ignoreUnknown: true });
     }
     return value;
   }

packages/core/middleware/middleware-module.ts

@@ -6,8 +6,10 @@ import {
 } from '@nestjs/common/interfaces/middleware/middleware-configuration.interface';
 import { NestMiddleware } from '@nestjs/common/interfaces/middleware/nest-middleware.interface';
 import { NestModule } from '@nestjs/common/interfaces/modules/nest-module.interface';
-import { Type } from '@nestjs/common/interfaces/type.interface';
-import { isUndefined, validatePath } from '@nestjs/common/utils/shared.utils';
+import {
+  addLeadingSlash,
+  isUndefined,
+} from '@nestjs/common/utils/shared.utils';
 import { ApplicationConfig } from '../application-config';
 import { InvalidMiddlewareException } from '../errors/exceptions/invalid-middleware.exception';
 import { RuntimeException } from '../errors/exceptions/runtime.exception';
@@ -105,18 +107,19 @@ export class MiddlewareModule {
     applicationRef: any,
   ) {
     const configs = middlewareContainer.getConfigurations();
-    const registerAllConfigs = (
+    const registerAllConfigs = async (
       moduleKey: string,
       middlewareConfig: MiddlewareConfiguration[],
-    ) =>
-      middlewareConfig.map(async (config: MiddlewareConfiguration) => {
+    ) => {
+      for (const config of middlewareConfig) {
         await this.registerMiddlewareConfig(
           middlewareContainer,
           config,
           moduleKey,
           applicationRef,
         );
-      });
+      }
+    };
 
     const entriesSortedByDistance = [...configs.entries()].sort(
       ([moduleA], [moduleB]) => {
@@ -126,10 +129,9 @@ export class MiddlewareModule {
         );
       },
     );
-    const registerModuleConfigs = async ([module, moduleConfigs]) => {
-      await Promise.all(registerAllConfigs(module, [...moduleConfigs]));
-    };
-    await Promise.all(entriesSortedByDistance.map(registerModuleConfigs));
+    for (const [moduleRef, moduleConfigurations] of entriesSortedByDistance) {
+      await registerAllConfigs(moduleRef, [...moduleConfigurations]);
+    }
   }
 
   public async registerMiddlewareConfig(
@@ -139,9 +141,7 @@ export class MiddlewareModule {
     applicationRef: any,
   ) {
     const { forRoutes } = config;
-    const registerRouteMiddleware = async (
-      routeInfo: Type<any> | string | RouteInfo,
-    ) => {
+    for (const routeInfo of forRoutes) {
       await this.registerRouteMiddleware(
         middlewareContainer,
         routeInfo as RouteInfo,
@@ -149,8 +149,7 @@ export class MiddlewareModule {
         moduleKey,
         applicationRef,
       );
-    };
-    await Promise.all(forRoutes.map(registerRouteMiddleware));
+    }
   }
 
   public async registerRouteMiddleware(
@@ -163,25 +162,21 @@ export class MiddlewareModule {
     const middlewareCollection = [].concat(config.middleware);
     const moduleRef = this.container.getModuleByKey(moduleKey);
 
-    await Promise.all(
-      middlewareCollection.map(async (metatype: Type<NestMiddleware>) => {
-        const collection = middlewareContainer.getMiddlewareCollection(
-          moduleKey,
-        );
-        const instanceWrapper = collection.get(metatype.name);
-        if (isUndefined(instanceWrapper)) {
-          throw new RuntimeException();
-        }
-        await this.bindHandler(
-          instanceWrapper,
-          applicationRef,
-          routeInfo.method,
-          routeInfo.path,
-          moduleRef,
-          collection,
-        );
-      }),
-    );
+    for (const metatype of middlewareCollection) {
+      const collection = middlewareContainer.getMiddlewareCollection(moduleKey);
+      const instanceWrapper = collection.get(metatype.name);
+      if (isUndefined(instanceWrapper)) {
+        throw new RuntimeException();
+      }
+      await this.bindHandler(
+        instanceWrapper,
+        applicationRef,
+        routeInfo.method,
+        routeInfo.path,
+        moduleRef,
+        collection,
+      );
+    }
   }
 
   private async bindHandler(
@@ -273,7 +268,7 @@ export class MiddlewareModule {
     ) => void,
   ) {
     const prefix = this.config.getGlobalPrefix();
-    const basePath = validatePath(prefix);
+    const basePath = addLeadingSlash(prefix);
     if (basePath && path === '/*') {
       // strip slash when a wildcard is being used
       // and global prefix has been set

packages/core/middleware/routes-mapper.ts

@@ -2,9 +2,9 @@ import { RequestMethod } from '@nestjs/common';
 import { PATH_METADATA } from '@nestjs/common/constants';
 import { RouteInfo, Type } from '@nestjs/common/interfaces';
 import {
+  addLeadingSlash,
   isString,
   isUndefined,
-  validatePath,
 } from '@nestjs/common/utils/shared.utils';
 import { NestContainer } from '../injector/container';
 import { MetadataScanner } from '../metadata-scanner';
@@ -64,11 +64,11 @@ export class RoutesMapper {
   }
 
   private validateGlobalPath(path: string): string {
-    const prefix = validatePath(path);
+    const prefix = addLeadingSlash(path);
     return prefix === '/' ? '' : prefix;
   }
 
   private validateRoutePath(path: string): string {
-    return validatePath(path);
+    return addLeadingSlash(path);
   }
 }

packages/core/nest-application-context.ts

@@ -2,6 +2,7 @@ import {
   INestApplicationContext,
   Logger,
   LoggerService,
+  LogLevel,
   ShutdownSignal,
 } from '@nestjs/common';
 import { Abstract, Scope } from '@nestjs/common/interfaces';
@@ -78,7 +79,7 @@ export class NestApplicationContext implements INestApplicationContext {
   }
 
   public resolve<TInput = any, TResult = TInput>(
-    typeOrToken: Type<TInput> | string | symbol,
+    typeOrToken: Type<TInput> | Abstract<TInput> | string | symbol,
     contextId = createContextId(),
     options: { strict: boolean } = { strict: false },
   ): Promise<TResult> {
@@ -119,7 +120,7 @@ export class NestApplicationContext implements INestApplicationContext {
     this.unsubscribeFromProcessSignals();
   }
 
-  public useLogger(logger: LoggerService) {
+  public useLogger(logger: LoggerService | LogLevel[] | false) {
     Logger.overrideLogger(logger);
   }
 
@@ -177,7 +178,7 @@ export class NestApplicationContext implements INestApplicationContext {
       } catch (err) {
         Logger.error(
           MESSAGES.ERROR_DURING_SHUTDOWN,
-          (err as Error).stack,
+          (err as Error)?.stack,
           NestApplicationContext.name,
         );
         process.exit(1);
@@ -277,7 +278,7 @@ export class NestApplicationContext implements INestApplicationContext {
   }
 
   protected async resolvePerContext<TInput = any, TResult = TInput>(
-    typeOrToken: Type<TInput> | string | symbol,
+    typeOrToken: Type<TInput> | Abstract<TInput> | string | symbol,
     contextModule: Module,
     contextId: ContextId,
     options?: { strict: boolean },

packages/core/nest-application.ts

@@ -13,7 +13,7 @@ import { CorsOptions } from '@nestjs/common/interfaces/external/cors-options.int
 import { NestApplicationOptions } from '@nestjs/common/interfaces/nest-application-options.interface';
 import { Logger } from '@nestjs/common/services/logger.service';
 import { loadPackage } from '@nestjs/common/utils/load-package.util';
-import { isObject, validatePath } from '@nestjs/common/utils/shared.utils';
+import { addLeadingSlash, isObject } from '@nestjs/common/utils/shared.utils';
 import { iterate } from 'iterare';
 import { platform } from 'os';
 import { AbstractHttpAdapter } from './adapters';
@@ -40,7 +40,8 @@ const {
 /**
  * @publicApi
  */
-export class NestApplication extends NestApplicationContext
+export class NestApplication
+  extends NestApplicationContext
   implements INestApplication {
   private readonly logger = new Logger(NestApplication.name, true);
   private readonly middlewareModule = new MiddlewareModule();
@@ -163,7 +164,7 @@ export class NestApplication extends NestApplicationContext
     await this.registerMiddleware(this.httpAdapter);
 
     const prefix = this.config.getGlobalPrefix();
-    const basePath = validatePath(prefix);
+    const basePath = addLeadingSlash(prefix);
     this.routesResolver.resolve(this.httpAdapter, basePath);
   }
 
@@ -238,8 +239,8 @@ export class NestApplication extends NestApplicationContext
   ): Promise<any>;
   public async listen(port: number | string, ...args: any[]): Promise<any> {
     !this.isInitialized && (await this.init());
-    this.httpAdapter.listen(port, ...args);
     this.isListening = true;
+    this.httpAdapter.listen(port, ...args);
     return this.httpServer;
   }
 

packages/core/nest-factory.ts

@@ -15,6 +15,7 @@ import { ApplicationConfig } from './application-config';
 import { MESSAGES } from './constants';
 import { ExceptionsZone } from './errors/exceptions-zone';
 import { loadAdapter } from './helpers/load-adapter';
+import { rethrow } from './helpers/rethrow';
 import { NestContainer } from './injector/container';
 import { InstanceLoader } from './injector/instance-loader';
 import { MetadataScanner } from './metadata-scanner';
@@ -27,6 +28,7 @@ import { DependenciesScanner } from './scanner';
  */
 export class NestFactoryStatic {
   private readonly logger = new Logger('NestFactory', true);
+  private abortOnError = true;
   /**
    * Creates an instance of NestApplication.
    *
@@ -67,7 +69,7 @@ export class NestFactoryStatic {
 
     const applicationConfig = new ApplicationConfig();
     const container = new NestContainer(applicationConfig);
-
+    this.setAbortOnError(serverOrOptions, options);
     this.applyLogger(appOptions);
     await this.initialize(module, container, applicationConfig, httpServer);
 
@@ -101,7 +103,7 @@ export class NestFactoryStatic {
     );
     const applicationConfig = new ApplicationConfig();
     const container = new NestContainer(applicationConfig);
-
+    this.setAbortOnError(options);
     this.applyLogger(options);
 
     await this.initialize(module, container, applicationConfig);
@@ -124,10 +126,9 @@ export class NestFactoryStatic {
     options?: NestApplicationContextOptions,
   ): Promise<INestApplicationContext> {
     const container = new NestContainer();
-
+    this.setAbortOnError(options);
     this.applyLogger(options);
     await this.initialize(module, container);
-
     const modules = container.getModules().values();
     const root = modules.next().value;
     const context = this.createNestInstance<NestApplicationContext>(
@@ -155,17 +156,26 @@ export class NestFactoryStatic {
     );
     container.setHttpAdapter(httpServer);
 
+    const teardown = this.abortOnError === false ? rethrow : undefined;
     await httpServer?.init();
     try {
       this.logger.log(MESSAGES.APPLICATION_START);
+
       await ExceptionsZone.asyncRun(async () => {
         await dependenciesScanner.scan(module);
         await instanceLoader.createInstancesOfDependencies();
         dependenciesScanner.applyApplicationProviders();
-      });
+      }, teardown);
     } catch (e) {
+      this.handleInitializationError(e);
+    }
+  }
+
+  private handleInitializationError(err: unknown) {
+    if (this.abortOnError) {
       process.abort();
     }
+    rethrow(err);
   }
 
   private createProxy(target: any) {
@@ -192,11 +202,14 @@ export class NestFactoryStatic {
     receiver: Record<string, any>,
     prop: string,
   ): Function {
+    const teardown = this.abortOnError === false ? rethrow : undefined;
+
     return (...args: unknown[]) => {
       let result: unknown;
       ExceptionsZone.run(() => {
         result = receiver[prop](...args);
-      });
+      }, teardown);
+
       return result;
     };
   }
@@ -225,6 +238,15 @@ export class NestFactoryStatic {
     );
   }
 
+  private setAbortOnError(
+    serverOrOptions?: AbstractHttpAdapter | NestApplicationOptions,
+    options?: NestApplicationContextOptions | NestApplicationOptions,
+  ) {
+    this.abortOnError = this.isHttpServer(serverOrOptions)
+      ? !(options && options.abortOnError === false)
+      : !(serverOrOptions && serverOrOptions.abortOnError === false);
+  }
+
   private createAdapterProxy<T>(app: NestApplication, adapter: HttpServer): T {
     return (new Proxy(app, {
       get: (receiver: Record<string, any>, prop: string) => {

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/core",
-  "version": "7.4.4",
+  "version": "7.5.5",
   "description": "Nest - modern, fast, powerful node.js web framework (@core)",
   "author": "Kamil Mysliwiec",
   "license": "MIT",
@@ -27,16 +27,16 @@
     }
   },
   "dependencies": {
-    "@nuxtjs/opencollective": "0.2.2",
+    "@nuxtjs/opencollective": "0.3.2",
     "fast-safe-stringify": "2.0.7",
     "iterare": "1.2.1",
     "object-hash": "2.0.3",
     "path-to-regexp": "3.2.0",
-    "tslib": "2.0.1",
-    "uuid": "8.3.0"
+    "tslib": "2.0.3",
+    "uuid": "8.3.1"
   },
   "devDependencies": {
-    "@nestjs/common": "7.4.4"
+    "@nestjs/common": "7.5.5"
   },
   "peerDependencies": {
     "@nestjs/common": "^7.0.0",

packages/core/router/router-execution-context.ts

@@ -13,19 +13,24 @@ import {
   REDIRECT_METADATA,
   RENDER_METADATA,
   ROUTE_ARGS_METADATA,
+  SSE_METADATA,
 } from '@nestjs/common/constants';
 import { RouteParamMetadata } from '@nestjs/common/decorators';
 import { RouteParamtypes } from '@nestjs/common/enums/route-paramtypes.enum';
 import { ContextType, Controller } from '@nestjs/common/interfaces';
 import { isEmpty, isString } from '@nestjs/common/utils/shared.utils';
+import { IncomingMessage } from 'http';
+import { Observable } from 'rxjs';
 import { FORBIDDEN_MESSAGE } from '../guards/constants';
 import { GuardsConsumer } from '../guards/guards-consumer';
 import { GuardsContextCreator } from '../guards/guards-context-creator';
 import { ContextUtils } from '../helpers/context-utils';
 import { ExecutionContextHost } from '../helpers/execution-context-host';
 import {
+  HandleResponseFn,
   HandlerMetadata,
   HandlerMetadataStorage,
+  HandlerResponseBasicFn,
 } from '../helpers/handler-metadata-storage';
 import { STATIC_CONTEXT } from '../injector/constants';
 import { InterceptorsConsumer } from '../interceptors/interceptors-consumer';
@@ -38,6 +43,7 @@ import {
   RedirectResponse,
   RouterResponseController,
 } from './router-response-controller';
+import { HeaderStream } from './sse-stream';
 
 export interface ParamProperties {
   index: number;
@@ -160,7 +166,7 @@ export class RouterExecutionContext {
         handler(args, req, res, next),
         contextType,
       );
-      await fnHandleResponse(result, res);
+      await (fnHandleResponse as HandlerResponseBasicFn)(result, res, req);
     };
   }
 
@@ -209,9 +215,10 @@ export class RouterExecutionContext {
       );
 
     const paramsMetadata = getParamsMetadata(moduleKey);
-    const isResponseHandled = paramsMetadata.some(
-      ({ type }) =>
-        type === RouteParamtypes.RESPONSE || type === RouteParamtypes.NEXT,
+    const isResponseHandled = this.isResponseHandled(
+      instance,
+      methodName,
+      paramsMetadata,
     );
 
     const httpRedirectResponse = this.reflectRedirect(callback);
@@ -265,6 +272,10 @@ export class RouterExecutionContext {
     return Reflect.getMetadata(HEADERS_METADATA, callback) || [];
   }
 
+  public reflectSse(callback: (...args: unknown[]) => unknown): string {
+    return Reflect.getMetadata(SSE_METADATA, callback);
+  }
+
   public exchangeKeysForValues(
     keys: string[],
     metadata: Record<number, RouteParamMetadata>,
@@ -398,7 +409,7 @@ export class RouterExecutionContext {
     isResponseHandled: boolean,
     redirectResponse?: RedirectResponse,
     httpStatusCode?: number,
-  ) {
+  ): HandleResponseFn {
     const renderTemplate = this.reflectRenderTemplate(callback);
     if (renderTemplate) {
       return async <TResult, TResponse>(result: TResult, res: TResponse) => {
@@ -410,10 +421,44 @@ export class RouterExecutionContext {
         await this.responseController.redirect(result, res, redirectResponse);
       };
     }
+    const isSseHandler = !!this.reflectSse(callback);
+    if (isSseHandler) {
+      return async <
+        TResult extends Observable<unknown> = any,
+        TResponse extends HeaderStream = any,
+        TRequest extends IncomingMessage = any
+      >(
+        result: TResult,
+        res: TResponse,
+        req: TRequest,
+      ) => {
+        await this.responseController.sse(
+          result,
+          (res as any).raw || res,
+          (req as any).raw || req,
+        );
+      };
+    }
     return async <TResult, TResponse>(result: TResult, res: TResponse) => {
       result = await this.responseController.transformToResult(result);
       !isResponseHandled &&
         (await this.responseController.apply(result, res, httpStatusCode));
     };
   }
+
+  private isResponseHandled(
+    instance: Controller,
+    methodName: string,
+    paramsMetadata: ParamProperties[],
+  ): boolean {
+    const hasResponseOrNextDecorator = paramsMetadata.some(
+      ({ type }) =>
+        type === RouteParamtypes.RESPONSE || type === RouteParamtypes.NEXT,
+    );
+    const isPassthroughEnabled = this.contextUtils.reflectPassthrough(
+      instance,
+      methodName,
+    );
+    return hasResponseOrNextDecorator && !isPassthroughEnabled;
+  }
 }

packages/core/router/router-explorer.ts

@@ -6,9 +6,9 @@ import { Controller } from '@nestjs/common/interfaces/controllers/controller.int
 import { Type } from '@nestjs/common/interfaces/type.interface';
 import { Logger } from '@nestjs/common/services/logger.service';
 import {
+  addLeadingSlash,
   isString,
   isUndefined,
-  validatePath,
 } from '@nestjs/common/utils/shared.utils';
 import * as pathToRegexp from 'path-to-regexp';
 import { ApplicationConfig } from '../application-config';
@@ -87,20 +87,20 @@ export class RouterExplorer {
     );
   }
 
-  public extractRouterPath(
-    metatype: Type<Controller>,
-    prefix?: string,
-  ): string {
+  public extractRouterPath(metatype: Type<Controller>, prefix = ''): string[] {
     let path = Reflect.getMetadata(PATH_METADATA, metatype);
-    if (prefix) path = prefix + this.validateRoutePath(path);
-    return this.validateRoutePath(path);
-  }
 
-  public validateRoutePath(path: string): string {
     if (isUndefined(path)) {
       throw new UnknownRequestMappingException();
     }
-    return validatePath(path);
+
+    if (Array.isArray(path)) {
+      path = path.map(p => prefix + addLeadingSlash(p));
+    } else {
+      path = [prefix + addLeadingSlash(path)];
+    }
+
+    return path.map(p => addLeadingSlash(p));
   }
 
   public scanForPaths(
@@ -134,8 +134,8 @@ export class RouterExplorer {
       targetCallback,
     );
     const path = isString(routePath)
-      ? [this.validateRoutePath(routePath)]
-      : routePath.map(p => this.validateRoutePath(p));
+      ? [addLeadingSlash(routePath)]
+      : routePath.map(p => addLeadingSlash(p));
     return {
       path,
       requestMethod,

packages/core/router/router-response-controller.ts

@@ -1,5 +1,9 @@
 import { HttpServer, HttpStatus, RequestMethod } from '@nestjs/common';
-import { isFunction } from '@nestjs/common/utils/shared.utils';
+import { isFunction, isObject } from '@nestjs/common/utils/shared.utils';
+import { IncomingMessage } from 'http';
+import { Observable } from 'rxjs';
+import { debounce } from 'rxjs/operators';
+import { HeaderStream, SseStream } from './sse-stream';
 
 export interface CustomHeader {
   name: string;
@@ -78,4 +82,42 @@ export class RouterResponseController {
   ) {
     this.applicationRef.status(response, statusCode);
   }
+
+  public async sse<
+    TInput extends Observable<unknown> = any,
+    TResponse extends HeaderStream = any,
+    TRequest extends IncomingMessage = any
+  >(result: TInput, response: TResponse, request: TRequest) {
+    this.assertObservable(result);
+
+    const stream = new SseStream(request);
+    stream.pipe(response);
+
+    const subscription = result
+      .pipe(
+        debounce(
+          (message: any) =>
+            new Promise(resolve => {
+              if (!isObject(message)) {
+                message = { data: message };
+              }
+              stream.writeMessage(message, resolve);
+            }),
+        ),
+      )
+      .subscribe();
+
+    request.on('close', () => {
+      response.end();
+      subscription.unsubscribe();
+    });
+  }
+
+  private assertObservable(result: any) {
+    if (!isFunction(result.subscribe)) {
+      throw new ReferenceError(
+        'You must return an Observable stream to use Server-Sent Events (SSE).',
+      );
+    }
+  }
 }

packages/core/router/routes-resolver.ts

@@ -60,24 +60,27 @@ export class RoutesResolver implements Resolver {
       const { metatype } = instanceWrapper;
 
       const host = this.getHostMetadata(metatype);
-      const path = this.routerExplorer.extractRouterPath(
+      const paths = this.routerExplorer.extractRouterPath(
         metatype as Type<any>,
         basePath,
       );
       const controllerName = metatype.name;
-      this.logger.log(
-        CONTROLLER_MAPPING_MESSAGE(
-          controllerName,
-          this.routerExplorer.stripEndSlash(path),
-        ),
-      );
-      this.routerExplorer.explore(
-        instanceWrapper,
-        moduleName,
-        applicationRef,
-        path,
-        host,
-      );
+
+      paths.forEach(path => {
+        this.logger.log(
+          CONTROLLER_MAPPING_MESSAGE(
+            controllerName,
+            this.routerExplorer.stripEndSlash(path),
+          ),
+        );
+        this.routerExplorer.explore(
+          instanceWrapper,
+          moduleName,
+          applicationRef,
+          path,
+          host,
+        );
+      });
     });
   }
 

packages/core/router/sse-stream.ts

@@ -0,0 +1,107 @@
+import { MessageEvent } from '@nestjs/common/interfaces';
+import { IncomingMessage, OutgoingHttpHeaders } from 'http';
+import { Transform } from 'stream';
+
+function toDataString(data: string | object): string {
+  if (typeof data === 'object') {
+    return toDataString(JSON.stringify(data));
+  }
+
+  return data
+    .split(/\r\n|\r|\n/)
+    .map(line => `data: ${line}\n`)
+    .join('');
+}
+
+interface WriteHeaders {
+  writeHead?(
+    statusCode: number,
+    reasonPhrase?: string,
+    headers?: OutgoingHttpHeaders,
+  ): void;
+  writeHead?(statusCode: number, headers?: OutgoingHttpHeaders): void;
+  flushHeaders?(): void;
+}
+
+export type HeaderStream = NodeJS.WritableStream & WriteHeaders;
+
+/**
+ * Adapted from https://raw.githubusercontent.com/EventSource/node-ssestream
+ * Transforms "messages" to W3C event stream content.
+ * See https://html.spec.whatwg.org/multipage/server-sent-events.html
+ * A message is an object with one or more of the following properties:
+ * - data (String or object, which gets turned into JSON)
+ * - type
+ * - id
+ * - retry
+ *
+ * If constructed with a HTTP Request, it will optimise the socket for streaming.
+ * If this stream is piped to an HTTP Response, it will set appropriate headers.
+ */
+export class SseStream extends Transform {
+  private lastEventId: number = null;
+
+  constructor(req?: IncomingMessage) {
+    super({ objectMode: true });
+    if (req && req.socket) {
+      req.socket.setKeepAlive(true);
+      req.socket.setNoDelay(true);
+      req.socket.setTimeout(0);
+    }
+  }
+
+  pipe<T extends HeaderStream>(destination: T, options?: { end?: boolean }): T {
+    if (destination.writeHead) {
+      destination.writeHead(200, {
+        // See https://github.com/dunglas/mercure/blob/master/hub/subscribe.go#L124-L130
+        'Content-Type': 'text/event-stream',
+        Connection: 'keep-alive',
+        // Disable cache, even for old browsers and proxies
+        'Cache-Control':
+          'private, no-cache, no-store, must-revalidate, max-age=0, no-transform',
+        'Transfer-Encoding': 'identity',
+        Pragma: 'no-cache',
+        Expire: '0',
+        // NGINX support https://www.nginx.com/resources/wiki/start/topics/examples/x-accel/#x-accel-buffering
+        'X-Accel-Buffering': 'no',
+      });
+      destination.flushHeaders();
+    }
+
+    destination.write(':\n');
+    return super.pipe(destination, options);
+  }
+
+  _transform(
+    message: MessageEvent,
+    encoding: string,
+    callback: (error?: Error | null, data?: any) => void,
+  ) {
+    let data = message.type ? `event: ${message.type}\n` : '';
+    data += message.id ? `id: ${message.id}\n` : '';
+    data += message.retry ? `retry: ${message.retry}\n` : '';
+    data += message.data ? toDataString(message.data) : '';
+    data += '\n';
+    this.push(data);
+    callback();
+  }
+
+  /**
+   * Calls `.write` but handles the drain if needed
+   */
+  writeMessage(
+    message: MessageEvent,
+    cb: (error: Error | null | undefined) => void,
+  ) {
+    if (!message.id) {
+      this.lastEventId++;
+      message.id = this.lastEventId.toString();
+    }
+
+    if (!this.write(message, 'utf-8', cb)) {
+      this.once('drain', cb);
+    } else {
+      process.nextTick(cb);
+    }
+  }
+}

packages/core/scanner.ts

@@ -37,14 +37,14 @@ import { iterate } from 'iterare';
 import { ApplicationConfig } from './application-config';
 import { APP_FILTER, APP_GUARD, APP_INTERCEPTOR, APP_PIPE } from './constants';
 import { CircularDependencyException } from './errors/exceptions/circular-dependency.exception';
+import { InvalidModuleException } from './errors/exceptions/invalid-module.exception';
+import { UndefinedModuleException } from './errors/exceptions/undefined-module.exception';
 import { getClassScope } from './helpers/get-class-scope';
 import { ModulesContainer } from './injector';
 import { NestContainer } from './injector/container';
 import { InstanceWrapper } from './injector/instance-wrapper';
 import { Module } from './injector/module';
 import { MetadataScanner } from './metadata-scanner';
-import { InvalidModuleException } from './errors/exceptions/invalid-module.exception';
-import { UndefinedModuleException } from './errors/exceptions/undefined-module.exception';
 
 interface ApplicationProviderWrapper {
   moduleKey: string;
@@ -72,40 +72,53 @@ export class DependenciesScanner {
   }
 
   public async scanForModules(
-    module: ForwardReference | Type<unknown> | DynamicModule,
+    moduleDefinition:
+      | ForwardReference
+      | Type<unknown>
+      | DynamicModule
+      | Promise<DynamicModule>,
     scope: Type<unknown>[] = [],
     ctxRegistry: (ForwardReference | DynamicModule | Type<unknown>)[] = [],
   ): Promise<Module> {
-    const moduleInstance = await this.insertModule(module, scope);
-    ctxRegistry.push(module);
+    const moduleInstance = await this.insertModule(moduleDefinition, scope);
+    moduleDefinition =
+      moduleDefinition instanceof Promise
+        ? await moduleDefinition
+        : moduleDefinition;
+    ctxRegistry.push(moduleDefinition);
 
-    if (this.isForwardReference(module)) {
-      module = (module as ForwardReference).forwardRef();
+    if (this.isForwardReference(moduleDefinition)) {
+      moduleDefinition = (moduleDefinition as ForwardReference).forwardRef();
     }
-    const modules = !this.isDynamicModule(module as Type<any> | DynamicModule)
-      ? this.reflectMetadata(module as Type<any>, MODULE_METADATA.IMPORTS)
+    const modules = !this.isDynamicModule(
+      moduleDefinition as Type<any> | DynamicModule,
+    )
+      ? this.reflectMetadata(
+          moduleDefinition as Type<any>,
+          MODULE_METADATA.IMPORTS,
+        )
       : [
           ...this.reflectMetadata(
-            (module as DynamicModule).module,
+            (moduleDefinition as DynamicModule).module,
             MODULE_METADATA.IMPORTS,
           ),
-          ...((module as DynamicModule).imports || []),
+          ...((moduleDefinition as DynamicModule).imports || []),
         ];
 
     for (const [index, innerModule] of modules.entries()) {
       // In case of a circular dependency (ES module system), JavaScript will resolve the type to `undefined`.
       if (innerModule === undefined) {
-        throw new UndefinedModuleException(module, index, scope);
+        throw new UndefinedModuleException(moduleDefinition, index, scope);
       }
       if (!innerModule) {
-        throw new InvalidModuleException(module, index, scope);
+        throw new InvalidModuleException(moduleDefinition, index, scope);
       }
       if (ctxRegistry.includes(innerModule)) {
         continue;
       }
       await this.scanForModules(
         innerModule,
-        [].concat(scope, module),
+        [].concat(scope, moduleDefinition),
         ctxRegistry,
       );
     }

packages/core/test/injector/instance-wrapper.spec.ts

@@ -21,7 +21,7 @@ describe('InstanceWrapper', () => {
       expect(instance.scope).to.be.eql(partial.scope);
       expect(instance.metatype).to.be.eql(partial.metatype);
     });
-    it('should set intance by context id', () => {
+    it('should set instance by context id', () => {
       const instance = new InstanceWrapper(partial);
 
       expect(

packages/core/test/router/router-execution-context.spec.ts

@@ -1,6 +1,8 @@
 import { ForbiddenException } from '@nestjs/common/exceptions/forbidden.exception';
 import { expect } from 'chai';
+import { of } from 'rxjs';
 import * as sinon from 'sinon';
+import { PassThrough } from 'stream';
 import { HttpException, HttpStatus, RouteParamMetadata } from '../../../common';
 import { CUSTOM_ROUTE_AGRS_METADATA } from '../../../common/constants';
 import { RouteParamtypes } from '../../../common/enums/route-paramtypes.enum';
@@ -9,6 +11,7 @@ import { ApplicationConfig } from '../../application-config';
 import { FORBIDDEN_MESSAGE } from '../../guards/constants';
 import { GuardsConsumer } from '../../guards/guards-consumer';
 import { GuardsContextCreator } from '../../guards/guards-context-creator';
+import { HandlerResponseBasicFn } from '../../helpers/handler-metadata-storage';
 import { NestContainer } from '../../injector/container';
 import { InterceptorsConsumer } from '../../interceptors/interceptors-consumer';
 import { InterceptorsContextCreator } from '../../interceptors/interceptors-context-creator';
@@ -313,7 +316,7 @@ describe('RouterExecutionContext', () => {
           true,
           undefined,
           200,
-        );
+        ) as HandlerResponseBasicFn;
         await handler(value, response);
 
         expect(response.render.calledWith(template, value)).to.be.true;
@@ -326,13 +329,14 @@ describe('RouterExecutionContext', () => {
 
         sinon.stub(contextCreator, 'reflectResponseHeaders').returns([]);
         sinon.stub(contextCreator, 'reflectRenderTemplate').returns(undefined);
+        sinon.stub(contextCreator, 'reflectSse').returns(undefined);
 
         const handler = contextCreator.createHandleResponseFn(
           null,
           true,
           undefined,
           200,
-        );
+        ) as HandlerResponseBasicFn;
         await handler(result, response);
 
         expect(response.render.called).to.be.false;
@@ -358,7 +362,7 @@ describe('RouterExecutionContext', () => {
           true,
           redirectResponse,
           200,
-        );
+        ) as HandlerResponseBasicFn;
         await handler(redirectResponse, response);
 
         expect(
@@ -377,13 +381,14 @@ describe('RouterExecutionContext', () => {
 
         sinon.stub(contextCreator, 'reflectResponseHeaders').returns([]);
         sinon.stub(contextCreator, 'reflectRenderTemplate').returns(undefined);
+        sinon.stub(contextCreator, 'reflectSse').returns(undefined);
 
         const handler = contextCreator.createHandleResponseFn(
           null,
           true,
           undefined,
           200,
-        );
+        ) as HandlerResponseBasicFn;
         await handler(result, response);
 
         expect(response.redirect.called).to.be.false;
@@ -396,13 +401,14 @@ describe('RouterExecutionContext', () => {
         const response = {};
 
         sinon.stub(contextCreator, 'reflectRenderTemplate').returns(undefined);
+        sinon.stub(contextCreator, 'reflectSse').returns(undefined);
 
         const handler = contextCreator.createHandleResponseFn(
           null,
           false,
           undefined,
           1234,
-        );
+        ) as HandlerResponseBasicFn;
         const adapterReplySpy = sinon.spy(adapter, 'reply');
         await handler(result, response);
         expect(
@@ -414,5 +420,54 @@ describe('RouterExecutionContext', () => {
         ).to.be.true;
       });
     });
+
+    describe('when "isSse" is enabled', () => {
+      it('should delegate result to SseStream', async () => {
+        const result = of('test');
+        const response = new PassThrough();
+        response.write = sinon.spy();
+
+        const request = new PassThrough();
+        request.on = sinon.spy();
+
+        sinon.stub(contextCreator, 'reflectRenderTemplate').returns(undefined);
+        sinon.stub(contextCreator, 'reflectSse').returns('/');
+
+        const handler = contextCreator.createHandleResponseFn(
+          null,
+          true,
+          undefined,
+          200,
+        ) as HandlerResponseBasicFn;
+        await handler(result, response, request);
+
+        expect((response.write as any).called).to.be.true;
+        expect((request.on as any).called).to.be.true;
+      });
+
+      it('should not allow a non-observable result', async () => {
+        const result = Promise.resolve('test');
+        const response = new PassThrough();
+        const request = new PassThrough();
+
+        sinon.stub(contextCreator, 'reflectRenderTemplate').returns(undefined);
+        sinon.stub(contextCreator, 'reflectSse').returns('/');
+
+        const handler = contextCreator.createHandleResponseFn(
+          null,
+          true,
+          undefined,
+          200,
+        ) as HandlerResponseBasicFn;
+
+        try {
+          await handler(result, response, request);
+        } catch (e) {
+          expect(e.message).to.equal(
+            'You must return an Observable stream to use Server-Sent Events (SSE).',
+          );
+        }
+      });
+    });
   });
 });

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

@@ -32,6 +32,21 @@ describe('RouterExplorer', () => {
     public getTestUsingArray() {}
   }
 
+  @Controller(['global', 'global-alias'])
+  class TestRouteAlias {
+    @Get('test')
+    public getTest() {}
+
+    @Post('test')
+    public postTest() {}
+
+    @All('another-test')
+    public anotherTest() {}
+
+    @Get(['foo', 'bar'])
+    public getTestUsingArray() {}
+  }
+
   let routerBuilder: RouterExplorer;
   let injector: Injector;
   let exceptionsFilter: RouterExceptionFilters;
@@ -70,6 +85,22 @@ describe('RouterExplorer', () => {
       expect(paths[2].requestMethod).to.eql(RequestMethod.ALL);
       expect(paths[3].requestMethod).to.eql(RequestMethod.GET);
     });
+
+    it('should method return expected list of route paths alias', () => {
+      const paths = routerBuilder.scanForPaths(new TestRouteAlias());
+
+      expect(paths).to.have.length(4);
+
+      expect(paths[0].path).to.eql(['/test']);
+      expect(paths[1].path).to.eql(['/test']);
+      expect(paths[2].path).to.eql(['/another-test']);
+      expect(paths[3].path).to.eql(['/foo', '/bar']);
+
+      expect(paths[0].requestMethod).to.eql(RequestMethod.GET);
+      expect(paths[1].requestMethod).to.eql(RequestMethod.POST);
+      expect(paths[2].requestMethod).to.eql(RequestMethod.ALL);
+      expect(paths[3].requestMethod).to.eql(RequestMethod.GET);
+    });
   });
 
   describe('exploreMethodMetadata', () => {
@@ -87,6 +118,20 @@ describe('RouterExplorer', () => {
       expect(route.requestMethod).to.eql(RequestMethod.GET);
     });
 
+    it('should method return expected object which represent single route with alias', () => {
+      const instance = new TestRouteAlias();
+      const instanceProto = Object.getPrototypeOf(instance);
+
+      const route = routerBuilder.exploreMethodMetadata(
+        new TestRouteAlias(),
+        instanceProto,
+        'getTest',
+      );
+
+      expect(route.path).to.eql(['/test']);
+      expect(route.requestMethod).to.eql(RequestMethod.GET);
+    });
+
     it('should method return expected object which represent multiple routes', () => {
       const instance = new TestRoute();
       const instanceProto = Object.getPrototypeOf(instance);
@@ -100,6 +145,20 @@ describe('RouterExplorer', () => {
       expect(route.path).to.eql(['/foo', '/bar']);
       expect(route.requestMethod).to.eql(RequestMethod.GET);
     });
+
+    it('should method return expected object which represent multiple routes with alias', () => {
+      const instance = new TestRouteAlias();
+      const instanceProto = Object.getPrototypeOf(instance);
+
+      const route = routerBuilder.exploreMethodMetadata(
+        new TestRouteAlias(),
+        instanceProto,
+        'getTestUsingArray',
+      );
+
+      expect(route.path).to.eql(['/foo', '/bar']);
+      expect(route.requestMethod).to.eql(RequestMethod.GET);
+    });
   });
 
   describe('applyPathsToRouterProxy', () => {
@@ -130,14 +189,20 @@ describe('RouterExplorer', () => {
 
   describe('extractRouterPath', () => {
     it('should return expected path', () => {
-      expect(routerBuilder.extractRouterPath(TestRoute)).to.be.eql('/global');
-      expect(routerBuilder.extractRouterPath(TestRoute, '/module')).to.be.eql(
+      expect(routerBuilder.extractRouterPath(TestRoute)).to.be.eql(['/global']);
+      expect(routerBuilder.extractRouterPath(TestRoute, '/module')).to.be.eql([
         '/module/global',
-      );
+      ]);
     });
 
-    it('should throw it a there is a bad path expected path', () => {
-      expect(() => routerBuilder.validateRoutePath(undefined)).to.throw();
+    it('should return expected path with alias', () => {
+      expect(routerBuilder.extractRouterPath(TestRouteAlias)).to.be.eql([
+        '/global',
+        '/global-alias',
+      ]);
+      expect(
+        routerBuilder.extractRouterPath(TestRouteAlias, '/module'),
+      ).to.be.eql(['/module/global', '/module/global-alias']);
     });
   });
 

packages/core/test/router/router-response-controller.spec.ts

@@ -1,8 +1,10 @@
 import { isNil, isObject } from '@nestjs/common/utils/shared.utils';
 import { expect } from 'chai';
+import { IncomingMessage, ServerResponse } from 'http';
 import { of } from 'rxjs';
 import * as sinon from 'sinon';
-import { RequestMethod, HttpStatus } from '../../../common';
+import { PassThrough, Writable } from 'stream';
+import { HttpStatus, RequestMethod } from '../../../common';
 import { RouterResponseController } from '../../router/router-response-controller';
 import { NoopHttpAdapter } from '../utils/noop-adapter.spec';
 
@@ -247,4 +249,79 @@ describe('RouterResponseController', () => {
       });
     });
   });
+  describe('Server-Sent-Events', () => {
+    it('should accept only observables', async () => {
+      const result = Promise.resolve('test');
+      try {
+        await routerResponseController.sse(
+          (result as unknown) as any,
+          ({} as unknown) as ServerResponse,
+          ({} as unknown) as IncomingMessage,
+        );
+      } catch (e) {
+        expect(e.message).to.eql(
+          'You must return an Observable stream to use Server-Sent Events (SSE).',
+        );
+      }
+    });
+
+    it('should write string', async () => {
+      class Sink extends Writable {
+        private readonly chunks: string[] = [];
+
+        _write(
+          chunk: any,
+          encoding: string,
+          callback: (error?: Error | null) => void,
+        ): void {
+          this.chunks.push(chunk);
+          callback();
+        }
+
+        get content() {
+          return this.chunks.join('');
+        }
+      }
+
+      const written = (stream: Writable) =>
+        new Promise((resolve, reject) =>
+          stream.on('error', reject).on('finish', resolve),
+        );
+
+      const result = of('test');
+      const response = new Sink();
+      const request = new PassThrough();
+      routerResponseController.sse(
+        result,
+        (response as unknown) as ServerResponse,
+        (request as unknown) as IncomingMessage,
+      );
+      request.destroy();
+      await written(response);
+      expect(response.content).to.eql(
+        `:
+id: 1
+data: test
+
+`,
+      );
+    });
+
+    it('should close on request close', done => {
+      const result = of('test');
+      const response = new Writable();
+      response.end = () => done();
+      response._write = () => {};
+
+      const request = new Writable();
+      request._write = () => {};
+
+      routerResponseController.sse(
+        result,
+        (response as unknown) as ServerResponse,
+        (request as unknown) as IncomingMessage,
+      );
+      request.emit('close');
+    });
+  });
 });

packages/core/test/router/routes-resolver.spec.ts

@@ -88,7 +88,7 @@ describe('RoutesResolver', () => {
 
       sinon
         .stub((routesResolver as any).routerExplorer, 'extractRouterPath')
-        .callsFake(() => '');
+        .callsFake(() => ['']);
       routesResolver.registerRouters(routes, moduleName, '', appInstance);
 
       expect(exploreSpy.called).to.be.true;
@@ -114,7 +114,7 @@ describe('RoutesResolver', () => {
 
       sinon
         .stub((routesResolver as any).routerExplorer, 'extractRouterPath')
-        .callsFake(() => '');
+        .callsFake(() => ['']);
       routesResolver.registerRouters(routes, moduleName, '', appInstance);
 
       expect(exploreSpy.called).to.be.true;

packages/core/test/router/sse-stream.spec.ts

@@ -0,0 +1,160 @@
+import { expect } from 'chai';
+import * as EventSource from 'eventsource';
+import { createServer, OutgoingHttpHeaders } from 'http';
+import { AddressInfo } from 'net';
+import { Writable } from 'stream';
+import { HeaderStream, SseStream } from '../../router/sse-stream';
+
+const noop = () => {};
+
+const written = (stream: Writable) =>
+  new Promise((resolve, reject) =>
+    stream.on('error', reject).on('finish', resolve),
+  );
+
+class Sink extends Writable implements HeaderStream {
+  private readonly chunks: string[] = [];
+
+  constructor(
+    public readonly writeHead?: (
+      statusCode: number,
+      headers?: OutgoingHttpHeaders | string,
+    ) => void,
+  ) {
+    super({ objectMode: true });
+  }
+
+  _write(
+    chunk: any,
+    encoding: string,
+    callback: (error?: Error | null) => void,
+  ): void {
+    this.chunks.push(chunk);
+    callback();
+  }
+
+  get content() {
+    return this.chunks.join('');
+  }
+}
+
+describe('SseStream', () => {
+  it('writes multiple multiline messages', async () => {
+    const sse = new SseStream();
+    const sink = new Sink();
+    sse.pipe(sink);
+    sse.writeMessage(
+      {
+        data: 'hello\nworld',
+      },
+      noop,
+    );
+    sse.writeMessage(
+      {
+        data: 'bonjour\nmonde',
+      },
+      noop,
+    );
+    sse.end();
+    await written(sink);
+    expect(sink.content).to.equal(
+      `:
+id: 1
+data: hello
+data: world
+
+id: 2
+data: bonjour
+data: monde
+
+`,
+    );
+  });
+
+  it('writes object messages as JSON', async () => {
+    const sse = new SseStream();
+    const sink = new Sink();
+    sse.pipe(sink);
+    sse.writeMessage(
+      {
+        data: { hello: 'world' },
+      },
+      noop,
+    );
+    sse.end();
+    await written(sink);
+    expect(sink.content).to.equal(
+      `:
+id: 1
+data: {"hello":"world"}
+
+`,
+    );
+  });
+
+  it('writes all message attributes', async () => {
+    const sse = new SseStream();
+    const sink = new Sink();
+    sse.pipe(sink);
+    sse.writeMessage(
+      {
+        type: 'tea-time',
+        id: 'the-id',
+        retry: 222,
+        data: 'hello',
+      },
+      noop,
+    );
+    sse.end();
+    await written(sink);
+    expect(sink.content).to.equal(
+      `:
+event: tea-time
+id: the-id
+retry: 222
+data: hello
+
+`,
+    );
+  });
+
+  it('sets headers on destination when it looks like a HTTP Response', callback => {
+    const sse = new SseStream();
+    const sink = new Sink((status: number, headers: OutgoingHttpHeaders) => {
+      expect(headers).to.deep.equal({
+        'Content-Type': 'text/event-stream',
+        Connection: 'keep-alive',
+        'Cache-Control':
+          'private, no-cache, no-store, must-revalidate, max-age=0',
+        'Transfer-Encoding': 'identity',
+        Pragma: 'no-cache',
+        Expire: '0',
+        'X-Accel-Buffering': 'no',
+      });
+      callback();
+      return sink;
+    });
+    sse.pipe(sink);
+  });
+
+  it('allows an eventsource to connect', callback => {
+    let sse: SseStream;
+    const server = createServer((req, res) => {
+      sse = new SseStream(req);
+      sse.pipe(res);
+    });
+    server.listen(() => {
+      const es = new EventSource(
+        `http://localhost:${(server.address() as AddressInfo).port}`,
+      );
+      es.onmessage = e => {
+        expect(e.data).to.equal('hello');
+        es.close();
+        server.close(callback);
+      };
+      es.onopen = () => sse.writeMessage({ data: 'hello' }, noop);
+      es.onerror = e =>
+        callback(new Error(`Error from EventSource: ${JSON.stringify(e)}`));
+    });
+  });
+});

packages/microservices/Readme.md

@@ -66,7 +66,8 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <a href="https://neoteric.eu/" target="_blank"><img src="https://nestjs.com/img/neoteric-cut.png" width="120" valign="middle" /></a> </td><td>
   <a href="http://gojob.com" target="_blank"><img src="http://nestjs.com/img/gojob-logo.png" valign="middle" width="100" /></a> </td><td>
     <a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="170" valign="middle" /></a> </td><td>
-<a href="http://www.leogistics.com" target="_blank"><img src="https://nestjs.com/img/leogistics-logo.jpeg" width="150" valign="middle" /></td></tr></table>
+<a href="http://www.leogistics.com" target="_blank"><img src="https://nestjs.com/img/leogistics-logo.jpeg" width="150" valign="middle" /></td><td>
+<a href="http://www.meetdandy.com" target="_blank"><img src="https://nestjs.com/img/dandy-wide-logo.png" width="150" valign="middle" /></td></tr></table>
 
 #### Sponsors
 
@@ -84,12 +85,11 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <a href="https://clay.global/" target="_blank"><img src="https://nestjs.com/img/clay-logo.svg" width="75" valign="middle" /></a> </td><td align="center" valign="middle">
 <a href="https://firesticktricks.com" target="_blank"><img src="https://nestjs.com/img/firesticktricks-logo.png" width="120" valign="middle" /></a></td></tr><tr><td align="center" valign="middle">
 <a href="https://www.codeguesser.co.uk" target="_blank"><img src="https://nestjs.com/img/codeguesser-logo.svg" width="120" valign="middle" /></a> </td><td align="center" valign="middle">
-<a href="https://tekhattan.com" target="_blank"><img src="https://nestjs.com/img/tekhattan-logo.png" width="110" valign="middle" /></a> </td><td align="center" valign="middle">
 <a href="https://f-a.nz/" target="_blank"><img src="https://nestjs.com/img/franz.svg" width="80" valign="middle" /></a> </td><td align="center" valign="middle">
 <a href="https://sparkfabrik.com/" target="_blank"><img src="https://nestjs.com/img/sparkfabrik-logo.png" width="120" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://www.thebigphonestore.co.uk/" target="_blank"><img src="https://nestjs.com/img/the-big-phone-store-logo.png" width="65" valign="middle" /></a></td>
   <td align="center" valign="middle">
-  <a href="https://genuinebee.com/" target="_blank"><img src="https://nestjs.com/img/genuinebee.svg" width="97" valign="middle" /></a> </td></tr>
-<tr><td align="center" valign="middle"><a href="https://sanyodigital.com/" target="_blank"><img src="https://nestjs.com/img/sanyo-digital.png" width="130" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://vpn-review.com/vpn-for-torrenting" target="_blank"><img src="https://nestjs.com/img/vpn-review-logo.png" width="85" valign="middle" /></a></td>
+  <a href="https://genuinebee.com/" target="_blank"><img src="https://nestjs.com/img/genuinebee.svg" width="97" valign="middle" /></a> </td>
+<td align="center" valign="middle"><a href="https://sanyodigital.com/" target="_blank"><img src="https://nestjs.com/img/sanyo-digital.png" width="130" valign="middle" /></a></td></tr><tr><td align="center" valign="middle"><a href="https://vpn-review.com/vpn-for-torrenting" target="_blank"><img src="https://nestjs.com/img/vpn-review-logo.png" width="85" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://lambda-it.ch/" target="_blank"><img src="https://nestjs.com/img/lambda-it-logo.svg" width="115" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://pickwriters.com/top-10-translation-services" target="_blank"><img src="https://nestjs.com/img/pickwriters-logo.png" width="40" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://thewordpoint.com/services/localization" target="_blank"><img src="https://nestjs.com/img/thewordpoint-logo.png" width="40" valign="middle" /></a></td>
   </tr></table>
 
 ## Backers

packages/microservices/client/client-kafka.ts

@@ -11,6 +11,7 @@ import { KafkaHeaders } from '../enums';
 import { InvalidKafkaClientTopicPartitionException } from '../errors/invalid-kafka-client-topic-partition.exception';
 import { InvalidKafkaClientTopicException } from '../errors/invalid-kafka-client-topic.exception';
 import {
+  BrokersFunction,
   Consumer,
   ConsumerConfig,
   ConsumerGroupJoinEvent,
@@ -47,7 +48,7 @@ export class ClientKafka extends ClientProxy {
   protected responsePatterns: string[] = [];
   protected consumerAssignments: { [key: string]: number[] } = {};
 
-  protected brokers: string[];
+  protected brokers: string[] | BrokersFunction;
   protected clientId: string;
   protected groupId: string;
 
@@ -64,8 +65,11 @@ export class ClientKafka extends ClientProxy {
     // Append a unique id to the clientId and groupId
     // so they don't collide with a microservices client
     this.clientId =
-      (clientOptions.clientId || KAFKA_DEFAULT_CLIENT) + '-client';
-    this.groupId = (consumerOptions.groupId || KAFKA_DEFAULT_GROUP) + '-client';
+      (clientOptions.clientId || KAFKA_DEFAULT_CLIENT) +
+      (clientOptions.clientIdPostfix || '-client');
+    this.groupId =
+      (consumerOptions.groupId || KAFKA_DEFAULT_GROUP) +
+      (clientOptions.clientIdPostfix || '-client');
 
     kafkaPackage = loadPackage('kafkajs', ClientKafka.name, () =>
       require('kafkajs'),
@@ -80,9 +84,9 @@ export class ClientKafka extends ClientProxy {
     this.responsePatterns.push(this.getResponsePatternName(request));
   }
 
-  public close(): void {
-    this.producer && this.producer.disconnect();
-    this.consumer && this.consumer.disconnect();
+  public async close(): Promise<void> {
+    this.producer && (await this.producer.disconnect());
+    this.consumer && (await this.consumer.disconnect());
     this.producer = null;
     this.consumer = null;
     this.client = null;

packages/microservices/client/client-rmq.ts

@@ -10,6 +10,7 @@ import {
   ERROR_EVENT,
   RQM_DEFAULT_IS_GLOBAL_PREFETCH_COUNT,
   RQM_DEFAULT_NOACK,
+  RQM_DEFAULT_PERSISTENT,
   RQM_DEFAULT_PREFETCH_COUNT,
   RQM_DEFAULT_QUEUE,
   RQM_DEFAULT_QUEUE_OPTIONS,
@@ -17,6 +18,7 @@ import {
 } from '../constants';
 import { ReadPacket, RmqOptions, WritePacket } from '../interfaces';
 import { ClientProxy } from './client-proxy';
+import { RmqUrl } from '../external/rmq-url.interface';
 
 let rqmPackage: any = {};
 
@@ -27,11 +29,12 @@ export class ClientRMQ extends ClientProxy {
   protected connection: Promise<any>;
   protected client: any = null;
   protected channel: any = null;
-  protected urls: string[];
+  protected urls: string[] | RmqUrl[];
   protected queue: string;
   protected queueOptions: any;
   protected responseEmitter: EventEmitter;
   protected replyQueue: string;
+  protected persistent: boolean;
 
   constructor(protected readonly options: RmqOptions['options']) {
     super();
@@ -43,6 +46,8 @@ export class ClientRMQ extends ClientProxy {
       RQM_DEFAULT_QUEUE_OPTIONS;
     this.replyQueue =
       this.getOptionsProp(this.options, 'replyQueue') || REPLY_QUEUE;
+    this.persistent =
+      this.getOptionsProp(this.options, 'persistent') || RQM_DEFAULT_PERSISTENT;
     loadPackage('amqplib', ClientRMQ.name, () => require('amqplib'));
     rqmPackage = loadPackage('amqp-connection-manager', ClientRMQ.name, () =>
       require('amqp-connection-manager'),
@@ -187,6 +192,7 @@ export class ClientRMQ extends ClientProxy {
         {
           replyTo: this.replyQueue,
           correlationId,
+          persistent: this.persistent,
         },
       );
       return () => this.responseEmitter.removeListener(correlationId, listener);
@@ -202,7 +208,9 @@ export class ClientRMQ extends ClientProxy {
       this.channel.sendToQueue(
         this.queue,
         Buffer.from(JSON.stringify(serializedPacket)),
-        {},
+        {
+          persistent: this.persistent,
+        },
         err => (err ? reject(err) : resolve()),
       ),
     );

packages/microservices/constants.ts

@@ -33,6 +33,7 @@ export const RQM_DEFAULT_PREFETCH_COUNT = 0;
 export const RQM_DEFAULT_IS_GLOBAL_PREFETCH_COUNT = false;
 export const RQM_DEFAULT_QUEUE_OPTIONS = {};
 export const RQM_DEFAULT_NOACK = true;
+export const RQM_DEFAULT_PERSISTENT = false;
 export const GRPC_DEFAULT_PROTO_LOADER = '@grpc/proto-loader';
 
 export const NO_MESSAGE_HANDLER = `There is no matching message handler defined in the remote service.`;

packages/microservices/context/rpc-metadata-constants.ts

@@ -5,5 +5,6 @@ export const DEFAULT_CALLBACK_METADATA = {
 };
 export const DEFAULT_GRPC_CALLBACK_METADATA = {
   [`${RpcParamtype.CONTEXT}:1`]: { index: 1, data: undefined, pipes: [] },
+  [`${RpcParamtype.GRPC_CALL}:2`]: { index: 2, data: undefined, pipes: [] },
   ...DEFAULT_CALLBACK_METADATA,
 };

packages/microservices/enums/kafka-headers.enum.ts

@@ -6,6 +6,7 @@ export enum KafkaHeaders {
   BATCH_CONVERTED_HEADERS = 'kafka_batchConvertedHeaders',
   CONSUMER = 'kafka_consumer',
   CORRELATION_ID = 'kafka_correlationId',
+  DELIVERY_ATTEMPT = 'kafka_deliveryAttempt',
   DLT_EXCEPTION_FQCN = 'kafka_dlt-exception-fqcn',
   DLT_EXCEPTION_MESSAGE = 'kafka_dlt-exception-message',
   DLT_EXCEPTION_STACKTRACE = 'kafka_dlt-exception-stacktrace',
@@ -14,6 +15,7 @@ export enum KafkaHeaders {
   DLT_ORIGINAL_TIMESTAMP = 'kafka_dlt-original-timestamp',
   DLT_ORIGINAL_TIMESTAMP_TYPE = 'kafka_dlt-original-timestamp-type',
   DLT_ORIGINAL_TOPIC = 'kafka_dlt-original-topic',
+  GROUP_ID = 'kafka_groupId',
   MESSAGE_KEY = 'kafka_messageKey',
   NATIVE_HEADERS = 'kafka_nativeHeaders',
   OFFSET = 'kafka_offset',

packages/microservices/enums/rpc-paramtype.enum.ts

@@ -1,4 +1,5 @@
 export enum RpcParamtype {
   PAYLOAD = 3,
   CONTEXT = 6,
+  GRPC_CALL = 9,
 }

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

@@ -1,7 +1,12 @@
 /// <reference types="node" />
 
-import * as tls from 'tls';
 import * as net from 'net';
+import * as tls from 'tls';
+
+type Without<T, U> = { [P in Exclude<keyof T, keyof U>]?: never };
+type XOR<T, U> = T | U extends object
+  ? (Without<T, U> & U) | (Without<U, T> & T)
+  : T | U;
 
 export declare class Kafka {
   constructor(config: KafkaConfig);
@@ -11,13 +16,17 @@ export declare class Kafka {
   logger(): Logger;
 }
 
+export type BrokersFunction = () => string[] | Promise<string[]>;
+
 export interface KafkaConfig {
-  brokers: string[];
+  brokers: string[] | BrokersFunction;
   ssl?: tls.ConnectionOptions | boolean;
   sasl?: SASLOptions;
   clientId?: string;
+  clientIdPostfix?: string;
   connectionTimeout?: number;
   authenticationTimeout?: number;
+  reauthenticationThreshold?: number;
   requestTimeout?: number;
   enforceRequestTimeout?: boolean;
   retry?: RetryOptions;
@@ -33,8 +42,10 @@ export type ISocketFactory = (
   onConnect: () => void,
 ) => net.Socket;
 
+export type SASLMechanism = 'plain' | 'scram-sha-256' | 'scram-sha-512' | 'aws';
+
 export interface SASLOptions {
-  mechanism: 'plain' | 'scram-sha-256' | 'scram-sha-512' | 'aws';
+  mechanism: SASLMechanism;
   username: string;
   password: string;
 }
@@ -65,24 +76,25 @@ export interface PartitionerArgs {
 }
 
 export type ICustomPartitioner = () => (args: PartitionerArgs) => number;
-export type DefaultPartitioner = (args: PartitionerArgs) => number;
-export type JavaCompatiblePartitioner = (args: PartitionerArgs) => number;
+export type DefaultPartitioner = ICustomPartitioner;
+export type JavaCompatiblePartitioner = ICustomPartitioner;
 
 export let Partitioners: {
   DefaultPartitioner: DefaultPartitioner;
   JavaCompatiblePartitioner: JavaCompatiblePartitioner;
 };
 
-export interface PartitionMetadata {
+export type PartitionMetadata = {
   partitionErrorCode: number;
   partitionId: number;
   leader: number;
   replicas: number[];
   isr: number[];
-}
+  offlineReplicas?: number[];
+};
 
 export interface IHeaders {
-  [key: string]: Buffer;
+  [key: string]: Buffer | string;
 }
 
 export interface ConsumerConfig {
@@ -96,15 +108,16 @@ export interface ConsumerConfig {
   minBytes?: number;
   maxBytes?: number;
   maxWaitTimeInMs?: number;
-  retry?: RetryOptions;
+  retry?: RetryOptions & {
+    restartOnFailure?: (err: Error) => Promise<boolean>;
+  };
   allowAutoTopicCreation?: boolean;
   maxInFlightRequests?: number;
   readUncommitted?: boolean;
+  rackId?: string;
 }
 
-export interface PartitionAssigner {
-  new (config: { cluster: Cluster }): Assigner;
-}
+export type PartitionAssigner = (config: { cluster: Cluster }) => Assigner;
 
 export interface CoordinatorMetadata {
   errorCode: number;
@@ -115,7 +128,7 @@ export interface CoordinatorMetadata {
   };
 }
 
-export interface Cluster {
+export type Cluster = {
   isConnected(): boolean;
   connect(): Promise<void>;
   disconnect(): Promise<void>;
@@ -135,46 +148,38 @@ export interface Cluster {
   }): Promise<CoordinatorMetadata>;
   defaultOffset(config: { fromBeginning: boolean }): number;
   fetchTopicsOffset(
-    topics: Array<{
-      topic: string;
-      partitions: Array<{ partition: number }>;
-      fromBeginning: boolean;
-    }>,
+    topics: Array<
+      {
+        topic: string;
+        partitions: Array<{ partition: number }>;
+      } & XOR<{ fromBeginning: boolean }, { fromTimestamp: number }>
+    >,
   ): Promise<{
     topic: string;
     partitions: Array<{ partition: number; offset: string }>;
   }>;
-}
+};
 
-export interface Assignment {
-  [topic: string]: number[];
-}
+export type Assignment = { [topic: string]: number[] };
 
-export interface GroupMember {
-  memberId: string;
-  memberMetadata: MemberMetadata;
-}
+export type GroupMember = { memberId: string; memberMetadata: Buffer };
 
-export interface GroupMemberAssignment {
+export type GroupMemberAssignment = {
   memberId: string;
   memberAssignment: Buffer;
-}
+};
 
-export interface GroupState {
-  name: string;
-  metadata: Buffer;
-}
+export type GroupState = { name: string; metadata: Buffer };
 
-export interface Assigner {
+export type Assigner = {
   name: string;
   version: number;
   assign(group: {
     members: GroupMember[];
     topics: string[];
-    userData: Buffer;
   }): Promise<GroupMemberAssignment[]>;
-  protocol(subscription: { topics: string[]; userData: Buffer }): GroupState;
-}
+  protocol(subscription: { topics: string[] }): GroupState;
+};
 
 export interface RetryOptions {
   maxRetryTime?: number;
@@ -196,12 +201,18 @@ export interface ITopicConfig {
   configEntries?: object[];
 }
 
+export interface ITopicPartitionConfig {
+  topic: string;
+  count: number;
+  assignments?: Array<Array<number>>;
+}
+
 export interface ITopicMetadata {
   name: string;
   partitions: PartitionMetadata[];
 }
 
-export enum ResourceType {
+export enum ResourceTypes {
   UNKNOWN = 0,
   ANY = 1,
   TOPIC = 2,
@@ -212,9 +223,9 @@ export enum ResourceType {
 }
 
 export interface ResourceConfigQuery {
-  type: ResourceType;
+  type: ResourceTypes;
   name: string;
-  configNames: string[];
+  configNames?: string[];
 }
 
 export interface ConfigEntries {
@@ -238,26 +249,26 @@ export interface DescribeConfigResponse {
     errorCode: number;
     errorMessage: string;
     resourceName: string;
-    resourceType: ResourceType;
+    resourceType: ResourceTypes;
   }[];
   throttleTime: number;
 }
 
 export interface IResourceConfig {
-  type: ResourceType;
+  type: ResourceTypes;
   name: string;
   configEntries: { name: string; value: string }[];
 }
 
 type ValueOf<T> = T[keyof T];
 
-export interface AdminEvents {
+export type AdminEvents = {
   CONNECT: 'admin.connect';
   DISCONNECT: 'admin.disconnect';
   REQUEST: 'admin.network.request';
   REQUEST_TIMEOUT: 'admin.network.request_timeout';
   REQUEST_QUEUE_SIZE: 'admin.network.request_queue_size';
-}
+};
 
 export interface InstrumentationEvent<T> {
   id: string;
@@ -266,6 +277,8 @@ export interface InstrumentationEvent<T> {
   payload: T;
 }
 
+export type RemoveInstrumentationEventListener<T> = () => void;
+
 export type ConnectEvent = InstrumentationEvent<null>;
 export type DisconnectEvent = InstrumentationEvent<null>;
 export type RequestEvent = InstrumentationEvent<{
@@ -303,9 +316,10 @@ export interface SeekEntry {
   offset: string;
 }
 
-export interface Admin {
+export type Admin = {
   connect(): Promise<void>;
   disconnect(): Promise<void>;
+  listTopics(): Promise<string[]>;
   createTopics(options: {
     validateOnly?: boolean;
     waitForLeaders?: boolean;
@@ -313,20 +327,30 @@ export interface Admin {
     topics: ITopicConfig[];
   }): Promise<boolean>;
   deleteTopics(options: { topics: string[]; timeout?: number }): Promise<void>;
-  fetchTopicMetadata(options: {
+  createPartitions(options: {
+    validateOnly?: boolean;
+    timeout?: number;
+    topicPartitions: ITopicPartitionConfig[];
+  }): Promise<boolean>;
+  fetchTopicMetadata(options?: {
     topics: string[];
   }): Promise<{ topics: Array<ITopicMetadata> }>;
   fetchOffsets(options: {
     groupId: string;
     topic: string;
-  }): Promise<
-    Array<{ partition: number; offset: string; metadata: string | null }>
-  >;
+  }): Promise<Array<SeekEntry & { metadata: string | null }>>;
   fetchTopicOffsets(
     topic: string,
-  ): Promise<
-    Array<{ partition: number; offset: string; high: string; low: string }>
-  >;
+  ): Promise<Array<SeekEntry & { high: string; low: string }>>;
+  fetchTopicOffsetsByTimestamp(
+    topic: string,
+    timestamp?: number,
+  ): Promise<Array<SeekEntry>>;
+  describeCluster(): Promise<{
+    brokers: Array<{ nodeId: number; host: string; port: number }>;
+    controller: number | null;
+    clusterId: string;
+  }>;
   setOffsets(options: {
     groupId: string;
     topic: string;
@@ -345,29 +369,35 @@ export interface Admin {
     validateOnly: boolean;
     resources: IResourceConfig[];
   }): Promise<any>;
+  listGroups(): Promise<{ groups: GroupOverview[] }>;
+  deleteGroups(groupIds: string[]): Promise<DeleteGroupsResult[]>;
+  describeGroups(groupIds: string[]): Promise<GroupDescriptions>;
   logger(): Logger;
-  on(eventName: ValueOf<AdminEvents>, listener: (...args: any[]) => void): void;
+  on(
+    eventName: ValueOf<AdminEvents>,
+    listener: (...args: any[]) => void,
+  ): RemoveInstrumentationEventListener<typeof eventName>;
   events: AdminEvents;
-}
+};
 
 export let PartitionAssigners: { roundRobin: PartitionAssigner };
 
 export interface ISerializer<T> {
   encode(value: T): Buffer;
-  decode(buffer: Buffer): T;
+  decode(buffer: Buffer): T | null;
 }
 
-export interface MemberMetadata {
+export type MemberMetadata = {
   version: number;
   topics: string[];
   userData: Buffer;
-}
+};
 
-export interface MemberAssignment {
+export type MemberAssignment = {
   version: number;
   assignment: Assignment;
   userData: Buffer;
-}
+};
 
 export let AssignerProtocol: {
   MemberMetadata: ISerializer<MemberMetadata>;
@@ -395,11 +425,16 @@ export interface LoggerEntryContent {
   [key: string]: any;
 }
 
-export type Logger = (entry: LogEntry) => void;
+export type logCreator = (logLevel: logLevel) => (entry: LogEntry) => void;
 
-export type logCreator = (logLevel: string) => (entry: LogEntry) => void;
+export type Logger = {
+  info: (message: string, extra?: object) => void;
+  error: (message: string, extra?: object) => void;
+  warn: (message: string, extra?: object) => void;
+  debug: (message: string, extra?: object) => void;
+};
 
-export interface Broker {
+export type Broker = {
   isConnected(): boolean;
   connect(): Promise<void>;
   disconnect(): Promise<void>;
@@ -409,7 +444,12 @@ export interface Broker {
   metadata(
     topics: string[],
   ): Promise<{
-    brokers: Array<{ nodeId: number; host: string; port: number }>;
+    brokers: Array<{
+      nodeId: number;
+      host: string;
+      port: number;
+      rack?: string;
+    }>;
     topicMetadata: Array<{
       topicErrorCode: number;
       topic: number;
@@ -426,17 +466,33 @@ export interface Broker {
       partitions: Array<{ partition: number; offset: string }>;
     }>;
   }): Promise<any>;
-}
+  fetch(request: {
+    replicaId?: number;
+    isolationLevel?: number;
+    maxWaitTime?: number;
+    minBytes?: number;
+    maxBytes?: number;
+    topics: Array<{
+      topic: string;
+      partitions: Array<{
+        partition: number;
+        fetchOffset: string;
+        maxBytes: number;
+      }>;
+    }>;
+    rackId?: string;
+  }): Promise<any>;
+};
 
-export interface KafkaMessage {
+export type KafkaMessage = {
   key: Buffer;
-  value: Buffer;
+  value: Buffer | null;
   timestamp: string;
   size: number;
   attributes: number;
   offset: string;
   headers?: IHeaders;
-}
+};
 
 export interface ProducerRecord {
   topic: string;
@@ -446,13 +502,13 @@ export interface ProducerRecord {
   compression?: CompressionTypes;
 }
 
-export interface RecordMetadata {
+export type RecordMetadata = {
   topicName: string;
   partition: number;
   errorCode: number;
   offset: string;
   timestamp: string;
-}
+};
 
 export interface TopicMessages {
   topic: string;
@@ -460,10 +516,10 @@ export interface TopicMessages {
 }
 
 export interface ProducerBatch {
-  acks: number;
-  timeout: number;
-  compression: CompressionTypes;
-  topicMessages: TopicMessages[];
+  acks?: number;
+  timeout?: number;
+  compression?: CompressionTypes;
+  topicMessages?: TopicMessages[];
 }
 
 export interface PartitionOffset {
@@ -480,18 +536,18 @@ export interface Offsets {
   topics: TopicOffsets[];
 }
 
-interface Sender {
+type Sender = {
   send(record: ProducerRecord): Promise<RecordMetadata[]>;
   sendBatch(batch: ProducerBatch): Promise<RecordMetadata[]>;
-}
+};
 
-export interface ProducerEvents {
+export type ProducerEvents = {
   CONNECT: 'producer.connect';
   DISCONNECT: 'producer.disconnect';
   REQUEST: 'producer.network.request';
   REQUEST_TIMEOUT: 'producer.network.request_timeout';
   REQUEST_QUEUE_SIZE: 'producer.network.request_queue_size';
-}
+};
 
 export type Producer = Sender & {
   connect(): Promise<void>;
@@ -501,7 +557,7 @@ export type Producer = Sender & {
   on(
     eventName: ValueOf<ProducerEvents>,
     listener: (...args: any[]) => void,
-  ): void;
+  ): RemoveInstrumentationEventListener<typeof eventName>;
   transaction(): Promise<Transaction>;
   logger(): Logger;
 };
@@ -513,41 +569,45 @@ export type Transaction = Sender & {
   isActive(): boolean;
 };
 
-export interface ConsumerGroup {
+export type ConsumerGroup = {
   groupId: string;
   generationId: number;
   memberId: string;
   coordinator: Broker;
-}
+};
 
-export interface MemberDescription {
+export type MemberDescription = {
   clientHost: string;
   clientId: string;
   memberId: string;
   memberAssignment: Buffer;
   memberMetadata: Buffer;
-}
+};
 
-export interface GroupDescription {
+export type GroupDescription = {
   groupId: string;
   members: MemberDescription[];
   protocol: string;
   protocolType: string;
   state: string;
-}
+};
 
-export interface TopicPartitions {
-  topic: string;
-  partitions: number[];
-}
-export interface TopicPartitionOffsetAndMedata {
+export type GroupDescriptions = {
+  groups: GroupDescription[];
+};
+
+export type TopicPartitions = { topic: string; partitions: number[] };
+export type TopicPartitionOffsetAndMetadata = {
   topic: string;
   partition: number;
   offset: string;
   metadata?: string | null;
-}
+};
 
-export interface Batch {
+// TODO: Remove with 2.x
+export type TopicPartitionOffsetAndMedata = TopicPartitionOffsetAndMetadata;
+
+export type Batch = {
   topic: string;
   partition: number;
   highWatermark: string;
@@ -557,12 +617,23 @@ export interface Batch {
   lastOffset(): string;
   offsetLag(): string;
   offsetLagLow(): string;
-}
+};
 
-export interface ConsumerEvents {
+export type GroupOverview = {
+  groupId: string;
+  protocolType: string;
+};
+
+export type DeleteGroupsResult = {
+  groupId: string;
+  errorCode?: number;
+};
+
+export type ConsumerEvents = {
   HEARTBEAT: 'consumer.heartbeat';
   COMMIT_OFFSETS: 'consumer.commit_offsets';
   GROUP_JOIN: 'consumer.group_join';
+  FETCH_START: 'consumer.fetch_start';
   FETCH: 'consumer.fetch';
   START_BATCH_PROCESS: 'consumer.start_batch_process';
   END_BATCH_PROCESS: 'consumer.end_batch_process';
@@ -573,7 +644,7 @@ export interface ConsumerEvents {
   REQUEST: 'consumer.network.request';
   REQUEST_TIMEOUT: 'consumer.network.request_timeout';
   REQUEST_QUEUE_SIZE: 'consumer.network.request_queue_size';
-}
+};
 export type ConsumerHeartbeatEvent = InstrumentationEvent<{
   groupId: string;
   memberId: string;
@@ -643,7 +714,7 @@ export interface EachBatchPayload {
   resolveOffset(offset: string): void;
   heartbeat(): Promise<void>;
   commitOffsetsIfNecessary(offsets?: Offsets): Promise<void>;
-  uncommittedOffsets(): Promise<OffsetsByTopicPartition>;
+  uncommittedOffsets(): OffsetsByTopicPartition;
   isRunning(): boolean;
   isStale(): boolean;
 }
@@ -660,25 +731,29 @@ export type ConsumerEachMessagePayload = EachMessagePayload;
  */
 export type ConsumerEachBatchPayload = EachBatchPayload;
 
-export interface Consumer {
+export type ConsumerRunConfig = {
+  autoCommit?: boolean;
+  autoCommitInterval?: number | null;
+  autoCommitThreshold?: number | null;
+  eachBatchAutoResolve?: boolean;
+  partitionsConsumedConcurrently?: number;
+  eachBatch?: (payload: EachBatchPayload) => Promise<void>;
+  eachMessage?: (payload: EachMessagePayload) => Promise<void>;
+};
+
+export type ConsumerSubscribeTopic = {
+  topic: string | RegExp;
+  fromBeginning?: boolean;
+};
+
+export type Consumer = {
   connect(): Promise<void>;
   disconnect(): Promise<void>;
-  subscribe(topic: {
-    topic: string | RegExp;
-    fromBeginning?: boolean;
-  }): Promise<void>;
+  subscribe(topic: ConsumerSubscribeTopic): Promise<void>;
   stop(): Promise<void>;
-  run(config?: {
-    autoCommit?: boolean;
-    autoCommitInterval?: number | null;
-    autoCommitThreshold?: number | null;
-    eachBatchAutoResolve?: boolean;
-    partitionsConsumedConcurrently?: number;
-    eachBatch?: (payload: EachBatchPayload) => Promise<void>;
-    eachMessage?: (payload: EachMessagePayload) => Promise<void>;
-  }): Promise<void>;
+  run(config?: ConsumerRunConfig): Promise<void>;
   commitOffsets(
-    topicPartitions: Array<TopicPartitionOffsetAndMedata>,
+    topicPartitions: Array<TopicPartitionOffsetAndMetadata>,
   ): Promise<void>;
   seek(topicPartition: {
     topic: string;
@@ -687,14 +762,15 @@ export interface Consumer {
   }): void;
   describeGroup(): Promise<GroupDescription>;
   pause(topics: Array<{ topic: string; partitions?: number[] }>): void;
+  paused(): TopicPartitions[];
   resume(topics: Array<{ topic: string; partitions?: number[] }>): void;
   on(
     eventName: ValueOf<ConsumerEvents>,
     listener: (...args: any[]) => void,
-  ): void;
+  ): RemoveInstrumentationEventListener<typeof eventName>;
   logger(): Logger;
   events: ConsumerEvents;
-}
+};
 
 export enum CompressionTypes {
   None = 0,
@@ -710,3 +786,146 @@ export let CompressionCodecs: {
   [CompressionTypes.LZ4]: () => any;
   [CompressionTypes.ZSTD]: () => any;
 };
+
+export declare class KafkaJSError extends Error {
+  constructor(e: Error | string, metadata?: KafkaJSErrorMetadata);
+}
+
+export declare class KafkaJSNonRetriableError extends KafkaJSError {
+  constructor(e: Error | string);
+}
+
+export declare class KafkaJSProtocolError extends KafkaJSError {
+  constructor(e: Error | string);
+}
+
+export declare class KafkaJSOffsetOutOfRange extends KafkaJSProtocolError {
+  constructor(e: Error | string, metadata?: KafkaJSOffsetOutOfRangeMetadata);
+}
+
+export declare class KafkaJSNumberOfRetriesExceeded extends KafkaJSNonRetriableError {
+  constructor(
+    e: Error | string,
+    metadata?: KafkaJSNumberOfRetriesExceededMetadata,
+  );
+}
+
+export declare class KafkaJSConnectionError extends KafkaJSError {
+  constructor(e: Error | string, metadata?: KafkaJSConnectionErrorMetadata);
+}
+
+export declare class KafkaJSRequestTimeoutError extends KafkaJSError {
+  constructor(e: Error | string, metadata?: KafkaJSRequestTimeoutErrorMetadata);
+}
+
+export declare class KafkaJSMetadataNotLoaded extends KafkaJSError {
+  constructor();
+}
+
+export declare class KafkaJSTopicMetadataNotLoaded extends KafkaJSMetadataNotLoaded {
+  constructor(
+    e: Error | string,
+    metadata?: KafkaJSTopicMetadataNotLoadedMetadata,
+  );
+}
+
+export declare class KafkaJSStaleTopicMetadataAssignment extends KafkaJSError {
+  constructor(
+    e: Error | string,
+    metadata?: KafkaJSStaleTopicMetadataAssignmentMetadata,
+  );
+}
+
+export declare class KafkaJSServerDoesNotSupportApiKey extends KafkaJSNonRetriableError {
+  constructor(
+    e: Error | string,
+    metadata?: KafkaJSServerDoesNotSupportApiKeyMetadata,
+  );
+}
+
+export declare class KafkaJSBrokerNotFound extends KafkaJSError {
+  constructor();
+}
+
+export declare class KafkaJSPartialMessageError extends KafkaJSError {
+  constructor();
+}
+
+export declare class KafkaJSSASLAuthenticationError extends KafkaJSError {
+  constructor();
+}
+
+export declare class KafkaJSGroupCoordinatorNotFound extends KafkaJSError {
+  constructor();
+}
+
+export declare class KafkaJSNotImplemented extends KafkaJSError {
+  constructor();
+}
+
+export declare class KafkaJSTimeout extends KafkaJSError {
+  constructor();
+}
+
+export declare class KafkaJSLockTimeout extends KafkaJSError {
+  constructor();
+}
+
+export declare class KafkaJSUnsupportedMagicByteInMessageSet extends KafkaJSError {
+  constructor();
+}
+
+export declare class KafkaJSDeleteGroupsError extends KafkaJSError {
+  constructor(e: Error | string, groups?: KafkaJSDeleteGroupsErrorGroups[]);
+}
+
+export interface KafkaJSDeleteGroupsErrorGroups {
+  groupId: string;
+  errorCode: number;
+  error: KafkaJSError;
+}
+
+export interface KafkaJSErrorMetadata {
+  retriable?: boolean;
+  topic?: string;
+  partitionId?: number;
+  metadata?: PartitionMetadata;
+}
+
+export interface KafkaJSOffsetOutOfRangeMetadata {
+  topic: string;
+  partition: number;
+}
+
+export interface KafkaJSNumberOfRetriesExceededMetadata {
+  retryCount: number;
+  retryTime: number;
+}
+
+export interface KafkaJSConnectionErrorMetadata {
+  broker?: string;
+  code?: string;
+}
+
+export interface KafkaJSRequestTimeoutErrorMetadata {
+  broker: string;
+  clientId: string;
+  correlationId: number;
+  createdAt: number;
+  sentAt: number;
+  pendingDuration: number;
+}
+
+export interface KafkaJSTopicMetadataNotLoadedMetadata {
+  topic: string;
+}
+
+export interface KafkaJSStaleTopicMetadataAssignmentMetadata {
+  topic: string;
+  unknownPartitions: PartitionMetadata[];
+}
+
+export interface KafkaJSServerDoesNotSupportApiKeyMetadata {
+  apiKey: number;
+  apiName: string;
+}

packages/microservices/external/kafka.interface.ts

@@ -12,13 +12,17 @@ export declare class Kafka {
   logger(): Logger;
 }
 
+export type BrokersFunction = () => string[] | Promise<string[]>;
+
 export interface KafkaConfig {
-  brokers: string[];
+  brokers: string[] | BrokersFunction;
   ssl?: tls.ConnectionOptions | boolean;
   sasl?: SASLOptions;
   clientId?: string;
+  clientIdPostfix?: string;
   connectionTimeout?: number;
   authenticationTimeout?: number;
+  reauthenticationThreshold?: number;
   requestTimeout?: number;
   enforceRequestTimeout?: boolean;
   retry?: RetryOptions;

packages/microservices/external/rmq-url.interface.ts

@@ -0,0 +1,11 @@
+export interface RmqUrl {
+  protocol?: string;
+  hostname?: string;
+  port?: number;
+  username?: string;
+  password?: string;
+  locale?: string;
+  frameMax?: number;
+  heartbeat?: number;
+  vhost?: string;
+}

packages/microservices/factories/rpc-params-factory.ts

@@ -10,6 +10,8 @@ export class RpcParamsFactory {
         return args[0];
       case RpcParamtype.CONTEXT:
         return args[1];
+      case RpcParamtype.GRPC_CALL:
+        return args[2];
       default:
         return null;
     }

packages/microservices/interfaces/microservice-configuration.interface.ts

@@ -12,6 +12,7 @@ import { Server } from '../server/server';
 import { CustomTransportStrategy } from './custom-transport-strategy.interface';
 import { Deserializer } from './deserializer.interface';
 import { Serializer } from './serializer.interface';
+import { RmqUrl } from '../external/rmq-url.interface';
 
 export type MicroserviceOptions =
   | GrpcOptions
@@ -113,13 +114,16 @@ export interface NatsOptions {
     queue?: string;
     serializer?: Serializer;
     deserializer?: Deserializer;
+    userJWT?: string;
+    nonceSigner?: any;
+    userCreds?: any;
   };
 }
 
 export interface RmqOptions {
   transport?: Transport.RMQ;
   options?: {
-    urls?: string[];
+    urls?: string[] | RmqUrl[];
     queue?: string;
     prefetchCount?: number;
     isGlobalPrefetchCount?: boolean;
@@ -129,6 +133,7 @@ export interface RmqOptions {
     serializer?: Serializer;
     deserializer?: Deserializer;
     replyQueue?: string;
+    persistent?: boolean;
   };
 }
 

packages/microservices/nest-microservice.ts

@@ -24,7 +24,8 @@ const { SocketModule } = optionalRequire(
   () => require('@nestjs/websockets/socket-module'),
 );
 
-export class NestMicroservice extends NestApplicationContext
+export class NestMicroservice
+  extends NestApplicationContext
   implements INestMicroservice {
   private readonly logger = new Logger(NestMicroservice.name, true);
   private readonly microservicesModule = new MicroservicesModule();

packages/microservices/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/microservices",
-  "version": "7.4.4",
+  "version": "7.5.5",
   "description": "Nest - modern, fast, powerful node.js web framework (@microservices)",
   "author": "Kamil Mysliwiec",
   "license": "MIT",
@@ -19,11 +19,11 @@
   "dependencies": {
     "iterare": "1.2.1",
     "json-socket": "0.3.0",
-    "tslib": "2.0.1"
+    "tslib": "2.0.3"
   },
   "devDependencies": {
-    "@nestjs/common": "7.4.4",
-    "@nestjs/core": "7.4.4"
+    "@nestjs/common": "7.5.5",
+    "@nestjs/core": "7.5.5"
   },
   "peerDependencies": {
     "@nestjs/common": "^7.0.0",

packages/microservices/server/server-grpc.ts

@@ -26,6 +26,7 @@ let grpcProtoLoaderPackage: any = {};
 interface GrpcCall<TRequest = any, TMetadata = any> {
   request: TRequest;
   metadata: TMetadata;
+  sendMetadata: Function;
   end: Function;
   write: Function;
   on: Function;
@@ -206,7 +207,7 @@ export class ServerGrpc extends Server implements CustomTransportStrategy {
 
   public createUnaryServiceMethod(methodHandler: Function): Function {
     return async (call: GrpcCall, callback: Function) => {
-      const handler = methodHandler(call.request, call.metadata);
+      const handler = methodHandler(call.request, call.metadata, call);
       this.transformToObservable(await handler).subscribe(
         data => callback(null, data),
         (err: any) => callback(err),
@@ -216,7 +217,7 @@ export class ServerGrpc extends Server implements CustomTransportStrategy {
 
   public createStreamServiceMethod(methodHandler: Function): Function {
     return async (call: GrpcCall, callback: Function) => {
-      const handler = methodHandler(call.request, call.metadata);
+      const handler = methodHandler(call.request, call.metadata, call);
       const result$ = this.transformToObservable(await handler);
       await result$
         .pipe(
@@ -254,7 +255,7 @@ export class ServerGrpc extends Server implements CustomTransportStrategy {
       });
       call.on('end', () => req.complete());
 
-      const handler = methodHandler(req.asObservable(), call.metadata);
+      const handler = methodHandler(req.asObservable(), call.metadata, call);
       const res = this.transformToObservable(await handler);
       if (isResponseStream) {
         await res

packages/microservices/server/server-kafka.ts

@@ -10,6 +10,7 @@ import {
 import { KafkaContext } from '../ctx-host';
 import { KafkaHeaders, Transport } from '../enums';
 import {
+  BrokersFunction,
   Consumer,
   ConsumerConfig,
   EachMessagePayload,
@@ -38,11 +39,11 @@ export class ServerKafka extends Server implements CustomTransportStrategy {
   protected consumer: Consumer = null;
   protected producer: Producer = null;
 
-  protected brokers: string[];
+  protected brokers: string[] | BrokersFunction;
   protected clientId: string;
   protected groupId: string;
 
-  constructor(private readonly options: KafkaOptions['options']) {
+  constructor(protected readonly options: KafkaOptions['options']) {
     super();
 
     const clientOptions =
@@ -55,8 +56,11 @@ export class ServerKafka extends Server implements CustomTransportStrategy {
     // append a unique id to the clientId and groupId
     // so they don't collide with a microservices client
     this.clientId =
-      (clientOptions.clientId || KAFKA_DEFAULT_CLIENT) + '-server';
-    this.groupId = (consumerOptions.groupId || KAFKA_DEFAULT_GROUP) + '-server';
+      (clientOptions.clientId || KAFKA_DEFAULT_CLIENT) +
+      (clientOptions.clientIdPostfix || '-server');
+    this.groupId =
+      (consumerOptions.groupId || KAFKA_DEFAULT_GROUP) +
+      (clientOptions.clientIdPostfix || '-server');
 
     kafkaPackage = this.loadPackage('kafkajs', ServerKafka.name, () =>
       require('kafkajs'),

packages/microservices/server/server-nats.ts

@@ -123,11 +123,18 @@ export class ServerNats extends Server implements CustomTransportStrategy {
   }
 
   public getPublisher(publisher: Client, replyTo: string, id: string) {
-    return (response: any) => {
-      Object.assign(response, { id });
-      const outgoingResponse = this.serializer.serialize(response);
-      return publisher.publish(replyTo, outgoingResponse);
-    };
+    if (replyTo) {
+      return (response: any) => {
+        Object.assign(response, { id });
+        const outgoingResponse = this.serializer.serialize(response);
+        return publisher.publish(replyTo, outgoingResponse);
+      };
+    }
+
+    // In case "replyTo" topic is not provided, there's no need for a reply.
+    // Method returns a noop function instead
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    return () => {};
   }
 
   public handleError(stream: any) {

packages/microservices/server/server-rmq.ts

@@ -1,4 +1,8 @@
-import { isString, isUndefined } from '@nestjs/common/utils/shared.utils';
+import {
+  isNil,
+  isString,
+  isUndefined,
+} from '@nestjs/common/utils/shared.utils';
 import { Observable } from 'rxjs';
 import {
   CONNECT_EVENT,
@@ -20,21 +24,22 @@ import {
   OutgoingResponse,
 } from '../interfaces/packet.interface';
 import { Server } from './server';
+import { RmqUrl } from '../external/rmq-url.interface';
 
 let rqmPackage: any = {};
 
 export class ServerRMQ extends Server implements CustomTransportStrategy {
   public readonly transportId = Transport.RMQ;
 
-  private server: any = null;
-  private channel: any = null;
-  private readonly urls: string[];
-  private readonly queue: string;
-  private readonly prefetchCount: number;
-  private readonly queueOptions: any;
-  private readonly isGlobalPrefetchCount: boolean;
+  protected server: any = null;
+  protected channel: any = null;
+  protected readonly urls: string[] | RmqUrl[];
+  protected readonly queue: string;
+  protected readonly prefetchCount: number;
+  protected readonly queueOptions: any;
+  protected readonly isGlobalPrefetchCount: boolean;
 
-  constructor(private readonly options: RmqOptions['options']) {
+  constructor(protected readonly options: RmqOptions['options']) {
     super();
     this.urls = this.getOptionsProp(this.options, 'urls') || [RQM_DEFAULT_URL];
     this.queue =
@@ -110,6 +115,9 @@ export class ServerRMQ extends Server implements CustomTransportStrategy {
     message: Record<string, any>,
     channel: any,
   ): Promise<void> {
+    if (isNil(message)) {
+      return;
+    }
     const { content, properties } = message;
     const rawMessage = JSON.parse(content.toString());
     const packet = this.deserializer.deserialize(rawMessage);

packages/microservices/server/server.ts

@@ -95,7 +95,9 @@ export abstract class Server {
   ): Promise<any> {
     const handler = this.getHandlerByPattern(pattern);
     if (!handler) {
-      return this.logger.error(NO_EVENT_HANDLER);
+      return this.logger.error(
+        `${NO_EVENT_HANDLER} Event pattern: ${JSON.stringify(pattern)}.`,
+      );
     }
     const resultOrStream = await handler(packet.data, context);
     if (this.isObservable(resultOrStream)) {
@@ -103,13 +105,13 @@ export abstract class Server {
     }
   }
 
-  public transformToObservable<T = any>(resultOrDeffered: any): Observable<T> {
-    if (resultOrDeffered instanceof Promise) {
-      return fromPromise(resultOrDeffered);
-    } else if (!this.isObservable(resultOrDeffered)) {
-      return of(resultOrDeffered);
+  public transformToObservable<T = any>(resultOrDeferred: any): Observable<T> {
+    if (resultOrDeferred instanceof Promise) {
+      return fromPromise(resultOrDeferred);
+    } else if (!this.isObservable(resultOrDeferred)) {
+      return of(resultOrDeferred);
     }
-    return resultOrDeffered;
+    return resultOrDeferred;
   }
 
   public getOptionsProp<

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

@@ -232,14 +232,14 @@ describe('ClientKafka', () => {
   });
 
   describe('close', () => {
-    const consumer = { disconnect: sinon.spy() };
-    const producer = { disconnect: sinon.spy() };
+    const consumer = { disconnect: sinon.stub().resolves() };
+    const producer = { disconnect: sinon.stub().resolves() };
     beforeEach(() => {
       (client as any).consumer = consumer;
       (client as any).producer = producer;
     });
-    it('should close server', () => {
-      client.close();
+    it('should close server', async () => {
+      await client.close();
 
       expect(consumer.disconnect.calledOnce).to.be.true;
       expect(producer.disconnect.calledOnce).to.be.true;

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

@@ -142,23 +142,31 @@ describe('ServerNats', () => {
     let pub, publisher;
 
     const id = '1';
-    const replyTo = 'test';
-
     beforeEach(() => {
       publisherSpy = sinon.spy();
       pub = {
         publish: publisherSpy,
       };
-      publisher = server.getPublisher(pub, replyTo, id);
     });
     it(`should return function`, () => {
       expect(typeof server.getPublisher(null, null, id)).to.be.eql('function');
     });
-    it(`should call "publish" with expected arguments`, () => {
+    it(`should call "publish" when replyTo provided`, () => {
+      const replyTo = 'test';
+      publisher = server.getPublisher(pub, replyTo, id);
+
       const respond = 'test';
       publisher({ respond, id });
       expect(publisherSpy.calledWith(replyTo, { respond, id })).to.be.true;
     });
+    it(`should not call "publish" when replyTo NOT provided`, () => {
+      const replyTo = undefined;
+      publisher = server.getPublisher(pub, replyTo, id);
+
+      const respond = 'test';
+      publisher({ respond, id });
+      expect(publisherSpy.notCalled);
+    });
   });
   describe('handleEvent', () => {
     const channel = 'test';

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

@@ -123,7 +123,7 @@ describe('Server', () => {
     });
   });
   describe('transformToObservable', () => {
-    describe('when resultOrDeffered', () => {
+    describe('when resultOrDeferred', () => {
       describe('is Promise', () => {
         it('should returns Observable', async () => {
           const value = 100;

packages/platform-express/Readme.md

@@ -66,7 +66,8 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <a href="https://neoteric.eu/" target="_blank"><img src="https://nestjs.com/img/neoteric-cut.png" width="120" valign="middle" /></a> </td><td>
   <a href="http://gojob.com" target="_blank"><img src="http://nestjs.com/img/gojob-logo.png" valign="middle" width="100" /></a> </td><td>
     <a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="170" valign="middle" /></a> </td><td>
-<a href="http://www.leogistics.com" target="_blank"><img src="https://nestjs.com/img/leogistics-logo.jpeg" width="150" valign="middle" /></td></tr></table>
+<a href="http://www.leogistics.com" target="_blank"><img src="https://nestjs.com/img/leogistics-logo.jpeg" width="150" valign="middle" /></td><td>
+<a href="http://www.meetdandy.com" target="_blank"><img src="https://nestjs.com/img/dandy-wide-logo.png" width="150" valign="middle" /></td></tr></table>
 
 #### Sponsors
 
@@ -84,12 +85,11 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors
 <a href="https://clay.global/" target="_blank"><img src="https://nestjs.com/img/clay-logo.svg" width="75" valign="middle" /></a> </td><td align="center" valign="middle">
 <a href="https://firesticktricks.com" target="_blank"><img src="https://nestjs.com/img/firesticktricks-logo.png" width="120" valign="middle" /></a></td></tr><tr><td align="center" valign="middle">
 <a href="https://www.codeguesser.co.uk" target="_blank"><img src="https://nestjs.com/img/codeguesser-logo.svg" width="120" valign="middle" /></a> </td><td align="center" valign="middle">
-<a href="https://tekhattan.com" target="_blank"><img src="https://nestjs.com/img/tekhattan-logo.png" width="110" valign="middle" /></a> </td><td align="center" valign="middle">
 <a href="https://f-a.nz/" target="_blank"><img src="https://nestjs.com/img/franz.svg" width="80" valign="middle" /></a> </td><td align="center" valign="middle">
 <a href="https://sparkfabrik.com/" target="_blank"><img src="https://nestjs.com/img/sparkfabrik-logo.png" width="120" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://www.thebigphonestore.co.uk/" target="_blank"><img src="https://nestjs.com/img/the-big-phone-store-logo.png" width="65" valign="middle" /></a></td>
   <td align="center" valign="middle">
-  <a href="https://genuinebee.com/" target="_blank"><img src="https://nestjs.com/img/genuinebee.svg" width="97" valign="middle" /></a> </td></tr>
-<tr><td align="center" valign="middle"><a href="https://sanyodigital.com/" target="_blank"><img src="https://nestjs.com/img/sanyo-digital.png" width="130" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://vpn-review.com/vpn-for-torrenting" target="_blank"><img src="https://nestjs.com/img/vpn-review-logo.png" width="85" valign="middle" /></a></td>
+  <a href="https://genuinebee.com/" target="_blank"><img src="https://nestjs.com/img/genuinebee.svg" width="97" valign="middle" /></a> </td>
+<td align="center" valign="middle"><a href="https://sanyodigital.com/" target="_blank"><img src="https://nestjs.com/img/sanyo-digital.png" width="130" valign="middle" /></a></td></tr><tr><td align="center" valign="middle"><a href="https://vpn-review.com/vpn-for-torrenting" target="_blank"><img src="https://nestjs.com/img/vpn-review-logo.png" width="85" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://lambda-it.ch/" target="_blank"><img src="https://nestjs.com/img/lambda-it-logo.svg" width="115" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://pickwriters.com/top-10-translation-services" target="_blank"><img src="https://nestjs.com/img/pickwriters-logo.png" width="40" valign="middle" /></a></td><td align="center" valign="middle"><a href="https://thewordpoint.com/services/localization" target="_blank"><img src="https://nestjs.com/img/thewordpoint-logo.png" width="40" valign="middle" /></a></td>
   </tr></table>
 
 ## Backers

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

@@ -142,6 +142,11 @@ export class ExpressAdapter extends AbstractHttpAdapter {
       .forEach(parserKey => this.use(parserMiddleware[parserKey]));
   }
 
+  public setLocal(key: string, value: any) {
+    this.instance.locals[key] = value;
+    return this;
+  }
+
   public getType(): string {
     return 'express';
   }

packages/platform-express/interfaces/nest-express-application.interface.ts

@@ -75,4 +75,16 @@ export interface NestExpressApplication extends INestApplication {
    * @returns {this}
    */
   setViewEngine(engine: string): this;
+
+  /**
+   * Sets app-level globals for view templates.
+   *
+   * @example
+   * app.setLocal('title', 'My Site')
+   *
+   * @see https://expressjs.com/en/4x/api.html#app.locals
+   *
+   * @returns {this}
+   */
+  setLocal(key: string, value: any): this;
 }

packages/platform-express/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/platform-express",
-  "version": "7.4.4",
+  "version": "7.5.5",
   "description": "Nest - modern, fast, powerful node.js web framework (@platform-express)",
   "author": "Kamil Mysliwiec",
   "license": "MIT",
@@ -21,11 +21,11 @@
     "cors": "2.8.5",
     "express": "4.17.1",
     "multer": "1.4.2",
-    "tslib": "2.0.1"
+    "tslib": "2.0.3"
   },
   "devDependencies": {
-    "@nestjs/common": "7.4.4",
-    "@nestjs/core": "7.4.4"
+    "@nestjs/common": "7.5.5",
+    "@nestjs/core": "7.5.5"
   },
   "peerDependencies": {
     "@nestjs/common": "^7.0.0",