@rio-cloud/cdk-v2-constructs 6.12.6 → 6.13.0

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/BaseProvider.d.ts

@@ -0,0 +1,83 @@
+import { EnvironmentVariablesService } from '../config/EnvironmentVariablesService.js';
+import type { BaseProviderInterface, GetMultipleOptionsInterface, GetOptionsInterface } from '../types/BaseProvider.js';
+import { ExpirableValue } from './ExpirableValue.js';
+/**
+ * Base class for all providers.
+ *
+ * As an abstract class, it should not be used directly, but rather extended by other providers.
+ *
+ * It implements the common logic for all providers, such as caching, transformation, etc.
+ * Each provider that extends this class must implement the `_get` and `_getMultiple` abstract methods.
+ *
+ * These methods are responsible for retrieving the values from the underlying parameter store. They are
+ * called by the `get` and `getMultiple` methods, which are responsible for caching and transformation.
+ *
+ * If there are multiple calls to the same parameter but in a different transform, they will be stored multiple times.
+ * This allows us to optimize by transforming the data only once per retrieval, thus there is no need to transform cached values multiple times.
+ *
+ * However, this means that we need to make multiple calls to the underlying parameter store if we need to return it in different transforms.
+ *
+ * Since the number of supported transform is small and the probability that a given parameter will always be used in a specific transform,
+ * this should be an acceptable tradeoff.
+ */
+declare abstract class BaseProvider implements BaseProviderInterface {
+    envVarsService: EnvironmentVariablesService;
+    protected client: unknown;
+    protected store: Map<string, ExpirableValue>;
+    constructor({ awsSdkV3Client, clientConfig, proto, }: {
+        awsSdkV3Client?: unknown;
+        clientConfig?: unknown;
+        proto: new (config?: unknown) => unknown;
+    });
+    /**
+     * Add a value to the cache.
+     *
+     * @param {string} key - Key of the cached value
+     * @param {string | Uint8Array | Record<string, unknown>} value - Value to be cached
+     * @param {number} maxAge - Maximum age in seconds for the value to be cached
+     */
+    addToCache(key: string, value: unknown, maxAge: number): void;
+    /**
+     * Clear the cache.
+     */
+    clearCache(): void;
+    /**
+     * Retrieve a parameter value or return the cached value.
+     *
+     * @param {string} name - Parameter name
+     * @param {GetOptionsInterface} options - Options to configure maximum age, trasformation, AWS SDK options, or force fetch
+     */
+    get(name: string, options?: GetOptionsInterface): Promise<unknown | undefined>;
+    /**
+     * Retrieve multiple parameter values or return the cached values.
+     *
+     * @param {string} path - Parameters path
+     * @param {GetMultipleOptionsInterface} options - Options to configure maximum age, trasformation, AWS SDK options, or force fetch
+     * @returns
+     */
+    getMultiple(path: string, options?: GetMultipleOptionsInterface): Promise<unknown>;
+    /**
+     * Check whether a key has expired in the cache or not.
+     *
+     * It returns true if the key is expired or not present in the cache.
+     *
+     * @param {string} key - Stringified representation of the key to retrieve
+     */
+    hasKeyExpiredInCache(key: string): boolean;
+    /**
+     * Retrieve parameter value from the underlying parameter store.
+     *
+     * @param {string} name - Parameter name
+     * @param {unknown} options - Options to pass to the underlying implemented method
+     */
+    protected abstract _get(name: string, options?: unknown): Promise<unknown>;
+    /**
+     * Retrieve multiple parameter values from the underlying parameter store.
+     *
+     * @param {string} path - Parameter name
+     * @param {unknown} options - Options to pass to the underlying implementated method
+     */
+    protected abstract _getMultiple(path: string, options?: unknown): Promise<Record<string, unknown> | undefined>;
+}
+export { BaseProvider };
+//# sourceMappingURL=BaseProvider.d.ts.map

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/BaseProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseProvider.d.ts","sourceRoot":"","sources":["../../../src/base/BaseProvider.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAEvF,OAAO,KAAK,EACV,qBAAqB,EACrB,2BAA2B,EAC3B,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD;;;;;;;;;;;;;;;;;;GAkBG;AACH,uBAAe,YAAa,YAAW,qBAAqB;IACnD,cAAc,EAAE,2BAA2B,CAAC;IACnD,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;gBAE1B,EACjB,cAAc,EACd,YAAY,EACZ,KAAK,GACN,EAAE;QACD,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,KAAK,EAAE,KAAK,MAAM,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;KAC1C;IAkBD;;;;;;OAMG;IACI,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAMpE;;OAEG;IACI,UAAU,IAAI,IAAI;IAIzB;;;;;OAKG;IACU,GAAG,CACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IA6B/B;;;;;;OAMG;IACU,WAAW,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,OAAO,CAAC;IAiDnB;;;;;;OAMG;IACI,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAOjD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAE1E;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAChD;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/BaseProvider.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseProvider = void 0;
+const commons_1 = require("@aws-lambda-powertools/commons");
+const EnvironmentVariablesService_js_1 = require("../config/EnvironmentVariablesService.js");
+const errors_js_1 = require("../errors.js");
+const ExpirableValue_js_1 = require("./ExpirableValue.js");
+const GetMultipleOptions_js_1 = require("./GetMultipleOptions.js");
+const GetOptions_js_1 = require("./GetOptions.js");
+const transformValue_js_1 = require("./transformValue.js");
+/**
+ * Base class for all providers.
+ *
+ * As an abstract class, it should not be used directly, but rather extended by other providers.
+ *
+ * It implements the common logic for all providers, such as caching, transformation, etc.
+ * Each provider that extends this class must implement the `_get` and `_getMultiple` abstract methods.
+ *
+ * These methods are responsible for retrieving the values from the underlying parameter store. They are
+ * called by the `get` and `getMultiple` methods, which are responsible for caching and transformation.
+ *
+ * If there are multiple calls to the same parameter but in a different transform, they will be stored multiple times.
+ * This allows us to optimize by transforming the data only once per retrieval, thus there is no need to transform cached values multiple times.
+ *
+ * However, this means that we need to make multiple calls to the underlying parameter store if we need to return it in different transforms.
+ *
+ * Since the number of supported transform is small and the probability that a given parameter will always be used in a specific transform,
+ * this should be an acceptable tradeoff.
+ */
+class BaseProvider {
+    envVarsService;
+    client;
+    store;
+    constructor({ awsSdkV3Client, clientConfig, proto, }) {
+        this.store = new Map();
+        this.envVarsService = new EnvironmentVariablesService_js_1.EnvironmentVariablesService();
+        if (awsSdkV3Client) {
+            if (!(0, commons_1.isSdkClient)(awsSdkV3Client)) {
+                console.warn('awsSdkV3Client is not an AWS SDK v3 client, using default client');
+                this.client = new proto(clientConfig ?? {});
+            }
+            else {
+                this.client = awsSdkV3Client;
+            }
+        }
+        else {
+            this.client = new proto(clientConfig ?? {});
+        }
+        (0, commons_1.addUserAgentMiddleware)(this.client, 'parameters');
+    }
+    /**
+     * Add a value to the cache.
+     *
+     * @param {string} key - Key of the cached value
+     * @param {string | Uint8Array | Record<string, unknown>} value - Value to be cached
+     * @param {number} maxAge - Maximum age in seconds for the value to be cached
+     */
+    addToCache(key, value, maxAge) {
+        if (maxAge <= 0)
+            return;
+        this.store.set(key, new ExpirableValue_js_1.ExpirableValue(value, maxAge));
+    }
+    /**
+     * Clear the cache.
+     */
+    clearCache() {
+        this.store.clear();
+    }
+    /**
+     * Retrieve a parameter value or return the cached value.
+     *
+     * @param {string} name - Parameter name
+     * @param {GetOptionsInterface} options - Options to configure maximum age, trasformation, AWS SDK options, or force fetch
+     */
+    async get(name, options) {
+        const configs = new GetOptions_js_1.GetOptions(this.envVarsService, options);
+        const key = [name, configs.transform].toString();
+        if (!configs.forceFetch && !this.hasKeyExpiredInCache(key)) {
+            return this.store.get(key)?.value;
+        }
+        try {
+            let value = await this._get(name, options);
+            if ((0, commons_1.isNullOrUndefined)(value))
+                return undefined;
+            if (configs.transform &&
+                ((0, commons_1.isString)(value) || value instanceof Uint8Array)) {
+                value = (0, transformValue_js_1.transformValue)(value, configs.transform, true, name);
+            }
+            this.addToCache(key, value, configs.maxAge);
+            return value;
+        }
+        catch (error) {
+            if (error instanceof errors_js_1.TransformParameterError)
+                throw error;
+            throw new errors_js_1.GetParameterError(error.message);
+        }
+    }
+    /**
+     * Retrieve multiple parameter values or return the cached values.
+     *
+     * @param {string} path - Parameters path
+     * @param {GetMultipleOptionsInterface} options - Options to configure maximum age, trasformation, AWS SDK options, or force fetch
+     * @returns
+     */
+    async getMultiple(path, options) {
+        const configs = new GetMultipleOptions_js_1.GetMultipleOptions(this.envVarsService, options);
+        const key = [path, configs.transform].toString();
+        if (!configs.forceFetch && !this.hasKeyExpiredInCache(key)) {
+            // biome-ignore lint/style/noNonNullAssertion: If the code enters in this block, then the key must exist & not have been expired
+            return this.store.get(key).value;
+        }
+        let values;
+        try {
+            values = await this._getMultiple(path, options);
+            if (!(0, commons_1.isRecord)(values)) {
+                throw new errors_js_1.GetParameterError(`Expected result to be a Record<string, unknown> but got ${typeof values}`);
+            }
+        }
+        catch (error) {
+            throw new errors_js_1.GetParameterError(error.message);
+        }
+        if (configs.transform) {
+            for (const [entryKey, entryValue] of Object.entries(values)) {
+                if (!((0, commons_1.isString)(entryValue) || entryValue instanceof Uint8Array))
+                    continue;
+                try {
+                    values[entryKey] = (0, transformValue_js_1.transformValue)(entryValue, configs.transform, configs.throwOnTransformError, entryKey);
+                }
+                catch (error) {
+                    if (configs.throwOnTransformError)
+                        throw new errors_js_1.TransformParameterError(configs.transform, error.message);
+                }
+            }
+        }
+        if (Object.keys(values).length !== 0) {
+            this.addToCache(key, values, configs.maxAge);
+        }
+        return values;
+    }
+    /**
+     * Check whether a key has expired in the cache or not.
+     *
+     * It returns true if the key is expired or not present in the cache.
+     *
+     * @param {string} key - Stringified representation of the key to retrieve
+     */
+    hasKeyExpiredInCache(key) {
+        const value = this.store.get(key);
+        if (value)
+            return value.isExpired();
+        return true;
+    }
+}
+exports.BaseProvider = BaseProvider;

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/DefaultProviders.d.ts

