@dyanet/config-aws 1.0.0

package/dist/cjs/interfaces/config-loader.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config-loader.interface.js.map

package/dist/cjs/interfaces/config-loader.interface.js.map

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

package/dist/cjs/interfaces/config-manager.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config-manager.interface.js.map

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

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

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=env-file-loader.interface.js.map

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

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

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=environment-loader.interface.js.map

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

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

package/dist/cjs/interfaces/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=s3-loader.interface.js.map

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

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

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=secrets-manager-loader.interface.js.map

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

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

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ssm-parameter-store-loader.interface.js.map

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

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

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

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

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

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

package/dist/cjs/loaders/environment.loader.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvironmentLoader = void 0;
+/**
+ * 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']
+ * });
+ * ```
+ */
+class EnvironmentLoader {
+    constructor(config = {}) {
+        this._config = config;
+    }
+    getName() {
+        return 'EnvironmentLoader';
+    }
+    async isAvailable() {
+        return true;
+    }
+    /**
+     * 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
+     */
+    async load() {
+        const result = {};
+        const { prefix, exclude = [] } = this._config;
+        const excludeSet = new Set(exclude);
+        for (const [key, value] of Object.entries(process.env)) {
+            // Skip undefined values
+            if (value === undefined) {
+                continue;
+            }
+            // Check exclusion list (against original key)
+            if (excludeSet.has(key)) {
+                continue;
+            }
+            // Handle prefix filtering
+            if (prefix) {
+                if (key.startsWith(prefix)) {
+                    // Strip prefix from key
+                    const strippedKey = key.slice(prefix.length);
+                    // Only include if there's a key remaining after stripping
+                    if (strippedKey) {
+                        result[strippedKey] = value;
+                    }
+                }
+                // Skip keys that don't match the prefix
+            }
+            else {
+                // No prefix - include all non-excluded keys
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+}
+exports.EnvironmentLoader = EnvironmentLoader;
+//# sourceMappingURL=environment.loader.js.map

package/dist/cjs/loaders/environment.loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.loader.js","sourceRoot":"","sources":["../../../src/loaders/environment.loader.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAa,iBAAiB;IAI5B,YAAY,SAAkC,EAAE;QAC9C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,OAAO;QACL,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAEpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,wBAAwB;YACxB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,8CAA8C;YAC9C,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,0BAA0B;YAC1B,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC3B,wBAAwB;oBACxB,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBAC7C,0DAA0D;oBAC1D,IAAI,WAAW,EAAE,CAAC;wBAChB,MAAM,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC;oBAC9B,CAAC;gBACH,CAAC;gBACD,wCAAwC;YAC1C,CAAC;iBAAM,CAAC;gBACN,4CAA4C;gBAC5C,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAhED,8CAgEC"}

package/dist/cjs/loaders/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SSMParameterStoreLoader = exports.SecretsManagerLoader = exports.S3Loader = exports.EnvFileLoader = exports.EnvironmentLoader = void 0;
+var environment_loader_1 = require("./environment.loader");
+Object.defineProperty(exports, "EnvironmentLoader", { enumerable: true, get: function () { return environment_loader_1.EnvironmentLoader; } });
+var env_file_loader_1 = require("./env-file.loader");
+Object.defineProperty(exports, "EnvFileLoader", { enumerable: true, get: function () { return env_file_loader_1.EnvFileLoader; } });
+var s3_loader_1 = require("./s3.loader");
+Object.defineProperty(exports, "S3Loader", { enumerable: true, get: function () { return s3_loader_1.S3Loader; } });
+var secrets_manager_loader_1 = require("./secrets-manager.loader");
+Object.defineProperty(exports, "SecretsManagerLoader", { enumerable: true, get: function () { return secrets_manager_loader_1.SecretsManagerLoader; } });
+var ssm_parameter_store_loader_1 = require("./ssm-parameter-store.loader");
+Object.defineProperty(exports, "SSMParameterStoreLoader", { enumerable: true, get: function () { return ssm_parameter_store_loader_1.SSMParameterStoreLoader; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/loaders/index.ts"],"names":[],"mappings":";;;AAAA,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAC1B,qDAAkD;AAAzC,gHAAA,aAAa,OAAA;AACtB,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AACjB,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA;AAC7B,2EAAuE;AAA9D,qIAAA,uBAAuB,OAAA"}

package/dist/cjs/loaders/s3.loader.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3Loader = void 0;
+const client_s3_1 = require("@aws-sdk/client-s3");
+const credential_providers_1 = require("@aws-sdk/credential-providers");
+const env_file_parser_util_1 = require("../utils/env-file-parser.util");
+const errors_1 = require("../errors");
+/**
+ * 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
+ */
+class S3Loader {
+    constructor(config) {
+        this._config = {
+            bucket: config.bucket,
+            key: config.key,
+            region: config.region || process.env['AWS_REGION'] || 'us-east-1',
+            format: config.format || 'auto',
+        };
+        this._client = new client_s3_1.S3Client({
+            credentials: (0, credential_providers_1.fromNodeProviderChain)(),
+            region: this._config.region,
+        });
+    }
+    getName() {
+        return `S3Loader(s3://${this._config.bucket}/${this._config.key})`;
+    }
+    /**
+     * Check if this loader is available by verifying AWS credentials.
+     * @returns Promise resolving to true if AWS credentials are available
+     */
+    async isAvailable() {
+        try {
+            await this._client.config.credentials();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 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
+     */
+    async load() {
+        try {
+            const command = new client_s3_1.GetObjectCommand({
+                Bucket: this._config.bucket,
+                Key: this._config.key,
+            });
+            const response = await this._client.send(command);
+            if (!response.Body) {
+                return {};
+            }
+            const content = await response.Body.transformToString();
+            if (!content || content.trim() === '') {
+                return {};
+            }
+            return this.parseContent(content);
+        }
+        catch (error) {
+            if (error instanceof errors_1.ConfigurationLoadError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                if (error.name === 'NoSuchKey' || error.name === 'NoSuchBucket') {
+                    // Object or bucket doesn't exist - return empty config
+                    return {};
+                }
+                if (error.name === 'AccessDenied') {
+                    throw new errors_1.AWSServiceError(`Access denied when retrieving s3://${this._config.bucket}/${this._config.key}. Check AWS credentials and permissions.`, 'S3', 'GetObject', error);
+                }
+            }
+            throw new errors_1.AWSServiceError(`Failed to retrieve s3://${this._config.bucket}/${this._config.key}: ${error instanceof Error ? error.message : String(error)}`, 'S3', 'GetObject', error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Parse content based on format setting or auto-detection.
+     * @internal
+     */
+    parseContent(content) {
+        const format = this._config.format === 'auto' ? this.detectFormat(content) : this._config.format;
+        if (format === 'json') {
+            return this.parseJson(content);
+        }
+        else {
+            return env_file_parser_util_1.EnvFileParser.parse(content);
+        }
+    }
+    /**
+     * Detect content format based on structure.
+     * JSON content starts with '{' after trimming whitespace.
+     * @internal
+     */
+    detectFormat(content) {
+        const trimmed = content.trim();
+        if (trimmed.startsWith('{')) {
+            return 'json';
+        }
+        return 'env';
+    }
+    /**
+     * Parse JSON content.
+     * @internal
+     */
+    parseJson(content) {
+        try {
+            const parsed = JSON.parse(content);
+            if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                return parsed;
+            }
+            // If not an object, wrap it
+            return { CONFIG_VALUE: parsed };
+        }
+        catch (error) {
+            throw new errors_1.ConfigurationLoadError(`Failed to parse JSON from s3://${this._config.bucket}/${this._config.key}: ${error instanceof Error ? error.message : String(error)}`, this.getName(), error instanceof Error ? error : undefined);
+        }
+    }
+}
+exports.S3Loader = S3Loader;
+//# sourceMappingURL=s3.loader.js.map

package/dist/cjs/loaders/s3.loader.js.map

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

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

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecretsManagerLoader = void 0;
+const client_secrets_manager_1 = require("@aws-sdk/client-secrets-manager");
+const credential_providers_1 = require("@aws-sdk/credential-providers");
+const errors_1 = require("../errors");
+/**
+ * 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'
+ *   }
+ * });
+ * ```
+ */
+class SecretsManagerLoader {
+    constructor(config = {}) {
+        this._appEnv = process.env['APP_ENV'] || process.env['NODE_ENV'] || 'local';
+        // Set default configuration
+        this._config = {
+            secretName: config.secretName || '/nestjs-config-aws',
+            region: config.region || process.env['AWS_REGION'] || 'us-east-1',
+            environmentMapping: config.environmentMapping || {
+                development: 'dev',
+                test: 'test',
+                production: 'production',
+            },
+        };
+        // Initialize AWS Secrets Manager client
+        this._client = new client_secrets_manager_1.SecretsManagerClient({
+            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 secret path
+     */
+    getName() {
+        const secretName = this.buildSecretName();
+        return `SecretsManagerLoader(${secretName})`;
+    }
+    /**
+     * 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 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
+     */
+    async load() {
+        // Skip loading in local environment
+        if (this._appEnv === 'local') {
+            return {};
+        }
+        const secretName = this.buildSecretName();
+        try {
+            const command = new client_secrets_manager_1.GetSecretValueCommand({ SecretId: secretName });
+            const response = await this._client.send(command);
+            if (!response.SecretString) {
+                return {};
+            }
+            // Try to parse as JSON, fallback to string value
+            try {
+                const parsed = JSON.parse(response.SecretString);
+                // Ensure we return an object for configuration merging
+                if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                    return parsed;
+                }
+                else {
+                    // If it's not an object, wrap it in a configuration object
+                    return { SECRET_VALUE: parsed };
+                }
+            }
+            catch {
+                // If JSON parsing fails, treat as a single string value
+                return { SECRET_VALUE: response.SecretString };
+            }
+        }
+        catch (error) {
+            // Handle specific AWS errors
+            if (error instanceof Error) {
+                if (error.name === 'ResourceNotFoundException') {
+                    // Secret doesn't exist - this is not necessarily an error in all environments
+                    return {};
+                }
+                if (error.name === 'AccessDeniedException') {
+                    throw new errors_1.AWSServiceError(`Access denied when retrieving secret '${secretName}'. Check AWS credentials and permissions.`, 'SecretsManager', 'GetSecretValue', error);
+                }
+                if (error.name === 'InvalidRequestException') {
+                    throw new errors_1.AWSServiceError(`Invalid request when retrieving secret '${secretName}'. Check secret name format.`, 'SecretsManager', 'GetSecretValue', error);
+                }
+            }
+            // For other errors, wrap in AWSServiceError
+            throw new errors_1.AWSServiceError(`Failed to retrieve secret '${secretName}' from AWS Secrets Manager: ${error instanceof Error ? error.message : String(error)}`, 'SecretsManager', 'GetSecretValue', error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Build the environment-aware secret name/path.
+     * @returns The full secret name with environment prefix
+     */
+    buildSecretName() {
+        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.secretName}`;
+    }
+    /**
+     * 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.SecretsManagerLoader = SecretsManagerLoader;
+//# sourceMappingURL=secrets-manager.loader.js.map