@pawells/nestjs-shared 1.0.0-dev.3052c75

package/build/config/validation.utils.d.ts

@@ -0,0 +1,136 @@
+import { ModuleRef } from '@nestjs/core';
+import Joi from 'joi';
+import type { ConfigSchema, ValidationResult } from './config.types.js';
+import { LazyModuleRefService } from '../common/utils/lazy-getter.types.js';
+/**
+ * Configuration Validation Service
+ * Provides validation utilities with logging
+ */
+export declare class ValidationService implements LazyModuleRefService {
+    private _contextualLogger;
+    readonly Module: ModuleRef;
+    constructor(module: ModuleRef);
+    private get logger();
+    /**
+     * Create a validation schema for environment variables.
+     * @param schema - Joi schema definition object with validation rules
+     * @returns Compiled Joi ObjectSchema ready for validation
+     */
+    createValidationSchema(schema: ConfigSchema): Joi.ObjectSchema;
+    /**
+     * Validate configuration against a schema.
+     * @param config - Configuration object to validate
+     * @param schema - Joi validation schema
+     * @returns ValidationResult with isValid flag and optional errors array
+     */
+    validateConfig(config: any, schema: Joi.ObjectSchema): ValidationResult;
+}
+/**
+ * Create a validation schema for environment variables.
+ * Utility function to compile a configuration object into a Joi validation schema.
+ * @param schema - Joi schema definition object with validation rules
+ * @returns Compiled Joi ObjectSchema ready for validation
+ */
+export declare function CreateValidationSchema(schema: ConfigSchema): Joi.ObjectSchema;
+/**
+ * Validate configuration against a schema.
+ * Utility function to validate a configuration object using a Joi schema.
+ * @param config - Configuration object to validate
+ * @param schema - Joi validation schema
+ * @returns ValidationResult with isValid flag and optional errors array
+ */
+export declare function ValidateConfig(config: any, schema: Joi.ObjectSchema): ValidationResult;
+/**
+ * Create a string validation schema with common patterns.
+ * Utility to build Joi string schemas with min/max length, pattern matching, and defaults.
+ * @param options - String schema options
+ * @param options.min - Minimum string length
+ * @param options.max - Maximum string length
+ * @param options.required - Whether the field is required
+ * @param options.pattern - Regular expression pattern to match
+ * @param options.default - Default value if not provided
+ * @param options.description - Human-readable description
+ * @returns Configured Joi StringSchema
+ */
+export declare function CreateStringSchema(options?: {
+    min?: number;
+    max?: number;
+    required?: boolean;
+    pattern?: RegExp;
+    default?: string;
+    description?: string;
+}): Joi.StringSchema;
+/**
+ * Create a number validation schema with common patterns.
+ * Utility to build Joi number schemas with min/max bounds, integer constraint, and defaults.
+ * @param options - Number schema options
+ * @param options.min - Minimum numeric value
+ * @param options.max - Maximum numeric value
+ * @param options.integer - Whether value must be an integer
+ * @param options.required - Whether the field is required
+ * @param options.default - Default value if not provided
+ * @param options.description - Human-readable description
+ * @returns Configured Joi NumberSchema
+ */
+export declare function CreateNumberSchema(options?: {
+    min?: number;
+    max?: number;
+    integer?: boolean;
+    required?: boolean;
+    default?: number;
+    description?: string;
+}): Joi.NumberSchema;
+/**
+ * Create a boolean validation schema.
+ * Utility to build Joi boolean schemas with required flag and defaults.
+ * @param options - Boolean schema options
+ * @param options.required - Whether the field is required
+ * @param options.default - Default value if not provided
+ * @param options.description - Human-readable description
+ * @returns Configured Joi BooleanSchema
+ */
+export declare function CreateBooleanSchema(options?: {
+    required?: boolean;
+    default?: boolean;
+    description?: string;
+}): Joi.BooleanSchema;
+/**
+ * Create a URI validation schema.
+ * Utility to build Joi string schemas that validate RFC 3986 URIs.
+ * @param options - URI schema options
+ * @param options.required - Whether the field is required
+ * @param options.default - Default value if not provided
+ * @param options.description - Human-readable description
+ * @returns Configured Joi StringSchema with URI validation
+ */
+export declare function CreateUriSchema(options?: {
+    required?: boolean;
+    default?: string;
+    description?: string;
+}): Joi.StringSchema;
+/**
+ * Create validation schema for port numbers.
+ * Utility to build Joi number schemas for TCP/UDP port validation (1-65535).
+ * @param defaultValue - Default port number (default: 3000)
+ * @param description - Human-readable description
+ * @returns Configured Joi NumberSchema for port validation
+ */
+export declare function CreatePortSchema(defaultValue?: number, description?: string): Joi.NumberSchema;
+/**
+ * Create validation schema for environment variables.
+ * Utility to build Joi string schemas that restrict values to a whitelist of environments.
+ * @param allowedValues - Array of allowed environment values (default: development, production, test)
+ * @param defaultValue - Default environment value (default: development)
+ * @param description - Human-readable description
+ * @returns Configured Joi StringSchema with environment validation
+ */
+export declare function CreateEnvironmentSchema(allowedValues?: string[], defaultValue?: string, description?: string): Joi.StringSchema;
+/**
+ * Create validation schema for JWT expiration times.
+ * Utility to build Joi string schemas that validate JWT expiration duration format (e.g., 15m, 1h, 7d).
+ * @param defaultValue - Default expiration time (default: 15m)
+ * @param description - Human-readable description
+ * @returns Configured Joi StringSchema with JWT expiration validation
+ */
+export declare function CreateJwtExpirationSchema(defaultValue?: string, description?: string): Joi.StringSchema;
+//# sourceMappingURL=validation.utils.d.ts.map

