@rolandsall24/nest-mediator 0.6.0 → 0.7.0

package/dist/lib/services/pipeline.orchestrator.d.ts

@@ -0,0 +1,46 @@
+import { Type } from '@nestjs/common';
+import { ModuleRef, Reflector } from '@nestjs/core';
+import { IPipelineBehavior, PipelineBehaviorOptions } from '../interfaces/pipeline-behavior.interface.js';
+/**
+ * Registered behavior with its metadata
+ */
+export interface RegisteredBehavior {
+    type: Type<IPipelineBehavior<any, any>>;
+    options: PipelineBehaviorOptions;
+    /**
+     * The specific request type this behavior applies to.
+     * When undefined, behavior applies to all requests.
+     */
+    requestType?: Function;
+}
+/**
+ * Orchestrates pipeline behaviors for commands and queries.
+ * Manages behavior registration and builds execution pipelines.
+ */
+export declare class PipelineOrchestrator {
+    private readonly moduleRef;
+    private readonly reflector;
+    private readonly logger;
+    private readonly behaviors;
+    constructor(moduleRef: ModuleRef, reflector: Reflector);
+    /**
+     * Register a pipeline behavior
+     * @param behaviorType - The behavior class
+     * @param options - Behavior options (priority, scope)
+     * @param requestType - Optional specific request type this behavior applies to
+     */
+    registerBehavior(behaviorType: Type<IPipelineBehavior<any, any>>, options: PipelineBehaviorOptions, requestType?: Function): void;
+    /**
+     * Build a pipeline of behaviors around the handler
+     * @param request - The request object (command or query)
+     * @param scope - The scope ('command' or 'query')
+     * @param handler - The innermost handler function
+     * @returns A function that executes the full pipeline
+     */
+    buildPipeline<TRequest, TResponse>(request: TRequest, scope: 'command' | 'query', handler: () => Promise<TResponse>): () => Promise<TResponse>;
+    /**
+     * Get registered behavior names (for debugging)
+     */
+    getRegisteredBehaviors(): string[];
+}
+//# sourceMappingURL=pipeline.orchestrator.d.ts.map

package/dist/lib/services/pipeline.orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.orchestrator.d.ts","sourceRoot":"","sources":["../../../src/lib/services/pipeline.orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,8CAA8C,CAAC;AAGtD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACxC,OAAO,EAAE,uBAAuB,CAAC;IACjC;;;OAGG;IACH,WAAW,CAAC,EAAE,QAAQ,CAAC;CACxB;AAED;;;GAGG;AACH,qBACa,oBAAoB;IAK7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;gBAGnC,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,SAAS;IAGvC;;;;;OAKG;IACH,gBAAgB,CACd,YAAY,EAAE,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAC/C,OAAO,EAAE,uBAAuB,EAChC,WAAW,CAAC,EAAE,QAAQ,GACrB,IAAI;IAcP;;;;;;OAMG;IACH,aAAa,CAAC,QAAQ,EAAE,SAAS,EAC/B,OAAO,EAAE,QAAQ,EACjB,KAAK,EAAE,SAAS,GAAG,OAAO,EAC1B,OAAO,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,GAChC,MAAM,OAAO,CAAC,SAAS,CAAC;IA8C3B;;OAEG;IACH,sBAAsB,IAAI,MAAM,EAAE;CAGnC"}

package/dist/lib/services/pipeline.orchestrator.js

@@ -0,0 +1,87 @@
+"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.PipelineOrchestrator = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const skip_behavior_decorator_js_1 = require("../decorators/skip-behavior.decorator.js");
+/**
+ * Orchestrates pipeline behaviors for commands and queries.
+ * Manages behavior registration and builds execution pipelines.
+ */
+let PipelineOrchestrator = class PipelineOrchestrator {
+    constructor(moduleRef, reflector) {
+        this.moduleRef = moduleRef;
+        this.reflector = reflector;
+        this.logger = new common_1.Logger('PipelineOrchestrator');
+        this.behaviors = [];
+    }
+    /**
+     * Register a pipeline behavior
+     * @param behaviorType - The behavior class
+     * @param options - Behavior options (priority, scope)
+     * @param requestType - Optional specific request type this behavior applies to
+     */
+    registerBehavior(behaviorType, options, requestType) {
+        this.behaviors.push({ type: behaviorType, options, requestType });
+        // Keep behaviors sorted by priority (lower first)
+        this.behaviors.sort((a, b) => (a.options.priority ?? 0) - (b.options.priority ?? 0));
+        const requestTypeInfo = requestType ? `, requestType: ${requestType.name}` : '';
+        this.logger.log(`Registered pipeline behavior: ${behaviorType.name} (priority: ${options.priority ?? 0}, scope: ${options.scope ?? 'all'}${requestTypeInfo})`);
+    }
+    /**
+     * Build a pipeline of behaviors around the handler
+     * @param request - The request object (command or query)
+     * @param scope - The scope ('command' or 'query')
+     * @param handler - The innermost handler function
+     * @returns A function that executes the full pipeline
+     */
+    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, skip list, and request type
+        const applicableBehaviors = this.behaviors.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);
+            // Check request type match
+            const requestTypeMatches = !b.requestType || request instanceof b.requestType;
+            return scopeMatches && !shouldSkip && requestTypeMatches;
+        });
+        // If no behaviors, just return the handler
+        if (applicableBehaviors.length === 0) {
+            return handler;
+        }
+        // Build the pipeline from right to left (innermost to outermost)
+        return applicableBehaviors.reduceRight((next, registeredBehavior) => {
+            return async () => {
+                const behavior = this.moduleRef.get(registeredBehavior.type, { strict: false });
+                return behavior.handle(request, next);
+            };
+        }, handler);
+    }
+    /**
+     * Get registered behavior names (for debugging)
+     */
+    getRegisteredBehaviors() {
+        return this.behaviors.map((b) => b.type.name);
+    }
+};
+exports.PipelineOrchestrator = PipelineOrchestrator;
+exports.PipelineOrchestrator = PipelineOrchestrator = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.ModuleRef,
+        core_1.Reflector])
+], PipelineOrchestrator);
+//# sourceMappingURL=pipeline.orchestrator.js.map

