@dyanet/nestjs-config-aws 1.0.1 → 1.2.0

package/dist/types/config-aws/src/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-aws/src/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../../../../config-aws/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/config-aws/src/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/config-aws/src/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../config-aws/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/config-aws/src/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/config-aws/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../config-aws/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/config-aws/src/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/config-aws/src/interfaces/config-loader.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.interface.d.ts","sourceRoot":"","sources":["../../../../../../config-aws/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/config-aws/src/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/config-aws/src/interfaces/config-manager.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.interface.d.ts","sourceRoot":"","sources":["../../../../../../config-aws/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/config-aws/src/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/config-aws/src/interfaces/env-file-loader.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-file-loader.interface.d.ts","sourceRoot":"","sources":["../../../../../../config-aws/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/config-aws/src/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/config-aws/src/interfaces/environment-loader.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-loader.interface.d.ts","sourceRoot":"","sources":["../../../../../../config-aws/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/config-aws/src/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/config-aws/src/interfaces/s3-loader.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-loader.interface.d.ts","sourceRoot":"","sources":["../../../../../../config-aws/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/config-aws/src/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/config-aws/src/interfaces/secrets-manager-loader.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets-manager-loader.interface.d.ts","sourceRoot":"","sources":["../../../../../../config-aws/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"}

package/dist/types/config-aws/src/interfaces/ssm-parameter-store-loader.interface.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Configuration options for SSMParameterStoreLoader
+ */
+export interface SSMParameterStoreLoaderConfig {
+    /** Path prefix for parameters to load */
+    parameterPath?: string;
+    /** AWS region. If not specified, uses default region from environment */
+    region?: string;
+    /** Mapping of environment names to path prefixes */
+    environmentMapping?: Record<string, string>;
+    /** Whether to decrypt SecureString parameters. Default: true */
+    withDecryption?: boolean;
+}
+//# sourceMappingURL=ssm-parameter-store-loader.interface.d.ts.map

package/dist/types/config-aws/src/interfaces/ssm-parameter-store-loader.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssm-parameter-store-loader.interface.d.ts","sourceRoot":"","sources":["../../../../../../config-aws/src/interfaces/ssm-parameter-store-loader.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/dist/types/config-aws/src/loaders/env-file.loader.d.ts

@@ -0,0 +1,69 @@
+import type { ConfigLoader } from '../interfaces/config-loader.interface';
+import type { EnvFileLoaderConfig } from '../interfaces/env-file-loader.interface';
+/**
+ * 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 declare class EnvFileLoader implements ConfigLoader {
+    /** @internal */
+    protected readonly _config: Required<EnvFileLoaderConfig>;
+    /** Default paths to search for .env files */
+    private static readonly DEFAULT_PATHS;
+    /** Default file encoding */
+    private static readonly DEFAULT_ENCODING;
+    constructor(config?: EnvFileLoaderConfig);
+    getName(): string;
+    /**
+     * Check if at least one of the configured .env files exists.
+     * @returns Promise resolving to true if any file exists
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * 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
+     */
+    load(): Promise<Record<string, unknown>>;
+    /**
+     * Resolve a file path relative to the current working directory.
+     * @internal
+     */
+    protected resolvePath(filePath: string): string;
+    /**
+     * Check if a file exists.
+     * @internal
+     */
+    protected fileExists(filePath: string): Promise<boolean>;
+    /**
+     * Read a file's contents.
+     * @internal
+     */
+    protected readFile(filePath: string): Promise<string>;
+}
+//# sourceMappingURL=env-file.loader.d.ts.map

package/dist/types/config-aws/src/loaders/env-file.loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-file.loader.d.ts","sourceRoot":"","sources":["../../../../../../config-aws/src/loaders/env-file.loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAInF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,aAAc,YAAW,YAAY;IAChD,gBAAgB;IAChB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IAE1D,6CAA6C;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAA0B;IAE/D,4BAA4B;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAA2B;gBAEvD,MAAM,GAAE,mBAAwB;IAQ5C,OAAO,IAAI,MAAM;IAKjB;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAUrC;;;;;;;;;;;OAWG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAuC9C;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAO/C;;;OAGG;cACa,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS9D;;;OAGG;cACa,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAG5D"}

package/dist/types/config-aws/src/loaders/environment.loader.d.ts