@@ -0,0 +1,10 @@
+import type { BaseProviderInterface } from '../types/BaseProvider.js';
+declare const DEFAULT_PROVIDERS: Record<string, BaseProviderInterface>;
+/**
+ * Utility function to clear all the caches of the default providers.
+ *
+ * This is useful when you want to clear the cache of all the providers at once, for example during testing.
+ */
+declare const clearCaches: () => void;
+export { DEFAULT_PROVIDERS, clearCaches };
+//# sourceMappingURL=DefaultProviders.d.ts.map

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/DefaultProviders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultProviders.d.ts","sourceRoot":"","sources":["../../../src/base/DefaultProviders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGtE,QAAA,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAM,CAAC;AAEpE;;;;GAIG;AACH,QAAA,MAAM,WAAW,QAAO,IAMvB,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC"}

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/DefaultProviders.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearCaches = exports.DEFAULT_PROVIDERS = void 0;
+// These providers are dinamycally intialized on first use of the helper functions
+const DEFAULT_PROVIDERS = {};
+exports.DEFAULT_PROVIDERS = DEFAULT_PROVIDERS;
+/**
+ * Utility function to clear all the caches of the default providers.
+ *
+ * This is useful when you want to clear the cache of all the providers at once, for example during testing.
+ */
+const clearCaches = () => {
+    for (const provider of Object.values(DEFAULT_PROVIDERS)) {
+        if (provider.clearCache) {
+            provider.clearCache();
+        }
+    }
+};
+exports.clearCaches = clearCaches;

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/ExpirableValue.d.ts