package/dist/lib/services/pipeline.orchestrator.js.map

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

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

@@ -0,0 +1,31 @@
+import { Type } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { IQuery, IQueryHandler, IQueryBus } from '../interfaces/index.js';
+import { PipelineOrchestrator } from './pipeline.orchestrator.js';
+/**
+ * Query bus implementation.
+ * Dispatches queries to their handlers through the pipeline.
+ */
+export declare class QueryBus implements IQueryBus {
+    private readonly moduleRef;
+    private readonly pipelineOrchestrator;
+    private readonly handlers;
+    constructor(moduleRef: ModuleRef, pipelineOrchestrator: PipelineOrchestrator);
+    /**
+     * 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>;
+    /**
+     * 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.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.bus.d.ts","sourceRoot":"","sources":["../../../src/lib/services/query.bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;GAGG;AACH,qBACa,QAAS,YAAW,SAAS;IAItC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IAJvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoD;gBAG1D,SAAS,EAAE,SAAS,EACpB,oBAAoB,EAAE,oBAAoB;IAG7D;;;;OAIG;IACG,KAAK,CAAC,MAAM,SAAS,MAAM,EAAE,OAAO,GAAG,GAAG,EAC9C,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC;IAuBnB;;;;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;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;CAGjC"}

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

@@ -0,0 +1,68 @@
+"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.QueryBus = 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");
+/**
+ * Query bus implementation.
+ * Dispatches queries to their handlers through the pipeline.
+ */
+let QueryBus = class QueryBus {
+    constructor(moduleRef, pipelineOrchestrator) {
+        this.moduleRef = moduleRef;
+        this.pipelineOrchestrator = pipelineOrchestrator;
+        this.handlers = new Map();
+    }
+    /**
+     * Execute a query through its handler and the pipeline
+     * @param query - The query instance
+     * @returns Promise with the result
+     */
+    async query(query) {
+        const queryName = query.constructor.name;
+        const handlerType = this.handlers.get(queryName);
+        if (!handlerType) {
+            throw new handler_not_found_exception_js_1.HandlerNotFoundException(queryName, 'query');
+        }
+        const handler = this.moduleRef.get(handlerType, { strict: false });
+        // Build and execute pipeline
+        const pipeline = this.pipelineOrchestrator.buildPipeline(query, 'query', () => handler.execute(query));
+        return pipeline();
+    }
+    /**
+     * Register a query handler
+     * @param query - The query class
+     * @param handler - The handler class
+     */
+    registerQueryHandler(query, handler) {
+        const queryName = query.name;
+        if (this.handlers.has(queryName)) {
+            throw new Error(`Query handler for ${queryName} is already registered`);
+        }
+        this.handlers.set(queryName, handler);
+    }
+    /**
+     * Get registered query names (for debugging)
+     */
+    getRegisteredQueries() {
+        return Array.from(this.handlers.keys());
+    }
+};
+exports.QueryBus = QueryBus;
+exports.QueryBus = QueryBus = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.ModuleRef,
+        pipeline_orchestrator_js_1.PipelineOrchestrator])
+], QueryBus);
+//# sourceMappingURL=query.bus.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.bus.js","sourceRoot":"","sources":["../../../src/lib/services/query.bus.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAkD;AAClD,uCAAyC;AAEzC,iGAAwF;AACxF,yEAAkE;AAElE;;;GAGG;AAEI,IAAM,QAAQ,GAAd,MAAM,QAAQ;IAGnB,YACmB,SAAoB,EACpB,oBAA0C;QAD1C,cAAS,GAAT,SAAS,CAAW;QACpB,yBAAoB,GAApB,oBAAoB,CAAsB;QAJ5C,aAAQ,GAAG,IAAI,GAAG,EAAyC,CAAC;IAK1E,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,KAAK,CACT,KAAa;QAEb,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;QACzC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEjD,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,oBAAoB,CAAC,aAAa,CACtD,KAAK,EACL,OAAO,EACP,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAC7B,CAAC;QAEF,OAAO,QAAQ,EAAE,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,oBAAoB,CAClB,KAAmB,EACnB,OAAsC;QAEtC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;QAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,qBAAqB,SAAS,wBAAwB,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF,CAAA;AA5DY,4BAAQ;mBAAR,QAAQ;IADpB,IAAA,mBAAU,GAAE;qCAKmB,gBAAS;QACE,+CAAoB;GALlD,QAAQ,CA4DpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rolandsall24/nest-mediator",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "A lightweight CQRS (Command Query Responsibility Segregation) mediator pattern implementation for NestJS applications",
   "author": "Roland Salloum",
   "license": "MIT",