@nestjs/cqrs 11.0.1 → 11.0.2

package/dist/cqrs.module.d.ts

@@ -1,7 +1,7 @@
 import { DynamicModule, OnApplicationBootstrap } from '@nestjs/common';
 import { CommandBus } from './command-bus';
 import { EventBus } from './event-bus';
-import { CqrsModuleOptions, IEvent } from './interfaces';
+import { CqrsModuleAsyncOptions, CqrsModuleOptions, IEvent } from './interfaces';
 import { QueryBus } from './query-bus';
 import { ExplorerService } from './services/explorer.service';
 export declare class CqrsModule<EventBase extends IEvent = IEvent> implements OnApplicationBootstrap {
@@ -9,12 +9,9 @@ export declare class CqrsModule<EventBase extends IEvent = IEvent> implements On
     private readonly eventBus;
     private readonly commandBus;
     private readonly queryBus;
-    /**
-     * Registers CQRS module globally.
-     * @param options CQRS module options.
-     * @returns A dynamic module.
-     */
     static forRoot(options?: CqrsModuleOptions): DynamicModule;
+    static forRootAsync(options: CqrsModuleAsyncOptions): DynamicModule;
+    private static createAsyncProviders;
     constructor(explorerService: ExplorerService<EventBase>, eventBus: EventBus<EventBase>, commandBus: CommandBus, queryBus: QueryBus);
     onApplicationBootstrap(): void;
 }

package/dist/cqrs.module.js

