@dyanet/nestjs-config-aws 1.0.1

package/dist/esm/integration/utils/config-integration.util.js

@@ -0,0 +1,240 @@
+import { NestConfigAwsIntegrationModule } from '../nestjs-config-integration.module';
+/**
+ * Utility functions for integrating nestjs-config-aws with @nestjs/config.
+ * These functions provide convenient ways to set up AWS configuration integration.
+ */
+/**
+ * Create a configuration factory that loads from AWS sources.
+ * This factory can be used directly in @nestjs/config's load array.
+ *
+ * @param options - Integration options for AWS configuration
+ * @returns Promise resolving to configuration factory
+ */
+export async function createAwsConfigFactory(options = {}) {
+    // Import services dynamically to avoid circular dependencies
+    const { AsyncConfigHelperService } = await import('../services/async-config-helper.service');
+    const { FactoryRegistrationService } = await import('../services/factory-registration.service');
+    const { ConfigurationFactoryProviderImpl } = await import('../providers/configuration-factory.provider');
+    const { AwsConfigurationLoaderService } = await import('../providers/aws-configuration-loader.service');
+    const { PrecedenceHandlerService } = await import('../services/precedence-handler.service');
+    const { NamespaceHandlerService } = await import('../services/namespace-handler.service');
+    const { ValidationIntegrationService } = await import('../services/validation-integration.service');
+    // Create service instances
+    const precedenceHandler = new PrecedenceHandlerService();
+    const configFactoryProvider = new ConfigurationFactoryProviderImpl(precedenceHandler);
+    const awsLoader = new AwsConfigurationLoaderService(options);
+    const namespaceHandler = new NamespaceHandlerService();
+    const validationService = new ValidationIntegrationService();
+    const factoryRegistration = new FactoryRegistrationService(configFactoryProvider, awsLoader, namespaceHandler, validationService, options);
+    const asyncHelper = new AsyncConfigHelperService(factoryRegistration, options);
+    // Create and return the async factory
+    return await asyncHelper.createAsyncConfigFactory();
+}
+/**
+ * Create configuration factories for specific namespaces.
+ * This function creates separate factories for each namespace.
+ *
+ * @param namespaces - Array of namespace names
+ * @param options - Integration options for AWS configuration
+ * @returns Promise resolving to array of namespaced configuration factories
+ */
+export async function createAwsNamespacedFactories(namespaces, options = {}) {
+    // Import services dynamically
+    const { AsyncConfigHelperService } = await import('../services/async-config-helper.service');
+    const { FactoryRegistrationService } = await import('../services/factory-registration.service');
+    const { ConfigurationFactoryProviderImpl } = await import('../providers/configuration-factory.provider');
+    const { AwsConfigurationLoaderService } = await import('../providers/aws-configuration-loader.service');
+    const { PrecedenceHandlerService } = await import('../services/precedence-handler.service');
+    const { NamespaceHandlerService } = await import('../services/namespace-handler.service');
+    const { ValidationIntegrationService } = await import('../services/validation-integration.service');
+    // Create service instances
+    const precedenceHandler = new PrecedenceHandlerService();
+    const configFactoryProvider = new ConfigurationFactoryProviderImpl(precedenceHandler);
+    const awsLoader = new AwsConfigurationLoaderService(options);
+    const namespaceHandler = new NamespaceHandlerService();
+    const validationService = new ValidationIntegrationService();
+    const factoryRegistration = new FactoryRegistrationService(configFactoryProvider, awsLoader, namespaceHandler, validationService, options);
+    const asyncHelper = new AsyncConfigHelperService(factoryRegistration, options);
+    // Create and return the namespaced factories
+    return await asyncHelper.createAsyncNamespacedFactories(namespaces);
+}
+/**
+ * Create enhanced ConfigModule options with AWS integration.
+ * This function enhances existing ConfigModule options with AWS-sourced configuration.
+ *
+ * @param baseOptions - Base ConfigModule options to enhance
+ * @param integrationOptions - Integration options for AWS configuration
+ * @returns Promise resolving to enhanced ConfigModule options
+ */
+export async function createEnhancedConfigOptions(baseOptions = {}, integrationOptions = {}) {
+    // Import services dynamically
+    const { AsyncConfigHelperService } = await import('../services/async-config-helper.service');
+    const { FactoryRegistrationService } = await import('../services/factory-registration.service');
+    const { ConfigurationFactoryProviderImpl } = await import('../providers/configuration-factory.provider');
+    const { AwsConfigurationLoaderService } = await import('../providers/aws-configuration-loader.service');
+    const { PrecedenceHandlerService } = await import('../services/precedence-handler.service');
+    const { NamespaceHandlerService } = await import('../services/namespace-handler.service');
+    const { ValidationIntegrationService } = await import('../services/validation-integration.service');
+    // Create service instances
+    const precedenceHandler = new PrecedenceHandlerService();
+    const configFactoryProvider = new ConfigurationFactoryProviderImpl(precedenceHandler);
+    const awsLoader = new AwsConfigurationLoaderService(integrationOptions);
+    const namespaceHandler = new NamespaceHandlerService();
+    const validationService = new ValidationIntegrationService();
+    const factoryRegistration = new FactoryRegistrationService(configFactoryProvider, awsLoader, namespaceHandler, validationService, integrationOptions);
+    const asyncHelper = new AsyncConfigHelperService(factoryRegistration, integrationOptions);
+    // Create and return enhanced options
+    return await asyncHelper.createAsyncConfigOptions(baseOptions);
+}
+/**
+ * Create a complete integration module for use with @nestjs/config.
+ * This function returns a module that can be imported alongside ConfigModule.
+ *
+ * @param options - Integration options for AWS configuration
+ * @returns Dynamic module for AWS integration
+ */
+export function createAwsIntegrationModule(options = {}) {
+    return NestConfigAwsIntegrationModule.forRoot(options);
+}
+/**
+ * Create an async integration module for use with @nestjs/config.
+ * This function returns a module that can be imported alongside ConfigModule for async scenarios.
+ *
+ * @param useFactory - Factory function to create integration options
+ * @param inject - Dependencies to inject into the factory function
+ * @param imports - Modules to import for the factory function
+ * @returns Dynamic module for async AWS integration
+ */
+export function createAsyncAwsIntegrationModule(useFactory, inject = [], imports = []) {
+    return NestConfigAwsIntegrationModule.forRootAsync({
+        useFactory,
+        inject,
+        imports,
+    });
+}
+/**
+ * Create a factory function that can be used with ConfigModule.forRoot().
+ * This factory function loads AWS configuration and merges it with local configuration.
+ *
+ * @param integrationOptions - Integration options for AWS configuration
+ * @returns Factory function for use with ConfigModule
+ */
+export function createConfigModuleFactory(integrationOptions = {}) {
+    return async () => {
+        try {
+            // Create AWS configuration factory
+            const awsFactory = await createAwsConfigFactory(integrationOptions);
+            // Return ConfigModule options with AWS factory
+            return {
+                load: [awsFactory],
+                isGlobal: integrationOptions.registerGlobally ?? true,
+                cache: integrationOptions.factoryOptions?.cache ?? true,
+                expandVariables: integrationOptions.factoryOptions?.expandVariables ?? true,
+            };
+        }
+        catch (error) {
+            // Handle error based on integration options
+            if (integrationOptions.failOnAwsError) {
+                throw error;
+            }
+            // Return basic options as fallback
+            if (integrationOptions.fallbackToLocal) {
+                return {
+                    load: [],
+                    isGlobal: integrationOptions.registerGlobally ?? true,
+                    cache: integrationOptions.factoryOptions?.cache ?? true,
+                    expandVariables: integrationOptions.factoryOptions?.expandVariables ?? true,
+                };
+            }
+            throw error;
+        }
+    };
+}
+/**
+ * Create a factory function with dependency injection support.
+ * This factory function can receive injected dependencies and use them to configure AWS integration.
+ *
+ * @param integrationOptions - Integration options for AWS configuration
+ * @param dependencies - Array of dependency tokens to inject
+ * @returns Factory function with dependency injection support
+ */
+export function createConfigModuleFactoryWithDependencies(integrationOptions = {}, dependencies = []) {
+    return async (...injectedDependencies) => {
+        try {
+            // Import services dynamically
+            const { AsyncConfigHelperService } = await import('../services/async-config-helper.service');
+            const { FactoryRegistrationService } = await import('../services/factory-registration.service');
+            const { ConfigurationFactoryProviderImpl } = await import('../providers/configuration-factory.provider');
+            const { AwsConfigurationLoaderService } = await import('../providers/aws-configuration-loader.service');
+            const { PrecedenceHandlerService } = await import('../services/precedence-handler.service');
+            const { NamespaceHandlerService } = await import('../services/namespace-handler.service');
+            const { ValidationIntegrationService } = await import('../services/validation-integration.service');
+            // Create service instances
+            const precedenceHandler = new PrecedenceHandlerService();
+            const configFactoryProvider = new ConfigurationFactoryProviderImpl(precedenceHandler);
+            const awsLoader = new AwsConfigurationLoaderService(integrationOptions);
+            const namespaceHandler = new NamespaceHandlerService();
+            const validationService = new ValidationIntegrationService();
+            const factoryRegistration = new FactoryRegistrationService(configFactoryProvider, awsLoader, namespaceHandler, validationService, integrationOptions);
+            const asyncHelper = new AsyncConfigHelperService(factoryRegistration, integrationOptions);
+            // Create factory with dependencies
+            const factoryWithDeps = asyncHelper.createAsyncFactoryWithDependencies(dependencies);
+            // Execute factory with injected dependencies
+            return await factoryWithDeps(...injectedDependencies);
+        }
+        catch (error) {
+            // Handle error based on integration options
+            if (integrationOptions.failOnAwsError) {
+                throw error;
+            }
+            // Return basic options as fallback
+            if (integrationOptions.fallbackToLocal) {
+                return {
+                    load: [],
+                    isGlobal: integrationOptions.registerGlobally ?? true,
+                    cache: integrationOptions.factoryOptions?.cache ?? true,
+                    expandVariables: integrationOptions.factoryOptions?.expandVariables ?? true,
+                };
+            }
+            throw error;
+        }
+    };
+}
+/**
+ * Check if AWS configuration is available for integration.
+ * This function can be used to determine if AWS integration should be enabled.
+ *
+ * @param options - Integration options for AWS configuration
+ * @returns Promise resolving to availability status
+ */
+export async function checkAwsConfigAvailability(options = {}) {
+    try {
+        // Import services dynamically
+        const { AsyncConfigHelperService } = await import('../services/async-config-helper.service');
+        const { FactoryRegistrationService } = await import('../services/factory-registration.service');
+        const { ConfigurationFactoryProviderImpl } = await import('../providers/configuration-factory.provider');
+        const { AwsConfigurationLoaderService } = await import('../providers/aws-configuration-loader.service');
+        const { PrecedenceHandlerService } = await import('../services/precedence-handler.service');
+        const { NamespaceHandlerService } = await import('../services/namespace-handler.service');
+        const { ValidationIntegrationService } = await import('../services/validation-integration.service');
+        // Create service instances
+        const precedenceHandler = new PrecedenceHandlerService();
+        const configFactoryProvider = new ConfigurationFactoryProviderImpl(precedenceHandler);
+        const awsLoader = new AwsConfigurationLoaderService(options);
+        const namespaceHandler = new NamespaceHandlerService();
+        const validationService = new ValidationIntegrationService();
+        const factoryRegistration = new FactoryRegistrationService(configFactoryProvider, awsLoader, namespaceHandler, validationService, options);
+        const asyncHelper = new AsyncConfigHelperService(factoryRegistration, options);
+        // Check availability
+        return await asyncHelper.checkAsyncAvailability();
+    }
+    catch (error) {
+        const availabilityError = error instanceof Error ? error : new Error(String(error));
+        return {
+            isAvailable: false,
+            factoriesCount: 0,
+            errors: [availabilityError.message],
+        };
+    }
+}
+//# sourceMappingURL=config-integration.util.js.map

