@nestjs/cqrs 10.0.3 → 10.2.0

package/dist/cqrs.module.d.ts

@@ -1,4 +1,4 @@
-import { OnApplicationBootstrap } from '@nestjs/common';
+import { DynamicModule, OnApplicationBootstrap } from '@nestjs/common';
 import { CommandBus } from './command-bus';
 import { EventBus } from './event-bus';
 import { IEvent } from './interfaces';
@@ -9,6 +9,11 @@ export declare class CqrsModule<EventBase extends IEvent = IEvent> implements On
     private readonly eventBus;
     private readonly commandBus;
     private readonly queryBus;
+    /**
+     * Registers the CQRS Module globally.
+     * @returns DynamicModule
+     */
+    static forRoot(): DynamicModule;
     constructor(explorerService: ExplorerService<EventBase>, eventBus: EventBus<EventBase>, commandBus: CommandBus, queryBus: QueryBus);
     onApplicationBootstrap(): void;
 }

package/dist/cqrs.module.js

@@ -8,6 +8,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+var CqrsModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CqrsModule = void 0;
 const common_1 = require("@nestjs/common");
@@ -17,13 +18,23 @@ const event_publisher_1 = require("./event-publisher");
 const query_bus_1 = require("./query-bus");
 const explorer_service_1 = require("./services/explorer.service");
 const unhandled_exception_bus_1 = require("./unhandled-exception-bus");
