@rolandsall24/nest-mediator 0.4.3 → 0.5.1

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

@@ -0,0 +1,52 @@
+import { Type } from '@nestjs/common/interfaces';
+import { IPipelineBehavior } from '../interfaces/pipeline-behavior.interface';
+/**
+ * Metadata key for storing behaviors to skip on a command/query class
+ */
+export declare const SKIP_BEHAVIORS_METADATA = "SKIP_BEHAVIORS_METADATA";
+/**
+ * Decorator to skip one or more pipeline behaviors for a specific command or query.
+ *
+ * Works with both built-in behaviors (PerformanceBehavior, LoggingBehavior, etc.)
+ * and custom behaviors.
+ *
+ * @example
+ * ```typescript
+ * import { PerformanceBehavior, LoggingBehavior } from '@rolandsall24/nest-mediator';
+ *
+ * // Skip a single behavior
+ * @SkipBehavior(PerformanceBehavior)
+ * export class HighFrequencyCommand {}
+ *
+ * // Skip multiple behaviors
+ * @SkipBehavior([PerformanceBehavior, LoggingBehavior])
+ * export class HealthCheckCommand {}
+ * ```
+ */
+export declare const SkipBehavior: (behavior: Type<IPipelineBehavior> | Type<IPipelineBehavior>[]) => ClassDecorator;
+/**
+ * Decorator to skip multiple pipeline behaviors for a specific command or query.
+ *
+ * Works with both built-in behaviors and custom behaviors.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   PerformanceBehavior,
+ *   LoggingBehavior,
+ *   ValidationBehavior
+ * } from '@rolandsall24/nest-mediator';
+ *
+ * @SkipBehaviors([PerformanceBehavior, LoggingBehavior])
+ * export class HealthCheckCommand {
+ *   // This command will skip performance and logging behaviors
+ * }
+ *
+ * @SkipBehaviors([ValidationBehavior])
+ * export class InternalCommand {
+ *   // This command will skip validation (use with caution!)
+ * }
+ * ```
+ */
+export declare const SkipBehaviors: (behaviors: Type<IPipelineBehavior>[]) => ClassDecorator;
+//# sourceMappingURL=skip-behavior.decorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skip-behavior.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/skip-behavior.decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,uBAAuB,4BAA4B,CAAC;AAEjE;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,IAAI,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,KAC5D,cAGF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,aAAa,GACxB,WAAW,IAAI,CAAC,iBAAiB,CAAC,EAAE,KACnC,cAEF,CAAC"}

package/dist/lib/decorators/skip-behavior.decorator.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkipBehaviors = exports.SkipBehavior = exports.SKIP_BEHAVIORS_METADATA = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Metadata key for storing behaviors to skip on a command/query class
+ */
+exports.SKIP_BEHAVIORS_METADATA = 'SKIP_BEHAVIORS_METADATA';
+/**
+ * Decorator to skip one or more pipeline behaviors for a specific command or query.
+ *
+ * Works with both built-in behaviors (PerformanceBehavior, LoggingBehavior, etc.)
+ * and custom behaviors.
+ *
+ * @example
+ * ```typescript
+ * import { PerformanceBehavior, LoggingBehavior } from '@rolandsall24/nest-mediator';
+ *
+ * // Skip a single behavior
+ * @SkipBehavior(PerformanceBehavior)
+ * export class HighFrequencyCommand {}
+ *
+ * // Skip multiple behaviors
+ * @SkipBehavior([PerformanceBehavior, LoggingBehavior])
+ * export class HealthCheckCommand {}
+ * ```
+ */
+const SkipBehavior = (behavior) => {
+    const behaviors = Array.isArray(behavior) ? behavior : [behavior];
+    return (0, common_1.SetMetadata)(exports.SKIP_BEHAVIORS_METADATA, behaviors);
+};
+exports.SkipBehavior = SkipBehavior;
+/**
+ * Decorator to skip multiple pipeline behaviors for a specific command or query.
+ *
+ * Works with both built-in behaviors and custom behaviors.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   PerformanceBehavior,
+ *   LoggingBehavior,
+ *   ValidationBehavior
+ * } from '@rolandsall24/nest-mediator';
+ *
+ * @SkipBehaviors([PerformanceBehavior, LoggingBehavior])
+ * export class HealthCheckCommand {
+ *   // This command will skip performance and logging behaviors
+ * }
+ *
+ * @SkipBehaviors([ValidationBehavior])
+ * export class InternalCommand {
+ *   // This command will skip validation (use with caution!)
+ * }
+ * ```
+ */
+const SkipBehaviors = (behaviors) => {
+    return (0, common_1.SetMetadata)(exports.SKIP_BEHAVIORS_METADATA, behaviors);
+};
+exports.SkipBehaviors = SkipBehaviors;
+//# sourceMappingURL=skip-behavior.decorator.js.map