package/dist/esm/integration/utils/config-integration.util.js.map

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

package/dist/esm/integration/utils/index.js

@@ -0,0 +1,3 @@
+// Integration utilities exports
+export * from './config-integration.util';
+//# sourceMappingURL=index.js.map

package/dist/esm/integration/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/integration/utils/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,cAAc,2BAA2B,CAAC"}

package/dist/esm/interfaces/config-loader.interface.js

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

package/dist/esm/interfaces/config-loader.interface.js.map

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

package/dist/esm/interfaces/config-service.interface.js

@@ -0,0 +1,7 @@
+/**
+ * Abstract ConfigService interface for dependency injection.
+ * Provides type-safe access to configuration values with generic type support.
+ */
+export class ConfigService {
+}
+//# sourceMappingURL=config-service.interface.js.map

package/dist/esm/interfaces/config-service.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-service.interface.js","sourceRoot":"","sources":["../../../src/interfaces/config-service.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAgB,aAAa;CAmBlC"}

package/dist/esm/interfaces/default-schema.interface.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+/**
+ * Default configuration schema using Zod.
+ * Provides a flexible base schema that can be extended by applications.
+ */
+export const defaultConfigSchema = z.object({
+    /** Node.js environment */
+    NODE_ENV: z.enum(['production', 'development', 'test']).optional(),
+    /** Application environment (mirrors NODE_ENV with 'local' default) */
+    APP_ENV: z.enum(['production', 'test', 'development', 'local']).default('local'),
+    /** AWS region for services */
+    AWS_REGION: z.string().optional(),
+    /** AWS profile for local development */
+    AWS_PROFILE: z.string().optional(),
+    /** Application port */
+    PORT: z.coerce.number().positive().optional(),
+    /** Application host */
+    HOST: z.string().optional(),
+    /** Log level */
+    LOG_LEVEL: z.enum(['error', 'warn', 'info', 'debug', 'verbose']).optional(),
+    /** Database URL */
+    DATABASE_URL: z.string().url().optional(),
+    /** Redis URL */
+    REDIS_URL: z.string().url().optional(),
+});
+/**
+ * Environment-specific validation schemas.
+ */
+export const environmentSchemas = {
+    local: defaultConfigSchema.extend({
+        // Local environment may have fewer required fields
+        AWS_REGION: z.string().optional(),
+    }),
+    development: defaultConfigSchema.extend({
+        // Development environment requirements
+        AWS_REGION: z.string().min(1, 'AWS_REGION is required in development'),
+    }),
+    test: defaultConfigSchema.extend({
+        // Test environment requirements
+        AWS_REGION: z.string().min(1, 'AWS_REGION is required in test'),
+    }),
+    production: defaultConfigSchema.extend({
+        // Production environment requirements
+        AWS_REGION: z.string().min(1, 'AWS_REGION is required in production'),
+        LOG_LEVEL: z.enum(['error', 'warn', 'info']).default('info'),
+    }),
+};
+/**
+ * Helper function to get the appropriate schema for the current environment.
+ */
+export function getSchemaForEnvironment(appEnv) {
+    const env = appEnv;
+    return environmentSchemas[env] || defaultConfigSchema;
+}
+/**
+ * Validation helper for APP_ENV values.
+ */
+export const appEnvSchema = z.enum(['production', 'test', 'development', 'local']);
+//# sourceMappingURL=default-schema.interface.js.map

