@dyanet/nestjs-config-aws 1.0.1

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

@@ -0,0 +1,283 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAwsConfigFactory = createAwsConfigFactory;
+exports.createAwsNamespacedFactories = createAwsNamespacedFactories;
+exports.createEnhancedConfigOptions = createEnhancedConfigOptions;
+exports.createAwsIntegrationModule = createAwsIntegrationModule;
+exports.createAsyncAwsIntegrationModule = createAsyncAwsIntegrationModule;
+exports.createConfigModuleFactory = createConfigModuleFactory;
+exports.createConfigModuleFactoryWithDependencies = createConfigModuleFactoryWithDependencies;
+exports.checkAwsConfigAvailability = checkAwsConfigAvailability;
+const nestjs_config_integration_module_1 = require("../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
+ */
+async function createAwsConfigFactory(options = {}) {
+    // Import services dynamically to avoid circular dependencies
+    const { AsyncConfigHelperService } = await Promise.resolve().then(() => __importStar(require('../services/async-config-helper.service')));
+    const { FactoryRegistrationService } = await Promise.resolve().then(() => __importStar(require('../services/factory-registration.service')));
+    const { ConfigurationFactoryProviderImpl } = await Promise.resolve().then(() => __importStar(require('../providers/configuration-factory.provider')));
+    const { AwsConfigurationLoaderService } = await Promise.resolve().then(() => __importStar(require('../providers/aws-configuration-loader.service')));
+    const { PrecedenceHandlerService } = await Promise.resolve().then(() => __importStar(require('../services/precedence-handler.service')));
+    const { NamespaceHandlerService } = await Promise.resolve().then(() => __importStar(require('../services/namespace-handler.service')));
+    const { ValidationIntegrationService } = await Promise.resolve().then(() => __importStar(require('../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
+ */
+async function createAwsNamespacedFactories(namespaces, options = {}) {
+    // Import services dynamically
+    const { AsyncConfigHelperService } = await Promise.resolve().then(() => __importStar(require('../services/async-config-helper.service')));
+    const { FactoryRegistrationService } = await Promise.resolve().then(() => __importStar(require('../services/factory-registration.service')));
+    const { ConfigurationFactoryProviderImpl } = await Promise.resolve().then(() => __importStar(require('../providers/configuration-factory.provider')));
+    const { AwsConfigurationLoaderService } = await Promise.resolve().then(() => __importStar(require('../providers/aws-configuration-loader.service')));
+    const { PrecedenceHandlerService } = await Promise.resolve().then(() => __importStar(require('../services/precedence-handler.service')));
+    const { NamespaceHandlerService } = await Promise.resolve().then(() => __importStar(require('../services/namespace-handler.service')));
+    const { ValidationIntegrationService } = await Promise.resolve().then(() => __importStar(require('../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
+ */
+async function createEnhancedConfigOptions(baseOptions = {}, integrationOptions = {}) {
+    // Import services dynamically
+    const { AsyncConfigHelperService } = await Promise.resolve().then(() => __importStar(require('../services/async-config-helper.service')));
+    const { FactoryRegistrationService } = await Promise.resolve().then(() => __importStar(require('../services/factory-registration.service')));
+    const { ConfigurationFactoryProviderImpl } = await Promise.resolve().then(() => __importStar(require('../providers/configuration-factory.provider')));
+    const { AwsConfigurationLoaderService } = await Promise.resolve().then(() => __importStar(require('../providers/aws-configuration-loader.service')));
+    const { PrecedenceHandlerService } = await Promise.resolve().then(() => __importStar(require('../services/precedence-handler.service')));
+    const { NamespaceHandlerService } = await Promise.resolve().then(() => __importStar(require('../services/namespace-handler.service')));
+    const { ValidationIntegrationService } = await Promise.resolve().then(() => __importStar(require('../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
+ */
+function createAwsIntegrationModule(options = {}) {
+    return nestjs_config_integration_module_1.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
+ */
+function createAsyncAwsIntegrationModule(useFactory, inject = [], imports = []) {
+    return nestjs_config_integration_module_1.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
+ */
+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
+ */
+function createConfigModuleFactoryWithDependencies(integrationOptions = {}, dependencies = []) {
+    return async (...injectedDependencies) => {
+        try {
+            // Import services dynamically
+            const { AsyncConfigHelperService } = await Promise.resolve().then(() => __importStar(require('../services/async-config-helper.service')));
+            const { FactoryRegistrationService } = await Promise.resolve().then(() => __importStar(require('../services/factory-registration.service')));
+            const { ConfigurationFactoryProviderImpl } = await Promise.resolve().then(() => __importStar(require('../providers/configuration-factory.provider')));
+            const { AwsConfigurationLoaderService } = await Promise.resolve().then(() => __importStar(require('../providers/aws-configuration-loader.service')));
+            const { PrecedenceHandlerService } = await Promise.resolve().then(() => __importStar(require('../services/precedence-handler.service')));
+            const { NamespaceHandlerService } = await Promise.resolve().then(() => __importStar(require('../services/namespace-handler.service')));
+            const { ValidationIntegrationService } = await Promise.resolve().then(() => __importStar(require('../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
+ */
+async function checkAwsConfigAvailability(options = {}) {
+    try {
+        // Import services dynamically
+        const { AsyncConfigHelperService } = await Promise.resolve().then(() => __importStar(require('../services/async-config-helper.service')));
+        const { FactoryRegistrationService } = await Promise.resolve().then(() => __importStar(require('../services/factory-registration.service')));
+        const { ConfigurationFactoryProviderImpl } = await Promise.resolve().then(() => __importStar(require('../providers/configuration-factory.provider')));
+        const { AwsConfigurationLoaderService } = await Promise.resolve().then(() => __importStar(require('../providers/aws-configuration-loader.service')));
+        const { PrecedenceHandlerService } = await Promise.resolve().then(() => __importStar(require('../services/precedence-handler.service')));
+        const { NamespaceHandlerService } = await Promise.resolve().then(() => __importStar(require('../services/namespace-handler.service')));
+        const { ValidationIntegrationService } = await Promise.resolve().then(() => __importStar(require('../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/cjs/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/cjs/integration/utils/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Integration utilities exports
+__exportStar(require("./config-integration.util"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/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,4DAA0C"}

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config-loader.interface.js.map

package/dist/cjs/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/cjs/interfaces/config-service.interface.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigService = void 0;
+/**
+ * Abstract ConfigService interface for dependency injection.
+ * Provides type-safe access to configuration values with generic type support.
+ */
+class ConfigService {
+}
+exports.ConfigService = ConfigService;
+//# sourceMappingURL=config-service.interface.js.map

package/dist/cjs/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,MAAsB,aAAa;CAmBlC;AAnBD,sCAmBC"}

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

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

package/dist/cjs/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":";;;AAqEA,0DAGC;AAxED,6BAAwB;AAExB;;;GAGG;AACU,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,0BAA0B;IAC1B,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IAElE,sEAAsE;IACtE,OAAO,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAEhF,8BAA8B;IAC9B,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEjC,wCAAwC;IACxC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAElC,uBAAuB;IACvB,IAAI,EAAE,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE7C,uBAAuB;IACvB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE3B,gBAAgB;IAChB,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IAE3E,mBAAmB;IACnB,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAEzC,gBAAgB;IAChB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAOH;;GAEG;AACU,QAAA,kBAAkB,GAAG;IAChC,KAAK,EAAE,2BAAmB,CAAC,MAAM,CAAC;QAChC,mDAAmD;QACnD,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC;IAEF,WAAW,EAAE,2BAAmB,CAAC,MAAM,CAAC;QACtC,uCAAuC;QACvC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uCAAuC,CAAC;KACvE,CAAC;IAEF,IAAI,EAAE,2BAAmB,CAAC,MAAM,CAAC;QAC/B,gCAAgC;QAChC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;KAChE,CAAC;IAEF,UAAU,EAAE,2BAAmB,CAAC,MAAM,CAAC;QACrC,sCAAsC;QACtC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC;QACrE,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;KAC7D,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,SAAgB,uBAAuB,CAAC,MAAc;IACpD,MAAM,GAAG,GAAG,MAAyC,CAAC;IACtD,OAAO,0BAAkB,CAAC,GAAG,CAAC,IAAI,2BAAmB,CAAC;AACxD,CAAC;AAED;;GAEG;AACU,QAAA,YAAY,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigurationLoadError = exports.MissingConfigurationError = exports.AWSServiceError = exports.ValidationError = exports.ConfigurationError = void 0;
+/**
+ * Base error class for all configuration-related errors.
+ */
+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);
+        }
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+/**
+ * Error thrown when configuration validation fails.
+ */
+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);
+        }
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Error thrown when AWS service operations fail.
+ */
+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);
+        }
+    }
+}
+exports.AWSServiceError = AWSServiceError;
+/**
+ * Error thrown when required configuration is missing.
+ */
+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);
+        }
+    }
+}
+exports.MissingConfigurationError = MissingConfigurationError;
+/**
+ * Error thrown when configuration loading fails.
+ */
+class ConfigurationLoadError extends ConfigurationError {
+    constructor(message, loader, cause) {
+        super(message, cause);
+        this.loader = loader;
+        this.name = 'ConfigurationLoadError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ConfigurationLoadError);
+        }
+    }
+}
+exports.ConfigurationLoadError = ConfigurationLoadError;
+//# sourceMappingURL=errors.interface.js.map

package/dist/cjs/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,MAAa,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;AAVD,gDAUC;AAED;;GAEG;AACH,MAAa,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;AAbD,0CAaC;AAED;;GAEG;AACH,MAAa,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;AAdD,0CAcC;AAED;;GAEG;AACH,MAAa,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;AAZD,8DAYC;AAED;;GAEG;AACH,MAAa,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;AAbD,wDAaC"}

package/dist/cjs/interfaces/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Core interfaces
+__exportStar(require("./config-service.interface"), exports);
+__exportStar(require("./config-loader.interface"), exports);
+__exportStar(require("./module-options.interface"), exports);
+// Error classes
+__exportStar(require("./errors.interface"), exports);
+// Default schema and types
+__exportStar(require("./default-schema.interface"), exports);
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=module-options.interface.js.map

package/dist/cjs/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/cjs/loaders/environment.loader.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvironmentLoader = void 0;
+/**
+ * Configuration loader that loads values from environment variables (process.env).
+ * This loader is always available and serves as the base configuration source.
+ */
+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;
+    }
+}
+exports.EnvironmentLoader = EnvironmentLoader;
+//# sourceMappingURL=environment.loader.js.map

package/dist/cjs/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,MAAa,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;AAxDD,8CAwDC"}