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

package/build/common/metrics.module.js

@@ -0,0 +1,77 @@
+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 MetricsModule_1;
+import { Module, Global } from '@nestjs/common';
+import { MetricsRegistryService } from './services/metrics-registry.service.js';
+import { HTTPMetricsInterceptor } from './interceptors/http-metrics.interceptor.js';
+import { MetricsController } from './controllers/metrics.controller.js';
+/**
+ * Metrics Module.
+ * Provides comprehensive Prometheus metrics collection and exposure for NestJS applications.
+ *
+ * Features:
+ * - HTTP request metrics (duration, count, size) with automatic cardinality prevention
+ * - Custom metric creation (counter, gauge, histogram)
+ * - Default Node.js metrics collection
+ * - Prometheus endpoint at /metrics
+ * - Metrics registry management
+ *
+ * @remarks
+ * - Imported as global module in CommonModule
+ * - Controlled by METRICS_ENABLED environment variable (default: true)
+ * - Automatically normalizes dynamic path segments to prevent unbounded label cardinality
+ * - MetricsController exports metrics at GET /metrics in Prometheus format
+ *
+ * @example
+ * ```typescript
+ * // Access metrics in any injectable
+ * constructor(private metrics: MetricsRegistryService) {}
+ *
+ * // Create and record custom metrics
+ * const counter = this.metrics.createCounter('orders_total', 'Total orders');
+ * counter.inc({ status: 'completed' });
+ *
+ * // Get metrics (typically called by MetricsController)
+ * const prometheusText = await this.metrics.getMetrics();
+ * ```
+ */
+let MetricsModule = MetricsModule_1 = class MetricsModule {
+    /**
+     * Configure metrics module for root application
+     * Enables HTTP metrics collection and /metrics endpoint
+     */
+    static forRoot() {
+        return {
+            module: MetricsModule_1,
+        };
+    }
+    /**
+     * Configure metrics module with async options
+     */
+    static forRootAsync(options) {
+        return {
+            module: MetricsModule_1,
+            imports: options.imports,
+        };
+    }
+};
+MetricsModule = MetricsModule_1 = __decorate([
+    Global(),
+    Module({
+        controllers: [MetricsController],
+        providers: [
+            MetricsRegistryService,
+            HTTPMetricsInterceptor,
+        ],
+        exports: [
+            MetricsRegistryService,
+            HTTPMetricsInterceptor,
+        ],
+    })
+], MetricsModule);
+export { MetricsModule };
+//# sourceMappingURL=metrics.module.js.map

package/build/common/metrics.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.module.js","sourceRoot":"","sources":["../../src/common/metrics.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAiB,MAAM,gBAAgB,CAAC;AAE/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAUxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAcI,IAAM,aAAa,qBAAnB,MAAM,aAAa;IACzB;;;OAGG;IACI,MAAM,CAAC,OAAO;QACpB,OAAO;YACN,MAAM,EAAE,eAAa;SACrB,CAAC;IACH,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,YAAY,CAAC,OAAkC;QAC5D,OAAO;YACN,MAAM,EAAE,eAAa;YACrB,OAAO,EAAE,OAAO,CAAC,OAAO;SACxB,CAAC;IACH,CAAC;CACD,CAAA;AApBY,aAAa;IAZzB,MAAM,EAAE;IACR,MAAM,CAAC;QACP,WAAW,EAAE,CAAC,iBAAiB,CAAC;QAChC,SAAS,EAAE;YACV,sBAAsB;YACtB,sBAAsB;SACtB;QACD,OAAO,EAAE;YACR,sBAAsB;YACtB,sBAAsB;SACtB;KACD,CAAC;GACW,aAAa,CAoBzB"}

package/build/common/modules/throttler.module.d.ts