package/dist/esm/interfaces/default-schema.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-schema.interface.js","sourceRoot":"","sources":["../../../src/interfaces/default-schema.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,0BAA0B;IAC1B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IAElE,sEAAsE;IACtE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAEhF,8BAA8B;IAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEjC,wCAAwC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAElC,uBAAuB;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE7C,uBAAuB;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE3B,gBAAgB;IAChB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IAE3E,mBAAmB;IACnB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAEzC,gBAAgB;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAOH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,mBAAmB,CAAC,MAAM,CAAC;QAChC,mDAAmD;QACnD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC;IAEF,WAAW,EAAE,mBAAmB,CAAC,MAAM,CAAC;QACtC,uCAAuC;QACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uCAAuC,CAAC;KACvE,CAAC;IAEF,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC;QAC/B,gCAAgC;QAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;KAChE,CAAC;IAEF,UAAU,EAAE,mBAAmB,CAAC,MAAM,CAAC;QACrC,sCAAsC;QACtC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC;QACrE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;KAC7D,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,MAAM,GAAG,GAAG,MAAyC,CAAC;IACtD,OAAO,kBAAkB,CAAC,GAAG,CAAC,IAAI,mBAAmB,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC"}

package/dist/esm/interfaces/errors.interface.js

@@ -0,0 +1,69 @@
+/**
+ * Base error class for all configuration-related errors.
+ */
+export class ConfigurationError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'ConfigurationError';
+        // Maintain proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ConfigurationError);
+        }
+    }
+}
+/**
+ * Error thrown when configuration validation fails.
+ */
+export class ValidationError extends ConfigurationError {
+    constructor(message, validationErrors, invalidKeys) {
+        super(message);
+        this.validationErrors = validationErrors;
+        this.invalidKeys = invalidKeys;
+        this.name = 'ValidationError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ValidationError);
+        }
+    }
+}
+/**
+ * Error thrown when AWS service operations fail.
+ */
+export class AWSServiceError extends ConfigurationError {
+    constructor(message, service, operation, cause) {
+        super(message, cause);
+        this.service = service;
+        this.operation = operation;
+        this.name = 'AWSServiceError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, AWSServiceError);
+        }
+    }
+}
+/**
+ * Error thrown when required configuration is missing.
+ */
+export class MissingConfigurationError extends ConfigurationError {
+    constructor(missingKeys, message) {
+        super(message || `Missing required configuration: ${missingKeys.join(', ')}`);
+        this.missingKeys = missingKeys;
+        this.name = 'MissingConfigurationError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, MissingConfigurationError);
+        }
+    }
+}
+/**
+ * Error thrown when configuration loading fails.
+ */
+export class ConfigurationLoadError extends ConfigurationError {
+    constructor(message, loader, cause) {
+        super(message, cause);
+        this.loader = loader;
+        this.name = 'ConfigurationLoadError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ConfigurationLoadError);
+        }
+    }
+}
+//# sourceMappingURL=errors.interface.js.map

