@pawells/nestjs-shared 1.0.0-dev.4c8c698

package/build/common/errors/base-application-error.js

@@ -0,0 +1,133 @@
+import { HTTP_STATUS_INTERNAL_SERVER_ERROR } from '../constants/http-status.constants.js';
+/**
+ * Base Application Error
+ *
+ * Provides a standardized error structure for NestJS applications with consistent
+ * properties and methods for error handling, serialization, and context management.
+ *
+ * @example
+ * ```typescript
+ * throw new BaseApplicationError('User not found', {
+ *   code: 'USER_NOT_FOUND',
+ *   statusCode: 404,
+ *   context: { userId: '123' }
+ * });
+ * ```
+ */
+export class BaseApplicationError extends Error {
+    /**
+     * The HTTP status code associated with this error
+     */
+    statusCode;
+    /**
+     * The error code for programmatic error identification
+     */
+    code;
+    /**
+     * Additional context information for debugging and logging
+     */
+    context;
+    /**
+     * Timestamp when the error was created
+     */
+    timestamp;
+    /**
+     * Creates a new BaseApplicationError instance
+     *
+     * @param message - The error message
+     * @param options - Configuration options for the error
+     * @param options.code - The error code (defaults to 'INTERNAL_SERVER_ERROR')
+     * @param options.statusCode - The HTTP status code (defaults to 500)
+     * @param options.context - Additional context information (defaults to empty object)
+     */
+    constructor(message, options = {}) {
+        super(message);
+        const { code = 'INTERNAL_SERVER_ERROR', statusCode = HTTP_STATUS_INTERNAL_SERVER_ERROR, context = {} } = options;
+        this.name = this.constructor.name;
+        this.statusCode = statusCode;
+        this.code = code;
+        this.context = { ...context };
+        this.timestamp = new Date();
+        // Capture stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Serializes the error to a plain object for JSON responses or logging
+     *
+     * @returns A plain object representation of the error
+     *
+     * @example
+     * ```typescript
+     * const error = new BaseApplicationError('Test error');
+     * console.log(error.toJSON());
+     * // {
+     * //   name: 'BaseApplicationError',
+     * //   message: 'Test error',
+     * //   code: 'INTERNAL_SERVER_ERROR',
+     * //   statusCode: 500,
+     * //   context: {},
+     * //   timestamp: '2023-01-01T00:00:00.000Z'
+     * // }
+     * ```
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            statusCode: this.statusCode,
+            context: this.context,
+            timestamp: this.timestamp.toISOString(),
+            // Include stack trace in development
+            ...(process.env['NODE_ENV'] !== 'production' ? { stack: this.stack } : {}),
+        };
+    }
+    /**
+     * Creates a new error instance with additional context merged into the existing context.
+     * Note: Returns a new instance, not the same instance, so instanceof checks will still work.
+     *
+     * @param additionalContext - Additional context to merge
+     * @returns A new error instance of the same type with merged context
+     *
+     * @example
+     * ```typescript
+     * const error = new BaseApplicationError('User error', { code: 'USER_ERROR' });
+     * const errorWithContext = error.withContext({ userId: '123', action: 'login' });
+     * // errorWithContext is a new instance but still instanceof BaseApplicationError
+     * // errorWithContext.context = { userId: '123', action: 'login' }
+     * ```
+     */
+    withContext(additionalContext) {
+        const mergedContext = { ...this.context, ...additionalContext };
+        const Constructor = this.constructor;
+        return new Constructor(this.message, {
+            code: this.code,
+            statusCode: this.statusCode,
+            context: mergedContext,
+        });
+    }
+    /**
+     * Creates a new error instance with a different message
+     *
+     * @param newMessage - The new error message
+     * @returns A new error instance with the updated message
+     *
+     * @example
+     * ```typescript
+     * const error = new BaseApplicationError('Generic error');
+     * const specificError = error.withMessage('User not found');
+     * // specificError.message = 'User not found'
+     * ```
+     */
+    withMessage(newMessage) {
+        const Constructor = this.constructor;
+        return new Constructor(newMessage, {
+            code: this.code,
+            statusCode: this.statusCode,
+            context: this.context,
+        });
+    }
+}
+//# sourceMappingURL=base-application-error.js.map