@@ -0,0 +1,69 @@
+/**
+ * SharedThrottlerModule
+ *
+ * Provides rate limiting / throttling functionality with optional Redis backend.
+ * Default: in-memory storage (suitable for single-instance deployments)
+ * With Redis: distributed rate limiting across multiple instances
+ *
+ * Usage:
+ * ```typescript
+ * // In-memory (default, development)
+ * @Module({
+ *   imports: [SharedThrottlerModule.forRoot()],
+ * })
+ * export class AppModule {}
+ *
+ * // With Redis (production)
+ * @Module({
+ *   imports: [
+ *     SharedThrottlerModule.forRootAsync({
+ *       useFactory: () => ({
+ *         redis: {
+ *           host: process.env.REDIS_HOST,
+ *           port: parseInt(process.env.REDIS_PORT || '6379', 10),
+ *         },
+ *       }),
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+import { DynamicModule, ModuleMetadata, Type } from '@nestjs/common';
+export interface SharedThrottlerConfig {
+    /** Time window in milliseconds (default: 15 * 60 * 1000 = 15 minutes) */
+    ttl?: number;
+    /** Maximum number of requests per window (default: 100) */
+    limit?: number;
+    /** Optional Redis configuration for distributed rate limiting */
+    redis?: {
+        host?: string;
+        port?: number;
+        password?: string;
+        username?: string;
+        db?: number;
+        [key: string]: any;
+    };
+}
+export declare class SharedThrottlerModule {
+    private static readonly logger;
+    private static readonly DEFAULT_WINDOW_MS;
+    private static readonly DEFAULT_MAX_REQUESTS;
+    private static readonly MS_PER_SECOND;
+    /**
+     * Configure in-memory throttling (default)
+     */
+    static forRoot(config?: SharedThrottlerConfig): DynamicModule;
+    /**
+     * Configure with async options (supports Redis backend)
+     */
+    static forRootAsync(options: {
+        useFactory?: (...args: any[]) => SharedThrottlerConfig | Promise<SharedThrottlerConfig>;
+        useClass?: Type<{
+            createThrottlerConfig(): SharedThrottlerConfig | Promise<SharedThrottlerConfig>;
+        }>;
+        inject?: any[];
+        imports?: ModuleMetadata['imports'];
+    }): DynamicModule;
+}
+//# sourceMappingURL=throttler.module.d.ts.map

package/build/common/modules/throttler.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttler.module.d.ts","sourceRoot":"","sources":["../../../src/common/modules/throttler.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAEN,aAAa,EACb,cAAc,EACd,IAAI,EAGJ,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,qBAAqB;IACrC,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,KAAK,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACnB,CAAC;CACF;AAED,qBACa,qBAAqB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAA0C;IAGxE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAkB;IAG3D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAO;IAGnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAQ;IAE7C;;OAEG;WACW,OAAO,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,aAAa;IAoBpE;;OAEG;WACW,YAAY,CACzB,OAAO,EAAE;QACR,UAAU,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;QACxF,QAAQ,CAAC,EAAE,IAAI,CAAC;YAAE,qBAAqB,IAAI,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;SAAE,CAAC,CAAC;QACrG,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;QACf,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;KACpC,GACC,aAAa;CAiDhB"}

package/build/common/modules/throttler.module.js

