chore(@nestjs) publish v7.3.0 release

Merge branch 'master' of https://github.com/nestjs/nest
feat(core): add instance links, introspection and expose request provider
2026-02-24 00:02:56 +00:00 · 2020-07-01 14:14:39 +02:00 · 2020-07-01 14:05:42 +02:00 · 2020-07-01 14:05:32 +02:00 · 2020-07-01 12:11:24 +02:00 · 2020-07-01 09:36:55 +00:00
246 changed files with 88349 additions and 74962 deletions
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -70,10 +70,10 @@ jobs:
    docker:
      - image: circleci/node:10

-  test_node_8:
+  test_node_14:
    <<: *unit-tests-template
    docker:
-      - image: circleci/node:8
+      - image: circleci/node:14

  lint:
    working_directory: ~/nest
@@ -160,15 +160,15 @@ workflows:
  build-and-test:
    jobs:
      - build
+      - test_node_14:
+          requires:
+            - build
      - test_node_12:
          requires:
            - build
      - test_node_10:
          requires:
            - build
-      - test_node_8:
-          requires:
-            - build
      - lint:
          requires:
            - build
--- a/.eslintrc.js
+++ b/.eslintrc.js
@@ -19,6 +19,8 @@ module.exports = {
    '@typescript-eslint/interface-name-prefix': 'off',
    '@typescript-eslint/explicit-function-return-type': 'off',
    '@typescript-eslint/no-explicit-any': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
    '@typescript-eslint/no-unused-vars': 'off',
+    '@typescript-eslint/ban-types': 'off',
  },
 };
--- a/2
+++ b/2
@@ -1,6 +1,6 @@
 (The MIT License)

-Copyright (c) 2017-2019 Kamil Myśliwiec <http://kamilmysliwiec.com>
+Copyright (c) 2017-2020 Kamil Mysliwiec <https://kamilmysliwiec.com>

 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
--- a/Readme.md
+++ b/Readme.md
@@ -38,6 +38,14 @@ Nest is a framework for building efficient, scalable <a href="http://nodejs.org"
 * To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
 * 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:

+## Questions
+
+For questions and support please use the official [Discord channel](https://discord.gg/G7Qnnhy). The issue list of this repo is **exclusively** for bug reports and feature requests.
+
+## Issues
+
+Please make sure to read the [Issue Reporting Checklist](https://github.com/nestjs/nest/blob/master/CONTRIBUTING.md#-submitting-an-issue) before opening an issue. Issues not conforming to the guidelines may be closed immediately.
+
 ## Consulting

 With official support, you can get expert help straight from Nest core team. We provide dedicated technical support, migration strategies, advice on best practices (and design decisions), PR reviews, and team augmentation. Read more about [support here](https://enterprise.nestjs.com).
@@ -46,32 +54,39 @@ With official support, you can get expert help straight from Nest core team. We

 Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support).

-#### Principal Sponsor
-
-<a href="https://valor-software.com/" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="320" /></a>
+#### Principal Sponsors
+<table style="text-align:center;"><tr><td>
+<a href="https://github.com/Sanofi-IADC" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/sanofi.png" width="180" valign="middle" /></a></td><td>
+<a href="https://valor-software.com/" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="180" valign="middle" /></a></td>
+</tr></table>

 #### Silver Sponsors
-<a href="https://neoteric.eu/" target="_blank"><img src="https://nestjs.com/img/neoteric-cut.png" width="120" valign="middle" /></a> &nbsp;
-  <a href="http://gojob.com" target="_blank"><img src="http://nestjs.com/img/gojob-logo.png" valign="middle" height="95" /></a> &nbsp; 
-    <a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="150" valign="middle" /></a> &nbsp;
-<a href="http://www.leogistics.com" target="_blank"><img src="https://nestjs.com/img/leogistics-logo.jpeg" width="150" valign="middle" /></a>
+
+<table style="text-align:center;"><tr><td>
+<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>

 #### Sponsors

-<a href="https://www.swingdev.io" target="_blank"><img src="https://nestjs.com/img/swingdev-logo.svg#1" width="110" valign="middle" /> </a> &nbsp; <a href="https://blueanchor.io/" target="_blank"><img src="https://nestjs.com/img/blueanchor.png" width="150" valign="middle" /></a> &nbsp;
-<a href="https://www.novologic.com/" target="_blank"><img src="https://nestjs.com/img/novologic.png" width="110" valign="middle" /></a> &nbsp; <a href="https://hostpresto.com" target="_blank"><img src="https://nestjs.com/img/hostpresto.png" height="24" valign="middle" /></a>
-<a href="https://ever.co/" target="_blank"><img src="https://nestjs.com/img/ever-logo.png" height="14" valign="middle" /></a>  &nbsp; 
-<a href="https://buddy.works/" target="_blank"><img src="https://nestjs.com/img/buddy-logo.svg" height="25" valign="middle" /></a> &nbsp;
-<a href="https://blokt.com" target="_blank"><img src="https://nestjs.com/img/blokt-logo.png" height="25" valign="middle" /></a>  &nbsp;  <a href="https://genuinebee.com/" target="_blank"><img src="https://nestjs.com/img/genuinebee.svg" height="27" valign="middle" /></a> &nbsp; <a href="http://architectnow.net/" target="_blank"><img src="https://nestjs.com/img/architectnow.png" height="20" valign="middle" /></a> &nbsp; <a href="https://quander.io/" target="_blank"><img src="https://nestjs.com/img/quander.png" height="22" valign="middle" /></a> &nbsp; <a href="https://mantro.net/" target="_blank"><img src="https://nestjs.com/img/mantro-logo.svg" height="19" valign="middle" /></a> &nbsp; <a href="https://triplebyte.com/" target="_blank"><img src="https://nestjs.com/img/triplebyte.png" height="20" valign="middle" /></a> &nbsp; 
-<a href="https://reposit.co.uk/" target="_blank"><img src="https://nestjs.com/img/reposit-logo.png" height="18" valign="middle" /></a> &nbsp; &nbsp;
-<a href="https://nearpod.com/" target="_blank"><img src="https://nestjs.com/img/nearpod-logo.svg" width="100" valign="middle" /></a> &nbsp;
-<a href="https://clay.global/" target="_blank"><img src="https://nestjs.com/img/clay-logo.svg" width="75" valign="middle" /></a> &nbsp;
-<a href="https://firesticktricks.com" target="_blank"><img src="https://nestjs.com/img/firesticktricks-logo.png" width="120" valign="middle" /></a> &nbsp;
-<a href="https://www.codeguesser.co.uk" target="_blank"><img src="https://nestjs.com/img/codeguesser-logo.svg" width="120" valign="middle" /></a> &nbsp;
-<a href="https://tekhattan.com" target="_blank"><img src="https://nestjs.com/img/tekhattan-logo.png" width="110" valign="middle" /></a> &nbsp;
-<a href="https://f-a.nz/" target="_blank"><img src="https://nestjs.com/img/franz.svg" width="80" valign="middle" /></a> &nbsp;
-<a href="https://sparkfabrik.com/" target="_blank"><img src="https://nestjs.com/img/sparkfabrik-logo.png" width="120" valign="middle" /></a>
-
+<table><tr><td align="center" valign="middle">
+<a href="https://www.swingdev.io" target="_blank"><img src="https://nestjs.com/img/swingdev-logo.svg#1" width="110" valign="middle" /> </a></td><td align="center" valign="middle">
+<a href="https://www.novologic.com/" target="_blank"><img src="https://nestjs.com/img/novologic.png" width="110" valign="middle" /></a> </td><td align="center" valign="middle">
+<a href="https://ever.co/" target="_blank"><img src="https://nestjs.com/img/ever-logo.png" width="72" valign="middle" /></a>  </td><td align="center" valign="middle">
+<a href="https://blokt.com" target="_blank"><img src="https://nestjs.com/img/blokt-logo.png" width="120" valign="middle" /></a>  </td><td align="center" valign="middle"> 
+  <a href="http://architectnow.net/" target="_blank"><img src="https://nestjs.com/img/architectnow.png" width="125" valign="middle" /></a> </td><td align="center" valign="middle">
+  <a href="https://quander.io/" target="_blank"><img src="https://nestjs.com/img/quander.png" width="100" valign="middle" /></a> </td></tr><tr><td align="center" valign="middle">
+  <a href="https://mantro.net/" target="_blank"><img src="https://nestjs.com/img/mantro-logo.svg" width="95" valign="middle" /></a> </td><td align="center" valign="middle">
+  <a href="https://triplebyte.com/" target="_blank"><img src="https://nestjs.com/img/triplebyte.png" width="107" valign="middle" /></a> </td><td align="center" valign="middle">
+<a href="https://reposit.co.uk/" target="_blank"><img src="https://nestjs.com/img/reposit-logo.png" width="71" valign="middle" /></a></td><td align="center" valign="middle">
+<a href="https://nearpod.com/" target="_blank"><img src="https://nestjs.com/img/nearpod-logo.svg" width="100" valign="middle" /></a> </td><td align="center" valign="middle">
+<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></tr></table>

 ## Backers

--- a/integration/docker-compose.yml
+++ b/integration/docker-compose.yml
@@ -23,7 +23,7 @@ services:
      - "9001:9001"
    restart: always
  mysql:
-    image: mysql:5.7.29
+    image: mysql:5.7.30
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: test
--- a/integration/graphql-code-first/schema.gql
+++ b/integration/graphql-code-first/schema.gql
@@ -2,9 +2,22 @@
 # THIS FILE WAS AUTOMATICALLY GENERATED (DO NOT MODIFY)
 # ------------------------------------------------------

+type Recipe {
+  id: ID!
+  title: String!
+  description: String
+  creationDate: Date!
+  ingredients: [String!]!
+}
+
 """Date custom scalar type"""
 scalar Date

+type Query {
+  recipe(id: String!): Recipe!
+  recipes(skip: Int = 0, take: Int = 25): [Recipe!]!
+}
+
 type Mutation {
  addRecipe(newRecipeData: NewRecipeInput!): Recipe!
  removeRecipe(id: String!): Boolean!
@@ -16,19 +29,6 @@ input NewRecipeInput {
  ingredients: [String!]!
 }

-type Query {
-  recipe(id: String!): Recipe!
-  recipes(skip: Int = 0, take: Int = 25): [Recipe!]!
-}
-
-type Recipe {
-  id: ID!
-  title: String!
-  description: String
-  creationDate: Date!
-  ingredients: [String!]!
-}
-
 type Subscription {
  recipeAdded: Recipe!
 }
--- a/integration/hello-world/e2e/middleware-fastify.spec.ts
+++ b/integration/hello-world/e2e/middleware-fastify.spec.ts
@@ -19,7 +19,6 @@ class TestController {
  }

  @Get('tests/wildcard_nested')
-  // eslint-disable-next-line @typescript-eslint/camelcase
  wildcard_nested() {
    return RETURN_VALUE;
  }
--- a/integration/hello-world/e2e/middleware.spec.ts
+++ b/integration/hello-world/e2e/middleware.spec.ts
@@ -21,7 +21,6 @@ class TestController {
  }

  @Get('tests/wildcard_nested')
-  // eslint-disable-next-line @typescript-eslint/camelcase
  wildcard_nested() {
    return RETURN_VALUE;
  }
--- a/integration/injector/e2e/introspection.spec.ts
+++ b/integration/injector/e2e/introspection.spec.ts
@@ -0,0 +1,34 @@
+import { Scope } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { Test, TestingModule } from '@nestjs/testing';
+import { expect } from 'chai';
+import { ScopedModule, STATIC_FACTORY } from '../src/scoped/scoped.module';
+import { ScopedService } from '../src/scoped/scoped.service';
+import { TransientService } from '../src/scoped/transient.service';
+
+describe('Providers introspection', () => {
+  let testingModule: TestingModule;
+  let moduleRef: ModuleRef;
+
+  beforeEach(async () => {
+    testingModule = await Test.createTestingModule({
+      imports: [ScopedModule],
+    }).compile();
+    moduleRef = testingModule.get(ModuleRef);
+  });
+
+  it('should properly introspect a transient provider', async () => {
+    const introspectionResult = moduleRef.introspect(TransientService);
+    expect(introspectionResult.scope).to.be.equal(Scope.TRANSIENT);
+  });
+
+  it('should properly introspect a singleton provider', async () => {
+    const introspectionResult = moduleRef.introspect(STATIC_FACTORY);
+    expect(introspectionResult.scope).to.be.equal(Scope.DEFAULT);
+  });
+
+  it('should properly introspect a request-scoped provider', async () => {
+    const introspectionResult = moduleRef.introspect(ScopedService);
+    expect(introspectionResult.scope).to.be.equal(Scope.REQUEST);
+  });
+});
--- a/integration/injector/e2e/scoped-instances.spec.ts
+++ b/integration/injector/e2e/scoped-instances.spec.ts
@@ -3,9 +3,15 @@ import { InvalidClassScopeException } from '@nestjs/core/errors/exceptions/inval
 import { Test, TestingModule } from '@nestjs/testing';
 import { expect } from 'chai';
 import { ScopedController } from '../src/scoped/scoped.controller';
-import { ScopedModule } from '../src/scoped/scoped.module';
+import {
+  REQUEST_SCOPED_FACTORY,
+  ScopedModule,
+  STATIC_FACTORY,
+  TRANSIENT_SCOPED_FACTORY,
+} from '../src/scoped/scoped.module';
 import { ScopedService } from '../src/scoped/scoped.service';
 import { TransientService } from '../src/scoped/transient.service';
+import { Transient3Service } from '../src/scoped/transient3.service';

 describe('Scoped Instances', () => {
  let testingModule: TestingModule;
@@ -20,20 +26,47 @@ describe('Scoped Instances', () => {
    const contextId = createContextId();
    const transient1 = await testingModule.resolve(TransientService, contextId);
    const transient2 = await testingModule.resolve(TransientService, contextId);
+    const transientFactory = await testingModule.resolve(
+      TRANSIENT_SCOPED_FACTORY,
+    );

    expect(transient1).to.be.instanceOf(TransientService);
    expect(transient2).to.be.instanceOf(TransientService);
    expect(transient1).to.be.equal(transient2);
+    expect(transientFactory).to.be.true;
+  });
+
+  it('should dynamically resolve nested transient provider', async () => {
+    const contextId = createContextId();
+    const transientTwoDepthLevel = await testingModule.resolve(
+      TransientService,
+      contextId,
+    );
+    const transientThreeDepthLevel = await testingModule.resolve(
+      Transient3Service,
+      contextId,
+    );
+
+    expect(transientTwoDepthLevel.svc.logger).to.not.be.undefined;
+    expect(transientThreeDepthLevel.svc.svc.logger).to.not.be.undefined;
  });

  it('should dynamically resolve request-scoped provider', async () => {
    const request1 = await testingModule.resolve(ScopedService);
    const request2 = await testingModule.resolve(ScopedService);
-    const request3 = await testingModule.resolve(ScopedService, { id: 1 });
+
+    const ctxId = { id: 1 };
+    const requestProvider = { host: 'localhost' };
+    testingModule.registerRequestByContextId(requestProvider, ctxId);
+
+    const request3 = await testingModule.resolve(ScopedService, ctxId);
+    const requestFactory = await testingModule.resolve(REQUEST_SCOPED_FACTORY);

    expect(request1).to.be.instanceOf(ScopedService);
    expect(request2).to.be.instanceOf(ScopedService);
    expect(request3).to.not.be.equal(request2);
+    expect(requestFactory).to.be.true;
+    expect(request3.request).to.be.equal(requestProvider);
  });

  it('should dynamically resolve request-scoped controller', async () => {
@@ -46,11 +79,19 @@ describe('Scoped Instances', () => {
    expect(request3).to.not.be.equal(request2);
  });

-  it('should throw an exception when "get()" method is used', async () => {
+  it('should throw an exception when "get()" method is used for scoped providers', () => {
    try {
      testingModule.get(ScopedController);
    } catch (err) {
      expect(err).to.be.instanceOf(InvalidClassScopeException);
    }
  });
+
+  it('should throw an exception when "resolve()" method is used for static providers', async () => {
+    try {
+      await testingModule.resolve(STATIC_FACTORY);
+    } catch (err) {
+      expect(err).to.be.instanceOf(InvalidClassScopeException);
+    }
+  });
 });
--- a/integration/injector/src/scoped/scoped.module.ts
+++ b/integration/injector/src/scoped/scoped.module.ts
@@ -1,11 +1,35 @@
-import { Module } from '@nestjs/common';
+import { Module, Scope } from '@nestjs/common';
 import { ScopedController } from './scoped.controller';
 import { ScopedService } from './scoped.service';
 import { TransientService } from './transient.service';
 import { Transient2Service } from './transient2.service';
+import { Transient3Service } from './transient3.service';
+
+export const STATIC_FACTORY = 'STATIC_FACTORY';
+export const REQUEST_SCOPED_FACTORY = 'REQUEST_SCOPED_FACTORY';
+export const TRANSIENT_SCOPED_FACTORY = 'TRANSIENT_SCOPED_FACTORY';

@Module({
  controllers: [ScopedController],
-  providers: [ScopedService, TransientService, Transient2Service],
+  providers: [
+    ScopedService,
+    TransientService,
+    Transient2Service,
+    Transient3Service,
+    {
+      provide: STATIC_FACTORY,
+      useFactory: () => true,
+    },
+    {
+      provide: REQUEST_SCOPED_FACTORY,
+      useFactory: () => true,
+      scope: Scope.REQUEST,
+    },
+    {
+      provide: TRANSIENT_SCOPED_FACTORY,
+      useFactory: () => true,
+      scope: Scope.TRANSIENT,
+    },
+  ],
 })
 export class ScopedModule {}
--- a/integration/injector/src/scoped/scoped.service.ts
+++ b/integration/injector/src/scoped/scoped.service.ts
@@ -1,4 +1,7 @@
-import { Injectable, Scope } from '@nestjs/common';
+import { Inject, Injectable, Scope } from '@nestjs/common';
+import { REQUEST } from '@nestjs/core';

@Injectable({ scope: Scope.REQUEST })
-export class ScopedService {}
+export class ScopedService {
+  constructor(@Inject(REQUEST) public readonly request) {}
+}
--- a/integration/injector/src/scoped/transient.service.ts
+++ b/integration/injector/src/scoped/transient.service.ts
@@ -3,5 +3,5 @@ import { Transient2Service } from './transient2.service';

@Injectable({ scope: Scope.TRANSIENT })
 export class TransientService {
-  constructor(private readonly svc: Transient2Service) {}
+  constructor(public readonly svc: Transient2Service) {}
 }
--- a/integration/injector/src/scoped/transient2.service.ts
+++ b/integration/injector/src/scoped/transient2.service.ts
@@ -1,4 +1,6 @@
-import { Injectable, Scope } from '@nestjs/common';
+import { Injectable, Logger, Scope } from '@nestjs/common';

@Injectable({ scope: Scope.TRANSIENT })
-export class Transient2Service {}
+export class Transient2Service {
+  logger = new Logger();
+}
--- a/integration/injector/src/scoped/transient3.service.ts
+++ b/integration/injector/src/scoped/transient3.service.ts
@@ -0,0 +1,7 @@
+import { Injectable, Scope } from '@nestjs/common';
+import { TransientService } from './transient.service';
+
+@Injectable({ scope: Scope.TRANSIENT })
+export class Transient3Service {
+  constructor(public readonly svc: TransientService) {}
+}
--- a/integration/microservices/e2e/sum-grpc.spec.ts
+++ b/integration/microservices/e2e/sum-grpc.spec.ts
@@ -25,8 +25,11 @@ describe('GRPC transport', () => {
    app.connectMicroservice({
      transport: Transport.GRPC,
      options: {
-        package: 'math',
-        protoPath: join(__dirname, '../src/grpc/math.proto'),
+        package: ['math', 'math2'],
+        protoPath: [
+          join(__dirname, '../src/grpc/math.proto'),
+          join(__dirname, '../src/grpc/math2.proto'),
+        ],
      },
    });
    // Start gRPC microservice
@@ -47,7 +50,19 @@ describe('GRPC transport', () => {

  it(`GRPC Sending and Receiving HTTP POST`, () => {
    return request(server)
-      .post('/')
+      .post('/sum')
+      .send([1, 2, 3, 4, 5])
+      .expect(200, { result: 15 });
+  });
+
+  it(`GRPC Sending and Receiving HTTP POST (multiple proto)`, async () => {
+    await request(server)
+      .post('/multi/sum')
+      .send([1, 2, 3, 4, 5])
+      .expect(200, { result: 15 });
+
+    await request(server)
+      .post('/multi/sum2')
      .send([1, 2, 3, 4, 5])
      .expect(200, { result: 15 });
  });
--- a/integration/microservices/src/grpc/grpc.controller.ts
+++ b/integration/microservices/src/grpc/grpc.controller.ts
@@ -31,9 +31,9 @@ export class GrpcController {
      ],
    },
  })
-  client2: ClientGrpc;
+  clientMulti: ClientGrpc;

-  @Post()
+  @Post('sum')
  @HttpCode(200)
  call(@Body() data: number[]): Observable<number> {
    const svc = this.client.getService<any>('Math');
@@ -77,10 +77,17 @@ export class GrpcController {
    });
  }

-  @Post()
+  @Post('multi/sum')
  @HttpCode(200)
-  call2(@Body() data: number[]): Observable<number> {
-    const svc = this.client2.getService<any>('Math2');
+  callMultiSum(@Body() data: number[]): Observable<number> {
+    const svc = this.clientMulti.getService<any>('Math');
    return svc.sum({ data });
  }
+
+  @Post('multi/sum2')
+  @HttpCode(200)
+  callMultiSum2(@Body() data: number[]): Observable<number> {
+    const svc = this.clientMulti.getService<any>('Math2');
+    return svc.sum2({ data });
+  }
 }
--- a/lerna.json
+++ b/lerna.json
@@ -3,5 +3,5 @@
  "packages": [
    "packages/*"
  ],
-  "version": "7.0.5"
+  "version": "7.3.0"
 }
--- a/package-lock.json
+++ b/package-lock.json
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@nestjs/core",
-  "version": "7.0.3",
+  "version": "7.0.11",
  "description": "Modern, fast, powerful node.js web framework",
  "homepage": "https://nestjs.com",
  "repository": {
@@ -27,7 +27,7 @@
    "test": "nyc --require ts-node/register mocha packages/**/*.spec.ts --reporter spec --retries 3 --require 'node_modules/reflect-metadata/Reflect.js' --exit",
    "test:integration": "mocha \"integration/*/{,!(node_modules)/**/}/*.spec.ts\" --reporter spec --require ts-node/register --require 'node_modules/reflect-metadata/Reflect.js' --exit",
    "test:docker:up": "docker-compose -f integration/docker-compose.yml up -d",
-    "test:docker:down": "docker-compose -f integration/docker-compose.yml down -d",
+    "test:docker:down": "docker-compose -f integration/docker-compose.yml down",
    "lint": "concurrently 'npm run lint:packages' 'npm run lint:integration' 'npm run lint:spec'",
    "lint:integration": "eslint 'integration/*/{,!(node_modules)/**/}/*.ts' -c '.eslintrc.spec.js' --fix",
    "lint:packages": "eslint 'packages/**/**.ts' --fix --ignore-pattern 'packages/**/*.spec.ts'",
@@ -54,115 +54,114 @@
    "@nuxtjs/opencollective": "0.2.2",
    "axios": "0.19.2",
    "class-transformer": "0.2.3",
-    "class-validator": "0.11.1",
+    "class-validator": "0.12.2",
    "cli-color": "2.0.0",
    "cors": "2.8.5",
    "express": "4.17.1",
-    "fast-json-stringify": "1.18.0",
+    "fast-json-stringify": "2.2.1",
    "fast-safe-stringify": "2.0.7",
-    "iterare": "1.2.0",
+    "iterare": "1.2.1",
    "object-hash": "2.0.3",
    "path-to-regexp": "3.2.0",
    "reflect-metadata": "0.1.13",
-    "rxjs": "6.5.4",
+    "rxjs": "6.5.5",
    "socket.io": "2.3.0",
-    "uuid": "7.0.2",
-    "tslib": "1.11.1"
+    "uuid": "8.2.0",
+    "tslib": "2.0.0"
  },
  "devDependencies": {
    "@codechecks/client": "0.1.10",
-    "@commitlint/cli": "8.3.5",
-    "@commitlint/config-angular": "8.3.4",
-    "@grpc/proto-loader": "0.5.3",
-    "@nestjs/graphql": "7.1.1",
-    "@nestjs/mongoose": "6.4.0",
-    "@nestjs/typeorm": "7.0.0",
+    "@commitlint/cli": "9.0.1",
+    "@commitlint/config-angular": "9.0.1",
+    "@grpc/proto-loader": "0.5.4",
+    "@nestjs/graphql": "7.4.6",
+    "@nestjs/mongoose": "7.0.1",
+    "@nestjs/typeorm": "7.1.0",
    "@types/amqplib": "0.5.13",
    "@types/bytes": "3.1.0",
-    "@types/cache-manager": "2.10.2",
-    "@types/chai": "4.2.10",
+    "@types/cache-manager": "2.10.3",
+    "@types/chai": "4.2.11",
    "@types/chai-as-promised": "7.1.2",
    "@types/cors": "2.8.6",
-    "@types/express": "4.17.3",
+    "@types/express": "4.17.6",
    "@types/fastify-cors": "2.1.0",
    "@types/gulp": "4.0.6",
-    "@types/kafka-node": "2.0.9",
    "@types/mocha": "7.0.2",
-    "@types/mongoose": "5.7.7",
+    "@types/mongoose": "5.7.29",
    "@types/node": "10.17.3",
-    "@types/redis": "2.8.16",
+    "@types/redis": "2.8.22",
    "@types/reflect-metadata": "0.0.5",
-    "@types/sinon": "7.5.2",
-    "@types/socket.io": "2.1.4",
-    "@types/ws": "7.2.3",
-    "@typescript-eslint/eslint-plugin": "2.25.0",
-    "@typescript-eslint/parser": "2.25.0",
+    "@types/sinon": "9.0.4",
+    "@types/socket.io": "2.1.8",
+    "@types/ws": "7.2.6",
+    "@typescript-eslint/eslint-plugin": "3.5.0",
+    "@typescript-eslint/parser": "3.5.0",
    "amqp-connection-manager": "3.2.0",
-    "amqplib": "0.5.5",
-    "apollo-server-express": "2.11.0",
-    "artillery": "1.6.0",
+    "amqplib": "0.5.6",
+    "apollo-server-express": "2.15.1",
+    "artillery": "1.6.1",
    "awesome-typescript-loader": "5.2.1",
    "body-parser": "1.19.0",
    "bytes": "3.1.0",
-    "cache-manager": "3.2.1",
+    "cache-manager": "3.3.0",
    "chai": "4.2.0",
    "chai-as-promised": "7.1.1",
    "clang-format": "1.4.0",
    "commitlint-circle": "1.0.0",
-    "concurrently": "5.1.0",
-    "conventional-changelog": "3.1.18",
-    "core-js": "3.6.4",
-    "coveralls": "3.0.11",
+    "concurrently": "5.2.0",
+    "conventional-changelog": "3.1.21",
+    "core-js": "3.6.5",
+    "coveralls": "3.1.0",
    "delete-empty": "3.0.0",
-    "engine.io-client": "3.4.0",
-    "eslint": "6.8.0",
-    "eslint-config-prettier": "6.10.1",
-    "eslint-plugin-import": "2.20.1",
+    "engine.io-client": "3.4.3",
+    "eslint": "7.3.1",
+    "eslint-config-prettier": "6.11.0",
+    "eslint-plugin-import": "2.22.0",
    "fancy-log": "1.3.3",
-    "fastify": "2.13.0",
-    "fastify-cors": "3.0.2",
-    "fastify-formbody": "3.1.0",
-    "fastify-multipart": "1.0.5",
-    "fastify-static": "2.6.0",
-    "graphql": "14.6.0",
-    "graphql-tools": "4.0.7",
-    "grpc": "1.24.2",
+    "fastify": "2.15.1",
+    "fastify-cors": "3.0.3",
+    "fastify-formbody": "3.2.0",
+    "fastify-multipart": "1.0.6",
+    "fastify-static": "2.7.0",
+    "graphql": "15.2.0",
+    "graphql-tools": "6.0.11",
+    "grpc": "1.24.3",
    "gulp": "4.0.2",
    "gulp-clang-format": "1.0.27",
    "gulp-clean": "0.4.0",
    "gulp-sourcemaps": "2.6.5",
    "gulp-typescript": "5.0.1",
    "gulp-watch": "5.0.1",
-    "husky": "4.2.3",
-    "imports-loader": "0.8.0",
+    "husky": "4.2.5",
+    "imports-loader": "1.1.0",
    "json-loader": "0.5.7",
    "kafkajs": "1.12.0",
    "lerna": "2.11.0",
-    "lint-staged": "10.0.9",
+    "lint-staged": "10.2.11",
    "markdown-table": "2.0.0",
-    "merge-graphql-schemas": "1.7.6",
-    "mocha": "7.1.1",
-    "mongoose": "5.9.6",
-    "mqtt": "3.0.0",
+    "merge-graphql-schemas": "1.7.8",
+    "mocha": "7.1.2",
+    "mongoose": "5.9.20",
+    "mqtt": "4.1.0",
    "multer": "1.4.2",
    "mysql": "2.18.1",
-    "nats": "1.4.8",
-    "nodemon": "2.0.2",
-    "nyc": "15.0.0",
-    "prettier": "2.0.2",
+    "nats": "1.4.9",
+    "nodemon": "2.0.4",
+    "nyc": "15.1.0",
+    "prettier": "2.0.5",
    "redis": "3.0.2",
-    "rxjs-compat": "6.5.4",
-    "sinon": "9.0.1",
+    "rxjs-compat": "6.5.5",
+    "sinon": "9.0.2",
    "sinon-chai": "3.5.0",
    "socket.io-client": "2.3.0",
    "subscriptions-transport-ws": "0.9.16",
    "supertest": "4.0.2",
-    "ts-morph": "7.0.0",
-    "ts-node": "8.8.1",
-    "typeorm": "0.2.24",
-    "typescript": "3.7.2",
+    "ts-morph": "7.1.2",
+    "ts-node": "8.10.2",
+    "typeorm": "0.2.25",
+    "typescript": "3.9.5",
    "wrk": "1.2.0",
-    "ws": "7.2.3"
+    "ws": "7.3.0"
  },
  "engines": {
    "node": ">= 10.13.0"
@@ -193,7 +192,7 @@
      "packages/microservices/microservices-module.ts",
      "packages/core/middleware/middleware-module.ts",
      "packages/core/injector/module-ref.ts",
-      "packages/core/injector/container-scanner.ts",
+      "packages/core/injector/instance-links-host.ts",
      "packages/common/cache/**/*",
      "packages/common/serializer/**/*",
      "packages/common/services/logger.service.ts"
--- a/packages/common/Readme.md
+++ b/packages/common/Readme.md
@@ -38,6 +38,14 @@ Nest is a framework for building efficient, scalable <a href="http://nodejs.org"
 * To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
 * 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:

+## Questions
+
+For questions and support please use the official [Discord channel](https://discord.gg/G7Qnnhy). The issue list of this repo is **exclusively** for bug reports and feature requests.
+
+## Issues
+
+Please make sure to read the [Issue Reporting Checklist](https://github.com/nestjs/nest/blob/master/CONTRIBUTING.md#-submitting-an-issue) before opening an issue. Issues not conforming to the guidelines may be closed immediately.
+
 ## Consulting

 With official support, you can get expert help straight from Nest core team. We provide dedicated technical support, migration strategies, advice on best practices (and design decisions), PR reviews, and team augmentation. Read more about [support here](https://enterprise.nestjs.com).
@@ -48,30 +56,35 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors

 #### Principal Sponsor

-<a href="https://valor-software.com/" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="320" /></a>
+<a href="https://valor-software.com/" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="220" /></a>

 #### Silver Sponsors
-<a href="https://neoteric.eu/" target="_blank"><img src="https://nestjs.com/img/neoteric-cut.png" width="120" valign="middle" /></a> &nbsp;
-  <a href="http://gojob.com" target="_blank"><img src="http://nestjs.com/img/gojob-logo.png" valign="middle" height="95" /></a> &nbsp; 
-    <a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="150" valign="middle" /></a> &nbsp;
-<a href="http://www.leogistics.com" target="_blank"><img src="https://nestjs.com/img/leogistics-logo.jpeg" width="150" valign="middle" /></a>
+
+<table style="text-align:center;"><tr><td>
+<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>

 #### Sponsors

-<a href="https://www.swingdev.io" target="_blank"><img src="https://nestjs.com/img/swingdev-logo.svg#1" width="110" valign="middle" /> </a> &nbsp; <a href="https://blueanchor.io/" target="_blank"><img src="https://nestjs.com/img/blueanchor.png" width="150" valign="middle" /></a> &nbsp;
-<a href="https://www.novologic.com/" target="_blank"><img src="https://nestjs.com/img/novologic.png" width="110" valign="middle" /></a> &nbsp; <a href="https://hostpresto.com" target="_blank"><img src="https://nestjs.com/img/hostpresto.png" height="24" valign="middle" /></a>
-<a href="https://ever.co/" target="_blank"><img src="https://nestjs.com/img/ever-logo.png" height="14" valign="middle" /></a>  &nbsp; 
-<a href="https://buddy.works/" target="_blank"><img src="https://nestjs.com/img/buddy-logo.svg" height="25" valign="middle" /></a> &nbsp;
-<a href="https://blokt.com" target="_blank"><img src="https://nestjs.com/img/blokt-logo.png" height="25" valign="middle" /></a>  &nbsp;  <a href="https://genuinebee.com/" target="_blank"><img src="https://nestjs.com/img/genuinebee.svg" height="27" valign="middle" /></a> &nbsp; <a href="http://architectnow.net/" target="_blank"><img src="https://nestjs.com/img/architectnow.png" height="20" valign="middle" /></a> &nbsp; <a href="https://quander.io/" target="_blank"><img src="https://nestjs.com/img/quander.png" height="22" valign="middle" /></a> &nbsp; <a href="https://mantro.net/" target="_blank"><img src="https://nestjs.com/img/mantro-logo.svg" height="19" valign="middle" /></a> &nbsp; <a href="https://triplebyte.com/" target="_blank"><img src="https://nestjs.com/img/triplebyte.png" height="20" valign="middle" /></a> &nbsp; 
-<a href="https://reposit.co.uk/" target="_blank"><img src="https://nestjs.com/img/reposit-logo.png" height="18" valign="middle" /></a> &nbsp; &nbsp;
-<a href="https://nearpod.com/" target="_blank"><img src="https://nestjs.com/img/nearpod-logo.svg" width="100" valign="middle" /></a> &nbsp;
-<a href="https://clay.global/" target="_blank"><img src="https://nestjs.com/img/clay-logo.svg" width="75" valign="middle" /></a> &nbsp;
-<a href="https://firesticktricks.com" target="_blank"><img src="https://nestjs.com/img/firesticktricks-logo.png" width="120" valign="middle" /></a> &nbsp;
-<a href="https://www.codeguesser.co.uk" target="_blank"><img src="https://nestjs.com/img/codeguesser-logo.svg" width="120" valign="middle" /></a> &nbsp;
-<a href="https://tekhattan.com" target="_blank"><img src="https://nestjs.com/img/tekhattan-logo.png" width="110" valign="middle" /></a> &nbsp;
-<a href="https://f-a.nz/" target="_blank"><img src="https://nestjs.com/img/franz.svg" width="80" valign="middle" /></a> &nbsp;
-<a href="https://sparkfabrik.com/" target="_blank"><img src="https://nestjs.com/img/sparkfabrik-logo.png" width="120" valign="middle" /></a>
-
+<table><tr><td align="center" valign="middle">
+<a href="https://www.swingdev.io" target="_blank"><img src="https://nestjs.com/img/swingdev-logo.svg#1" width="110" valign="middle" /> </a></td><td align="center" valign="middle">
+<a href="https://www.novologic.com/" target="_blank"><img src="https://nestjs.com/img/novologic.png" width="110" valign="middle" /></a> </td><td align="center" valign="middle">
+<a href="https://ever.co/" target="_blank"><img src="https://nestjs.com/img/ever-logo.png" width="72" valign="middle" /></a>  </td><td align="center" valign="middle">
+<a href="https://blokt.com" target="_blank"><img src="https://nestjs.com/img/blokt-logo.png" width="120" valign="middle" /></a>  </td><td align="center" valign="middle"> 
+  <a href="http://architectnow.net/" target="_blank"><img src="https://nestjs.com/img/architectnow.png" width="125" valign="middle" /></a> </td><td align="center" valign="middle">
+  <a href="https://quander.io/" target="_blank"><img src="https://nestjs.com/img/quander.png" width="100" valign="middle" /></a> </td></tr><tr><td align="center" valign="middle">
+  <a href="https://mantro.net/" target="_blank"><img src="https://nestjs.com/img/mantro-logo.svg" width="95" valign="middle" /></a> </td><td align="center" valign="middle">
+  <a href="https://triplebyte.com/" target="_blank"><img src="https://nestjs.com/img/triplebyte.png" width="107" valign="middle" /></a> </td><td align="center" valign="middle">
+<a href="https://reposit.co.uk/" target="_blank"><img src="https://nestjs.com/img/reposit-logo.png" width="71" valign="middle" /></a></td><td align="center" valign="middle">
+<a href="https://nearpod.com/" target="_blank"><img src="https://nestjs.com/img/nearpod-logo.svg" width="100" valign="middle" /></a> </td><td align="center" valign="middle">
+<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></tr></table>

 ## Backers

--- a/packages/common/cache/interceptors/cache.interceptor.ts
+++ b/packages/common/cache/interceptors/cache.interceptor.ts
@@ -7,6 +7,7 @@ import {
  HttpServer,
  NestInterceptor,
 } from '../../interfaces';
+import { isNil } from '../../utils/shared.utils';
 import {
  CACHE_KEY_METADATA,
  CACHE_MANAGER,
@@ -44,13 +45,13 @@ export class CacheInterceptor implements NestInterceptor {
    }
    try {
      const value = await this.cacheManager.get(key);
-      if (value) {
+      if (typeof value !== 'undefined') {
        return of(value);
      }

      return next.handle().pipe(
        tap(response => {
-          const args = ttl ? [key, response, { ttl }] : [key, response];
+          const args = isNil(ttl) ? [key, response] : [key, response, { ttl }];
          this.cacheManager.set(...args);
        }),
      );
--- a/packages/common/decorators/core/set-metadata.decorator.ts
+++ b/packages/common/decorators/core/set-metadata.decorator.ts
@@ -9,7 +9,7 @@ export type CustomDecorator<TKey = string> = MethodDecorator &
 *
 * Requires two parameters:
 * - `key` - a value defining the key under which the metadata is stored
- * - `value[]` - array of metadata values to be associated with `key`
+ * - `value` - metadata to be associated with `key`
 *
 * This metadata can be reflected using the `Reflector` class.
 *
--- a/packages/common/decorators/http/redirect.decorator.ts
+++ b/packages/common/decorators/http/redirect.decorator.ts
@@ -5,7 +5,7 @@ import { REDIRECT_METADATA } from '../../constants';
 *
 * @publicApi
 */
-export function Redirect(url: string, statusCode?: number): MethodDecorator {
+export function Redirect(url = '', statusCode?: number): MethodDecorator {
  return (
    target: object,
    key: string | symbol,
--- a/packages/common/http/http.service.ts
+++ b/packages/common/http/http.service.ts
@@ -1,8 +1,9 @@
 import Axios, {
  AxiosInstance,
+  AxiosPromise,
  AxiosRequestConfig,
  AxiosResponse,
-  AxiosPromise,
+  CancelTokenSource,
 } from 'axios';
 import { Observable } from 'rxjs';
 import { Inject } from '../decorators';
@@ -72,13 +73,14 @@ export class HttpService {
    ...args: any[]
  ) {
    return new Observable<AxiosResponse<T>>(subscriber => {
-      let config = args[args.length - 1];
-      if (!config) {
-        config = {};
-        args[args.length - 1] = config;
+      const config: AxiosRequestConfig = { ...(args[args.length - 1] || {}) };
+
+      let cancelSource: CancelTokenSource;
+      if (!config.cancelToken) {
+        cancelSource = Axios.CancelToken.source();
+        config.cancelToken = cancelSource.token;
      }
-      const cancelSource = Axios.CancelToken.source();
-      config.cancelToken = cancelSource.token;
+
      axios(...args)
        .then(res => {
          subscriber.next(res);
@@ -88,7 +90,11 @@ export class HttpService {
          subscriber.error(err);
        });
      return () => {
-        if (config.responseType !== 'stream') {
+        if (config.responseType === 'stream') {
+          return;
+        }
+
+        if (cancelSource) {
          cancelSource.cancel();
        }
      };
--- a/packages/common/index.ts
+++ b/packages/common/index.ts
@@ -30,8 +30,11 @@ export {
  INestApplication,
  INestApplicationContext,
  INestMicroservice,
+  IntrospectionResult,
  MiddlewareConsumer,
+  ModuleMetadata,
  NestApplicationOptions,
+  NestHybridApplicationOptions,
  NestInterceptor,
  NestMiddleware,
  NestModule,
--- a/packages/common/interfaces/features/nest-interceptor.interface.ts
+++ b/packages/common/interfaces/features/nest-interceptor.interface.ts
@@ -10,7 +10,7 @@ import { ExecutionContext } from './execution-context.interface';
 */
 export interface CallHandler<T = any> {
  /**
-   * Returns an `Observable` reprsenting the response stream from the route
+   * Returns an `Observable` representing the response stream from the route
   * handler.
   */
  handle(): Observable<T>;
--- a/packages/common/interfaces/index.ts
+++ b/packages/common/interfaces/index.ts
@@ -15,12 +15,9 @@ export * from './features/pipe-transform.interface';
 export * from './hooks';
 export * from './http/http-server.interface';
 export * from './injectable.interface';
+export * from './microservices/nest-hybrid-application-options.interface';
 export * from './middleware';
-export * from './modules/dynamic-module.interface';
-export * from './modules/forward-reference.interface';
-export * from './modules/module-metadata.interface';
-export * from './modules/nest-module.interface';
-export * from './modules/provider.interface';
+export * from './modules';
 export * from './nest-application-context.interface';
 export * from './nest-application-options.interface';
 export * from './nest-application.interface';
--- a/packages/common/interfaces/microservices/nest-hybrid-application-options.interface.ts
+++ b/packages/common/interfaces/microservices/nest-hybrid-application-options.interface.ts
@@ -0,0 +1,3 @@
+export interface NestHybridApplicationOptions {
+  inheritAppConfig?: boolean;
+}
--- a/packages/common/interfaces/modules/index.ts
+++ b/packages/common/interfaces/modules/index.ts
@@ -1,5 +1,6 @@
 export * from './dynamic-module.interface';
 export * from './forward-reference.interface';
+export * from './introspection-result.interface';
 export * from './module-metadata.interface';
 export * from './nest-module.interface';
 export * from './provider.interface';
--- a/packages/common/interfaces/modules/introspection-result.interface.ts
+++ b/packages/common/interfaces/modules/introspection-result.interface.ts
@@ -0,0 +1,11 @@
+import { Scope } from '../scope-options.interface';
+
+/**
+ * @publicApi
+ */
+export interface IntrospectionResult {
+  /**
+   * Enum defining lifetime of host class or factory.
+   */
+  scope: Scope;
+}
--- a/packages/common/interfaces/nest-application-context.interface.ts
+++ b/packages/common/interfaces/nest-application-context.interface.ts
@@ -34,6 +34,15 @@ export interface INestApplicationContext {
    options?: { strict: boolean },
  ): Promise<TResult>;

+  /**
+   * Registers the request/context object for a given context ID (DI container sub-tree).
+   * @returns {void}
+   */
+  registerRequestByContextId<T = any>(
+    request: T,
+    contextId: { id: number },
+  ): void;
+
  /**
   * Terminates the application
   * @returns {Promise<void>}
--- a/packages/common/interfaces/nest-application.interface.ts
+++ b/packages/common/interfaces/nest-application.interface.ts
@@ -2,7 +2,12 @@ import { CorsOptions } from './external/cors-options.interface';
 import { CanActivate } from './features/can-activate.interface';
 import { NestInterceptor } from './features/nest-interceptor.interface';
 import { HttpServer } from './http/http-server.interface';
-import { ExceptionFilter, INestMicroservice, PipeTransform } from './index';
+import {
+  ExceptionFilter,
+  INestMicroservice,
+  NestHybridApplicationOptions,
+  PipeTransform,
+} from './index';
 import { INestApplicationContext } from './nest-application-context.interface';
 import { WebSocketAdapter } from './websockets/web-socket-adapter.interface';

@@ -80,9 +85,13 @@ export interface INestApplication extends INestApplicationContext {
   * to a hybrid instance.
   *
   * @param  {T} options Microservice options object
+   * @param  {NestHybridApplicationOptions} hybridOptions Hybrid options object
   * @returns {INestMicroservice}
   */
-  connectMicroservice<T extends object = any>(options: T): INestMicroservice;
+  connectMicroservice<T extends object = any>(
+    options: T,
+    hybridOptions?: NestHybridApplicationOptions,
+  ): INestMicroservice;

  /**
   * Returns array of the microservices connected to the NestApplication.
--- a/packages/common/package.json
+++ b/packages/common/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@nestjs/common",
-  "version": "7.0.5",
+  "version": "7.3.0",
  "description": "Nest - modern, fast, powerful node.js web framework (@common)",
  "author": "Kamil Mysliwiec",
  "homepage": "https://nestjs.com",
@@ -19,8 +19,9 @@
  "dependencies": {
    "axios": "0.19.2",
    "cli-color": "2.0.0",
-    "tslib": "1.11.1",
-    "uuid": "7.0.2"
+    "iterare": "1.2.1",
+    "tslib": "2.0.0",
+    "uuid": "8.2.0"
  },
  "peerDependencies": {
    "reflect-metadata": "^0.1.12",
--- a/packages/common/pipes/default-value.pipe.ts
+++ b/packages/common/pipes/default-value.pipe.ts
@@ -0,0 +1,22 @@
+import { ArgumentMetadata, Injectable, PipeTransform } from '../index';
+import { isNil } from '../utils/shared.utils';
+
+/**
+ * Defines the built-in DefaultValue Pipe
+ *
+ * @see [Built-in Pipes](https://docs.nestjs.com/pipes#built-in-pipes)
+ *
+ * @publicApi
+ */
+@Injectable()
+export class DefaultValuePipe<T = any, R = any>
+  implements PipeTransform<T, T | R> {
+  constructor(private readonly defaultValue: R) {}
+
+  transform(value?: T, _metadata?: ArgumentMetadata): T | R {
+    if (isNil(value)) {
+      return this.defaultValue;
+    }
+    return value;
+  }
+}
--- a/packages/common/pipes/index.ts
+++ b/packages/common/pipes/index.ts
@@ -1,3 +1,4 @@
+export * from './default-value.pipe';
 export * from './parse-array.pipe';
 export * from './parse-bool.pipe';
 export * from './parse-int.pipe';
--- a/packages/common/pipes/validation.pipe.ts
+++ b/packages/common/pipes/validation.pipe.ts
@@ -1,4 +1,4 @@
-import iterate from 'iterare';
+import { iterate } from 'iterare';
 import { Optional } from '../decorators';
 import { Injectable } from '../decorators/core';
 import { HttpStatus } from '../enums/http-status.enum';
@@ -159,7 +159,7 @@ export class ValidationPipe implements PipeTransform<any> {
  private stripProtoKeys(value: Record<string, any>) {
    delete value.__proto__;
    const keys = Object.keys(value);
-    keys
+    iterate(keys)
      .filter(key => typeof value[key] === 'object' && value[key])
      .forEach(key => this.stripProtoKeys(value[key]));
  }
--- a/packages/common/serializer/class-serializer.interceptor.ts
+++ b/packages/common/serializer/class-serializer.interceptor.ts
@@ -1,10 +1,10 @@
 import { Observable } from 'rxjs';
 import { map } from 'rxjs/operators';
-import { Inject, Injectable } from '../decorators/core';
+import { Inject, Injectable, Optional } from '../decorators/core';
+import { CallHandler, ExecutionContext, NestInterceptor } from '../interfaces';
 import { ClassTransformOptions } from '../interfaces/external/class-transform-options.interface';
 import { loadPackage } from '../utils/load-package.util';
 import { isObject } from '../utils/shared.utils';
-import { CallHandler, ExecutionContext, NestInterceptor } from '../interfaces';
 import { CLASS_SERIALIZER_OPTIONS } from './class-serializer.constants';

 let classTransformer: any = {};
@@ -20,7 +20,10 @@ const REFLECTOR = 'Reflector';

@Injectable()
 export class ClassSerializerInterceptor implements NestInterceptor {
-  constructor(@Inject(REFLECTOR) protected readonly reflector: any) {
+  constructor(
+    @Inject(REFLECTOR) protected readonly reflector: any,
+    @Optional() protected readonly defaultOptions: ClassTransformOptions = {},
+  ) {
    classTransformer = loadPackage(
      'class-transformer',
      'ClassSerializerInterceptor',
@@ -30,7 +33,11 @@ export class ClassSerializerInterceptor implements NestInterceptor {
  }

  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
-    const options = this.getContextOptions(context);
+    const contextOptions = this.getContextOptions(context);
+    const options = {
+      ...this.defaultOptions,
+      ...contextOptions,
+    };
    return next
      .handle()
      .pipe(
--- a/packages/common/test/decorators/bind.decorator.spec.ts
+++ b/packages/common/test/decorators/bind.decorator.spec.ts
@@ -1,6 +1,6 @@
 import { expect } from 'chai';
+import { ROUTE_ARGS_METADATA } from '../../constants';
 import { Bind } from '../../decorators/core/bind.decorator';
-import { ROUTE_ARGS_METADATA } from '@nestjs/common/constants';
 import { Req } from '../../decorators/http/route-params.decorator';

 describe('@Bind', () => {
--- a/packages/common/test/decorators/create-param-decorator.spec.ts
+++ b/packages/common/test/decorators/create-param-decorator.spec.ts
@@ -1,7 +1,7 @@
-import { ParseIntPipe } from '@nestjs/common';
-import { ROUTE_ARGS_METADATA } from '@nestjs/common/constants';
 import { expect } from 'chai';
+import { ROUTE_ARGS_METADATA } from '../../constants';
 import { createParamDecorator } from '../../decorators/http/create-route-param-metadata.decorator';
+import { ParseIntPipe } from '../../index';

 describe('createParamDecorator', () => {
  let result;
--- a/packages/common/test/decorators/redirect.decorator.spec.ts
+++ b/packages/common/test/decorators/redirect.decorator.spec.ts
@@ -1,7 +1,7 @@
 import { expect } from 'chai';
-import { Redirect } from '../../decorators/http/redirect.decorator';
 import { REDIRECT_METADATA } from '../../constants';
-import { HttpStatus } from '@nestjs/common';
+import { Redirect } from '../../decorators/http/redirect.decorator';
+import { HttpStatus } from '../../index';

 describe('@Redirect', () => {
  const url = 'http://test.com';
--- a/packages/common/test/decorators/use-guards.decorator.spec.ts
+++ b/packages/common/test/decorators/use-guards.decorator.spec.ts
@@ -8,17 +8,17 @@ class Guard {}
 describe('@UseGuards', () => {
  const guards = [Guard, Guard];

-  @UseGuards(...(guards as any))
+  @UseGuards(...guards)
  class Test {}

  class TestWithMethod {
-    @UseGuards(...(guards as any))
+    @UseGuards(...guards)
    public static test() {}
  }

  class Test2 {
-    @UseGuards(...(guards as any))
-    @UseGuards(...(guards as any))
+    @UseGuards(...guards)
+    @UseGuards(...guards)
    public static test() {}
  }

--- a/packages/common/test/decorators/use-interceptors.decorator.spec.ts
+++ b/packages/common/test/decorators/use-interceptors.decorator.spec.ts
@@ -8,11 +8,11 @@ class Interceptor {}
 describe('@UseInterceptors', () => {
  const interceptors = [Interceptor, Interceptor];

-  @UseInterceptors(...(interceptors as any))
+  @UseInterceptors(...interceptors)
  class Test {}

  class TestWithMethod {
-    @UseInterceptors(...(interceptors as any))
+    @UseInterceptors(...interceptors)
    public static test() {}
  }

--- a/packages/common/test/decorators/use-pipes.decorator.spec.ts
+++ b/packages/common/test/decorators/use-pipes.decorator.spec.ts
@@ -10,11 +10,11 @@ class Pipe {
 describe('@UsePipes', () => {
  const pipes = [new Pipe(), new Pipe()];

-  @UsePipes(...(pipes as any))
+  @UsePipes(...pipes)
  class Test {}

  class TestWithMethod {
-    @UsePipes(...(pipes as any))
+    @UsePipes(...pipes)
    public static test() {}
  }

--- a/packages/common/test/http/http.service.spec.ts
+++ b/packages/common/test/http/http.service.spec.ts
@@ -0,0 +1,18 @@
+import { expect } from 'chai';
+import { HttpService } from '../../http/http.service';
+import { AxiosRequestConfig, AxiosInstance } from 'axios';
+
+describe('HttpService', () => {
+  it('should not mutate user-given axios options object', done => {
+    const http = new HttpService({ get: () => Promise.resolve() } as any);
+    const options: AxiosRequestConfig = {};
+
+    http
+      .get('/', options)
+      .toPromise()
+      .then(() => {
+        expect(options.cancelToken).to.be.undefined;
+        done();
+      });
+  });
+});
--- a/packages/common/test/pipes/default-value.pipe.spec.ts
+++ b/packages/common/test/pipes/default-value.pipe.spec.ts
@@ -0,0 +1,20 @@
+import { expect } from 'chai';
+import { DefaultValuePipe } from '../../pipes/default-value.pipe';
+
+describe('DefaultValuePipe', () => {
+  const defaultValue = 'default';
+  const target = new DefaultValuePipe(defaultValue);
+
+  describe('transform', () => {
+    it('should return original value if one was provided', () => {
+      const value = 'value';
+      const result = target.transform(value);
+      expect(result).to.equal(value);
+    });
+
+    it('should return default value if no value was provided', () => {
+      const result = target.transform(undefined);
+      expect(result).to.equal(defaultValue);
+    });
+  });
+});
--- a/packages/core/Readme.md
+++ b/packages/core/Readme.md
@@ -38,6 +38,14 @@ Nest is a framework for building efficient, scalable <a href="http://nodejs.org"
 * To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
 * 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:

+## Questions
+
+For questions and support please use the official [Discord channel](https://discord.gg/G7Qnnhy). The issue list of this repo is **exclusively** for bug reports and feature requests.
+
+## Issues
+
+Please make sure to read the [Issue Reporting Checklist](https://github.com/nestjs/nest/blob/master/CONTRIBUTING.md#-submitting-an-issue) before opening an issue. Issues not conforming to the guidelines may be closed immediately.
+
 ## Consulting

 With official support, you can get expert help straight from Nest core team. We provide dedicated technical support, migration strategies, advice on best practices (and design decisions), PR reviews, and team augmentation. Read more about [support here](https://enterprise.nestjs.com).
@@ -48,30 +56,35 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors

 #### Principal Sponsor

-<a href="https://valor-software.com/" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="320" /></a>
+<a href="https://valor-software.com/" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="220" /></a>

 #### Silver Sponsors
-<a href="https://neoteric.eu/" target="_blank"><img src="https://nestjs.com/img/neoteric-cut.png" width="120" valign="middle" /></a> &nbsp;
-  <a href="http://gojob.com" target="_blank"><img src="http://nestjs.com/img/gojob-logo.png" valign="middle" height="95" /></a> &nbsp; 
-    <a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="150" valign="middle" /></a> &nbsp;
-<a href="http://www.leogistics.com" target="_blank"><img src="https://nestjs.com/img/leogistics-logo.jpeg" width="150" valign="middle" /></a>
+
+<table style="text-align:center;"><tr><td>
+<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>

 #### Sponsors

-<a href="https://www.swingdev.io" target="_blank"><img src="https://nestjs.com/img/swingdev-logo.svg#1" width="110" valign="middle" /> </a> &nbsp; <a href="https://blueanchor.io/" target="_blank"><img src="https://nestjs.com/img/blueanchor.png" width="150" valign="middle" /></a> &nbsp;
-<a href="https://www.novologic.com/" target="_blank"><img src="https://nestjs.com/img/novologic.png" width="110" valign="middle" /></a> &nbsp; <a href="https://hostpresto.com" target="_blank"><img src="https://nestjs.com/img/hostpresto.png" height="24" valign="middle" /></a>
-<a href="https://ever.co/" target="_blank"><img src="https://nestjs.com/img/ever-logo.png" height="14" valign="middle" /></a>  &nbsp; 
-<a href="https://buddy.works/" target="_blank"><img src="https://nestjs.com/img/buddy-logo.svg" height="25" valign="middle" /></a> &nbsp;
-<a href="https://blokt.com" target="_blank"><img src="https://nestjs.com/img/blokt-logo.png" height="25" valign="middle" /></a>  &nbsp;  <a href="https://genuinebee.com/" target="_blank"><img src="https://nestjs.com/img/genuinebee.svg" height="27" valign="middle" /></a> &nbsp; <a href="http://architectnow.net/" target="_blank"><img src="https://nestjs.com/img/architectnow.png" height="20" valign="middle" /></a> &nbsp; <a href="https://quander.io/" target="_blank"><img src="https://nestjs.com/img/quander.png" height="22" valign="middle" /></a> &nbsp; <a href="https://mantro.net/" target="_blank"><img src="https://nestjs.com/img/mantro-logo.svg" height="19" valign="middle" /></a> &nbsp; <a href="https://triplebyte.com/" target="_blank"><img src="https://nestjs.com/img/triplebyte.png" height="20" valign="middle" /></a> &nbsp; 
-<a href="https://reposit.co.uk/" target="_blank"><img src="https://nestjs.com/img/reposit-logo.png" height="18" valign="middle" /></a> &nbsp; &nbsp;
-<a href="https://nearpod.com/" target="_blank"><img src="https://nestjs.com/img/nearpod-logo.svg" width="100" valign="middle" /></a> &nbsp;
-<a href="https://clay.global/" target="_blank"><img src="https://nestjs.com/img/clay-logo.svg" width="75" valign="middle" /></a> &nbsp;
-<a href="https://firesticktricks.com" target="_blank"><img src="https://nestjs.com/img/firesticktricks-logo.png" width="120" valign="middle" /></a> &nbsp;
-<a href="https://www.codeguesser.co.uk" target="_blank"><img src="https://nestjs.com/img/codeguesser-logo.svg" width="120" valign="middle" /></a> &nbsp;
-<a href="https://tekhattan.com" target="_blank"><img src="https://nestjs.com/img/tekhattan-logo.png" width="110" valign="middle" /></a> &nbsp;
-<a href="https://f-a.nz/" target="_blank"><img src="https://nestjs.com/img/franz.svg" width="80" valign="middle" /></a> &nbsp;
-<a href="https://sparkfabrik.com/" target="_blank"><img src="https://nestjs.com/img/sparkfabrik-logo.png" width="120" valign="middle" /></a>
-
+<table><tr><td align="center" valign="middle">
+<a href="https://www.swingdev.io" target="_blank"><img src="https://nestjs.com/img/swingdev-logo.svg#1" width="110" valign="middle" /> </a></td><td align="center" valign="middle">
+<a href="https://www.novologic.com/" target="_blank"><img src="https://nestjs.com/img/novologic.png" width="110" valign="middle" /></a> </td><td align="center" valign="middle">
+<a href="https://ever.co/" target="_blank"><img src="https://nestjs.com/img/ever-logo.png" width="72" valign="middle" /></a>  </td><td align="center" valign="middle">
+<a href="https://blokt.com" target="_blank"><img src="https://nestjs.com/img/blokt-logo.png" width="120" valign="middle" /></a>  </td><td align="center" valign="middle"> 
+  <a href="http://architectnow.net/" target="_blank"><img src="https://nestjs.com/img/architectnow.png" width="125" valign="middle" /></a> </td><td align="center" valign="middle">
+  <a href="https://quander.io/" target="_blank"><img src="https://nestjs.com/img/quander.png" width="100" valign="middle" /></a> </td></tr><tr><td align="center" valign="middle">
+  <a href="https://mantro.net/" target="_blank"><img src="https://nestjs.com/img/mantro-logo.svg" width="95" valign="middle" /></a> </td><td align="center" valign="middle">
+  <a href="https://triplebyte.com/" target="_blank"><img src="https://nestjs.com/img/triplebyte.png" width="107" valign="middle" /></a> </td><td align="center" valign="middle">
+<a href="https://reposit.co.uk/" target="_blank"><img src="https://nestjs.com/img/reposit-logo.png" width="71" valign="middle" /></a></td><td align="center" valign="middle">
+<a href="https://nearpod.com/" target="_blank"><img src="https://nestjs.com/img/nearpod-logo.svg" width="100" valign="middle" /></a> </td><td align="center" valign="middle">
+<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></tr></table>

 ## Backers

--- a/packages/core/errors/exceptions/invalid-module.exception.ts
+++ b/packages/core/errors/exceptions/invalid-module.exception.ts
@@ -2,8 +2,7 @@ import { INVALID_MODULE_MESSAGE } from '../messages';
 import { RuntimeException } from './runtime.exception';

 export class InvalidModuleException extends RuntimeException {
-  constructor(trace: any[]) {
-    const scope = (trace || []).map(module => module.name).join(' -> ');
-    super(INVALID_MODULE_MESSAGE`${scope}`);
+  constructor(parentModule: any, index: number, scope: any[]) {
+    super(INVALID_MODULE_MESSAGE(parentModule, index, scope));
  }
 }
--- a/packages/core/errors/exceptions/undefined-forwardref.exception.ts
+++ b/packages/core/errors/exceptions/undefined-forwardref.exception.ts
@@ -0,0 +1,9 @@
+import { UNDEFINED_FORWARDREF_MESSAGE } from '../messages';
+import { RuntimeException } from './runtime.exception';
+import { Type } from '@nestjs/common';
+
+export class UndefinedForwardRefException extends RuntimeException {
+  constructor(scope: Type<any>[]) {
+    super(UNDEFINED_FORWARDREF_MESSAGE(scope));
+  }
+}
--- a/packages/core/errors/exceptions/undefined-module.exception.ts
+++ b/packages/core/errors/exceptions/undefined-module.exception.ts
@@ -0,0 +1,8 @@
+import { RuntimeException } from './runtime.exception';
+import { UNDEFINED_MODULE_MESSAGE } from '../messages';
+
+export class UndefinedModuleException extends RuntimeException {
+  constructor(parentModule: any, index: number, scope: any[]) {
+    super(UNDEFINED_MODULE_MESSAGE(parentModule, index, scope));
+  }
+}
--- a/packages/core/errors/exceptions/unknown-element.exception.ts
+++ b/packages/core/errors/exceptions/unknown-element.exception.ts
@@ -1,7 +1,8 @@
 import { RuntimeException } from './runtime.exception';

 export class UnknownElementException extends RuntimeException {
-  constructor(name?: string) {
+  constructor(name?: string | symbol) {
+    name = name && name.toString();
    super(
      `Nest could not find ${
        name || 'given'
--- a/packages/core/errors/exceptions/unknown-export.exception.ts
+++ b/packages/core/errors/exceptions/unknown-export.exception.ts
@@ -2,7 +2,7 @@ import { UNKNOWN_EXPORT_MESSAGE } from '../messages';
 import { RuntimeException } from './runtime.exception';

 export class UnknownExportException extends RuntimeException {
-  constructor(token: string, module: string) {
-    super(UNKNOWN_EXPORT_MESSAGE(token, module));
+  constructor(token: string | symbol, moduleName: string) {
+    super(UNKNOWN_EXPORT_MESSAGE(token, moduleName));
  }
 }
--- a/packages/core/errors/messages.ts
+++ b/packages/core/errors/messages.ts
@@ -37,6 +37,9 @@ const getDependencyName = (dependency: InjectorDependency): string =>
 const getModuleName = (module: Module) =>
  (module && getInstanceName(module.metatype)) || 'current';

+const stringifyScope = (scope: any[]): string =>
+  (scope || []).map(getInstanceName).join(' -> ');
+
 export const UNKNOWN_DEPENDENCIES_MESSAGE = (
  type: string | symbol,
  unknownDependencyContext: InjectorDependencyContext,
@@ -84,17 +87,50 @@ export const INVALID_MIDDLEWARE_MESSAGE = (
  name: string,
 ) => `The middleware doesn't provide the 'use' method (${name})`;

-export const INVALID_MODULE_MESSAGE = (
-  text: TemplateStringsArray,
-  scope: string,
-) =>
-  `Nest cannot create the module instance. Often, this is because of a circular dependency between modules. Use forwardRef() to avoid it.
+export const UNDEFINED_FORWARDREF_MESSAGE = (
+  scope: Type<any>[],
+) => `Nest cannot create the module instance. Often, this is because of a circular dependency between modules. Use forwardRef() to avoid it.

 (Read more: https://docs.nestjs.com/fundamentals/circular-dependency)
-Scope [${scope}]
-`;
+Scope [${stringifyScope(scope)}]
+  `;
+
+export const INVALID_MODULE_MESSAGE = (
+  parentModule: any,
+  index: number,
+  scope: any[],
+) => {
+  const parentModuleName = parentModule?.name || 'module';
+
+  return `Nest cannot create the ${parentModuleName} instance.
+Received an unexpected value at index [${index}] of the ${parentModuleName} "imports" array. 
+
+Scope [${stringifyScope(scope)}]`;
+};
+
+export const UNDEFINED_MODULE_MESSAGE = (
+  parentModule: any,
+  index: number,
+  scope: any[],
+) => {
+  const parentModuleName = parentModule?.name || 'module';
+
+  return `Nest cannot create the ${parentModuleName} instance.
+The module at index [${index}] of the ${parentModuleName} "imports" array is undefined.
+
+Potential causes:
+- A circular dependency between modules. Use forwardRef() to avoid it. Read more: https://docs.nestjs.com/fundamentals/circular-dependency
+- The module at index [${index}] is of type "undefined". Check your import statements and the type of the module.
+
+Scope [${stringifyScope(scope)}]`;
+};
+
+export const UNKNOWN_EXPORT_MESSAGE = (
+  token: string | symbol = 'item',
+  module: string,
+) => {
+  token = isSymbol(token) ? token.toString() : token;

-export const UNKNOWN_EXPORT_MESSAGE = (token = 'item', module: string) => {
  return `Nest cannot export a provider/module that is not a part of the currently processed module (${module}). Please verify whether the exported ${token} is available in this particular context.

 Possible Solutions:
--- a/packages/core/exceptions/base-exception-filter-context.ts
+++ b/packages/core/exceptions/base-exception-filter-context.ts
@@ -2,7 +2,7 @@ import { FILTER_CATCH_EXCEPTIONS } from '@nestjs/common/constants';
 import { Type } from '@nestjs/common/interfaces';
 import { ExceptionFilter } from '@nestjs/common/interfaces/exceptions/exception-filter.interface';
 import { isEmpty, isFunction } from '@nestjs/common/utils/shared.utils';
-import iterate from 'iterare';
+import { iterate } from 'iterare';
 import { ContextCreator } from '../helpers/context-creator';
 import { STATIC_CONTEXT } from '../injector/constants';
 import { NestContainer } from '../injector/container';
--- a/packages/core/exceptions/exceptions-handler.ts
+++ b/packages/core/exceptions/exceptions-handler.ts
@@ -1,4 +1,4 @@
-import { HttpException } from '@nestjs/common';
+import { HttpException, Type } from '@nestjs/common';
 import { ExceptionFilterMetadata } from '@nestjs/common/interfaces/exceptions/exception-filter-metadata.interface';
 import { ArgumentsHost } from '@nestjs/common/interfaces/features/arguments-host.interface';
 import { isEmpty } from '@nestjs/common/utils/shared.utils';
@@ -26,14 +26,15 @@ export class ExceptionsHandler extends BaseExceptionFilter {
    exception: T,
    ctx: ArgumentsHost,
  ): boolean {
-    if (isEmpty(this.filters)) return false;
+    if (isEmpty(this.filters)) {
+      return false;
+    }
+    const isInstanceOf = (metatype: Type<unknown>) =>
+      exception instanceof metatype;

    const filter = this.filters.find(({ exceptionMetatypes }) => {
      const typeExists =
-        !exceptionMetatypes.length ||
-        exceptionMetatypes.some(
-          ExceptionMetatype => exception instanceof ExceptionMetatype,
-        );
+        !exceptionMetatypes.length || exceptionMetatypes.some(isInstanceOf);
      return typeExists;
    });
    filter && filter.func(exception, ctx);
--- a/packages/core/exceptions/external-exception-filter-context.ts
+++ b/packages/core/exceptions/external-exception-filter-context.ts
@@ -9,6 +9,7 @@ import { InstanceWrapper } from '../injector/instance-wrapper';
 import { RouterProxyCallback } from '../router/router-proxy';
 import { BaseExceptionFilterContext } from './base-exception-filter-context';
 import { ExternalExceptionsHandler } from './external-exceptions-handler';
+import { iterate } from 'iterare';

 export class ExternalExceptionFilterContext extends BaseExceptionFilterContext {
  constructor(
@@ -54,10 +55,11 @@ export class ExternalExceptionFilterContext extends BaseExceptionFilterContext {
      return globalFilters;
    }
    const scopedFilterWrappers = this.config.getGlobalRequestFilters() as InstanceWrapper[];
-    const scopedFilters = scopedFilterWrappers
+    const scopedFilters = iterate(scopedFilterWrappers)
      .map(wrapper => wrapper.getInstanceByContextId(contextId, inquirerId))
-      .filter(host => host)
-      .map(host => host.instance);
+      .filter(host => !!host)
+      .map(host => host.instance)
+      .toArray();

    return globalFilters.concat(scopedFilters) as T;
  }
--- a/packages/core/exceptions/external-exceptions-handler.ts
+++ b/packages/core/exceptions/external-exceptions-handler.ts
@@ -1,3 +1,4 @@
+import { Type } from '@nestjs/common';
 import { ExceptionFilterMetadata } from '@nestjs/common/interfaces/exceptions';
 import { ArgumentsHost } from '@nestjs/common/interfaces/features/arguments-host.interface';
 import { isEmpty } from '@nestjs/common/utils/shared.utils';
@@ -29,11 +30,13 @@ export class ExternalExceptionsHandler extends ExternalExceptionFilter {
    if (isEmpty(this.filters)) {
      return null;
    }
-    const isInstanceOf = metatype => exception instanceof metatype;
-    const filter = this.filters.find(({ exceptionMetatypes, func }) => {
-      const hasMetatype =
+    const isInstanceOf = (metatype: Type<unknown>) =>
+      exception instanceof metatype;
+
+    const filter = this.filters.find(({ exceptionMetatypes }) => {
+      const typeExists =
        !exceptionMetatypes.length || exceptionMetatypes.some(isInstanceOf);
-      return hasMetatype;
+      return typeExists;
    });
    return filter ? filter.func(exception, host) : null;
  }
--- a/packages/core/guards/guards-context-creator.ts
+++ b/packages/core/guards/guards-context-creator.ts
@@ -2,7 +2,7 @@ import { CanActivate } from '@nestjs/common';
 import { GUARDS_METADATA } from '@nestjs/common/constants';
 import { Controller } from '@nestjs/common/interfaces';
 import { isEmpty, isFunction } from '@nestjs/common/utils/shared.utils';
-import iterate from 'iterare';
+import { iterate } from 'iterare';
 import { ApplicationConfig } from '../application-config';
 import { ContextCreator } from '../helpers/context-creator';
 import { STATIC_CONTEXT } from '../injector/constants';
@@ -100,10 +100,11 @@ export class GuardsContextCreator extends ContextCreator {
      return globalGuards;
    }
    const scopedGuardWrappers = this.config.getGlobalRequestGuards() as InstanceWrapper[];
-    const scopedGuards = scopedGuardWrappers
+    const scopedGuards = iterate(scopedGuardWrappers)
      .map(wrapper => wrapper.getInstanceByContextId(contextId, inquirerId))
-      .filter(host => host)
-      .map(host => host.instance);
+      .filter(host => !!host)
+      .map(host => host.instance)
+      .toArray();

    return globalGuards.concat(scopedGuards) as T;
  }
--- a/packages/core/hooks/before-app-shutdown.hook.ts
+++ b/packages/core/hooks/before-app-shutdown.hook.ts
@@ -1,12 +1,12 @@
 import { BeforeApplicationShutdown } from '@nestjs/common';
 import { isNil } from '@nestjs/common/utils/shared.utils';
-import iterate from 'iterare';
-import { InstanceWrapper } from '../injector/instance-wrapper';
-import { Module } from '../injector/module';
+import { iterate } from 'iterare';
 import {
  getNonTransientInstances,
  getTransientInstances,
-} from '../injector/transient-instances';
+} from '../injector/helpers/transient-instances';
+import { InstanceWrapper } from '../injector/instance-wrapper';
+import { Module } from '../injector/module';

 /**
 * Checks if the given instance has the `beforeApplicationShutdown` function
--- a/packages/core/hooks/on-app-bootstrap.hook.ts
+++ b/packages/core/hooks/on-app-bootstrap.hook.ts
@@ -1,12 +1,12 @@
 import { OnApplicationBootstrap } from '@nestjs/common';
 import { isNil } from '@nestjs/common/utils/shared.utils';
-import iterate from 'iterare';
-import { InstanceWrapper } from '../injector/instance-wrapper';
-import { Module } from '../injector/module';
+import { iterate } from 'iterare';
 import {
  getNonTransientInstances,
  getTransientInstances,
-} from '../injector/transient-instances';
+} from '../injector/helpers/transient-instances';
+import { InstanceWrapper } from '../injector/instance-wrapper';
+import { Module } from '../injector/module';

 /**
 * Checks if the given instance has the `onApplicationBootstrap` function
--- a/packages/core/hooks/on-app-shutdown.hook.ts
+++ b/packages/core/hooks/on-app-shutdown.hook.ts
@@ -1,12 +1,12 @@
 import { OnApplicationShutdown } from '@nestjs/common';
 import { isNil } from '@nestjs/common/utils/shared.utils';
-import iterate from 'iterare';
-import { InstanceWrapper } from '../injector/instance-wrapper';
-import { Module } from '../injector/module';
+import { iterate } from 'iterare';
 import {
  getNonTransientInstances,
  getTransientInstances,
-} from '../injector/transient-instances';
+} from '../injector/helpers/transient-instances';
+import { InstanceWrapper } from '../injector/instance-wrapper';
+import { Module } from '../injector/module';

 /**
 * Checks if the given instance has the `onApplicationShutdown` function
--- a/packages/core/hooks/on-module-destroy.hook.ts
+++ b/packages/core/hooks/on-module-destroy.hook.ts
@@ -1,12 +1,12 @@
 import { OnModuleDestroy } from '@nestjs/common';
 import { isNil } from '@nestjs/common/utils/shared.utils';
-import iterate from 'iterare';
-import { InstanceWrapper } from '../injector/instance-wrapper';
-import { Module } from '../injector/module';
+import { iterate } from 'iterare';
 import {
  getNonTransientInstances,
  getTransientInstances,
-} from '../injector/transient-instances';
+} from '../injector/helpers/transient-instances';
+import { InstanceWrapper } from '../injector/instance-wrapper';
+import { Module } from '../injector/module';

 /**
 * Returns true or false if the given instance has a `onModuleDestroy` function
--- a/packages/core/hooks/on-module-init.hook.ts
+++ b/packages/core/hooks/on-module-init.hook.ts
@@ -1,12 +1,12 @@
 import { OnModuleInit } from '@nestjs/common';
 import { isNil } from '@nestjs/common/utils/shared.utils';
-import iterate from 'iterare';
-import { InstanceWrapper } from '../injector/instance-wrapper';
-import { Module } from '../injector/module';
+import { iterate } from 'iterare';
 import {
  getNonTransientInstances,
  getTransientInstances,
-} from '../injector/transient-instances';
+} from '../injector/helpers/transient-instances';
+import { InstanceWrapper } from '../injector/instance-wrapper';
+import { Module } from '../injector/module';

 /**
 * Returns true or false if the given instance has a `onModuleInit` function
--- a/packages/core/injector/container-scanner.ts
+++ b/packages/core/injector/container-scanner.ts
@@ -1,118 +0,0 @@
-import { Type } from '@nestjs/common';
-import { Abstract, Scope } from '@nestjs/common/interfaces';
-import { isFunction } from '@nestjs/common/utils/shared.utils';
-import { InvalidClassScopeException } from '../errors/exceptions/invalid-class-scope.exception';
-import { UnknownElementException } from '../errors/exceptions/unknown-element.exception';
-import { NestContainer } from './container';
-import { InstanceWrapper } from './instance-wrapper';
-import { Module } from './module';
-
-type HostCollection = 'providers' | 'controllers' | 'injectables';
-
-export class ContainerScanner {
-  private flatContainer: Partial<Module>;
-
-  constructor(private readonly container: NestContainer) {}
-
-  public find<TInput = any, TResult = TInput>(
-    typeOrToken: Type<TInput> | Abstract<TInput> | string | symbol,
-  ): TResult {
-    this.initFlatContainer();
-    return this.findInstanceByToken<TInput, TResult>(
-      typeOrToken,
-      this.flatContainer,
-    );
-  }
-
-  public getWrapperCollectionPair<TInput = any, TResult = TInput>(
-    typeOrToken: Type<TInput> | Abstract<TInput> | string | symbol,
-  ): [InstanceWrapper<TResult>, Map<string, InstanceWrapper>] {
-    this.initFlatContainer();
-    return this.getWrapperCollectionPairByHost<TInput, TResult>(
-      typeOrToken,
-      this.flatContainer,
-    );
-  }
-
-  public findInstanceByToken<TInput = any, TResult = TInput>(
-    metatypeOrToken: Type<TInput> | Abstract<TInput> | string | symbol,
-    contextModule: Partial<Module>,
-  ): TResult {
-    const [instanceWrapper] = this.getWrapperCollectionPairByHost(
-      metatypeOrToken,
-      contextModule,
-    );
-    if (
-      instanceWrapper.scope === Scope.REQUEST ||
-      instanceWrapper.scope === Scope.TRANSIENT
-    ) {
-      throw new InvalidClassScopeException(metatypeOrToken);
-    }
-    return (instanceWrapper.instance as unknown) as TResult;
-  }
-
-  public getWrapperCollectionPairByHost<TInput = any, TResult = TInput>(
-    metatypeOrToken: Type<TInput> | Abstract<TInput> | string | symbol,
-    contextModule: Partial<Module>,
-  ): [InstanceWrapper<TResult>, Map<string, InstanceWrapper>] {
-    const name = isFunction(metatypeOrToken)
-      ? (metatypeOrToken as Function).name
-      : metatypeOrToken;
-    const collectionName = this.getHostCollection(
-      name as string,
-      contextModule,
-    );
-    const instanceWrapper = contextModule[collectionName].get(name as string);
-    if (!instanceWrapper) {
-      throw new UnknownElementException(name && name.toString());
-    }
-    return [
-      instanceWrapper as InstanceWrapper<TResult>,
-      contextModule[collectionName],
-    ];
-  }
-
-  private initFlatContainer() {
-    if (this.flatContainer) {
-      return;
-    }
-    const modules = this.container.getModules();
-    const initialValue: Record<string, any[]> = {
-      providers: [],
-      controllers: [],
-      injectables: [],
-    };
-    const merge = <T = unknown>(
-      initial: Map<string, T> | T[],
-      arr: Map<string, T>,
-    ) => [...initial, ...arr];
-
-    const partialModule = ([...modules.values()].reduce(
-      (current, next) => ({
-        providers: merge(current.providers, next.providers),
-        controllers: merge(current.controllers, next.controllers),
-        injectables: merge(current.injectables, next.injectables),
-      }),
-      initialValue,
-    ) as any) as Partial<Module>;
-
-    this.flatContainer = {
-      providers: new Map(partialModule.providers),
-      controllers: new Map(partialModule.controllers),
-      injectables: new Map(partialModule.injectables),
-    };
-  }
-
-  private getHostCollection(
-    token: string,
-    { providers, controllers }: Partial<Module>,
-  ): HostCollection {
-    if (providers.has(token)) {
-      return 'providers';
-    }
-    if (controllers.has(token)) {
-      return 'controllers';
-    }
-    return 'injectables';
-  }
-}
--- a/packages/core/injector/container.ts
+++ b/packages/core/injector/container.ts
@@ -4,7 +4,7 @@ import { Injectable } from '@nestjs/common/interfaces/injectable.interface';
 import { Type } from '@nestjs/common/interfaces/type.interface';
 import { ApplicationConfig } from '../application-config';
 import { CircularDependencyException } from '../errors/exceptions/circular-dependency.exception';
-import { InvalidModuleException } from '../errors/exceptions/invalid-module.exception';
+import { UndefinedForwardRefException } from '../errors/exceptions/undefined-forwardref.exception';
 import { UnknownModuleException } from '../errors/exceptions/unknown-module.exception';
 import { ExternalContextCreator } from '../helpers/external-context-creator';
 import { HttpAdapterHost } from '../helpers/http-adapter-host';
@@ -55,8 +55,10 @@ export class NestContainer {
    metatype: Type<any> | DynamicModule | Promise<DynamicModule>,
    scope: Type<any>[],
  ): Promise<Module> {
+    // In DependenciesScanner#scanForModules we already check for undefined or invalid modules
+    // We sill need to catch the edge-case of `forwardRef(() => undefined)`
    if (!metatype) {
-      throw new InvalidModuleException(scope);
+      throw new UndefinedForwardRefException(scope);
    }
    const { type, dynamicMetadata, token } = await this.moduleCompiler.compile(
      metatype,
@@ -64,7 +66,7 @@ export class NestContainer {
    if (this.modules.has(token)) {
      return;
    }
-    const moduleRef = new Module(type, scope, this);
+    const moduleRef = new Module(type, this);
    this.modules.set(token, moduleRef);
    this.addDynamicMetadata(token, dynamicMetadata, [].concat(scope, type));

@@ -180,11 +182,11 @@ export class NestContainer {
  }

  public replace(toReplace: any, options: any & { scope: any[] | null }) {
-    this.modules.forEach(module => module.replace(toReplace, options));
+    this.modules.forEach(moduleRef => moduleRef.replace(toReplace, options));
  }

  public bindGlobalScope() {
-    this.modules.forEach(module => this.bindGlobalsToImports(module));
+    this.modules.forEach(moduleRef => this.bindGlobalsToImports(moduleRef));
  }

  public bindGlobalsToImports(moduleRef: Module) {
--- a/packages/core/injector/helpers/transient-instances.ts
+++ b/packages/core/injector/helpers/transient-instances.ts
@@ -1,6 +1,5 @@
-import iterate from 'iterare';
-
-import { InstanceWrapper } from './instance-wrapper';
+import { iterate } from 'iterare';
+import { InstanceWrapper } from '../instance-wrapper';

 /**
 * Returns the instances which are transient
--- a/packages/core/injector/injector.ts
+++ b/packages/core/injector/injector.ts
@@ -15,6 +15,7 @@ import {
  isString,
  isUndefined,
 } from '@nestjs/common/utils/shared.utils';
+import { iterate } from 'iterare';
 import { RuntimeException } from '../errors/exceptions/runtime.exception';
 import { UndefinedDependencyException } from '../errors/exceptions/undefined-dependency.exception';
 import { UnknownDependenciesException } from '../errors/exceptions/unknown-dependencies.exception';
@@ -612,7 +613,7 @@ export class Injector {
    if (!isObject(instance)) {
      return undefined;
    }
-    properties
+    iterate(properties)
      .filter(item => !isNil(item.instance))
      .forEach(item => (instance[item.key] = item.instance));
  }
@@ -665,8 +666,11 @@ export class Injector {
    wrapper?: InstanceWrapper,
  ): Promise<T> {
    if (!wrapper) {
-      const ctor = instance.constructor;
-      wrapper = collection.get(ctor && ctor.name);
+      const providerCtor = instance.constructor;
+      const injectionToken =
+        (providerCtor && providerCtor.name) ||
+        ((providerCtor as unknown) as string);
+      wrapper = collection.get(injectionToken);
    }
    await this.loadInstance(wrapper, collection, moduleRef, ctx, wrapper);
    await this.loadEnhancersPerContext(wrapper, ctx, wrapper);
--- a/packages/core/injector/instance-links-host.ts
+++ b/packages/core/injector/instance-links-host.ts
@@ -0,0 +1,79 @@
+import { Abstract, Type } from '@nestjs/common';
+import { isFunction } from '@nestjs/common/utils/shared.utils';
+import { UnknownElementException } from '../errors/exceptions/unknown-element.exception';
+import { NestContainer } from './container';
+import { InstanceWrapper } from './instance-wrapper';
+import { Module } from './module';
+
+type InstanceToken = string | symbol | Type<any> | Abstract<any> | Function;
+type HostCollection = 'providers' | 'controllers' | 'injectables';
+
+export interface InstanceLink<T = any> {
+  token: InstanceToken;
+  wrapperRef: InstanceWrapper<T>;
+  collection: Map<any, InstanceWrapper>;
+  moduleId: string;
+}
+
+export class InstanceLinksHost {
+  private readonly instanceLinks = new Map<InstanceToken, InstanceLink[]>();
+
+  constructor(private readonly container: NestContainer) {
+    this.initialize();
+  }
+
+  get<T = any>(token: InstanceToken, moduleId?: string): InstanceLink<T> {
+    const name = isFunction(token)
+      ? (token as Function).name
+      : (token as string | symbol);
+    const modulesMap = this.instanceLinks.get(name);
+
+    if (!modulesMap) {
+      throw new UnknownElementException(name);
+    }
+    const instanceLink = moduleId
+      ? modulesMap.find(item => item.moduleId === moduleId)
+      : modulesMap[0];
+
+    if (!instanceLink) {
+      throw new UnknownElementException(name);
+    }
+    return instanceLink;
+  }
+
+  private initialize() {
+    const modules = this.container.getModules();
+    modules.forEach(moduleRef => {
+      const { providers, injectables, controllers } = moduleRef;
+      providers.forEach((wrapper, token) =>
+        this.addLink(wrapper, token, moduleRef, 'providers'),
+      );
+      injectables.forEach((wrapper, token) =>
+        this.addLink(wrapper, token, moduleRef, 'injectables'),
+      );
+      controllers.forEach((wrapper, token) =>
+        this.addLink(wrapper, token, moduleRef, 'controllers'),
+      );
+    });
+  }
+
+  private addLink(
+    wrapper: InstanceWrapper,
+    token: InstanceToken,
+    moduleRef: Module,
+    collectionName: HostCollection,
+  ) {
+    const instanceLink: InstanceLink = {
+      moduleId: moduleRef.id,
+      wrapperRef: wrapper,
+      collection: moduleRef[collectionName],
+      token,
+    };
+    const existingLinks = this.instanceLinks.get(token);
+    if (!existingLinks) {
+      this.instanceLinks.set(token, [instanceLink]);
+    } else {
+      existingLinks.push(instanceLink);
+    }
+  }
+}
--- a/packages/core/injector/instance-wrapper.ts
+++ b/packages/core/injector/instance-wrapper.ts
@@ -6,6 +6,7 @@ import {
 } from '@nestjs/common/interfaces';
 import { randomStringGenerator } from '@nestjs/common/utils/random-string-generator.util';
 import { isNil, isUndefined } from '@nestjs/common/utils/shared.utils';
+import { iterate } from 'iterare';
 import { STATIC_CONTEXT } from './constants';
 import { Module } from './module';

@@ -37,9 +38,9 @@ export class InstanceWrapper<T = any> {
  public readonly name: any;
  public readonly async?: boolean;
  public readonly host?: Module;
-  public readonly scope?: Scope = Scope.DEFAULT;
  public readonly isAlias: boolean = false;

+  public scope?: Scope = Scope.DEFAULT;
  public metatype: Type<T> | Function;
  public inject?: (string | symbol | Function | Type<any>)[];
  public forwardRef?: boolean;
@@ -255,9 +256,11 @@ export class InstanceWrapper<T = any> {
  ): boolean {
    const isDependencyTreeStatic = this.isDependencyTreeStatic();

-    return ((!isDependencyTreeStatic &&
+    return (
+      !isDependencyTreeStatic &&
      contextId !== STATIC_CONTEXT &&
-      (!this.isTransient || (this.isTransient && inquirer))) as any) as boolean;
+      (!this.isTransient || (this.isTransient && !!inquirer))
+    );
  }

  public isLazyTransient(
@@ -279,10 +282,11 @@ export class InstanceWrapper<T = any> {
    contextId: ContextId,
    inquirer?: InstanceWrapper,
  ): boolean {
+    const isSelfRequested = inquirer === this;
    return (
      this.isDependencyTreeStatic() &&
      contextId !== STATIC_CONTEXT &&
-      inquirer === this
+      (isSelfRequested || (inquirer && inquirer.scope === Scope.TRANSIENT))
    );
  }

@@ -297,7 +301,8 @@ export class InstanceWrapper<T = any> {
    return (
      this.isDependencyTreeStatic() &&
      contextId === STATIC_CONTEXT &&
-      (!this.isTransient || (isStaticTransient && !!inquirer))
+      (!this.isTransient ||
+        (isStaticTransient && !!inquirer && !inquirer.isTransient))
    );
  }

@@ -306,15 +311,17 @@ export class InstanceWrapper<T = any> {
      return [];
    }
    const instances = [...this.transientMap.values()];
-    return instances
+    return iterate(instances)
      .map(item => item.get(STATIC_CONTEXT))
-      .filter(item => !!item);
+      .filter(item => !!item)
+      .toArray();
  }

  public mergeWith(provider: Provider) {
    if ((provider as ValueProvider).useValue) {
      this.metatype = null;
      this.inject = null;
+      this.scope = Scope.DEFAULT;

      this.setInstanceByContextId(STATIC_CONTEXT, {
        instance: (provider as ValueProvider).useValue,
--- a/packages/core/injector/module-ref.ts
+++ b/packages/core/injector/module-ref.ts
@@ -1,19 +1,26 @@
-import { Type } from '@nestjs/common';
+import { IntrospectionResult, Scope, Type } from '@nestjs/common';
+import { InvalidClassScopeException } from '../errors/exceptions/invalid-class-scope.exception';
 import { UnknownElementException } from '../errors/exceptions/unknown-element.exception';
+import { getClassScope } from '../helpers/get-class-scope';
 import { NestContainer } from './container';
-import { ContainerScanner } from './container-scanner';
 import { Injector } from './injector';
+import { InstanceLinksHost } from './instance-links-host';
 import { ContextId, InstanceWrapper } from './instance-wrapper';
 import { Module } from './module';

 export abstract class ModuleRef {
  private readonly injector = new Injector();
-  private readonly containerScanner: ContainerScanner;
+  private _instanceLinksHost: InstanceLinksHost;

-  constructor(protected readonly container: NestContainer) {
-    this.containerScanner = new ContainerScanner(container);
+  private get instanceLinksHost() {
+    if (!this._instanceLinksHost) {
+      this._instanceLinksHost = new InstanceLinksHost(this.container);
+    }
+    return this._instanceLinksHost;
  }

+  constructor(protected readonly container: NestContainer) {}
+
  public abstract get<TInput = any, TResult = TInput>(
    typeOrToken: Type<TInput> | string | symbol,
    options?: { strict: boolean },
@@ -25,10 +32,70 @@ export abstract class ModuleRef {
  ): Promise<TResult>;
  public abstract create<T = any>(type: Type<T>): Promise<T>;

+  public introspect<T = any>(
+    token: Type<T> | string | symbol,
+  ): IntrospectionResult {
+    const { wrapperRef } = this.instanceLinksHost.get(token);
+
+    let scope = Scope.DEFAULT;
+    if (!wrapperRef.isDependencyTreeStatic()) {
+      scope = Scope.REQUEST;
+    } else if (wrapperRef.isTransient) {
+      scope = Scope.TRANSIENT;
+    }
+    return { scope };
+  }
+
+  public registerRequestByContextId<T = any>(request: T, contextId: ContextId) {
+    this.container.registerRequestProvider(request, contextId);
+  }
+
  protected find<TInput = any, TResult = TInput>(
    typeOrToken: Type<TInput> | string | symbol,
+    contextModule?: Module,
  ): TResult {
-    return this.containerScanner.find<TInput, TResult>(typeOrToken);
+    const moduleId = contextModule && contextModule.id;
+    const { wrapperRef } = this.instanceLinksHost.get<TResult>(
+      typeOrToken,
+      moduleId,
+    );
+    if (
+      wrapperRef.scope === Scope.REQUEST ||
+      wrapperRef.scope === Scope.TRANSIENT
+    ) {
+      throw new InvalidClassScopeException(typeOrToken);
+    }
+    return wrapperRef.instance;
+  }
+
+  protected async resolvePerContext<TInput = any, TResult = TInput>(
+    typeOrToken: Type<TInput> | string | symbol,
+    contextModule: Module,
+    contextId: ContextId,
+    options?: { strict: boolean },
+  ): Promise<TResult> {
+    const isStrictModeEnabled = options && options.strict;
+    const instanceLink = isStrictModeEnabled
+      ? this.instanceLinksHost.get(typeOrToken, contextModule.id)
+      : this.instanceLinksHost.get(typeOrToken);
+
+    const { wrapperRef, collection } = instanceLink;
+    if (wrapperRef.isDependencyTreeStatic() && !wrapperRef.isTransient) {
+      return this.get(typeOrToken);
+    }
+
+    const ctorHost = wrapperRef.instance || { constructor: typeOrToken };
+    const instance = await this.injector.loadPerContext(
+      ctorHost,
+      wrapperRef.host,
+      collection,
+      contextId,
+      wrapperRef,
+    );
+    if (!instance) {
+      throw new UnknownElementException();
+    }
+    return instance;
  }

  protected async instantiateClass<T = any>(
@@ -38,8 +105,8 @@ export abstract class ModuleRef {
    const wrapper = new InstanceWrapper({
      name: type && type.name,
      metatype: type,
-      instance: undefined,
      isResolved: false,
+      scope: getClassScope(type),
      host: moduleRef,
    });
    return new Promise<T>(async (resolve, reject) => {
@@ -64,47 +131,4 @@ export abstract class ModuleRef {
      }
    });
  }
-
-  protected findInstanceByToken<TInput = any, TResult = TInput>(
-    metatypeOrToken: Type<TInput> | string | symbol,
-    contextModule: Module,
-  ): TResult {
-    return this.containerScanner.findInstanceByToken<TInput, TResult>(
-      metatypeOrToken,
-      contextModule,
-    );
-  }
-
-  protected async resolvePerContext<TInput = any, TResult = TInput>(
-    typeOrToken: Type<TInput> | string | symbol,
-    contextModule: Module,
-    contextId: ContextId,
-    options?: { strict: boolean },
-  ): Promise<TResult> {
-    let wrapper: InstanceWrapper, collection: Map<string, InstanceWrapper>;
-    if (!(options && options.strict)) {
-      [wrapper, collection] = this.containerScanner.getWrapperCollectionPair(
-        typeOrToken,
-      );
-    } else {
-      [
-        wrapper,
-        collection,
-      ] = this.containerScanner.getWrapperCollectionPairByHost(
-        typeOrToken,
-        contextModule,
-      );
-    }
-    const instance = await this.injector.loadPerContext(
-      wrapper.instance,
-      wrapper.host,
-      collection,
-      contextId,
-      wrapper,
-    );
-    if (!instance) {
-      throw new UnknownElementException();
-    }
-    return instance;
-  }
 }
--- a/packages/core/injector/module.ts
+++ b/packages/core/injector/module.ts
@@ -19,6 +19,7 @@ import {
  isSymbol,
  isUndefined,
 } from '@nestjs/common/utils/shared.utils';
+import { iterate } from 'iterare';
 import { ApplicationConfig } from '../application-config';
 import { InvalidClassException } from '../errors/exceptions/invalid-class.exception';
 import { RuntimeException } from '../errors/exceptions/runtime.exception';
@@ -49,7 +50,6 @@ export class Module {

  constructor(
    private readonly _metatype: Type<any>,
-    private readonly _scope: Type<any>[],
    private readonly container: NestContainer,
  ) {
    this.addCoreProviders();
@@ -60,10 +60,6 @@ export class Module {
    return this._id;
  }

-  get scope(): Type<any>[] {
-    return this._scope;
-  }
-
  get providers(): Map<any, InstanceWrapper<Injectable>> {
    return this._providers;
  }
@@ -397,15 +393,16 @@ export class Module {
      return token;
    }
    const importsArray = [...this._imports.values()];
-    const importsNames = importsArray
-      .filter(item => item)
+    const importsNames = iterate(importsArray)
+      .filter(item => !!item)
      .map(({ metatype }) => metatype)
-      .filter(metatype => metatype)
-      .map(({ name }) => name);
+      .filter(metatype => !!metatype)
+      .map(({ name }) => name)
+      .toArray();

-    if (!importsNames.includes(token as any)) {
+    if (!importsNames.includes(token as string)) {
      const { name } = this.metatype;
-      throw new UnknownExportException(token as any, name);
+      throw new UnknownExportException(token, name);
    }
    return token;
  }
@@ -482,7 +479,7 @@ export class Module {
    return [...this._providers].filter(([_, wrapper]) => !wrapper.isAlias);
  }

-  public createModuleReferenceType(): any {
+  public createModuleReferenceType(): Type<ModuleRef> {
    // eslint-disable-next-line @typescript-eslint/no-this-alias
    const self = this;
    return class extends ModuleRef {
@@ -494,10 +491,9 @@ export class Module {
        typeOrToken: Type<TInput> | string | symbol,
        options: { strict: boolean } = { strict: true },
      ): TResult {
-        if (!(options && options.strict)) {
-          return this.find<TInput, TResult>(typeOrToken);
-        }
-        return this.findInstanceByToken<TInput, TResult>(typeOrToken, self);
+        return !(options && options.strict)
+          ? this.find<TInput, TResult>(typeOrToken)
+          : this.find<TInput, TResult>(typeOrToken, self);
      }

      public resolve<TInput = any, TResult = TInput>(
--- a/packages/core/interceptors/interceptors-context-creator.ts
+++ b/packages/core/interceptors/interceptors-context-creator.ts
@@ -1,7 +1,7 @@
 import { INTERCEPTORS_METADATA } from '@nestjs/common/constants';
 import { Controller, NestInterceptor } from '@nestjs/common/interfaces';
 import { isEmpty, isFunction } from '@nestjs/common/utils/shared.utils';
-import iterate from 'iterare';
+import { iterate } from 'iterare';
 import { ApplicationConfig } from '../application-config';
 import { ContextCreator } from '../helpers/context-creator';
 import { STATIC_CONTEXT } from '../injector/constants';
@@ -104,10 +104,11 @@ export class InterceptorsContextCreator extends ContextCreator {
      return globalInterceptors;
    }
    const scopedInterceptorWrappers = this.config.getGlobalRequestInterceptors() as InstanceWrapper[];
-    const scopedInterceptors = scopedInterceptorWrappers
+    const scopedInterceptors = iterate(scopedInterceptorWrappers)
      .map(wrapper => wrapper.getInstanceByContextId(contextId, inquirerId))
-      .filter(host => host)
-      .map(host => host.instance);
+      .filter(host => !!host)
+      .map(host => host.instance)
+      .toArray();

    return globalInterceptors.concat(scopedInterceptors) as T;
  }
--- a/packages/core/metadata-scanner.ts
+++ b/packages/core/metadata-scanner.ts
@@ -4,7 +4,7 @@ import {
  isFunction,
  isNil,
 } from '@nestjs/common/utils/shared.utils';
-import iterate from 'iterare';
+import { iterate } from 'iterare';

 export class MetadataScanner {
  public scanFromPrototype<T extends Injectable, R = any>(
--- a/packages/core/middleware/builder.ts
+++ b/packages/core/middleware/builder.ts
@@ -11,6 +11,7 @@ import {
 import { MiddlewareConfiguration } from '@nestjs/common/interfaces/middleware/middleware-configuration.interface';
 import { RoutesMapper } from './routes-mapper';
 import { filterMiddleware } from './utils';
+import { iterate } from 'iterare';

 export class MiddlewareBuilder implements MiddlewareConsumer {
  private readonly middlewareCollection = new Set<MiddlewareConfiguration>();
@@ -49,21 +50,16 @@ export class MiddlewareBuilder implements MiddlewareConsumer {
    public exclude(
      ...routes: Array<string | RouteInfo>
    ): MiddlewareConfigProxy {
-      const { routesMapper } = this.builder;
-      this.excludedRoutes = this.mapRoutesToFlatList(
-        routes.map(route => routesMapper.mapRouteToRouteInfo(route)),
-      );
+      this.excludedRoutes = this.getRoutesFlatList(routes);
      return this;
    }

    public forRoutes(
      ...routes: Array<string | Type<any> | RouteInfo>
    ): MiddlewareConsumer {
-      const { middlewareCollection, routesMapper } = this.builder;
+      const { middlewareCollection } = this.builder;

-      const forRoutes = this.mapRoutesToFlatList(
-        routes.map(route => routesMapper.mapRouteToRouteInfo(route)),
-      );
+      const forRoutes = this.getRoutesFlatList(routes);
      const configuration = {
        middleware: filterMiddleware(
          this.middleware,
@@ -76,8 +72,15 @@ export class MiddlewareBuilder implements MiddlewareConsumer {
      return this.builder;
    }

-    private mapRoutesToFlatList(forRoutes: RouteInfo[][]): RouteInfo[] {
-      return forRoutes.reduce((a, b) => a.concat(b));
+    private getRoutesFlatList(
+      routes: Array<string | Type<any> | RouteInfo>,
+    ): RouteInfo[] {
+      const { routesMapper } = this.builder;
+
+      return iterate(routes)
+        .map(route => routesMapper.mapRouteToRouteInfo(route))
+        .flatten()
+        .toArray();
    }
  };
 }
--- a/packages/core/middleware/utils.ts
+++ b/packages/core/middleware/utils.ts
@@ -4,6 +4,7 @@ import { HttpServer, RouteInfo, Type } from '@nestjs/common/interfaces';
 import { isFunction } from '@nestjs/common/utils/shared.utils';
 import * as pathToRegexp from 'path-to-regexp';
 import { v4 as uuid } from 'uuid';
+import { iterate } from 'iterare';

 type RouteInfoRegex = RouteInfo & { regex: RegExp };

@@ -16,10 +17,11 @@ export const filterMiddleware = <T extends Function | Type<any> = any>(
    ...route,
    regex: pathToRegexp(route.path),
  }));
-  return []
+  return iterate([])
    .concat(middleware)
    .filter(isFunction)
-    .map((item: T) => mapToClass(item, excluded, httpAdapter));
+    .map((item: T) => mapToClass(item, excluded, httpAdapter))
+    .toArray();
 };

 export const mapToClass = <T extends Function | Type<any>>(
--- a/packages/core/nest-application-context.ts
+++ b/packages/core/nest-application-context.ts
@@ -4,10 +4,12 @@ import {
  LoggerService,
  ShutdownSignal,
 } from '@nestjs/common';
-import { Abstract } from '@nestjs/common/interfaces';
+import { Abstract, Scope } from '@nestjs/common/interfaces';
 import { Type } from '@nestjs/common/interfaces/type.interface';
 import { isEmpty } from '@nestjs/common/utils/shared.utils';
+import { iterate } from 'iterare';
 import { MESSAGES } from './constants';
+import { InvalidClassScopeException } from './errors/exceptions/invalid-class-scope.exception';
 import { UnknownElementException } from './errors/exceptions/unknown-element.exception';
 import { UnknownModuleException } from './errors/exceptions/unknown-module.exception';
 import { createContextId } from './helpers';
@@ -20,9 +22,8 @@ import {
 } from './hooks';
 import { ContextId } from './injector';
 import { NestContainer } from './injector/container';
-import { ContainerScanner } from './injector/container-scanner';
 import { Injector } from './injector/injector';
-import { InstanceWrapper } from './injector/instance-wrapper';
+import { InstanceLinksHost } from './injector/instance-links-host';
 import { Module } from './injector/module';

 /**
@@ -33,15 +34,20 @@ export class NestApplicationContext implements INestApplicationContext {
  protected readonly injector = new Injector();
  private shutdownCleanupRef?: (...args: unknown[]) => unknown;
  private readonly activeShutdownSignals = new Array<string>();
-  private readonly containerScanner: ContainerScanner;
+  private _instanceLinksHost: InstanceLinksHost;
+
+  private get instanceLinksHost() {
+    if (!this._instanceLinksHost) {
+      this._instanceLinksHost = new InstanceLinksHost(this.container);
+    }
+    return this._instanceLinksHost;
+  }

  constructor(
    protected readonly container: NestContainer,
    private readonly scope = new Array<Type<any>>(),
    private contextModule: Module = null,
-  ) {
-    this.containerScanner = new ContainerScanner(container);
-  }
+  ) {}

  public selectContextModule() {
    const modules = this.container.getModules().values();
@@ -66,13 +72,9 @@ export class NestApplicationContext implements INestApplicationContext {
    typeOrToken: Type<TInput> | Abstract<TInput> | string | symbol,
    options: { strict: boolean } = { strict: false },
  ): TResult {
-    if (!(options && options.strict)) {
-      return this.find<TInput, TResult>(typeOrToken);
-    }
-    return this.findInstanceByToken<TInput, TResult>(
-      typeOrToken,
-      this.contextModule,
-    );
+    return !(options && options.strict)
+      ? this.find<TInput, TResult>(typeOrToken)
+      : this.find<TInput, TResult>(typeOrToken, this.contextModule);
  }

  public resolve<TInput = any, TResult = TInput>(
@@ -88,6 +90,10 @@ export class NestApplicationContext implements INestApplicationContext {
    );
  }

+  public registerRequestByContextId<T = any>(request: T, contextId: ContextId) {
+    this.container.registerRequestProvider(request, contextId);
+  }
+
  /**
   * Initalizes the Nest application.
   * Calls the Nest lifecycle events.
@@ -110,7 +116,7 @@ export class NestApplicationContext implements INestApplicationContext {
    await this.callBeforeShutdownHook();
    await this.dispose();
    await this.callShutdownHook();
-    await this.unsubscribeFromProcessSignals();
+    this.unsubscribeFromProcessSignals();
  }

  public useLogger(logger: LoggerService) {
@@ -137,10 +143,11 @@ export class NestApplicationContext implements INestApplicationContext {
      signals = Array.from(new Set(signals));
    }

-    signals = signals
+    signals = iterate(signals)
      .map((signal: string) => signal.toString().toUpperCase().trim())
      // filter out the signals which is already listening to
-      .filter(signal => !this.activeShutdownSignals.includes(signal));
+      .filter(signal => !this.activeShutdownSignals.includes(signal))
+      .toArray();

    this.listenToShutdownSignals(signals);
    return this;
@@ -253,18 +260,20 @@ export class NestApplicationContext implements INestApplicationContext {

  protected find<TInput = any, TResult = TInput>(
    typeOrToken: Type<TInput> | Abstract<TInput> | string | symbol,
+    contextModule?: Module,
  ): TResult {
-    return this.containerScanner.find<TInput, TResult>(typeOrToken);
-  }
-
-  protected findInstanceByToken<TInput = any, TResult = TInput>(
-    metatypeOrToken: Type<TInput> | Abstract<TInput> | string | symbol,
-    contextModule: Partial<Module>,
-  ): TResult {
-    return this.containerScanner.findInstanceByToken<TInput, TResult>(
-      metatypeOrToken,
-      contextModule,
+    const moduleId = contextModule && contextModule.id;
+    const { wrapperRef } = this.instanceLinksHost.get<TResult>(
+      typeOrToken,
+      moduleId,
    );
+    if (
+      wrapperRef.scope === Scope.REQUEST ||
+      wrapperRef.scope === Scope.TRANSIENT
+    ) {
+      throw new InvalidClassScopeException(typeOrToken);
+    }
+    return wrapperRef.instance;
  }

  protected async resolvePerContext<TInput = any, TResult = TInput>(
@@ -273,23 +282,20 @@ export class NestApplicationContext implements INestApplicationContext {
    contextId: ContextId,
    options?: { strict: boolean },
  ): Promise<TResult> {
-    let wrapper: InstanceWrapper, collection: Map<string, InstanceWrapper>;
-    if (!(options && options.strict)) {
-      [wrapper, collection] = this.containerScanner.getWrapperCollectionPair(
-        typeOrToken,
-      );
-    } else {
-      [
-        wrapper,
-        collection,
-      ] = this.containerScanner.getWrapperCollectionPairByHost(
-        typeOrToken,
-        contextModule,
-      );
+    const isStrictModeEnabled = options && options.strict;
+    const instanceLink = isStrictModeEnabled
+      ? this.instanceLinksHost.get(typeOrToken, contextModule.id)
+      : this.instanceLinksHost.get(typeOrToken);
+
+    const { wrapperRef, collection } = instanceLink;
+    if (wrapperRef.isDependencyTreeStatic() && !wrapperRef.isTransient) {
+      return this.get(typeOrToken);
    }
+
+    const ctorHost = wrapperRef.instance || { constructor: typeOrToken };
    const instance = await this.injector.loadPerContext(
-      wrapper.instance,
-      wrapper.host,
+      ctorHost,
+      wrapperRef.host,
      collection,
      contextId,
    );
--- a/packages/core/nest-application.ts
+++ b/packages/core/nest-application.ts
@@ -4,6 +4,7 @@ import {
  HttpServer,
  INestApplication,
  INestMicroservice,
+  NestHybridApplicationOptions,
  NestInterceptor,
  PipeTransform,
  WebSocketAdapter,
@@ -13,7 +14,7 @@ import { NestApplicationOptions } from '@nestjs/common/interfaces/nest-applicati
 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 iterate from 'iterare';
+import { iterate } from 'iterare';
 import { platform } from 'os';
 import { AbstractHttpAdapter } from './adapters';
 import { ApplicationConfig } from './application-config';
@@ -170,17 +171,23 @@ export class NestApplication extends NestApplicationContext
    this.routesResolver.registerExceptionHandler();
  }

-  public connectMicroservice<T extends object>(options: T): INestMicroservice {
+  public connectMicroservice<T extends object>(
+    microserviceOptions: T,
+    hybridAppOptions: NestHybridApplicationOptions = {},
+  ): INestMicroservice {
    const { NestMicroservice } = loadPackage(
      '@nestjs/microservices',
      'NestFactory',
      () => require('@nestjs/microservices'),
    );
+    const { inheritAppConfig } = hybridAppOptions;
+    const applicationConfig = inheritAppConfig
+      ? this.config
+      : new ApplicationConfig();

-    const applicationConfig = new ApplicationConfig();
    const instance = new NestMicroservice(
      this.container,
-      options,
+      microserviceOptions,
      applicationConfig,
    );
    instance.registerListeners();
--- a/packages/core/nest-factory.ts
+++ b/packages/core/nest-factory.ts
@@ -190,7 +190,7 @@ export class NestFactoryStatic {
    prop: string,
  ): Function {
    return (...args: unknown[]) => {
-      let result;
+      let result: unknown;
      ExceptionsZone.run(() => {
        result = receiver[prop](...args);
      });
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@nestjs/core",
-  "version": "7.0.5",
+  "version": "7.3.0",
  "description": "Nest - modern, fast, powerful node.js web framework (@core)",
  "author": "Kamil Mysliwiec",
  "license": "MIT",
@@ -29,11 +29,14 @@
  "dependencies": {
    "@nuxtjs/opencollective": "0.2.2",
    "fast-safe-stringify": "2.0.7",
-    "iterare": "1.2.0",
+    "iterare": "1.2.1",
    "object-hash": "2.0.3",
    "path-to-regexp": "3.2.0",
-    "tslib": "1.11.1",
-    "uuid": "7.0.2"
+    "tslib": "2.0.0",
+    "uuid": "8.2.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "7.3.0"
  },
  "peerDependencies": {
    "@nestjs/common": "^7.0.0",
--- a/packages/core/pipes/pipes-context-creator.ts
+++ b/packages/core/pipes/pipes-context-creator.ts
@@ -1,7 +1,7 @@
 import { PIPES_METADATA } from '@nestjs/common/constants';
 import { Controller, PipeTransform } from '@nestjs/common/interfaces';
 import { isEmpty, isFunction } from '@nestjs/common/utils/shared.utils';
-import iterate from 'iterare';
+import { iterate } from 'iterare';
 import { ApplicationConfig } from '../application-config';
 import { ContextCreator } from '../helpers/context-creator';
 import { STATIC_CONTEXT } from '../injector/constants';
@@ -96,10 +96,11 @@ export class PipesContextCreator extends ContextCreator {
      return globalPipes;
    }
    const scopedPipeWrappers = this.config.getGlobalRequestPipes() as InstanceWrapper[];
-    const scopedPipes = scopedPipeWrappers
+    const scopedPipes = iterate(scopedPipeWrappers)
      .map(wrapper => wrapper.getInstanceByContextId(contextId, inquirerId))
-      .filter(host => host)
-      .map(host => host.instance);
+      .filter(host => !!host)
+      .map(host => host.instance)
+      .toArray();

    return globalPipes.concat(scopedPipes) as T;
  }
--- a/packages/core/router/router-exception-filters.ts
+++ b/packages/core/router/router-exception-filters.ts
@@ -9,6 +9,7 @@ import { STATIC_CONTEXT } from '../injector/constants';
 import { NestContainer } from '../injector/container';
 import { InstanceWrapper } from '../injector/instance-wrapper';
 import { RouterProxyCallback } from './router-proxy';
+import { iterate } from 'iterare';

 export class RouterExceptionFilters extends BaseExceptionFilterContext {
  constructor(
@@ -52,10 +53,11 @@ export class RouterExceptionFilters extends BaseExceptionFilterContext {
      return globalFilters;
    }
    const scopedFilterWrappers = this.config.getGlobalRequestFilters() as InstanceWrapper[];
-    const scopedFilters = scopedFilterWrappers
+    const scopedFilters = iterate(scopedFilterWrappers)
      .map(wrapper => wrapper.getInstanceByContextId(contextId, inquirerId))
-      .filter(host => host)
-      .map(host => host.instance);
+      .filter(host => !!host)
+      .map(host => host.instance)
+      .toArray();

    return globalFilters.concat(scopedFilters) as T;
  }
--- a/packages/core/scanner.ts
+++ b/packages/core/scanner.ts
@@ -33,6 +33,7 @@ import {
  isNil,
  isUndefined,
 } from '@nestjs/common/utils/shared.utils';
+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';
@@ -42,6 +43,8 @@ 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;
@@ -89,7 +92,14 @@ export class DependenciesScanner {
          ...((module as DynamicModule).imports || []),
        ];

-    for (const innerModule of modules) {
+    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);
+      }
+      if (!innerModule) {
+        throw new InvalidModuleException(module, index, scope);
+      }
      if (ctxRegistry.includes(innerModule)) {
        continue;
      }
@@ -259,7 +269,7 @@ export class DependenciesScanner {

  public async calculateModulesDistance(modules: ModulesContainer) {
    const modulesGenerator = modules.values();
-    const rootModule = modulesGenerator.next().value;
+    const rootModule = modulesGenerator.next().value as Module;
    const modulesStack = [rootModule];

    const calculateDistance = (moduleRef: Module, distance = 1) => {
@@ -378,24 +388,20 @@ export class DependenciesScanner {
   * to all controllers metadata storage
   */
  public addScopedEnhancersMetadata() {
-    const scopedGlobalProviders = this.applicationProvidersApplyMap.filter(
-      wrapper => this.isRequestOrTransient(wrapper.scope),
-    );
+    iterate(this.applicationProvidersApplyMap)
+      .filter(wrapper => this.isRequestOrTransient(wrapper.scope))
+      .forEach(({ moduleKey, providerKey }) => {
+        const modulesContainer = this.container.getModules();
+        const { injectables } = modulesContainer.get(moduleKey);
+        const instanceWrapper = injectables.get(providerKey);

-    scopedGlobalProviders.forEach(({ moduleKey, providerKey }) => {
-      const modulesContainer = this.container.getModules();
-      const { injectables } = modulesContainer.get(moduleKey);
-      const instanceWrapper = injectables.get(providerKey);
-
-      const modules = [...modulesContainer.values()];
-      const controllersArray = modules.map(module => [
-        ...module.controllers.values(),
-      ]);
-      const controllers = this.flatten(controllersArray);
-      controllers.forEach(controller =>
-        controller.addEnhancerMetadata(instanceWrapper),
-      );
-    });
+        iterate(modulesContainer.values())
+          .map(module => module.controllers.values())
+          .flatten()
+          .forEach(controller =>
+            controller.addEnhancerMetadata(instanceWrapper),
+          );
+      });
  }

  public applyApplicationProviders() {
--- a/packages/core/services/reflector.service.ts
+++ b/packages/core/services/reflector.service.ts
@@ -1,5 +1,5 @@
 import { Type } from '@nestjs/common';
-import { isObject } from '@nestjs/common/utils/shared.utils';
+import { isEmpty, isObject } from '@nestjs/common/utils/shared.utils';

 /**
 * Helper class providing Nest reflection capabilities.
@@ -53,7 +53,14 @@ export class Reflector {
    metadataKey: TKey,
    targets: (Type<any> | Function)[],
  ): TResult {
-    const metadataCollection = this.getAll(metadataKey, targets);
+    const metadataCollection = this.getAll<TResult, TKey>(
+      metadataKey,
+      targets,
+    ).filter(item => item !== undefined);
+
+    if (isEmpty(metadataCollection)) {
+      return metadataCollection as TResult;
+    }
    return metadataCollection.reduce((a, b) => {
      if (Array.isArray(a)) {
        return a.concat(b);
--- a/packages/core/test/errors/test/messages.spec.ts
+++ b/packages/core/test/errors/test/messages.spec.ts
@@ -2,161 +2,204 @@ import { expect } from 'chai';
 import { UnknownDependenciesException } from '../../../errors/exceptions/unknown-dependencies.exception';
 import { Module } from '../../../injector/module';
 import { stringCleaner } from '../../utils/string.cleaner';
+import {
+  UNDEFINED_MODULE_MESSAGE,
+  INVALID_MODULE_MESSAGE,
+} from '../../../errors/messages';

-describe('UnknownDependenciesMessage', () => {
-  const index = 0;
-  it('should display class', () => {
-    const expectedResult = stringCleaner(`Nest can't resolve dependencies of the CatService (?, CatService). Please make sure that the argument dependency at index [0] is available in the current context.
+describe('Error Messages', () => {
+  const CatsModule = { name: 'CatsModule' };
+  const AppModule = { name: 'AppModule' };

-    Potential solutions:
-    - If dependency is a provider, is it part of the current current?
-    - If dependency is exported from a separate @Module, is that module imported within current?
-    @Module({
+  describe('UNKNOWN_DEPENDENCIES_MESSAGE', () => {
+    const index = 0;
+    it('should display class', () => {
+      const expectedResult = stringCleaner(`Nest can't resolve dependencies of the CatService (?, CatService). Please make sure that the argument dependency at index [0] is available in the current context.
+  
+      Potential solutions:
+      - If dependency is a provider, is it part of the current current?
+      - If dependency is exported from a separate @Module, is that module imported within current?
+      @Module({
+        imports: [ /* the Module containing dependency */ ]
+      })
+      `);
+
+      class CatService {}
+
+      const actualMessage = stringCleaner(
+        new UnknownDependenciesException('CatService', {
+          index,
+          dependencies: ['', CatService],
+        }).message,
+      );
+
+      expect(actualMessage).to.equal(expectedResult);
+    });
+    it('should display the provide token', () => {
+      const expectedResult = stringCleaner(`Nest can't resolve dependencies of the CatService (?, MY_TOKEN). Please make sure that the argument dependency at index [0] is available in the current context.
+  
+      Potential solutions:
+      - If dependency is a provider, is it part of the current current?
+      - If dependency is exported from a separate @Module, is that module imported within current?
+      @Module({
      imports: [ /* the Module containing dependency */ ]
-    })
-    `);
+      })
+      `);

-    class CatService {}
+      const actualMessage = stringCleaner(
+        new UnknownDependenciesException('CatService', {
+          index,
+          dependencies: ['', 'MY_TOKEN'],
+        }).message,
+      );

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

-    const actualMessage = stringCleaner(
-      new UnknownDependenciesException('CatService', {
-        index,
-        dependencies: ['', undefined],
-      }).message,
-    );
+      function CatFunction() {}
+      const actualMessage = stringCleaner(
+        new UnknownDependenciesException('CatService', {
+          index,
+          dependencies: ['', CatFunction],
+        }).message,
+      );
+      expect(actualMessage).to.equal(expectedResult);
+    });
+    it('should use "+" if unknown dependency name', () => {
+      const expectedResult = stringCleaner(`Nest can't resolve dependencies of the CatService (?, +). Please make sure that the argument dependency at index [0] is available in the current context.
+  
+      Potential solutions:
+      - If dependency is a provider, is it part of the current current?
+      - If dependency is exported from a separate @Module, is that module imported within current?
+        @Module({
+          imports: [ /* the Module containing dependency */ ]
+        })
+      `);

-    expect(actualMessage).to.equal(expectedResult);
+      const actualMessage = stringCleaner(
+        new UnknownDependenciesException('CatService', {
+          index,
+          dependencies: ['', undefined],
+        }).message,
+      );
+
+      expect(actualMessage).to.equal(expectedResult);
+    });
+    it('should display the module name', () => {
+      const expectedResult = stringCleaner(`Nest can't resolve dependencies of the CatService (?, MY_TOKEN). Please make sure that the argument dependency at index [0] is available in the TestModule context.
+  
+      Potential solutions:
+      - If dependency is a provider, is it part of the current TestModule?
+      - If dependency is exported from a separate @Module, is that module imported within TestModule?
+        @Module({
+          imports: [ /* the Module containing dependency */ ]
+        })
+      `);
+
+      class MetaType {
+        name: string;
+      }
+      class TestModule {
+        metatype: MetaType;
+      }
+      const myModule = new TestModule();
+      const myMetaType = new MetaType();
+      myMetaType.name = 'TestModule';
+      myModule.metatype = myMetaType;
+
+      const actualMessage = stringCleaner(
+        new UnknownDependenciesException(
+          'CatService',
+          { index, dependencies: ['', 'MY_TOKEN'] },
+          myModule as Module,
+        ).message,
+      );
+
+      expect(actualMessage).to.equal(expectedResult);
+    });
+    it('should display the symbol name of the provider', () => {
+      const expectedResult = stringCleaner(`Nest can't resolve dependencies of the Symbol(CatProvider) (?). Please make sure that the argument dependency at index [0] is available in the current context.
+  
+      Potential solutions:
+      - If dependency is a provider, is it part of the current current?
+      - If dependency is exported from a separate @Module, is that module imported within current?
+        @Module({
+          imports: [ /* the Module containing dependency */ ]
+        })
+      `);
+
+      const actualMessage = stringCleaner(
+        new UnknownDependenciesException(Symbol('CatProvider'), {
+          index,
+          dependencies: [''],
+        }).message,
+      );
+
+      expect(actualMessage).to.equal(expectedResult);
+    });
+    it('should display the symbol dependency of the provider', () => {
+      const expectedResult = stringCleaner(`Nest can't resolve dependencies of the CatProvider (?, Symbol(DogProvider)). Please make sure that the argument dependency at index [0] is available in the current context.
+  
+      Potential solutions:
+      - If dependency is a provider, is it part of the current current?
+      - If dependency is exported from a separate @Module, is that module imported within current?
+        @Module({
+          imports: [ /* the Module containing dependency */ ]
+        })
+      `);
+
+      const actualMessage = stringCleaner(
+        new UnknownDependenciesException('CatProvider', {
+          index,
+          dependencies: ['', Symbol('DogProvider')],
+        }).message,
+      );
+
+      expect(actualMessage).to.equal(expectedResult);
+    });
  });
-  it('should display the module name', () => {
-    const expectedResult = stringCleaner(`Nest can't resolve dependencies of the CatService (?, MY_TOKEN). Please make sure that the argument dependency at index [0] is available in the TestModule context.

-    Potential solutions:
-    - If dependency is a provider, is it part of the current TestModule?
-    - If dependency is exported from a separate @Module, is that module imported within TestModule?
-      @Module({
-        imports: [ /* the Module containing dependency */ ]
-      })
-    `);
+  describe('UNDEFINED_MODULE_EXCEPTION', () => {
+    it('should display the module name with the undefined index and scope', () => {
+      const expectedMessage = stringCleaner(`Nest cannot create the CatsModule instance.
+The module at index [0] of the CatsModule "imports" array is undefined.

-    class MetaType {
-      name: string;
-    }
-    class TestModule {
-      metatype: MetaType;
-    }
-    const myModule = new TestModule();
-    const myMetaType = new MetaType();
-    myMetaType.name = 'TestModule';
-    myModule.metatype = myMetaType;
+Potential causes:
+- A circular dependency between modules. Use forwardRef() to avoid it. Read more: https://docs.nestjs.com/fundamentals/circular-dependency
+- The module at index [0] is of type "undefined". Check your import statements and the type of the module.

-    const actualMessage = stringCleaner(
-      new UnknownDependenciesException(
-        'CatService',
-        { index, dependencies: ['', 'MY_TOKEN'] },
-        myModule as Module,
-      ).message,
-    );
+Scope [AppModule -> CatsModule]`);

-    expect(actualMessage).to.equal(expectedResult);
+      const actualMessage = stringCleaner(
+        UNDEFINED_MODULE_MESSAGE(CatsModule, 0, [AppModule, CatsModule]),
+      );
+
+      expect(actualMessage).to.be.eq(expectedMessage);
+    });
  });
-  it('should display the symbol name of the provider', () => {
-    const expectedResult = stringCleaner(`Nest can't resolve dependencies of the Symbol(CatProvider) (?). Please make sure that the argument dependency at index [0] is available in the current context.

-    Potential solutions:
-    - If dependency is a provider, is it part of the current current?
-    - If dependency is exported from a separate @Module, is that module imported within current?
-      @Module({
-        imports: [ /* the Module containing dependency */ ]
-      })
-    `);
+  describe('INVALID_MODULE_MESSAGE', () => {
+    it('should display the module name with the invalid index and scope', () => {
+      const expectedMessage = stringCleaner(`Nest cannot create the CatsModule instance.
+Received an unexpected value at index [0] of the CatsModule "imports" array. 

-    const actualMessage = stringCleaner(
-      new UnknownDependenciesException(Symbol('CatProvider'), {
-        index,
-        dependencies: [''],
-      }).message,
-    );
+Scope [AppModule -> CatsModule]`);

-    expect(actualMessage).to.equal(expectedResult);
-  });
-  it('should display the symbol dependency of the provider', () => {
-    const expectedResult = stringCleaner(`Nest can't resolve dependencies of the CatProvider (?, Symbol(DogProvider)). Please make sure that the argument dependency at index [0] is available in the current context.
+      const actualMessage = stringCleaner(
+        INVALID_MODULE_MESSAGE(CatsModule, 0, [AppModule, CatsModule]),
+      );

-    Potential solutions:
-    - If dependency is a provider, is it part of the current current?
-    - If dependency is exported from a separate @Module, is that module imported within current?
-      @Module({
-        imports: [ /* the Module containing dependency */ ]
-      })
-    `);
-
-    const actualMessage = stringCleaner(
-      new UnknownDependenciesException('CatProvider', {
-        index,
-        dependencies: ['', Symbol('DogProvider')],
-      }).message,
-    );
-
-    expect(actualMessage).to.equal(expectedResult);
+      expect(actualMessage).to.be.eq(expectedMessage);
+    });
  });
 });
--- a/packages/core/test/hooks/before-app-shutdown.hook.spec.ts
+++ b/packages/core/test/hooks/before-app-shutdown.hook.spec.ts
@@ -0,0 +1,49 @@
+import { BeforeApplicationShutdown } from '@nestjs/common';
+import { expect } from 'chai';
+import * as sinon from 'sinon';
+import { callBeforeAppShutdownHook } from '../../hooks/before-app-shutdown.hook';
+import { NestContainer } from '../../injector/container';
+import { Module } from '../../injector/module';
+
+class SampleProvider implements BeforeApplicationShutdown {
+  beforeApplicationShutdown(signal?: string) {}
+}
+
+class SampleModule implements BeforeApplicationShutdown {
+  beforeApplicationShutdown(signal?: string) {}
+}
+
+class WithoutHookProvider {}
+
+describe('BeforeAppShutdown', () => {
+  let moduleRef: Module;
+  let sampleProvider: SampleProvider;
+
+  beforeEach(() => {
+    sampleProvider = new SampleProvider();
+    moduleRef = new Module(SampleModule, new NestContainer());
+
+    const moduleWrapperRef = moduleRef.getProviderByKey(SampleModule.name);
+    moduleWrapperRef.instance = new SampleModule();
+
+    moduleRef.addProvider({
+      provide: SampleProvider,
+      useValue: sampleProvider,
+    });
+    moduleRef.addProvider({
+      provide: WithoutHookProvider,
+      useValue: new WithoutHookProvider(),
+    });
+  });
+
+  describe('callBeforeAppShutdownHook', () => {
+    it('should call "beforeApplicationShutdown" hook for the entire module', async () => {
+      const signal = 'SIGTERM';
+
+      const hookSpy = sinon.spy(sampleProvider, 'beforeApplicationShutdown');
+      await callBeforeAppShutdownHook(moduleRef, signal);
+
+      expect(hookSpy.calledWith(signal)).to.be.true;
+    });
+  });
+});
--- a/packages/core/test/hooks/on-app-bootstrap.hook.spec.ts
+++ b/packages/core/test/hooks/on-app-bootstrap.hook.spec.ts
@@ -0,0 +1,47 @@
+import { OnApplicationBootstrap } from '@nestjs/common';
+import { expect } from 'chai';
+import * as sinon from 'sinon';
+import { callModuleBootstrapHook } from '../../hooks/on-app-bootstrap.hook';
+import { NestContainer } from '../../injector/container';
+import { Module } from '../../injector/module';
+
+class SampleProvider implements OnApplicationBootstrap {
+  onApplicationBootstrap() {}
+}
+
+class SampleModule implements OnApplicationBootstrap {
+  onApplicationBootstrap() {}
+}
+
+class WithoutHookProvider {}
+
+describe('OnApplicationBootstrap', () => {
+  let moduleRef: Module;
+  let sampleProvider: SampleProvider;
+
+  beforeEach(() => {
+    sampleProvider = new SampleProvider();
+    moduleRef = new Module(SampleModule, new NestContainer());
+
+    const moduleWrapperRef = moduleRef.getProviderByKey(SampleModule.name);
+    moduleWrapperRef.instance = new SampleModule();
+
+    moduleRef.addProvider({
+      provide: SampleProvider,
+      useValue: sampleProvider,
+    });
+    moduleRef.addProvider({
+      provide: WithoutHookProvider,
+      useValue: new WithoutHookProvider(),
+    });
+  });
+
+  describe('callModuleBootstrapHook', () => {
+    it('should call "onApplicationBootstrap" hook for the entire module', async () => {
+      const hookSpy = sinon.spy(sampleProvider, 'onApplicationBootstrap');
+      await callModuleBootstrapHook(moduleRef);
+
+      expect(hookSpy.called).to.be.true;
+    });
+  });
+});
--- a/packages/core/test/hooks/on-app-shutdown.hook.spec.ts
+++ b/packages/core/test/hooks/on-app-shutdown.hook.spec.ts
@@ -0,0 +1,47 @@
+import { OnApplicationShutdown } from '@nestjs/common';
+import { expect } from 'chai';
+import * as sinon from 'sinon';
+import { callAppShutdownHook } from '../../hooks/on-app-shutdown.hook';
+import { NestContainer } from '../../injector/container';
+import { Module } from '../../injector/module';
+
+class SampleProvider implements OnApplicationShutdown {
+  onApplicationShutdown() {}
+}
+
+class SampleModule implements OnApplicationShutdown {
+  onApplicationShutdown() {}
+}
+
+class WithoutHookProvider {}
+
+describe('OnApplicationShutdown', () => {
+  let moduleRef: Module;
+  let sampleProvider: SampleProvider;
+
+  beforeEach(() => {
+    sampleProvider = new SampleProvider();
+    moduleRef = new Module(SampleModule, new NestContainer());
+
+    const moduleWrapperRef = moduleRef.getProviderByKey(SampleModule.name);
+    moduleWrapperRef.instance = new SampleModule();
+
+    moduleRef.addProvider({
+      provide: SampleProvider,
+      useValue: sampleProvider,
+    });
+    moduleRef.addProvider({
+      provide: WithoutHookProvider,
+      useValue: new WithoutHookProvider(),
+    });
+  });
+
+  describe('callAppShutdownHook', () => {
+    it('should call "onApplicationShutdown" hook for the entire module', async () => {
+      const hookSpy = sinon.spy(sampleProvider, 'onApplicationShutdown');
+      await callAppShutdownHook(moduleRef);
+
+      expect(hookSpy.called).to.be.true;
+    });
+  });
+});
--- a/packages/core/test/hooks/on-module-destroy.hook.spec.ts
+++ b/packages/core/test/hooks/on-module-destroy.hook.spec.ts
@@ -0,0 +1,47 @@
+import { OnModuleDestroy } from '@nestjs/common';
+import { expect } from 'chai';
+import * as sinon from 'sinon';
+import { callModuleDestroyHook } from '../../hooks/on-module-destroy.hook';
+import { NestContainer } from '../../injector/container';
+import { Module } from '../../injector/module';
+
+class SampleProvider implements OnModuleDestroy {
+  onModuleDestroy() {}
+}
+
+class SampleModule implements OnModuleDestroy {
+  onModuleDestroy() {}
+}
+
+class WithoutHookProvider {}
+
+describe('OnModuleDestroy', () => {
+  let moduleRef: Module;
+  let sampleProvider: SampleProvider;
+
+  beforeEach(() => {
+    sampleProvider = new SampleProvider();
+    moduleRef = new Module(SampleModule, new NestContainer());
+
+    const moduleWrapperRef = moduleRef.getProviderByKey(SampleModule.name);
+    moduleWrapperRef.instance = new SampleModule();
+
+    moduleRef.addProvider({
+      provide: SampleProvider,
+      useValue: sampleProvider,
+    });
+    moduleRef.addProvider({
+      provide: WithoutHookProvider,
+      useValue: new WithoutHookProvider(),
+    });
+  });
+
+  describe('callModuleDestroyHook', () => {
+    it('should call "onModuleDestroy" hook for the entire module', async () => {
+      const hookSpy = sinon.spy(sampleProvider, 'onModuleDestroy');
+      await callModuleDestroyHook(moduleRef);
+
+      expect(hookSpy.called).to.be.true;
+    });
+  });
+});
--- a/packages/core/test/hooks/on-module-init.hook.spec.ts
+++ b/packages/core/test/hooks/on-module-init.hook.spec.ts
@@ -0,0 +1,47 @@
+import { OnModuleInit } from '@nestjs/common';
+import { expect } from 'chai';
+import * as sinon from 'sinon';
+import { callModuleInitHook } from '../../hooks/on-module-init.hook';
+import { NestContainer } from '../../injector/container';
+import { Module } from '../../injector/module';
+
+class SampleProvider implements OnModuleInit {
+  onModuleInit() {}
+}
+
+class SampleModule implements OnModuleInit {
+  onModuleInit() {}
+}
+
+class WithoutHookProvider {}
+
+describe('OnModuleInit', () => {
+  let moduleRef: Module;
+  let sampleProvider: SampleProvider;
+
+  beforeEach(() => {
+    sampleProvider = new SampleProvider();
+    moduleRef = new Module(SampleModule, new NestContainer());
+
+    const moduleWrapperRef = moduleRef.getProviderByKey(SampleModule.name);
+    moduleWrapperRef.instance = new SampleModule();
+
+    moduleRef.addProvider({
+      provide: SampleProvider,
+      useValue: sampleProvider,
+    });
+    moduleRef.addProvider({
+      provide: WithoutHookProvider,
+      useValue: new WithoutHookProvider(),
+    });
+  });
+
+  describe('callModuleInitHook', () => {
+    it('should call "onModuleInit" hook for the entire module', async () => {
+      const hookSpy = sinon.spy(sampleProvider, 'onModuleInit');
+      await callModuleInitHook(moduleRef);
+
+      expect(hookSpy.called).to.be.true;
+    });
+  });
+});
--- a/packages/core/test/injector/injector.spec.ts
+++ b/packages/core/test/injector/injector.spec.ts
@@ -36,7 +36,7 @@ describe('Injector', () => {
    let mainTest, depOne, depTwo;

    beforeEach(() => {
-      moduleDeps = new Module(DependencyTwo as any, [], new NestContainer());
+      moduleDeps = new Module(DependencyTwo, new NestContainer());
      mainTest = new InstanceWrapper({
        name: 'MainTest',
        metatype: MainTest,
@@ -133,7 +133,7 @@ describe('Injector', () => {
    let test;

    beforeEach(() => {
-      moduleDeps = new Module(Test as any, [], new NestContainer());
+      moduleDeps = new Module(Test, new NestContainer());
      test = new InstanceWrapper({
        name: 'Test',
        metatype: Test,
@@ -712,12 +712,12 @@ describe('Injector', () => {
      const wrapper = new InstanceWrapper();
      wrapper.addEnhancerMetadata(
        new InstanceWrapper({
-          host: new Module(class {}, [], new NestContainer()),
+          host: new Module(class {}, new NestContainer()),
        }),
      );
      wrapper.addEnhancerMetadata(
        new InstanceWrapper({
-          host: new Module(class {}, [], new NestContainer()),
+          host: new Module(class {}, new NestContainer()),
        }),
      );

--- a/packages/core/test/injector/module.spec.ts
+++ b/packages/core/test/injector/module.spec.ts
@@ -22,7 +22,7 @@ describe('Module', () => {

  beforeEach(() => {
    container = new NestContainer();
-    module = new Module(TestModule as any, [], container);
+    module = new Module(TestModule, container);
  });

  it('should add controller', () => {
@@ -418,7 +418,7 @@ describe('Module', () => {
      it('should behave as identity', () => {
        const metatype = { name: token };
        (module as any)._imports = new Set([
-          new Module(metatype as any, [], new NestContainer()),
+          new Module(metatype as any, new NestContainer()),
        ]);
        expect(module.validateExportedProvider(token)).to.be.eql(token);
      });
--- a/packages/core/test/middleware/container.spec.ts
+++ b/packages/core/test/middleware/container.spec.ts
@@ -33,8 +33,8 @@ describe('MiddlewareContainer', () => {
    const nestContainer = new NestContainer();
    const modules = nestContainer.getModules();

-    modules.set('Module', new Module(ExampleModule, [], nestContainer));
-    modules.set('Test', new Module(ExampleModule, [], nestContainer));
+    modules.set('Module', new Module(ExampleModule, nestContainer));
+    modules.set('Test', new Module(ExampleModule, nestContainer));

    container = new MiddlewareContainer(nestContainer);
  });
--- a/packages/core/test/middleware/middleware-module.spec.ts
+++ b/packages/core/test/middleware/middleware-module.spec.ts
@@ -58,7 +58,7 @@ describe('MiddlewareModule', () => {
      const stubContainer = new NestContainer();
      stubContainer
        .getModules()
-        .set('Test', new Module(class {}, [], stubContainer));
+        .set('Test', new Module(class {}, stubContainer));

      await middlewareModule.loadConfiguration(
        new MiddlewareContainer(stubContainer),
@@ -87,7 +87,7 @@ describe('MiddlewareModule', () => {
      nestContainer = new NestContainer();
      nestContainer
        .getModules()
-        .set('Test', new Module(TestModule, [], nestContainer));
+        .set('Test', new Module(TestModule, nestContainer));
    });
    it('should throw "RuntimeException" exception when middleware is not stored in container', () => {
      const route = { path: 'Test' };
@@ -162,7 +162,7 @@ describe('MiddlewareModule', () => {
      const stubContainer = new NestContainer();
      stubContainer
        .getModules()
-        .set('Test', new Module(TestModule, [], stubContainer));
+        .set('Test', new Module(TestModule, stubContainer));

      const container = new MiddlewareContainer(stubContainer);
      const moduleKey = 'Test';
@@ -178,7 +178,7 @@ describe('MiddlewareModule', () => {
      );
      sinon
        .stub(stubContainer, 'getModuleByKey')
-        .callsFake(() => new Module(class {}, [], stubContainer));
+        .callsFake(() => new Module(class {}, stubContainer));
      middlewareModule['container'] = stubContainer;

      await middlewareModule.registerRouteMiddleware(
--- a/packages/core/test/nest-application.spec.ts
+++ b/packages/core/test/nest-application.spec.ts
@@ -0,0 +1,54 @@
+import { expect } from 'chai';
+import { NestApplication } from '../nest-application';
+import { ApplicationConfig } from '../application-config';
+import { NestContainer } from '../injector';
+import { NoopHttpAdapter } from './utils/noop-adapter.spec';
+
+describe('NestApplication', () => {
+  describe('Hybrid Application', () => {
+    class Interceptor {
+      public intercept(context, next) {
+        return next();
+      }
+    }
+    it('default should use new ApplicationConfig', () => {
+      const applicationConfig = new ApplicationConfig();
+      const container = new NestContainer(applicationConfig);
+      const instance = new NestApplication(
+        container,
+        new NoopHttpAdapter({}),
+        applicationConfig,
+        {},
+      );
+      instance.useGlobalInterceptors(new Interceptor());
+      const microservice = instance.connectMicroservice({});
+      expect((instance as any).config.getGlobalInterceptors().length).to.equal(
+        1,
+      );
+      expect(
+        (microservice as any).applicationConfig.getGlobalInterceptors().length,
+      ).to.equal(0);
+    });
+    it('should inherit existing ApplicationConfig', () => {
+      const applicationConfig = new ApplicationConfig();
+      const container = new NestContainer(applicationConfig);
+      const instance = new NestApplication(
+        container,
+        new NoopHttpAdapter({}),
+        applicationConfig,
+        {},
+      );
+      instance.useGlobalInterceptors(new Interceptor());
+      const microservice = instance.connectMicroservice(
+        {},
+        { inheritAppConfig: true },
+      );
+      expect((instance as any).config.getGlobalInterceptors().length).to.equal(
+        1,
+      );
+      expect(
+        (microservice as any).applicationConfig.getGlobalInterceptors().length,
+      ).to.equal(1);
+    });
+  });
+});
--- a/packages/core/test/scanner.spec.ts
+++ b/packages/core/test/scanner.spec.ts
@@ -12,6 +12,8 @@ import { NestContainer } from '../injector/container';
 import { InstanceWrapper } from '../injector/instance-wrapper';
 import { MetadataScanner } from '../metadata-scanner';
 import { DependenciesScanner } from '../scanner';
+import { UndefinedModuleException } from '../errors/exceptions/undefined-module.exception';
+import { InvalidModuleException } from '../errors/exceptions/invalid-module.exception';

 describe('DependenciesScanner', () => {
  class Guard {}
@@ -36,6 +38,16 @@ describe('DependenciesScanner', () => {
  })
  class TestModule {}

+  @Module({
+    imports: [undefined],
+  })
+  class UndefinedModule {}
+
+  @Module({
+    imports: [null],
+  })
+  class InvalidModule {}
+
  let scanner: DependenciesScanner;
  let mockContainer: sinon.SinonMock;
  let container: NestContainer;
@@ -432,4 +444,20 @@ describe('DependenciesScanner', () => {
      });
    });
  });
+  describe('scanForModules', () => {
+    it('should throw an exception when the imports array includes undefined', () => {
+      try {
+        scanner.scanForModules(UndefinedModule, [UndefinedModule]);
+      } catch (exception) {
+        expect(exception instanceof UndefinedModuleException).to.be.true;
+      }
+    });
+    it('should throw an exception when the imports array includes an invalid value', () => {
+      try {
+        scanner.scanForModules(InvalidModule, [InvalidModule]);
+      } catch (exception) {
+        expect(exception instanceof InvalidModuleException).to.be.true;
+      }
+    });
+  });
 });
--- a/packages/microservices/Readme.md
+++ b/packages/microservices/Readme.md
@@ -38,6 +38,14 @@ Nest is a framework for building efficient, scalable <a href="http://nodejs.org"
 * To check out the [guide](https://docs.nestjs.com), visit [docs.nestjs.com](https://docs.nestjs.com). :books:
 * 要查看中文 [指南](readme_zh.md), 请访问 [docs.nestjs.cn](https://docs.nestjs.cn). :books:

+## Questions
+
+For questions and support please use the official [Discord channel](https://discord.gg/G7Qnnhy). The issue list of this repo is **exclusively** for bug reports and feature requests.
+
+## Issues
+
+Please make sure to read the [Issue Reporting Checklist](https://github.com/nestjs/nest/blob/master/CONTRIBUTING.md#-submitting-an-issue) before opening an issue. Issues not conforming to the guidelines may be closed immediately.
+
 ## Consulting

 With official support, you can get expert help straight from Nest core team. We provide dedicated technical support, migration strategies, advice on best practices (and design decisions), PR reviews, and team augmentation. Read more about [support here](https://enterprise.nestjs.com).
@@ -48,30 +56,35 @@ Nest is an MIT-licensed open source project. It can grow thanks to the sponsors

 #### Principal Sponsor

-<a href="https://valor-software.com/" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="320" /></a>
+<a href="https://valor-software.com/" target="_blank"><img src="https://docs.nestjs.com/assets/sponsors/valor-software.png" width="220" /></a>

 #### Silver Sponsors
-<a href="https://neoteric.eu/" target="_blank"><img src="https://nestjs.com/img/neoteric-cut.png" width="120" valign="middle" /></a> &nbsp;
-  <a href="http://gojob.com" target="_blank"><img src="http://nestjs.com/img/gojob-logo.png" valign="middle" height="95" /></a> &nbsp; 
-    <a href="https://trilon.io" target="_blank"><img src="https://nestjs.com/img/trilon.svg" width="150" valign="middle" /></a> &nbsp;
-<a href="http://www.leogistics.com" target="_blank"><img src="https://nestjs.com/img/leogistics-logo.jpeg" width="150" valign="middle" /></a>
+
+<table style="text-align:center;"><tr><td>
+<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>

 #### Sponsors

-<a href="https://www.swingdev.io" target="_blank"><img src="https://nestjs.com/img/swingdev-logo.svg#1" width="110" valign="middle" /> </a> &nbsp; <a href="https://blueanchor.io/" target="_blank"><img src="https://nestjs.com/img/blueanchor.png" width="150" valign="middle" /></a> &nbsp;
-<a href="https://www.novologic.com/" target="_blank"><img src="https://nestjs.com/img/novologic.png" width="110" valign="middle" /></a> &nbsp; <a href="https://hostpresto.com" target="_blank"><img src="https://nestjs.com/img/hostpresto.png" height="24" valign="middle" /></a>
-<a href="https://ever.co/" target="_blank"><img src="https://nestjs.com/img/ever-logo.png" height="14" valign="middle" /></a>  &nbsp; 
-<a href="https://buddy.works/" target="_blank"><img src="https://nestjs.com/img/buddy-logo.svg" height="25" valign="middle" /></a> &nbsp;
-<a href="https://blokt.com" target="_blank"><img src="https://nestjs.com/img/blokt-logo.png" height="25" valign="middle" /></a>  &nbsp;  <a href="https://genuinebee.com/" target="_blank"><img src="https://nestjs.com/img/genuinebee.svg" height="27" valign="middle" /></a> &nbsp; <a href="http://architectnow.net/" target="_blank"><img src="https://nestjs.com/img/architectnow.png" height="20" valign="middle" /></a> &nbsp; <a href="https://quander.io/" target="_blank"><img src="https://nestjs.com/img/quander.png" height="22" valign="middle" /></a> &nbsp; <a href="https://mantro.net/" target="_blank"><img src="https://nestjs.com/img/mantro-logo.svg" height="19" valign="middle" /></a> &nbsp; <a href="https://triplebyte.com/" target="_blank"><img src="https://nestjs.com/img/triplebyte.png" height="20" valign="middle" /></a> &nbsp; 
-<a href="https://reposit.co.uk/" target="_blank"><img src="https://nestjs.com/img/reposit-logo.png" height="18" valign="middle" /></a> &nbsp; &nbsp;
-<a href="https://nearpod.com/" target="_blank"><img src="https://nestjs.com/img/nearpod-logo.svg" width="100" valign="middle" /></a> &nbsp;
-<a href="https://clay.global/" target="_blank"><img src="https://nestjs.com/img/clay-logo.svg" width="75" valign="middle" /></a> &nbsp;
-<a href="https://firesticktricks.com" target="_blank"><img src="https://nestjs.com/img/firesticktricks-logo.png" width="120" valign="middle" /></a> &nbsp;
-<a href="https://www.codeguesser.co.uk" target="_blank"><img src="https://nestjs.com/img/codeguesser-logo.svg" width="120" valign="middle" /></a> &nbsp;
-<a href="https://tekhattan.com" target="_blank"><img src="https://nestjs.com/img/tekhattan-logo.png" width="110" valign="middle" /></a> &nbsp;
-<a href="https://f-a.nz/" target="_blank"><img src="https://nestjs.com/img/franz.svg" width="80" valign="middle" /></a> &nbsp;
-<a href="https://sparkfabrik.com/" target="_blank"><img src="https://nestjs.com/img/sparkfabrik-logo.png" width="120" valign="middle" /></a>
-
+<table><tr><td align="center" valign="middle">
+<a href="https://www.swingdev.io" target="_blank"><img src="https://nestjs.com/img/swingdev-logo.svg#1" width="110" valign="middle" /> </a></td><td align="center" valign="middle">
+<a href="https://www.novologic.com/" target="_blank"><img src="https://nestjs.com/img/novologic.png" width="110" valign="middle" /></a> </td><td align="center" valign="middle">
+<a href="https://ever.co/" target="_blank"><img src="https://nestjs.com/img/ever-logo.png" width="72" valign="middle" /></a>  </td><td align="center" valign="middle">
+<a href="https://blokt.com" target="_blank"><img src="https://nestjs.com/img/blokt-logo.png" width="120" valign="middle" /></a>  </td><td align="center" valign="middle"> 
+  <a href="http://architectnow.net/" target="_blank"><img src="https://nestjs.com/img/architectnow.png" width="125" valign="middle" /></a> </td><td align="center" valign="middle">
+  <a href="https://quander.io/" target="_blank"><img src="https://nestjs.com/img/quander.png" width="100" valign="middle" /></a> </td></tr><tr><td align="center" valign="middle">
+  <a href="https://mantro.net/" target="_blank"><img src="https://nestjs.com/img/mantro-logo.svg" width="95" valign="middle" /></a> </td><td align="center" valign="middle">
+  <a href="https://triplebyte.com/" target="_blank"><img src="https://nestjs.com/img/triplebyte.png" width="107" valign="middle" /></a> </td><td align="center" valign="middle">
+<a href="https://reposit.co.uk/" target="_blank"><img src="https://nestjs.com/img/reposit-logo.png" width="71" valign="middle" /></a></td><td align="center" valign="middle">
+<a href="https://nearpod.com/" target="_blank"><img src="https://nestjs.com/img/nearpod-logo.svg" width="100" valign="middle" /></a> </td><td align="center" valign="middle">
+<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></tr></table>

 ## Backers

--- a/packages/microservices/client/client-grpc.ts
+++ b/packages/microservices/client/client-grpc.ts
@@ -89,22 +89,14 @@ export class ClientGrpcProxy extends ClientProxy implements ClientGrpc {
    }

    const keepaliveOptions = this.getKeepaliveOptions();
-    const options: Record<string, unknown> = isObject(this.options)
-      ? {
-          ...this.options,
-          ...maxMessageLengthOptions,
-          ...keepaliveOptions,
-          loader: '',
-        }
-      : {
-          ...maxMessageLengthOptions,
-        };
+    const options: Record<string, string | number> = {
+      ...(this.options.channelOptions || {}),
+      ...maxMessageLengthOptions,
+      ...keepaliveOptions,
+    };

    const credentials =
-      options.credentials || grpcPackage.credentials.createInsecure();
-
-    delete options.credentials;
-    delete options.keepalive;
+      this.options.credentials || grpcPackage.credentials.createInsecure();

    const grpcClient = new clientRef[name](this.url, credentials, options);
    this.clients.set(name, grpcClient);
@@ -134,7 +126,7 @@ export class ClientGrpcProxy extends ClientProxy implements ClientGrpc {
      this.options.keepalive,
    )) {
      const key = keepaliveKeys[optionKey];
-      if (!key) {
+      if (key === undefined) {
        continue;
      }
      keepaliveOptions[key] = optionValue;
--- a/packages/microservices/client/client-kafka.ts
+++ b/packages/microservices/client/client-kafka.ts
@@ -93,11 +93,18 @@ export class ClientKafka extends ClientProxy {
      return this.producer;
    }
    this.client = this.createClient();
+
+    const partitionAssigners = [
+      (
+        config: ConstructorParameters<
+          typeof KafkaRoundRobinPartitionAssigner
+        >[0],
+      ) => new KafkaRoundRobinPartitionAssigner(config),
+    ] as any[];
+
    const consumerOptions = Object.assign(
      {
-        partitionAssigners: [
-          (config: any) => new KafkaRoundRobinPartitionAssigner(config),
-        ],
+        partitionAssigners,
      },
      this.options.consumer || {},
      {
--- a/packages/microservices/client/client-redis.ts
+++ b/packages/microservices/client/client-redis.ts
@@ -93,11 +93,11 @@ export class ClientRedis extends ClientProxy {
  }

  public getClientOptions(error$: Subject<Error>): Partial<ClientOpts> {
-    // eslint-disable-next-line @typescript-eslint/camelcase
    const retry_strategy = (options: RetryStrategyOptions) =>
      this.createRetryStrategy(options, error$);
+
    return {
-      // eslint-disable-next-line @typescript-eslint/camelcase
+      ...(this.options || {}),
      retry_strategy,
    };
  }
--- a/packages/microservices/constants.ts
+++ b/packages/microservices/constants.ts
@@ -19,6 +19,7 @@ export const SUBSCRIBE = 'subscribe';
 export const CANCEL_EVENT = 'cancelled';

 export const PATTERN_METADATA = 'microservices:pattern';
+export const TRANSPORT_METADATA = 'microservices:transport';
 export const CLIENT_CONFIGURATION_METADATA = 'microservices:client';
 export const PATTERN_HANDLER_METADATA = 'microservices:handler_type';
 export const CLIENT_METADATA = 'microservices:is_client_instance';
--- a/Show More
+++ b/Show More