package/build/common/errors/base-application-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-application-error.js","sourceRoot":"","sources":["../../../src/common/errors/base-application-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,uCAAuC,CAAC;AAE1F;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC9C;;OAEG;IACa,UAAU,CAAS;IAEnC;;OAEG;IACa,IAAI,CAAS;IAE7B;;OAEG;IACa,OAAO,CAAsB;IAE7C;;OAEG;IACa,SAAS,CAAO;IAEhC;;;;;;;;OAQG;IACH,YACC,OAAe,EACf,UAII,EAAE;QAEN,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,MAAM,EAAE,IAAI,GAAG,uBAAuB,EAAE,UAAU,GAAG,iCAAiC,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;QAEjH,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAE5B,sBAAsB;QACtB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC7B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACjD,CAAC;IACF,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACI,MAAM;QACZ,OAAO;YACN,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;YACvC,qCAAqC;YACrC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1E,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACI,WAAW,CAAC,iBAAsC;QACxD,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,iBAAiB,EAAE,CAAC;QAChE,MAAM,WAAW,GAAG,IAAI,CAAC,WAGhB,CAAC;QAEV,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;YACpC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,aAAa;SACtB,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,WAAW,CAAC,UAAkB;QACpC,MAAM,WAAW,GAAG,IAAI,CAAC,WAGhB,CAAC;QAEV,OAAO,IAAI,WAAW,CAAC,UAAU,EAAE;YAClC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC,CAAC;IACJ,CAAC;CACD"}

package/build/common/errors/error-factory.d.ts

@@ -0,0 +1,93 @@
+import { BaseApplicationError } from './base-application-error.js';
+/**
+ * Configuration interface for creating error classes
+ */
+export interface ErrorConfig {
+    /** The error code for programmatic identification */
+    code: string;
+    /** The HTTP status code */
+    statusCode: number;
+    /** Default error message */
+    defaultMessage: string;
+    /** Optional error class name (defaults to code + 'Error') */
+    name?: string;
+}
+/**
+ * Factory function to create application error classes
+ *
+ * This factory eliminates code duplication by generating error classes
+ * from configuration objects instead of defining each class individually.
+ *
+ * @param config - Configuration for the error class
+ * @returns An application error class constructor
+ *
+ * @example
+ * ```typescript
+ * export const NotFoundError = createError({
+ *   code: 'NOT_FOUND',
+ *   statusCode: 404,
+ *   defaultMessage: 'Resource not found'
+ * });
+ * ```
+ */
+export declare function createError(config: ErrorConfig): typeof BaseApplicationError;
+/**
+ * Error configurations for all standard HTTP error types
+ */
+export declare const ERROR_CONFIGS: {
+    readonly BAD_REQUEST: {
+        readonly code: "BAD_REQUEST";
+        readonly statusCode: 400;
+        readonly defaultMessage: "Bad request";
+    };
+    readonly UNAUTHORIZED: {
+        readonly code: "UNAUTHORIZED";
+        readonly statusCode: 401;
+        readonly defaultMessage: "Unauthorized";
+    };
+    readonly FORBIDDEN: {
+        readonly code: "FORBIDDEN";
+        readonly statusCode: 403;
+        readonly defaultMessage: "Forbidden";
+    };
+    readonly NOT_FOUND: {
+        readonly code: "NOT_FOUND";
+        readonly statusCode: 404;
+        readonly defaultMessage: "Not found";
+    };
+    readonly CONFLICT: {
+        readonly code: "CONFLICT";
+        readonly statusCode: 409;
+        readonly defaultMessage: "Conflict";
+    };
+    readonly UNPROCESSABLE_ENTITY: {
+        readonly code: "UNPROCESSABLE_ENTITY";
+        readonly statusCode: 422;
+        readonly defaultMessage: "Unprocessable entity";
+    };
+    readonly INTERNAL_SERVER_ERROR: {
+        readonly code: "INTERNAL_SERVER_ERROR";
+        readonly statusCode: 500;
+        readonly defaultMessage: "Internal server error";
+    };
+    readonly BAD_GATEWAY: {
+        readonly code: "BAD_GATEWAY";
+        readonly statusCode: 502;
+        readonly defaultMessage: "Bad gateway";
+    };
+    readonly SERVICE_UNAVAILABLE: {
+        readonly code: "SERVICE_UNAVAILABLE";
+        readonly statusCode: 503;
+        readonly defaultMessage: "Service unavailable";
+    };
+    readonly GATEWAY_TIMEOUT: {
+        readonly code: "GATEWAY_TIMEOUT";
+        readonly statusCode: 504;
+        readonly defaultMessage: "Gateway timeout";
+    };
+};
+/**
+ * Type for error configuration keys
+ */
+export type ErrorType = keyof typeof ERROR_CONFIGS;
+//# sourceMappingURL=error-factory.d.ts.map