@@ -0,0 +1,25 @@
+import type { ExpirableValueInterface } from '../types/BaseProvider.js';
+/**
+ * Class to represent a value that can expire.
+ *
+ * Upon creation, the value is assigned a TTL (time to live) that is calculated
+ * by adding the current time with the maximum age.
+ */
+declare class ExpirableValue implements ExpirableValueInterface {
+    ttl: number;
+    value: unknown;
+    /**
+     *
+     * @param value - Value to be cached
+     * @param maxAge - Maximum age in seconds for the value to be cached
+     */
+    constructor(value: unknown, maxAge: number);
+    /**
+     * Check if the value has expired.
+     *
+     * @returns {boolean} - True if the value has expired, false otherwise
+     */
+    isExpired(): boolean;
+}
+export { ExpirableValue };
+//# sourceMappingURL=ExpirableValue.d.ts.map

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/ExpirableValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpirableValue.d.ts","sourceRoot":"","sources":["../../../src/base/ExpirableValue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE;;;;;GAKG;AACH,cAAM,cAAe,YAAW,uBAAuB;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;gBACgB,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;IAMjD;;;;OAIG;IACI,SAAS,IAAI,OAAO;CAG5B;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/ExpirableValue.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpirableValue = void 0;
+/**
+ * Class to represent a value that can expire.
+ *
+ * Upon creation, the value is assigned a TTL (time to live) that is calculated
+ * by adding the current time with the maximum age.
+ */
+class ExpirableValue {
+    ttl;
+    value;
+    /**
+     *
+     * @param value - Value to be cached
+     * @param maxAge - Maximum age in seconds for the value to be cached
+     */
+    constructor(value, maxAge) {
+        this.value = value;
+        const timeNow = new Date();
+        this.ttl = timeNow.setSeconds(timeNow.getSeconds() + maxAge);
+    }
+    /**
+     * Check if the value has expired.
+     *
+     * @returns {boolean} - True if the value has expired, false otherwise
+     */
+    isExpired() {
+        return this.ttl < Date.now();
+    }
+}
+exports.ExpirableValue = ExpirableValue;

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/GetMultipleOptions.d.ts