package/dist/lib/decorators/skip-behavior.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skip-behavior.decorator.js","sourceRoot":"","sources":["../../../src/lib/decorators/skip-behavior.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAI7C;;GAEG;AACU,QAAA,uBAAuB,GAAG,yBAAyB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;GAkBG;AACI,MAAM,YAAY,GAAG,CAC1B,QAA6D,EAC7C,EAAE;IAClB,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAClE,OAAO,IAAA,oBAAW,EAAC,+BAAuB,EAAE,SAAS,CAAC,CAAC;AACzD,CAAC,CAAC;AALW,QAAA,YAAY,gBAKvB;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,MAAM,aAAa,GAAG,CAC3B,SAAoC,EACpB,EAAE;IAClB,OAAO,IAAA,oBAAW,EAAC,+BAAuB,EAAE,SAAS,CAAC,CAAC;AACzD,CAAC,CAAC;AAJW,QAAA,aAAa,iBAIxB"}

package/dist/lib/exceptions/handler-not-found.exception.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Exception thrown when no handler is registered for a request.
+ *
+ * @example
+ * ```typescript
+ * throw new HandlerNotFoundException('CreateUserCommand', 'command');
+ * ```
+ */
+export declare class HandlerNotFoundException extends Error {
+    readonly requestName: string;
+    readonly requestType: 'command' | 'query';
+    constructor(requestName: string, requestType: 'command' | 'query');
+    toJSON(): {
+        name: string;
+        message: string;
+        requestName: string;
+        requestType: string;
+    };
+}
+//# sourceMappingURL=handler-not-found.exception.d.ts.map

package/dist/lib/exceptions/handler-not-found.exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-not-found.exception.d.ts","sourceRoot":"","sources":["../../../src/lib/exceptions/handler-not-found.exception.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC;gBAErC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,GAAG,OAAO;IAYjE,MAAM,IAAI;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB;CAQF"}

package/dist/lib/exceptions/handler-not-found.exception.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandlerNotFoundException = void 0;
+/**
+ * Exception thrown when no handler is registered for a request.
+ *
+ * @example
+ * ```typescript
+ * throw new HandlerNotFoundException('CreateUserCommand', 'command');
+ * ```
+ */
+class HandlerNotFoundException extends Error {
+    constructor(requestName, requestType) {
+        const message = `No handler registered for ${requestType}: ${requestName}. Did you forget to add @${requestType === 'command' ? 'CommandHandler' : 'QueryHandler'} decorator?`;
+        super(message);
+        this.name = 'HandlerNotFoundException';
+        this.requestName = requestName;
+        this.requestType = requestType;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, HandlerNotFoundException);
+        }
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            requestName: this.requestName,
+            requestType: this.requestType,
+        };
+    }
+}
+exports.HandlerNotFoundException = HandlerNotFoundException;
+//# sourceMappingURL=handler-not-found.exception.js.map

package/dist/lib/exceptions/handler-not-found.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-not-found.exception.js","sourceRoot":"","sources":["../../../src/lib/exceptions/handler-not-found.exception.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,MAAa,wBAAyB,SAAQ,KAAK;IAIjD,YAAY,WAAmB,EAAE,WAAgC;QAC/D,MAAM,OAAO,GAAG,6BAA6B,WAAW,KAAK,WAAW,4BAA4B,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,cAAc,aAAa,CAAC;QAC/K,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAE/B,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,MAAM;QAMJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;IACJ,CAAC;CACF;AA7BD,4DA6BC"}

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