package/build/config/validation.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.utils.d.ts","sourceRoot":"","sources":["../../src/config/validation.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAE5E;;;GAGG;AACH,qBACa,iBAAkB,YAAW,oBAAoB;IAC7D,OAAO,CAAC,iBAAiB,CAAwB;IAEjD,SAAgB,MAAM,EAAE,SAAS,CAAC;gBAEtB,MAAM,EAAE,SAAS;IAI7B,OAAO,KAAK,MAAM,GAMjB;IAED;;;;OAIG;IACI,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAAC,YAAY;IAOrE;;;;;OAKG;IACI,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,YAAY,GAAG,gBAAgB;CAqB9E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAAC,YAAY,CAE7E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,YAAY,GAAG,gBAAgB,CAgBtF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,GAAG,CAAC,YAAY,CA4BxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,GAAG,CAAC,YAAY,CA4BxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,GAAG,CAAC,aAAa,CAgBzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,GAAG,CAAC,YAAY,CAgBxB;AAED;;;;;;GAMG;AAEH,wBAAgB,gBAAgB,CAAC,YAAY,GAAE,MAAa,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,YAAY,CAQpG;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACtC,aAAa,GAAE,MAAM,EAA0C,EAC/D,YAAY,GAAE,MAAsB,EACpC,WAAW,CAAC,EAAE,MAAM,GAClB,GAAG,CAAC,YAAY,CAMlB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACxC,YAAY,GAAE,MAAc,EAC5B,WAAW,CAAC,EAAE,MAAM,GAClB,GAAG,CAAC,YAAY,CAMlB"}

package/build/config/validation.utils.js

