@dyanet/config-aws 1.0.0

package/dist/esm/config-manager.js

@@ -0,0 +1,356 @@
+import { ConfigurationError, ConfigurationLoadError, ValidationError } from './errors';
+/**
+ * Default console logger implementation
+ */
+const defaultLogger = {
+    log: (message) => console.log(message),
+    error: (message) => console.error(message),
+    warn: (message) => console.warn(message),
+    debug: (message) => console.debug(message),
+};
+/**
+ * Default sensitive keys that should always be masked
+ */
+const DEFAULT_SENSITIVE_KEYS = ['password', 'secret', 'key', 'token', 'credential', 'api_key', 'apikey'];
+/**
+ * Default verbose options
+ */
+const DEFAULT_VERBOSE_OPTIONS = {
+    logKeys: true,
+    logValues: false,
+    logOverrides: true,
+    logTiming: true,
+    maskValues: true,
+    sensitiveKeys: DEFAULT_SENSITIVE_KEYS,
+};
+/**
+ * Predefined precedence orders for common strategies
+ * Higher index = higher priority (later loaders override earlier ones)
+ */
+const PRECEDENCE_ORDERS = {
+    // AWS wins: env -> envFile -> s3 -> secretsManager -> ssm
+    'aws-first': [
+        'EnvironmentLoader',
+        'EnvFileLoader',
+        'S3Loader',
+        'SecretsManagerLoader',
+        'SSMParameterStoreLoader',
+    ],
+    // Local wins: ssm -> secretsManager -> s3 -> envFile -> env
+    'local-first': [
+        'SSMParameterStoreLoader',
+        'SecretsManagerLoader',
+        'S3Loader',
+        'EnvFileLoader',
+        'EnvironmentLoader',
+    ],
+};
+/**
+ * ConfigManager orchestrates loading configuration from multiple sources
+ * with configurable precedence and validation.
+ *
+ * @example
+ * ```typescript
+ * import { ConfigManager, EnvironmentLoader, SecretsManagerLoader } from '@dyanet/config-aws';
+ * import { z } from 'zod';
+ *
+ * const schema = z.object({
+ *   DATABASE_URL: z.string(),
+ *   API_KEY: z.string(),
+ *   PORT: z.coerce.number().default(3000),
+ * });
+ *
+ * const manager = new ConfigManager({
+ *   loaders: [
+ *     new EnvironmentLoader({ prefix: 'APP_' }),
+ *     new SecretsManagerLoader({ secretName: '/my-app/config' }),
+ *   ],
+ *   schema,
+ *   precedence: 'aws-first',
+ *   verbose: true,
+ * });
+ *
+ * await manager.load();
+ * const dbUrl = manager.get('DATABASE_URL');
+ * ```
+ */
+export class ConfigManager {
+    constructor(options = {}) {
+        this.config = null;
+        this.loadResult = null;
+        this.loaded = false;
+        this._options = {
+            loaders: options.loaders ?? [],
+            schema: options.schema,
+            precedence: options.precedence ?? 'aws-first',
+            validateOnLoad: options.validateOnLoad ?? true,
+            enableLogging: options.enableLogging ?? false,
+            logger: options.logger,
+            verbose: options.verbose,
+        };
+        this._logger = options.logger ?? defaultLogger;
+        this._verboseOptions = this.resolveVerboseOptions(options.verbose);
+    }
+    /**
+     * Resolve verbose options from boolean or object
+     */
+    resolveVerboseOptions(verbose) {
+        if (verbose === undefined || verbose === false) {
+            return null;
+        }
+        if (verbose === true) {
+            return { ...DEFAULT_VERBOSE_OPTIONS };
+        }
+        return {
+            logKeys: verbose.logKeys ?? DEFAULT_VERBOSE_OPTIONS.logKeys,
+            logValues: verbose.logValues ?? DEFAULT_VERBOSE_OPTIONS.logValues,
+            logOverrides: verbose.logOverrides ?? DEFAULT_VERBOSE_OPTIONS.logOverrides,
+            logTiming: verbose.logTiming ?? DEFAULT_VERBOSE_OPTIONS.logTiming,
+            maskValues: verbose.maskValues ?? DEFAULT_VERBOSE_OPTIONS.maskValues,
+            sensitiveKeys: verbose.sensitiveKeys ?? DEFAULT_VERBOSE_OPTIONS.sensitiveKeys,
+        };
+    }
+    /**
+     * Log a message if logging is enabled
+     */
+    log(message) {
+        if (this._options.enableLogging || this._verboseOptions) {
+            this._logger.log(`[config-aws] ${message}`);
+        }
+    }
+    /**
+     * Mask a value for logging
+     */
+    maskValue(key, value) {
+        if (!this._verboseOptions?.logValues) {
+            return '';
+        }
+        const strValue = String(value);
+        const lowerKey = key.toLowerCase();
+        // Check if key contains any sensitive patterns
+        const isSensitive = this._verboseOptions.sensitiveKeys.some((pattern) => lowerKey.includes(pattern.toLowerCase()));
+        if (this._verboseOptions.maskValues || isSensitive) {
+            if (strValue.length <= 4) {
+                return '****';
+            }
+            return `${strValue.slice(0, 2)}**...${strValue.slice(-2)}`;
+        }
+        return strValue;
+    }
+    /**
+     * Get the loading order for loaders based on precedence strategy.
+     * Returns loaders sorted by priority (lower priority first, so higher priority loads last and wins).
+     */
+    getLoadOrder() {
+        const { loaders, precedence } = this._options;
+        if (!loaders || loaders.length === 0) {
+            return [];
+        }
+        // If precedence is a custom array, use it
+        if (Array.isArray(precedence)) {
+            return this.sortByCustomPrecedence(loaders, precedence);
+        }
+        // Use predefined precedence order
+        const order = PRECEDENCE_ORDERS[precedence];
+        return this.sortByPredefinedOrder(loaders, order);
+    }
+    /**
+     * Sort loaders by custom precedence configuration
+     */
+    sortByCustomPrecedence(loaders, precedence) {
+        const priorityMap = new Map();
+        for (const p of precedence) {
+            priorityMap.set(p.loader, p.priority);
+        }
+        // Sort by priority (lower first, so higher priority loads last and wins)
+        return [...loaders].sort((a, b) => {
+            const priorityA = priorityMap.get(a.getName()) ?? 0;
+            const priorityB = priorityMap.get(b.getName()) ?? 0;
+            return priorityA - priorityB;
+        });
+    }
+    /**
+     * Sort loaders by predefined order
+     */
+    sortByPredefinedOrder(loaders, order) {
+        const orderMap = new Map();
+        order.forEach((name, index) => orderMap.set(name, index));
+        // Sort by order index (lower first, so higher index loads last and wins)
+        return [...loaders].sort((a, b) => {
+            const indexA = orderMap.get(a.getName()) ?? -1;
+            const indexB = orderMap.get(b.getName()) ?? -1;
+            return indexA - indexB;
+        });
+    }
+    /**
+     * Load configuration from all configured loaders.
+     * Loaders are executed in precedence order, with later loaders overriding earlier ones.
+     */
+    async load() {
+        const startTime = Date.now();
+        const sources = [];
+        let mergedConfig = {};
+        const keyOrigins = new Map(); // Track which loader set each key
+        this.log('Loading configuration...');
+        const orderedLoaders = this.getLoadOrder();
+        for (const loader of orderedLoaders) {
+            const loaderName = loader.getName();
+            const loaderStartTime = Date.now();
+            try {
+                // Check if loader is available
+                const isAvailable = await loader.isAvailable();
+                if (!isAvailable) {
+                    if (this._verboseOptions?.logTiming) {
+                        this.log(`${loaderName}: skipped (not available)`);
+                    }
+                    continue;
+                }
+                // Load configuration from this loader
+                const loaderConfig = await loader.load();
+                const keysLoaded = Object.keys(loaderConfig);
+                const duration = Date.now() - loaderStartTime;
+                // Track source info
+                sources.push({
+                    loader: loaderName,
+                    keysLoaded,
+                    duration,
+                });
+                // Log timing and keys
+                if (this._verboseOptions?.logTiming) {
+                    this.log(`${loaderName}: loaded ${keysLoaded.length} keys in ${duration}ms`);
+                }
+                // Log individual keys and track overrides
+                for (const key of keysLoaded) {
+                    const previousLoader = keyOrigins.get(key);
+                    const isOverride = previousLoader !== undefined;
+                    if (this._verboseOptions?.logKeys) {
+                        let logLine = `  - ${key}`;
+                        if (this._verboseOptions.logValues) {
+                            logLine += ` = "${this.maskValue(key, loaderConfig[key])}"`;
+                        }
+                        if (isOverride && this._verboseOptions.logOverrides) {
+                            logLine += ` (overrides ${previousLoader})`;
+                        }
+                        this.log(logLine);
+                    }
+                    keyOrigins.set(key, loaderName);
+                }
+                // Merge configuration (later loaders override earlier ones)
+                mergedConfig = { ...mergedConfig, ...loaderConfig };
+            }
+            catch (error) {
+                throw new ConfigurationLoadError(`Failed to load configuration from ${loaderName}: ${error instanceof Error ? error.message : String(error)}`, loaderName, error instanceof Error ? error : undefined);
+            }
+        }
+        // Count overrides
+        const totalKeys = Object.keys(mergedConfig).length;
+        const totalDuration = Date.now() - startTime;
+        const overrideCount = sources.reduce((acc, s) => acc + s.keysLoaded.length, 0) - totalKeys;
+        if (this._verboseOptions?.logTiming) {
+            this.log(`Configuration loaded: ${totalKeys} total keys, ${overrideCount} overrides, ${totalDuration}ms total`);
+        }
+        // Validate if schema is provided and validation is enabled
+        if (this._options.schema && this._options.validateOnLoad) {
+            const result = this._options.schema.safeParse(mergedConfig);
+            if (!result.success) {
+                const zodError = result.error;
+                throw new ValidationError(`Configuration validation failed: ${zodError.errors.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ')}`, zodError.errors, undefined);
+            }
+            this.config = result.data;
+        }
+        else {
+            this.config = mergedConfig;
+        }
+        this.loadResult = {
+            config: this.config,
+            sources,
+            loadedAt: new Date(),
+        };
+        this.loaded = true;
+    }
+    /**
+     * Get a specific configuration value by key.
+     * @param key The configuration key
+     * @returns The configuration value
+     * @throws ConfigurationError if configuration is not loaded
+     */
+    get(key) {
+        if (!this.loaded || this.config === null) {
+            throw new ConfigurationError('Configuration not loaded. Call load() first.');
+        }
+        // Non-null assertion is safe here because we've checked this.config !== null above
+        return this.config[key];
+    }
+    /**
+     * Get all configuration values.
+     * @returns The complete configuration object
+     * @throws ConfigurationError if configuration is not loaded
+     */
+    getAll() {
+        if (!this.loaded || this.config === null) {
+            throw new ConfigurationError('Configuration not loaded. Call load() first.');
+        }
+        return this.config;
+    }
+    /**
+     * Check if configuration has been loaded.
+     * @returns true if configuration is loaded
+     */
+    isLoaded() {
+        return this.loaded;
+    }
+    /**
+     * Get the current application environment.
+     * @returns The APP_ENV value or 'development' as default
+     */
+    getAppEnv() {
+        return process.env['APP_ENV'] ?? 'development';
+    }
+    /**
+     * Get the load result with source information.
+     * @returns The load result or null if not loaded
+     */
+    getLoadResult() {
+        return this.loadResult;
+    }
+    /**
+     * Serialize the current configuration to JSON string.
+     * @returns JSON string representation of the configuration
+     * @throws ConfigurationError if configuration is not loaded
+     */
+    serialize() {
+        if (!this.loaded || this.config === null) {
+            throw new ConfigurationError('Configuration not loaded. Call load() first.');
+        }
+        return JSON.stringify(this.config);
+    }
+    /**
+     * Create a new ConfigManager with configuration loaded from a JSON string.
+     * This is useful for restoring configuration from a serialized state.
+     * @param json JSON string to deserialize
+     * @param options Optional ConfigManager options (schema will be used for validation)
+     * @returns A new ConfigManager instance with the deserialized configuration
+     */
+    static deserialize(json, options = {}) {
+        const parsed = JSON.parse(json);
+        // Validate if schema is provided
+        if (options.schema) {
+            const result = options.schema.safeParse(parsed);
+            if (!result.success) {
+                const zodError = result.error;
+                throw new ValidationError(`Deserialization validation failed: ${zodError.errors.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ')}`, zodError.errors, undefined);
+            }
+        }
+        // Create a new ConfigManager and set its internal state
+        const manager = new ConfigManager(options);
+        manager.config = parsed;
+        manager.loaded = true;
+        manager.loadResult = {
+            config: parsed,
+            sources: [{ loader: 'deserialize', keysLoaded: Object.keys(parsed), duration: 0 }],
+            loadedAt: new Date(),
+        };
+        return manager;
+    }
+}
+//# sourceMappingURL=config-manager.js.map