package/dist/esm/interfaces/errors.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.interface.js","sourceRoot":"","sources":["../../../src/interfaces/errors.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe,EAAkB,KAAa;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAQ;QAExD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QAEjC,oFAAoF;QACpF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,kBAAkB;IACrD,YACE,OAAe,EACC,gBAAqB,EACrB,WAAsB;QAEtC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,qBAAgB,GAAhB,gBAAgB,CAAK;QACrB,gBAAW,GAAX,WAAW,CAAW;QAGtC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAE9B,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,kBAAkB;IACrD,YACE,OAAe,EACC,OAAiC,EACjC,SAAiB,EACjC,KAAa;QAEb,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAJN,YAAO,GAAP,OAAO,CAA0B;QACjC,cAAS,GAAT,SAAS,CAAQ;QAIjC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAE9B,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,kBAAkB;IAC/D,YACkB,WAAqB,EACrC,OAAgB;QAEhB,KAAK,CAAC,OAAO,IAAI,mCAAmC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAH9D,gBAAW,GAAX,WAAW,CAAU;QAIrC,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QAExC,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,kBAAkB;IAC5D,YACE,OAAe,EACC,MAAc,EAC9B,KAAa;QAEb,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAHN,WAAM,GAAN,MAAM,CAAQ;QAI9B,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QAErC,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;CACF"}

