@dyanet/config-aws 1.0.0

package/dist/types/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/interfaces/ssm-parameter-store-loader.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssm-parameter-store-loader.interface.d.ts","sourceRoot":"","sources":["../../../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/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/loaders/env-file.loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.loader.d.ts","sourceRoot":"","sources":["../../../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/loaders/index.d.ts

@@ -0,0 +1,6 @@
+export { EnvironmentLoader } from './environment.loader';
+export { EnvFileLoader } from './env-file.loader';
+export { S3Loader } from './s3.loader';
+export { SecretsManagerLoader } from './secrets-manager.loader';
+export { SSMParameterStoreLoader } from './ssm-parameter-store.loader';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/loaders/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/types/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/loaders/s3.loader.d.ts.map

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

package/dist/types/loaders/secrets-manager.loader.d.ts

@@ -0,0 +1,68 @@
+import { SecretsManagerClient } from '@aws-sdk/client-secrets-manager';
+import type { ConfigLoader } from '../interfaces/config-loader.interface';
+import type { SecretsManagerLoaderConfig } from '../interfaces/secrets-manager-loader.interface';
+/**
+ * Loader that reads configuration from AWS Secrets Manager.
+ * Supports environment-aware path construction.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const loader = new SecretsManagerLoader({
+ *   secretName: '/my-app/config',
+ *   region: 'us-east-1'
+ * });
+ *
+ * // With environment mapping
+ * const loader = new SecretsManagerLoader({
+ *   secretName: '/my-app/config',
+ *   environmentMapping: {
+ *     development: 'dev',
+ *     staging: 'stg',
+ *     production: 'prod'
+ *   }
+ * });
+ * ```
+ */
+export declare class SecretsManagerLoader implements ConfigLoader {
+    /** @internal */
+    protected readonly _client: SecretsManagerClient;
+    /** @internal */
+    protected readonly _config: Required<SecretsManagerLoaderConfig>;
+    /** @internal */
+    protected readonly _appEnv: string;
+    constructor(config?: SecretsManagerLoaderConfig);
+    /**
+     * Get the name of this loader for logging and debugging.
+     * @returns The loader name with secret path
+     */
+    getName(): string;
+    /**
+     * Check if this loader is available in the current environment.
+     * @returns Promise resolving to true if not in local environment and AWS credentials are available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Load configuration from AWS Secrets Manager.
+     * @returns Promise resolving to configuration key-value pairs from the secret
+     * @throws AWSServiceError if AWS operation fails
+     * @throws ConfigurationLoadError if secret cannot be parsed
+     */
+    load(): Promise<Record<string, unknown>>;
+    /**
+     * Build the environment-aware secret name/path.
+     * @returns The full secret name with environment prefix
+     */
+    buildSecretName(): string;
+    /**
+     * Get the current app environment.
+     * @returns The current APP_ENV or NODE_ENV value
+     */
+    getAppEnv(): string;
+    /**
+     * Get the environment mapping configuration.
+     * @returns The environment mapping record
+     */
+    getEnvironmentMapping(): Record<string, string>;
+}
+//# sourceMappingURL=secrets-manager.loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"secrets-manager.loader.d.ts","sourceRoot":"","sources":["../../../src/loaders/secrets-manager.loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAG9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AAGjG;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,gBAAgB;IAChB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACjD,gBAAgB;IAChB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,0BAA0B,CAAC,CAAC;IACjE,gBAAgB;IAChB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEvB,MAAM,GAAE,0BAA+B;IAsBnD;;;OAGG;IACH,OAAO,IAAI,MAAM;IAKjB;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAerC;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAoE9C;;;OAGG;IACH,eAAe,IAAI,MAAM;IAczB;;;OAGG;IACH,SAAS,IAAI,MAAM;IAInB;;;OAGG;IACH,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAGhD"}

package/dist/types/loaders/ssm-parameter-store.loader.d.ts