@@ -0,0 +1,14 @@
+import type { EnvironmentVariablesService } from '../config/EnvironmentVariablesService.js';
+import type { GetMultipleOptionsInterface } from '../types/BaseProvider.js';
+import { GetOptions } from './GetOptions.js';
+/**
+ * Options for the `getMultiple` method.
+ *
+ * Extends the `GetOptions` class and adds the `throwOnTransformError` option.
+ */
+declare class GetMultipleOptions extends GetOptions implements GetMultipleOptionsInterface {
+    throwOnTransformError: boolean;
+    constructor(envVarsService: EnvironmentVariablesService, options?: GetMultipleOptionsInterface);
+}
+export { GetMultipleOptions };
+//# sourceMappingURL=GetMultipleOptions.d.ts.map

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/GetMultipleOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetMultipleOptions.d.ts","sourceRoot":"","sources":["../../../src/base/GetMultipleOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;GAIG;AACH,cAAM,kBACJ,SAAQ,UACR,YAAW,2BAA2B;IAE/B,qBAAqB,UAAS;gBAGnC,cAAc,EAAE,2BAA2B,EAC3C,OAAO,GAAE,2BAAgC;CAQ5C;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/GetMultipleOptions.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetMultipleOptions = void 0;
+const GetOptions_js_1 = require("./GetOptions.js");
+/**
+ * Options for the `getMultiple` method.
+ *
+ * Extends the `GetOptions` class and adds the `throwOnTransformError` option.
+ */
+class GetMultipleOptions extends GetOptions_js_1.GetOptions {
+    throwOnTransformError = false;
+    constructor(envVarsService, options = {}) {
+        super(envVarsService, options);
+        if (options.throwOnTransformError !== undefined) {
+            this.throwOnTransformError = options.throwOnTransformError;
+        }
+    }
+}
+exports.GetMultipleOptions = GetMultipleOptions;

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/GetOptions.d.ts