@@ -0,0 +1,117 @@
+/**
+ * SharedThrottlerModule
+ *
+ * Provides rate limiting / throttling functionality with optional Redis backend.
+ * Default: in-memory storage (suitable for single-instance deployments)
+ * With Redis: distributed rate limiting across multiple instances
+ *
+ * Usage:
+ * ```typescript
+ * // In-memory (default, development)
+ * @Module({
+ *   imports: [SharedThrottlerModule.forRoot()],
+ * })
+ * export class AppModule {}
+ *
+ * // With Redis (production)
+ * @Module({
+ *   imports: [
+ *     SharedThrottlerModule.forRootAsync({
+ *       useFactory: () => ({
+ *         redis: {
+ *           host: process.env.REDIS_HOST,
+ *           port: parseInt(process.env.REDIS_PORT || '6379', 10),
+ *         },
+ *       }),
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+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 SharedThrottlerModule_1;
+import { Module, Logger, } from '@nestjs/common';
+import { ThrottlerModule, ThrottlerGuard } from '@nestjs/throttler';
+let SharedThrottlerModule = class SharedThrottlerModule {
+    static { SharedThrottlerModule_1 = this; }
+    static logger = new Logger(SharedThrottlerModule_1.name);
+    // eslint-disable-next-line no-magic-numbers
+    static DEFAULT_WINDOW_MS = 15 * 60 * 1000; // 15 minutes
+    // eslint-disable-next-line no-magic-numbers
+    static DEFAULT_MAX_REQUESTS = 100;
+    // eslint-disable-next-line no-magic-numbers
+    static MS_PER_SECOND = 1000;
+    /**
+     * Configure in-memory throttling (default)
+     */
+    static forRoot(config) {
+        const ttl = config?.ttl ?? SharedThrottlerModule_1.DEFAULT_WINDOW_MS;
+        const limit = config?.limit ?? SharedThrottlerModule_1.DEFAULT_MAX_REQUESTS;
+        SharedThrottlerModule_1.logger.log(`Initializing SharedThrottlerModule with in-memory storage (ttl: ${ttl}ms, limit: ${limit})`);
+        return {
+            module: SharedThrottlerModule_1,
+            imports: [
+                ThrottlerModule.forRoot({
+                    throttlers: [{ ttl: Math.round(ttl / SharedThrottlerModule_1.MS_PER_SECOND), limit }],
+                }),
+            ],
+            providers: [ThrottlerGuard],
+            exports: [ThrottlerModule, ThrottlerGuard],
+        };
+    }
+    /**
+     * Configure with async options (supports Redis backend)
+     */
+    static forRootAsync(options) {
+        const providers = [];
+        // If useFactory is provided
+        if (options.useFactory) {
+            providers.push({
+                provide: 'SHARED_THROTTLER_CONFIG',
+                useFactory: options.useFactory,
+                inject: options.inject ?? [],
+            });
+        }
+        // If useClass is provided
+        if (options.useClass) {
+            providers.push(options.useClass, {
+                provide: 'SHARED_THROTTLER_CONFIG',
+                useFactory: (instance) => instance.createThrottlerConfig(),
+                inject: [options.useClass],
+            });
+        }
+        return {
+            module: SharedThrottlerModule_1,
+            imports: [
+                ThrottlerModule.forRootAsync({
+                    inject: ['SHARED_THROTTLER_CONFIG'],
+                    useFactory: (config) => {
+                        const ttl = config?.ttl ?? SharedThrottlerModule_1.DEFAULT_WINDOW_MS;
+                        const limit = config?.limit ?? SharedThrottlerModule_1.DEFAULT_MAX_REQUESTS;
+                        if (config?.redis) {
+                            throw new Error('Redis backend for SharedThrottlerModule is not yet implemented. Remove the redis config or wait for the implementation.');
+                        }
+                        SharedThrottlerModule_1.logger.log(`Initializing SharedThrottlerModule with in-memory storage (ttl: ${ttl}ms, limit: ${limit})`);
+                        return {
+                            throttlers: [{ ttl: Math.round(ttl / SharedThrottlerModule_1.MS_PER_SECOND), limit }],
+                        };
+                    },
+                }),
+                ...(options.imports ?? []),
+            ],
+            providers: [...providers, ThrottlerGuard],
+            exports: [ThrottlerModule, ThrottlerGuard],
+        };
+    }
+};
+SharedThrottlerModule = SharedThrottlerModule_1 = __decorate([
+    Module({})
+], SharedThrottlerModule);
+export { SharedThrottlerModule };
+//# sourceMappingURL=throttler.module.js.map

package/build/common/modules/throttler.module.js.map

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

package/build/common/pipes/base-validation.pipe.d.ts

