@rolandsall24/nest-mediator 0.4.2 → 0.5.0

package/dist/lib/behaviors/exception-handling.behavior.js

@@ -0,0 +1,76 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExceptionHandlingBehavior = void 0;
+const common_1 = require("@nestjs/common");
+const pipeline_behavior_decorator_js_1 = require("../decorators/pipeline-behavior.decorator.js");
+/**
+ * Pipeline behavior that provides centralized exception handling.
+ * This behavior wraps all other behaviors and handlers, catching any exceptions.
+ *
+ * Priority: -100 (executes first/outermost to catch all exceptions)
+ *
+ * Features:
+ * - Catches all exceptions from the pipeline
+ * - Logs exceptions with request context
+ * - Can be extended with custom exception handlers
+ *
+ * @example
+ * ```typescript
+ * // The behavior automatically catches and logs all exceptions
+ * await mediator.send(new CreateUserCommand('invalid'));
+ * // If handler throws, ExceptionHandlingBehavior logs:
+ * // [MediatorBus] Exception in CreateUserCommand: User validation failed
+ * ```
+ */
+let ExceptionHandlingBehavior = class ExceptionHandlingBehavior {
+    constructor() {
+        this.logger = new common_1.Logger('MediatorBus');
+        this.exceptionHandlers = [];
+    }
+    /**
+     * Register a custom exception handler
+     */
+    registerExceptionHandler(handler) {
+        this.exceptionHandlers.push(handler);
+    }
+    async handle(request, next) {
+        try {
+            return await next();
+        }
+        catch (error) {
+            const processedError = await this.processException(error, request);
+            throw processedError;
+        }
+    }
+    async processException(error, request) {
+        const requestName = this.getRequestName(request);
+        // Log the exception
+        this.logger.error(`Exception in ${requestName}: ${error.message}`, error.stack);
+        // Try custom exception handlers
+        for (const handler of this.exceptionHandlers) {
+            if (handler.canHandle(error)) {
+                return handler.handle(error, request);
+            }
+        }
+        // Return original error if no handler processed it
+        return error;
+    }
+    getRequestName(request) {
+        if (request && typeof request === 'object' && request.constructor) {
+            return request.constructor.name;
+        }
+        return 'UnknownRequest';
+    }
+};
+exports.ExceptionHandlingBehavior = ExceptionHandlingBehavior;
+exports.ExceptionHandlingBehavior = ExceptionHandlingBehavior = __decorate([
+    (0, common_1.Injectable)(),
+    (0, pipeline_behavior_decorator_js_1.PipelineBehavior)({ priority: -100, scope: 'all' })
+], ExceptionHandlingBehavior);
+//# sourceMappingURL=exception-handling.behavior.js.map

package/dist/lib/behaviors/exception-handling.behavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception-handling.behavior.js","sourceRoot":"","sources":["../../../src/lib/behaviors/exception-handling.behavior.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAoD;AAEpD,iGAAgF;AAkBhF;;;;;;;;;;;;;;;;;;GAkBG;AAGI,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;IAA/B;QAGY,WAAM,GAAG,IAAI,eAAM,CAAC,aAAa,CAAC,CAAC;QACnC,sBAAiB,GAAwB,EAAE,CAAC;IAqD/D,CAAC;IAnDC;;OAEG;IACH,wBAAwB,CAAC,OAA0B;QACjD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,MAAM,CACV,OAAiB,EACjB,IAA8B;QAE9B,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAChD,KAAc,EACd,OAAO,CACR,CAAC;YACF,MAAM,cAAc,CAAC;QACvB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,KAAY,EACZ,OAAiB;QAEjB,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAEjD,oBAAoB;QACpB,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,gBAAgB,WAAW,KAAK,KAAK,CAAC,OAAO,EAAE,EAC/C,KAAK,CAAC,KAAK,CACZ,CAAC;QAEF,gCAAgC;QAChC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC7C,IAAI,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,mDAAmD;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,cAAc,CAAC,OAAiB;QACtC,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAClE,OAAO,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,CAAC;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF,CAAA;AAzDY,8DAAyB;oCAAzB,yBAAyB;IAFrC,IAAA,mBAAU,GAAE;IACZ,IAAA,iDAAgB,EAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;GACtC,yBAAyB,CAyDrC"}

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