@@ -0,0 +1,263 @@
+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 ValidationService_1;
+import { Injectable } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import Joi from 'joi';
+import { AppLogger } from '../common/index.js';
+/**
+ * Configuration Validation Service
+ * Provides validation utilities with logging
+ */
+let ValidationService = ValidationService_1 = class ValidationService {
+    _contextualLogger;
+    Module;
+    constructor(module) {
+        this.Module = module;
+    }
+    get logger() {
+        if (!this._contextualLogger) {
+            const baseLogger = this.Module.get(AppLogger, { strict: false });
+            this._contextualLogger = baseLogger.createContextualLogger(ValidationService_1.name);
+        }
+        return this._contextualLogger;
+    }
+    /**
+     * Create a validation schema for environment variables.
+     * @param schema - Joi schema definition object with validation rules
+     * @returns Compiled Joi ObjectSchema ready for validation
+     */
+    createValidationSchema(schema) {
+        this.logger.debug('Creating validation schema');
+        const joiSchema = Joi.object(schema);
+        this.logger.debug('Validation schema created successfully');
+        return joiSchema;
+    }
+    /**
+     * Validate configuration against a schema.
+     * @param config - Configuration object to validate
+     * @param schema - Joi validation schema
+     * @returns ValidationResult with isValid flag and optional errors array
+     */
+    validateConfig(config, schema) {
+        this.logger.debug('Starting configuration validation');
+        const { error } = schema.validate(config, {
+            allowUnknown: true,
+            stripUnknown: false,
+        });
+        if (error) {
+            this.logger.error(`Configuration validation failed with ${error.details.length} errors`);
+            this.logger.debug(`Validation errors: ${error.details.map(detail => detail.message).join(', ')}`);
+            return {
+                isValid: false,
+                errors: error.details.map(detail => detail.message),
+            };
+        }
+        this.logger.info('Configuration validation passed');
+        return {
+            isValid: true,
+        };
+    }
+};
+ValidationService = ValidationService_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [ModuleRef])
+], ValidationService);
+export { ValidationService };
+/**
+ * Create a validation schema for environment variables.
+ * Utility function to compile a configuration object into a Joi validation schema.
+ * @param schema - Joi schema definition object with validation rules
+ * @returns Compiled Joi ObjectSchema ready for validation
+ */
+export function CreateValidationSchema(schema) {
+    return Joi.object(schema);
+}
+/**
+ * Validate configuration against a schema.
+ * Utility function to validate a configuration object using a Joi schema.
+ * @param config - Configuration object to validate
+ * @param schema - Joi validation schema
+ * @returns ValidationResult with isValid flag and optional errors array
+ */
+export function ValidateConfig(config, schema) {
+    const { error } = schema.validate(config, {
+        allowUnknown: true,
+        stripUnknown: false,
+    });
+    if (error) {
+        return {
+            isValid: false,
+            errors: error.details.map(detail => detail.message),
+        };
+    }
+    return {
+        isValid: true,
+    };
+}
+/**
+ * Create a string validation schema with common patterns.
+ * Utility to build Joi string schemas with min/max length, pattern matching, and defaults.
+ * @param options - String schema options
+ * @param options.min - Minimum string length
+ * @param options.max - Maximum string length
+ * @param options.required - Whether the field is required
+ * @param options.pattern - Regular expression pattern to match
+ * @param options.default - Default value if not provided
+ * @param options.description - Human-readable description
+ * @returns Configured Joi StringSchema
+ */
+export function CreateStringSchema(options = {}) {
+    let schema = Joi.string();
+    if (options.min !== undefined) {
+        schema = schema.min(options.min);
+    }
+    if (options.max !== undefined) {
+        schema = schema.max(options.max);
+    }
+    if (options.pattern) {
+        schema = schema.pattern(options.pattern);
+    }
+    if (options.required) {
+        schema = schema.required();
+    }
+    if (options.default !== undefined) {
+        schema = schema.default(options.default);
+    }
+    if (options.description) {
+        schema = schema.description(options.description);
+    }
+    return schema;
+}
+/**
+ * Create a number validation schema with common patterns.
+ * Utility to build Joi number schemas with min/max bounds, integer constraint, and defaults.
+ * @param options - Number schema options
+ * @param options.min - Minimum numeric value
+ * @param options.max - Maximum numeric value
+ * @param options.integer - Whether value must be an integer
+ * @param options.required - Whether the field is required
+ * @param options.default - Default value if not provided
+ * @param options.description - Human-readable description
+ * @returns Configured Joi NumberSchema
+ */
+export function CreateNumberSchema(options = {}) {
+    let schema = Joi.number();
+    if (options.integer) {
+        schema = schema.integer();
+    }
+    if (options.min !== undefined) {
+        schema = schema.min(options.min);
+    }
+    if (options.max !== undefined) {
+        schema = schema.max(options.max);
+    }
+    if (options.required) {
+        schema = schema.required();
+    }
+    if (options.default !== undefined) {
+        schema = schema.default(options.default);
+    }
+    if (options.description) {
+        schema = schema.description(options.description);
+    }
+    return schema;
+}
+/**
+ * Create a boolean validation schema.
+ * Utility to build Joi boolean schemas with required flag and defaults.
+ * @param options - Boolean schema options
+ * @param options.required - Whether the field is required
+ * @param options.default - Default value if not provided
+ * @param options.description - Human-readable description
+ * @returns Configured Joi BooleanSchema
+ */
+export function CreateBooleanSchema(options = {}) {
+    let schema = Joi.boolean();
+    if (options.required) {
+        schema = schema.required();
+    }
+    if (options.default !== undefined) {
+        schema = schema.default(options.default);
+    }
+    if (options.description) {
+        schema = schema.description(options.description);
+    }
+    return schema;
+}
+/**
+ * Create a URI validation schema.
+ * Utility to build Joi string schemas that validate RFC 3986 URIs.
+ * @param options - URI schema options
+ * @param options.required - Whether the field is required
+ * @param options.default - Default value if not provided
+ * @param options.description - Human-readable description
+ * @returns Configured Joi StringSchema with URI validation
+ */
+export function CreateUriSchema(options = {}) {
+    let schema = Joi.string().uri();
+    if (options.required) {
+        schema = schema.required();
+    }
+    if (options.default !== undefined) {
+        schema = schema.default(options.default);
+    }
+    if (options.description) {
+        schema = schema.description(options.description);
+    }
+    return schema;
+}
+/**
+ * Create validation schema for port numbers.
+ * Utility to build Joi number schemas for TCP/UDP port validation (1-65535).
+ * @param defaultValue - Default port number (default: 3000)
+ * @param description - Human-readable description
+ * @returns Configured Joi NumberSchema for port validation
+ */
+// eslint-disable-next-line no-magic-numbers
+export function CreatePortSchema(defaultValue = 3000, description) {
+    return CreateNumberSchema({
+        min: 1,
+        max: 65535,
+        integer: true,
+        default: defaultValue,
+        description: description ?? 'Port number',
+    });
+}
+/**
+ * Create validation schema for environment variables.
+ * Utility to build Joi string schemas that restrict values to a whitelist of environments.
+ * @param allowedValues - Array of allowed environment values (default: development, production, test)
+ * @param defaultValue - Default environment value (default: development)
+ * @param description - Human-readable description
+ * @returns Configured Joi StringSchema with environment validation
+ */
+export function CreateEnvironmentSchema(allowedValues = ['development', 'production', 'test'], defaultValue = 'development', description) {
+    return CreateStringSchema({
+        required: false,
+        default: defaultValue,
+        description: description ?? 'Environment',
+    }).valid(...allowedValues);
+}
+/**
+ * Create validation schema for JWT expiration times.
+ * Utility to build Joi string schemas that validate JWT expiration duration format (e.g., 15m, 1h, 7d).
+ * @param defaultValue - Default expiration time (default: 15m)
+ * @param description - Human-readable description
+ * @returns Configured Joi StringSchema with JWT expiration validation
+ */
+export function CreateJwtExpirationSchema(defaultValue = '15m', description) {
+    return CreateStringSchema({
+        pattern: /^\d+[smhd]$/,
+        default: defaultValue,
+        description: description ?? 'JWT expiration time (e.g., 15m, 1h, 7d)',
+    });
+}
+//# sourceMappingURL=validation.utils.js.map

