@dyanet/nestjs-config-aws 1.0.1

package/dist/esm/loaders/ssm-parameter-store.loader.js

@@ -0,0 +1,142 @@
+import { GetParametersByPathCommand, SSMClient } from '@aws-sdk/client-ssm';
+import { fromNodeProviderChain } from '@aws-sdk/credential-providers';
+import { ConfigurationError } from '../interfaces/errors.interface';
+/**
+ * Configuration loader that loads values from AWS Systems Manager Parameter Store.
+ * Supports environment-aware parameter path construction, recursive parameter fetching with pagination,
+ * and parameter name transformation (remove prefix, convert to uppercase).
+ */
+export class SSMParameterStoreLoader {
+    constructor(config = {}) {
+        this.appEnv = process.env['APP_ENV'] || process.env['NODE_ENV'] || 'local';
+        // Set default configuration
+        this.config = {
+            parameterPath: config.parameterPath || '/nestjs-config-aws',
+            region: config.region || process.env['AWS_REGION'] || 'us-east-1',
+            environmentMapping: config.environmentMapping || {
+                development: 'dev',
+                test: 'test',
+                production: 'production'
+            },
+            withDecryption: config.withDecryption ?? true
+        };
+        // Initialize AWS SSM client
+        this.client = new SSMClient({
+            credentials: fromNodeProviderChain(),
+            region: this.config.region,
+        });
+    }
+    /**
+     * Load configuration from AWS Systems Manager Parameter Store.
+     * Implements recursive parameter fetching with NextToken handling for pagination.
+     * @returns Promise resolving to configuration key-value pairs from parameters
+     */
+    async load() {
+        // Skip loading in local environment or if AWS_REGION is not available
+        if (this.appEnv === 'local' || !process.env['AWS_REGION']) {
+            return {};
+        }
+        const parameterPath = this.buildParameterPath();
+        const result = {};
+        let nextToken;
+        try {
+            do {
+                const command = new GetParametersByPathCommand({
+                    Path: parameterPath,
+                    Recursive: true,
+                    WithDecryption: this.config.withDecryption,
+                    NextToken: nextToken,
+                });
+                const response = await this.client.send(command);
+                if (!response.Parameters) {
+                    // No parameters found - this is not necessarily an error
+                    break;
+                }
+                // Process each parameter
+                for (const param of response.Parameters) {
+                    const key = this.transformParameterName(param.Name, parameterPath);
+                    if (key && param.Value !== undefined) {
+                        result[key] = param.Value;
+                    }
+                }
+                nextToken = response.NextToken;
+            } while (nextToken);
+            return result;
+        }
+        catch (error) {
+            // Handle specific AWS errors
+            if (error instanceof Error) {
+                if (error.name === 'AccessDeniedException') {
+                    throw new ConfigurationError(`Access denied when retrieving parameters from path '${parameterPath}'. Check AWS credentials and permissions.`, error);
+                }
+                if (error.name === 'InvalidFilterKey' || error.name === 'InvalidFilterValue') {
+                    throw new ConfigurationError(`Invalid parameter path '${parameterPath}'. Check path format.`, error);
+                }
+                if (error.name === 'ParameterNotFound') {
+                    // No parameters found at path - this is not necessarily an error
+                    return {};
+                }
+            }
+            // For other errors, wrap in ConfigurationError
+            throw new ConfigurationError(`Failed to retrieve parameters from path '${parameterPath}' in AWS SSM Parameter Store: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Get the name of this loader for logging and debugging.
+     * @returns The loader name with parameter path
+     */
+    getName() {
+        const parameterPath = this.buildParameterPath();
+        return `SSMParameterStoreLoader(${parameterPath})`;
+    }
+    /**
+     * Check if this loader is available in the current environment.
+     * @returns Promise resolving to true if not in local environment, AWS_REGION is set, and AWS credentials are available
+     */
+    async isAvailable() {
+        // Skip in local environment or if AWS_REGION is not available
+        if (this.appEnv === 'local' || !process.env['AWS_REGION']) {
+            return false;
+        }
+        try {
+            // Test AWS credentials by attempting to get caller identity
+            // This is a lightweight way to verify AWS access without making actual SSM calls
+            await this.client.config.credentials();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Build the environment-aware parameter path.
+     * @returns The full parameter path with environment prefix
+     */
+    buildParameterPath() {
+        const envPrefix = this.config.environmentMapping[this.appEnv];
+        if (!envPrefix) {
+            throw new ConfigurationError(`No environment mapping found for APP_ENV '${this.appEnv}'. ` +
+                `Available environments: ${Object.keys(this.config.environmentMapping).join(', ')}`);
+        }
+        return `/${envPrefix}${this.config.parameterPath}`;
+    }
+    /**
+     * Transform parameter name by removing the prefix and converting to uppercase.
+     * Example: '/dev/nestjs-config-aws/database/host' -> 'DATABASEHOST'
+     * This matches the original prospectory-backend implementation
+     * @param parameterName The full parameter name from AWS
+     * @param pathPrefix The path prefix to remove
+     * @returns The transformed parameter name or null if invalid
+     */
+    transformParameterName(parameterName, pathPrefix) {
+        if (!parameterName) {
+            return null;
+        }
+        // Remove the path prefix and all slashes, then convert to uppercase
+        // This matches the original implementation: .replace(envPrefix, '').replace(/\//g, '').toUpperCase()
+        const key = parameterName.replace(pathPrefix, '').replace(/\//g, '').toUpperCase();
+        // Return null for empty keys
+        return key || null;
+    }
+}
+//# sourceMappingURL=ssm-parameter-store.loader.js.map

package/dist/esm/loaders/ssm-parameter-store.loader.js.map

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

package/dist/esm/services/config.service.js

@@ -0,0 +1,261 @@
+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 ConfigServiceImpl_1;
+import { Injectable, Logger } from '@nestjs/common';
+import { ConfigService } from '../interfaces/config-service.interface';
+import { getSchemaForEnvironment, appEnvSchema } from '../interfaces/default-schema.interface';
+import { ConfigurationError, ConfigurationLoadError } from '../interfaces/errors.interface';
+import { ConfigValidationUtil } from '../utils/validation.util';
+import { EnvironmentLoader } from '../loaders/environment.loader';
+import { SecretsManagerLoader } from '../loaders/secrets-manager.loader';
+import { SSMParameterStoreLoader } from '../loaders/ssm-parameter-store.loader';
+/**
+ * Implementation of ConfigService with AWS integration and APP_ENV logic.
+ * Provides type-safe configuration access with orchestrated loading from multiple sources.
+ */
+let ConfigServiceImpl = ConfigServiceImpl_1 = class ConfigServiceImpl extends ConfigService {
+    constructor(options = {}) {
+        super();
+        this.logger = new Logger(ConfigServiceImpl_1.name);
+        this.config = null;
+        this.initialized = false;
+        // Set default options
+        this.options = {
+            envPrefix: options.envPrefix,
+            validateOnLoad: options.validateOnLoad ?? true,
+            enableLogging: options.enableLogging ?? true,
+        };
+        // Initialize APP_ENV logic
+        this.appEnv = this.initializeAppEnv();
+        // Set schema - use environment-specific schema if no custom schema provided
+        this.schema = options.schema || getSchemaForEnvironment(this.appEnv);
+        // Initialize loaders
+        this.loaders = options.loaders || this.createDefaultLoaders();
+    }
+    /**
+     * Initialize the configuration service by loading and validating configuration.
+     * This method should be called during application startup.
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        try {
+            if (this.options.enableLogging) {
+                this.logger.log(`Initializing configuration service with APP_ENV: ${this.appEnv}`);
+            }
+            // Load configuration from all sources
+            const rawConfig = await this.loadConfiguration();
+            // Validate configuration if enabled
+            if (this.options.validateOnLoad) {
+                this.config = ConfigValidationUtil.validateConfiguration(this.schema, rawConfig, 'merged configuration');
+            }
+            else {
+                this.config = rawConfig;
+            }
+            this.initialized = true;
+            if (this.options.enableLogging) {
+                this.logger.log('Configuration service initialized successfully');
+            }
+        }
+        catch (error) {
+            const errorMessage = `Failed to initialize configuration service: ${error instanceof Error ? error.message : String(error)}`;
+            this.logger.error(errorMessage);
+            throw new ConfigurationError(errorMessage, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Get a configuration value by key with type safety.
+     * @param key - The configuration key to retrieve
+     * @returns The configuration value with proper typing
+     */
+    get(key) {
+        if (!this.initialized || !this.config) {
+            throw new ConfigurationError('Configuration service not initialized. Call initialize() first.');
+        }
+        return this.config[key];
+    }
+    /**
+     * Check if the configuration service has been initialized.
+     * @returns True if the service is ready to serve configuration values
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Get all configuration values.
+     * @returns The complete configuration object
+     */
+    getAll() {
+        if (!this.initialized || !this.config) {
+            throw new ConfigurationError('Configuration service not initialized. Call initialize() first.');
+        }
+        return this.config;
+    }
+    /**
+     * Get the current APP_ENV value.
+     * @returns The current application environment
+     */
+    getAppEnv() {
+        return this.appEnv;
+    }
+    /**
+     * Initialize APP_ENV with NODE_ENV mirroring and warning logic.
+     * Implements requirement 2.0: APP_ENV mirroring NODE_ENV with "local" default and warning logic.
+     */
+    initializeAppEnv() {
+        const nodeEnv = process.env['NODE_ENV'];
+        const appEnv = process.env['APP_ENV'];
+        // If APP_ENV is explicitly set
+        if (appEnv) {
+            // Validate APP_ENV value
+            const validation = ConfigValidationUtil.safeValidate(appEnvSchema, appEnv);
+            if (!validation.success) {
+                // If APP_ENV is invalid, try to use NODE_ENV as fallback
+                if (nodeEnv) {
+                    const nodeEnvValidation = ConfigValidationUtil.safeValidate(appEnvSchema, nodeEnv);
+                    if (nodeEnvValidation.success) {
+                        if (this.options.enableLogging) {
+                            this.logger.warn(`Invalid APP_ENV value '${appEnv}'. Using NODE_ENV '${nodeEnv}' as fallback.`);
+                        }
+                        return nodeEnv;
+                    }
+                }
+                // Both APP_ENV and NODE_ENV are invalid, default to 'local'
+                if (this.options.enableLogging) {
+                    this.logger.warn(`Invalid APP_ENV value '${appEnv}' and no valid NODE_ENV fallback. Defaulting to 'local'.`);
+                }
+                return 'local';
+            }
+            // APP_ENV is valid, check if it differs from NODE_ENV
+            if (nodeEnv && nodeEnv !== appEnv) {
+                if (this.options.enableLogging) {
+                    this.logger.warn(`APP_ENV '${appEnv}' differs from NODE_ENV '${nodeEnv}'. Using APP_ENV value.`);
+                }
+            }
+            return appEnv;
+        }
+        // APP_ENV not set, try to use NODE_ENV
+        if (nodeEnv) {
+            const validation = ConfigValidationUtil.safeValidate(appEnvSchema, nodeEnv);
+            if (validation.success) {
+                return nodeEnv;
+            }
+            // NODE_ENV is invalid, log warning and default to 'local'
+            if (this.options.enableLogging) {
+                this.logger.warn(`Invalid NODE_ENV value '${nodeEnv}'. Defaulting to 'local'.`);
+            }
+        }
+        // Neither APP_ENV nor NODE_ENV set, default to 'local'
+        return 'local';
+    }
+    /**
+     * Create default configuration loaders.
+     * @returns Array of default loaders in precedence order
+     */
+    createDefaultLoaders() {
+        return [
+            new EnvironmentLoader(this.options.envPrefix),
+            new SecretsManagerLoader(),
+            new SSMParameterStoreLoader(),
+        ];
+    }
+    /**
+     * Load configuration from all sources with proper precedence order.
+     * Implements orchestration: env -> secrets -> ssm with proper merging.
+     */
+    async loadConfiguration() {
+        const mergedConfig = {};
+        for (const loader of this.loaders) {
+            try {
+                // Check if loader is available in current environment
+                const isAvailable = await loader.isAvailable();
+                if (!isAvailable) {
+                    if (this.options.enableLogging) {
+                        this.logger.debug(`Skipping ${loader.getName()} - not available in current environment`);
+                    }
+                    continue;
+                }
+                if (this.options.enableLogging) {
+                    this.logger.debug(`Loading configuration from ${loader.getName()}`);
+                }
+                // Load configuration from this source
+                const loaderConfig = await loader.load();
+                // Merge with existing configuration
+                // Later loaders override earlier ones (environment variables have lowest precedence)
+                Object.assign(mergedConfig, loaderConfig);
+                if (this.options.enableLogging) {
+                    const keyCount = Object.keys(loaderConfig).length;
+                    this.logger.debug(`Loaded ${keyCount} configuration values from ${loader.getName()}`);
+                }
+            }
+            catch (error) {
+                const errorMessage = `Failed to load configuration from ${loader.getName()}: ${error instanceof Error ? error.message : String(error)}`;
+                if (this.options.enableLogging) {
+                    this.logger.error(errorMessage);
+                }
+                throw new ConfigurationLoadError(errorMessage, loader.getName(), error instanceof Error ? error : undefined);
+            }
+        }
+        // Handle special case for local environment with .env file override
+        if (this.appEnv === 'local') {
+            await this.handleLocalEnvironmentOverrides(mergedConfig);
+        }
+        return mergedConfig;
+    }
+    /**
+     * Handle local environment overrides according to requirement 2.4.
+     * In local mode with valid AWS profile and .env file, .env values override AWS values.
+     */
+    async handleLocalEnvironmentOverrides(config) {
+        // Check if we have a valid AWS profile in the credential chain
+        const awsProfile = process.env['AWS_PROFILE'];
+        if (!awsProfile) {
+            return; // No AWS profile, no special handling needed
+        }
+        // Check if .env file exists (this is a simplified check - in real implementation
+        // you might want to use a library like dotenv to properly detect .env files)
+        try {
+            const fs = await import('fs');
+            const path = await import('path');
+            const envFilePath = path.resolve(process.cwd(), '.env');
+            const envFileExists = fs.existsSync(envFilePath);
+            if (envFileExists) {
+                if (this.options.enableLogging) {
+                    this.logger.debug('Local environment detected with AWS profile and .env file. ' +
+                        'Environment variables from .env will override AWS values.');
+                }
+                // Load .env file and override AWS values
+                const dotenv = await import('dotenv');
+                const envConfig = dotenv.config({ path: envFilePath });
+                if (envConfig.parsed) {
+                    // Override AWS values with .env values
+                    Object.assign(config, envConfig.parsed);
+                    if (this.options.enableLogging) {
+                        const overrideCount = Object.keys(envConfig.parsed).length;
+                        this.logger.debug(`Applied ${overrideCount} overrides from .env file`);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            // If we can't load .env file, just log a warning and continue
+            if (this.options.enableLogging) {
+                this.logger.warn(`Failed to load .env file for local overrides: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+};
+ConfigServiceImpl = ConfigServiceImpl_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [Object])
+], ConfigServiceImpl);
+export { ConfigServiceImpl };
+//# sourceMappingURL=config.service.js.map