@@ -0,0 +1,3 @@
+export * from './validation.exception.js';
+export * from './handler-not-found.exception.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/lib/exceptions/index.js

@@ -0,0 +1,19 @@
+"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("./validation.exception.js"), exports);
+__exportStar(require("./handler-not-found.exception.js"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/exceptions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,mEAAiD"}

package/dist/lib/exceptions/validation.exception.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Represents a single validation error
+ */
+export interface ValidationError {
+    /**
+     * The property or field that failed validation
+     */
+    property: string;
+    /**
+     * Human-readable error message
+     */
+    message: string;
+    /**
+     * Optional error code for programmatic handling
+     */
+    code?: string;
+    /**
+     * The value that failed validation (optional)
+     */
+    value?: any;
+    /**
+     * Nested validation errors for complex objects
+     */
+    children?: ValidationError[];
+}
+/**
+ * Exception thrown when request validation fails.
+ * Contains detailed information about all validation errors.
+ *
+ * @example
+ * ```typescript
+ * throw new ValidationException([
+ *   { property: 'email', message: 'Email is required' },
+ *   { property: 'age', message: 'Age must be at least 18', code: 'MIN_AGE' }
+ * ]);
+ * ```
+ */
+export declare class ValidationException extends Error {
+    readonly errors: ValidationError[];
+    constructor(errors: ValidationError[]);
+    /**
+     * Format validation errors into a readable message
+     */
+    private static formatMessage;
+    /**
+     * Get errors for a specific property
+     */
+    getErrorsForProperty(property: string): ValidationError[];
+    /**
+     * Check if a specific property has errors
+     */
+    hasErrorForProperty(property: string): boolean;
+    /**
+     * Convert to a plain object for serialization
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        errors: ValidationError[];
+    };
+}
+//# sourceMappingURL=validation.exception.d.ts.map

package/dist/lib/exceptions/validation.exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.exception.d.ts","sourceRoot":"","sources":["../../../src/lib/exceptions/validation.exception.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,GAAG,CAAC;IAEZ;;OAEG;IACH,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,MAAM,EAAE,eAAe,EAAE,CAAC;gBAE9B,MAAM,EAAE,eAAe,EAAE;IAYrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAgB5B;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE;IAIzD;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9C;;OAEG;IACH,MAAM,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,eAAe,EAAE,CAAA;KAAE;CAOvE"}

package/dist/lib/exceptions/validation.exception.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationException = void 0;
+/**
+ * Exception thrown when request validation fails.
+ * Contains detailed information about all validation errors.
+ *
+ * @example
+ * ```typescript
+ * throw new ValidationException([
+ *   { property: 'email', message: 'Email is required' },
+ *   { property: 'age', message: 'Age must be at least 18', code: 'MIN_AGE' }
+ * ]);
+ * ```
+ */
+class ValidationException extends Error {
+    constructor(errors) {
+        const message = ValidationException.formatMessage(errors);
+        super(message);
+        this.name = 'ValidationException';
+        this.errors = errors;
+        // Maintains proper stack trace for where error was thrown (V8 engines)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ValidationException);
+        }
+    }
+    /**
+     * Format validation errors into a readable message
+     */
+    static formatMessage(errors) {
+        if (errors.length === 0) {
+            return 'Validation failed';
+        }
+        if (errors.length === 1) {
+            return `Validation failed: ${errors[0].property} - ${errors[0].message}`;
+        }
+        const errorMessages = errors
+            .map((e) => `${e.property}: ${e.message}`)
+            .join('; ');
+        return `Validation failed with ${errors.length} errors: ${errorMessages}`;
+    }
+    /**
+     * Get errors for a specific property
+     */
+    getErrorsForProperty(property) {
+        return this.errors.filter((e) => e.property === property);
+    }
+    /**
+     * Check if a specific property has errors
+     */
+    hasErrorForProperty(property) {
+        return this.errors.some((e) => e.property === property);
+    }
+    /**
+     * Convert to a plain object for serialization
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            errors: this.errors,
+        };
+    }
+}
+exports.ValidationException = ValidationException;
+//# sourceMappingURL=validation.exception.js.map

package/dist/lib/exceptions/validation.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.exception.js","sourceRoot":"","sources":["../../../src/lib/exceptions/validation.exception.ts"],"names":[],"mappings":";;;AA8BA;;;;;;;;;;;GAWG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAG5C,YAAY,MAAyB;QACnC,MAAM,OAAO,GAAG,mBAAmB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,uEAAuE;QACvE,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,aAAa,CAAC,MAAyB;QACpD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,mBAAmB,CAAC;QAC7B,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,sBAAsB,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAC3E,CAAC;QAED,MAAM,aAAa,GAAG,MAAM;aACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aACzC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO,0BAA0B,MAAM,CAAC,MAAM,YAAY,aAAa,EAAE,CAAC;IAC5E,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,QAAgB;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,QAAgB;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF;AA1DD,kDA0DC"}

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

@@ -2,4 +2,5 @@ export * from './command.interface.js';
 export * from './query.interface.js';
 export * from './command-handler.interface.js';
 export * from './query-handler.interface.js';
+export * from './pipeline-behavior.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"}
+{"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"}

package/dist/lib/interfaces/index.js

@@ -18,4 +18,5 @@ __exportStar(require("./command.interface.js"), exports);
 __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);
 //# 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"}
+{"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"}

package/dist/lib/interfaces/pipeline-behavior.interface.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Pipeline behavior interface for implementing cross-cutting concerns.
+ * Behaviors wrap around request handlers, allowing pre/post processing.
+ *
+ * @template TRequest - The request type (command or query)
+ * @template TResponse - The response type
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * @PipelineBehavior({ priority: 100 })
+ * export class LoggingBehavior<TRequest, TResponse>
+ *   implements IPipelineBehavior<TRequest, TResponse> {
+ *
+ *   async handle(request: TRequest, next: () => Promise<TResponse>): Promise<TResponse> {
+ *     console.log('Before handler');
+ *     const response = await next();
+ *     console.log('After handler');
+ *     return response;
+ *   }
+ * }
+ * ```
+ */
+export interface IPipelineBehavior<TRequest = any, TResponse = any> {
+    /**
+     * Handle the request by executing pre-processing logic,
+     * calling the next behavior/handler in the pipeline,
+     * and executing post-processing logic.
+     *
+     * @param request - The incoming request object
+     * @param next - Delegate to invoke the next behavior or final handler
+     * @returns Promise with the response
+     */
+    handle(request: TRequest, next: () => Promise<TResponse>): Promise<TResponse>;
+}
+/**
+ * Options for configuring pipeline behavior
+ */
+export interface PipelineBehaviorOptions {
+    /**
+     * Execution priority (lower numbers execute first).
+     * Default: 0
+     *
+     * Suggested priority ranges:
+     * - -100 to -1: Exception handling (outermost)
+     * - 0 to 99: Logging, performance tracking
+     * - 100 to 199: Validation
+     * - 200+: Transaction/Unit of Work (innermost)
+     */
+    priority?: number;
+    /**
+     * Scope of the behavior.
+     * - 'command': Only applies to commands (send)
+     * - 'query': Only applies to queries (query)
+     * - 'all': Applies to both commands and queries
+     * Default: 'all'
+     */
+    scope?: 'command' | 'query' | 'all';
+}
+//# sourceMappingURL=pipeline-behavior.interface.d.ts.map

package/dist/lib/interfaces/pipeline-behavior.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-behavior.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/pipeline-behavior.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,GAAG,EAAE,SAAS,GAAG,GAAG;IAChE;;;;;;;;OAQG;IACH,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAC/E;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,KAAK,CAAC;CACrC"}

package/dist/lib/interfaces/pipeline-behavior.interface.js

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

package/dist/lib/interfaces/pipeline-behavior.interface.js.map

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

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

@@ -1,6 +1,53 @@
-import { DynamicModule, OnModuleInit } from '@nestjs/common';
+import { DynamicModule, Type, OnModuleInit } from '@nestjs/common';
 import { Reflector, DiscoveryService } from '@nestjs/core';
 import { MediatorBus } from './services/index.js';
+import { IPipelineBehavior } from './interfaces/index.js';
+/**
+ * Configuration options for NestMediatorModule
+ */
+export interface NestMediatorModuleOptions {
+    /**
+     * Enable built-in logging behavior.
+     * Logs request handling with timing information.
+     * Default: false
+     */
+    enableLogging?: boolean;
+    /**
+     * Enable built-in validation behavior.
+     * Validates requests using class-validator if available.
+     * Default: false
+     */
+    enableValidation?: boolean;
+    /**
+     * Enable built-in exception handling behavior.
+     * Provides centralized exception logging.
+     * Default: false
+     */
+    enableExceptionHandling?: boolean;
+    /**
+     * Enable built-in performance tracking behavior.
+     * Logs warnings for slow requests.
+     * Default: false
+     */
+    enablePerformanceTracking?: boolean;
+    /**
+     * Performance threshold in milliseconds.
+     * Requests exceeding this will be logged as warnings.
+     * Only applies when enablePerformanceTracking is true.
+     * Default: 500
+     */
+    performanceThresholdMs?: number;
+    /**
+     * Custom pipeline behaviors to register.
+     * These will be registered in addition to any behaviors
+     * discovered via @PipelineBehavior decorator.
+     */
+    behaviors?: Type<IPipelineBehavior<any, any>>[];
+}
+/**
+ * Token for module options injection
+ */
+export declare const NEST_MEDIATOR_OPTIONS = "NEST_MEDIATOR_OPTIONS";
 export declare class NestMediatorModule implements OnModuleInit {
     private readonly mediatorBus;
     private readonly reflector;
@@ -8,10 +55,32 @@ export declare class NestMediatorModule implements OnModuleInit {
     constructor(mediatorBus: MediatorBus, reflector: Reflector, discoveryService: DiscoveryService);
     onModuleInit(): void;
     /**
-     * Register the NestMediator module
-     * Handlers are automatically discovered from the application's providers
+     * Register the NestMediator module.
+     * Handlers and behaviors are automatically discovered from the application's providers.
+     *
+     * @param options - Optional configuration options
      * @returns Dynamic module
+     *
+     * @example
+     * ```typescript
+     * // Basic setup (no built-in behaviors)
+     * NestMediatorModule.forRoot()
+     *
+     * // Enable built-in behaviors
+     * NestMediatorModule.forRoot({
+     *   enableLogging: true,
+     *   enableValidation: true,
+     *   enableExceptionHandling: true,
+     *   enablePerformanceTracking: true,
+     *   performanceThresholdMs: 1000,
+     * })
+     *
+     * // With custom behaviors
+     * NestMediatorModule.forRoot({
+     *   behaviors: [MyCustomBehavior],
+     * })
+     * ```
      */
-    static forRoot(): DynamicModule;
+    static forRoot(options?: NestMediatorModuleOptions): DynamicModule;
 }
 //# sourceMappingURL=nest-mediator.module.d.ts.map

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;AAKlD,qBACa,kBAAmB,YAAW,YAAY;IAEjD,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;IAGvD,YAAY;IAiDZ;;;;OAIG;IACH,MAAM,CAAC,OAAO,IAAI,aAAa;CAahC"}
+{"version":3,"file":"nest-mediator.module.d.ts","sourceRoot":"","sources":["../../src/lib/nest-mediator.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,IAAI,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAmB,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMlD,OAAO,EAKL,iBAAiB,EAElB,MAAM,uBAAuB,CAAC;AAQ/B;;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;IAEhC;;;;OAIG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;CACjD;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;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,yBAA8B,GAAG,aAAa;CAwCvE"}

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,82 @@ 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.
+     * Handlers and behaviors are automatically discovered from the application's providers.
+     *
+     * @param options - Optional configuration options
      * @returns Dynamic module
+     *
+     * @example
+     * ```typescript
+     * // Basic setup (no built-in behaviors)
+     * NestMediatorModule.forRoot()
+     *
+     * // Enable built-in behaviors
+     * NestMediatorModule.forRoot({
+     *   enableLogging: true,
+     *   enableValidation: true,
+     *   enableExceptionHandling: true,
+     *   enablePerformanceTracking: true,
+     *   performanceThresholdMs: 1000,
+     * })
+     *
+     * // With custom behaviors
+     * NestMediatorModule.forRoot({
+     *   behaviors: [MyCustomBehavior],
+     * })
+     * ```
      */
-    static forRoot() {
+    static forRoot(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,