@rolandsall24/nest-mediator 0.6.0 → 0.7.0

package/dist/lib/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iEAA+C;AAC/C,+DAA6C;AAC7C,mEAAiD;AACjD,+DAA6C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iEAA+C;AAC/C,+DAA6C;AAC7C,mEAAiD;AACjD,+DAA6C;AAC7C,+DAA6C;AAC7C,mEAAiD"}

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

@@ -0,0 +1,25 @@
+import { Type } from '@nestjs/common';
+import { ICommand } from './command.interface.js';
+import { ICommandHandler } from './command-handler.interface.js';
+/**
+ * Interface for the command bus.
+ * Responsible for dispatching commands to their handlers.
+ */
+export interface ICommandBus {
+    /**
+     * Send a command to its handler
+     * @param command - The command instance
+     */
+    send<TCommand extends ICommand>(command: TCommand): Promise<void>;
+    /**
+     * Register a command handler
+     * @param command - The command class
+     * @param handler - The handler class
+     */
+    registerCommandHandler(command: Type<ICommand>, handler: Type<ICommandHandler<any>>): void;
+    /**
+     * Get registered command names (for debugging)
+     */
+    getRegisteredCommands(): string[];
+}
+//# sourceMappingURL=command-bus.interface.d.ts.map

package/dist/lib/interfaces/command-bus.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-bus.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/command-bus.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,IAAI,CAAC,QAAQ,SAAS,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;;;OAIG;IACH,sBAAsB,CACpB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,EACvB,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GAClC,IAAI,CAAC;IAER;;OAEG;IACH,qBAAqB,IAAI,MAAM,EAAE,CAAC;CACnC"}

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=command-bus.interface.js.map

package/dist/lib/interfaces/command-bus.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-bus.interface.js","sourceRoot":"","sources":["../../../src/lib/interfaces/command-bus.interface.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,35 @@
+import { Type } from '@nestjs/common';
+import { IEvent, EventPublishResult } from './event.interface.js';
+import { IEventConsumer } from './event-consumer.interface.js';
+import { EventCriticalityMetadata } from './event-criticality.interface.js';
+/**
+ * Interface for the event bus.
+ * Responsible for publishing events to their consumers.
+ */
+export interface IEventBus {
+    /**
+     * Publish an event to all its consumers
+     * @param event - The event instance
+     * @returns Promise with the publish result
+     */
+    publish<TEvent extends IEvent>(event: TEvent): Promise<EventPublishResult>;
+    /**
+     * Register an event consumer
+     * @param event - The event class
+     * @param handler - The consumer class
+     * @param criticalityMetadata - Criticality metadata
+     */
+    registerEventHandler(event: Type<IEvent>, handler: Type<IEventConsumer<any>>, criticalityMetadata?: EventCriticalityMetadata): void;
+    /**
+     * Get registered events and their consumers (for debugging)
+     */
+    getRegisteredEvents(): {
+        event: string;
+        handlers: {
+            name: string;
+            criticality: string;
+            order: number;
+        }[];
+    }[];
+}
+//# sourceMappingURL=event-bus.interface.d.ts.map

package/dist/lib/interfaces/event-bus.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/event-bus.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,OAAO,CAAC,MAAM,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE3E;;;;;OAKG;IACH,oBAAoB,CAClB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EACnB,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,EAClC,mBAAmB,CAAC,EAAE,wBAAwB,GAC7C,IAAI,CAAC;IAER;;OAEG;IACH,mBAAmB,IAAI;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAClE,EAAE,CAAC;CACL"}

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=event-bus.interface.js.map

package/dist/lib/interfaces/event-bus.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.interface.js","sourceRoot":"","sources":["../../../src/lib/interfaces/event-bus.interface.ts"],"names":[],"mappings":""}

package/dist/lib/interfaces/event-consumer.interface.d.ts