@@ -0,0 +1,78 @@
+import { SSMClient } from '@aws-sdk/client-ssm';
+import type { ConfigLoader } from '../interfaces/config-loader.interface';
+import type { SSMParameterStoreLoaderConfig } from '../interfaces/ssm-parameter-store-loader.interface';
+/**
+ * Loader that reads configuration from AWS SSM Parameter Store.
+ * Supports environment-aware path construction, pagination, and decryption options.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const loader = new SSMParameterStoreLoader({
+ *   parameterPath: '/my-app/config',
+ *   region: 'us-east-1'
+ * });
+ *
+ * // With environment mapping
+ * const loader = new SSMParameterStoreLoader({
+ *   parameterPath: '/my-app/config',
+ *   environmentMapping: {
+ *     development: 'dev',
+ *     staging: 'stg',
+ *     production: 'prod'
+ *   }
+ * });
+ * ```
+ */
+export declare class SSMParameterStoreLoader implements ConfigLoader {
+    /** @internal */
+    protected readonly _client: SSMClient;
+    /** @internal */
+    protected readonly _config: Required<SSMParameterStoreLoaderConfig>;
+    /** @internal */
+    protected readonly _appEnv: string;
+    constructor(config?: SSMParameterStoreLoaderConfig);
+    /**
+     * Get the name of this loader for logging and debugging.
+     * @returns The loader name with parameter path
+     */
+    getName(): string;
+    /**
+     * Check if this loader is available in the current environment.
+     * @returns Promise resolving to true if not in local environment and AWS credentials are available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Load configuration from AWS SSM Parameter Store.
+     * Implements recursive parameter fetching with NextToken handling for pagination.
+     * @returns Promise resolving to configuration key-value pairs from parameters
+     * @throws AWSServiceError if AWS operation fails
+     * @throws ConfigurationLoadError if parameter path cannot be constructed
+     */
+    load(): Promise<Record<string, unknown>>;
+    /**
+     * Build the environment-aware parameter path.
+     * @returns The full parameter path with environment prefix
+     * @throws ConfigurationLoadError if no environment mapping found
+     */
+    buildParameterPath(): string;
+    /**
+     * Transform parameter name by removing the prefix and converting to uppercase.
+     * Example: '/dev/config-aws/database/host' -> 'DATABASE_HOST'
+     * @param parameterName The full parameter name from AWS
+     * @param pathPrefix The path prefix to remove
+     * @returns The transformed parameter name or null if invalid
+     */
+    private transformParameterName;
+    /**
+     * Get the current app environment.
+     * @returns The current APP_ENV or NODE_ENV value
+     */
+    getAppEnv(): string;
+    /**
+     * Get the environment mapping configuration.
+     * @returns The environment mapping record
+     */
+    getEnvironmentMapping(): Record<string, string>;
+}
+//# sourceMappingURL=ssm-parameter-store.loader.d.ts.map

package/dist/types/loaders/ssm-parameter-store.loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssm-parameter-store.loader.d.ts","sourceRoot":"","sources":["../../../src/loaders/ssm-parameter-store.loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAG5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAGxG;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,uBAAwB,YAAW,YAAY;IAC1D,gBAAgB;IAChB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IACtC,gBAAgB;IAChB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,6BAA6B,CAAC,CAAC;IACpE,gBAAgB;IAChB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEvB,MAAM,GAAE,6BAAkC;IAuBtD;;;OAGG;IACH,OAAO,IAAI,MAAM;IAUjB;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAerC;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA6E9C;;;;OAIG;IACH,kBAAkB,IAAI,MAAM;IAc5B;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAuB9B;;;OAGG;IACH,SAAS,IAAI,MAAM;IAInB;;;OAGG;IACH,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAGhD"}

