@rolandsall24/nest-mediator 0.5.2 → 0.7.0

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;IAoEZ;;;;;;;;;;;;;;;;;;;;;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");
 /**
@@ -53,8 +57,35 @@ let NestMediatorModule = NestMediatorModule_1 = class NestMediatorModule {
             // Register pipeline behaviors
             const behaviorMetadata = this.reflector.get(index_js_2.PIPELINE_BEHAVIOR_METADATA, handlerType);
             if (behaviorMetadata) {
-                console.log(`[NestMediator] Registering pipeline behavior: ${handlerType.name} (priority: ${behaviorMetadata.priority ?? 0}, scope: ${behaviorMetadata.scope ?? 'all'})`);
-                this.mediatorBus.registerPipelineBehavior(handlerType, behaviorMetadata);
+                // Try to infer request type from handle method's first parameter
+                // This only works if @PipelineBehavior() decorator is applied to the handle method
+                const handleParamTypes = Reflect.getMetadata('design:paramtypes', handlerType.prototype, 'handle');
+                // Get the first parameter type (the request type)
+                // Only use it if it's a concrete class (not Object, Function, or undefined)
+                let requestType;
+                if (handleParamTypes && handleParamTypes[0]) {
+                    const firstParamType = handleParamTypes[0];
+                    // Exclude generic types like Object, Function that indicate no specific type
+                    if (firstParamType !== Object &&
+                        firstParamType !== Function &&
+                        typeof firstParamType === 'function') {
+                        requestType = firstParamType;
+                    }
+                }
+                const requestTypeInfo = requestType ? `, requestType: ${requestType.name}` : '';
+                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);
             }
         }
     }
@@ -99,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"}

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

@@ -0,0 +1,61 @@
+import { Type } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { IEvent, IEventConsumer, IEventBus, EventPublishResult, EventCriticalityMetadata } from '../interfaces/index.js';
+/**
+ * Event bus implementation.
+ * Publishes events to their consumers with critical/non-critical handling.
+ * Supports saga-style compensation for critical consumers.
+ */
+export declare class EventBus implements IEventBus {
+    private readonly moduleRef;
+    private readonly logger;
+    private readonly handlers;
+    constructor(moduleRef: ModuleRef);
+    /**
+     * Publish an event to all its consumers
+     *
+     * Execution flow:
+     * 1. Critical consumers run sequentially in order (lower order first)
+     * 2. If a critical consumer fails:
+     *    - Compensations run in reverse order for previously succeeded consumers
+     *    - Non-critical consumers are NOT dispatched
+     *    - Original error is thrown after compensations complete
+     * 3. If all critical consumers succeed, non-critical consumers are fired in parallel (fire-and-forget)
+     *
+     * @param event - The event instance
+     * @returns Promise with the publish result
+     */
+    publish<TEvent extends IEvent>(event: TEvent): Promise<EventPublishResult>;
+    /**
+     * Run compensations for succeeded consumers in reverse order
+     * Continues even if individual compensations fail (logs errors)
+     *
+     * @param succeededConsumers - Consumers that succeeded and have compensate()
+     * @param event - The event to pass to compensate()
+     * @returns Number of compensations that were run
+     */
+    private runCompensations;
+    /**
+     * 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;
+        }[];
+    }[];
+    /**
+     * Execute a non-critical consumer in the background
+     */
+    private executeNonCriticalConsumer;
+}
+//# sourceMappingURL=event.bus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event.bus.d.ts","sourceRoot":"","sources":["../../../src/lib/services/event.bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,MAAM,EACN,cAAc,EAEd,SAAS,EACT,kBAAkB,EAClB,wBAAwB,EAEzB,MAAM,wBAAwB,CAAC;AAmBhC;;;;GAIG;AACH,qBACa,QAAS,YAAW,SAAS;IAI5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAHtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;gBAE5C,SAAS,EAAE,SAAS;IAEjD;;;;;;;;;;;;;OAaG;IACG,OAAO,CAAC,MAAM,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqFhF;;;;;;;OAOG;YACW,gBAAgB;IA0B9B;;;;;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;IAkBP;;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;IAWH;;OAEG;IACH,OAAO,CAAC,0BAA0B;CAqBnC"}

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