@@ -0,0 +1,16 @@
+import type { EnvironmentVariablesService } from '../config/EnvironmentVariablesService.js';
+import type { GetOptionsInterface, TransformOptions } from '../types/BaseProvider.js';
+/**
+ * Options for the `get` method.
+ *
+ * It merges the default options with the provided options.
+ */
+declare class GetOptions implements GetOptionsInterface {
+    forceFetch: boolean;
+    maxAge: number;
+    sdkOptions?: unknown;
+    transform?: TransformOptions;
+    constructor(envVarsService: EnvironmentVariablesService, options?: GetOptionsInterface);
+}
+export { GetOptions };
+//# sourceMappingURL=GetOptions.d.ts.map

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/GetOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetOptions.d.ts","sourceRoot":"","sources":["../../../src/base/GetOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAE5F,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAElC;;;;GAIG;AACH,cAAM,UAAW,YAAW,mBAAmB;IACtC,UAAU,UAAS;IACnB,MAAM,EAAG,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,gBAAgB,CAAC;gBAGlC,cAAc,EAAE,2BAA2B,EAC3C,OAAO,GAAE,mBAAwB;CASpC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/GetOptions.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetOptions = void 0;
+const constants_js_1 = require("../constants.js");
+/**
+ * Options for the `get` method.
+ *
+ * It merges the default options with the provided options.
+ */
+class GetOptions {
+    forceFetch = false;
+    maxAge;
+    sdkOptions;
+    transform;
+    constructor(envVarsService, options = {}) {
+        Object.assign(this, options);
+        if (options.maxAge === undefined) {
+            this.maxAge =
+                envVarsService.getParametersMaxAge() ?? constants_js_1.DEFAULT_MAX_AGE_SECS;
+        }
+    }
+}
+exports.GetOptions = GetOptions;

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/index.d.ts

@@ -0,0 +1,5 @@
+export { BaseProvider } from './BaseProvider.js';
+export { DEFAULT_PROVIDERS } from './DefaultProviders.js';
+export { GetOptions } from './GetOptions.js';
+export { GetMultipleOptions } from './GetMultipleOptions.js';
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/base/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetMultipleOptions = exports.GetOptions = exports.DEFAULT_PROVIDERS = exports.BaseProvider = void 0;
+var BaseProvider_js_1 = require("./BaseProvider.js");
+Object.defineProperty(exports, "BaseProvider", { enumerable: true, get: function () { return BaseProvider_js_1.BaseProvider; } });
+var DefaultProviders_js_1 = require("./DefaultProviders.js");
+Object.defineProperty(exports, "DEFAULT_PROVIDERS", { enumerable: true, get: function () { return DefaultProviders_js_1.DEFAULT_PROVIDERS; } });
+var GetOptions_js_1 = require("./GetOptions.js");
+Object.defineProperty(exports, "GetOptions", { enumerable: true, get: function () { return GetOptions_js_1.GetOptions; } });
+var GetMultipleOptions_js_1 = require("./GetMultipleOptions.js");
+Object.defineProperty(exports, "GetMultipleOptions", { enumerable: true, get: function () { return GetMultipleOptions_js_1.GetMultipleOptions; } });

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/transformValue.d.ts