@@ -0,0 +1,67 @@
+import { PipeTransform, ArgumentMetadata } from '@nestjs/common';
+import { ValidationError } from 'class-validator';
+import { ClassTransformOptions } from 'class-transformer';
+/**
+ * Base Validation Pipe
+ *
+ * Abstract base class for validation pipes that provides core validation logic
+ * while allowing subclasses to customize error formatting and validation options.
+ *
+ * @example
+ * ```typescript
+ * export class MyValidationPipe extends BaseValidationPipe {
+ *   protected formatValidationErrors(errors: ValidationError[]): any {
+ *     // Custom error formatting
+ *     return errors.map(error => ({
+ *       field: error.property,
+ *       message: Object.values(error.constraints || {}).join(', ')
+ *     }));
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class BaseValidationPipe implements PipeTransform<any> {
+    /**
+     * Transforms and validates input data
+     *
+     * @param value - The input value to validate
+     * @param metadata - Metadata about the argument
+     * @returns any - The validated and transformed value
+     */
+    transform(value: any, metadata: ArgumentMetadata): Promise<any>;
+    /**
+     * Determines if the metatype should be validated
+     *
+     * @param metatype - The type to check
+     * @returns boolean - True if validation should be performed
+     */
+    protected shouldValidate(metatype: any): boolean;
+    /**
+     * Gets validation options for class-validator
+     *
+     * @returns Validation options
+     */
+    protected getValidationOptions(): any;
+    /**
+     * Gets transformation options for class-transformer
+     *
+     * @returns Transformation options
+     */
+    protected getTransformOptions(): ClassTransformOptions;
+    /**
+     * Handles validation errors before formatting
+     *
+     * Subclasses can override this to add logging, metrics, etc.
+     *
+     * @param _errors - The validation errors (unused in base implementation)
+     */
+    protected handleValidationErrors(_errors: ValidationError[]): void;
+    /**
+     * Formats validation errors for the response
+     *
+     * @param errors - The validation errors
+     * @returns Formatted error response
+     */
+    protected abstract formatValidationErrors(errors: ValidationError[]): any;
+}
+//# sourceMappingURL=base-validation.pipe.d.ts.map

package/build/common/pipes/base-validation.pipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-validation.pipe.d.ts","sourceRoot":"","sources":["../../../src/common/pipes/base-validation.pipe.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,aAAa,EAEb,gBAAgB,EAEhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAY,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAgB,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAExE;;;;;;;;;;;;;;;;;;GAkBG;AACH,8BACsB,kBAAmB,YAAW,aAAa,CAAC,GAAG,CAAC;IACrE;;;;;;OAMG;IACU,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IAuB5E;;;;;OAKG;IACH,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO;IAKhD;;;;OAIG;IACH,SAAS,CAAC,oBAAoB,IAAI,GAAG;IAIrC;;;;OAIG;IACH,SAAS,CAAC,mBAAmB,IAAI,qBAAqB;IAItD;;;;;;OAMG;IACH,SAAS,CAAC,sBAAsB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,IAAI;IAIlE;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,GAAG;CACzE"}

package/build/common/pipes/base-validation.pipe.js