package/dist/types/utils/env-file-parser.util.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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 declare class EnvFileParser {
+    /** Maximum line length per AWS ECS specification */
+    private static readonly MAX_LINE_LENGTH;
+    /** Valid variable name pattern: alphanumeric + underscore, cannot start with digit */
+    private static readonly VARIABLE_NAME_PATTERN;
+    /**
+     * 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: string): Record<string, string>;
+    /**
+     * 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: string): boolean;
+    /**
+     * 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: Record<string, string>): string;
+}
+//# sourceMappingURL=env-file-parser.util.d.ts.map

package/dist/types/utils/env-file-parser.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-file-parser.util.d.ts","sourceRoot":"","sources":["../../../src/utils/env-file-parser.util.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAa;IACxB,oDAAoD;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAa;IAEpD,sFAAsF;IACtF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAA8B;IAE3E;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IA+CrD;;;;;;;;;OASG;IACH,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOjD;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;CAYzD"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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/types/utils/validation.util.d.ts

@@ -0,0 +1,53 @@
+import type { ZodType, ZodError, TypeOf } from 'zod';
+import { ValidationError } from '../errors';
+/**
+ * Framework-agnostic validation utility for configuration values.
+ * Provides methods for validating configuration objects against Zod schemas.
+ */
+export declare 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<T extends ZodType>(schema: T, value: unknown, context?: string): TypeOf<T>;
+    /**
+     * 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<T extends ZodType>(schema: T, value: unknown): {
+        success: true;
+        data: TypeOf<T>;
+    } | {
+        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: ZodError): unknown;
+    /**
+     * 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: ZodError, context?: string): string;
+    /**
+     * 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<T extends ZodType>(schema: T, value: unknown, source: string): TypeOf<T>;
+}
+//# sourceMappingURL=validation.util.d.ts.map

package/dist/types/utils/validation.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.util.d.ts","sourceRoot":"","sources":["../../../src/utils/validation.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,OAAO,EAC/B,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAAC,CAAC,CAAC;IAeZ;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,OAAO,EACnC,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,GACb;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,eAAe,CAAA;KAAE;IAalF;;;;OAIG;IACH,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IA+BvD;;;;;OAKG;IACH,MAAM,CAAC,0BAA0B,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAmB5E;;;;;;;OAOG;IACH,MAAM,CAAC,qBAAqB,CAAC,CAAC,SAAS,OAAO,EAC5C,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,CAAC,CAAC;CAYb"}

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@dyanet/config-aws",
+  "version": "1.0.0",
+  "description": "Framework-agnostic AWS configuration management with support for environment variables, AWS Secrets Manager, SSM Parameter Store, S3, and .env files",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run clean && npm run build:types && npm run build:esm && npm run build:cjs",
+    "build:types": "tsc --project tsconfig.types.json",
+    "build:esm": "tsc --project tsconfig.esm.json",
+    "build:cjs": "tsc --project tsconfig.cjs.json",
+    "clean": "rimraf dist",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "configuration",
+    "aws",
+    "secrets-manager",
+    "ssm",
+    "parameter-store",
+    "s3",
+    "env-file",
+    "typescript",
+    "zod",
+    "framework-agnostic"
+  ],
+  "author": "Dyanet",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=8.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-secrets-manager": "^3.0.0",
+    "@aws-sdk/client-ssm": "^3.0.0",
+    "@aws-sdk/client-s3": "^3.0.0",
+    "zod": "^3.22.0"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-secrets-manager": {
+      "optional": true
+    },
+    "@aws-sdk/client-ssm": {
+      "optional": true
+    },
+    "@aws-sdk/client-s3": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@aws-sdk/client-secrets-manager": "^3.0.0",
+    "@aws-sdk/client-ssm": "^3.0.0",
+    "@aws-sdk/client-s3": "^3.0.0",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "aws-sdk-client-mock": "^4.0.0",
+    "eslint": "^8.0.0",
+    "fast-check": "^3.15.0",
+    "jest": "^29.5.0",
+    "rimraf": "^5.0.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.9.2",
+    "zod": "^3.22.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dyanet/nestjs-config-aws.git"
+  },
+  "bugs": {
+    "url": "https://github.com/dyanet/nestjs-config-aws/issues"
+  },
+  "homepage": "https://github.com/dyanet/nestjs-config-aws/tree/main/packages/config-aws"
+}