package/build/common/errors/error-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-factory.d.ts","sourceRoot":"","sources":["../../../src/common/errors/error-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,oBAAoB,CAgC5E;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDhB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,aAAa,CAAC"}

package/build/common/errors/error-factory.js

@@ -0,0 +1,105 @@
+import { BaseApplicationError } from './base-application-error.js';
+/**
+ * Factory function to create application error classes
+ *
+ * This factory eliminates code duplication by generating error classes
+ * from configuration objects instead of defining each class individually.
+ *
+ * @param config - Configuration for the error class
+ * @returns An application error class constructor
+ *
+ * @example
+ * ```typescript
+ * export const NotFoundError = createError({
+ *   code: 'NOT_FOUND',
+ *   statusCode: 404,
+ *   defaultMessage: 'Resource not found'
+ * });
+ * ```
+ */
+export function createError(config) {
+    const { code, statusCode, defaultMessage, name = `${code}Error` } = config;
+    /**
+     * Dynamically created application error class
+     */
+    class GeneratedApplicationError extends BaseApplicationError {
+        /**
+         * Creates a new error instance
+         *
+         * @param message - Custom error message (optional)
+         * @param context - Additional context information (optional)
+         */
+        constructor(message = defaultMessage, context) {
+            const options = {
+                code,
+                statusCode,
+            };
+            if (context !== undefined) {
+                options.context = context;
+            }
+            super(message, options);
+        }
+    }
+    // Set the class name for better debugging and instanceof checks
+    Object.defineProperty(GeneratedApplicationError, 'name', {
+        value: name,
+        writable: false,
+    });
+    return GeneratedApplicationError;
+}
+/**
+ * Error configurations for all standard HTTP error types
+ */
+export const ERROR_CONFIGS = {
+    BAD_REQUEST: {
+        code: 'BAD_REQUEST',
+        statusCode: 400,
+        defaultMessage: 'Bad request',
+    },
+    UNAUTHORIZED: {
+        code: 'UNAUTHORIZED',
+        statusCode: 401,
+        defaultMessage: 'Unauthorized',
+    },
+    FORBIDDEN: {
+        code: 'FORBIDDEN',
+        statusCode: 403,
+        defaultMessage: 'Forbidden',
+    },
+    NOT_FOUND: {
+        code: 'NOT_FOUND',
+        statusCode: 404,
+        defaultMessage: 'Not found',
+    },
+    CONFLICT: {
+        code: 'CONFLICT',
+        statusCode: 409,
+        defaultMessage: 'Conflict',
+    },
+    UNPROCESSABLE_ENTITY: {
+        code: 'UNPROCESSABLE_ENTITY',
+        statusCode: 422,
+        defaultMessage: 'Unprocessable entity',
+    },
+    INTERNAL_SERVER_ERROR: {
+        code: 'INTERNAL_SERVER_ERROR',
+        statusCode: 500,
+        defaultMessage: 'Internal server error',
+    },
+    BAD_GATEWAY: {
+        code: 'BAD_GATEWAY',
+        statusCode: 502,
+        defaultMessage: 'Bad gateway',
+    },
+    SERVICE_UNAVAILABLE: {
+        code: 'SERVICE_UNAVAILABLE',
+        statusCode: 503,
+        defaultMessage: 'Service unavailable',
+    },
+    GATEWAY_TIMEOUT: {
+        code: 'GATEWAY_TIMEOUT',
+        statusCode: 504,
+        defaultMessage: 'Gateway timeout',
+    },
+};
+//# sourceMappingURL=error-factory.js.map