@@ -0,0 +1,64 @@
+import { IEvent } from './event.interface.js';
+/**
+ * Interface for event consumers.
+ * Event consumers subscribe to events and react to them.
+ * Multiple consumers can subscribe to the same event.
+ *
+ * Use this interface for non-critical consumers (fire-and-forget).
+ *
+ * @example
+ * ```typescript
+ * @EventHandler(UserCreatedEvent)
+ * @NonCritical()
+ * export class SendWelcomeEmailConsumer implements IEventConsumer<UserCreatedEvent> {
+ *   async handle(event: UserCreatedEvent): Promise<void> {
+ *     await this.emailService.sendWelcome(event.userEmail);
+ *   }
+ * }
+ * ```
+ */
+export interface IEventConsumer<TEvent extends IEvent> {
+    /**
+     * Handle the event
+     * @param event - The event instance
+     */
+    handle(event: TEvent): Promise<void>;
+}
+/**
+ * Interface for critical event consumers with optional compensation.
+ * Critical consumers run sequentially and can define a compensate method
+ * that will be called if a subsequent critical consumer fails.
+ *
+ * Compensation is called in reverse order (last succeeded -> first succeeded)
+ * when a critical consumer in the chain fails.
+ *
+ * @example
+ * ```typescript
+ * @EventHandler(OrderPlacedEvent)
+ * @Critical({ order: 2 })
+ * export class ReserveInventoryConsumer implements ICriticalEventConsumer<OrderPlacedEvent> {
+ *   async handle(event: OrderPlacedEvent): Promise<void> {
+ *     await this.inventoryService.reserve(event.orderId, event.items);
+ *   }
+ *
+ *   async compensate(event: OrderPlacedEvent): Promise<void> {
+ *     await this.inventoryService.releaseByOrderId(event.orderId);
+ *   }
+ * }
+ * ```
+ */
+export interface ICriticalEventConsumer<TEvent extends IEvent> extends IEventConsumer<TEvent> {
+    /**
+     * Compensate/rollback the work done by handle().
+     * Called when a subsequent critical consumer fails.
+     * Should be idempotent and derive state from the event.
+     *
+     * @param event - The same event instance passed to handle()
+     */
+    compensate?(event: TEvent): Promise<void>;
+}
+/**
+ * @deprecated Use IEventConsumer instead
+ */
+export type IEventHandler<TEvent extends IEvent> = IEventConsumer<TEvent>;
+//# sourceMappingURL=event-consumer.interface.d.ts.map

package/dist/lib/interfaces/event-consumer.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-consumer.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/event-consumer.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,SAAS,MAAM;IACnD;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,sBAAsB,CAAC,MAAM,SAAS,MAAM,CAAE,SAAQ,cAAc,CAAC,MAAM,CAAC;IAC3F;;;;;;OAMG;IACH,UAAU,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,MAAM,SAAS,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC"}

package/dist/lib/interfaces/event-consumer.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=event-consumer.interface.js.map

package/dist/lib/interfaces/event-consumer.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-consumer.interface.js","sourceRoot":"","sources":["../../../src/lib/interfaces/event-consumer.interface.ts"],"names":[],"mappings":""}

package/dist/lib/interfaces/event-criticality.interface.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Criticality level for event consumers.
+ * Determines how the consumer is executed when an event is published.
+ */
+export declare enum EventCriticality {
+    /**
+     * Critical consumers run sequentially in order.
+     * - Must complete before non-critical consumers start
+     * - If one fails, the publish operation fails
+     * - Are awaited by the caller
+     */
+    CRITICAL = "critical",
+    /**
+     * Non-critical consumers run in parallel after critical consumers complete.
+     * - Fire and forget (not awaited by the caller)
+     * - Failures are logged but don't affect the publish result
+     * - Don't block the caller
+     */
+    NON_CRITICAL = "non-critical"
+}
+/**
+ * Metadata stored for event consumer criticality
+ */
+export interface EventCriticalityMetadata {
+    criticality: EventCriticality;
+    order: number;
+}
+//# sourceMappingURL=event-criticality.interface.d.ts.map

package/dist/lib/interfaces/event-criticality.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-criticality.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/event-criticality.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,gBAAgB;IAC1B;;;;;OAKG;IACH,QAAQ,aAAa;IAErB;;;;;OAKG;IACH,YAAY,iBAAiB;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/lib/interfaces/event-criticality.interface.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventCriticality = void 0;
+/**
+ * Criticality level for event consumers.
+ * Determines how the consumer is executed when an event is published.
+ */
+var EventCriticality;
+(function (EventCriticality) {
+    /**
+     * Critical consumers run sequentially in order.
+     * - Must complete before non-critical consumers start
+     * - If one fails, the publish operation fails
+     * - Are awaited by the caller
+     */
+    EventCriticality["CRITICAL"] = "critical";
+    /**
+     * Non-critical consumers run in parallel after critical consumers complete.
+     * - Fire and forget (not awaited by the caller)
+     * - Failures are logged but don't affect the publish result
+     * - Don't block the caller
+     */
+    EventCriticality["NON_CRITICAL"] = "non-critical";
+})(EventCriticality || (exports.EventCriticality = EventCriticality = {}));
+//# sourceMappingURL=event-criticality.interface.js.map