package/build/config/validation.utils.js.map

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

package/build/errors/index.d.ts

@@ -0,0 +1,9 @@
+export { BaseApplicationError, createError } from '../common/errors/index.js';
+export { ERROR_CONFIGS } from '../common/errors/index.js';
+export type { ErrorConfig, ErrorType } from '../common/errors/index.js';
+export { BadRequestError, UnauthorizedError, ForbiddenError, NotFoundError, ConflictError, UnprocessableEntityError, InternalServerError, BadGatewayError, ServiceUnavailableError, GatewayTimeoutError, } from '../common/errors/index.js';
+export { ErrorSanitizerService } from '../common/services/error-sanitizer.service.js';
+export { ErrorCategorizerService } from '../common/services/error-categorizer.service.js';
+export { GlobalExceptionFilter } from '../common/filters/global-exception.filter.js';
+export { HttpExceptionFilter } from '../common/filters/http-exception.filter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGxE,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,aAAa,EACb,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,mBAAmB,GACnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iDAAiD,CAAC;AAG1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC"}

package/build/errors/index.js

@@ -0,0 +1,12 @@
+// Error base classes and factories
+export { BaseApplicationError, createError } from '../common/errors/index.js';
+export { ERROR_CONFIGS } from '../common/errors/index.js';
+// Typed HTTP error classes
+export { BadRequestError, UnauthorizedError, ForbiddenError, NotFoundError, ConflictError, UnprocessableEntityError, InternalServerError, BadGatewayError, ServiceUnavailableError, GatewayTimeoutError, } from '../common/errors/index.js';
+// Error handling services
+export { ErrorSanitizerService } from '../common/services/error-sanitizer.service.js';
+export { ErrorCategorizerService } from '../common/services/error-categorizer.service.js';
+// Exception filters
+export { GlobalExceptionFilter } from '../common/filters/global-exception.filter.js';
+export { HttpExceptionFilter } from '../common/filters/http-exception.filter.js';
+//# sourceMappingURL=index.js.map