@@ -0,0 +1,5 @@
+export * from './logging.behavior.js';
+export * from './validation.behavior.js';
+export * from './exception-handling.behavior.js';
+export * from './performance.behavior.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/behaviors/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC"}

package/dist/lib/behaviors/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./logging.behavior.js"), exports);
+__exportStar(require("./validation.behavior.js"), exports);
+__exportStar(require("./exception-handling.behavior.js"), exports);
+__exportStar(require("./performance.behavior.js"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/behaviors/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,2DAAyC;AACzC,mEAAiD;AACjD,4DAA0C"}

package/dist/lib/behaviors/logging.behavior.d.ts

@@ -0,0 +1,26 @@
+import { IPipelineBehavior } from '../interfaces/pipeline-behavior.interface.js';
+/**
+ * Pipeline behavior that logs request handling.
+ * Logs before execution, after successful execution (with duration), and on errors.
+ *
+ * Priority: 0 (executes early, wraps most other behaviors)
+ *
+ * @example
+ * Output:
+ * ```
+ * [MediatorBus] Handling CreateUserCommand...
+ * [MediatorBus] Handled CreateUserCommand successfully in 45ms
+ * ```
+ *
+ * On error:
+ * ```
+ * [MediatorBus] Handling CreateUserCommand...
+ * [MediatorBus] Failed CreateUserCommand after 12ms: User already exists
+ * ```
+ */
+export declare class LoggingBehavior<TRequest = any, TResponse = any> implements IPipelineBehavior<TRequest, TResponse> {
+    private readonly logger;
+    handle(request: TRequest, next: () => Promise<TResponse>): Promise<TResponse>;
+    private getRequestName;
+}
+//# sourceMappingURL=logging.behavior.d.ts.map

package/dist/lib/behaviors/logging.behavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.behavior.d.ts","sourceRoot":"","sources":["../../../src/lib/behaviors/logging.behavior.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAGjF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAEa,eAAe,CAAC,QAAQ,GAAG,GAAG,EAAE,SAAS,GAAG,GAAG,CAC1D,YAAW,iBAAiB,CAAC,QAAQ,EAAE,SAAS,CAAC;IAEjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IAE9C,MAAM,CACV,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,GAC7B,OAAO,CAAC,SAAS,CAAC;IA0BrB,OAAO,CAAC,cAAc;CAMvB"}

package/dist/lib/behaviors/logging.behavior.js

@@ -0,0 +1,64 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggingBehavior = void 0;
+const common_1 = require("@nestjs/common");
+const pipeline_behavior_decorator_js_1 = require("../decorators/pipeline-behavior.decorator.js");
+/**
+ * Pipeline behavior that logs request handling.
+ * Logs before execution, after successful execution (with duration), and on errors.
+ *
+ * Priority: 0 (executes early, wraps most other behaviors)
+ *
+ * @example
+ * Output:
+ * ```
+ * [MediatorBus] Handling CreateUserCommand...
+ * [MediatorBus] Handled CreateUserCommand successfully in 45ms
+ * ```
+ *
+ * On error:
+ * ```
+ * [MediatorBus] Handling CreateUserCommand...
+ * [MediatorBus] Failed CreateUserCommand after 12ms: User already exists
+ * ```
+ */
+let LoggingBehavior = class LoggingBehavior {
+    constructor() {
+        this.logger = new common_1.Logger('MediatorBus');
+    }
+    async handle(request, next) {
+        const requestName = this.getRequestName(request);
+        const startTime = Date.now();
+        this.logger.log(`Handling ${requestName}...`);
+        try {
+            const response = await next();
+            const elapsed = Date.now() - startTime;
+            this.logger.log(`Handled ${requestName} successfully in ${elapsed}ms`);
+            return response;
+        }
+        catch (error) {
+            const elapsed = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            this.logger.error(`Failed ${requestName} after ${elapsed}ms: ${errorMessage}`);
+            throw error;
+        }
+    }
+    getRequestName(request) {
+        if (request && typeof request === 'object' && request.constructor) {
+            return request.constructor.name;
+        }
+        return 'UnknownRequest';
+    }
+};
+exports.LoggingBehavior = LoggingBehavior;
+exports.LoggingBehavior = LoggingBehavior = __decorate([
+    (0, common_1.Injectable)(),
+    (0, pipeline_behavior_decorator_js_1.PipelineBehavior)({ priority: 0, scope: 'all' })
+], LoggingBehavior);
+//# sourceMappingURL=logging.behavior.js.map

package/dist/lib/behaviors/logging.behavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.behavior.js","sourceRoot":"","sources":["../../../src/lib/behaviors/logging.behavior.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAoD;AAEpD,iGAAgF;AAEhF;;;;;;;;;;;;;;;;;;GAkBG;AAGI,IAAM,eAAe,GAArB,MAAM,eAAe;IAArB;QAGY,WAAM,GAAG,IAAI,eAAM,CAAC,aAAa,CAAC,CAAC;IAqCtD,CAAC;IAnCC,KAAK,CAAC,MAAM,CACV,OAAiB,EACjB,IAA8B;QAE9B,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,WAAW,KAAK,CAAC,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAEvC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,WAAW,oBAAoB,OAAO,IAAI,CAAC,CAAC;YAEvE,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACvC,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAE3D,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,UAAU,WAAW,UAAU,OAAO,OAAO,YAAY,EAAE,CAC5D,CAAC;YAEF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,OAAiB;QACtC,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAClE,OAAO,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,CAAC;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF,CAAA;AAxCY,0CAAe;0BAAf,eAAe;IAF3B,IAAA,mBAAU,GAAE;IACZ,IAAA,iDAAgB,EAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;GACnC,eAAe,CAwC3B"}

package/dist/lib/behaviors/performance.behavior.d.ts

@@ -0,0 +1,41 @@
+import { IPipelineBehavior } from '../interfaces/pipeline-behavior.interface.js';
+/**
+ * Injection token for PerformanceBehavior options
+ */
+export declare const PERFORMANCE_BEHAVIOR_OPTIONS = "PERFORMANCE_BEHAVIOR_OPTIONS";
+/**
+ * Configuration options for PerformanceBehavior
+ */
+export interface PerformanceBehaviorOptions {
+    /**
+     * Threshold in milliseconds. Requests exceeding this will be logged as warnings.
+     * Default: 500ms
+     */
+    thresholdMs?: number;
+    /**
+     * Whether to log all requests or only slow ones.
+     * Default: false (only log slow requests)
+     */
+    logAllRequests?: boolean;
+}
+/**
+ * Pipeline behavior that tracks request performance.
+ * Logs warnings for requests that exceed a configurable threshold.
+ *
+ * Priority: 10 (executes early to measure total pipeline time)
+ *
+ * @example
+ * ```typescript
+ * // Slow request output:
+ * // [Performance] SLOW REQUEST: GetAllUsersQuery took 1234ms (threshold: 500ms)
+ * ```
+ */
+export declare class PerformanceBehavior<TRequest = any, TResponse = any> implements IPipelineBehavior<TRequest, TResponse> {
+    private readonly logger;
+    private readonly thresholdMs;
+    private readonly logAllRequests;
+    constructor(options?: PerformanceBehaviorOptions);
+    handle(request: TRequest, next: () => Promise<TResponse>): Promise<TResponse>;
+    private getRequestName;
+}
+//# sourceMappingURL=performance.behavior.d.ts.map

package/dist/lib/behaviors/performance.behavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.behavior.d.ts","sourceRoot":"","sources":["../../../src/lib/behaviors/performance.behavior.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAGjF;;GAEG;AACH,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,qBAEa,mBAAmB,CAAC,QAAQ,GAAG,GAAG,EAAE,SAAS,GAAG,GAAG,CAC9D,YAAW,iBAAiB,CAAC,QAAQ,EAAE,SAAS,CAAC;IAEjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;gBAKvC,OAAO,CAAC,EAAE,0BAA0B;IAMhC,MAAM,CACV,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,GAC7B,OAAO,CAAC,SAAS,CAAC;IAmBrB,OAAO,CAAC,cAAc;CAMvB"}

package/dist/lib/behaviors/performance.behavior.js

@@ -0,0 +1,71 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PerformanceBehavior = exports.PERFORMANCE_BEHAVIOR_OPTIONS = void 0;
+const common_1 = require("@nestjs/common");
+const pipeline_behavior_decorator_js_1 = require("../decorators/pipeline-behavior.decorator.js");
+/**
+ * Injection token for PerformanceBehavior options
+ */
+exports.PERFORMANCE_BEHAVIOR_OPTIONS = 'PERFORMANCE_BEHAVIOR_OPTIONS';
+/**
+ * Pipeline behavior that tracks request performance.
+ * Logs warnings for requests that exceed a configurable threshold.
+ *
+ * Priority: 10 (executes early to measure total pipeline time)
+ *
+ * @example
+ * ```typescript
+ * // Slow request output:
+ * // [Performance] SLOW REQUEST: GetAllUsersQuery took 1234ms (threshold: 500ms)
+ * ```
+ */
+let PerformanceBehavior = class PerformanceBehavior {
+    constructor(options) {
+        this.logger = new common_1.Logger('Performance');
+        this.thresholdMs = options?.thresholdMs ?? 500;
+        this.logAllRequests = options?.logAllRequests ?? false;
+    }
+    async handle(request, next) {
+        const requestName = this.getRequestName(request);
+        const startTime = performance.now();
+        try {
+            return await next();
+        }
+        finally {
+            const elapsed = Math.round(performance.now() - startTime);
+            if (elapsed > this.thresholdMs) {
+                this.logger.warn(`SLOW REQUEST: ${requestName} took ${elapsed}ms (threshold: ${this.thresholdMs}ms)`);
+            }
+            else if (this.logAllRequests) {
+                this.logger.debug(`${requestName} completed in ${elapsed}ms`);
+            }
+        }
+    }
+    getRequestName(request) {
+        if (request && typeof request === 'object' && request.constructor) {
+            return request.constructor.name;
+        }
+        return 'UnknownRequest';
+    }
+};
+exports.PerformanceBehavior = PerformanceBehavior;
+exports.PerformanceBehavior = PerformanceBehavior = __decorate([
+    (0, common_1.Injectable)(),
+    (0, pipeline_behavior_decorator_js_1.PipelineBehavior)({ priority: 10, scope: 'all' }),
+    __param(0, (0, common_1.Optional)()),
+    __param(0, (0, common_1.Inject)(exports.PERFORMANCE_BEHAVIOR_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], PerformanceBehavior);
+//# sourceMappingURL=performance.behavior.js.map

package/dist/lib/behaviors/performance.behavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.behavior.js","sourceRoot":"","sources":["../../../src/lib/behaviors/performance.behavior.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAsE;AAEtE,iGAAgF;AAEhF;;GAEG;AACU,QAAA,4BAA4B,GAAG,8BAA8B,CAAC;AAmB3E;;;;;;;;;;;GAWG;AAGI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAO9B,YAGE,OAAoC;QAPrB,WAAM,GAAG,IAAI,eAAM,CAAC,aAAa,CAAC,CAAC;QASlD,IAAI,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,GAAG,CAAC;QAC/C,IAAI,CAAC,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,KAAK,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,MAAM,CACV,OAAiB,EACjB,IAA8B;QAE9B,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEpC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;YAE1D,IAAI,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,iBAAiB,WAAW,SAAS,OAAO,kBAAkB,IAAI,CAAC,WAAW,KAAK,CACpF,CAAC;YACJ,CAAC;iBAAM,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,iBAAiB,OAAO,IAAI,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,OAAiB;QACtC,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAClE,OAAO,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,CAAC;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF,CAAA;AA5CY,kDAAmB;8BAAnB,mBAAmB;IAF/B,IAAA,mBAAU,GAAE;IACZ,IAAA,iDAAgB,EAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAS5C,WAAA,IAAA,iBAAQ,GAAE,CAAA;IACV,WAAA,IAAA,eAAM,EAAC,oCAA4B,CAAC,CAAA;;GAT5B,mBAAmB,CA4C/B"}

package/dist/lib/behaviors/validation.behavior.d.ts

@@ -0,0 +1,69 @@
+import { IPipelineBehavior } from '../interfaces/pipeline-behavior.interface.js';
+import { ValidationError } from '../exceptions/validation.exception.js';
+/**
+ * Interface for custom validators.
+ * Implement this interface to create validators for specific request types.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * export class CreateUserCommandValidator implements IValidator<CreateUserCommand> {
+ *   async validate(request: CreateUserCommand): Promise<ValidationError[]> {
+ *     const errors: ValidationError[] = [];
+ *
+ *     if (!request.email) {
+ *       errors.push({ property: 'email', message: 'Email is required' });
+ *     }
+ *
+ *     return errors;
+ *   }
+ * }
+ * ```
+ */
+export interface IValidator<TRequest> {
+    /**
+     * Validate the request and return any validation errors.
+     * Return an empty array if validation passes.
+     */
+    validate(request: TRequest): Promise<ValidationError[]>;
+}
+/**
+ * Metadata key for validator registration
+ */
+export declare const VALIDATOR_METADATA = "VALIDATOR_METADATA";
+/**
+ * Pipeline behavior that performs validation using class-validator.
+ * Validates request objects decorated with class-validator decorators.
+ *
+ * Priority: 100 (executes after logging but before handler)
+ *
+ * This behavior integrates with class-validator if available.
+ * It will validate any request object that has class-validator decorators.
+ *
+ * @example
+ * ```typescript
+ * // Request with class-validator decorators
+ * class CreateUserCommand implements ICommand {
+ *   @IsEmail()
+ *   email: string;
+ *
+ *   @IsString()
+ *   @MinLength(2)
+ *   name: string;
+ * }
+ *
+ * // The ValidationBehavior will automatically validate this command
+ * await mediator.send(new CreateUserCommand('invalid', 'a'));
+ * // Throws ValidationException with details about the errors
+ * ```
+ */
+export declare class ValidationBehavior<TRequest = any, TResponse = any> implements IPipelineBehavior<TRequest, TResponse> {
+    private classValidatorAvailable;
+    private validateFn;
+    private getMetadataStorageFn;
+    handle(request: TRequest, next: () => Promise<TResponse>): Promise<TResponse>;
+    private validateRequest;
+    private loadClassValidator;
+    private transformClassValidatorErrors;
+}
+//# sourceMappingURL=validation.behavior.d.ts.map

package/dist/lib/behaviors/validation.behavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.behavior.d.ts","sourceRoot":"","sources":["../../../src/lib/behaviors/validation.behavior.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAEjF,OAAO,EAEL,eAAe,EAChB,MAAM,uCAAuC,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,UAAU,CAAC,QAAQ;IAClC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CACzD;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAEa,kBAAkB,CAAC,QAAQ,GAAG,GAAG,EAAE,SAAS,GAAG,GAAG,CAC7D,YAAW,iBAAiB,CAAC,QAAQ,EAAE,SAAS,CAAC;IAEjD,OAAO,CAAC,uBAAuB,CAAwB;IACvD,OAAO,CAAC,UAAU,CAAkD;IACpE,OAAO,CAAC,oBAAoB,CAA4B;IAElD,MAAM,CACV,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,GAC7B,OAAO,CAAC,SAAS,CAAC;YAeP,eAAe;YAmCf,kBAAkB;IAwBhC,OAAO,CAAC,6BAA6B;CA6BtC"}

package/dist/lib/behaviors/validation.behavior.js

@@ -0,0 +1,137 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationBehavior = exports.VALIDATOR_METADATA = void 0;
+const common_1 = require("@nestjs/common");
+const pipeline_behavior_decorator_js_1 = require("../decorators/pipeline-behavior.decorator.js");
+const validation_exception_js_1 = require("../exceptions/validation.exception.js");
+/**
+ * Metadata key for validator registration
+ */
+exports.VALIDATOR_METADATA = 'VALIDATOR_METADATA';
+/**
+ * Pipeline behavior that performs validation using class-validator.
+ * Validates request objects decorated with class-validator decorators.
+ *
+ * Priority: 100 (executes after logging but before handler)
+ *
+ * This behavior integrates with class-validator if available.
+ * It will validate any request object that has class-validator decorators.
+ *
+ * @example
+ * ```typescript
+ * // Request with class-validator decorators
+ * class CreateUserCommand implements ICommand {
+ *   @IsEmail()
+ *   email: string;
+ *
+ *   @IsString()
+ *   @MinLength(2)
+ *   name: string;
+ * }
+ *
+ * // The ValidationBehavior will automatically validate this command
+ * await mediator.send(new CreateUserCommand('invalid', 'a'));
+ * // Throws ValidationException with details about the errors
+ * ```
+ */
+let ValidationBehavior = class ValidationBehavior {
+    constructor() {
+        this.classValidatorAvailable = null;
+        this.validateFn = null;
+        this.getMetadataStorageFn = null;
+    }
+    async handle(request, next) {
+        // Only validate objects
+        if (!request || typeof request !== 'object') {
+            return next();
+        }
+        const errors = await this.validateRequest(request);
+        if (errors.length > 0) {
+            throw new validation_exception_js_1.ValidationException(errors);
+        }
+        return next();
+    }
+    async validateRequest(request) {
+        // Try to use class-validator if available
+        await this.loadClassValidator();
+        if (this.validateFn && this.getMetadataStorageFn) {
+            try {
+                // Check if the class has any validation decorators
+                const metadataStorage = this.getMetadataStorageFn();
+                const targetConstructor = request.constructor;
+                // Get validation metadata for this class
+                const targetMetadatas = metadataStorage.getTargetValidationMetadatas(targetConstructor, targetConstructor.name, true, // always
+                false // strictGroups
+                ) || [];
+                // If no validation decorators, skip validation
+                if (targetMetadatas.length === 0) {
+                    return [];
+                }
+                const classValidatorErrors = await this.validateFn(request);
+                return this.transformClassValidatorErrors(classValidatorErrors);
+            }
+            catch {
+                // class-validator failed, skip validation
+                return [];
+            }
+        }
+        return [];
+    }
+    async loadClassValidator() {
+        if (this.classValidatorAvailable !== null) {
+            return;
+        }
+        try {
+            // Dynamic import to avoid hard dependency on class-validator
+            // Using Function constructor to prevent TypeScript from resolving the module
+            const importFn = new Function('moduleName', 'return import(moduleName)');
+            const classValidator = await importFn('class-validator');
+            this.validateFn = classValidator.validate;
+            this.getMetadataStorageFn = classValidator.getMetadataStorage;
+            this.classValidatorAvailable = true;
+        }
+        catch {
+            this.classValidatorAvailable = false;
+            this.validateFn = null;
+            this.getMetadataStorageFn = null;
+        }
+    }
+    transformClassValidatorErrors(errors) {
+        const result = [];
+        for (const error of errors) {
+            if (error.constraints) {
+                const messages = Object.values(error.constraints);
+                for (const message of messages) {
+                    result.push({
+                        property: error.property,
+                        message,
+                        value: error.value,
+                    });
+                }
+            }
+            // Handle nested validation errors
+            if (error.children && error.children.length > 0) {
+                const childErrors = this.transformClassValidatorErrors(error.children);
+                for (const childError of childErrors) {
+                    result.push({
+                        ...childError,
+                        property: `${error.property}.${childError.property}`,
+                    });
+                }
+            }
+        }
+        return result;
+    }
+};
+exports.ValidationBehavior = ValidationBehavior;
+exports.ValidationBehavior = ValidationBehavior = __decorate([
+    (0, common_1.Injectable)(),
+    (0, pipeline_behavior_decorator_js_1.PipelineBehavior)({ priority: 100, scope: 'all' })
+], ValidationBehavior);
+//# sourceMappingURL=validation.behavior.js.map

package/dist/lib/behaviors/validation.behavior.js.map

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

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

@@ -1,3 +1,5 @@
 export * from './command-handler.decorator.js';
 export * from './query-handler.decorator.js';
+export * from './pipeline-behavior.decorator.js';
+export * from './skip-behavior.decorator.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC"}

package/dist/lib/decorators/index.js

@@ -16,4 +16,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./command-handler.decorator.js"), exports);
 __exportStar(require("./query-handler.decorator.js"), exports);
+__exportStar(require("./pipeline-behavior.decorator.js"), exports);
+__exportStar(require("./skip-behavior.decorator.js"), exports);
 //# sourceMappingURL=index.js.map

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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iEAA+C;AAC/C,+DAA6C;AAC7C,mEAAiD;AACjD,+DAA6C"}

package/dist/lib/decorators/pipeline-behavior.decorator.d.ts

@@ -0,0 +1,51 @@
+import { PipelineBehaviorOptions } from '../interfaces/pipeline-behavior.interface.js';
+/**
+ * Metadata key for pipeline behavior registration
+ */
+export declare const PIPELINE_BEHAVIOR_METADATA = "PIPELINE_BEHAVIOR_METADATA";
+/**
+ * Decorator that marks a class as a pipeline behavior.
+ * Pipeline behaviors execute around request handlers, enabling cross-cutting concerns.
+ *
+ * @param options - Configuration options for the behavior
+ * @returns Class decorator
+ *
+ * @example
+ * ```typescript
+ * // Basic usage - applies to all requests with default priority
+ * @Injectable()
+ * @PipelineBehavior()
+ * export class LoggingBehavior implements IPipelineBehavior {
+ *   async handle(request, next) {
+ *     console.log('Handling:', request);
+ *     return next();
+ *   }
+ * }
+ *
+ * // With priority - lower numbers execute first (outermost)
+ * @Injectable()
+ * @PipelineBehavior({ priority: -100 })
+ * export class ExceptionHandlingBehavior implements IPipelineBehavior {
+ *   async handle(request, next) {
+ *     try {
+ *       return await next();
+ *     } catch (error) {
+ *       // Handle error
+ *       throw error;
+ *     }
+ *   }
+ * }
+ *
+ * // Scoped to commands only
+ * @Injectable()
+ * @PipelineBehavior({ priority: 100, scope: 'command' })
+ * export class CommandValidationBehavior implements IPipelineBehavior {
+ *   async handle(request, next) {
+ *     await this.validate(request);
+ *     return next();
+ *   }
+ * }
+ * ```
+ */
+export declare const PipelineBehavior: (options?: PipelineBehaviorOptions) => ClassDecorator;
+//# sourceMappingURL=pipeline-behavior.decorator.d.ts.map

package/dist/lib/decorators/pipeline-behavior.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-behavior.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/pipeline-behavior.decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AAEvF;;GAEG;AACH,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AAUvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,uBAAuB,KAChC,cAMF,CAAC"}