package/dist/lib/interfaces/event-criticality.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-criticality.interface.js","sourceRoot":"","sources":["../../../src/lib/interfaces/event-criticality.interface.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,gBAgBX;AAhBD,WAAY,gBAAgB;IAC1B;;;;;OAKG;IACH,yCAAqB,CAAA;IAErB;;;;;OAKG;IACH,iDAA6B,CAAA;AAC/B,CAAC,EAhBW,gBAAgB,gCAAhB,gBAAgB,QAgB3B"}

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

@@ -0,0 +1,24 @@
+import { IEvent } from './event.interface.js';
+/**
+ * Interface for event handlers
+ * Event handlers subscribe to events and react to them.
+ * Multiple handlers can subscribe to the same event.
+ *
+ * @example
+ * ```typescript
+ * @EventHandler(UserCreatedEvent)
+ * export class SendWelcomeEmailHandler implements IEventHandler<UserCreatedEvent> {
+ *   async handle(event: UserCreatedEvent): Promise<void> {
+ *     await this.emailService.sendWelcome(event.userEmail);
+ *   }
+ * }
+ * ```
+ */
+export interface IEventHandler<TEvent extends IEvent> {
+    /**
+     * Handle the event
+     * @param event - The event instance
+     */
+    handle(event: TEvent): Promise<void>;
+}
+//# sourceMappingURL=event-handler.interface.d.ts.map

package/dist/lib/interfaces/event-handler.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/event-handler.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,aAAa,CAAC,MAAM,SAAS,MAAM;IAClD;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC"}

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=event-handler.interface.js.map

package/dist/lib/interfaces/event-handler.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler.interface.js","sourceRoot":"","sources":["../../../src/lib/interfaces/event-handler.interface.ts"],"names":[],"mappings":""}

package/dist/lib/interfaces/event.interface.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Marker interface for events
+ * Events represent something that has happened in the domain.
+ * Multiple handlers can subscribe to the same event.
+ */
+export interface IEvent {
+}
+/**
+ * Result of publishing an event
+ */
+export interface EventPublishResult {
+    /**
+     * Total number of handlers that were invoked
+     */
+    totalHandlers: number;
+    /**
+     * Number of critical handlers that executed successfully
+     */
+    criticalSucceeded: number;
+    /**
+     * Number of non-critical handlers that were dispatched
+     * Note: Non-critical handlers run in background, so this only indicates they were started
+     */
+    nonCriticalDispatched: number;
+    /**
+     * Number of compensations that were executed (only non-zero when a critical handler fails)
+     */
+    compensationsRun: number;
+}
+//# sourceMappingURL=event.interface.d.ts.map

package/dist/lib/interfaces/event.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/event.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,MAAM;CAAG;AAE1B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=event.interface.js.map

package/dist/lib/interfaces/event.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.interface.js","sourceRoot":"","sources":["../../../src/lib/interfaces/event.interface.ts"],"names":[],"mappings":""}

package/dist/lib/interfaces/index.d.ts

@@ -3,4 +3,11 @@ export * from './query.interface.js';
 export * from './command-handler.interface.js';
 export * from './query-handler.interface.js';
 export * from './pipeline-behavior.interface.js';
+export * from './event.interface.js';
+export * from './event-consumer.interface.js';
+export * from './event-criticality.interface.js';
+export * from './command-bus.interface.js';
+export * from './query-bus.interface.js';
+export * from './event-bus.interface.js';
+export * from './mediator.interface.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC"}

package/dist/lib/interfaces/index.js

@@ -19,4 +19,11 @@ __exportStar(require("./query.interface.js"), exports);
 __exportStar(require("./command-handler.interface.js"), exports);
 __exportStar(require("./query-handler.interface.js"), exports);
 __exportStar(require("./pipeline-behavior.interface.js"), exports);