package/dist/esm/config-manager.js.map

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

package/dist/esm/errors/index.js

@@ -0,0 +1,57 @@
+/**
+ * Base error class for all configuration-related errors
+ */
+export class ConfigurationError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.name = 'ConfigurationError';
+        this.cause = cause;
+        Object.setPrototypeOf(this, ConfigurationError.prototype);
+    }
+}
+/**
+ * Error thrown when configuration validation fails
+ */
+export class ValidationError extends ConfigurationError {
+    constructor(message, validationErrors, cause) {
+        super(message, cause);
+        this.name = 'ValidationError';
+        this.validationErrors = validationErrors;
+        Object.setPrototypeOf(this, ValidationError.prototype);
+    }
+}
+/**
+ * Error thrown when an AWS service operation fails
+ */
+export class AWSServiceError extends ConfigurationError {
+    constructor(message, service, operation, cause) {
+        super(message, cause);
+        this.name = 'AWSServiceError';
+        this.service = service;
+        this.operation = operation;
+        Object.setPrototypeOf(this, AWSServiceError.prototype);
+    }
+}
+/**
+ * Error thrown when a configuration loader fails to load
+ */
+export class ConfigurationLoadError extends ConfigurationError {
+    constructor(message, loader, cause) {
+        super(message, cause);
+        this.name = 'ConfigurationLoadError';
+        this.loader = loader;
+        Object.setPrototypeOf(this, ConfigurationLoadError.prototype);
+    }
+}
+/**
+ * Error thrown when required configuration keys are missing
+ */
+export class MissingConfigurationError extends ConfigurationError {
+    constructor(message, missingKeys, cause) {
+        super(message, cause);
+        this.name = 'MissingConfigurationError';
+        this.missingKeys = missingKeys;
+        Object.setPrototypeOf(this, MissingConfigurationError.prototype);
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAI3C,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,kBAAkB;IAIrD,YAAY,OAAe,EAAE,gBAAyB,EAAE,KAAa;QACnE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,kBAAkB;IAMrD,YAAY,OAAe,EAAE,OAAe,EAAE,SAAiB,EAAE,KAAa;QAC5E,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,kBAAkB;IAI5D,YAAY,OAAe,EAAE,MAAc,EAAE,KAAa;QACxD,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,kBAAkB;IAI/D,YAAY,OAAe,EAAE,WAAqB,EAAE,KAAa;QAC/D,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC;CACF"}

package/dist/esm/index.js

@@ -0,0 +1,21 @@
+/**
+ * @dyanet/config-aws
+ *
+ * Framework-agnostic AWS configuration management library.
+ * Supports environment variables, AWS Secrets Manager, SSM Parameter Store,
+ * S3, and .env files with configurable precedence.
+ */
+// Error classes
+export { ConfigurationError, ValidationError, AWSServiceError, ConfigurationLoadError, MissingConfigurationError, } from './errors';
+// Loaders
+export { EnvironmentLoader } from './loaders/environment.loader';
+export { EnvFileLoader } from './loaders/env-file.loader';
+export { S3Loader } from './loaders/s3.loader';
+export { SecretsManagerLoader } from './loaders/secrets-manager.loader';
+export { SSMParameterStoreLoader } from './loaders/ssm-parameter-store.loader';
+// ConfigManager
+export { ConfigManager } from './config-manager';
+// Utilities
+export { ConfigValidationUtil } from './utils/validation.util';
+export { EnvFileParser } from './utils/env-file-parser.util';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsCH,gBAAgB;AAChB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,UAAU,CAAC;AAElB,UAAU;AACV,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,YAAY;AACZ,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,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-manager.interface.js

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

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

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

package/dist/esm/interfaces/env-file-loader.interface.js

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

package/dist/esm/interfaces/env-file-loader.interface.js.map

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

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

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

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

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

package/dist/esm/interfaces/index.js

@@ -0,0 +1,2 @@
+export {};
+//# 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":""}

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

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

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

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

package/dist/esm/interfaces/secrets-manager-loader.interface.js

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

package/dist/esm/interfaces/secrets-manager-loader.interface.js.map

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

package/dist/esm/interfaces/ssm-parameter-store-loader.interface.js

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

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

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

package/dist/esm/loaders/env-file.loader.js

@@ -0,0 +1,130 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { EnvFileParser } from '../utils/env-file-parser.util';
+import { ConfigurationLoadError } from '../errors';
+/**
+ * Loader that reads configuration from .env files on the filesystem.
+ * Uses AWS ECS-compatible format for parsing.
+ *
+ * @example
+ * ```typescript
+ * // Load from default paths (.env, .env.local)
+ * const loader = new EnvFileLoader();
+ *
+ * // Load from specific paths
+ * const loader = new EnvFileLoader({
+ *   paths: ['.env', '.env.production']
+ * });
+ *
+ * // Disable override (first file wins)
+ * const loader = new EnvFileLoader({
+ *   paths: ['.env', '.env.local'],
+ *   override: false
+ * });
+ * ```
+ *
+ * @see https://docs.aws.amazon.com/AmazonECS/latest/developerguide/use-environment-file.html
+ */
+export class EnvFileLoader {
+    constructor(config = {}) {
+        this._config = {
+            paths: config.paths ?? EnvFileLoader.DEFAULT_PATHS,
+            encoding: config.encoding ?? EnvFileLoader.DEFAULT_ENCODING,
+            override: config.override ?? true,
+        };
+    }
+    getName() {
+        return 'EnvFileLoader';
+    }
+    /**
+     * Check if at least one of the configured .env files exists.
+     * @returns Promise resolving to true if any file exists
+     */
+    async isAvailable() {
+        for (const filePath of this._config.paths) {
+            const resolvedPath = this.resolvePath(filePath);
+            if (await this.fileExists(resolvedPath)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Load configuration from .env files.
+     *
+     * Files are processed in order. When override is true (default),
+     * later files override earlier ones. When override is false,
+     * earlier files take precedence.
+     *
+     * Missing files are silently skipped.
+     *
+     * @returns Promise resolving to the merged configuration
+     * @throws ConfigurationLoadError if a file exists but cannot be read
+     */
+    async load() {
+        const result = {};
+        for (const filePath of this._config.paths) {
+            const resolvedPath = this.resolvePath(filePath);
+            if (!(await this.fileExists(resolvedPath))) {
+                // Skip missing files silently
+                continue;
+            }
+            try {
+                const content = await this.readFile(resolvedPath);
+                const parsed = EnvFileParser.parse(content);
+                // Merge based on override setting
+                if (this._config.override) {
+                    // Later files override earlier ones
+                    Object.assign(result, parsed);
+                }
+                else {
+                    // Earlier files take precedence - only add keys that don't exist
+                    for (const [key, value] of Object.entries(parsed)) {
+                        if (!(key in result)) {
+                            result[key] = value;
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                throw new ConfigurationLoadError(`Failed to read env file: ${resolvedPath}`, this.getName(), error instanceof Error ? error : undefined);
+            }
+        }
+        return result;
+    }
+    /**
+     * Resolve a file path relative to the current working directory.
+     * @internal
+     */
+    resolvePath(filePath) {
+        if (path.isAbsolute(filePath)) {
+            return filePath;
+        }
+        return path.resolve(process.cwd(), filePath);
+    }
+    /**
+     * Check if a file exists.
+     * @internal
+     */
+    async fileExists(filePath) {
+        try {
+            await fs.promises.access(filePath, fs.constants.R_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Read a file's contents.
+     * @internal
+     */
+    async readFile(filePath) {
+        return fs.promises.readFile(filePath, { encoding: this._config.encoding });
+    }
+}
+/** Default paths to search for .env files */
+EnvFileLoader.DEFAULT_PATHS = ['.env', '.env.local'];
+/** Default file encoding */
+EnvFileLoader.DEFAULT_ENCODING = 'utf-8';
+//# sourceMappingURL=env-file.loader.js.map

package/dist/esm/loaders/env-file.loader.js.map

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