@@ -0,0 +1,176 @@
+"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.EventBus = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const index_js_1 = require("../interfaces/index.js");
+/**
+ * Event bus implementation.
+ * Publishes events to their consumers with critical/non-critical handling.
+ * Supports saga-style compensation for critical consumers.
+ */
+let EventBus = class EventBus {
+    constructor(moduleRef) {
+        this.moduleRef = moduleRef;
+        this.logger = new common_1.Logger('EventBus');
+        this.handlers = new Map();
+    }
+    /**
+     * Publish an event to all its consumers
+     *
+     * Execution flow:
+     * 1. Critical consumers run sequentially in order (lower order first)
+     * 2. If a critical consumer fails:
+     *    - Compensations run in reverse order for previously succeeded consumers
+     *    - Non-critical consumers are NOT dispatched
+     *    - Original error is thrown after compensations complete
+     * 3. If all critical consumers succeed, non-critical consumers are fired in parallel (fire-and-forget)
+     *
+     * @param event - The event instance
+     * @returns Promise with the publish result
+     */
+    async publish(event) {
+        const eventName = event.constructor.name;
+        const consumers = this.handlers.get(eventName) || [];
+        if (consumers.length === 0) {
+            this.logger.log(`No consumers registered for event: ${eventName}`);
+            return {
+                totalHandlers: 0,
+                criticalSucceeded: 0,
+                nonCriticalDispatched: 0,
+                compensationsRun: 0,
+            };
+        }
+        // Separate critical and non-critical consumers
+        const criticalConsumers = consumers
+            .filter((h) => h.criticality === index_js_1.EventCriticality.CRITICAL)
+            .sort((a, b) => a.order - b.order);
+        const nonCriticalConsumers = consumers.filter((h) => h.criticality === index_js_1.EventCriticality.NON_CRITICAL);
+        this.logger.log(`Publishing event: ${eventName} to ${criticalConsumers.length} critical and ${nonCriticalConsumers.length} non-critical consumers`);
+        // Phase 1: Execute critical consumers sequentially, tracking those with compensate()
+        const succeededWithCompensation = [];
+        let criticalSucceeded = 0;
+        for (const registeredConsumer of criticalConsumers) {
+            const consumer = this.moduleRef.get(registeredConsumer.type, { strict: false });
+            try {
+                await consumer.handle(event);
+                criticalSucceeded++;
+                this.logger.log(`Critical consumer ${registeredConsumer.type.name} completed successfully`);
+                // Track if it has a compensate method for potential rollback
+                if (typeof consumer.compensate === 'function') {
+                    succeededWithCompensation.push({
+                        consumer,
+                        name: registeredConsumer.type.name,
+                    });
+                }
+            }
+            catch (error) {
+                this.logger.error(`Critical consumer ${registeredConsumer.type.name} failed: ${error.message}`);
+                // Run compensations for previously succeeded consumers (in reverse order)
+                const compensationsRun = await this.runCompensations(succeededWithCompensation, event);
+                this.logger.log(`Ran ${compensationsRun} compensations after failure in ${registeredConsumer.type.name}`);
+                throw error;
+            }
+        }
+        // Phase 2: Fire non-critical consumers in parallel (fire-and-forget)
+        let nonCriticalDispatched = 0;
+        for (const registeredConsumer of nonCriticalConsumers) {
+            nonCriticalDispatched++;
+            this.executeNonCriticalConsumer(event, registeredConsumer);
+        }
+        return {
+            totalHandlers: consumers.length,
+            criticalSucceeded,
+            nonCriticalDispatched,
+            compensationsRun: 0,
+        };
+    }
+    /**
+     * Run compensations for succeeded consumers in reverse order
+     * Continues even if individual compensations fail (logs errors)
+     *
+     * @param succeededConsumers - Consumers that succeeded and have compensate()
+     * @param event - The event to pass to compensate()
+     * @returns Number of compensations that were run
+     */
+    async runCompensations(succeededConsumers, event) {
+        let compensationsRun = 0;
+        // Run in reverse order (last succeeded -> first succeeded)
+        for (const { consumer, name } of succeededConsumers.reverse()) {
+            try {
+                this.logger.log(`Running compensation for ${name}...`);
+                await consumer.compensate(event);
+                compensationsRun++;
+                this.logger.log(`Compensation for ${name} completed successfully`);
+            }
+            catch (compError) {
+                // Log but continue with other compensations
+                this.logger.error(`Compensation for ${name} failed: ${compError.message}. ` +
+                    `Manual intervention may be required.`);
+                compensationsRun++; // Count as run even if failed
+            }
+        }
+        return compensationsRun;
+    }
+    /**
+     * Register an event consumer
+     * @param event - The event class
+     * @param handler - The consumer class
+     * @param criticalityMetadata - Criticality metadata
+     */
+    registerEventHandler(event, handler, criticalityMetadata) {
+        const eventName = event.name;
+        const consumers = this.handlers.get(eventName) || [];
+        const registeredConsumer = {
+            type: handler,
+            criticality: criticalityMetadata?.criticality ?? index_js_1.EventCriticality.NON_CRITICAL,
+            order: criticalityMetadata?.order ?? 0,
+        };
+        consumers.push(registeredConsumer);
+        this.handlers.set(eventName, consumers);
+        this.logger.log(`Registered event consumer: ${handler.name} for event: ${eventName} (criticality: ${registeredConsumer.criticality}, order: ${registeredConsumer.order})`);
+    }
+    /**
+     * Get registered events and their consumers (for debugging)
+     */
+    getRegisteredEvents() {
+        return Array.from(this.handlers.entries()).map(([event, consumers]) => ({
+            event,
+            handlers: consumers.map((h) => ({
+                name: h.type.name,
+                criticality: h.criticality,
+                order: h.order,
+            })),
+        }));
+    }
+    /**
+     * Execute a non-critical consumer in the background
+     */
+    executeNonCriticalConsumer(event, registeredConsumer) {
+        setImmediate(async () => {
+            try {
+                const consumer = this.moduleRef.get(registeredConsumer.type, { strict: false });
+                await consumer.handle(event);
+                this.logger.log(`Non-critical consumer ${registeredConsumer.type.name} completed successfully`);
+            }
+            catch (error) {
+                this.logger.warn(`Non-critical consumer ${registeredConsumer.type.name} failed: ${error.message}`);
+            }
+        });
+    }
+};
+exports.EventBus = EventBus;
+exports.EventBus = EventBus = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.ModuleRef])
+], EventBus);
+//# sourceMappingURL=event.bus.js.map

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

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