@rolandsall24/nest-mediator 0.4.3 → 0.5.0

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

@@ -10,11 +10,16 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 var NestMediatorModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NestMediatorModule = void 0;
+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 index_js_2 = require("./decorators/index.js");
+const index_js_3 = require("./behaviors/index.js");
+/**
+ * Token for module options injection
+ */
+exports.NEST_MEDIATOR_OPTIONS = 'NEST_MEDIATOR_OPTIONS';
 let NestMediatorModule = NestMediatorModule_1 = class NestMediatorModule {
     constructor(mediatorBus, reflector, discoveryService) {
         this.mediatorBus = mediatorBus;
@@ -33,31 +38,86 @@ let NestMediatorModule = NestMediatorModule_1 = class NestMediatorModule {
                 continue;
             }
             const handlerType = wrapper.metatype;
+            // Register command handlers
             const commandMetadata = this.reflector.get(index_js_2.COMMAND_HANDLER_METADATA, handlerType);
             if (commandMetadata) {
                 console.log(`[NestMediator] Registering command handler: ${handlerType.name} for command: ${commandMetadata.name}`);
                 this.mediatorBus.registerCommandHandler(commandMetadata, handlerType);
             }
+            // Register query handlers
             const queryMetadata = this.reflector.get(index_js_2.QUERY_HANDLER_METADATA, handlerType);
             if (queryMetadata) {
                 console.log(`[NestMediator] Registering query handler: ${handlerType.name} for query: ${queryMetadata.name}`);
                 this.mediatorBus.registerQueryHandler(queryMetadata, handlerType);
             }
+            // 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);
+            }
         }
     }
     /**
-     * Register the NestMediator module
-     * Handlers are automatically discovered from the application's providers
+     * Register the NestMediator module with default settings.
+     * Handlers and behaviors are automatically discovered from the application's providers.
      * @returns Dynamic module
      */
     static forRoot() {
+        return this.forRootAsync({});
+    }
+    /**
+     * Register the NestMediator module with custom configuration.
+     *
+     * @param options - Configuration options
+     * @returns Dynamic module
+     *
+     * @example
+     * ```typescript
+     * // Enable built-in behaviors
+     * NestMediatorModule.forRootAsync({
+     *   enableLogging: true,
+     *   enableValidation: true,
+     *   enableExceptionHandling: true,
+     *   enablePerformanceTracking: true,
+     *   performanceThresholdMs: 1000,
+     * })
+     *
+     * // With custom behaviors
+     * NestMediatorModule.forRootAsync({
+     *   behaviors: [MyCustomBehavior],
+     * })
+     * ```
+     */
+    static forRootAsync(options = {}) {
+        const builtInProviders = [];
+        // Add built-in behaviors based on options
+        if (options.enableExceptionHandling) {
+            builtInProviders.push(index_js_3.ExceptionHandlingBehavior);
+        }
+        if (options.enableLogging) {
+            builtInProviders.push(index_js_3.LoggingBehavior);
+        }
+        if (options.enablePerformanceTracking) {
+            builtInProviders.push(index_js_3.PerformanceBehavior);
+        }
+        if (options.enableValidation) {
+            builtInProviders.push(index_js_3.ValidationBehavior);
+        }
+        // Add custom behaviors
+        const customBehaviors = options.behaviors ?? [];
         return {
             module: NestMediatorModule_1,
-            imports: [
-                core_1.DiscoveryModule,
-            ],
+            imports: [core_1.DiscoveryModule],
             providers: [
                 index_js_1.MediatorBus,
+                core_1.Reflector,
+                ...builtInProviders,
+                ...customBehaviors,
+                {
+                    provide: exports.NEST_MEDIATOR_OPTIONS,
+                    useValue: options,
+                },
             ],
             exports: [index_js_1.MediatorBus],
             global: true,

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":";;;;;;;;;;;;;AAAA,2CAA2E;AAC3E,uCAA4E;AAC5E,kDAAkD;AAClD,oDAAyF;AAKlF,IAAM,kBAAkB,0BAAxB,MAAM,kBAAkB;IAC7B,YACqB,WAAwB,EACxB,SAAoB,EACpB,gBAAkC;QAFlC,gBAAW,GAAX,WAAW,CAAa;QACxB,cAAS,GAAT,SAAS,CAAW;QACpB,qBAAgB,GAAhB,gBAAgB,CAAkB;IACpD,CAAC;IAEJ,YAAY;QACV,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,CAAC;QAEvD,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAC3C,SAAS;YACX,CAAC;YAED,MAAM,UAAU,GAAG,OAAO,OAAO,CAAC,QAAQ,KAAK,UAAU,CAAC;YAC1D,MAAM,aAAa,GAAG,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC;YAE7E,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,SAAS;YACX,CAAC;YAED,MAAM,WAAW,GAAG,OAAO,CAAC,QAAgB,CAAC;YAE7C,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CACxC,mCAAwB,EACxB,WAAW,CACZ,CAAC;YAEF,IAAI,eAAe,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CACP,+CAA+C,WAAW,CAAC,IAAI,iBAAiB,eAAe,CAAC,IAAI,EAAE,CACzG,CAAC;gBACF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CACnC,eAAe,EACf,WAAyC,CAC5C,CAAC;YACJ,CAAC;YAED,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CACtC,iCAAsB,EACtB,WAAW,CACZ,CAAC;YAEF,IAAI,aAAa,EAAE,CAAC;gBAClB,OAAO,CAAC,GAAG,CACP,6CAA6C,WAAW,CAAC,IAAI,eAAe,aAAa,CAAC,IAAI,EAAE,CACnG,CAAC;gBACF,IAAI,CAAC,WAAW,CAAC,oBAAoB,CACjC,aAAa,EACb,WAA4C,CAC/C,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,MAAM,EAAE,oBAAkB;YAC1B,OAAO,EAAE;gBACP,sBAAe;aAChB;YACD,SAAS,EAAE;gBACT,sBAAW;aACZ;YACD,OAAO,EAAE,CAAC,sBAAW,CAAC;YACtB,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;CACF,CAAA;AA1EY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,eAAM,EAAC,EAAE,CAAC;qCAGyB,sBAAW;QACb,gBAAS;QACF,uBAAgB;GAJ5C,kBAAkB,CA0E9B"}
+{"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/mediator.bus.d.ts

@@ -1,11 +1,38 @@
 import { Type } from '@nestjs/common';
-import { ModuleRef } from '@nestjs/core';
+import { ModuleRef, Reflector } from '@nestjs/core';
 import { ICommand, ICommandHandler, IQuery, IQueryHandler } from '../interfaces/index.js';
+import { IPipelineBehavior, PipelineBehaviorOptions } from '../interfaces/pipeline-behavior.interface.js';
+/**
+ * Central mediator bus for dispatching commands and queries.
+ * Supports pipeline behaviors for cross-cutting concerns.
+ *
+ * @example
+ * ```typescript
+ * // In a controller
+ * @Controller('users')
+ * export class UserController {
+ *   constructor(private readonly mediator: MediatorBus) {}
+ *
+ *   @Post()
+ *   async create(@Body() dto: CreateUserDto) {
+ *     await this.mediator.send(new CreateUserCommand(dto));
+ *   }
+ *
+ *   @Get(':id')
+ *   async findOne(@Param('id') id: string) {
+ *     return this.mediator.query(new GetUserQuery(id));
+ *   }
+ * }
+ * ```
+ */
 export declare class MediatorBus {
     private readonly moduleRef;
+    private readonly reflector;
+    private readonly logger;
     private commandHandlers;
     private queryHandlers;
-    constructor(moduleRef: ModuleRef);
+    private pipelineBehaviors;
+    constructor(moduleRef: ModuleRef, reflector: Reflector);
     /**
      * Register a command handler
      * @param command - The command class
@@ -19,16 +46,39 @@ export declare class MediatorBus {
      */
     registerQueryHandler(query: Type<IQuery>, handler: Type<IQueryHandler<any, any>>): void;
     /**
-     * Send a command to its handler
+     * Register a pipeline behavior
+     * @param behaviorType - The behavior class
+     * @param options - Behavior options (priority, scope)
+     */
+    registerPipelineBehavior(behaviorType: Type<IPipelineBehavior<any, any>>, options: PipelineBehaviorOptions): void;
+    /**
+     * Send a command to its handler through the pipeline
      * @param command - The command instance
      * @returns Promise<void>
      */
     send<TCommand extends ICommand>(command: TCommand): Promise<void>;
     /**
-     * Execute a query through its handler
+     * Execute a query through its handler and the pipeline
      * @param query - The query instance
      * @returns Promise with the result
      */
     query<TQuery extends IQuery, TResult = any>(query: TQuery): Promise<TResult>;
+    /**
+     * Build a pipeline of behaviors around the handler
+     * Uses reduceRight to create a chain where the first behavior wraps all others
+     */
+    private buildPipeline;
+    /**
+     * Get registered command handler names (for debugging)
+     */
+    getRegisteredCommands(): string[];
+    /**
+     * Get registered query handler names (for debugging)
+     */
+    getRegisteredQueries(): string[];
+    /**
+     * Get registered behavior names (for debugging)
+     */
+    getRegisteredBehaviors(): string[];
 }
 //# sourceMappingURL=mediator.bus.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mediator.bus.d.ts","sourceRoot":"","sources":["../../../src/lib/services/mediator.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,MAAM,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE1F,qBACa,WAAW;IAIV,OAAO,CAAC,QAAQ,CAAC,SAAS;IAHtC,OAAO,CAAC,eAAe,CAAiD;IACxE,OAAO,CAAC,aAAa,CAAoD;gBAE5C,SAAS,EAAE,SAAS;IAEjD;;;;OAIG;IACH,sBAAsB,CACpB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,EACvB,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GAClC,IAAI;IAQP;;;;OAIG;IACH,oBAAoB,CAClB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EACnB,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GACrC,IAAI;IAQP;;;;OAIG;IACG,IAAI,CAAC,QAAQ,SAAS,QAAQ,EAClC,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;;OAIG;IACG,KAAK,CAAC,MAAM,SAAS,MAAM,EAAE,OAAO,GAAG,GAAG,EAC9C,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC;CAiBpB"}
+{"version":3,"file":"mediator.bus.d.ts","sourceRoot":"","sources":["../../../src/lib/services/mediator.bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,QAAQ,EACR,eAAe,EACf,MAAM,EACN,aAAa,EACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,8CAA8C,CAAC;AAYtD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,WAAW;IAQpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAR5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IAEpD,OAAO,CAAC,eAAe,CAAiD;IACxE,OAAO,CAAC,aAAa,CAAoD;IACzE,OAAO,CAAC,iBAAiB,CAA4B;gBAGlC,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,SAAS;IAGvC;;;;OAIG;IACH,sBAAsB,CACpB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,EACvB,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GAClC,IAAI;IAUP;;;;OAIG;IACH,oBAAoB,CAClB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EACnB,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GACrC,IAAI;IAQP;;;;OAIG;IACH,wBAAwB,CACtB,YAAY,EAAE,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAC/C,OAAO,EAAE,uBAAuB,GAC/B,IAAI;IAaP;;;;OAIG;IACG,IAAI,CAAC,QAAQ,SAAS,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvE;;;;OAIG;IACG,KAAK,CAAC,MAAM,SAAS,MAAM,EAAE,OAAO,GAAG,GAAG,EAC9C,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC;IAqBnB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAiDrB;;OAEG;IACH,qBAAqB,IAAI,MAAM,EAAE;IAIjC;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;OAEG;IACH,sBAAsB,IAAI,MAAM,EAAE;CAGnC"}

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

@@ -12,11 +12,39 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MediatorBus = 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 skip_behavior_decorator_js_1 = require("../decorators/skip-behavior.decorator.js");
+/**
+ * Central mediator bus for dispatching commands and queries.
+ * Supports pipeline behaviors for cross-cutting concerns.
+ *
+ * @example
+ * ```typescript
+ * // In a controller
+ * @Controller('users')
+ * export class UserController {
+ *   constructor(private readonly mediator: MediatorBus) {}
+ *
+ *   @Post()
+ *   async create(@Body() dto: CreateUserDto) {
+ *     await this.mediator.send(new CreateUserCommand(dto));
+ *   }
+ *
+ *   @Get(':id')
+ *   async findOne(@Param('id') id: string) {
+ *     return this.mediator.query(new GetUserQuery(id));
+ *   }
+ * }
+ * ```
+ */
 let MediatorBus = class MediatorBus {
-    constructor(moduleRef) {
+    constructor(moduleRef, reflector) {
         this.moduleRef = moduleRef;
+        this.reflector = reflector;
+        this.logger = new common_1.Logger('MediatorBus');
         this.commandHandlers = new Map();
         this.queryHandlers = new Map();
+        this.pipelineBehaviors = [];
     }
     /**
      * Register a command handler
@@ -43,7 +71,18 @@ let MediatorBus = class MediatorBus {
         this.queryHandlers.set(queryName, handler);
     }
     /**
-     * Send a command to its handler
+     * Register a pipeline behavior
+     * @param behaviorType - The behavior class
+     * @param options - Behavior options (priority, scope)
+     */
+    registerPipelineBehavior(behaviorType, options) {
+        this.pipelineBehaviors.push({ type: behaviorType, options });
+        // Keep behaviors sorted by priority (lower first)
+        this.pipelineBehaviors.sort((a, b) => (a.options.priority ?? 0) - (b.options.priority ?? 0));
+        this.logger.log(`Registered pipeline behavior: ${behaviorType.name} (priority: ${options.priority ?? 0}, scope: ${options.scope ?? 'all'})`);
+    }
+    /**
+     * Send a command to its handler through the pipeline
      * @param command - The command instance
      * @returns Promise<void>
      */
@@ -51,13 +90,17 @@ let MediatorBus = class MediatorBus {
         const commandName = command.constructor.name;
         const handlerType = this.commandHandlers.get(commandName);
         if (!handlerType) {
-            throw new Error(`No handler registered for command: ${commandName}. Did you forget to add @CommandHandler decorator?`);
+            throw new handler_not_found_exception_js_1.HandlerNotFoundException(commandName, 'command');
         }
-        const handler = this.moduleRef.get(handlerType, { strict: false });
-        await handler.execute(command);
+        const handler = this.moduleRef.get(handlerType, {
+            strict: false,
+        });
+        // Build and execute pipeline
+        const pipeline = this.buildPipeline(command, 'command', () => handler.execute(command));
+        await pipeline();
     }
     /**
-     * Execute a query through its handler
+     * Execute a query through its handler and the pipeline
      * @param query - The query instance
      * @returns Promise with the result
      */
@@ -65,15 +108,67 @@ let MediatorBus = class MediatorBus {
         const queryName = query.constructor.name;
         const handlerType = this.queryHandlers.get(queryName);
         if (!handlerType) {
-            throw new Error(`No handler registered for query: ${queryName}. Did you forget to add @QueryHandler decorator?`);
+            throw new handler_not_found_exception_js_1.HandlerNotFoundException(queryName, 'query');
         }
         const handler = this.moduleRef.get(handlerType, { strict: false });
-        return handler.execute(query);
+        // Build and execute pipeline
+        const pipeline = this.buildPipeline(query, 'query', () => handler.execute(query));
+        return pipeline();
+    }
+    /**
+     * Build a pipeline of behaviors around the handler
+     * Uses reduceRight to create a chain where the first behavior wraps all others
+     */
+    buildPipeline(request, scope, handler) {
+        // Get behaviors to skip from request metadata
+        const requestClass = request.constructor;
+        const behaviorsToSkip = this.reflector.get(skip_behavior_decorator_js_1.SKIP_BEHAVIORS_METADATA, requestClass) ?? [];
+        // Filter behaviors by scope and skip list
+        const applicableBehaviors = this.pipelineBehaviors.filter((b) => {
+            // Check scope
+            const behaviorScope = b.options.scope ?? 'all';
+            const scopeMatches = behaviorScope === 'all' || behaviorScope === scope;
+            // Check if this behavior should be skipped
+            const shouldSkip = behaviorsToSkip.some((skipType) => skipType === b.type);
+            return scopeMatches && !shouldSkip;
+        });
+        // If no behaviors, just return the handler
+        if (applicableBehaviors.length === 0) {
+            return handler;
+        }
+        // Build the pipeline from right to left (innermost to outermost)
+        // The last behavior in the array wraps the handler directly
+        // The first behavior in the array is the outermost wrapper
+        return applicableBehaviors.reduceRight((next, registeredBehavior) => {
+            return async () => {
+                const behavior = this.moduleRef.get(registeredBehavior.type, { strict: false });
+                return behavior.handle(request, next);
+            };
+        }, handler);
+    }
+    /**
+     * Get registered command handler names (for debugging)
+     */
+    getRegisteredCommands() {
+        return Array.from(this.commandHandlers.keys());
+    }
+    /**
+     * Get registered query handler names (for debugging)
+     */
+    getRegisteredQueries() {
+        return Array.from(this.queryHandlers.keys());
+    }
+    /**
+     * Get registered behavior names (for debugging)
+     */
+    getRegisteredBehaviors() {
+        return this.pipelineBehaviors.map((b) => b.type.name);
     }
 };
 exports.MediatorBus = MediatorBus;
 exports.MediatorBus = MediatorBus = __decorate([
     (0, common_1.Injectable)(),
-    __metadata("design:paramtypes", [core_1.ModuleRef])
+    __metadata("design:paramtypes", [core_1.ModuleRef,
+        core_1.Reflector])
 ], MediatorBus);
 //# sourceMappingURL=mediator.bus.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"mediator.bus.js","sourceRoot":"","sources":["../../../src/lib/services/mediator.bus.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAkD;AAClD,uCAAyC;AAIlC,IAAM,WAAW,GAAjB,MAAM,WAAW;IAItB,YAA6B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;QAHzC,oBAAe,GAAG,IAAI,GAAG,EAAsC,CAAC;QAChE,kBAAa,GAAG,IAAI,GAAG,EAAyC,CAAC;IAErB,CAAC;IAErD;;;;OAIG;IACH,sBAAsB,CACpB,OAAuB,EACvB,OAAmC;QAEnC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;QACjC,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,uBAAuB,WAAW,wBAAwB,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACH,oBAAoB,CAClB,KAAmB,EACnB,OAAsC;QAEtC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;QAC7B,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,qBAAqB,SAAS,wBAAwB,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CACR,OAAiB;QAEjB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;QAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAE1D,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,sCAAsC,WAAW,oDAAoD,CACtG,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAChC,WAAW,EACX,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAAC;QAEF,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CACT,KAAa;QAEb,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;QACzC,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEtD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,oCAAoC,SAAS,kDAAkD,CAChG,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAChC,WAAW,EACX,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAAC;QAEF,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;CACF,CAAA;AAvFY,kCAAW;sBAAX,WAAW;IADvB,IAAA,mBAAU,GAAE;qCAK6B,gBAAS;GAJtC,WAAW,CAuFvB"}
+{"version":3,"file":"mediator.bus.js","sourceRoot":"","sources":["../../../src/lib/services/mediator.bus.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA0D;AAC1D,uCAAoD;AAWpD,iGAAwF;AACxF,yFAAmF;AAUnF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEI,IAAM,WAAW,GAAjB,MAAM,WAAW;IAOtB,YACmB,SAAoB,EACpB,SAAoB;QADpB,cAAS,GAAT,SAAS,CAAW;QACpB,cAAS,GAAT,SAAS,CAAW;QARtB,WAAM,GAAG,IAAI,eAAM,CAAC,aAAa,CAAC,CAAC;QAE5C,oBAAe,GAAG,IAAI,GAAG,EAAsC,CAAC;QAChE,kBAAa,GAAG,IAAI,GAAG,EAAyC,CAAC;QACjE,sBAAiB,GAAyB,EAAE,CAAC;IAKlD,CAAC;IAEJ;;;;OAIG;IACH,sBAAsB,CACpB,OAAuB,EACvB,OAAmC;QAEnC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;QACjC,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,uBAAuB,WAAW,wBAAwB,CAC3D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACH,oBAAoB,CAClB,KAAmB,EACnB,OAAsC;QAEtC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;QAC7B,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,qBAAqB,SAAS,wBAAwB,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,wBAAwB,CACtB,YAA+C,EAC/C,OAAgC;QAEhC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;QAE7D,kDAAkD;QAClD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CACzB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,CAChE,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,iCAAiC,YAAY,CAAC,IAAI,eAAe,OAAO,CAAC,QAAQ,IAAI,CAAC,YAAY,OAAO,CAAC,KAAK,IAAI,KAAK,GAAG,CAC5H,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAA4B,OAAiB;QACrD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;QAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAE1D,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,aAAa,CACjC,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,KAAK,CAAC,KAAK,CACT,KAAa;QAEb,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;QACzC,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEtD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,yDAAwB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAChC,WAAW,EACX,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAAC;QAEF,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAkB,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CACxE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CACvB,CAAC;QAEF,OAAO,QAAQ,EAAE,CAAC;IACpB,CAAC;IAED;;;OAGG;IACK,aAAa,CACnB,OAAiB,EACjB,KAA0B,EAC1B,OAAiC;QAEjC,8CAA8C;QAC9C,MAAM,YAAY,GAAI,OAAkB,CAAC,WAAW,CAAC;QACrD,MAAM,eAAe,GACnB,IAAI,CAAC,SAAS,CAAC,GAAG,CAChB,oDAAuB,EACvB,YAAY,CACb,IAAI,EAAE,CAAC;QAEV,0CAA0C;QAC1C,MAAM,mBAAmB,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YAC9D,cAAc;YACd,MAAM,aAAa,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;YAC/C,MAAM,YAAY,GAAG,aAAa,KAAK,KAAK,IAAI,aAAa,KAAK,KAAK,CAAC;YAExE,2CAA2C;YAC3C,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CACrC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,CAClC,CAAC;YAEF,OAAO,YAAY,IAAI,CAAC,UAAU,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,2CAA2C;QAC3C,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,iEAAiE;QACjE,4DAA4D;QAC5D,2DAA2D;QAC3D,OAAO,mBAAmB,CAAC,WAAW,CACpC,CAAC,IAAI,EAAE,kBAAkB,EAAE,EAAE;YAC3B,OAAO,KAAK,IAAI,EAAE;gBAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAEjC,kBAAkB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;gBAE9C,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACxC,CAAC,CAAC;QACJ,CAAC,EACD,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,sBAAsB;QACpB,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;CACF,CAAA;AAnMY,kCAAW;sBAAX,WAAW;IADvB,IAAA,mBAAU,GAAE;qCASmB,gBAAS;QACT,gBAAS;GAT5B,WAAW,CAmMvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rolandsall24/nest-mediator",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "description": "A lightweight CQRS (Command Query Responsibility Segregation) mediator pattern implementation for NestJS applications",
   "author": "Roland Salloum",
   "license": "MIT",
@@ -12,7 +12,11 @@
     "query",
     "handler",
     "pattern",
-    "typescript"
+    "typescript",
+    "pipeline",
+    "behaviors",
+    "validation",
+    "middleware"
   ],
   "main": "./dist/index.js",
   "module": "./dist/index.js",