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

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;
@@ -961,6 +985,19 @@ const getSecret = async (ssm, config, parameter_, defaultValue) => {
         return defaultValue;
     }
 };
+const getSecureStringParameter = async (ssm, config, parameter_) => {
+    if (config.onlyDefault) {
+        throw new Error(`Cannot retrieve parameter ${parameter_}: getSecureStringParameter has no default value, but onlyDefault is enabled`);
+    }
+    const parameter = await ssm.send(new clientSsm.GetParameterCommand({
+        Name: `${config.prefix ?? ''}${parameter_}`,
+        WithDecryption: true,
+    }));
+    if (parameter?.Parameter?.Value === undefined) {
+        throw new Error(`Could not retrieve parameter ${parameter_} from AWS SSM parameter store`);
+    }
+    return parameter.Parameter.Value;
+};
 const parameterStore = (userConfig) => {
     const { clientConfig, ...config } = {
         ...DEFAULT_CLIENT_CONFIG$1,
@@ -970,6 +1007,7 @@ const parameterStore = (userConfig) => {
     return {
         getSecret: (parameter, defaultValue = '') => getSecret(ssm, config, parameter, defaultValue),
         getSecrets: (parameters, defaultValues = []) => getSecrets(ssm, config, parameters, defaultValues),
+        getSecureStringParameter: (parameter) => getSecureStringParameter(ssm, config, parameter),
     };
 };
 
@@ -1119,6 +1157,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 +1199,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

@@ -7,7 +7,7 @@ import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
 import { DynamoDBDocumentClient, UpdateCommand, ScanCommand, QueryCommand, PutCommand, GetCommand, DeleteCommand, BatchWriteCommand } from '@aws-sdk/lib-dynamodb';
 import Bottleneck from 'bottleneck';
 import { LambdaClient, InvokeCommand } from '@aws-sdk/client-lambda';
-import { SSMClient, GetParametersCommand, GetParameterCommand } from '@aws-sdk/client-ssm';
+import { SSMClient, GetParameterCommand, GetParametersCommand } from '@aws-sdk/client-ssm';
 import { SESv2Client, SendEmailCommand } from '@aws-sdk/client-sesv2';
 import { createTransport } from 'nodemailer';
 import { SQSClient, SendMessageCommand, SendMessageBatchCommand, GetQueueUrlCommand, ReceiveMessageCommand, DeleteMessageCommand } from '@aws-sdk/client-sqs';
@@ -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;
@@ -939,6 +963,19 @@ const getSecret = async (ssm, config, parameter_, defaultValue) => {
         return defaultValue;
     }
 };
+const getSecureStringParameter = async (ssm, config, parameter_) => {
+    if (config.onlyDefault) {
+        throw new Error(`Cannot retrieve parameter ${parameter_}: getSecureStringParameter has no default value, but onlyDefault is enabled`);
+    }
+    const parameter = await ssm.send(new GetParameterCommand({
+        Name: `${config.prefix ?? ''}${parameter_}`,
+        WithDecryption: true,
+    }));
+    if (parameter?.Parameter?.Value === undefined) {
+        throw new Error(`Could not retrieve parameter ${parameter_} from AWS SSM parameter store`);
+    }
+    return parameter.Parameter.Value;
+};
 const parameterStore = (userConfig) => {
     const { clientConfig, ...config } = {
         ...DEFAULT_CLIENT_CONFIG$1,
@@ -948,6 +985,7 @@ const parameterStore = (userConfig) => {
     return {
         getSecret: (parameter, defaultValue = '') => getSecret(ssm, config, parameter, defaultValue),
         getSecrets: (parameters, defaultValues = []) => getSecrets(ssm, config, parameters, defaultValues),
+        getSecureStringParameter: (parameter) => getSecureStringParameter(ssm, config, parameter),
     };
 };
 
@@ -1097,6 +1135,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 +1168,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/aws/index.d.ts

@@ -1,5 +1,5 @@
 export { default as dynamodb, IDynamoDBConfig, IDynamoDBInstance, IUnprocessedItems, TBatchWriteItems, TDeleteItem, TGetItem, TPutItem, TQueryTable, TScanTable, TUpdateItem, } from './dynamodb';
 export { ILambda, ILambdaInstance, default as lambda, TInvokeLambda, } from './lambda';
-export { DEFAULT_CLIENT_CONFIG as DEFAULT_PARAMETER_STORE_CLIENT_CONFIG, IParameterStore, IParameterStoreInstance, default as parameterStore, TGetSecret, TGetSecrets, } from './parameterStore';
+export { DEFAULT_CLIENT_CONFIG as DEFAULT_PARAMETER_STORE_CLIENT_CONFIG, IParameterStore, IParameterStoreInstance, default as parameterStore, TGetSecret, TGetSecrets, TGetSecureStringParameter, } from './parameterStore';
 export { DEFAULT_CLIENT_CONFIG as DEFAULT_SES_CLIENT_CONFIG, IEmailAttachment, IEmailOptions, ISES, ISESInstance, default as ses, TSendMail, } from './ses';
 export { ISQS, ISQSInstance, default as sqs, TDeleteQueueItem, TGetQueueItems, TGetQueueUrl, TSendMessage, } from './sqs';

package/dist/src/aws/parameterStore.d.ts

@@ -13,10 +13,12 @@ interface IParameter {
 }
 export type TGetSecret = (parameter: string, defaultValue?: string) => Promise<string>;
 export type TGetSecrets = (parameters: string[], defaultValues?: IParameter[]) => Promise<IParameter[]>;
+export type TGetSecureStringParameter = (parameter: string) => Promise<string>;
 export declare const DEFAULT_CLIENT_CONFIG: IParameterStore;
 export interface IParameterStoreInstance {
     getSecret: TGetSecret;
     getSecrets: TGetSecrets;
+    getSecureStringParameter: TGetSecureStringParameter;
 }
 declare const parameterStore: (userConfig: IParameterStore) => IParameterStoreInstance;
 export default parameterStore;

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 { 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, TGetSecureStringParameter, 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.1",
   "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"
   },