@allthings/cloud-toolkit 5.0.0 → 5.1.0-beta.2

package/README.md

@@ -30,7 +30,7 @@ Standardizes the setup of aws, Datadog and other things
 | batchWriteItems | table<br/>items                      | Creates multiple item in a defined table                 |
 | deleteItem      | table<br/>key<br/>options (optional) | Deletes database item from defined table by given key    |
 | getItem         | table<br/>key<br/>options (optional) | Returns item from Database by defined table and key      |
-| putItem         | table<br/>key                        | Creates one item in defined table                        |
+| putItem         | table<br/>item                       | Creates one item in defined table                        |
 | queryTable      | table<br/>options (optional)         | Returns result items of query                            |
 | scanTable       | table<br/>options (optional)         | Returns result items of scan                             |
 | updateItem      | table<br/>key<br/>options (optional) | Updates item in database by provided table and given key |
@@ -42,7 +42,7 @@ Standardizes the setup of aws, Datadog and other things
 | deleteQueueItem | queueUrl<br/>receiptHandle                                                      | Deletes item from queue                                  |
 | getQueueItems   | queueUrl<br/>maxNumberOfMessages (optional)                                     | Retrieves items from queue                               |
 | getQueueUrl     | queueName                                                                       | Returns queue url which is needed for all other requests |
-| sendMessage     | queueUrl<br/>message<br/>messageAttributes(optional)<br/>messageDelay(optional) | Creates an item in the queue                             |
+| sendMessage     | queueUrl<br/>message<br/>fifoSettings(optional)<br/>messageAttributes(optional)<br/>messageDelay(optional) | Creates an item in the queue                             |
 
 ### logger
 

package/dist/lib.cjs.js

@@ -703,6 +703,30 @@ const until = async (predicate, transformer, initialValue, iterationCount = 0) =
         ? transformed
         : until(predicate, transformer, transformed, iterationCount + 1);
 };
+const partial = (function_, ...partialArguments) => (...arguments_) => function_(...partialArguments, ...arguments_);
+const times = (function_, n) => Array.from({ length: n }, (_, index) => function_(index, index));
+const deepFlatten = (arrayOfArrays) => arrayOfArrays.reduce((flatArray, currentArray) => [
+    ...flatArray,
+    ...(Array.isArray(currentArray)
+        ?
+            currentArray.some(Array.isArray)
+                ? deepFlatten(currentArray)
+                : currentArray
+        : [currentArray]),
+], []);
+const flatten = (arrayOfArrays, depth = 1) => arrayOfArrays.reduce((flatArray, currentArray) => [
+    ...flatArray,
+    ...(Array.isArray(currentArray)
+        ?
+            currentArray.some(Array.isArray) && depth > 1
+                ? flatten(currentArray, depth - 1)
+                : currentArray
+        : [currentArray]),
+], []);
+const asyncReduce = async (iterable, reducer, initialValue) => iterable.reduce(async (accumulatorPromise, value, index, array) => {
+    const accumulator = await accumulatorPromise;
+    return reducer(accumulator, value, index, array);
+}, Promise.resolve(initialValue));
 
 const DEFAULT_BATCH_ITEMS_MAX_RETRIES = 50;
 let queue;
@@ -943,16 +967,32 @@ const getSecrets = async (ssm, config, parameters_, defaultValues) => {
         return defaultValues;
     }
 };