package/build/common/errors/error-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-factory.js","sourceRoot":"","sources":["../../../src/common/errors/error-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAgBnE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC9C,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,IAAI,GAAG,GAAG,IAAI,OAAO,EAAE,GAAG,MAAM,CAAC;IAE3E;;OAEG;IACH,MAAM,yBAA0B,SAAQ,oBAAoB;QAC3D;;;;;WAKG;QACH,YAAY,OAAO,GAAG,cAAc,EAAE,OAA6B;YAClE,MAAM,OAAO,GAAQ;gBACpB,IAAI;gBACJ,UAAU;aACV,CAAC;YACF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;YAC3B,CAAC;YACD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzB,CAAC;KACD;IAED,gEAAgE;IAChE,MAAM,CAAC,cAAc,CAAC,yBAAyB,EAAE,MAAM,EAAE;QACxD,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,KAAK;KACf,CAAC,CAAC;IAEH,OAAO,yBAAyB,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC5B,WAAW,EAAE;QACZ,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,GAAG;QACf,cAAc,EAAE,aAAa;KAC7B;IACD,YAAY,EAAE;QACb,IAAI,EAAE,cAAc;QACpB,UAAU,EAAE,GAAG;QACf,cAAc,EAAE,cAAc;KAC9B;IACD,SAAS,EAAE;QACV,IAAI,EAAE,WAAW;QACjB,UAAU,EAAE,GAAG;QACf,cAAc,EAAE,WAAW;KAC3B;IACD,SAAS,EAAE;QACV,IAAI,EAAE,WAAW;QACjB,UAAU,EAAE,GAAG;QACf,cAAc,EAAE,WAAW;KAC3B;IACD,QAAQ,EAAE;QACT,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,GAAG;QACf,cAAc,EAAE,UAAU;KAC1B;IACD,oBAAoB,EAAE;QACrB,IAAI,EAAE,sBAAsB;QAC5B,UAAU,EAAE,GAAG;QACf,cAAc,EAAE,sBAAsB;KACtC;IACD,qBAAqB,EAAE;QACtB,IAAI,EAAE,uBAAuB;QAC7B,UAAU,EAAE,GAAG;QACf,cAAc,EAAE,uBAAuB;KACvC;IACD,WAAW,EAAE;QACZ,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,GAAG;QACf,cAAc,EAAE,aAAa;KAC7B;IACD,mBAAmB,EAAE;QACpB,IAAI,EAAE,qBAAqB;QAC3B,UAAU,EAAE,GAAG;QACf,cAAc,EAAE,qBAAqB;KACrC;IACD,eAAe,EAAE;QAChB,IAAI,EAAE,iBAAiB;QACvB,UAAU,EAAE,GAAG;QACf,cAAc,EAAE,iBAAiB;KACjC;CACQ,CAAC"}

package/build/common/errors/index.d.ts

@@ -0,0 +1,13 @@
+export { BaseApplicationError } from './base-application-error.js';
+export { createError, ERROR_CONFIGS, type ErrorConfig, type ErrorType } from './error-factory.js';
+export declare const BadRequestError: typeof import("./base-application-error.js").BaseApplicationError;
+export declare const UnauthorizedError: typeof import("./base-application-error.js").BaseApplicationError;
+export declare const ForbiddenError: typeof import("./base-application-error.js").BaseApplicationError;
+export declare const NotFoundError: typeof import("./base-application-error.js").BaseApplicationError;
+export declare const ConflictError: typeof import("./base-application-error.js").BaseApplicationError;
+export declare const UnprocessableEntityError: typeof import("./base-application-error.js").BaseApplicationError;
+export declare const InternalServerError: typeof import("./base-application-error.js").BaseApplicationError;
+export declare const BadGatewayError: typeof import("./base-application-error.js").BaseApplicationError;
+export declare const ServiceUnavailableError: typeof import("./base-application-error.js").BaseApplicationError;
+export declare const GatewayTimeoutError: typeof import("./base-application-error.js").BaseApplicationError;
+//# sourceMappingURL=index.d.ts.map

package/build/common/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAKlG,eAAO,MAAM,eAAe,mEAAyC,CAAC;AACtE,eAAO,MAAM,iBAAiB,mEAA0C,CAAC;AACzE,eAAO,MAAM,cAAc,mEAAuC,CAAC;AACnE,eAAO,MAAM,aAAa,mEAAuC,CAAC;AAClE,eAAO,MAAM,aAAa,mEAAsC,CAAC;AACjE,eAAO,MAAM,wBAAwB,mEAAkD,CAAC;AACxF,eAAO,MAAM,mBAAmB,mEAAmD,CAAC;AACpF,eAAO,MAAM,eAAe,mEAAyC,CAAC;AACtE,eAAO,MAAM,uBAAuB,mEAAiD,CAAC;AACtF,eAAO,MAAM,mBAAmB,mEAA6C,CAAC"}