-let CqrsModule = class CqrsModule {
+let CqrsModule = CqrsModule_1 = class CqrsModule {
     constructor(explorerService, eventBus, commandBus, queryBus) {
         this.explorerService = explorerService;
         this.eventBus = eventBus;
         this.commandBus = commandBus;
         this.queryBus = queryBus;
     }
+    /**
+     * Registers the CQRS Module globally.
+     * @returns DynamicModule
+     */
+    static forRoot() {
+        return {
+            module: CqrsModule_1,
+            global: true,
+        };
+    }
     onApplicationBootstrap() {
         const { events, queries, sagas, commands } = this.explorerService.explore();
         this.eventBus.register(events);
@@ -32,7 +43,7 @@ let CqrsModule = class CqrsModule {
         this.eventBus.registerSagas(sagas);
     }
 };
-CqrsModule = __decorate([
+CqrsModule = CqrsModule_1 = __decorate([
     (0, common_1.Module)({
         providers: [
             command_bus_1.CommandBus,

package/dist/event-bus.d.ts

@@ -31,12 +31,12 @@ export declare class EventBus<EventBase extends IEvent = IEvent> extends Observa
      * Publishes an event.
      * @param event The event to publish.
      */
-    publish<T extends EventBase>(event: T): any;
+    publish<TEvent extends EventBase, TContext = unknown>(event: TEvent, context: TContext): any;
     /**
      * Publishes multiple events.
      * @param events The events to publish.
      */
-    publishAll<T extends EventBase>(events: T[]): any;
+    publishAll<TEvent extends EventBase, TContext = unknown>(events: TEvent[], context: TContext): any;
     bind(handler: IEventHandler<EventBase>, id: string): void;
     registerSagas(types?: Type<unknown>[]): void;
     register(handlers?: EventHandlerType<EventBase>[]): void;

package/dist/event-bus.js

@@ -55,18 +55,18 @@ let EventBus = EventBus_1 = class EventBus extends utils_1.ObservableBus {
      * Publishes an event.
      * @param event The event to publish.
      */
-    publish(event) {
-        return this._publisher.publish(event);
+    publish(event, context) {
+        return this._publisher.publish(event, context);
     }
     /**
      * Publishes multiple events.
      * @param events The events to publish.
      */
-    publishAll(events) {
+    publishAll(events, context) {
         if (this._publisher.publishAll) {
             return this._publisher.publishAll(events);
         }
-        return (events || []).map((event) => this._publisher.publish(event));
+        return (events || []).map((event) => this._publisher.publish(event, context));
     }
     bind(handler, id) {
         const stream$ = id ? this.ofEventId(id) : this.subject$;

package/dist/event-publisher.js

@@ -25,10 +25,10 @@ let EventPublisher = class EventPublisher {
         const eventBus = this.eventBus;
         return class extends metatype {
             publish(event) {
-                eventBus.publish(event);
+                eventBus.publish(event, this);
             }
             publishAll(events) {
-                eventBus.publishAll(events);
+                eventBus.publishAll(events, this);
             }
         };
     }
@@ -40,10 +40,10 @@ let EventPublisher = class EventPublisher {
     mergeObjectContext(object) {
         const eventBus = this.eventBus;
         object.publish = (event) => {
-            eventBus.publish(event);
+            eventBus.publish(event, object);
         };
         object.publishAll = (events) => {
-            eventBus.publishAll(events);
+            eventBus.publishAll(events, object);
         };
         return object;
     }

package/dist/interfaces/events/event-bus.interface.d.ts

@@ -6,11 +6,13 @@ export interface IEventBus<EventBase extends IEvent = IEvent> {
     /**
      * Publishes an event.
      * @param event The event to publish.
+     * @param context The context.
      */
-    publish<T extends EventBase>(event: T): any;
+    publish<TEvent extends EventBase, TContext = unknown>(event: TEvent, context?: TContext): any;
     /**
      * Publishes multiple events.
      * @param events The events to publish.
+     * @param context The context.
      */
-    publishAll(events: EventBase[]): any;
+    publishAll<TEvent extends EventBase, TContext = unknown>(events: TEvent[], context?: TContext): any;
 }

package/dist/interfaces/events/event-publisher.interface.d.ts

@@ -1,5 +1,15 @@
 import { IEvent } from './event.interface';
 export interface IEventPublisher<EventBase extends IEvent = IEvent> {
-    publish<T extends EventBase = EventBase>(event: T): any;
-    publishAll?<T extends EventBase = EventBase>(events: T[]): any;
+    /**
+     * Publishes an event.
+     * @param event The event to publish.
+     * @param context The context.
+     */
+    publish<TEvent extends EventBase, TContext = unknown>(event: TEvent, context?: TContext): any;
+    /**
+     * Publishes multiple events.
+     * @param events The events to publish.
+     * @param context The context.
+     */
+    publishAll?<TEvent extends EventBase, TContext = unknown>(events: TEvent[], context?: TContext): any;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/cqrs",
-  "version": "10.0.3",
+  "version": "10.2.0",
   "description": "A lightweight CQRS module for Nest framework (node.js)",
   "license": "MIT",
   "url": "https://github.com/nestjs/cqrs#readme",
@@ -23,19 +23,19 @@
   "devDependencies": {
     "@commitlint/cli": "17.6.7",
     "@commitlint/config-angular": "17.6.7",
-    "@nestjs/common": "10.1.1",
-    "@nestjs/core": "10.1.1",
-    "@types/node": "18.17.0",
+    "@nestjs/common": "10.1.3",
+    "@nestjs/core": "10.1.3",
+    "@types/node": "18.17.3",
     "@types/jest": "29.5.3",
-    "@typescript-eslint/eslint-plugin": "6.2.0",
-    "@typescript-eslint/parser": "6.2.0",
-    "eslint": "8.45.0",
-    "eslint-config-prettier": "8.8.0",
-    "eslint-plugin-import": "2.27.5",
+    "@typescript-eslint/eslint-plugin": "6.3.0",
+    "@typescript-eslint/parser": "6.3.0",
+    "eslint": "8.46.0",
+    "eslint-config-prettier": "9.0.0",
+    "eslint-plugin-import": "2.28.0",
     "husky": "8.0.3",
-    "jest": "29.6.1",
+    "jest": "29.6.2",
     "lint-staged": "13.2.3",
-    "prettier": "3.0.0",
+    "prettier": "3.0.1",
     "reflect-metadata": "0.1.13",
     "release-it": "16.1.3",
     "rxjs": "7.8.1",