package/build/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG1D,2BAA2B;AAC3B,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,aAAa,EACb,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,mBAAmB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,0BAA0B;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iDAAiD,CAAC;AAE1F,oBAAoB;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC"}

package/build/guards/custom-throttle.guard.d.ts

@@ -0,0 +1,28 @@
+import { ThrottlerGuard } from '@nestjs/throttler';
+/**
+ * Custom throttle guard that uses IP address for tracking
+ * Provides IP-based rate limiting for HTTP requests
+ *
+ * IMPORTANT: Proxy Configuration
+ * This guard prefers the direct TCP connection address (req.socket.remoteAddress)
+ * which is not spoofable via HTTP headers. If your application is behind a
+ * reverse proxy (Nginx, HAProxy, AWS ELB, etc.), ensure the proxy is correctly
+ * configured as trusted in Express:
+ *
+ * - Express: app.set('trust proxy', 'loopback') or app.set('trust proxy', 1)
+ * - Only then will req.ip correctly reflect the client IP through the proxy
+ *
+ * If req.socket.remoteAddress is unavailable (e.g., in test environments),
+ * falls back to req.ip, which may be influenced by X-Forwarded-For headers.
+ */
+export declare class CustomThrottleGuard extends ThrottlerGuard {
+    /**
+     * Get tracker identifier from request
+     * Prefers the direct socket address (not spoofable via headers),
+     * falls back to req.ip when unavailable
+     * @param req Request object
+     * @returns Tracker string (IP address)
+     */
+    protected getTracker(req: Record<string, unknown>): Promise<string>;
+}
+//# sourceMappingURL=custom-throttle.guard.d.ts.map

package/build/guards/custom-throttle.guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-throttle.guard.d.ts","sourceRoot":"","sources":["../../src/guards/custom-throttle.guard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,qBACa,mBAAoB,SAAQ,cAAc;IACtD;;;;;;OAMG;cAEsB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAelF"}

package/build/guards/custom-throttle.guard.js

@@ -0,0 +1,52 @@
+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 { ThrottlerGuard } from '@nestjs/throttler';
+/**
+ * Custom throttle guard that uses IP address for tracking
+ * Provides IP-based rate limiting for HTTP requests
+ *
+ * IMPORTANT: Proxy Configuration
+ * This guard prefers the direct TCP connection address (req.socket.remoteAddress)
+ * which is not spoofable via HTTP headers. If your application is behind a
+ * reverse proxy (Nginx, HAProxy, AWS ELB, etc.), ensure the proxy is correctly
+ * configured as trusted in Express:
+ *
+ * - Express: app.set('trust proxy', 'loopback') or app.set('trust proxy', 1)
+ * - Only then will req.ip correctly reflect the client IP through the proxy
+ *
+ * If req.socket.remoteAddress is unavailable (e.g., in test environments),
+ * falls back to req.ip, which may be influenced by X-Forwarded-For headers.
+ */
+let CustomThrottleGuard = class CustomThrottleGuard extends ThrottlerGuard {
+    /**
+     * Get tracker identifier from request
+     * Prefers the direct socket address (not spoofable via headers),
+     * falls back to req.ip when unavailable
+     * @param req Request object
+     * @returns Tracker string (IP address)
+     */
+    // eslint-disable-next-line require-await
+    async getTracker(req) {
+        // Prefer the direct TCP connection address (not spoofable via headers)
+        // req.socket.remoteAddress is the actual connecting IP regardless of proxies
+        const directIp = req['socket']?.remoteAddress ??
+            req['connection']?.remoteAddress;
+        if (directIp)
+            return directIp;
+        // Fall back to req.ip only when direct address is unavailable (e.g., test environment)
+        // NOTE: req.ip may be influenced by X-Forwarded-For in proxy setups.
+        // Ensure express trust proxy is configured correctly if behind a trusted reverse proxy.
+        const ip = req['ip'];
+        return ip ?? 'unknown';
+    }
+};
+CustomThrottleGuard = __decorate([
+    Injectable()
+], CustomThrottleGuard);
+export { CustomThrottleGuard };
+//# sourceMappingURL=custom-throttle.guard.js.map