@@ -0,0 +1,28 @@
+import type { JSONValue } from '@aws-lambda-powertools/commons/types';
+import type { TransformOptions } from '../types/BaseProvider.js';
+/**
+ * Utility function to transform a value.
+ *
+ * It supports JSON and binary transformations, as well as an `auto` mode that will try to transform the value based on the key.
+ *
+ * The function supports both `string` and `Uint8Array` values as input. Other types will be returned as-is.
+ *
+ * If the value is a `Uint8Array`, it will be decoded to a string first. Then, when the transform is `json` or `auto` and the key ends with `.json`,
+ * the value will be parsed as JSON using the `JSON.parse` function.
+ *
+ * When the transform is `binary` or `auto` and the key ends with `.binary`, the value will be decoded from base64 using the `fromBase64` function
+ * from the `@aws-lambda-powertools/commons/utils/base64` package.
+ *
+ * If the transformation fails, the function will return the value as-is unless `throwOnTransformError` is set to `true`.
+ *
+ * When using `auto` mode, the key must end with either `.json` or `.binary` to be transformed. Automatic transformation is supported only for
+ * `getMultiple` calls.
+ *
+ * @param {string | Uint8Array} value - Value to be transformed
+ * @param {TransformOptions} transform - Transform to be applied, can be `json`, `binary`, or `auto`
+ * @param {boolean} throwOnTransformError - Whether to throw an error if the transformation fails, when transforming multiple values this can be set to false
+ * @param {string} key - Key of the value to be transformed, used to determine the transformation method when using 'auto'
+ */
+declare const transformValue: (value: string | Uint8Array, transform: TransformOptions, throwOnTransformError: boolean, key: string) => string | JSONValue | Uint8Array | undefined;
+export { transformValue };
+//# sourceMappingURL=transformValue.d.ts.map

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/transformValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformValue.d.ts","sourceRoot":"","sources":["../../../src/base/transformValue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAOtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,QAAA,MAAM,cAAc,UACX,MAAM,GAAG,UAAU,aACf,gBAAgB,yBACJ,OAAO,OACzB,MAAM,KACV,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SA2CpC,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/base/transformValue.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformValue = void 0;
+const commons_1 = require("@aws-lambda-powertools/commons");
+const base64_1 = require("@aws-lambda-powertools/commons/utils/base64");
+const constants_js_1 = require("../constants.js");
+const errors_js_1 = require("../errors.js");
+/**
+ * Utility function to transform a value.
+ *
+ * It supports JSON and binary transformations, as well as an `auto` mode that will try to transform the value based on the key.
+ *
+ * The function supports both `string` and `Uint8Array` values as input. Other types will be returned as-is.
+ *
+ * If the value is a `Uint8Array`, it will be decoded to a string first. Then, when the transform is `json` or `auto` and the key ends with `.json`,
+ * the value will be parsed as JSON using the `JSON.parse` function.
+ *
+ * When the transform is `binary` or `auto` and the key ends with `.binary`, the value will be decoded from base64 using the `fromBase64` function
+ * from the `@aws-lambda-powertools/commons/utils/base64` package.
+ *
+ * If the transformation fails, the function will return the value as-is unless `throwOnTransformError` is set to `true`.
+ *
+ * When using `auto` mode, the key must end with either `.json` or `.binary` to be transformed. Automatic transformation is supported only for
+ * `getMultiple` calls.
+ *
+ * @param {string | Uint8Array} value - Value to be transformed
+ * @param {TransformOptions} transform - Transform to be applied, can be `json`, `binary`, or `auto`
+ * @param {boolean} throwOnTransformError - Whether to throw an error if the transformation fails, when transforming multiple values this can be set to false
+ * @param {string} key - Key of the value to be transformed, used to determine the transformation method when using 'auto'
+ */
+const transformValue = (value, transform, throwOnTransformError, key) => {
+    const normalizedTransform = transform.toLowerCase();
+    const isAutoTransform = normalizedTransform === 'auto';
+    const isAutoJsonTransform = isAutoTransform && key.toLowerCase().endsWith(`.${constants_js_1.TRANSFORM_METHOD_JSON}`);
+    const isAutoBinaryTransform = isAutoTransform &&
+        key.toLowerCase().endsWith(`.${constants_js_1.TRANSFORM_METHOD_BINARY}`);
+    const isJsonTransform = normalizedTransform === constants_js_1.TRANSFORM_METHOD_JSON;
+    const isBinaryTransform = normalizedTransform === constants_js_1.TRANSFORM_METHOD_BINARY;
+    // If the value is not a string or Uint8Array, or if the transform is `auto`
+    // and the key does not end with `.json` or `.binary`, return the value as-is
+    if (!(value instanceof Uint8Array || (0, commons_1.isString)(value)) ||
+        (isAutoTransform && !isAutoJsonTransform && !isAutoBinaryTransform)) {
+        return value;
+    }
+    try {
+        // If the value is a Uint8Array, decode it to a string first
+        const valueToTransform = value instanceof Uint8Array
+            ? new TextDecoder('utf-8').decode(value)
+            : value;
+        // If the transform is `json` or `auto` and the key ends with `.json`, parse the value as JSON
+        if (isJsonTransform || isAutoJsonTransform) {
+            return JSON.parse(valueToTransform);
+            // If the transform is `binary` or `auto` and the key ends with `.binary`, decode the value from base64
+        }
+        if (isBinaryTransform || isAutoBinaryTransform) {
+            return new TextDecoder('utf-8').decode((0, base64_1.fromBase64)(valueToTransform, 'base64'));
+        }
+    }
+    catch (error) {
+        if (throwOnTransformError)
+            throw new errors_js_1.TransformParameterError(transform, error.message);
+        return;
+    }
+};
+exports.transformValue = transformValue;

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/config/EnvironmentVariablesService.d.ts

