@dyanet/config-aws 1.0.0

package/dist/cjs/loaders/secrets-manager.loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets-manager.loader.js","sourceRoot":"","sources":["../../../src/loaders/secrets-manager.loader.ts"],"names":[],"mappings":";;;AAAA,4EAA8F;AAC9F,wEAAsE;AAItE,sCAAoE;AAEpE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAa,oBAAoB;IAQ/B,YAAY,SAAqC,EAAE;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC;QAE5E,4BAA4B;QAC5B,IAAI,CAAC,OAAO,GAAG;YACb,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,oBAAoB;YACrD,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,WAAW;YACjE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI;gBAC/C,WAAW,EAAE,KAAK;gBAClB,IAAI,EAAE,MAAM;gBACZ,UAAU,EAAE,YAAY;aACzB;SACF,CAAC;QAEF,wCAAwC;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,6CAAoB,CAAC;YACtC,WAAW,EAAE,IAAA,4CAAqB,GAAE;YACpC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;SAC5B,CAAC,CAAC;IACL,CAAC;IAGD;;;OAGG;IACH,OAAO;QACL,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1C,OAAO,wBAAwB,UAAU,GAAG,CAAC;IAC/C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW;QACf,4BAA4B;QAC5B,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,4DAA4D;YAC5D,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI;QACR,oCAAoC;QACpC,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC7B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAE1C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,8CAAqB,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;YACpE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAElD,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;gBAC3B,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,iDAAiD;YACjD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;gBAEjD,uDAAuD;gBACvD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC5E,OAAO,MAAM,CAAC;gBAChB,CAAC;qBAAM,CAAC;oBACN,2DAA2D;oBAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;gBAClC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,wDAAwD;gBACxD,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC;YACjD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,6BAA6B;YAC7B,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,2BAA2B,EAAE,CAAC;oBAC/C,8EAA8E;oBAC9E,OAAO,EAAE,CAAC;gBACZ,CAAC;gBAED,IAAI,KAAK,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;oBAC3C,MAAM,IAAI,wBAAe,CACvB,yCAAyC,UAAU,2CAA2C,EAC9F,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,CACN,CAAC;gBACJ,CAAC;gBAED,IAAI,KAAK,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;oBAC7C,MAAM,IAAI,wBAAe,CACvB,2CAA2C,UAAU,8BAA8B,EACnF,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,CACN,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,4CAA4C;YAC5C,MAAM,IAAI,wBAAe,CACvB,8BAA8B,UAAU,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC/H,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC3C,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,eAAe;QACb,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEhE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,+BAAsB,CAC9B,6CAA6C,IAAI,CAAC,OAAO,KAAK;gBAC5D,2BAA2B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACtF,IAAI,CAAC,OAAO,EAAE,CACf,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,qBAAqB;QACnB,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAChD,CAAC;CACF;AArKD,oDAqKC"}