+__exportStar(require("./event.interface.js"), exports);
+__exportStar(require("./event-consumer.interface.js"), exports);
+__exportStar(require("./event-criticality.interface.js"), exports);
+__exportStar(require("./command-bus.interface.js"), exports);
+__exportStar(require("./query-bus.interface.js"), exports);
+__exportStar(require("./event-bus.interface.js"), exports);
+__exportStar(require("./mediator.interface.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/lib/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,uDAAqC;AACrC,iEAA+C;AAC/C,+DAA6C;AAC7C,mEAAiD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,uDAAqC;AACrC,iEAA+C;AAC/C,+DAA6C;AAC7C,mEAAiD;AACjD,uDAAqC;AACrC,gEAA8C;AAC9C,mEAAiD;AACjD,6DAA2C;AAC3C,2DAAyC;AACzC,2DAAyC;AACzC,0DAAwC"}

package/dist/lib/interfaces/mediator.interface.d.ts

@@ -0,0 +1,14 @@
+import { ICommandBus } from './command-bus.interface.js';
+import { IQueryBus } from './query-bus.interface.js';
+import { IEventBus } from './event-bus.interface.js';
+/**
+ * Unified mediator interface combining command, query, and event bus capabilities.
+ * This is the primary interface clients should depend on.
+ */
+export interface IMediator extends ICommandBus, IQueryBus, IEventBus {
+    /**
+     * Get registered behavior names (for debugging)
+     */
+    getRegisteredBehaviors(): string[];
+}
+//# sourceMappingURL=mediator.interface.d.ts.map

package/dist/lib/interfaces/mediator.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediator.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/mediator.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,SAAU,SAAQ,WAAW,EAAE,SAAS,EAAE,SAAS;IAClE;;OAEG;IACH,sBAAsB,IAAI,MAAM,EAAE,CAAC;CACpC"}

package/dist/lib/interfaces/mediator.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mediator.interface.js.map

package/dist/lib/interfaces/mediator.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediator.interface.js","sourceRoot":"","sources":["../../../src/lib/interfaces/mediator.interface.ts"],"names":[],"mappings":""}

package/dist/lib/interfaces/query-bus.interface.d.ts

@@ -0,0 +1,26 @@
+import { Type } from '@nestjs/common';
+import { IQuery } from './query.interface.js';
+import { IQueryHandler } from './query-handler.interface.js';
+/**
+ * Interface for the query bus.
+ * Responsible for dispatching queries to their handlers.
+ */
+export interface IQueryBus {
+    /**
+     * Execute a query through its handler
+     * @param query - The query instance
+     * @returns Promise with the result
+     */
+    query<TQuery extends IQuery, TResult = any>(query: TQuery): Promise<TResult>;
+    /**
+     * Register a query handler
+     * @param query - The query class
+     * @param handler - The handler class
+     */
+    registerQueryHandler(query: Type<IQuery>, handler: Type<IQueryHandler<any, any>>): void;
+    /**
+     * Get registered query names (for debugging)
+     */
+    getRegisteredQueries(): string[];
+}
+//# sourceMappingURL=query-bus.interface.d.ts.map

package/dist/lib/interfaces/query-bus.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-bus.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/query-bus.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,KAAK,CAAC,MAAM,SAAS,MAAM,EAAE,OAAO,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7E;;;;OAIG;IACH,oBAAoB,CAClB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EACnB,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GACrC,IAAI,CAAC;IAER;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE,CAAC;CAClC"}

package/dist/lib/interfaces/query-bus.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=query-bus.interface.js.map

package/dist/lib/interfaces/query-bus.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-bus.interface.js","sourceRoot":"","sources":["../../../src/lib/interfaces/query-bus.interface.ts"],"names":[],"mappings":""}

package/dist/lib/nest-mediator.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nest-mediator.module.d.ts","sourceRoot":"","sources":["../../src/lib/nest-mediator.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAgB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAmB,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAqBlD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAEpC;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,qBACa,kBAAmB,YAAW,YAAY;IAEnD,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAFhB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,EACpB,gBAAgB,EAAE,gBAAgB;IAGrD,YAAY;IA6FZ;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,yBAA8B,GAAG,aAAa;CAoCvE"}
+{"version":3,"file":"nest-mediator.module.d.ts","sourceRoot":"","sources":["../../src/lib/nest-mediator.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAgB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAmB,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AA8BlD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAEpC;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,qBACa,kBAAmB,YAAW,YAAY;IAEnD,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAFhB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,EACpB,gBAAgB,EAAE,gBAAgB;IAGrD,YAAY;IAwHZ;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,yBAA8B,GAAG,aAAa;CAwCvE"}

package/dist/lib/nest-mediator.module.js

@@ -14,6 +14,10 @@ exports.NestMediatorModule = exports.NEST_MEDIATOR_OPTIONS = void 0;
 const common_1 = require("@nestjs/common");
 const core_1 = require("@nestjs/core");
 const index_js_1 = require("./services/index.js");
+const command_bus_js_1 = require("./services/command.bus.js");
+const query_bus_js_1 = require("./services/query.bus.js");
+const event_bus_js_1 = require("./services/event.bus.js");
+const pipeline_orchestrator_js_1 = require("./services/pipeline.orchestrator.js");
 const index_js_2 = require("./decorators/index.js");
 const index_js_3 = require("./behaviors/index.js");
 /**
@@ -72,6 +76,17 @@ let NestMediatorModule = NestMediatorModule_1 = class NestMediatorModule {
                 console.log(`[NestMediator] Registering pipeline behavior: ${handlerType.name} (priority: ${behaviorMetadata.priority ?? 0}, scope: ${behaviorMetadata.scope ?? 'all'}${requestTypeInfo})`);
                 this.mediatorBus.registerPipelineBehavior(handlerType, behaviorMetadata, requestType);
             }
+            // Register event handlers
+            const eventMetadata = this.reflector.get(index_js_2.EVENT_HANDLER_METADATA, handlerType);
+            if (eventMetadata) {
+                // Get criticality metadata (if any)
+                const criticalityMetadata = this.reflector.get(index_js_2.EVENT_CRITICALITY_METADATA, handlerType);
+                const criticalityInfo = criticalityMetadata
+                    ? ` (criticality: ${criticalityMetadata.criticality}, order: ${criticalityMetadata.order})`
+                    : ' (criticality: non-critical)';
+                console.log(`[NestMediator] Registering event handler: ${handlerType.name} for event: ${eventMetadata.name}${criticalityInfo}`);
+                this.mediatorBus.registerEventHandler(eventMetadata, handlerType, criticalityMetadata);
+            }
         }
     }
     /**
@@ -115,6 +130,10 @@ let NestMediatorModule = NestMediatorModule_1 = class NestMediatorModule {
             module: NestMediatorModule_1,
             imports: [core_1.DiscoveryModule],
             providers: [
+                pipeline_orchestrator_js_1.PipelineOrchestrator,
+                command_bus_js_1.CommandBus,
+                query_bus_js_1.QueryBus,
+                event_bus_js_1.EventBus,
                 index_js_1.MediatorBus,
                 core_1.Reflector,
                 ...builtInProviders,

package/dist/lib/nest-mediator.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"nest-mediator.module.js","sourceRoot":"","sources":["../../src/lib/nest-mediator.module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nest-mediator.module.js","sourceRoot":"","sources":["../../src/lib/nest-mediator.module.ts"],"names":[],"mappings":"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"}

package/dist/lib/services/command.bus.d.ts

@@ -0,0 +1,30 @@
+import { Type } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { ICommand, ICommandHandler, ICommandBus } from '../interfaces/index.js';
+import { PipelineOrchestrator } from './pipeline.orchestrator.js';
+/**
+ * Command bus implementation.
+ * Dispatches commands to their handlers through the pipeline.
+ */
+export declare class CommandBus implements ICommandBus {
+    private readonly moduleRef;
+    private readonly pipelineOrchestrator;
+    private readonly handlers;
+    constructor(moduleRef: ModuleRef, pipelineOrchestrator: PipelineOrchestrator);
+    /**
+     * Send a command to its handler through the pipeline
+     * @param command - The command instance
+     */
+    send<TCommand extends ICommand>(command: TCommand): Promise<void>;
+    /**
+     * Register a command handler
+     * @param command - The command class
+     * @param handler - The handler class
+     */
+    registerCommandHandler(command: Type<ICommand>, handler: Type<ICommandHandler<any>>): void;
+    /**
+     * Get registered command names (for debugging)
+     */
+    getRegisteredCommands(): string[];
+}
+//# sourceMappingURL=command.bus.d.ts.map

package/dist/lib/services/command.bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.bus.d.ts","sourceRoot":"","sources":["../../../src/lib/services/command.bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;GAGG;AACH,qBACa,UAAW,YAAW,WAAW;IAI1C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IAJvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiD;gBAGvD,SAAS,EAAE,SAAS,EACpB,oBAAoB,EAAE,oBAAoB;IAG7D;;;OAGG;IACG,IAAI,CAAC,QAAQ,SAAS,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvE;;;;OAIG;IACH,sBAAsB,CACpB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,EACvB,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GAClC,IAAI;IAUP;;OAEG;IACH,qBAAqB,IAAI,MAAM,EAAE;CAGlC"}

package/dist/lib/services/command.bus.js

@@ -0,0 +1,69 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandBus = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const handler_not_found_exception_js_1 = require("../exceptions/handler-not-found.exception.js");
+const pipeline_orchestrator_js_1 = require("./pipeline.orchestrator.js");
+/**
+ * Command bus implementation.
+ * Dispatches commands to their handlers through the pipeline.
+ */
+let CommandBus = class CommandBus {
+    constructor(moduleRef, pipelineOrchestrator) {
+        this.moduleRef = moduleRef;
+        this.pipelineOrchestrator = pipelineOrchestrator;
+        this.handlers = new Map();
+    }
+    /**
+     * Send a command to its handler through the pipeline
+     * @param command - The command instance
+     */
+    async send(command) {
+        const commandName = command.constructor.name;
+        const handlerType = this.handlers.get(commandName);
+        if (!handlerType) {
+            throw new handler_not_found_exception_js_1.HandlerNotFoundException(commandName, 'command');
+        }
+        const handler = this.moduleRef.get(handlerType, {
+            strict: false,
+        });
+        // Build and execute pipeline
+        const pipeline = this.pipelineOrchestrator.buildPipeline(command, 'command', () => handler.execute(command));
+        await pipeline();
+    }
+    /**
+     * Register a command handler
+     * @param command - The command class
+     * @param handler - The handler class
+     */
+    registerCommandHandler(command, handler) {
+        const commandName = command.name;
+        if (this.handlers.has(commandName)) {
+            throw new Error(`Command handler for ${commandName} is already registered`);
+        }
+        this.handlers.set(commandName, handler);
+    }
+    /**
+     * Get registered command names (for debugging)
+     */
+    getRegisteredCommands() {
+        return Array.from(this.handlers.keys());
+    }
+};
+exports.CommandBus = CommandBus;
+exports.CommandBus = CommandBus = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.ModuleRef,
+        pipeline_orchestrator_js_1.PipelineOrchestrator])
+], CommandBus);
+//# sourceMappingURL=command.bus.js.map