@@ -0,0 +1,95 @@
+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;
+};
+import { Injectable, BadRequestException, } from '@nestjs/common';
+import { validate } from 'class-validator';
+import { plainToClass } from 'class-transformer';
+/**
+ * Base Validation Pipe
+ *
+ * Abstract base class for validation pipes that provides core validation logic
+ * while allowing subclasses to customize error formatting and validation options.
+ *
+ * @example
+ * ```typescript
+ * export class MyValidationPipe extends BaseValidationPipe {
+ *   protected formatValidationErrors(errors: ValidationError[]): any {
+ *     // Custom error formatting
+ *     return errors.map(error => ({
+ *       field: error.property,
+ *       message: Object.values(error.constraints || {}).join(', ')
+ *     }));
+ *   }
+ * }
+ * ```
+ */
+let BaseValidationPipe = class BaseValidationPipe {
+    /**
+     * Transforms and validates input data
+     *
+     * @param value - The input value to validate
+     * @param metadata - Metadata about the argument
+     * @returns any - The validated and transformed value
+     */
+    async transform(value, metadata) {
+        const { metatype } = metadata;
+        // Skip validation for primitive types
+        if (!metatype || !this.shouldValidate(metatype)) {
+            return value;
+        }
+        // Transform plain object to class instance
+        const object = plainToClass(metatype, value, this.getTransformOptions());
+        // Validate the object
+        const errors = await validate(object, this.getValidationOptions());
+        if (errors.length > 0) {
+            this.handleValidationErrors(errors);
+            // If handleValidationErrors doesn't throw, format and throw
+            throw new BadRequestException(this.formatValidationErrors(errors));
+        }
+        return object;
+    }
+    /**
+     * Determines if the metatype should be validated
+     *
+     * @param metatype - The type to check
+     * @returns boolean - True if validation should be performed
+     */
+    shouldValidate(metatype) {
+        const types = [String, Boolean, Number, Array, Object];
+        return !types.includes(metatype);
+    }
+    /**
+     * Gets validation options for class-validator
+     *
+     * @returns Validation options
+     */
+    getValidationOptions() {
+        return {};
+    }
+    /**
+     * Gets transformation options for class-transformer
+     *
+     * @returns Transformation options
+     */
+    getTransformOptions() {
+        return {};
+    }
+    /**
+     * Handles validation errors before formatting
+     *
+     * Subclasses can override this to add logging, metrics, etc.
+     *
+     * @param _errors - The validation errors (unused in base implementation)
+     */
+    handleValidationErrors(_errors) {
+        // Default: no-op, subclasses can add logging/metrics
+    }
+};
+BaseValidationPipe = __decorate([
+    Injectable()
+], BaseValidationPipe);
+export { BaseValidationPipe };
+//# sourceMappingURL=base-validation.pipe.js.map

package/build/common/pipes/base-validation.pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-validation.pipe.js","sourceRoot":"","sources":["../../../src/common/pipes/base-validation.pipe.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAEN,UAAU,EAEV,mBAAmB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAmB,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAyB,MAAM,mBAAmB,CAAC;AAExE;;;;;;;;;;;;;;;;;;GAkBG;AAEI,IAAe,kBAAkB,GAAjC,MAAe,kBAAkB;IACvC;;;;;;OAMG;IACI,KAAK,CAAC,SAAS,CAAC,KAAU,EAAE,QAA0B;QAC5D,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;QAE9B,sCAAsC;QACtC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC;QACd,CAAC;QAED,2CAA2C;QAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;QAEzE,sBAAsB;QACtB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;QAEnE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;YACpC,4DAA4D;YAC5D,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACO,cAAc,CAAC,QAAa;QACrC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACvD,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACO,oBAAoB;QAC7B,OAAO,EAAE,CAAC;IACX,CAAC;IAED;;;;OAIG;IACO,mBAAmB;QAC5B,OAAO,EAAE,CAAC;IACX,CAAC;IAED;;;;;;OAMG;IACO,sBAAsB,CAAC,OAA0B;QAC1D,qDAAqD;IACtD,CAAC;CASD,CAAA;AA9EqB,kBAAkB;IADvC,UAAU,EAAE;GACS,kBAAkB,CA8EvC"}

package/build/common/pipes/validation.pipe.d.ts

@@ -0,0 +1,32 @@
+import { ValidationError } from 'class-validator';
+import { BaseValidationPipe } from './base-validation.pipe.js';
+/**
+ * HTTP Validation Pipe.
+ * Validates incoming HTTP request data using class-validator and transforms using class-transformer.
+ * Extends BaseValidationPipe with HTTP-specific error formatting.
+ *
+ * @remarks
+ * - Automatically applied as a global pipe in CommonModule
+ * - Supports nested object validation with path prefixes
+ * - Recursively processes validation errors with depth traversal
+ * - Formats errors as string array for consistent HTTP responses
+ *
+ * @example
+ * ```typescript
+ * // Automatically applied globally; decorator is optional
+ * @Post()
+ * async createUser(@Body() createUserDto: CreateUserDto): Promise<User> {
+ *   // DTO will be validated automatically
+ * }
+ * ```
+ */
+export declare class ValidationPipe extends BaseValidationPipe {
+    /**
+     * Formats validation errors as string array for HTTP responses
+     *
+     * @param errors - The validation errors
+     * @returns string[] - Array of error messages
+     */
+    protected formatValidationErrors(errors: ValidationError[]): string[];
+}
+//# sourceMappingURL=validation.pipe.d.ts.map

