@dyanet/config-aws 1.0.0

package/dist/esm/utils/env-file-parser.util.js

@@ -0,0 +1,94 @@
+/**
+ * Parser for AWS ECS-compatible environment files.
+ *
+ * Format rules (per AWS ECS documentation):
+ * - Lines beginning with # are comments and ignored
+ * - Blank lines are ignored
+ * - Format: VARIABLE=VALUE (no spaces around =)
+ * - Variable names must match /^[a-zA-Z_][a-zA-Z0-9_]*$/
+ * - Values are literal (no quote processing, no interpolation)
+ * - One variable per line
+ * - Lines without = are ignored
+ * - Maximum line length: 32KB
+ *
+ * @see https://docs.aws.amazon.com/AmazonECS/latest/developerguide/use-environment-file.html
+ */
+export class EnvFileParser {
+    /**
+     * Parse environment file content into key-value pairs.
+     * @param content The raw content of the environment file
+     * @returns Record of environment variable names to values
+     */
+    static parse(content) {
+        const result = {};
+        // Handle empty content
+        if (!content) {
+            return result;
+        }
+        const lines = content.split(/\r?\n/);
+        for (const line of lines) {
+            // Skip lines exceeding max length
+            if (line.length > this.MAX_LINE_LENGTH) {
+                continue;
+            }
+            // Skip blank lines
+            if (line.trim() === '') {
+                continue;
+            }
+            // Skip comment lines (lines starting with # after optional whitespace)
+            if (line.trimStart().startsWith('#')) {
+                continue;
+            }
+            // Find the first = sign
+            const equalsIndex = line.indexOf('=');
+            if (equalsIndex === -1) {
+                // Lines without = are ignored
+                continue;
+            }
+            const key = line.substring(0, equalsIndex);
+            const value = line.substring(equalsIndex + 1);
+            // Validate variable name (must not be empty and must match pattern)
+            if (key.length === 0 || !this.VARIABLE_NAME_PATTERN.test(key)) {
+                continue;
+            }
+            result[key] = value;
+        }
+        return result;
+    }
+    /**
+     * Check if a variable name is valid per AWS ECS format.
+     * Variable names must:
+     * - Start with a letter (a-z, A-Z) or underscore (_)
+     * - Contain only alphanumeric characters and underscores
+     * - Not be empty
+     *
+     * @param name The variable name to check
+     * @returns true if the name is valid
+     */
+    static isValidVariableName(name) {
+        if (!name || name.length === 0) {
+            return false;
+        }
+        return this.VARIABLE_NAME_PATTERN.test(name);
+    }
+    /**
+     * Serialize a configuration object to AWS ECS-compatible env file format.
+     * @param config The configuration object to serialize
+     * @returns The serialized env file content
+     */
+    static serialize(config) {
+        const lines = [];
+        for (const [key, value] of Object.entries(config)) {
+            // Only include valid variable names
+            if (this.isValidVariableName(key)) {
+                lines.push(`${key}=${value}`);
+            }
+        }
+        return lines.join('\n');
+    }
+}
+/** Maximum line length per AWS ECS specification */
+EnvFileParser.MAX_LINE_LENGTH = 32 * 1024; // 32KB
+/** Valid variable name pattern: alphanumeric + underscore, cannot start with digit */
+EnvFileParser.VARIABLE_NAME_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+//# sourceMappingURL=env-file-parser.util.js.map

package/dist/esm/utils/env-file-parser.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-file-parser.util.js","sourceRoot":"","sources":["../../../src/utils/env-file-parser.util.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,aAAa;IAOxB;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,OAAe;QAC1B,MAAM,MAAM,GAA2B,EAAE,CAAC;QAE1C,uBAAuB;QACvB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,kCAAkC;YAClC,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;gBACvC,SAAS;YACX,CAAC;YAED,mBAAmB;YACnB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACvB,SAAS;YACX,CAAC;YAED,uEAAuE;YACvE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrC,SAAS;YACX,CAAC;YAED,wBAAwB;YACxB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;gBACvB,8BAA8B;gBAC9B,SAAS;YACX,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;YAE9C,oEAAoE;YACpE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9D,SAAS;YACX,CAAC;YAED,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,mBAAmB,CAAC,IAAY;QACrC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,MAA8B;QAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,oCAAoC;YACpC,IAAI,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;;AA3FD,oDAAoD;AAC5B,6BAAe,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO;AAE5D,sFAAsF;AAC9D,mCAAqB,GAAG,0BAA0B,CAAC"}