package/dist/lib/services/command.bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.bus.js","sourceRoot":"","sources":["../../../src/lib/services/command.bus.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAkD;AAClD,uCAAyC;AAEzC,iGAAwF;AACxF,yEAAkE;AAElE;;;GAGG;AAEI,IAAM,UAAU,GAAhB,MAAM,UAAU;IAGrB,YACmB,SAAoB,EACpB,oBAA0C;QAD1C,cAAS,GAAT,SAAS,CAAW;QACpB,yBAAoB,GAApB,oBAAoB,CAAsB;QAJ5C,aAAQ,GAAG,IAAI,GAAG,EAAsC,CAAC;IAKvE,CAAC;IAEJ;;;OAGG;IACH,KAAK,CAAC,IAAI,CAA4B,OAAiB;QACrD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;QAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAEnD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,yDAAwB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAA4B,WAAW,EAAE;YACzE,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QAEH,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,aAAa,CACtD,OAAO,EACP,SAAS,EACT,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAC/B,CAAC;QAEF,MAAM,QAAQ,EAAE,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,sBAAsB,CACpB,OAAuB,EACvB,OAAmC;QAEnC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;QACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,uBAAuB,WAAW,wBAAwB,CAC3D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF,CAAA;AA1DY,gCAAU;qBAAV,UAAU;IADtB,IAAA,mBAAU,GAAE;qCAKmB,gBAAS;QACE,+CAAoB;GALlD,UAAU,CA0DtB"}