@@ -0,0 +1,20 @@
+import { EnvironmentVariablesService as CommonEnvironmentVariablesService } from '@aws-lambda-powertools/commons';
+import type { ConfigServiceInterface } from '../types/ConfigServiceInterface.js';
+declare class EnvironmentVariablesService extends CommonEnvironmentVariablesService implements ConfigServiceInterface {
+    private parametersMaxAgeVariable;
+    private ssmDecryptVariable;
+    /**
+     * It returns the value of the POWERTOOLS_PARAMETERS_MAX_AGE environment variable.
+     *
+     * @returns {number|undefined}
+     */
+    getParametersMaxAge(): number | undefined;
+    /**
+     * It returns the value of the POWERTOOLS_PARAMETERS_SSM_DECRYPT environment variable.
+     *
+     * @returns {string}
+     */
+    getSSMDecrypt(): string;
+}
+export { EnvironmentVariablesService };
+//# sourceMappingURL=EnvironmentVariablesService.d.ts.map

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/config/EnvironmentVariablesService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentVariablesService.d.ts","sourceRoot":"","sources":["../../../src/config/EnvironmentVariablesService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,IAAI,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AAElH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEjF,cAAM,2BACJ,SAAQ,iCACR,YAAW,sBAAsB;IAGjC,OAAO,CAAC,wBAAwB,CAAmC;IACnE,OAAO,CAAC,kBAAkB,CAAuC;IAEjE;;;;OAIG;IACI,mBAAmB,IAAI,MAAM,GAAG,SAAS;IAehD;;;;OAIG;IACI,aAAa,IAAI,MAAM;CAG/B;AAED,OAAO,EAAE,2BAA2B,EAAE,CAAC"}

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/config/EnvironmentVariablesService.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvironmentVariablesService = void 0;
+const commons_1 = require("@aws-lambda-powertools/commons");
+const constants_js_1 = require("../constants.js");
+class EnvironmentVariablesService extends commons_1.EnvironmentVariablesService {
+    // Environment variables
+    parametersMaxAgeVariable = 'POWERTOOLS_PARAMETERS_MAX_AGE';
+    ssmDecryptVariable = 'POWERTOOLS_PARAMETERS_SSM_DECRYPT';
+    /**
+     * It returns the value of the POWERTOOLS_PARAMETERS_MAX_AGE environment variable.
+     *
+     * @returns {number|undefined}
+     */
+    getParametersMaxAge() {
+        const maxAge = this.get(this.parametersMaxAgeVariable);
+        if (maxAge.length === 0)
+            return undefined;
+        const maxAgeAsNumber = Number.parseInt(maxAge, 10);
+        if (Number.isNaN(maxAgeAsNumber)) {
+            console.warn(`Invalid value for ${this.parametersMaxAgeVariable} environment variable: [${maxAge}], using default value of ${constants_js_1.DEFAULT_MAX_AGE_SECS} seconds`);
+        }
+        else {
+            return maxAgeAsNumber;
+        }
+    }
+    /**
+     * It returns the value of the POWERTOOLS_PARAMETERS_SSM_DECRYPT environment variable.
+     *
+     * @returns {string}
+     */
+    getSSMDecrypt() {
+        return this.get(this.ssmDecryptVariable);
+    }
+}
+exports.EnvironmentVariablesService = EnvironmentVariablesService;

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/constants.d.ts