package/build/common/pipes/validation.pipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.pipe.d.ts","sourceRoot":"","sources":["../../../src/common/pipes/validation.pipe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,cAAe,SAAQ,kBAAkB;IACrD;;;;;OAKG;IACH,SAAS,CAAC,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,EAAE;CA2BrE"}

package/build/common/pipes/validation.pipe.js

@@ -0,0 +1,60 @@
+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;
+};
+import { Injectable } from '@nestjs/common';
+import { BaseValidationPipe } from './base-validation.pipe.js';
+/**
+ * HTTP Validation Pipe.
+ * Validates incoming HTTP request data using class-validator and transforms using class-transformer.
+ * Extends BaseValidationPipe with HTTP-specific error formatting.
+ *
+ * @remarks
+ * - Automatically applied as a global pipe in CommonModule
+ * - Supports nested object validation with path prefixes
+ * - Recursively processes validation errors with depth traversal
+ * - Formats errors as string array for consistent HTTP responses
+ *
+ * @example
+ * ```typescript
+ * // Automatically applied globally; decorator is optional
+ * @Post()
+ * async createUser(@Body() createUserDto: CreateUserDto): Promise<User> {
+ *   // DTO will be validated automatically
+ * }
+ * ```
+ */
+let ValidationPipe = class ValidationPipe extends BaseValidationPipe {
+    /**
+     * Formats validation errors as string array for HTTP responses
+     *
+     * @param errors - The validation errors
+     * @returns string[] - Array of error messages
+     */
+    formatValidationErrors(errors) {
+        const result = [];
+        const processError = (error, parentPath = '') => {
+            const currentPath = parentPath ? `${parentPath}.${error.property}` : error.property;
+            // If error has constraints, add them to result
+            if (error.constraints && Object.keys(error.constraints).length > 0) {
+                const messages = Object.values(error.constraints).join(', ');
+                result.push(`${currentPath}: ${messages}`);
+            }
+            // If error has children, recurse
+            if (error.children && error.children.length > 0) {
+                error.children.forEach(childError => processError(childError, currentPath));
+            }
+            // Skip fields with no constraints and no children — no message to add
+            // (do not add empty entries like "email: ")
+        };
+        errors.forEach(error => processError(error));
+        return result;
+    }
+};
+ValidationPipe = __decorate([
+    Injectable()
+], ValidationPipe);
+export { ValidationPipe };
+//# sourceMappingURL=validation.pipe.js.map

package/build/common/pipes/validation.pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.pipe.js","sourceRoot":"","sources":["../../../src/common/pipes/validation.pipe.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;GAmBG;AAEI,IAAM,cAAc,GAApB,MAAM,cAAe,SAAQ,kBAAkB;IACrD;;;;;OAKG;IACO,sBAAsB,CAAC,MAAyB;QACzD,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,MAAM,YAAY,GAAG,CAAC,KAAsB,EAAE,aAAqB,EAAE,EAAQ,EAAE;YAC9E,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;YAEpF,+CAA+C;YAC/C,IAAI,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC7D,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,KAAK,QAAQ,EAAE,CAAC,CAAC;YAC5C,CAAC;YAED,iCAAiC;YACjC,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjD,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CACnC,YAAY,CAAC,UAAU,EAAE,WAAW,CAAC,CACrC,CAAC;YACH,CAAC;YAED,sEAAsE;YACtE,4CAA4C;QAC7C,CAAC,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;QAE7C,OAAO,MAAM,CAAC;IACf,CAAC;CACD,CAAA;AAlCY,cAAc;IAD1B,UAAU,EAAE;GACA,cAAc,CAkC1B"}