@@ -0,0 +1,46 @@
+import type { ConfigLoader } from '../interfaces/config-loader.interface';
+import type { EnvironmentLoaderConfig } from '../interfaces/environment-loader.interface';
+/**
+ * Loader that reads configuration from process.env.
+ * Supports prefix filtering and exclusion lists.
+ *
+ * @example
+ * ```typescript
+ * // Load all environment variables
+ * const loader = new EnvironmentLoader();
+ *
+ * // Load only variables starting with 'APP_', stripping the prefix
+ * const loader = new EnvironmentLoader({ prefix: 'APP_' });
+ *
+ * // Load all except specific variables
+ * const loader = new EnvironmentLoader({ exclude: ['PATH', 'HOME'] });
+ *
+ * // Combine prefix and exclusion
+ * const loader = new EnvironmentLoader({
+ *   prefix: 'APP_',
+ *   exclude: ['APP_DEBUG']
+ * });
+ * ```
+ */
+export declare class EnvironmentLoader implements ConfigLoader {
+    /** @internal */
+    protected readonly _config: EnvironmentLoaderConfig;
+    constructor(config?: EnvironmentLoaderConfig);
+    getName(): string;
+    isAvailable(): Promise<boolean>;
+    /**
+     * Load configuration from process.env.
+     *
+     * When a prefix is specified:
+     * - Only variables starting with the prefix are included
+     * - The prefix is stripped from the resulting key names
+     *
+     * When an exclusion list is specified:
+     * - Variables in the list are excluded from the result
+     * - Exclusion is checked against the original key (before prefix stripping)
+     *
+     * @returns Promise resolving to the loaded configuration
+     */
+    load(): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=environment.loader.d.ts.map

package/dist/types/config-aws/src/loaders/environment.loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.loader.d.ts","sourceRoot":"","sources":["../../../../../../config-aws/src/loaders/environment.loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,gBAAgB;IAChB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;gBAExC,MAAM,GAAE,uBAA4B;IAIhD,OAAO,IAAI,MAAM;IAIX,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;;;;;;;;;;;OAYG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAmC/C"}

package/dist/types/config-aws/src/loaders/s3.loader.d.ts

@@ -0,0 +1,62 @@
+import { S3Client } from '@aws-sdk/client-s3';
+import type { ConfigLoader } from '../interfaces/config-loader.interface';
+import type { S3LoaderConfig } from '../interfaces/s3-loader.interface';
+/**
+ * Loader that reads configuration from S3 buckets.
+ * Supports JSON and .env file formats with auto-detection.
+ *
+ * @example
+ * ```typescript
+ * // Load JSON config from S3
+ * const loader = new S3Loader({
+ *   bucket: 'my-config-bucket',
+ *   key: 'config/app.json',
+ *   format: 'json'
+ * });
+ *
+ * // Load .env file from S3 with auto-detection
+ * const loader = new S3Loader({
+ *   bucket: 'my-config-bucket',
+ *   key: 'config/.env'
+ * });
+ * ```
+ *
+ * @see https://docs.aws.amazon.com/AmazonECS/latest/developerguide/use-environment-file.html
+ */
+export declare class S3Loader implements ConfigLoader {
+    /** @internal */
+    protected readonly _config: Required<S3LoaderConfig>;
+    /** @internal */
+    protected readonly _client: S3Client;
+    constructor(config: S3LoaderConfig);
+    getName(): string;
+    /**
+     * Check if this loader is available by verifying AWS credentials.
+     * @returns Promise resolving to true if AWS credentials are available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Load configuration from S3.
+     * @returns Promise resolving to configuration key-value pairs
+     * @throws AWSServiceError if S3 operation fails
+     * @throws ConfigurationLoadError if content cannot be parsed
+     */
+    load(): Promise<Record<string, unknown>>;
+    /**
+     * Parse content based on format setting or auto-detection.
+     * @internal
+     */
+    protected parseContent(content: string): Record<string, unknown>;
+    /**
+     * Detect content format based on structure.
+     * JSON content starts with '{' after trimming whitespace.
+     * @internal
+     */
+    protected detectFormat(content: string): 'json' | 'env';
+    /**
+     * Parse JSON content.
+     * @internal
+     */
+    protected parseJson(content: string): Record<string, unknown>;
+}
+//# sourceMappingURL=s3.loader.d.ts.map

package/dist/types/config-aws/src/loaders/s3.loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.loader.d.ts","sourceRoot":"","sources":["../../../../../../config-aws/src/loaders/s3.loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAIxE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,QAAS,YAAW,YAAY;IAC3C,gBAAgB;IAChB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACrD,gBAAgB;IAChB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;gBAEzB,MAAM,EAAE,cAAc;IAclC,OAAO,IAAI,MAAM;IAKjB;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAkD9C;;;OAGG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAUhE;;;;OAIG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK;IAQvD;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAkB9D"}