package/dist/esm/services/config.service.js.map

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

package/dist/esm/utils/validation.util.js

@@ -0,0 +1,110 @@
+import { ValidationError } from '../interfaces/errors.interface';
+/**
+ * Framework-agnostic validation utility for configuration values
+ * Adapted from ZodValidationPipe for standalone use
+ */
+export class ConfigValidationUtil {
+    /**
+     * Validates a value against a Zod schema
+     * @param schema The Zod schema to validate against
+     * @param value The value to validate
+     * @param context Optional context for error messages
+     * @returns The validated and transformed value
+     * @throws ValidationError if validation fails
+     */
+    static validate(schema, value, context) {
+        const result = schema.safeParse(value);
+        if (result.success) {
+            return result.data;
+        }
+        const errors = this.formatValidationErrors(result.error);
+        const contextMessage = context ? `Configuration validation failed for ${context}` : 'Configuration validation failed';
+        throw new ValidationError(contextMessage, errors);
+    }
+    /**
+     * Safely validates a value against a Zod schema without throwing
+     * @param schema The Zod schema to validate against
+     * @param value The value to validate
+     * @returns Object with success flag and either data or error
+     */
+    static safeValidate(schema, value) {
+        const result = schema.safeParse(value);
+        if (result.success) {
+            return { success: true, data: result.data };
+        }
+        const errors = this.formatValidationErrors(result.error);
+        const validationError = new ValidationError('Configuration validation failed', errors);
+        return { success: false, error: validationError };
+    }
+    /**
+     * Formats Zod validation errors into a structured format
+     * @param error The ZodError to format
+     * @returns Formatted error object or string
+     */
+    static formatValidationErrors(error) {
+        // If there's only one error at the root level, return just the message
+        if (error.issues.length === 1) {
+            const issue = error.issues[0];
+            if (issue && Array.isArray(issue.path) && issue.path.length === 0) {
+                return issue.message;
+            }
+        }
+        // For multiple errors or nested paths, create a structured object
+        return error.issues.reduce((errors, issue) => {
+            const path = issue.path.join('.');
+            const key = path || 'root';
+            if (!errors[key]) {
+                errors[key] = [];
+            }
+            errors[key].push({
+                message: issue.message,
+                code: issue.code,
+                path: issue.path,
+            });
+            return errors;
+        }, {});
+    }
+    /**
+     * Creates a detailed error message for configuration validation failures
+     * @param error The ZodError to create a message for
+     * @param context Optional context for the error
+     * @returns Detailed error message string
+     */
+    static createDetailedErrorMessage(error, context) {
+        const contextPrefix = context ? `${context}: ` : '';
+        if (error.issues.length === 1) {
+            const issue = error.issues[0];
+            if (issue) {
+                const pathStr = issue.path.length > 0 ? ` at '${issue.path.join('.')}'` : '';
+                return `${contextPrefix}${issue.message}${pathStr}`;
+            }
+        }
+        const errorMessages = error.issues.map(issue => {
+            const pathStr = issue.path.length > 0 ? ` at '${issue.path.join('.')}'` : '';
+            return `  - ${issue.message}${pathStr}`;
+        });
+        return `${contextPrefix}Multiple validation errors:\n${errorMessages.join('\n')}`;
+    }
+    /**
+     * Validates configuration with enhanced error context
+     * @param schema The Zod schema to validate against
+     * @param value The configuration object to validate
+     * @param source The source of the configuration (e.g., 'environment', 'secrets-manager')
+     * @returns The validated configuration
+     * @throws ValidationError with enhanced context
+     */
+    static validateConfiguration(schema, value, source) {
+        try {
+            return this.validate(schema, value, `${source} configuration`);
+        }
+        catch (error) {
+            if (error instanceof ValidationError) {
+                // Enhance the error with source information
+                const enhancedMessage = `Configuration validation failed for source '${source}': ${error.message}`;
+                throw new ValidationError(enhancedMessage, error.validationErrors);
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=validation.util.js.map

package/dist/esm/utils/validation.util.js.map

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

package/dist/types/config.module.d.ts

@@ -0,0 +1,46 @@
+import { DynamicModule } from '@nestjs/common';
+import { NestConfigAwsModuleOptions, NestConfigAwsModuleAsyncOptions } from './interfaces/module-options.interface';
+import { DefaultConfigSchema } from './interfaces/default-schema.interface';
+/**
+ * Token for injecting module options
+ */
+export declare const NEST_CONFIG_AWS_OPTIONS = "NEST_CONFIG_AWS_OPTIONS";
+/**
+ * NestJS module for AWS-integrated configuration management.
+ * Provides global configuration service with support for environment variables,
+ * AWS Secrets Manager, and AWS Systems Manager Parameter Store.
+ */
+export declare class ConfigModule {
+    /**
+     * Create a synchronous configuration module with provided options.
+     *
+     * @param options - Configuration options for the module
+     * @returns Dynamic module configuration
+     */
+    static forRoot<T = DefaultConfigSchema>(options?: NestConfigAwsModuleOptions<T>): DynamicModule;
+    /**
+     * Create an asynchronous configuration module with factory-based options.
+     * Useful when configuration options depend on other services or async operations.
+     *
+     * @param options - Async configuration options with factory function
+     * @returns Dynamic module configuration
+     */
+    static forRootAsync<T = DefaultConfigSchema>(options: NestConfigAwsModuleAsyncOptions<T>): DynamicModule;
+    /**
+     * Create the ConfigService provider for synchronous module registration.
+     */
+    private static createConfigServiceProvider;
+    /**
+     * Create providers for asynchronous module registration.
+     */
+    private static createAsyncProviders;
+    /**
+     * Create the ConfigService provider for asynchronous module registration.
+     */
+    private static createAsyncConfigServiceProvider;
+    /**
+     * Create configuration loaders based on module options.
+     */
+    private static createLoaders;
+}
+//# sourceMappingURL=config.module.d.ts.map

package/dist/types/config.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.module.d.ts","sourceRoot":"","sources":["../../src/config.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA4B,MAAM,gBAAgB,CAAC;AAGzE,OAAO,EAAE,0BAA0B,EAAE,+BAA+B,EAAE,MAAM,uCAAuC,CAAC;AACpH,OAAO,EAAE,mBAAmB,EAAuB,MAAM,uCAAuC,CAAC;AAOjG;;GAEG;AACH,eAAO,MAAM,uBAAuB,4BAA4B,CAAC;AAEjE;;;;GAIG;AACH,qBAEa,YAAY;IACvB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,mBAAmB,EACpC,OAAO,GAAE,0BAA0B,CAAC,CAAC,CAAM,GAC1C,aAAa;IAiBhB;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,mBAAmB,EACzC,OAAO,EAAE,+BAA+B,CAAC,CAAC,CAAC,GAC1C,aAAa;IAehB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,2BAA2B;IA+B1C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAYnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gCAAgC;IA8B/C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;CAuC7B"}

package/dist/types/index.d.ts

@@ -0,0 +1,13 @@
+export * from './config.module';
+export * from './interfaces';
+export * from './loaders/environment.loader';
+export * from './loaders/secrets-manager.loader';
+export * from './loaders/ssm-parameter-store.loader';
+export * from './services/config.service';
+export * from './utils/validation.util';
+export * from './integration';
+export { isAwsSource, isLocalSource, hasMetadata, isValidationResult, isCacheEntry } from './integration/interfaces/utility-types.interface';
+export { InjectEnhancedConfig, ConfigProperty, ConfigClass, ValidateConfig, TransformConfig, createTypeSafeConfigFactory } from './integration/interfaces/nestjs-config-compatibility.interface';
+export { NestConfigAwsIntegrationModule } from './integration/nestjs-config-integration.module';
+export type { IntegrationOptions, AsyncIntegrationOptions, PrecedenceRule, ErrorHandlingStrategy, FactoryOptions, AwsConfigurationFactory, ConfigurationFactoryProvider, ConfigurationSource, ConfigurationSourceType, IntegrationState, TypedConfiguration, TypedConfigurationFactory, TypedConfigurationAccessor, ConfigurationSchema, TypedConfigurationRegistry, TypedConfigurationOptions, ConfigurationType, StronglyTypedConfig, ConfigurationValue, ConfigurationPathResolver, NestJSConfigIntegrationService, EnhancedConfigModuleOptions, EnhancedAsyncConfigModuleOptions, EnhancedConfigModuleFactory, EnhancedAsyncConfigModuleFactory, EnhancedConfigModuleOptionsFactory, IntegrationStatus, AwsConfigurationLoader, ConfigurationMerger, AwsConfigurationValidator, EnhancedConfigService, ConfigValueWithSource, ConfigSourceInfo, ConfigHealthStatus, ConfigPropertyOptions, ConfigClassOptions, ConfigValidationOptions, TypeSafeConfigFactory, ConfigModuleBuilder, ConfigTestingUtils, ConfigMonitor, ConfigMetrics, ConfigEvent, ConfigAuditEntry, ConfigAuditLogger, ExtractConfigType, TypedConfigService, ConfigurationNamespaceRegistry, DeepReadonly, PartialDeep, RequiredDeep, ConfigPath, ConfigValue, AwsConfigSource, LocalConfigSource, AllConfigSource, ConfigSourceMetadata, ConfigWithSource, ExtractConfig, ConfigFactoryMap, ExtractConfigMap, NamespaceConfig, MultiNamespaceConfig, ValidationResult, AsyncValidationResult, ConfigTransformerFn, AsyncConfigTransformerFn, ConfigPredicate, AsyncConfigPredicate, ConfigBuilder, ConfigFluentAPI } from './integration/interfaces';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AAGxC,cAAc,eAAe,CAAC;AAG9B,OAAO,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,YAAY,EACb,MAAM,kDAAkD,CAAC;AAG1D,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EACf,2BAA2B,EAC5B,MAAM,gEAAgE,CAAC;AAGxE,OAAO,EAAE,8BAA8B,EAAE,MAAM,gDAAgD,CAAC;AAChG,YAAY,EAEV,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACd,qBAAqB,EACrB,cAAc,EAGd,uBAAuB,EACvB,4BAA4B,EAG5B,mBAAmB,EACnB,uBAAuB,EAGvB,gBAAgB,EAGhB,kBAAkB,EAClB,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,EAC1B,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EAGzB,8BAA8B,EAC9B,2BAA2B,EAC3B,gCAAgC,EAChC,2BAA2B,EAC3B,gCAAgC,EAChC,kCAAkC,EAClC,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EAGzB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EAGjB,iBAAiB,EACjB,kBAAkB,EAClB,8BAA8B,EAC9B,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,eAAe,EAChB,MAAM,0BAA0B,CAAC"}

package/dist/types/integration/index.d.ts

@@ -0,0 +1,6 @@
+export * from './interfaces';
+export * from './nestjs-config-integration.module';
+export * from './providers';
+export * from './services';
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/integration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integration/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC;AACnD,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}