package/build/common/errors/index.js

@@ -0,0 +1,15 @@
+export { BaseApplicationError } from './base-application-error.js';
+export { createError, ERROR_CONFIGS } from './error-factory.js';
+import { createError, ERROR_CONFIGS } from './error-factory.js';
+// Predefined error classes
+export const BadRequestError = createError(ERROR_CONFIGS.BAD_REQUEST);
+export const UnauthorizedError = createError(ERROR_CONFIGS.UNAUTHORIZED);
+export const ForbiddenError = createError(ERROR_CONFIGS.FORBIDDEN);
+export const NotFoundError = createError(ERROR_CONFIGS.NOT_FOUND);
+export const ConflictError = createError(ERROR_CONFIGS.CONFLICT);
+export const UnprocessableEntityError = createError(ERROR_CONFIGS.UNPROCESSABLE_ENTITY);
+export const InternalServerError = createError(ERROR_CONFIGS.INTERNAL_SERVER_ERROR);
+export const BadGatewayError = createError(ERROR_CONFIGS.BAD_GATEWAY);
+export const ServiceUnavailableError = createError(ERROR_CONFIGS.SERVICE_UNAVAILABLE);
+export const GatewayTimeoutError = createError(ERROR_CONFIGS.GATEWAY_TIMEOUT);
+//# sourceMappingURL=index.js.map

package/build/common/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAoC,MAAM,oBAAoB,CAAC;AAElG,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEhE,2BAA2B;AAC3B,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;AACxF,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;AACpF,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;AACtE,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC"}

package/build/common/factories/index.d.ts

@@ -0,0 +1,5 @@
+export { ApplySecurityMiddleware } from './security-bootstrap.factory.js';
+export type { SecurityBootstrapOptions } from './security-bootstrap.factory.js';
+export { CreateRateLimitConfig } from './rate-limit-config.factory.js';
+export type { RateLimitConfig, RateLimitDescriptor } from './rate-limit-config.factory.js';
+//# sourceMappingURL=index.d.ts.map

package/build/common/factories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/factories/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,YAAY,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC"}

package/build/common/factories/index.js

@@ -0,0 +1,3 @@
+export { ApplySecurityMiddleware } from './security-bootstrap.factory.js';
+export { CreateRateLimitConfig } from './rate-limit-config.factory.js';
+//# sourceMappingURL=index.js.map

package/build/common/factories/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/factories/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC"}