package/dist/esm/utils/index.js

@@ -0,0 +1,3 @@
+export { ConfigValidationUtil } from './validation.util';
+export { EnvFileParser } from './env-file-parser.util';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}

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

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

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

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

package/dist/types/config-manager.d.ts

@@ -0,0 +1,119 @@
+import type { ConfigManagerOptions, ConfigLoadResult, Logger, VerboseOptions } from './interfaces/config-manager.interface';
+/**
+ * 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 declare class ConfigManager<T = Record<string, unknown>> {
+    /** @internal */
+    protected readonly _options: Required<Omit<ConfigManagerOptions<T>, 'schema' | 'logger' | 'verbose'>> & {
+        schema?: ConfigManagerOptions<T>['schema'];
+        logger?: Logger;
+        verbose?: VerboseOptions | boolean;
+    };
+    /** @internal */
+    protected readonly _logger: Logger;
+    /** @internal */
+    protected readonly _verboseOptions: Required<VerboseOptions> | null;
+    private config;
+    private loadResult;
+    private loaded;
+    constructor(options?: ConfigManagerOptions<T>);
+    /**
+     * Resolve verbose options from boolean or object
+     */
+    private resolveVerboseOptions;
+    /**
+     * Log a message if logging is enabled
+     */
+    private log;
+    /**
+     * Mask a value for logging
+     */
+    private maskValue;
+    /**
+     * 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).
+     */
+    private getLoadOrder;
+    /**
+     * Sort loaders by custom precedence configuration
+     */
+    private sortByCustomPrecedence;
+    /**
+     * Sort loaders by predefined order
+     */
+    private sortByPredefinedOrder;
+    /**
+     * Load configuration from all configured loaders.
+     * Loaders are executed in precedence order, with later loaders overriding earlier ones.
+     */
+    load(): Promise<void>;
+    /**
+     * Get a specific configuration value by key.
+     * @param key The configuration key
+     * @returns The configuration value
+     * @throws ConfigurationError if configuration is not loaded
+     */
+    get<K extends keyof T>(key: K): T[K];
+    /**
+     * Get all configuration values.
+     * @returns The complete configuration object
+     * @throws ConfigurationError if configuration is not loaded
+     */
+    getAll(): T;
+    /**
+     * Check if configuration has been loaded.
+     * @returns true if configuration is loaded
+     */
+    isLoaded(): boolean;
+    /**
+     * Get the current application environment.
+     * @returns The APP_ENV value or 'development' as default
+     */
+    getAppEnv(): string;
+    /**
+     * Get the load result with source information.
+     * @returns The load result or null if not loaded
+     */
+    getLoadResult(): ConfigLoadResult<T> | null;
+    /**
+     * Serialize the current configuration to JSON string.
+     * @returns JSON string representation of the configuration
+     * @throws ConfigurationError if configuration is not loaded
+     */
+    serialize(): string;
+    /**
+     * 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<T = Record<string, unknown>>(json: string, options?: ConfigManagerOptions<T>): ConfigManager<T>;
+}
+//# sourceMappingURL=config-manager.d.ts.map

package/dist/types/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../src/config-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAEhB,MAAM,EAEN,cAAc,EACf,MAAM,uCAAuC,CAAC;AAsD/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpD,gBAAgB;IAChB,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC,GAAG;QACtG,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;KACpC,CAAC;IACF,gBAAgB;IAChB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACnC,gBAAgB;IAChB,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IAEpE,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,oBAAoB,CAAC,CAAC,CAAM;IAcjD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiB7B;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;OAEG;IACH,OAAO,CAAC,SAAS;IAwBjB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAc9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0G3B;;;;;OAKG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAQpC;;;;OAIG;IACH,MAAM,IAAI,CAAC;IAOX;;;OAGG;IACH,QAAQ,IAAI,OAAO;IAInB;;;OAGG;IACH,SAAS,IAAI,MAAM;IAInB;;;OAGG;IACH,aAAa,IAAI,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI;IAI3C;;;;OAIG;IACH,SAAS,IAAI,MAAM;IAOnB;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5C,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,oBAAoB,CAAC,CAAC,CAAM,GACpC,aAAa,CAAC,CAAC,CAAC;CA4BpB"}

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

@@ -0,0 +1,43 @@
+/**
+ * Base error class for all configuration-related errors
+ */
+export declare class ConfigurationError extends Error {
+    /** The underlying cause of this error */
+    readonly cause?: Error;
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Error thrown when configuration validation fails
+ */
+export declare class ValidationError extends ConfigurationError {
+    /** Detailed validation errors from Zod */
+    readonly validationErrors: unknown;
+    constructor(message: string, validationErrors: unknown, cause?: Error);
+}
+/**
+ * Error thrown when an AWS service operation fails
+ */
+export declare class AWSServiceError extends ConfigurationError {
+    /** The AWS service that failed */
+    readonly service: string;
+    /** The operation that failed */
+    readonly operation: string;
+    constructor(message: string, service: string, operation: string, cause?: Error);
+}
+/**
+ * Error thrown when a configuration loader fails to load
+ */
+export declare class ConfigurationLoadError extends ConfigurationError {
+    /** The name of the loader that failed */
+    readonly loader: string;
+    constructor(message: string, loader: string, cause?: Error);
+}
+/**
+ * Error thrown when required configuration keys are missing
+ */
+export declare class MissingConfigurationError extends ConfigurationError {
+    /** The keys that are missing */
+    readonly missingKeys: string[];
+    constructor(message: string, missingKeys: string[], cause?: Error);
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,yCAAyC;IACzC,SAAgB,KAAK,CAAC,EAAE,KAAK,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,kBAAkB;IACrD,0CAA0C;IAC1C,SAAgB,gBAAgB,EAAE,OAAO,CAAC;gBAE9B,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK;CAMtE;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,kBAAkB;IACrD,kCAAkC;IAClC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,gCAAgC;IAChC,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAO/E;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,kBAAkB;IAC5D,yCAAyC;IACzC,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3D;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,kBAAkB;IAC/D,gCAAgC;IAChC,SAAgB,WAAW,EAAE,MAAM,EAAE,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,KAAK;CAMlE"}

package/dist/types/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @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.
+ */
+export type { ConfigLoader, ConfigLoaderResult, } from './interfaces/config-loader.interface';
+export type { ConfigManagerOptions, LoaderPrecedence, VerboseOptions, PrecedenceStrategy, ConfigLoadResult, ConfigSourceInfo, Logger, } from './interfaces/config-manager.interface';
+export type { EnvironmentLoaderConfig, } from './interfaces/environment-loader.interface';
+export type { EnvFileLoaderConfig, } from './interfaces/env-file-loader.interface';
+export type { S3LoaderConfig, } from './interfaces/s3-loader.interface';
+export type { SecretsManagerLoaderConfig, } from './interfaces/secrets-manager-loader.interface';
+export type { SSMParameterStoreLoaderConfig, } from './interfaces/ssm-parameter-store-loader.interface';
+export { ConfigurationError, ValidationError, AWSServiceError, ConfigurationLoadError, MissingConfigurationError, } from './errors';
+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';
+export { ConfigManager } from './config-manager';
+export { ConfigValidationUtil } from './utils/validation.util';
+export { EnvFileParser } from './utils/env-file-parser.util';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,YAAY,EACZ,kBAAkB,GACnB,MAAM,sCAAsC,CAAC;AAE9C,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,MAAM,GACP,MAAM,uCAAuC,CAAC;AAE/C,YAAY,EACV,uBAAuB,GACxB,MAAM,2CAA2C,CAAC;AAEnD,YAAY,EACV,mBAAmB,GACpB,MAAM,wCAAwC,CAAC;AAEhD,YAAY,EACV,cAAc,GACf,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EACV,0BAA0B,GAC3B,MAAM,+CAA+C,CAAC;AAEvD,YAAY,EACV,6BAA6B,GAC9B,MAAM,mDAAmD,CAAC;AAG3D,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,UAAU,CAAC;AAGlB,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;AAG/E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/types/interfaces/config-loader.interface.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Result returned by a configuration loader
+ */
+export interface ConfigLoaderResult {
+    /** The loaded configuration key-value pairs */
+    config: Record<string, unknown>;
+    /** Keys that were loaded by this loader */
+    keysLoaded: string[];
+    /** Time taken to load in milliseconds */
+    duration: number;
+}
+/**
+ * Interface for configuration loaders.
+ * All loaders must implement this interface to be used with ConfigManager.
+ */
+export interface ConfigLoader {
+    /**
+     * Load configuration from the source.
+     * @returns Promise resolving to the loaded configuration
+     */
+    load(): Promise<Record<string, unknown>>;
+    /**
+     * Get the name of this loader for logging and debugging.
+     * @returns The loader name
+     */
+    getName(): string;
+    /**
+     * Check if this loader is available and can load configuration.
+     * @returns Promise resolving to true if the loader can load configuration
+     */
+    isAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=config-loader.interface.d.ts.map

package/dist/types/interfaces/config-loader.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/config-loader.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,2CAA2C;IAC3C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEzC;;;OAGG;IACH,OAAO,IAAI,MAAM,CAAC;IAElB;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC"}

package/dist/types/interfaces/config-manager.interface.d.ts

@@ -0,0 +1,86 @@
+import type { ZodType } from 'zod';
+import type { ConfigLoader } from './config-loader.interface';
+/**
+ * Logger interface for ConfigManager
+ */
+export interface Logger {
+    log(message: string): void;
+    error(message: string): void;
+    warn(message: string): void;
+    debug?(message: string): void;
+}
+/**
+ * Options for verbose logging output
+ */
+export interface VerboseOptions {
+    /** Log all variable names being loaded. Default: true */
+    logKeys?: boolean;
+    /** Log variable values (WARNING: may expose secrets). Default: false */
+    logValues?: boolean;
+    /** Log when a variable is overridden by a higher-precedence loader. Default: true */
+    logOverrides?: boolean;
+    /** Log loader timing information. Default: true */
+    logTiming?: boolean;
+    /** Mask sensitive values (show first/last 2 chars only). Default: true (when logValues is true) */
+    maskValues?: boolean;
+    /** Keys to always mask regardless of maskValues setting. Default: ['password', 'secret', 'key', 'token'] */
+    sensitiveKeys?: string[];
+}
+/**
+ * Custom loader precedence configuration
+ */
+export interface LoaderPrecedence {
+    /** Loader name */
+    loader: string;
+    /** Priority - higher values override lower values */
+    priority: number;
+}
+/**
+ * Precedence strategy for merging configurations
+ * - 'aws-first': env -> envFile -> s3 -> secretsManager -> ssm (AWS wins)
+ * - 'local-first': secretsManager -> ssm -> s3 -> envFile -> env (local wins)
+ * - Custom array: user-defined order via LoaderPrecedence[]
+ */
+export type PrecedenceStrategy = 'aws-first' | 'local-first' | LoaderPrecedence[];
+/**
+ * Options for ConfigManager
+ */
+export interface ConfigManagerOptions<T = Record<string, unknown>> {
+    /** Array of loaders to use */
+    loaders?: ConfigLoader[];
+    /** Zod schema for validation */
+    schema?: ZodType<T>;
+    /** Precedence strategy for merging configurations */
+    precedence?: PrecedenceStrategy;
+    /** Whether to validate configuration on load. Default: true */
+    validateOnLoad?: boolean;
+    /** Enable logging. Default: false */
+    enableLogging?: boolean;
+    /** Custom logger instance */
+    logger?: Logger;
+    /** Verbose debugging output options */
+    verbose?: VerboseOptions | boolean;
+}
+/**
+ * Information about a configuration source
+ */
+export interface ConfigSourceInfo {
+    /** Name of the loader */
+    loader: string;
+    /** Keys loaded by this loader */
+    keysLoaded: string[];
+    /** Time taken to load in milliseconds */
+    duration: number;
+}
+/**
+ * Result of loading configuration
+ */
+export interface ConfigLoadResult<T> {
+    /** The merged configuration */
+    config: T;
+    /** Information about each source */
+    sources: ConfigSourceInfo[];
+    /** When the configuration was loaded */
+    loadedAt: Date;
+}
+//# sourceMappingURL=config-manager.interface.d.ts.map

package/dist/types/interfaces/config-manager.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/config-manager.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qFAAqF;IACrF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mGAAmG;IACnG,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4GAA4G;IAC5G,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,aAAa,GAAG,gBAAgB,EAAE,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,8BAA8B;IAC9B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,gCAAgC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,qDAAqD;IACrD,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qCAAqC;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,+BAA+B;IAC/B,MAAM,EAAE,CAAC,CAAC;IACV,oCAAoC;IACpC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,wCAAwC;IACxC,QAAQ,EAAE,IAAI,CAAC;CAChB"}

package/dist/types/interfaces/env-file-loader.interface.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Configuration options for EnvFileLoader
+ */
+export interface EnvFileLoaderConfig {
+    /** Paths to .env files to load. Default: ['.env', '.env.local'] */
+    paths?: string[];
+    /** File encoding. Default: 'utf-8' */
+    encoding?: BufferEncoding;
+    /** Whether later files override earlier ones. Default: true */
+    override?: boolean;
+}
+//# sourceMappingURL=env-file-loader.interface.d.ts.map

package/dist/types/interfaces/env-file-loader.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-file-loader.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/env-file-loader.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/types/interfaces/environment-loader.interface.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Configuration options for EnvironmentLoader
+ */
+export interface EnvironmentLoaderConfig {
+    /** Prefix to filter environment variables. Only variables starting with this prefix will be loaded. */
+    prefix?: string;
+    /** List of environment variable names to exclude from loading */
+    exclude?: string[];
+}
+//# sourceMappingURL=environment-loader.interface.d.ts.map

package/dist/types/interfaces/environment-loader.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-loader.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/environment-loader.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uGAAuG;IACvG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB"}

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

@@ -0,0 +1,8 @@
+export type { ConfigLoader, ConfigLoaderResult } from './config-loader.interface';
+export type { ConfigManagerOptions, LoaderPrecedence, VerboseOptions, PrecedenceStrategy, ConfigLoadResult, ConfigSourceInfo, Logger, } from './config-manager.interface';
+export type { EnvironmentLoaderConfig } from './environment-loader.interface';
+export type { EnvFileLoaderConfig } from './env-file-loader.interface';
+export type { S3LoaderConfig } from './s3-loader.interface';
+export type { SecretsManagerLoaderConfig } from './secrets-manager-loader.interface';
+export type { SSMParameterStoreLoaderConfig } from './ssm-parameter-store-loader.interface';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAClF,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,MAAM,GACP,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AACrF,YAAY,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/types/interfaces/s3-loader.interface.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Configuration options for S3Loader
+ */
+export interface S3LoaderConfig {
+    /** S3 bucket name */
+    bucket: string;
+    /** S3 object key */
+    key: string;
+    /** AWS region. If not specified, uses default region from environment */
+    region?: string;
+    /** Format of the configuration file. Default: 'auto' (auto-detect based on content) */
+    format?: 'json' | 'env' | 'auto';
+}
+//# sourceMappingURL=s3-loader.interface.d.ts.map

package/dist/types/interfaces/s3-loader.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-loader.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/s3-loader.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;CAClC"}

package/dist/types/interfaces/secrets-manager-loader.interface.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Configuration options for SecretsManagerLoader
+ */
+export interface SecretsManagerLoaderConfig {
+    /** Name or ARN of the secret to load */
+    secretName?: string;
+    /** AWS region. If not specified, uses default region from environment */
+    region?: string;
+    /** Mapping of environment names to path prefixes */
+    environmentMapping?: Record<string, string>;
+}
+//# sourceMappingURL=secrets-manager-loader.interface.d.ts.map

package/dist/types/interfaces/secrets-manager-loader.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets-manager-loader.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/secrets-manager-loader.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C"}