@@ -0,0 +1,24 @@
+declare const DEFAULT_MAX_AGE_SECS = 5;
+declare const TRANSFORM_METHOD_JSON = "json";
+declare const TRANSFORM_METHOD_BINARY = "binary";
+declare const TRANSFORM_METHOD_AUTO = "auto";
+declare const APPCONFIG_TOKEN_EXPIRATION: number;
+/**
+ * Transform methods for values retrieved by parameter providers.
+ */
+declare const Transform: {
+    /**
+     * Transform the retrieved value using `JSON.parse`.
+     */
+    readonly JSON: "json";
+    /**
+     * Transform a base64-encoded value from `Uint8Array` to `string`.
+     */
+    readonly BINARY: "binary";
+    /**
+     * Automatically detect the transform method based on the parameter' name suffix.
+     */
+    readonly AUTO: "auto";
+};
+export { APPCONFIG_TOKEN_EXPIRATION, DEFAULT_MAX_AGE_SECS, TRANSFORM_METHOD_JSON, TRANSFORM_METHOD_BINARY, TRANSFORM_METHOD_AUTO, Transform, };
+//# sourceMappingURL=constants.d.ts.map

package/node_modules/@aws-lambda-powertools/parameters/lib/cjs/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,oBAAoB,IAAI,CAAC;AAC/B,QAAA,MAAM,qBAAqB,SAAS,CAAC;AACrC,QAAA,MAAM,uBAAuB,WAAW,CAAC;AACzC,QAAA,MAAM,qBAAqB,SAAS,CAAC;AACrC,QAAA,MAAM,0BAA0B,QAAuC,CAAC;AAExE;;GAEG;AACH,QAAA,MAAM,SAAS;IACb;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;CAEK,CAAC;AAEX,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,SAAS,GACV,CAAC"}