package/dist/esm/interfaces/index.js

@@ -0,0 +1,9 @@
+// Core interfaces
+export * from './config-service.interface';
+export * from './config-loader.interface';
+export * from './module-options.interface';
+// Error classes
+export * from './errors.interface';
+// Default schema and types
+export * from './default-schema.interface';
+//# sourceMappingURL=index.js.map

package/dist/esm/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAClB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAE3C,gBAAgB;AAChB,cAAc,oBAAoB,CAAC;AAEnC,2BAA2B;AAC3B,cAAc,4BAA4B,CAAC"}

package/dist/esm/interfaces/module-options.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=module-options.interface.js.map

package/dist/esm/interfaces/module-options.interface.js.map

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

package/dist/esm/loaders/environment.loader.js

@@ -0,0 +1,55 @@
+/**
+ * Configuration loader that loads values from environment variables (process.env).
+ * This loader is always available and serves as the base configuration source.
+ */
+export class EnvironmentLoader {
+    constructor(envPrefix) {
+        this.envPrefix = envPrefix;
+    }
+    /**
+     * Load configuration from environment variables.
+     * @returns Promise resolving to environment variables as key-value pairs
+     */
+    async load() {
+        const config = {};
+        // Get all environment variables
+        const envVars = process.env;
+        // If prefix is specified, only load variables with that prefix
+        if (this.envPrefix) {
+            for (const [key, value] of Object.entries(envVars)) {
+                if (key.startsWith(this.envPrefix)) {
+                    // Remove prefix from key
+                    const configKey = key.substring(this.envPrefix.length);
+                    if (configKey && value !== undefined) {
+                        config[configKey] = value;
+                    }
+                }
+            }
+        }
+        else {
+            // Load all environment variables
+            for (const [key, value] of Object.entries(envVars)) {
+                if (value !== undefined) {
+                    config[key] = value;
+                }
+            }
+        }
+        return config;
+    }
+    /**
+     * Get the name of this loader for logging and debugging.
+     * @returns The loader name
+     */
+    getName() {
+        return this.envPrefix ? `EnvironmentLoader(${this.envPrefix})` : 'EnvironmentLoader';
+    }
+    /**
+     * Check if this loader is available.
+     * Environment variables are always available.
+     * @returns Promise resolving to true
+     */
+    async isAvailable() {
+        return true;
+    }
+}
+//# sourceMappingURL=environment.loader.js.map