@@ -21,11 +21,6 @@ const explorer_service_1 = require("./services/explorer.service");
 const unhandled_exception_bus_1 = require("./unhandled-exception-bus");
 const aggregate_root_storage_1 = require("./storages/aggregate-root.storage");
 let CqrsModule = CqrsModule_1 = class CqrsModule {
-    /**
-     * Registers CQRS module globally.
-     * @param options CQRS module options.
-     * @returns A dynamic module.
-     */
     static forRoot(options) {
         return {
             module: CqrsModule_1,
@@ -38,6 +33,57 @@ let CqrsModule = CqrsModule_1 = class CqrsModule {
             global: true,
         };
     }
+    static forRootAsync(options) {
+        return {
+            module: CqrsModule_1,
+            global: true,
+            imports: options.imports || [],
+            providers: [...this.createAsyncProviders(options)],
+            exports: [constants_1.CQRS_MODULE_OPTIONS],
+        };
+    }
+    static createAsyncProviders(options) {
+        if (options.useValue) {
+            return [
+                {
+                    provide: constants_1.CQRS_MODULE_OPTIONS,
+                    useValue: options.useValue,
+                },
+            ];
+        }
+        if (options.useFactory) {
+            return [
+                {
+                    provide: constants_1.CQRS_MODULE_OPTIONS,
+                    useFactory: options.useFactory,
+                    inject: options.inject || [],
+                },
+            ];
+        }
+        if (options.useClass) {
+            return [
+                {
+                    provide: options.useClass,
+                    useClass: options.useClass,
+                },
+                {
+                    provide: constants_1.CQRS_MODULE_OPTIONS,
+                    useFactory: async (optionsFactory) => optionsFactory.createCqrsOptions(),
+                    inject: [options.useClass],
+                },
+            ];
+        }
+        if (options.useExisting) {
+            return [
+                {
+                    provide: constants_1.CQRS_MODULE_OPTIONS,
+                    useFactory: async (optionsFactory) => optionsFactory.createCqrsOptions(),
+                    inject: [options.useExisting],
+                },
+            ];
+        }
+        throw new Error('Invalid CqrsModuleAsyncOptions configuration. Provide useValue, useFactory, useClass, or useExisting.');
+    }
     constructor(explorerService, eventBus, commandBus, queryBus) {
         this.explorerService = explorerService;
         this.eventBus = eventBus;

package/dist/event-publisher.d.ts

@@ -10,14 +10,14 @@ export declare class EventPublisher<EventBase extends IEvent = IEvent> {
     constructor(eventBus: EventBus<EventBase>);
     /**
      * Merge the event publisher into the provided class.
-     * This is required to make `publish` and `publishAll` available on the `AgreggateRoot` class.
+     * This is required to make `publish` and `publishAll` available on the `AggregateRoot` class.
      * @param metatype The class to merge into.
      * @param asyncContext The async context (if scoped).
      */
     mergeClassContext<T extends Constructor<AggregateRoot<EventBase>>>(metatype: T, asyncContext?: AsyncContext): T;
     /**
      * Merge the event publisher into the provided object.
-     * This is required to make `publish` and `publishAll` available on the `AgreggateRoot` class instance.
+     * This is required to make `publish` and `publishAll` available on the `AggregateRoot` class instance.
      * @param object The object to merge into.
      * @param asyncContext The async context (if scoped).
      */

package/dist/event-publisher.js

@@ -18,7 +18,7 @@ let EventPublisher = class EventPublisher {
     }
     /**
      * Merge the event publisher into the provided class.
-     * This is required to make `publish` and `publishAll` available on the `AgreggateRoot` class.
+     * This is required to make `publish` and `publishAll` available on the `AggregateRoot` class.
      * @param metatype The class to merge into.
      * @param asyncContext The async context (if scoped).
      */
@@ -35,7 +35,7 @@ let EventPublisher = class EventPublisher {
     }
     /**
      * Merge the event publisher into the provided object.
-     * This is required to make `publish` and `publishAll` available on the `AgreggateRoot` class instance.
+     * This is required to make `publish` and `publishAll` available on the `AggregateRoot` class instance.
      * @param object The object to merge into.
      * @param asyncContext The async context (if scoped).
      */

package/dist/interfaces/cqrs-module-options.interface.d.ts

@@ -38,3 +38,16 @@ export interface CqrsModuleOptions {
      */
     rethrowUnhandled?: boolean;
 }
+import { Provider, Type } from '@nestjs/common';
+export interface CqrsModuleOptionsFactory {
+    createCqrsOptions(): Promise<CqrsModuleOptions> | CqrsModuleOptions;
+}
+export interface CqrsModuleAsyncOptions {
+    imports?: any[];
+    useExisting?: Type<CqrsModuleOptionsFactory>;
+    useClass?: Type<CqrsModuleOptionsFactory>;
+    useFactory?: (...args: any[]) => Promise<CqrsModuleOptions> | CqrsModuleOptions;
+    useValue?: CqrsModuleOptions;
+    inject?: any[];
+    extraProviders?: Provider[];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/cqrs",
-  "version": "11.0.1",
+  "version": "11.0.2",
   "description": "A lightweight CQRS module for Nest framework (node.js)",
   "license": "MIT",
   "url": "https://github.com/nestjs/cqrs#readme",
@@ -22,26 +22,26 @@
     "@commitlint/cli": "19.7.1",
     "@commitlint/config-angular": "19.7.1",
     "@eslint/eslintrc": "3.2.0",
-    "@eslint/js": "9.19.0",
-    "@nestjs/common": "11.0.7",
-    "@nestjs/core": "11.0.7",
-    "@nestjs/testing": "11.0.7",
+    "@eslint/js": "9.20.0",
+    "@nestjs/common": "11.0.9",
+    "@nestjs/core": "11.0.9",
+    "@nestjs/testing": "11.0.9",
     "@types/jest": "29.5.14",
-    "@types/node": "22.13.0",
-    "eslint": "9.19.0",
+    "@types/node": "22.13.1",
+    "eslint": "9.20.1",
     "eslint-config-prettier": "10.0.1",
     "eslint-plugin-prettier": "5.2.3",
     "globals": "15.14.0",
     "husky": "9.1.7",
     "jest": "29.7.0",
     "lint-staged": "15.4.3",
-    "prettier": "3.4.2",
+    "prettier": "3.5.0",
     "reflect-metadata": "0.2.2",
     "release-it": "18.1.2",
     "rxjs": "7.8.1",
     "ts-jest": "29.2.5",
     "typescript": "5.7.3",
-    "typescript-eslint": "8.22.0"
+    "typescript-eslint": "8.24.0"
   },
   "peerDependencies": {
     "@nestjs/common": "^10.0.0 || ^11.0.0",