package/build/common/factories/module-factory.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Module factory utilities for common NestJS module patterns
+ *
+ * Provides standardized factory functions for creating modules with consistent
+ * structure, providers, exports, and configuration patterns.
+ */
+import { DynamicModule } from '@nestjs/common';
+/**
+ * Configuration interface for global modules
+ */
+export interface GlobalModuleConfig {
+    /** Module name for logging */
+    name: string;
+    /** Providers to include in the module */
+    providers?: any[];
+    /** Services to export from the module */
+    exports?: any[];
+    /** Other modules to import */
+    imports?: any[];
+    /** Whether the module is global (default: true) */
+    isGlobal?: boolean;
+}
+/**
+ * Configuration interface for feature modules
+ */
+export interface FeatureModuleConfig {
+    /** Module name for logging */
+    name: string;
+    /** Providers to include in the module */
+    providers?: any[];
+    /** Services to export from the module */
+    exports?: any[];
+    /** Controllers to include */
+    controllers?: any[];
+    /** Other modules to import */
+    imports?: any[];
+}
+/**
+ * Configuration interface for service modules
+ */
+export interface ServiceModuleConfig {
+    /** Module name for logging */
+    name: string;
+    /** Service providers */
+    providers?: any[];
+    /** Services to export */
+    exports?: any[];
+    /** Other modules to import */
+    imports?: any[];
+}
+/**
+ * Configuration interface for application modules
+ */
+export interface ApplicationModuleConfig {
+    /** Module name for logging */
+    name: string;
+    /** Global filters to apply */
+    filters?: any[];
+    /** Global interceptors to apply */
+    interceptors?: any[];
+    /** Global pipes to apply */
+    pipes?: any[];
+    /** Global guards to apply */
+    guards?: any[];
+    /** Other modules to import */
+    imports?: any[];
+}
+/**
+ * Creates a global module with standardized configuration
+ *
+ * @param config - Module configuration
+ * @returns DynamicModule
+ *
+ * @example
+ * ```typescript
+ * @Module({})
+ * export class ConfigModule extends createGlobalModule({
+ *   name: 'ConfigModule',
+ *   providers: [ConfigService],
+ *   exports: [ConfigService],
+ * }) {}
+ * ```
+ */
+export declare function CreateGlobalModule(config: GlobalModuleConfig): DynamicModule;
+/**
+ * Creates a feature module with standardized configuration
+ *
+ * @param config - Module configuration
+ * @returns DynamicModule
+ *
+ * @example
+ * ```typescript
+ * @Module({})
+ * export class UserModule extends createFeatureModule({
+ *   name: 'UserModule',
+ *   controllers: [UserController],
+ *   providers: [UserService],
+ *   exports: [UserService],
+ * }) {}
+ * ```
+ */
+export declare function CreateFeatureModule(config: FeatureModuleConfig): DynamicModule;
+/**
+ * Creates a service module with standardized configuration
+ *
+ * @param config - Module configuration
+ * @returns DynamicModule
+ *
+ * @example
+ * ```typescript
+ * @Module({})
+ * export class DatabaseModule extends createServiceModule({
+ *   name: 'DatabaseModule',
+ *   providers: [DatabaseService, DatabaseConnection],
+ *   exports: [DatabaseService],
+ * }) {}
+ * ```
+ */
+export declare function CreateServiceModule(config: ServiceModuleConfig): DynamicModule;
+/**
+ * Creates an application module with global filters, interceptors, pipes, and guards
+ *
+ * @param config - Module configuration
+ * @returns DynamicModule
+ *
+ * @example
+ * ```typescript
+ * @Module({})
+ * export class AppModule extends createApplicationModule({
+ *   name: 'AppModule',
+ *   imports: [UserModule, AuthModule],
+ *   filters: [HttpExceptionFilter],
+ *   interceptors: [LoggingInterceptor],
+ *   pipes: [ValidationPipe],
+ *   guards: [AuthGuard],
+ * }) {}
+ * ```
+ */
+export declare function CreateApplicationModule(config: ApplicationModuleConfig): DynamicModule;
+/**
+ * Creates a module with conditional providers based on configuration
+ *
+ * @param config - Base module configuration
+ * @param conditions - Array of conditional provider configurations
+ * @returns DynamicModule
+ *
+ * @example
+ * ```typescript
+ * @Module({})
+ * export class CacheModule extends createConditionalModule(
+ *   { name: 'CacheModule', imports: [ConfigModule] },
+ *   [
+ *     {
+ *       condition: (config) => config.get('CACHE_ENABLED'),
+ *       providers: [RedisService],
+ *       exports: [RedisService],
+ *     },
+ *   ]
+ * ) {}
+ * ```
+ */
+export declare function CreateConditionalModule(baseConfig: Partial<GlobalModuleConfig & FeatureModuleConfig & ServiceModuleConfig>, conditions: Array<{
+    condition: (config?: any) => boolean;
+    providers?: any[];
+    exports?: any[];
+    imports?: any[];
+    controllers?: any[];
+    config?: any;
+}>): DynamicModule;
+/**
+ * Backwards compatibility aliases - exported functions use PascalCase per project conventions
+ */
+export declare const createApplicationModule: typeof CreateApplicationModule;
+export declare const createConditionalModule: typeof CreateConditionalModule;
+export declare const createFeatureModule: typeof CreateFeatureModule;
+export declare const createGlobalModule: typeof CreateGlobalModule;
+export declare const createServiceModule: typeof CreateServiceModule;
+//# sourceMappingURL=module-factory.d.ts.map

package/build/common/factories/module-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-factory.d.ts","sourceRoot":"","sources":["../../../src/common/factories/module-factory.ts"],"names":[],"mappings":"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"}