feat(core): defer initialization connected microservice

packages/common/interfaces/microservices/nest-hybrid-application-options.interface.ts

@@ -3,4 +3,5 @@
  */
 export interface NestHybridApplicationOptions {
   inheritAppConfig?: boolean;
+  deferInitialization?: boolean;
 }

packages/core/nest-application.ts

@@ -232,9 +232,12 @@ export class NestApplication
       this.graphInspector,
       applicationConfig,
     );
-    instance.registerListeners();
-    instance.setIsInitialized(true);
-    instance.setIsInitHookCalled(true);
+
+    if (!hybridAppOptions.deferInitialization) {
+      instance.registerListeners();
+      instance.setIsInitialized(true);
+      instance.setIsInitHookCalled(true);
+    }
 
     this.microservices.push(instance);
     return instance;

packages/core/test/nest-application.spec.ts

@@ -59,6 +59,46 @@ describe('NestApplication', () => {
         (microservice as any).applicationConfig.getGlobalInterceptors().length,
       ).to.equal(1);
     });
+
+    it('should immediately initialize microservice by default', () => {
+      const applicationConfig = new ApplicationConfig();
+      const container = new NestContainer(applicationConfig);
+      const instance = new NestApplication(
+        container,
+        new NoopHttpAdapter({}),
+        applicationConfig,
+        new GraphInspector(container),
+        {},
+      );
+
+      const microservice = instance.connectMicroservice<MicroserviceOptions>(
+        {},
+        {},
+      );
+
+      expect((microservice as any).isInitialized).to.be.true;
+      expect((microservice as any).wasInitHookCalled).to.be.true;
+    });
+
+    it('should defer microservice initialization when deferInitialization is true', () => {
+      const applicationConfig = new ApplicationConfig();
+      const container = new NestContainer(applicationConfig);
+      const instance = new NestApplication(
+        container,
+        new NoopHttpAdapter({}),
+        applicationConfig,
+        new GraphInspector(container),
+        {},
+      );
+
+      const microservice = instance.connectMicroservice<MicroserviceOptions>(
+        {},
+        { deferInitialization: true },
+      );
+
+      expect((microservice as any).isInitialized).to.be.false;
+      expect((microservice as any).wasInitHookCalled).to.be.false;
+    });
   });
   describe('Global Prefix', () => {
     it('should get correct global prefix options', () => {