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

package/build/config/config.module.js

@@ -0,0 +1,49 @@
+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 { Module } from '@nestjs/common';
+import { ConfigService } from './config.service.js';
+import { ValidationService } from './validation.utils.js';
+/**
+ * Configuration Module.
+ * Provides configuration services with environment variable access, validation, and logging.
+ * MUST be imported before CommonModule in your application.
+ *
+ * Exports:
+ * - ConfigService: Typed configuration accessor
+ * - ValidationService: Configuration validation utilities
+ *
+ * @remarks
+ * - ConfigService is required by CommonModule and other @pawells packages
+ * - Initializes logging for configuration operations
+ * - Import order critical: ConfigModule must come BEFORE CommonModule
+ *
+ * @example
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     ConfigModule,              // FIRST
+ *     CommonModule,              // SECOND (depends on ConfigModule)
+ *     MetricsModule.forRoot(),
+ *     // ... other modules
+ *   ]
+ * })
+ * export class AppModule {}
+ * ```
+ */
+let ConfigModule = class ConfigModule {
+};
+ConfigModule = __decorate([
+    Module({
+        providers: [
+            ConfigService,
+            ValidationService,
+        ],
+        exports: [ConfigService, ValidationService],
+    })
+], ConfigModule);
+export { ConfigModule };
+//# sourceMappingURL=config.module.js.map

package/build/config/config.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.module.js","sourceRoot":"","sources":["../../src/config/config.module.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AASI,IAAM,YAAY,GAAlB,MAAM,YAAY;CAAG,CAAA;AAAf,YAAY;IAPxB,MAAM,CAAC;QACP,SAAS,EAAE;YACV,aAAa;YACb,iBAAiB;SACjB;QACD,OAAO,EAAE,CAAC,aAAa,EAAE,iBAAiB,CAAC;KAC3C,CAAC;GACW,YAAY,CAAG"}

package/build/config/config.service.d.ts