package/dist/esm/loaders/environment.loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.loader.js","sourceRoot":"","sources":["../../../src/loaders/environment.loader.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IAG5B,YAAY,SAAkB;QAC5B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAwB,EAAE,CAAC;QAEvC,gCAAgC;QAChC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;QAE5B,+DAA+D;QAC/D,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;oBACnC,yBAAyB;oBACzB,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;oBACvD,IAAI,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;wBACrC,MAAM,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;oBAC5B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,iCAAiC;YACjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,mBAAmB,CAAC;IACvF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/esm/loaders/secrets-manager.loader.js

@@ -0,0 +1,118 @@
+import { GetSecretValueCommand, SecretsManagerClient } from '@aws-sdk/client-secrets-manager';
+import { fromNodeProviderChain } from '@aws-sdk/credential-providers';
+import { ConfigurationError } from '../interfaces/errors.interface';
+/**
+ * Configuration loader that loads values from AWS Secrets Manager.
+ * Supports environment-aware secret path construction and JSON parsing with string fallback.
+ */
+export class SecretsManagerLoader {
+    constructor(config = {}) {
+        this.appEnv = process.env['APP_ENV'] || process.env['NODE_ENV'] || 'local';
+        // Set default configuration
+        this.config = {
+            secretName: config.secretName || '/nestjs-config-aws',
+            region: config.region || process.env['AWS_REGION'] || 'us-east-1',
+            environmentMapping: config.environmentMapping || {
+                development: 'dev',
+                test: 'test',
+                production: 'production'
+            }
+        };
+        // Initialize AWS Secrets Manager client
+        this.client = new SecretsManagerClient({
+            credentials: fromNodeProviderChain(),
+            region: this.config.region,
+        });
+    }
+    /**
+     * Load configuration from AWS Secrets Manager.
+     * @returns Promise resolving to configuration key-value pairs from the secret
+     */
+    async load() {
+        // Skip loading in local environment
+        if (this.appEnv === 'local') {
+            return {};
+        }
+        const secretName = this.buildSecretName();
+        try {
+            const command = new GetSecretValueCommand({ SecretId: secretName });
+            const response = await this.client.send(command);
+            if (!response.SecretString) {
+                return {};
+            }
+            // Try to parse as JSON, fallback to string value
+            try {
+                const parsed = JSON.parse(response.SecretString);
+                // Ensure we return an object for configuration merging
+                if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                    return parsed;
+                }
+                else {
+                    // If it's not an object, wrap it in a configuration object
+                    return { SECRET_VALUE: parsed };
+                }
+            }
+            catch {
+                // If JSON parsing fails, treat as a single string value
+                return { SECRET_VALUE: response.SecretString };
+            }
+        }
+        catch (error) {
+            // Handle specific AWS errors
+            if (error instanceof Error) {
+                if (error.name === 'ResourceNotFoundException') {
+                    // Secret doesn't exist - this is not necessarily an error in all environments
+                    return {};
+                }
+                if (error.name === 'AccessDeniedException') {
+                    throw new ConfigurationError(`Access denied when retrieving secret '${secretName}'. Check AWS credentials and permissions.`, error);
+                }
+                if (error.name === 'InvalidRequestException') {
+                    throw new ConfigurationError(`Invalid request when retrieving secret '${secretName}'. Check secret name format.`, error);
+                }
+            }
+            // For other errors, wrap in ConfigurationError
+            throw new ConfigurationError(`Failed to retrieve secret '${secretName}' from AWS Secrets Manager: ${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 secret path
+     */
+    getName() {
+        const secretName = this.buildSecretName();
+        return `SecretsManagerLoader(${secretName})`;
+    }
+    /**
+     * Check if this loader is available in the current environment.
+     * @returns Promise resolving to true if not in local environment and AWS credentials are available
+     */
+    async isAvailable() {
+        // Skip in local environment
+        if (this.appEnv === 'local') {
+            return false;
+        }
+        try {
+            // Test AWS credentials by attempting to get caller identity
+            // This is a lightweight way to verify AWS access without making actual Secrets Manager calls
+            await this.client.config.credentials();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Build the environment-aware secret name/path.
+     * @returns The full secret name with environment prefix
+     */
+    buildSecretName() {
+        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.secretName}`;
+    }
+}
+//# sourceMappingURL=secrets-manager.loader.js.map

package/dist/esm/loaders/secrets-manager.loader.js.map

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