@nestjs/cqrs 11.0.2 → 12.0.0

package/dist/exceptions/index.d.ts

@@ -1,7 +1,7 @@
-export * from './command-not-found.exception';
-export * from './invalid-command-handler.exception';
-export * from './invalid-events-handler.exception';
-export * from './invalid-query-handler.exception';
-export * from './invalid-saga.exception';
-export * from './query-not-found.exception';
-export * from './unsupported-saga-scope.exception';
+export * from './command-not-found.exception.js';
+export * from './invalid-command-handler.exception.js';
+export * from './invalid-events-handler.exception.js';
+export * from './invalid-query-handler.exception.js';
+export * from './invalid-saga.exception.js';
+export * from './query-not-found.exception.js';
+export * from './unsupported-saga-scope.exception.js';

package/dist/exceptions/index.js

@@ -1,23 +1,7 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./command-not-found.exception"), exports);
-__exportStar(require("./invalid-command-handler.exception"), exports);
-__exportStar(require("./invalid-events-handler.exception"), exports);
-__exportStar(require("./invalid-query-handler.exception"), exports);
-__exportStar(require("./invalid-saga.exception"), exports);
-__exportStar(require("./query-not-found.exception"), exports);
-__exportStar(require("./unsupported-saga-scope.exception"), exports);
+export * from './command-not-found.exception.js';
+export * from './invalid-command-handler.exception.js';
+export * from './invalid-events-handler.exception.js';
+export * from './invalid-query-handler.exception.js';
+export * from './invalid-saga.exception.js';
+export * from './query-not-found.exception.js';
+export * from './unsupported-saga-scope.exception.js';

package/dist/exceptions/invalid-command-handler.exception.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @publicApi
+ */
 export declare class InvalidCommandHandlerException extends Error {
     constructor();
 }

package/dist/exceptions/invalid-command-handler.exception.js