package/dist/cjs/loaders/ssm-parameter-store.loader.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SSMParameterStoreLoader = void 0;
+const client_ssm_1 = require("@aws-sdk/client-ssm");
+const credential_providers_1 = require("@aws-sdk/credential-providers");
+const errors_1 = require("../errors");
+/**
+ * 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'
+ *   }
+ * });
+ * ```
+ */
+class SSMParameterStoreLoader {
+    constructor(config = {}) {
+        this._appEnv = process.env['APP_ENV'] || process.env['NODE_ENV'] || 'local';
+        // Set default configuration
+        this._config = {
+            parameterPath: config.parameterPath || '/config-aws',
+            region: config.region || process.env['AWS_REGION'] || 'us-east-1',
+            environmentMapping: config.environmentMapping || {
+                development: 'dev',
+                test: 'test',
+                production: 'production',
+            },
+            withDecryption: config.withDecryption ?? true,
+        };
+        // Initialize AWS SSM client
+        this._client = new client_ssm_1.SSMClient({
+            credentials: (0, credential_providers_1.fromNodeProviderChain)(),
+            region: this._config.region,
+        });
+    }
+    /**
+     * Get the name of this loader for logging and debugging.
+     * @returns The loader name with parameter path
+     */
+    getName() {
+        try {
+            const parameterPath = this.buildParameterPath();
+            return `SSMParameterStoreLoader(${parameterPath})`;
+        }
+        catch {
+            // Fallback if path construction fails (e.g., missing env mapping)
+            return `SSMParameterStoreLoader(${this._config.parameterPath})`;
+        }
+    }
+    /**
+     * 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
+     */
+    async isAvailable() {
+        // Skip in local environment
+        if (this._appEnv === 'local') {
+            return false;
+        }
+        try {
+            // Test AWS credentials by attempting to get caller identity
+            await this._client.config.credentials();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 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
+     */
+    async load() {
+        // Skip loading in local environment
+        if (this._appEnv === 'local') {
+            return {};
+        }
+        const parameterPath = this.buildParameterPath();
+        const result = {};
+        let nextToken;
+        try {
+            do {
+                const command = new client_ssm_1.GetParametersByPathCommand({
+                    Path: parameterPath,
+                    Recursive: true,
+                    WithDecryption: this._config.withDecryption,
+                    NextToken: nextToken,
+                });
+                const response = await this._client.send(command);
+                if (!response.Parameters) {
+                    // No parameters found - this is not necessarily an error
+                    break;
+                }
+                // Process each parameter
+                for (const param of response.Parameters) {
+                    const key = this.transformParameterName(param.Name, parameterPath);
+                    if (key && param.Value !== undefined) {
+                        result[key] = param.Value;
+                    }
+                }
+                nextToken = response.NextToken;
+            } while (nextToken);
+            return result;
+        }
+        catch (error) {
+            // Handle specific AWS errors
+            if (error instanceof Error) {
+                if (error.name === 'ResourceNotFoundException' || error.name === 'ParameterNotFound') {
+                    // No parameters found at path - this is not necessarily an error
+                    return {};
+                }
+                if (error.name === 'AccessDeniedException') {
+                    throw new errors_1.AWSServiceError(`Access denied when retrieving parameters from path '${parameterPath}'. Check AWS credentials and permissions.`, 'SSM', 'GetParametersByPath', error);
+                }
+                if (error.name === 'InvalidFilterKey' || error.name === 'InvalidFilterValue') {
+                    throw new errors_1.AWSServiceError(`Invalid parameter path '${parameterPath}'. Check path format.`, 'SSM', 'GetParametersByPath', error);
+                }
+            }
+            // For other errors, wrap in AWSServiceError
+            throw new errors_1.AWSServiceError(`Failed to retrieve parameters from path '${parameterPath}' in AWS SSM Parameter Store: ${error instanceof Error ? error.message : String(error)}`, 'SSM', 'GetParametersByPath', error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Build the environment-aware parameter path.
+     * @returns The full parameter path with environment prefix
+     * @throws ConfigurationLoadError if no environment mapping found
+     */
+    buildParameterPath() {
+        const envPrefix = this._config.environmentMapping[this._appEnv];
+        if (!envPrefix) {
+            throw new errors_1.ConfigurationLoadError(`No environment mapping found for APP_ENV '${this._appEnv}'. ` +
+                `Available environments: ${Object.keys(this._config.environmentMapping).join(', ')}`, this.getName());
+        }
+        return `/${envPrefix}${this._config.parameterPath}`;
+    }
+    /**
+     * 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
+     */
+    transformParameterName(parameterName, pathPrefix) {
+        if (!parameterName) {
+            return null;
+        }
+        // Remove the path prefix
+        let key = parameterName;
+        if (key.startsWith(pathPrefix)) {
+            key = key.substring(pathPrefix.length);
+        }
+        // Remove leading slash if present
+        if (key.startsWith('/')) {
+            key = key.substring(1);
+        }
+        // Convert slashes to underscores and uppercase
+        key = key.replace(/\//g, '_').toUpperCase();
+        // Return null for empty keys
+        return key || null;
+    }
+    /**
+     * Get the current app environment.
+     * @returns The current APP_ENV or NODE_ENV value
+     */
+    getAppEnv() {
+        return this._appEnv;
+    }
+    /**
+     * Get the environment mapping configuration.
+     * @returns The environment mapping record
+     */
+    getEnvironmentMapping() {
+        return { ...this._config.environmentMapping };
+    }
+}
+exports.SSMParameterStoreLoader = SSMParameterStoreLoader;
+//# sourceMappingURL=ssm-parameter-store.loader.js.map

package/dist/cjs/loaders/ssm-parameter-store.loader.js.map

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

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

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvFileParser = void 0;
+/**
+ * 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
+ */
+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');
+    }
+}
+exports.EnvFileParser = EnvFileParser;
+/** 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/cjs/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,MAAa,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;;AA5FH,sCA6FC;AA5FC,oDAAoD;AAC5B,6BAAe,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO;AAE5D,sFAAsF;AAC9D,mCAAqB,GAAG,0BAA0B,CAAC"}

package/dist/cjs/utils/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvFileParser = exports.ConfigValidationUtil = void 0;
+var validation_util_1 = require("./validation.util");
+Object.defineProperty(exports, "ConfigValidationUtil", { enumerable: true, get: function () { return validation_util_1.ConfigValidationUtil; } });
+var env_file_parser_util_1 = require("./env-file-parser.util");
+Object.defineProperty(exports, "EnvFileParser", { enumerable: true, get: function () { return env_file_parser_util_1.EnvFileParser; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;AAAA,qDAAyD;AAAhD,uHAAA,oBAAoB,OAAA;AAC7B,+DAAuD;AAA9C,qHAAA,aAAa,OAAA"}

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

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigValidationUtil = void 0;
+const errors_1 = require("../errors");
+/**
+ * Framework-agnostic validation utility for configuration values.
+ * Provides methods for validating configuration objects against Zod schemas.
+ */
+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 errors_1.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 errors_1.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 errors_1.ValidationError) {
+                // Enhance the error with source information
+                const enhancedMessage = `Configuration validation failed for source '${source}': ${error.message}`;
+                throw new errors_1.ValidationError(enhancedMessage, error.validationErrors);
+            }
+            throw error;
+        }
+    }
+}
+exports.ConfigValidationUtil = ConfigValidationUtil;
+//# sourceMappingURL=validation.util.js.map

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