@@ -0,0 +1,74 @@
+import { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { LazyModuleRefService } from '../common/utils/lazy-getter.types.js';
+import { AppLogger } from '../common/index.js';
+/**
+ * Configuration schema definition interface.
+ * Used for validating configuration structure.
+ */
+export interface ConfigSchemaDefinition {
+    [key: string]: {
+        required: boolean;
+        [key: string]: any;
+    };
+}
+/**
+ * Configuration Service.
+ * Provides typed access to environment variables with validation and transformation.
+ * Extends NestJS ConfigService with additional typed accessor methods (getString, getNumber).
+ * Integrates with AppLogger for configuration validation logging.
+ *
+ * @remarks
+ * - Must be imported before CommonModule in your application
+ * - Validates configuration at module initialization
+ * - Supports type-safe getters for string and number values
+ * - Logs all configuration operations for audit trail
+ *
+ * @example
+ * ```typescript
+ * // Get configuration values
+ * const port = configService.getNumber('PORT') ?? 3000;
+ * const nodeEnv = configService.getString('NODE_ENV') ?? 'development';
+ * const dbUrl = configService.getOrThrow('DATABASE_URL');
+ *
+ * // Validate configuration
+ * configService.validate({
+ *   PORT: { required: true },
+ *   DATABASE_URL: { required: true },
+ *   LOG_LEVEL: { required: false }
+ * });
+ * ```
+ */
+export declare class ConfigService implements LazyModuleRefService, OnModuleInit, OnModuleDestroy {
+    private _contextualLogger;
+    readonly Module: ModuleRef;
+    constructor(module: ModuleRef);
+    onModuleInit(): void;
+    get Logger(): AppLogger;
+    private get NestConfig();
+    /**
+     * Validate configuration against schema
+     */
+    validate(schema: ConfigSchemaDefinition): void;
+    /**
+     * Get configuration value
+     */
+    get<T = any>(propertyPath: string, defaultValue?: T): T | undefined;
+    /**
+     * Get configuration value or throw
+     */
+    getOrThrow<T = any>(propertyPath: string): T;
+    /**
+     * Get configuration value as string
+     */
+    getString(propertyPath: string, defaultValue?: string): string | undefined;
+    /**
+     * Get configuration value as number
+     */
+    getNumber(propertyPath: string, defaultValue?: number): number | undefined;
+    /**
+     * Cleanup resources on module destruction
+     */
+    onModuleDestroy(): void;
+}
+//# sourceMappingURL=config.service.d.ts.map

package/build/config/config.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.service.d.ts","sourceRoot":"","sources":["../../src/config/config.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG;QACd,QAAQ,EAAE,OAAO,CAAC;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACnB,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,aAAc,YAAW,oBAAoB,EAAE,YAAY,EAAE,eAAe;IACxF,OAAO,CAAC,iBAAiB,CAAwB;IAEjD,SAAgB,MAAM,EAAE,SAAS,CAAC;gBAEtB,MAAM,EAAE,SAAS;IAItB,YAAY,IAAI,IAAI;IAI3B,IAAW,MAAM,IAAI,SAAS,CAQ7B;IAED,OAAO,KAAK,UAAU,GAErB;IAED;;OAEG;IACI,QAAQ,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAuCrD;;OAEG;IACI,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAI1E;;OAEG;IACI,UAAU,CAAC,CAAC,GAAG,GAAG,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC;IAInD;;OAEG;IACI,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMjF;;OAEG;IACI,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOjF;;OAEG;IACI,eAAe,IAAI,IAAI;CAG9B"}

package/build/config/config.service.js

@@ -0,0 +1,145 @@
+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 ConfigService_1;
+import { Injectable, Logger } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { ConfigService as NestConfigService } from '@nestjs/config';
+import { AppLogger } from '../common/index.js';
+/**
+ * Configuration Service.
+ * Provides typed access to environment variables with validation and transformation.
+ * Extends NestJS ConfigService with additional typed accessor methods (getString, getNumber).
+ * Integrates with AppLogger for configuration validation logging.
+ *
+ * @remarks
+ * - Must be imported before CommonModule in your application
+ * - Validates configuration at module initialization
+ * - Supports type-safe getters for string and number values
+ * - Logs all configuration operations for audit trail
+ *
+ * @example
+ * ```typescript
+ * // Get configuration values
+ * const port = configService.getNumber('PORT') ?? 3000;
+ * const nodeEnv = configService.getString('NODE_ENV') ?? 'development';
+ * const dbUrl = configService.getOrThrow('DATABASE_URL');
+ *
+ * // Validate configuration
+ * configService.validate({
+ *   PORT: { required: true },
+ *   DATABASE_URL: { required: true },
+ *   LOG_LEVEL: { required: false }
+ * });
+ * ```
+ */
+let ConfigService = ConfigService_1 = class ConfigService {
+    _contextualLogger;
+    Module;
+    constructor(module) {
+        this.Module = module;
+    }
+    onModuleInit() {
+        Logger.log('Configuration service initialized', ConfigService_1.name);
+    }
+    get Logger() {
+        if (!this._contextualLogger) {
+            const baseLogger = this.Module.get(AppLogger, { strict: false });
+            if (baseLogger) {
+                this._contextualLogger = baseLogger.createContextualLogger(ConfigService_1.name);
+            }
+        }
+        return this._contextualLogger ?? this.Module.get(AppLogger);
+    }
+    get NestConfig() {
+        return this.Module.get(NestConfigService, { strict: false });
+    }
+    /**
+     * Validate configuration against schema
+     */
+    validate(schema) {
+        const startTime = Date.now();
+        this.Logger.debug('Starting configuration validation', {
+            schemaKeys: Object.keys(schema).length,
+        });
+        try {
+            // Basic validation - check required fields
+            const requiredFields = Object.keys(schema).filter(key => schema[key].required);
+            const optionalFields = Object.keys(schema).filter(key => !schema[key].required);
+            const missingFields = requiredFields.filter(field => this.get(field) === undefined);
+            if (missingFields.length > 0) {
+                const durationMs = Date.now() - startTime;
+                this.Logger.error('Configuration validation failed', undefined, undefined, {
+                    missingFields,
+                    requiredFields: requiredFields.length,
+                    durationMs,
+                });
+                throw new Error(`Missing required configuration fields: ${missingFields.join(', ')}`);
+            }
+            const durationMs = Date.now() - startTime;
+            this.Logger.info('Configuration validation successful', {
+                validatedFields: Object.keys(schema).length,
+                requiredFields: requiredFields.length,
+                optionalFields: optionalFields.length,
+                durationMs,
+            });
+        }
+        catch (error) {
+            const durationMs = Date.now() - startTime;
+            this.Logger.error('Configuration validation error', undefined, undefined, {
+                error: error instanceof Error ? error.message : String(error),
+                durationMs,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Get configuration value
+     */
+    get(propertyPath, defaultValue) {
+        return this.NestConfig.get(propertyPath, defaultValue);
+    }
+    /**
+     * Get configuration value or throw
+     */
+    getOrThrow(propertyPath) {
+        return this.NestConfig.getOrThrow(propertyPath);
+    }
+    /**
+     * Get configuration value as string
+     */
+    getString(propertyPath, defaultValue) {
+        const value = this.get(propertyPath, defaultValue);
+        if (value === undefined)
+            return undefined;
+        return String(value);
+    }
+    /**
+     * Get configuration value as number
+     */
+    getNumber(propertyPath, defaultValue) {
+        const value = this.get(propertyPath, defaultValue);
+        if (value === undefined)
+            return undefined;
+        const num = Number(value);
+        return isNaN(num) ? undefined : num;
+    }
+    /**
+     * Cleanup resources on module destruction
+     */
+    onModuleDestroy() {
+        this._contextualLogger = undefined;
+    }
+};
+ConfigService = ConfigService_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [ModuleRef])
+], ConfigService);
+export { ConfigService };
+//# sourceMappingURL=config.service.js.map

package/build/config/config.service.js.map

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

package/build/config/config.types.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Application Configuration Interface
+ * Defines top-level application configuration for port, environment, CORS, file uploads, logging, and optional GraphQL settings.
+ */
+export interface AppConfig {
+    /** Server port number */
+    port: number;
+    /** Node environment (development, production, test) */
+    nodeEnv: string;
+    /** CORS origin URL */
+    corsOrigin: string;
+    /** Maximum file size in bytes */
+    maxFileSize: number;
+    /** Storage path for uploads */
+    storagePath: string;
+    /** Log level (debug, info, warn, error, fatal) */
+    logLevel: string;
+    /** Optional GraphQL configuration */
+    graphql?: {
+        /** Enable GraphQL Playground */
+        playground: boolean;
+        /** Enable schema introspection */
+        introspection: boolean;
+    };
+}
+/**
+ * Database Configuration Interface
+ * Defines MongoDB/database connection parameters and connection pool options.
+ */
+export interface DatabaseConfig {
+    /** Database connection URI */
+    uri: string;
+    /** Optional connection options */
+    options?: {
+        /** Use new URL parser */
+        useNewUrlParser?: boolean;
+        /** Use unified topology */
+        useUnifiedTopology?: boolean;
+        /** Connection pool size */
+        maxPoolSize?: number;
+        /** Server selection timeout in milliseconds */
+        serverSelectionTimeoutMS?: number;
+        /** Socket timeout in milliseconds */
+        socketTimeoutMS?: number;
+    };
+}
+/**
+ * Cache Configuration Interface
+ * Defines Redis cache connection parameters, timeouts, retry behavior, and performance settings.
+ */
+export interface CacheConfig {
+    /** Redis host */
+    host: string;
+    /** Redis port */
+    port: number;
+    /** Optional Redis password for authentication */
+    password?: string;
+    /** Redis database number */
+    db: number;
+    /** Time-to-live (TTL) in seconds for cache entries */
+    ttl: number;
+    /** Key prefix for all cache entries */
+    keyPrefix: string;
+    /** Connection timeout in milliseconds */
+    connectTimeout: number;
+    /** Command timeout in milliseconds */
+    commandTimeout: number;
+    /** Keep-alive interval in milliseconds */
+    keepAlive: number;
+    /** Delay between connection retry attempts in milliseconds */
+    retryDelay: number;
+    /** Maximum number of connection retry attempts */
+    maxRetries: number;
+    /** Enable ready check before issuing commands */
+    enableReadyCheck: boolean;
+    /** Defer connection until first command */
+    lazyConnect: boolean;
+    /** Address family (4 for IPv4, 6 for IPv6) */
+    family: number;
+    /** Enable Redis metrics collection */
+    enableMetrics: boolean;
+}
+/**
+ * Authentication Configuration Interface
+ * Defines JWT token signing and validation parameters.
+ */
+export interface AuthConfig {
+    /** JWT token configuration */
+    jwt: {
+        /** Secret key for signing tokens */
+        secret: string;
+        /** Token expiration time (e.g., '15m', '1h', '7d') */
+        expiresIn: string;
+        /** Refresh token expiration time */
+        refreshExpiresIn?: string;
+        /** Token issuer claim */
+        issuer?: string;
+        /** Token audience claim */
+        audience?: string;
+    };
+}
+/**
+ * Generic Configuration Validation Result
+ * Indicates validation outcome and collects any errors or warnings encountered.
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    isValid: boolean;
+    /** Array of validation error messages */
+    errors?: string[];
+    /** Array of validation warning messages */
+    warnings?: string[];
+}
+/**
+ * Configuration Schema Definition
+ * Object map defining validation rules for configuration values.
+ */
+export interface ConfigSchema {
+    /** Joi schema definition for configuration keys */
+    [key: string]: any;
+}
+/**
+ * Environment Configuration Options
+ * Options for loading and validating environment variables from files and process.env.
+ */
+export interface EnvironmentOptions {
+    /** Joi schema for validating environment variables */
+    validationSchema?: ConfigSchema;
+    /** Options passed to Joi schema validation */
+    validationOptions?: {
+        /** Allow unknown environment variables */
+        allowUnknown?: boolean;
+        /** Strip unknown environment variables */
+        stripUnknown?: boolean;
+    };
+    /** Skip loading from .env files */
+    ignoreEnvFile?: boolean;
+    /** Skip reading from process.env */
+    ignoreEnvVars?: boolean;
+    /** Path(s) to .env files to load */
+    envFilePath?: string | string[];
+}
+//# sourceMappingURL=config.types.d.ts.map

package/build/config/config.types.d.ts.map

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

package/build/config/config.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.types.js.map

package/build/config/config.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.types.js","sourceRoot":"","sources":["../../src/config/config.types.ts"],"names":[],"mappings":""}

package/build/config/decorators/config.decorators.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Configuration Value decorator
+ *
+ * Extracts configuration values from the application config service.
+ * The config service must be available in the request context.
+ *
+ * @param key - Configuration key to extract
+ * @param defaultValue - Default value if key not found
+ * @returns Parameter decorator
+ *
+ * @example
+ * // Extract database URL
+ * @Get('config')
+ * getConfig(@ConfigValue('database.url') dbUrl: string) {}
+ *
+ * @example
+ * // Extract with default
+ * @Get('config')
+ * getConfig(@ConfigValue('app.port', 3000) port: number) {}
+ */
+export declare function ConfigValue<T = any>(key: string, defaultValue?: T): any;
+/**
+ * Environment Variable decorator
+ *
+ * Extracts environment variables from process.env.
+ * Provides a convenient way to inject environment variables into parameters.
+ *
+ * @param key - Environment variable name
+ * @param defaultValue - Default value if environment variable not set
+ * @returns Parameter decorator
+ *
+ * @example
+ * // Extract NODE_ENV
+ * @Get('env')
+ * getEnv(@EnvVar('NODE_ENV') nodeEnv: string) {}
+ *
+ * @example
+ * // Extract with default
+ * @Get('env')
+ * getEnv(@EnvVar('PORT', '3000') port: string) {}
+ */
+export declare function EnvVar<T = string>(key: string, defaultValue?: T): any;
+//# sourceMappingURL=config.decorators.d.ts.map

package/build/config/decorators/config.decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.decorators.d.ts","sourceRoot":"","sources":["../../../src/config/decorators/config.decorators.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,GAAG,CAKvE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,GAAG,CAmBrE"}

package/build/config/decorators/config.decorators.js

@@ -0,0 +1,68 @@
+import { RequestProperty } from '../../common/index.js';
+/**
+ * Configuration Value decorator
+ *
+ * Extracts configuration values from the application config service.
+ * The config service must be available in the request context.
+ *
+ * @param key - Configuration key to extract
+ * @param defaultValue - Default value if key not found
+ * @returns Parameter decorator
+ *
+ * @example
+ * // Extract database URL
+ * @Get('config')
+ * getConfig(@ConfigValue('database.url') dbUrl: string) {}
+ *
+ * @example
+ * // Extract with default
+ * @Get('config')
+ * getConfig(@ConfigValue('app.port', 3000) port: number) {}
+ */
+export function ConfigValue(key, defaultValue) {
+    return RequestProperty(`config.${key}`, {
+        defaultValue,
+        transform: (value) => value ?? defaultValue,
+    });
+}
+/**
+ * Environment Variable decorator
+ *
+ * Extracts environment variables from process.env.
+ * Provides a convenient way to inject environment variables into parameters.
+ *
+ * @param key - Environment variable name
+ * @param defaultValue - Default value if environment variable not set
+ * @returns Parameter decorator
+ *
+ * @example
+ * // Extract NODE_ENV
+ * @Get('env')
+ * getEnv(@EnvVar('NODE_ENV') nodeEnv: string) {}
+ *
+ * @example
+ * // Extract with default
+ * @Get('env')
+ * getEnv(@EnvVar('PORT', '3000') port: string) {}
+ */
+export function EnvVar(key, defaultValue) {
+    return RequestProperty(`env.${key}`, {
+        defaultValue,
+        transform: (value) => {
+            // Get from process.env
+            const envValue = process.env[key];
+            if (envValue !== undefined) {
+                // Basic type conversion for common types
+                if (typeof defaultValue === 'number') {
+                    return Number(envValue);
+                }
+                if (typeof defaultValue === 'boolean') {
+                    return envValue.toLowerCase() === 'true';
+                }
+                return envValue;
+            }
+            return value ?? defaultValue;
+        },
+    });
+}
+//# sourceMappingURL=config.decorators.js.map

package/build/config/decorators/config.decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.decorators.js","sourceRoot":"","sources":["../../../src/config/decorators/config.decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,WAAW,CAAU,GAAW,EAAE,YAAgB;IACjE,OAAO,eAAe,CAAC,UAAU,GAAG,EAAE,EAAE;QACvC,YAAY;QACZ,SAAS,EAAE,CAAC,KAAQ,EAAE,EAAE,CAAC,KAAK,IAAI,YAAY;KAC9C,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,MAAM,CAAa,GAAW,EAAE,YAAgB;IAC/D,OAAO,eAAe,CAAC,OAAO,GAAG,EAAE,EAAE;QACpC,YAAY;QACZ,SAAS,EAAE,CAAC,KAAQ,EAAE,EAAE;YACvB,uBAAuB;YACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC5B,yCAAyC;gBACzC,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;oBACtC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACzB,CAAC;gBACD,IAAI,OAAO,YAAY,KAAK,SAAS,EAAE,CAAC;oBACvC,OAAO,QAAQ,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;gBAC1C,CAAC;gBACD,OAAO,QAAQ,CAAC;YACjB,CAAC;YACD,OAAO,KAAK,IAAI,YAAY,CAAC;QAC9B,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/build/config/decorators/index.d.ts

@@ -0,0 +1,2 @@
+export { ConfigValue, EnvVar } from './config.decorators.js';
+//# sourceMappingURL=index.d.ts.map

package/build/config/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC"}

package/build/config/decorators/index.js

@@ -0,0 +1,2 @@
+export { ConfigValue, EnvVar } from './config.decorators.js';
+//# sourceMappingURL=index.js.map

package/build/config/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC"}

package/build/config/index.d.ts

@@ -0,0 +1,7 @@
+export { ConfigService } from './config.service.js';
+export { ValidationService } from './validation.utils.js';
+export { ConfigModule } from './config.module.js';
+export type { AppConfig, DatabaseConfig, CacheConfig, AuthConfig, ValidationResult, ConfigSchema, EnvironmentOptions, } from './config.types.js';
+export { CreateValidationSchema, ValidateConfig, CreateStringSchema, CreateNumberSchema, CreateBooleanSchema, CreateUriSchema, CreatePortSchema, CreateEnvironmentSchema, CreateJwtExpirationSchema, } from './validation.utils.js';
+export * from './decorators/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,YAAY,EACX,SAAS,EACT,cAAc,EACd,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,GAClB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACN,sBAAsB,EACtB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,cAAc,uBAAuB,CAAC"}

package/build/config/index.js

@@ -0,0 +1,9 @@
+// Main exports
+export { ConfigService } from './config.service.js';
+export { ValidationService } from './validation.utils.js';
+export { ConfigModule } from './config.module.js';
+// Validation utilities
+export { CreateValidationSchema, ValidateConfig, CreateStringSchema, CreateNumberSchema, CreateBooleanSchema, CreateUriSchema, CreatePortSchema, CreateEnvironmentSchema, CreateJwtExpirationSchema, } from './validation.utils.js';
+// Decorators
+export * from './decorators/index.js';
+//# sourceMappingURL=index.js.map

package/build/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAalD,uBAAuB;AACvB,OAAO,EACN,sBAAsB,EACtB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,aAAa;AACb,cAAc,uBAAuB,CAAC"}