@nestjs/cqrs 10.2.3 → 10.2.4

package/dist/aggregate-root.d.ts

@@ -58,7 +58,21 @@ export declare abstract class AggregateRoot<EventBase extends IEvent = IEvent> {
      * @param event The event to apply.
      * @param isFromHistory Whether the event is from history.
      */
-    apply<T extends EventBase = EventBase>(event: T, isFromHistory?: boolean): void;
+    apply<T extends EventBase = EventBase>(event: T, isFromHistory: boolean): void;
+    /**
+     * Applies an event.
+     * If auto commit is enabled, the event will be published immediately (note: must be merged with the publisher context in order to work).
+     * Otherwise, the event will be stored in the internal events array, and will be published when the commit method is called.
+     * Also, the corresponding event handler will be called (if exists).
+     * For example, if the event is called UserCreatedEvent, the "onUserCreatedEvent" method will be called.
+     *
+     * @param event The event to apply.
+     * @param options The options.
+     */
+    apply<T extends EventBase = EventBase>(event: T, options: {
+        fromHistory?: boolean;
+        skipHandler?: boolean;
+    }): void;
     protected getEventHandler<T extends EventBase = EventBase>(event: T): Type<IEventHandler> | undefined;
     protected getEventName(event: any): string;
 }

package/dist/aggregate-root.js

@@ -65,23 +65,21 @@ class AggregateRoot {
     loadFromHistory(history) {
         history.forEach((event) => this.apply(event, true));
     }
-    /**
-     * Applies an event.
-     * If auto commit is enabled, the event will be published immediately (note: must be merged with the publisher context in order to work).
-     * Otherwise, the event will be stored in the internal events array, and will be published when the commit method is called.
-     * Also, the corresponding event handler will be called (if exists).
-     * For example, if the event is called UserCreatedEvent, the "onUserCreatedEvent" method will be called.
-     *
-     * @param event The event to apply.
-     * @param isFromHistory Whether the event is from history.
-     */
-    apply(event, isFromHistory = false) {
+    apply(event, optionsOrIsFromHistory = {}) {
+        const isFromHistory = (typeof optionsOrIsFromHistory === 'boolean'
+            ? optionsOrIsFromHistory
+            : optionsOrIsFromHistory.fromHistory) ?? false;
+        const skipHandler = typeof optionsOrIsFromHistory === 'boolean'
+            ? false
+            : optionsOrIsFromHistory.skipHandler;
         if (!isFromHistory && !this.autoCommit) {
             this[INTERNAL_EVENTS].push(event);
         }
         this.autoCommit && this.publish(event);
-        const handler = this.getEventHandler(event);
-        handler && handler.call(this, event);
+        if (!skipHandler) {
+            const handler = this.getEventHandler(event);
+            handler && handler.call(this, event);
+        }
     }
     getEventHandler(event) {
         const handler = `on${this.getEventName(event)}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/cqrs",
-  "version": "10.2.3",
+  "version": "10.2.4",
   "description": "A lightweight CQRS module for Nest framework (node.js)",
   "license": "MIT",
   "url": "https://github.com/nestjs/cqrs#readme",
@@ -25,7 +25,7 @@
     "@commitlint/config-angular": "17.6.7",
     "@nestjs/common": "10.1.3",
     "@nestjs/core": "10.1.3",
-    "@types/node": "18.17.3",
+    "@types/node": "18.17.4",
     "@types/jest": "29.5.3",
     "@typescript-eslint/eslint-plugin": "6.3.0",
     "@typescript-eslint/parser": "6.3.0",