@@ -1,9 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InvalidCommandHandlerException = void 0;
-class InvalidCommandHandlerException extends Error {
+/**
+ * @publicApi
+ */
+export class InvalidCommandHandlerException extends Error {
     constructor() {
         super(`An invalid command handler has been provided. Please ensure that the provided handler is a class annotated with @CommandHandler and contains an 'execute' method.`);
     }
 }
-exports.InvalidCommandHandlerException = InvalidCommandHandlerException;

package/dist/exceptions/invalid-events-handler.exception.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @publicApi
+ */
 export declare class InvalidEventsHandlerException extends Error {
     constructor();
 }

package/dist/exceptions/invalid-events-handler.exception.js

@@ -1,9 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InvalidEventsHandlerException = void 0;
-class InvalidEventsHandlerException extends Error {
+/**
+ * @publicApi
+ */
+export class InvalidEventsHandlerException extends Error {
     constructor() {
         super(`An invalid events handler has been provided. Please ensure that the provided handler is a class annotated with @EventsHandler and contains a 'handle' method.`);
     }
 }
-exports.InvalidEventsHandlerException = InvalidEventsHandlerException;

package/dist/exceptions/invalid-query-handler.exception.js

@@ -1,9 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InvalidQueryHandlerException = void 0;
-class InvalidQueryHandlerException extends Error {
+export class InvalidQueryHandlerException extends Error {
     constructor() {
         super(`An invalid query handler has been provided. Please ensure that the provided handler is a class annotated with @QueryHandler and contains an 'execute' method.`);
     }
 }
-exports.InvalidQueryHandlerException = InvalidQueryHandlerException;

package/dist/exceptions/invalid-saga.exception.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @publicApi
+ */
 export declare class InvalidSagaException extends Error {
     constructor();
 }

package/dist/exceptions/invalid-saga.exception.js

@@ -1,9 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InvalidSagaException = void 0;
-class InvalidSagaException extends Error {
+/**
+ * @publicApi
+ */
+export class InvalidSagaException extends Error {
     constructor() {
         super(`Invalid saga. Each saga should return Observable stream.`);
     }
 }
-exports.InvalidSagaException = InvalidSagaException;

package/dist/exceptions/query-not-found.exception.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @publicApi
+ */
 export declare class QueryHandlerNotFoundException extends Error {
     constructor(queryName: string);
 }

package/dist/exceptions/query-not-found.exception.js

@@ -1,9 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.QueryHandlerNotFoundException = void 0;
-class QueryHandlerNotFoundException extends Error {
+/**
+ * @publicApi
+ */
+export class QueryHandlerNotFoundException extends Error {
     constructor(queryName) {
         super(`No handler found for the query: "${queryName}"`);
     }
 }
-exports.QueryHandlerNotFoundException = QueryHandlerNotFoundException;

package/dist/exceptions/unsupported-saga-scope.exception.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @publicApi
+ */
 export declare class UnsupportedSagaScopeException extends Error {
     constructor();
 }

package/dist/exceptions/unsupported-saga-scope.exception.js

@@ -1,9 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UnsupportedSagaScopeException = void 0;
-class UnsupportedSagaScopeException extends Error {
+/**
+ * @publicApi
+ */
+export class UnsupportedSagaScopeException extends Error {
     constructor() {
         super(`Request-scoped saga hosts are not supported. Instead, you should retrieve async-context-specific instances within the saga itself, using the "ModuleRef" provider.`);
     }
 }
-exports.UnsupportedSagaScopeException = UnsupportedSagaScopeException;

package/dist/helpers/default-command-pubsub.d.ts

@@ -1,5 +1,5 @@
 import { Subject } from 'rxjs';
-import { ICommand, ICommandPublisher } from '../interfaces';
+import { ICommand, ICommandPublisher } from '../interfaces/index.js';
 export declare class DefaultCommandPubSub<CommandBase extends ICommand> implements ICommandPublisher<CommandBase> {
     private subject$;
     constructor(subject$: Subject<CommandBase>);

package/dist/helpers/default-command-pubsub.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DefaultCommandPubSub = void 0;
-class DefaultCommandPubSub {
+export class DefaultCommandPubSub {
     constructor(subject$) {
         this.subject$ = subject$;
     }
@@ -9,4 +6,3 @@ class DefaultCommandPubSub {
         this.subject$.next(command);
     }
 }
-exports.DefaultCommandPubSub = DefaultCommandPubSub;

package/dist/helpers/default-event-id-provider.d.ts

@@ -1,5 +1,5 @@
 import { Type } from '@nestjs/common';
-import { EventIdProvider, IEvent } from '../interfaces';
+import { EventIdProvider, IEvent } from '../interfaces/index.js';
 declare class DefaultEventIdProvider<EventBase extends IEvent = IEvent> implements EventIdProvider<EventBase> {
     getEventId(event: Type<EventBase>): string | null;
 }

package/dist/helpers/default-event-id-provider.js

@@ -1,10 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultEventIdProvider = void 0;
-const constants_1 = require("../decorators/constants");
+import { EVENT_METADATA } from '../decorators/constants.js';
 class DefaultEventIdProvider {
     getEventId(event) {
-        return Reflect.getMetadata(constants_1.EVENT_METADATA, event)?.id ?? null;
+        return Reflect.getMetadata(EVENT_METADATA, event)?.id ?? null;
     }
 }
-exports.defaultEventIdProvider = new DefaultEventIdProvider();
+export const defaultEventIdProvider = new DefaultEventIdProvider();

package/dist/helpers/default-pubsub.d.ts

@@ -1,5 +1,5 @@
 import { Subject } from 'rxjs';
-import { IEvent, IEventPublisher, IMessageSource } from '../interfaces';
+import { IEvent, IEventPublisher, IMessageSource } from '../interfaces/index.js';
 export declare class DefaultPubSub<EventBase extends IEvent> implements IEventPublisher<EventBase>, IMessageSource<EventBase> {
     private subject$;
     constructor(subject$: Subject<EventBase>);

package/dist/helpers/default-pubsub.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DefaultPubSub = void 0;
-class DefaultPubSub {
+export class DefaultPubSub {
     constructor(subject$) {
         this.subject$ = subject$;
     }
@@ -12,4 +9,3 @@ class DefaultPubSub {
         this.subject$ = subject;
     }
 }
-exports.DefaultPubSub = DefaultPubSub;

package/dist/helpers/default-query-pubsub.d.ts

@@ -1,5 +1,5 @@
 import { Subject } from 'rxjs';
-import { IQuery, IQueryPublisher } from '../interfaces';
+import { IQuery, IQueryPublisher } from '../interfaces/index.js';
 export declare class DefaultQueryPubSub<QueryBase extends IQuery> implements IQueryPublisher<QueryBase> {
     private subject$;
     constructor(subject$: Subject<QueryBase>);

package/dist/helpers/default-query-pubsub.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DefaultQueryPubSub = void 0;
-class DefaultQueryPubSub {
+export class DefaultQueryPubSub {
     constructor(subject$) {
         this.subject$ = subject$;
     }
@@ -9,4 +6,3 @@ class DefaultQueryPubSub {
         this.subject$.next(query);
     }
 }
-exports.DefaultQueryPubSub = DefaultQueryPubSub;

package/dist/helpers/default-unhandled-exception-pubsub.d.ts

@@ -1,5 +1,5 @@
 import { Subject } from 'rxjs';
-import { ICommand, IEvent, IUnhandledExceptionPublisher, UnhandledExceptionInfo } from '../interfaces';
+import { ICommand, IEvent, IUnhandledExceptionPublisher, UnhandledExceptionInfo } from '../interfaces/index.js';
 /**
  * Default implementation of the `IUnhandledExceptionPublisher` interface.
  */

package/dist/helpers/default-unhandled-exception-pubsub.js

@@ -1,10 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DefaultUnhandledExceptionPubSub = void 0;
 /**
  * Default implementation of the `IUnhandledExceptionPublisher` interface.
  */
-class DefaultUnhandledExceptionPubSub {
+export class DefaultUnhandledExceptionPubSub {
     constructor(subject$) {
         this.subject$ = subject$;
     }
@@ -12,4 +9,3 @@ class DefaultUnhandledExceptionPubSub {
         this.subject$.next(info);
     }
 }
-exports.DefaultUnhandledExceptionPubSub = DefaultUnhandledExceptionPubSub;

package/dist/index.d.ts

@@ -1,14 +1,15 @@
-export * from './aggregate-root';
-export * from './classes';
-export * from './command-bus';
-export * from './cqrs.module';
-export * from './decorators';
-export * from './event-bus';
-export * from './event-publisher';
-export * from './exceptions';
-export * from './interfaces';
-export * from './operators';
-export * from './query-bus';
-export * from './scopes';
-export * from './unhandled-exception-bus';
-export * from './utils';
+export * from './aggregate-root.js';
+export * from './classes/index.js';
+export * from './command-bus.js';
+export * from './cqrs.module.js';
+export * from './decorators/index.js';
+export * from './event-bus.js';
+export * from './event-publisher.js';
+export * from './exceptions/index.js';
+export * from './interfaces/index.js';
+export * from './operators/index.js';
+export * from './query-bus.js';
+export * from './scopes/index.js';
+export * from './unhandled-exception-bus.js';
+export * from './utils/index.js';
+export * from './mixins/index.js';

package/dist/index.js

@@ -1,36 +1,21 @@
-"use strict";
 /*
  * Nest CQRS Module
  * Copyright(c) 2017-... Kamil Mysliwiec
  * www.kamilmysliwiec.com
  * MIT Licensed
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./aggregate-root"), exports);
-__exportStar(require("./classes"), exports);
-__exportStar(require("./command-bus"), exports);
-__exportStar(require("./cqrs.module"), exports);
-__exportStar(require("./decorators"), exports);
-__exportStar(require("./event-bus"), exports);
-__exportStar(require("./event-publisher"), exports);
-__exportStar(require("./exceptions"), exports);
-__exportStar(require("./interfaces"), exports);
-__exportStar(require("./operators"), exports);
-__exportStar(require("./query-bus"), exports);
-__exportStar(require("./scopes"), exports);
-__exportStar(require("./unhandled-exception-bus"), exports);
-__exportStar(require("./utils"), exports);
+export * from './aggregate-root.js';
+export * from './classes/index.js';
+export * from './command-bus.js';
+export * from './cqrs.module.js';
+export * from './decorators/index.js';
+export * from './event-bus.js';
+export * from './event-publisher.js';
+export * from './exceptions/index.js';
+export * from './interfaces/index.js';
+export * from './operators/index.js';
+export * from './query-bus.js';
+export * from './scopes/index.js';
+export * from './unhandled-exception-bus.js';
+export * from './utils/index.js';
+export * from './mixins/index.js';

package/dist/interfaces/aggregate-root.interface.d.ts

@@ -0,0 +1,53 @@
+import type { IEvent } from './events/event.interface.js';
+/**
+ * Represents the aggregate root interface with event sourcing capabilities.
+ */
+export interface IAggregateRoot<EventBase extends IEvent = IEvent> {
+    /**
+     * Sets or gets the auto-commit flag.
+     */
+    autoCommit: boolean;
+    /**
+     * Publishes a single event.
+     * @param event The event to publish.
+     */
+    publish<T extends EventBase = EventBase>(event: T): void;
+    /**
+     * Publishes multiple events.
+     * @param events The events to publish.
+     */
+    publishAll<T extends EventBase = EventBase>(events: T[]): void;
+    /**
+     * Commits all uncommitted events.
+     */
+    commit(): void;
+    /**
+     * Uncommits all events.
+     */
+    uncommit(): void;
+    /**
+     * Gets all uncommitted events.
+     * @returns An array of uncommitted events.
+     */
+    getUncommittedEvents(): EventBase[];
+    /**
+     * Loads aggregate root state from event history.
+     * @param history The event history to load.
+     */
+    loadFromHistory(history: EventBase[]): void;
+    /**
+     * Applies an event to the aggregate root.
+     * @param event The event to apply.
+     * @param isFromHistory Optional flag indicating if the event is from history.
+     */
+    apply<T extends EventBase = EventBase>(event: T, isFromHistory?: boolean): void;
+    /**
+     * Applies an event to the aggregate root with options.
+     * @param event The event to apply.
+     * @param options Options for applying the event.
+     */
+    apply<T extends EventBase = EventBase>(event: T, options?: {
+        fromHistory?: boolean;
+        skipHandler?: boolean;
+    }): void;
+}

package/dist/interfaces/aggregate-root.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/commands/command-bus.interface.d.ts

@@ -1,8 +1,10 @@
-import { Command } from '../../classes';
-import { AsyncContext } from '../../scopes/async.context';
-import { ICommand } from './command.interface';
+import { Command } from '../../classes/index.js';
+import { AsyncContext } from '../../scopes/async.context.js';
+import { ICommand } from './command.interface.js';
 /**
  * Represents a command bus.
+ *
+ * @publicApi
  */
 export interface ICommandBus<CommandBase extends ICommand = ICommand> {
     /**

package/dist/interfaces/commands/command-bus.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/interfaces/commands/command-handler.interface.d.ts

@@ -1,8 +1,10 @@
-import { Command } from '../../classes';
-import { ICommand } from './command.interface';
+import { Command } from '../../classes/index.js';
+import { ICommand } from './command.interface.js';
 /**
  * Represents a command handler.
  * Command handlers are used to execute commands.
+ *
+ * @publicApi
  */
 export type ICommandHandler<TCommand extends ICommand = any, TResult = any> = TCommand extends Command<infer InferredCommandResult> ? {
     /**

package/dist/interfaces/commands/command-handler.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/interfaces/commands/command-metadata.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/interfaces/commands/command-publisher.interface.d.ts

@@ -1,4 +1,9 @@
-import { ICommand } from './command.interface';
+import { ICommand } from './command.interface.js';
+/**
+ * Represents a command publisher.
+ *
+ * @publicApi
+ */
 export interface ICommandPublisher<CommandBase extends ICommand = ICommand> {
     publish<T extends CommandBase = CommandBase>(command: T): any;
 }

package/dist/interfaces/commands/command-publisher.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/interfaces/commands/command.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

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

@@ -1,10 +1,12 @@
-import { ICommandPublisher } from './commands/command-publisher.interface';
-import { EventIdProvider } from './events/event-id-provider.interface';
-import { IEventPublisher } from './events/event-publisher.interface';
-import { IUnhandledExceptionPublisher } from './exceptions/unhandled-exception-publisher.interface';
-import { IQueryPublisher } from './queries/query-publisher.interface';
+import { ICommandPublisher } from './commands/command-publisher.interface.js';
+import { EventIdProvider } from './events/event-id-provider.interface.js';
+import { IEventPublisher } from './events/event-publisher.interface.js';
+import { IUnhandledExceptionPublisher } from './exceptions/unhandled-exception-publisher.interface.js';
+import { IQueryPublisher } from './queries/query-publisher.interface.js';
 /**
  * Options for the CqrsModule.
+ *
+ * @publicApi
  */
 export interface CqrsModuleOptions {
     /**
@@ -39,9 +41,19 @@ export interface CqrsModuleOptions {
     rethrowUnhandled?: boolean;
 }
 import { Provider, Type } from '@nestjs/common';
+/**
+ * Options for the CqrsModuleOptionsFactory.
+ *
+ * @publicApi
+ */
 export interface CqrsModuleOptionsFactory {
     createCqrsOptions(): Promise<CqrsModuleOptions> | CqrsModuleOptions;
 }
+/**
+ * Options for the CqrsModuleAsyncOptions.
+ *
+ * @publicApi
+ */
 export interface CqrsModuleAsyncOptions {
     imports?: any[];
     useExisting?: Type<CqrsModuleOptionsFactory>;

package/dist/interfaces/cqrs-module-options.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

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

@@ -1,5 +1,5 @@
-import { AsyncContext } from '../../scopes/async.context';
-import { IEvent } from './event.interface';
+import { AsyncContext } from '../../scopes/async.context.js';
+import { IEvent } from './event.interface.js';
 /**
  * Represents an event bus.
  */

package/dist/interfaces/events/event-bus.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

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

@@ -1,4 +1,4 @@
-import { IEvent } from './event.interface';
+import { IEvent } from './event.interface.js';
 /**
  * Represents an event handler.
  */

package/dist/interfaces/events/event-handler.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/interfaces/events/event-id-provider.interface.d.ts

@@ -1,5 +1,5 @@
 import { Type } from '@nestjs/common';
-import { IEvent } from './event.interface';
+import { IEvent } from './event.interface.js';
 export interface EventIdProvider<EventBase extends IEvent = IEvent> {
     /**
      * Retrieves the unique identifier for the given event instance.

package/dist/interfaces/events/event-id-provider.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

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

@@ -1,5 +1,5 @@
-import { AsyncContext } from '../../scopes';
-import { IEvent } from './event.interface';
+import { AsyncContext } from '../../scopes/index.js';
+import { IEvent } from './event.interface.js';
 export interface IEventPublisher<EventBase extends IEvent = IEvent> {
     /**
      * Publishes an event.

package/dist/interfaces/events/event-publisher.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/interfaces/events/event.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/interfaces/events/message-source.interface.d.ts

@@ -1,5 +1,5 @@
 import { Subject } from 'rxjs';
-import { IEvent } from './event.interface';
+import { IEvent } from './event.interface.js';
 export interface IMessageSource<EventBase extends IEvent = IEvent> {
     bridgeEventsTo<T extends EventBase>(subject: Subject<T>): any;
 }

package/dist/interfaces/events/message-source.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/interfaces/exceptions/unhandled-exception-info.interface.d.ts

@@ -1,5 +1,5 @@
-import { ICommand } from '../commands/command.interface';
-import { IEvent } from '../events/event.interface';
+import { ICommand } from '../commands/command.interface.js';
+import { IEvent } from '../events/event.interface.js';
 /**
  * Represents an unhandled exception.
  */