package/build/guards/custom-throttle.guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-throttle.guard.js","sourceRoot":"","sources":["../../src/guards/custom-throttle.guard.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,cAAc;IACtD;;;;;;OAMG;IACH,yCAAyC;IACtB,KAAK,CAAC,UAAU,CAAC,GAA4B;QAC/D,uEAAuE;QACvE,6EAA6E;QAC7E,MAAM,QAAQ,GACZ,GAAG,CAAC,QAAQ,CAA4C,EAAE,aAAa;YACvE,GAAG,CAAC,YAAY,CAA4C,EAAE,aAAa,CAAC;QAE9E,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE9B,uFAAuF;QACvF,qEAAqE;QACrE,wFAAwF;QACxF,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAuB,CAAC;QAC3C,OAAO,EAAE,IAAI,SAAS,CAAC;IACxB,CAAC;CACD,CAAA;AAxBY,mBAAmB;IAD/B,UAAU,EAAE;GACA,mBAAmB,CAwB/B"}

package/build/guards/index.d.ts

@@ -0,0 +1,2 @@
+export { CustomThrottleGuard } from './custom-throttle.guard.js';
+//# sourceMappingURL=index.d.ts.map

package/build/guards/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/build/guards/index.js

@@ -0,0 +1,2 @@
+export { CustomThrottleGuard } from './custom-throttle.guard.js';
+//# sourceMappingURL=index.js.map