+const fetchParameterValue = async (ssm, config, parameter_) => {
+    const parameter = await ssm.send(new clientSsm.GetParameterCommand({
+        Name: `${config.prefix ?? ''}${parameter_}`,
+        WithDecryption: true,
+    }));
+    return parameter?.Parameter?.Value;
+};
+const getRequiredSecret = async (ssm, config, parameter_) => {
+    const value = await fetchParameterValue(ssm, config, parameter_);
+    if (value === undefined) {
+        throw new Error(`Could not retrieve parameter ${parameter_} from AWS SSM parameter store`);
+    }
+    return value;
+};
 const getSecret = async (ssm, config, parameter_, defaultValue) => {
+    if (defaultValue === undefined) {
+        if (config.onlyDefault) {
+            throw new Error(`Cannot retrieve parameter ${parameter_}: onlyDefault is enabled and no default value was provided`);
+        }
+        return getRequiredSecret(ssm, config, parameter_);
+    }
     if (config.onlyDefault) {
         return defaultValue;
     }
     try {
-        const parameter = await ssm.send(new clientSsm.GetParameterCommand({
-            Name: `${config.prefix ?? ''}${parameter_}`,
-            WithDecryption: true,
-        }));
-        return parameter?.Parameter?.Value ?? defaultValue;
+        return (await fetchParameterValue(ssm, config, parameter_)) ?? defaultValue;
     }
     catch (error) {
         if (config.logger) {
@@ -968,7 +1008,7 @@ const parameterStore = (userConfig) => {
     };
     const ssm = new clientSsm.SSMClient(clientConfig);
     return {
-        getSecret: (parameter, defaultValue = '') => getSecret(ssm, config, parameter, defaultValue),
+        getSecret: (parameter, defaultValue) => getSecret(ssm, config, parameter, defaultValue),
         getSecrets: (parameters, defaultValues = []) => getSecrets(ssm, config, parameters, defaultValues),
     };
 };
@@ -1119,6 +1159,9 @@ const sqs = (userConfig) => {
     };
 };
 
+const btoa = (stringToEncode) => Buffer.from(stringToEncode).toString('base64');
+const atob = (stringToDecode) => Buffer.from(stringToDecode, 'base64').toString('utf8');
+
 const logger = (config) => {
     const loggerConfig = {
         defaultMeta: {
@@ -1158,9 +1201,18 @@ exports.DEFAULT_PARAMETER_STORE_CLIENT_CONFIG = DEFAULT_CLIENT_CONFIG$1;
 exports.DEFAULT_SES_CLIENT_CONFIG = DEFAULT_CLIENT_CONFIG;
 exports.ServerError = ServerError;
 exports.alagarr = alagarr;
+exports.asyncReduce = asyncReduce;
+exports.atob = atob;
+exports.btoa = btoa;
+exports.deepFlatten = deepFlatten;
 exports.dynamodb = dynamodb;
+exports.flatten = flatten;
 exports.lambda = lambda;
 exports.logger = logger;
 exports.parameterStore = parameterStore;
+exports.partial = partial;
 exports.ses = ses;
+exports.splitEvery = splitEvery;
 exports.sqs = sqs;
+exports.times = times;
+exports.until = until;

package/dist/lib.esm.mjs

@@ -681,6 +681,30 @@ const until = async (predicate, transformer, initialValue, iterationCount = 0) =
         ? transformed
         : until(predicate, transformer, transformed, iterationCount + 1);
 };
+const partial = (function_, ...partialArguments) => (...arguments_) => function_(...partialArguments, ...arguments_);
+const times = (function_, n) => Array.from({ length: n }, (_, index) => function_(index, index));
+const deepFlatten = (arrayOfArrays) => arrayOfArrays.reduce((flatArray, currentArray) => [
+    ...flatArray,
+    ...(Array.isArray(currentArray)
+        ?
+            currentArray.some(Array.isArray)
+                ? deepFlatten(currentArray)
+                : currentArray
+        : [currentArray]),
+], []);
+const flatten = (arrayOfArrays, depth = 1) => arrayOfArrays.reduce((flatArray, currentArray) => [
+    ...flatArray,
+    ...(Array.isArray(currentArray)
+        ?
+            currentArray.some(Array.isArray) && depth > 1
+                ? flatten(currentArray, depth - 1)
+                : currentArray
+        : [currentArray]),
+], []);
+const asyncReduce = async (iterable, reducer, initialValue) => iterable.reduce(async (accumulatorPromise, value, index, array) => {
+    const accumulator = await accumulatorPromise;
+    return reducer(accumulator, value, index, array);
+}, Promise.resolve(initialValue));
 
 const DEFAULT_BATCH_ITEMS_MAX_RETRIES = 50;
 let queue;
@@ -921,16 +945,32 @@ const getSecrets = async (ssm, config, parameters_, defaultValues) => {
         return defaultValues;
     }
 };
+const fetchParameterValue = async (ssm, config, parameter_) => {
+    const parameter = await ssm.send(new GetParameterCommand({
+        Name: `${config.prefix ?? ''}${parameter_}`,
+        WithDecryption: true,
+    }));
+    return parameter?.Parameter?.Value;
+};
+const getRequiredSecret = async (ssm, config, parameter_) => {
+    const value = await fetchParameterValue(ssm, config, parameter_);
+    if (value === undefined) {
+        throw new Error(`Could not retrieve parameter ${parameter_} from AWS SSM parameter store`);
+    }
+    return value;
+};
 const getSecret = async (ssm, config, parameter_, defaultValue) => {
+    if (defaultValue === undefined) {
+        if (config.onlyDefault) {
+            throw new Error(`Cannot retrieve parameter ${parameter_}: onlyDefault is enabled and no default value was provided`);
+        }
+        return getRequiredSecret(ssm, config, parameter_);
+    }
     if (config.onlyDefault) {
         return defaultValue;
     }
     try {
-        const parameter = await ssm.send(new GetParameterCommand({
-            Name: `${config.prefix ?? ''}${parameter_}`,
-            WithDecryption: true,
-        }));
-        return parameter?.Parameter?.Value ?? defaultValue;
+        return (await fetchParameterValue(ssm, config, parameter_)) ?? defaultValue;
     }
     catch (error) {
         if (config.logger) {
@@ -946,7 +986,7 @@ const parameterStore = (userConfig) => {
     };
     const ssm = new SSMClient(clientConfig);
     return {
-        getSecret: (parameter, defaultValue = '') => getSecret(ssm, config, parameter, defaultValue),
+        getSecret: (parameter, defaultValue) => getSecret(ssm, config, parameter, defaultValue),
         getSecrets: (parameters, defaultValues = []) => getSecrets(ssm, config, parameters, defaultValues),
     };
 };
@@ -1097,6 +1137,9 @@ const sqs = (userConfig) => {
     };
 };
 
+const btoa = (stringToEncode) => Buffer.from(stringToEncode).toString('base64');
+const atob = (stringToDecode) => Buffer.from(stringToDecode, 'base64').toString('utf8');
+
 const logger = (config) => {
     const loggerConfig = {
         defaultMeta: {
@@ -1127,4 +1170,4 @@ const logger = (config) => {
     });
 };
 
-export { ClientError, DEFAULT_CLIENT_CONFIG$1 as DEFAULT_PARAMETER_STORE_CLIENT_CONFIG, DEFAULT_CLIENT_CONFIG as DEFAULT_SES_CLIENT_CONFIG, ServerError, alagarr, dynamodb, lambda, logger, parameterStore, ses, sqs };
+export { ClientError, DEFAULT_CLIENT_CONFIG$1 as DEFAULT_PARAMETER_STORE_CLIENT_CONFIG, DEFAULT_CLIENT_CONFIG as DEFAULT_SES_CLIENT_CONFIG, ServerError, alagarr, asyncReduce, atob, btoa, deepFlatten, dynamodb, flatten, lambda, logger, parameterStore, partial, ses, splitEvery, sqs, times, until };

package/dist/src/base64.d.ts

@@ -0,0 +1,2 @@
+export declare const btoa: (stringToEncode: string) => string;
+export declare const atob: (stringToDecode: string) => string;

package/dist/src/index.d.ts

@@ -1,5 +1,7 @@
 export { Alagarr, default as alagarr, ClientError, HandlerFunction, IInterfaceAlagarrOptions, IInterfaceHeaders, IInterfaceQueryParameters, IInterfaceRequest, IInterfaceResponse, ServerError, } from './alagarr';
 export { DEFAULT_PARAMETER_STORE_CLIENT_CONFIG, DEFAULT_SES_CLIENT_CONFIG, dynamodb, IDynamoDBConfig, IDynamoDBInstance, IEmailAttachment, IEmailOptions, ILambda, ILambdaInstance, IParameterStore, IParameterStoreInstance, ISES, ISESInstance, ISQS, ISQSInstance, IUnprocessedItems, lambda, parameterStore, ses, sqs, TBatchWriteItems, TDeleteItem, TDeleteQueueItem, TGetItem, TGetQueueItems, TGetQueueUrl, TGetSecret, TGetSecrets, TInvokeLambda, TPutItem, TQueryTable, TScanTable, TSendMail, TSendMessage, TUpdateItem, } from './aws';
+export { atob, btoa } from './base64';
 export { default as logger } from './logger/logger';
+export { asyncReduce, deepFlatten, flatten, List, partial, splitEvery, times, until, } from './utils';
 export type { APIGatewayEvent, APIGatewayProxyEventV2, Context, } from 'aws-lambda';
 export { Logger } from 'winston';

package/dist/src/utils.d.ts

@@ -1,2 +1,8 @@
+export type List<T> = readonly T[];
 export declare const splitEvery: <T>(every: number, list: readonly T[]) => T[][];
 export declare const until: <A, B>(predicate: (value: B, iteration: number) => boolean | Promise<boolean>, transformer: (value: A | B | undefined, iteration: number) => B | Promise<B>, initialValue?: A | B, iterationCount?: number) => Promise<B>;
+export declare const partial: (function_: (...arguments_: any[]) => any | Promise<any>, ...partialArguments: any[]) => (...arguments_: any[]) => any;
+export declare const times: <T>(function_: (item: number, index: number) => T, n: number) => List<T>;
+export declare const deepFlatten: <T>(arrayOfArrays: readonly (readonly T[])[]) => readonly T[];
+export declare const flatten: <T>(arrayOfArrays: readonly (readonly T[])[], depth?: number) => readonly T[];
+export declare const asyncReduce: <I, O>(iterable: List<I>, reducer: (previousValue: O, currentValue: I, currentIndex: number, iterable: List<I>) => Promise<O>, initialValue: O) => Promise<O>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allthings/cloud-toolkit",
-  "version": "5.0.0",
+  "version": "5.1.0-beta.2",
   "description": "",
   "author": "Allthings GmbH",
   "keywords": [
@@ -17,7 +17,7 @@
     "node": ">=24",
     "npm": ">=10"
   },
-  "packageManager": "yarn@4.17.1",
+  "packageManager": "yarn@4.18.0",
   "main": "dist/lib.cjs.js",
   "module": "dist/lib.esm.mjs",
   "types": "dist/src/index.d.ts",
@@ -76,22 +76,22 @@
     "winston": "^3.19.0"
   },
   "devDependencies": {
-    "@allthings/eslint-config": "5.1.3",
-    "@commitlint/cli": "21.2.1",
-    "@commitlint/config-conventional": "21.2.0",
+    "@allthings/eslint-config": "5.2.0",
+    "@commitlint/cli": "21.2.2",
+    "@commitlint/config-conventional": "21.2.2",
     "@rollup/plugin-node-resolve": "16.0.3",
     "@types/node": "24.13.3",
     "@types/nodemailer": "8.0.1",
     "@vitest/coverage-v8": "4.1.10",
     "aws-sdk-client-mock": "4.1.0",
     "conventional-changelog-conventionalcommits": "9.3.1",
-    "eslint": "10.7.0",
+    "eslint": "10.8.1",
     "husky": "9.1.7",
-    "lint-staged": "17.1.0",
-    "prettier": "3.9.5",
+    "lint-staged": "17.3.0",
+    "prettier": "3.9.6",
     "rimraf": "6.1.3",
-    "rollup": "4.62.2",
-    "semantic-release": "25.0.8",
+    "rollup": "4.62.4",
+    "semantic-release": "25.0.9",
     "typescript": "6.0.3",
     "vitest": "4.1.10"
   },