package/build/guards/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/guards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @packageDocumentation
+ *
+ * Foundational NestJS infrastructure library providing essential utilities for building secure, observable, and maintainable applications.
+ *
+ * ## Key Features
+ *
+ * - **Error Handling**: Structured error responses with categorization (transient/permanent) and automatic sanitization
+ * - **Logging**: Centralized, structured logging with automatic redaction of sensitive data
+ * - **Metrics**: Prometheus metrics with automatic HTTP request tracking and custom metric support
+ * - **Validation**: Automatic DTO validation and transformation with comprehensive error formatting
+ * - **CSRF Protection**: Double-Submit Cookie pattern with per-IP rate limiting
+ * - **Security**: Global filters, guards, and interceptors for standardized protection
+ * - **Configuration**: Type-safe environment variable access with Joi validation
+ * - **Lazy Loading**: Defer dependency resolution to avoid circular dependencies
+ * - **Audit Logging**: Security event logging for compliance and forensics
+ * - **Health Checks**: Kubernetes-ready liveness, readiness, and general health probes
+ * - **HTTP Client**: Robust HTTP client with timeout, SSL/TLS, and sensitive data redaction
+ *
+ * ## Quick Start
+ *
+ * @example
+ * ```typescript
+ * import { Module } from '@nestjs/common';
+ * import { ConfigModule, CommonModule } from '@pawells/nestjs-shared';
+ *
+ * @Module({
+ *   imports: [
+ *     ConfigModule,     // MUST come first
+ *     CommonModule,     // Depends on ConfigModule
+ *   ],
+ * })
+ * export class AppModule {}
+ *
+ * async function bootstrap() {
+ *   const app = await NestFactory.create(AppModule);
+ *   const port = process.env['PORT'] ?? 3000;
+ *   await app.listen(port);
+ * }
+ * ```
+ *
+ * ## Modules
+ *
+ * - **ConfigModule**: Environment configuration with validation (must be imported first)
+ * - **CommonModule**: Global infrastructure (filters, interceptors, pipes, services)
+ * - **MetricsModule**: Prometheus metrics endpoint and collection
+ */
+export type { IMetricsExporter, MetricDescriptor, MetricValue, MetricType } from './common/interfaces/metrics-exporter.interface.js';
+export { InstrumentationRegistry } from './common/registry/instrumentation-registry.js';
+export { GlobalExceptionFilter, HttpExceptionFilter, LoggingInterceptor, HTTPMetricsInterceptor, BaseValidationPipe, ValidationPipe, RequestProperty, getNestedProperty, getRequestFromContext, createRequestPropertyDecorator, createConditionalDecorator, createValidatingDecorator, createTransformingDecorator, BaseDecoratorOptions, ConditionalDecoratorOptions, ValidatingDecoratorOptions, TransformingDecoratorOptions, Query, Params, Body, Headers, Cookies, LogContext, GRAFANA_TIMEOUT, LOKI_TIMEOUT, PROMETHEUS_TIMEOUT, HTTP_CLIENT_TIMEOUT, CONFIG_VALIDATION_TIMEOUT, LogEntry, LogLevel, LogMetadata, LOG_LEVEL_STRINGS, ILogger, IContextualLogger, AppLogger, NestLoggerAdapter, AuditLoggerService, ErrorSanitizerService, ErrorCategorizerService, HttpClientService, CSRFService, MetricsRegistryService, HealthCheckService, HealthStatus, BaseMetricsCollector, MetricsController, CSRFGuard, MetricsGuard, CommonModule, MetricsModule, SharedThrottlerModule, type SharedThrottlerConfig, BaseApplicationError, createError, ERROR_CONFIGS, ErrorConfig, ErrorType, BadRequestError as CommonBadRequestError, UnauthorizedError as CommonUnauthorizedError, ForbiddenError as CommonForbiddenError, NotFoundError as CommonNotFoundError, ConflictError as CommonConflictError, UnprocessableEntityError as CommonUnprocessableEntityError, InternalServerError as CommonInternalServerError, BadGatewayError as CommonBadGatewayError, ServiceUnavailableError as CommonServiceUnavailableError, GatewayTimeoutError as CommonGatewayTimeoutError, ApplySecurityMiddleware, SecurityBootstrapOptions, CreateRateLimitConfig, RateLimitConfig, RateLimitDescriptor, LazyGetter, OptionalLazyGetter, TokenLazyGetter, LazyModuleRefService, LazyGetterDependencies, OptionalGetterConfig, CreateMemoizedLazyGetter as createMemoizedLazyGetter, CreateOptionalLazyGetter as createOptionalLazyGetter, IsLazyModuleRefService as isLazyModuleRefService, LazyGetterNamingConventions, type IHealthCheck, getErrorStack, getErrorMessage, AsyncModuleOptions, createAsyncOptionsProvider, createAsyncProviders, } from './common/index.js';
+export { ConfigService, ValidationService, ConfigModule, AppConfig, DatabaseConfig, CacheConfig as ConfigCacheConfig, AuthConfig, ValidationResult, ConfigSchema, EnvironmentOptions, CreateValidationSchema, ValidateConfig, CreateStringSchema, CreateNumberSchema, CreateBooleanSchema, CreateUriSchema, CreatePortSchema, CreateEnvironmentSchema, CreateJwtExpirationSchema, } from './config/index.js';
+export { CustomThrottleGuard } from './guards/index.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAKH,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mDAAmD,CAAC;AACrI,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AAKxF,OAAO,EACN,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,8BAA8B,EAC9B,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,KAAK,EACL,MAAM,EACN,IAAI,EACJ,OAAO,EACP,OAAO,EACP,UAAU,EACV,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,WAAW,EACX,SAAS,EACT,eAAe,IAAI,qBAAqB,EACxC,iBAAiB,IAAI,uBAAuB,EAC5C,cAAc,IAAI,oBAAoB,EACtC,aAAa,IAAI,mBAAmB,EACpC,aAAa,IAAI,mBAAmB,EACpC,wBAAwB,IAAI,8BAA8B,EAC1D,mBAAmB,IAAI,yBAAyB,EAChD,eAAe,IAAI,qBAAqB,EACxC,uBAAuB,IAAI,6BAA6B,EACxD,mBAAmB,IAAI,yBAAyB,EAChD,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,IAAI,wBAAwB,EACpD,wBAAwB,IAAI,wBAAwB,EACpD,sBAAsB,IAAI,sBAAsB,EAChD,2BAA2B,EAC3B,KAAK,YAAY,EACjB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,GACpB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,EACN,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,cAAc,EACd,WAAW,IAAI,iBAAiB,EAChC,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,GACzB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}