quidproquo-actionprocessor-awslambda 0.1.10 → 0.1.12

package/lib/commonjs/logic/createAwsClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"createAwsClient.js","sourceRoot":"","sources":["../../../src/logic/createAwsClient.ts"],"names":[],"mappings":";;;;;;;;;;;AAIA,0CAoCC;AAtCD,MAAM,KAAK,GAAG,IAAI,OAAO,EAA4C,CAAC;AAEtE,SAAgB,eAAe,CAAI,WAAiC,EAAE,IAAS;IAC7E,4CAA4C;IAC5C,IAAI,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,mCAAmC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAErC,oDAAoD;IACpD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,WAAW,CAAC,IAAI,CAErC,CAAC;QAEF,sFAAsF;QACtF,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACzC,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,CAAC;YACpC,SAAS,CAAC,IAAI,GAAG,UAAgB,GAAG,QAAe;;oBACjD,IAAI,CAAC;wBACH,OAAO,MAAM,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;oBAClD,CAAC;oBAAC,OAAO,KAAU,EAAE,CAAC;wBACpB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;wBACnG,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC;aAAA,CAAC;QACJ,CAAC;QAED,kDAAkD;QAClD,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,6BAA6B;IAC7B,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;AACjC,CAAC","sourcesContent":["type ClientConstructor<T> = new (args: any) => T;\n\nconst cache = new WeakMap<ClientConstructor<any>, Map<string, any>>();\n\nexport function createAwsClient<T>(ClientClass: ClientConstructor<T>, args: any): T {\n  // Get or create the Map for the ClientClass\n  let argsCache = cache.get(ClientClass);\n  if (!argsCache) {\n    argsCache = new Map();\n    cache.set(ClientClass, argsCache);\n  }\n\n  // Generate a key for the arguments\n  const argsKey = JSON.stringify(args);\n\n  // Check if the instance already exists in the cache\n  if (!argsCache.has(argsKey)) {\n    const newClient = new ClientClass(args) as {\n      send?: (...args: any[]) => any;\n    };\n\n    // If the send method exists, wrap it with error handling so we can see it in the logs\n    if (typeof newClient.send === 'function') {\n      const originalSend = newClient.send;\n      newClient.send = async function (...sendArgs: any[]) {\n        try {\n          return await originalSend.apply(this, sendArgs);\n        } catch (error: any) {\n          console.log(ClientClass.name || 'aws client', args, 'send args', sendArgs, 'error', error.message);\n          throw error;\n        }\n      };\n    }\n\n    // Create a new instance and store it in the cache\n    argsCache.set(argsKey, newClient);\n  }\n\n  // Return the cached instance\n  return argsCache.get(argsKey)!;\n}\n"]}
+{"version":3,"file":"createAwsClient.js","sourceRoot":"","sources":["../../../src/logic/createAwsClient.ts"],"names":[],"mappings":";;;;;;;;;;;AAiBA,0CA4BC;AArCD,sFAAsF;AACtF,yFAAyF;AACzF,MAAM,KAAK,GAAG,IAAI,OAAO,EAA8C,CAAC;AAExE;;;;GAIG;AACH,SAAgB,eAAe,CAAU,WAAuC,EAAE,IAAY;IAC5F,IAAI,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAErC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,WAAW,CAAC,IAAI,CAAiB,CAAC;QAExD,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACzC,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,CAAC;YACpC,SAAS,CAAC,IAAI,GAAG,UAAgB,GAAG,QAAmB;;oBACrD,IAAI,CAAC;wBACH,OAAO,MAAM,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;oBAClD,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;wBAC9G,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC;aAAA,CAAC;QACJ,CAAC;QAED,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAY,CAAC;AAC3C,CAAC","sourcesContent":["// AWS SDK client constructors vary in config type and optionality (some take an optional\n// config); `any` here is the variance boundary that lets one helper accept them all.\ntype AnyClientConstructor = new (args: any) => unknown;\n\ntype CachedClient = {\n  send?: (...sendArgs: unknown[]) => Promise<unknown>;\n};\n\n// One client instance per (client class, config) pair, reused across invocations in a\n// warm lambda container so connection pools and SDK middleware are not rebuilt per call.\nconst cache = new WeakMap<AnyClientConstructor, Map<string, unknown>>();\n\n/**\n * Returns a cached AWS SDK v3 client for the given class and config, creating it on first\n * use. The client's `send` is wrapped so failed calls log the client, config, and command\n * before rethrowing (CloudWatch visibility for which AWS call failed and why).\n */\nexport function createAwsClient<TClient>(ClientClass: new (args: any) => TClient, args: object): TClient {\n  let argsCache = cache.get(ClientClass);\n  if (!argsCache) {\n    argsCache = new Map();\n    cache.set(ClientClass, argsCache);\n  }\n\n  const argsKey = JSON.stringify(args);\n\n  if (!argsCache.has(argsKey)) {\n    const newClient = new ClientClass(args) as CachedClient;\n\n    if (typeof newClient.send === 'function') {\n      const originalSend = newClient.send;\n      newClient.send = async function (...sendArgs: unknown[]) {\n        try {\n          return await originalSend.apply(this, sendArgs);\n        } catch (error) {\n          console.log(ClientClass.name || 'aws client', args, 'send args', sendArgs, 'error', (error as Error).message);\n          throw error;\n        }\n      };\n    }\n\n    argsCache.set(argsKey, newClient);\n  }\n\n  return argsCache.get(argsKey) as TClient;\n}\n"]}

package/lib/commonjs/logic/dynamo/convertDynamoMapToObject.d.ts

@@ -0,0 +1,7 @@
+import { AttributeValue } from '@aws-sdk/client-dynamodb';
+/**
+ * Unmarshal a DynamoDB attribute map back into a plain js object. Supports
+ * the types buildAttributeValue can produce (S, N, BOOL, NULL, L, M) and
+ * throws on anything else. A missing map unmarshals to an empty object.
+ */
+export declare function convertDynamoMapToObject(dynamoMap?: Record<string, AttributeValue>): Record<string, unknown>;

package/lib/commonjs/logic/dynamo/convertDynamoMapToObject.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertDynamoMapToObject = convertDynamoMapToObject;
+const convertDynamoAttributeToValue = (value) => {
+    const valueType = Object.keys(value)[0];
+    switch (valueType) {
+        case 'S':
+            return value.S;
+        case 'N':
+            return parseFloat(value.N);
+        case 'BOOL':
+            return value.BOOL;
+        case 'NULL':
+            return null;
+        case 'L':
+            return value.L.map((item) => convertDynamoAttributeToValue(item));
+        case 'M':
+            return convertDynamoMapToObject(value.M);
+        default:
+            throw new Error(`Unsupported DynamoDB data type: ${valueType}`);
+    }
+};
+/**
+ * Unmarshal a DynamoDB attribute map back into a plain js object. Supports
+ * the types buildAttributeValue can produce (S, N, BOOL, NULL, L, M) and
+ * throws on anything else. A missing map unmarshals to an empty object.
+ */
+function convertDynamoMapToObject(dynamoMap) {
+    const obj = {};
+    for (const property in dynamoMap) {
+        obj[property] = convertDynamoAttributeToValue(dynamoMap[property]);
+    }
+    return obj;
+}
+//# sourceMappingURL=convertDynamoMapToObject.js.map

package/lib/commonjs/logic/dynamo/convertDynamoMapToObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertDynamoMapToObject.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/convertDynamoMapToObject.ts"],"names":[],"mappings":";;AA4BA,4DAQC;AAlCD,MAAM,6BAA6B,GAAG,CAAC,KAAqB,EAAW,EAAE;IACvE,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAExC,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,GAAG;YACN,OAAO,KAAK,CAAC,CAAC,CAAC;QACjB,KAAK,GAAG;YACN,OAAO,UAAU,CAAC,KAAK,CAAC,CAAE,CAAC,CAAC;QAC9B,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,IAAI,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd,KAAK,GAAG;YACN,OAAO,KAAK,CAAC,CAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,6BAA6B,CAAC,IAAI,CAAC,CAAC,CAAC;QACrE,KAAK,GAAG;YACN,OAAO,wBAAwB,CAAC,KAAK,CAAC,CAAE,CAAC,CAAC;QAC5C;YACE,MAAM,IAAI,KAAK,CAAC,mCAAmC,SAAS,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,SAAgB,wBAAwB,CAAC,SAA0C;IACjF,MAAM,GAAG,GAA4B,EAAE,CAAC;IAExC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,GAAG,CAAC,QAAQ,CAAC,GAAG,6BAA6B,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["import { AttributeValue } from '@aws-sdk/client-dynamodb';\n\nconst convertDynamoAttributeToValue = (value: AttributeValue): unknown => {\n  const valueType = Object.keys(value)[0];\n\n  switch (valueType) {\n    case 'S':\n      return value.S;\n    case 'N':\n      return parseFloat(value.N!);\n    case 'BOOL':\n      return value.BOOL;\n    case 'NULL':\n      return null;\n    case 'L':\n      return value.L!.map((item) => convertDynamoAttributeToValue(item));\n    case 'M':\n      return convertDynamoMapToObject(value.M!);\n    default:\n      throw new Error(`Unsupported DynamoDB data type: ${valueType}`);\n  }\n};\n\n/**\n * Unmarshal a DynamoDB attribute map back into a plain js object. Supports\n * the types buildAttributeValue can produce (S, N, BOOL, NULL, L, M) and\n * throws on anything else. A missing map unmarshals to an empty object.\n */\nexport function convertDynamoMapToObject(dynamoMap?: Record<string, AttributeValue>): Record<string, unknown> {\n  const obj: Record<string, unknown> = {};\n\n  for (const property in dynamoMap) {\n    obj[property] = convertDynamoAttributeToValue(dynamoMap[property]);\n  }\n\n  return obj;\n}\n"]}

package/lib/commonjs/logic/dynamo/deleteItem.js

@@ -12,20 +12,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.deleteItem = deleteItem;
 const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
 const createAwsClient_1 = require("../createAwsClient");
-const qpqDynamoOrm_1 = require("./qpqDynamoOrm");
+const buildDynamoKey_1 = require("./utils/buildDynamoKey");
 function deleteItem(tableName, region, key, keyName, sortKey, sortKeyName) {
     return __awaiter(this, void 0, void 0, function* () {
         const dynamoDBClient = (0, createAwsClient_1.createAwsClient)(client_dynamodb_1.DynamoDBClient, { region });
-        const deleteItemParams = {
+        yield dynamoDBClient.send(new client_dynamodb_1.DeleteItemCommand({
             TableName: tableName,
-            Key: {
-                [keyName]: (0, qpqDynamoOrm_1.buildAttributeValue)(key),
-            },
-        };
-        if (sortKey && sortKeyName) {
-            deleteItemParams.Key[sortKeyName] = (0, qpqDynamoOrm_1.buildAttributeValue)(sortKey);
-        }
-        yield dynamoDBClient.send(new client_dynamodb_1.DeleteItemCommand(deleteItemParams));
+            Key: (0, buildDynamoKey_1.buildDynamoKey)(keyName, key, sortKeyName, sortKey),
+        }));
     });
 }
 //# sourceMappingURL=deleteItem.js.map

package/lib/commonjs/logic/dynamo/deleteItem.js.map

@@ -1 +1 @@
-{"version":3,"file":"deleteItem.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/deleteItem.ts"],"names":[],"mappings":";;;;;;;;;;;AAOA,gCAsBC;AA3BD,8DAAqG;AAErG,wDAAqD;AACrD,iDAAqD;AAErD,SAAsB,UAAU,CAC9B,SAAiB,EACjB,MAAc,EACd,GAAoB,EACpB,OAAe,EACf,OAAyB,EACzB,WAAoB;;QAEpB,MAAM,cAAc,GAAG,IAAA,iCAAe,EAAC,gCAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnE,MAAM,gBAAgB,GAA2B;YAC/C,SAAS,EAAE,SAAS;YACpB,GAAG,EAAE;gBACH,CAAC,OAAO,CAAC,EAAE,IAAA,kCAAmB,EAAC,GAAG,CAAC;aACpC;SACF,CAAC;QAEF,IAAI,OAAO,IAAI,WAAW,EAAE,CAAC;YAC3B,gBAAgB,CAAC,GAAI,CAAC,WAAW,CAAC,GAAG,IAAA,kCAAmB,EAAC,OAAO,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,mCAAiB,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACrE,CAAC;CAAA","sourcesContent":["import { KvsCoreDataType } from 'quidproquo-core';\n\nimport { DeleteItemCommand, DeleteItemCommandInput, DynamoDBClient } from '@aws-sdk/client-dynamodb';\n\nimport { createAwsClient } from '../createAwsClient';\nimport { buildAttributeValue } from './qpqDynamoOrm';\n\nexport async function deleteItem(\n  tableName: string,\n  region: string,\n  key: KvsCoreDataType,\n  keyName: string,\n  sortKey?: KvsCoreDataType,\n  sortKeyName?: string,\n): Promise<void> {\n  const dynamoDBClient = createAwsClient(DynamoDBClient, { region });\n\n  const deleteItemParams: DeleteItemCommandInput = {\n    TableName: tableName,\n    Key: {\n      [keyName]: buildAttributeValue(key),\n    },\n  };\n\n  if (sortKey && sortKeyName) {\n    deleteItemParams.Key![sortKeyName] = buildAttributeValue(sortKey);\n  }\n\n  await dynamoDBClient.send(new DeleteItemCommand(deleteItemParams));\n}\n"]}
+{"version":3,"file":"deleteItem.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/deleteItem.ts"],"names":[],"mappings":";;;;;;;;;;;AAOA,gCAgBC;AArBD,8DAA6E;AAE7E,wDAAqD;AACrD,2DAAwD;AAExD,SAAsB,UAAU,CAC9B,SAAiB,EACjB,MAAc,EACd,GAAoB,EACpB,OAAe,EACf,OAAyB,EACzB,WAAoB;;QAEpB,MAAM,cAAc,GAAG,IAAA,iCAAe,EAAC,gCAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnE,MAAM,cAAc,CAAC,IAAI,CACvB,IAAI,mCAAiB,CAAC;YACpB,SAAS,EAAE,SAAS;YACpB,GAAG,EAAE,IAAA,+BAAc,EAAC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC;SACxD,CAAC,CACH,CAAC;IACJ,CAAC;CAAA","sourcesContent":["import { KvsCoreDataType } from 'quidproquo-core';\n\nimport { DeleteItemCommand, DynamoDBClient } from '@aws-sdk/client-dynamodb';\n\nimport { createAwsClient } from '../createAwsClient';\nimport { buildDynamoKey } from './utils/buildDynamoKey';\n\nexport async function deleteItem(\n  tableName: string,\n  region: string,\n  key: KvsCoreDataType,\n  keyName: string,\n  sortKey?: KvsCoreDataType,\n  sortKeyName?: string,\n): Promise<void> {\n  const dynamoDBClient = createAwsClient(DynamoDBClient, { region });\n\n  await dynamoDBClient.send(\n    new DeleteItemCommand({\n      TableName: tableName,\n      Key: buildDynamoKey(keyName, key, sortKeyName, sortKey),\n    }),\n  );\n}\n"]}

package/lib/commonjs/logic/dynamo/getAllItems.d.ts

@@ -1,2 +1,3 @@
 import { KvsQueryOperation } from 'quidproquo-core';
-export declare function getAllItems(tableName: string, region: string, filterExpression?: KvsQueryOperation): Promise<any[]>;
+/** Scan every page of the table, optionally filtered, and return all items. */
+export declare function getAllItems(tableName: string, region: string, filterExpression?: KvsQueryOperation): Promise<Record<string, unknown>[]>;

package/lib/commonjs/logic/dynamo/getAllItems.js

@@ -12,8 +12,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAllItems = getAllItems;
 const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
 const createAwsClient_1 = require("../createAwsClient");
-const convertObjectToDynamoMap_1 = require("./convertObjectToDynamoMap");
+const convertDynamoMapToObject_1 = require("./convertDynamoMapToObject");
 const qpqDynamoOrm_1 = require("./qpqDynamoOrm");
+/** Scan every page of the table, optionally filtered, and return all items. */
 function getAllItems(tableName, region, filterExpression) {
     return __awaiter(this, void 0, void 0, function* () {
         const dynamoDBClient = (0, createAwsClient_1.createAwsClient)(client_dynamodb_1.DynamoDBClient, { region });
@@ -27,15 +28,9 @@ function getAllItems(tableName, region, filterExpression) {
                 ExpressionAttributeNames: filterExpression && (0, qpqDynamoOrm_1.buildExpressionAttributeNames)([filterExpression]),
                 ExclusiveStartKey: lastEvaluatedKey,
             };
-            try {
-                const result = yield dynamoDBClient.send(new client_dynamodb_1.ScanCommand(scanParams));
-                records = records.concat((result.Items || []).map((item) => (0, convertObjectToDynamoMap_1.convertDynamoMapToObject)(item)));
-                lastEvaluatedKey = result.LastEvaluatedKey;
-            }
-            catch (error) {
-                console.error('Error scanning DynamoDB table:', error);
-                throw error;
-            }
+            const result = yield dynamoDBClient.send(new client_dynamodb_1.ScanCommand(scanParams));
+            records = records.concat((result.Items || []).map((item) => (0, convertDynamoMapToObject_1.convertDynamoMapToObject)(item)));
+            lastEvaluatedKey = result.LastEvaluatedKey;
         } while (lastEvaluatedKey);
         return records;
     });

package/lib/commonjs/logic/dynamo/getAllItems.js.map

@@ -1 +1 @@
-{"version":3,"file":"getAllItems.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/getAllItems.ts"],"names":[],"mappings":";;;;;;;;;;;AAQA,kCA0BC;AAhCD,8DAAyF;AAEzF,wDAAqD;AACrD,yEAAsE;AACtE,iDAA2H;AAE3H,SAAsB,WAAW,CAAC,SAAiB,EAAE,MAAc,EAAE,gBAAoC;;QACvG,MAAM,cAAc,GAAG,IAAA,iCAAe,EAAC,gCAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnE,IAAI,OAAO,GAAU,EAAE,CAAC;QACxB,IAAI,gBAAoD,CAAC;QAEzD,GAAG,CAAC;YACF,MAAM,UAAU,GAAqB;gBACnC,SAAS,EAAE,SAAS;gBACpB,gBAAgB,EAAE,IAAA,yCAA0B,EAAC,gBAAgB,CAAC;gBAC9D,yBAAyB,EAAE,gBAAgB,IAAI,IAAA,6CAA8B,EAAC,CAAC,gBAAgB,CAAC,CAAC;gBACjG,wBAAwB,EAAE,gBAAgB,IAAI,IAAA,4CAA6B,EAAC,CAAC,gBAAgB,CAAC,CAAC;gBAC/F,iBAAiB,EAAE,gBAAgB;aACpC,CAAC;YAEF,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,6BAAW,CAAC,UAAU,CAAC,CAAC,CAAC;gBACtE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,mDAAwB,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC7F,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;YAC7C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;gBACvD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,QAAQ,gBAAgB,EAAE;QAE3B,OAAO,OAAO,CAAC;IACjB,CAAC;CAAA","sourcesContent":["import { KvsQueryOperation } from 'quidproquo-core';\n\nimport { DynamoDBClient, ScanCommand, ScanCommandInput } from '@aws-sdk/client-dynamodb';\n\nimport { createAwsClient } from '../createAwsClient';\nimport { convertDynamoMapToObject } from './convertObjectToDynamoMap';\nimport { buildDynamoQueryExpression, buildExpressionAttributeNames, buildExpressionAttributeValues } from './qpqDynamoOrm';\n\nexport async function getAllItems(tableName: string, region: string, filterExpression?: KvsQueryOperation): Promise<any[]> {\n  const dynamoDBClient = createAwsClient(DynamoDBClient, { region });\n\n  let records: any[] = [];\n  let lastEvaluatedKey: { [key: string]: any } | undefined;\n\n  do {\n    const scanParams: ScanCommandInput = {\n      TableName: tableName,\n      FilterExpression: buildDynamoQueryExpression(filterExpression),\n      ExpressionAttributeValues: filterExpression && buildExpressionAttributeValues([filterExpression]),\n      ExpressionAttributeNames: filterExpression && buildExpressionAttributeNames([filterExpression]),\n      ExclusiveStartKey: lastEvaluatedKey,\n    };\n\n    try {\n      const result = await dynamoDBClient.send(new ScanCommand(scanParams));\n      records = records.concat((result.Items || []).map((item) => convertDynamoMapToObject(item)));\n      lastEvaluatedKey = result.LastEvaluatedKey;\n    } catch (error) {\n      console.error('Error scanning DynamoDB table:', error);\n      throw error;\n    }\n  } while (lastEvaluatedKey);\n\n  return records;\n}\n"]}
+{"version":3,"file":"getAllItems.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/getAllItems.ts"],"names":[],"mappings":";;;;;;;;;;;AASA,kCAsBC;AA7BD,8DAAyG;AAEzG,wDAAqD;AACrD,yEAAsE;AACtE,iDAA2H;AAE3H,+EAA+E;AAC/E,SAAsB,WAAW,CAAC,SAAiB,EAAE,MAAc,EAAE,gBAAoC;;QACvG,MAAM,cAAc,GAAG,IAAA,iCAAe,EAAC,gCAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnE,IAAI,OAAO,GAA8B,EAAE,CAAC;QAC5C,IAAI,gBAA4D,CAAC;QAEjE,GAAG,CAAC;YACF,MAAM,UAAU,GAAqB;gBACnC,SAAS,EAAE,SAAS;gBACpB,gBAAgB,EAAE,IAAA,yCAA0B,EAAC,gBAAgB,CAAC;gBAC9D,yBAAyB,EAAE,gBAAgB,IAAI,IAAA,6CAA8B,EAAC,CAAC,gBAAgB,CAAC,CAAC;gBACjG,wBAAwB,EAAE,gBAAgB,IAAI,IAAA,4CAA6B,EAAC,CAAC,gBAAgB,CAAC,CAAC;gBAC/F,iBAAiB,EAAE,gBAAgB;aACpC,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,6BAAW,CAAC,UAAU,CAAC,CAAC,CAAC;YAEtE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,mDAAwB,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC7F,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;QAC7C,CAAC,QAAQ,gBAAgB,EAAE;QAE3B,OAAO,OAAO,CAAC;IACjB,CAAC;CAAA","sourcesContent":["import { KvsQueryOperation } from 'quidproquo-core';\n\nimport { AttributeValue, DynamoDBClient, ScanCommand, ScanCommandInput } from '@aws-sdk/client-dynamodb';\n\nimport { createAwsClient } from '../createAwsClient';\nimport { convertDynamoMapToObject } from './convertDynamoMapToObject';\nimport { buildDynamoQueryExpression, buildExpressionAttributeNames, buildExpressionAttributeValues } from './qpqDynamoOrm';\n\n/** Scan every page of the table, optionally filtered, and return all items. */\nexport async function getAllItems(tableName: string, region: string, filterExpression?: KvsQueryOperation): Promise<Record<string, unknown>[]> {\n  const dynamoDBClient = createAwsClient(DynamoDBClient, { region });\n\n  let records: Record<string, unknown>[] = [];\n  let lastEvaluatedKey: Record<string, AttributeValue> | undefined;\n\n  do {\n    const scanParams: ScanCommandInput = {\n      TableName: tableName,\n      FilterExpression: buildDynamoQueryExpression(filterExpression),\n      ExpressionAttributeValues: filterExpression && buildExpressionAttributeValues([filterExpression]),\n      ExpressionAttributeNames: filterExpression && buildExpressionAttributeNames([filterExpression]),\n      ExclusiveStartKey: lastEvaluatedKey,\n    };\n\n    const result = await dynamoDBClient.send(new ScanCommand(scanParams));\n\n    records = records.concat((result.Items || []).map((item) => convertDynamoMapToObject(item)));\n    lastEvaluatedKey = result.LastEvaluatedKey;\n  } while (lastEvaluatedKey);\n\n  return records;\n}\n"]}

package/lib/commonjs/logic/dynamo/getItem.d.ts

@@ -1,2 +1,2 @@
-import { KvsCoreDataType } from 'quidproquo-core';
-export declare function getItem(tableName: string, region: string, keyName: string, key: KvsCoreDataType, sortKeyName?: string, sortKey?: KvsCoreDataType): Promise<any | null>;
+import { KvsCoreDataType, Nullable } from 'quidproquo-core';
+export declare function getItem(tableName: string, region: string, keyName: string, key: KvsCoreDataType, sortKeyName?: string, sortKey?: KvsCoreDataType): Promise<Nullable<Record<string, unknown>>>;

package/lib/commonjs/logic/dynamo/getItem.js

@@ -12,28 +12,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getItem = getItem;
 const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
 const createAwsClient_1 = require("../createAwsClient");
-const convertObjectToDynamoMap_1 = require("./convertObjectToDynamoMap");
-const qpqDynamoOrm_1 = require("./qpqDynamoOrm");
+const buildDynamoKey_1 = require("./utils/buildDynamoKey");
+const convertDynamoMapToObject_1 = require("./convertDynamoMapToObject");
 function getItem(tableName, region, keyName, key, sortKeyName, sortKey) {
     return __awaiter(this, void 0, void 0, function* () {
         const dynamoDBClient = (0, createAwsClient_1.createAwsClient)(client_dynamodb_1.DynamoDBClient, { region });
-        const getItemParams = {
+        const result = yield dynamoDBClient.send(new client_dynamodb_1.GetItemCommand({
             TableName: tableName,
-            Key: {
-                [keyName]: (0, qpqDynamoOrm_1.buildAttributeValue)(key),
-            },
-        };
-        if (sortKeyName && sortKey !== undefined) {
-            getItemParams.Key[sortKeyName] = (0, qpqDynamoOrm_1.buildAttributeValue)(sortKey);
-        }
-        try {
-            const result = yield dynamoDBClient.send(new client_dynamodb_1.GetItemCommand(getItemParams));
-            return result.Item ? (0, convertObjectToDynamoMap_1.convertDynamoMapToObject)(result.Item) : null;
-        }
-        catch (error) {
-            console.error('Error getting item from DynamoDB:', error);
-            throw error;
-        }
+            Key: (0, buildDynamoKey_1.buildDynamoKey)(keyName, key, sortKeyName, sortKey),
+        }));
+        return result.Item ? (0, convertDynamoMapToObject_1.convertDynamoMapToObject)(result.Item) : null;
     });
 }
 //# sourceMappingURL=getItem.js.map

package/lib/commonjs/logic/dynamo/getItem.js.map

@@ -1 +1 @@
-{"version":3,"file":"getItem.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/getItem.ts"],"names":[],"mappings":";;;;;;;;;;;AAQA,0BA4BC;AAlCD,8DAA+F;AAE/F,wDAAqD;AACrD,yEAAsE;AACtE,iDAAqD;AAErD,SAAsB,OAAO,CAC3B,SAAiB,EACjB,MAAc,EACd,OAAe,EACf,GAAoB,EACpB,WAAoB,EACpB,OAAyB;;QAEzB,MAAM,cAAc,GAAG,IAAA,iCAAe,EAAC,gCAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnE,MAAM,aAAa,GAAwB;YACzC,SAAS,EAAE,SAAS;YACpB,GAAG,EAAE;gBACH,CAAC,OAAO,CAAC,EAAE,IAAA,kCAAmB,EAAC,GAAG,CAAC;aACpC;SACF,CAAC;QAEF,IAAI,WAAW,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACzC,aAAa,CAAC,GAAI,CAAC,WAAW,CAAC,GAAG,IAAA,kCAAmB,EAAC,OAAO,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,gCAAc,CAAC,aAAa,CAAC,CAAC,CAAC;YAC5E,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAA,mDAAwB,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;YAC1D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CAAA","sourcesContent":["import { KvsCoreDataType } from 'quidproquo-core';\n\nimport { DynamoDBClient, GetItemCommand, GetItemCommandInput } from '@aws-sdk/client-dynamodb';\n\nimport { createAwsClient } from '../createAwsClient';\nimport { convertDynamoMapToObject } from './convertObjectToDynamoMap';\nimport { buildAttributeValue } from './qpqDynamoOrm';\n\nexport async function getItem(\n  tableName: string,\n  region: string,\n  keyName: string,\n  key: KvsCoreDataType,\n  sortKeyName?: string,\n  sortKey?: KvsCoreDataType,\n): Promise<any | null> {\n  const dynamoDBClient = createAwsClient(DynamoDBClient, { region });\n\n  const getItemParams: GetItemCommandInput = {\n    TableName: tableName,\n    Key: {\n      [keyName]: buildAttributeValue(key),\n    },\n  };\n\n  if (sortKeyName && sortKey !== undefined) {\n    getItemParams.Key![sortKeyName] = buildAttributeValue(sortKey);\n  }\n\n  try {\n    const result = await dynamoDBClient.send(new GetItemCommand(getItemParams));\n    return result.Item ? convertDynamoMapToObject(result.Item) : null;\n  } catch (error) {\n    console.error('Error getting item from DynamoDB:', error);\n    throw error;\n  }\n}\n"]}
+{"version":3,"file":"getItem.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/getItem.ts"],"names":[],"mappings":";;;;;;;;;;;AAQA,0BAkBC;AAxBD,8DAA0E;AAE1E,wDAAqD;AACrD,2DAAwD;AACxD,yEAAsE;AAEtE,SAAsB,OAAO,CAC3B,SAAiB,EACjB,MAAc,EACd,OAAe,EACf,GAAoB,EACpB,WAAoB,EACpB,OAAyB;;QAEzB,MAAM,cAAc,GAAG,IAAA,iCAAe,EAAC,gCAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnE,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CACtC,IAAI,gCAAc,CAAC;YACjB,SAAS,EAAE,SAAS;YACpB,GAAG,EAAE,IAAA,+BAAc,EAAC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC;SACxD,CAAC,CACH,CAAC;QAEF,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAA,mDAAwB,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,CAAC;CAAA","sourcesContent":["import { KvsCoreDataType, Nullable } from 'quidproquo-core';\n\nimport { DynamoDBClient, GetItemCommand } from '@aws-sdk/client-dynamodb';\n\nimport { createAwsClient } from '../createAwsClient';\nimport { buildDynamoKey } from './utils/buildDynamoKey';\nimport { convertDynamoMapToObject } from './convertDynamoMapToObject';\n\nexport async function getItem(\n  tableName: string,\n  region: string,\n  keyName: string,\n  key: KvsCoreDataType,\n  sortKeyName?: string,\n  sortKey?: KvsCoreDataType,\n): Promise<Nullable<Record<string, unknown>>> {\n  const dynamoDBClient = createAwsClient(DynamoDBClient, { region });\n\n  const result = await dynamoDBClient.send(\n    new GetItemCommand({\n      TableName: tableName,\n      Key: buildDynamoKey(keyName, key, sortKeyName, sortKey),\n    }),\n  );\n\n  return result.Item ? convertDynamoMapToObject(result.Item) : null;\n}\n"]}

package/lib/commonjs/logic/dynamo/index.d.ts

@@ -1,6 +1,8 @@
+export * from './convertDynamoMapToObject';
 export * from './deleteItem';
 export * from './getAllItems';
 export * from './getItem';
 export * from './putItem';
 export * from './query';
+export * from './scan';
 export * from './updateItem';

package/lib/commonjs/logic/dynamo/index.js

@@ -14,10 +14,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./convertDynamoMapToObject"), exports);
 __exportStar(require("./deleteItem"), exports);
 __exportStar(require("./getAllItems"), exports);
 __exportStar(require("./getItem"), exports);
 __exportStar(require("./putItem"), exports);
 __exportStar(require("./query"), exports);
+__exportStar(require("./scan"), exports);
 __exportStar(require("./updateItem"), exports);
 //# sourceMappingURL=index.js.map

package/lib/commonjs/logic/dynamo/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,gDAA8B;AAC9B,4CAA0B;AAC1B,4CAA0B;AAC1B,0CAAwB;AACxB,+CAA6B","sourcesContent":["export * from './deleteItem';\nexport * from './getAllItems';\nexport * from './getItem';\nexport * from './putItem';\nexport * from './query';\nexport * from './updateItem';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,+CAA6B;AAC7B,gDAA8B;AAC9B,4CAA0B;AAC1B,4CAA0B;AAC1B,0CAAwB;AACxB,yCAAuB;AACvB,+CAA6B","sourcesContent":["export * from './convertDynamoMapToObject';\nexport * from './deleteItem';\nexport * from './getAllItems';\nexport * from './getItem';\nexport * from './putItem';\nexport * from './query';\nexport * from './scan';\nexport * from './updateItem';\n"]}

package/lib/commonjs/logic/dynamo/putItem.d.ts

@@ -1,6 +1,6 @@
-import { KvsKey } from 'quidproquo-core';
-export interface PutItemOptions {
+import { KvsKey, KvsObjectDataType } from 'quidproquo-core';
+export type PutItemOptions = {
     expires?: number;
     ifNotExistsAttribute?: string;
-}
-export declare function putItem<Item, T extends object = any>(tableName: string, item: Item, attributes: KvsKey[], options: PutItemOptions, region: string): Promise<void>;
+};
+export declare function putItem(tableName: string, item: KvsObjectDataType, attributes: KvsKey[], options: PutItemOptions, region: string): Promise<void>;

package/lib/commonjs/logic/dynamo/putItem.js

@@ -13,26 +13,9 @@ exports.putItem = putItem;
 const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
 const createAwsClient_1 = require("../createAwsClient");
 const qpqDynamoOrm_1 = require("./qpqDynamoOrm");
-// We currently only support objects as root items in dynamo
-// Storing a list (array) as the root of your DynamoDB record is indeed possible,
-// but there are some caveats. One of the main challenges is that DynamoDB doesn't support
-// complex operations on list items. For instance, you can't perform a conditional update or
-// delete on a specific item in the list based on its value. However, you can read and write
-// entire lists, and you can append items to a list with an update operation.
-//
-// TODO?: support lists as root items in dynamo ~ Probably not worth it
-// a root list probably should be a table!
-// Something like this:
-// const convertObjectOrListToDynamoMap = (value: KvsObjectDataType | KvsListDataType): AttributeValue => {
-//   const attributeValue = buildAttributeValue(value);
-//   if ('M' in attributeValue) {
-//     return attributeValue.M!;
-//   }
-//   if ('L' in attributeValue) {
-//     return attributeValue.L!;
-//   }
-//   throw new Error("Value must be an object or a list");
-// }
+// Root items must be objects. A root-level list is technically storable, but
+// DynamoDB cannot conditionally update or delete individual list elements,
+// and a root list is usually better modelled as its own table.
 const convertObjectToDynamoItem = (obj) => {
     return (0, qpqDynamoOrm_1.buildAttributeValue)(obj).M;
 };

package/lib/commonjs/logic/dynamo/putItem.js.map

@@ -1 +1 @@
-{"version":3,"file":"putItem.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/putItem.ts"],"names":[],"mappings":";;;;;;;;;;;AA2CA,0BAqBC;AA9DD,8DAA0F;AAE1F,wDAAqD;AACrD,iDAAqD;AAarD,4DAA4D;AAC5D,iFAAiF;AACjF,0FAA0F;AAC1F,4FAA4F;AAC5F,4FAA4F;AAC5F,6EAA6E;AAC7E,EAAE;AACF,uEAAuE;AACvE,0CAA0C;AAC1C,uBAAuB;AACvB,2GAA2G;AAC3G,uDAAuD;AACvD,iCAAiC;AACjC,gCAAgC;AAChC,MAAM;AACN,iCAAiC;AACjC,gCAAgC;AAChC,MAAM;AACN,0DAA0D;AAC1D,IAAI;AAEJ,MAAM,yBAAyB,GAAG,CAAC,GAAsB,EAAkC,EAAE;IAC3F,OAAO,IAAA,kCAAmB,EAAC,GAAG,CAAC,CAAC,CAAE,CAAC;AACrC,CAAC,CAAC;AAEF,SAAsB,OAAO,CAC3B,SAAiB,EACjB,IAAU,EACV,UAAoB,EACpB,OAAuB,EACvB,MAAc;;QAEd,MAAM,cAAc,GAAG,IAAA,iCAAe,EAAC,gCAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnE,MAAM,cAAc,CAAC,IAAI,CACvB,IAAI,gCAAc,iBAChB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,yBAAyB,CAAC,IAAyB,CAAC,IACvD,CAAC,OAAO,CAAC,oBAAoB;YAC9B,CAAC,CAAC;gBACE,mBAAmB,EAAE,gCAAgC;gBACrD,wBAAwB,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,oBAAoB,EAAE;aACvE;YACH,CAAC,CAAC,EAAE,CAAC,EACP,CACH,CAAC;IACJ,CAAC;CAAA","sourcesContent":["import { KvsKey, KvsObjectDataType } from 'quidproquo-core';\n\nimport { AttributeValue, DynamoDBClient, PutItemCommand } from '@aws-sdk/client-dynamodb';\n\nimport { createAwsClient } from '../createAwsClient';\nimport { buildAttributeValue } from './qpqDynamoOrm';\n\nexport interface PutItemOptions {\n  expires?: number;\n\n  // When set, the put becomes a conditional insert: it fails with\n  // ConditionalCheckFailedException if an item with the same primary key\n  // already exists. The value is the attribute name to condition on (any\n  // key attribute works — the condition evaluates against the item at the\n  // full primary key).\n  ifNotExistsAttribute?: string;\n}\n\n// We currently only support objects as root items in dynamo\n// Storing a list (array) as the root of your DynamoDB record is indeed possible,\n// but there are some caveats. One of the main challenges is that DynamoDB doesn't support\n// complex operations on list items. For instance, you can't perform a conditional update or\n// delete on a specific item in the list based on its value. However, you can read and write\n// entire lists, and you can append items to a list with an update operation.\n//\n// TODO?: support lists as root items in dynamo ~ Probably not worth it\n// a root list probably should be a table!\n// Something like this:\n// const convertObjectOrListToDynamoMap = (value: KvsObjectDataType | KvsListDataType): AttributeValue => {\n//   const attributeValue = buildAttributeValue(value);\n//   if ('M' in attributeValue) {\n//     return attributeValue.M!;\n//   }\n//   if ('L' in attributeValue) {\n//     return attributeValue.L!;\n//   }\n//   throw new Error(\"Value must be an object or a list\");\n// }\n\nconst convertObjectToDynamoItem = (obj: KvsObjectDataType): Record<string, AttributeValue> => {\n  return buildAttributeValue(obj).M!;\n};\n\nexport async function putItem<Item, T extends object = any>(\n  tableName: string,\n  item: Item,\n  attributes: KvsKey[],\n  options: PutItemOptions,\n  region: string,\n): Promise<void> {\n  const dynamoDBClient = createAwsClient(DynamoDBClient, { region });\n\n  await dynamoDBClient.send(\n    new PutItemCommand({\n      TableName: tableName,\n      Item: convertObjectToDynamoItem(item as KvsObjectDataType),\n      ...(options.ifNotExistsAttribute\n        ? {\n            ConditionExpression: 'attribute_not_exists(#ineAttr)',\n            ExpressionAttributeNames: { '#ineAttr': options.ifNotExistsAttribute },\n          }\n        : {}),\n    }),\n  );\n}\n"]}
+{"version":3,"file":"putItem.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/putItem.ts"],"names":[],"mappings":";;;;;;;;;;;AA6BA,0BAqBC;AAhDD,8DAA0F;AAE1F,wDAAqD;AACrD,iDAAqD;AAiBrD,6EAA6E;AAC7E,2EAA2E;AAC3E,+DAA+D;AAC/D,MAAM,yBAAyB,GAAG,CAAC,GAAsB,EAAkC,EAAE;IAC3F,OAAO,IAAA,kCAAmB,EAAC,GAAG,CAAC,CAAC,CAAE,CAAC;AACrC,CAAC,CAAC;AAEF,SAAsB,OAAO,CAC3B,SAAiB,EACjB,IAAuB,EACvB,UAAoB,EACpB,OAAuB,EACvB,MAAc;;QAEd,MAAM,cAAc,GAAG,IAAA,iCAAe,EAAC,gCAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnE,MAAM,cAAc,CAAC,IAAI,CACvB,IAAI,gCAAc,iBAChB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC,IAClC,CAAC,OAAO,CAAC,oBAAoB;YAC9B,CAAC,CAAC;gBACE,mBAAmB,EAAE,gCAAgC;gBACrD,wBAAwB,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,oBAAoB,EAAE;aACvE;YACH,CAAC,CAAC,EAAE,CAAC,EACP,CACH,CAAC;IACJ,CAAC;CAAA","sourcesContent":["import { KvsKey, KvsObjectDataType } from 'quidproquo-core';\n\nimport { AttributeValue, DynamoDBClient, PutItemCommand } from '@aws-sdk/client-dynamodb';\n\nimport { createAwsClient } from '../createAwsClient';\nimport { buildAttributeValue } from './qpqDynamoOrm';\n\nexport type PutItemOptions = {\n  // Requested TTL in seconds. Not currently applied: the table's ttlAttribute\n  // name is not plumbed through to this call, so the value is silently\n  // dropped. Wire storeConfig.ttlAttribute through and write the epoch expiry\n  // before relying on it.\n  expires?: number;\n\n  // When set, the put becomes a conditional insert: it fails with\n  // ConditionalCheckFailedException if an item with the same primary key\n  // already exists. The value is the attribute name to condition on (any\n  // key attribute works: the condition evaluates against the item at the\n  // full primary key).\n  ifNotExistsAttribute?: string;\n};\n\n// Root items must be objects. A root-level list is technically storable, but\n// DynamoDB cannot conditionally update or delete individual list elements,\n// and a root list is usually better modelled as its own table.\nconst convertObjectToDynamoItem = (obj: KvsObjectDataType): Record<string, AttributeValue> => {\n  return buildAttributeValue(obj).M!;\n};\n\nexport async function putItem(\n  tableName: string,\n  item: KvsObjectDataType,\n  attributes: KvsKey[],\n  options: PutItemOptions,\n  region: string,\n): Promise<void> {\n  const dynamoDBClient = createAwsClient(DynamoDBClient, { region });\n\n  await dynamoDBClient.send(\n    new PutItemCommand({\n      TableName: tableName,\n      Item: convertObjectToDynamoItem(item),\n      ...(options.ifNotExistsAttribute\n        ? {\n            ConditionExpression: 'attribute_not_exists(#ineAttr)',\n            ExpressionAttributeNames: { '#ineAttr': options.ifNotExistsAttribute },\n          }\n        : {}),\n    }),\n  );\n}\n"]}

package/lib/commonjs/logic/dynamo/qpqDynamoOrm/buildAttributeValue.d.ts

@@ -0,0 +1,8 @@
+import { KvsAdvancedDataType } from 'quidproquo-core';
+import { AttributeValue } from '@aws-sdk/client-dynamodb';
+/**
+ * Convert a kvs value to its DynamoDB AttributeValue form. Recurses into
+ * arrays and objects; object members with an undefined value are dropped
+ * (DynamoDB has no representation for undefined).
+ */
+export declare const buildAttributeValue: (value: KvsAdvancedDataType) => AttributeValue;

package/lib/commonjs/logic/dynamo/qpqDynamoOrm/buildAttributeValue.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAttributeValue = void 0;
+/**
+ * Convert a kvs value to its DynamoDB AttributeValue form. Recurses into
+ * arrays and objects; object members with an undefined value are dropped
+ * (DynamoDB has no representation for undefined).
+ */
+const buildAttributeValue = (value) => {
+    const valueType = typeof value;
+    switch (valueType) {
+        case 'string':
+            return { S: value };
+        case 'number':
+            return { N: value.toString() };
+        case 'boolean':
+            return { BOOL: value };
+        case 'object':
+            if (Array.isArray(value)) {
+                return {
+                    L: value.map((item) => (0, exports.buildAttributeValue)(item)),
+                };
+            }
+            else if (value !== null) {
+                const objectKeyValuePairs = Object.entries(value)
+                    .filter(([, memberValue]) => memberValue !== undefined)
+                    .map(([memberKey, memberValue]) => [memberKey, (0, exports.buildAttributeValue)(memberValue)]);
+                return {
+                    M: Object.fromEntries(objectKeyValuePairs),
+                };
+            }
+            else {
+                return { NULL: true };
+            }
+        default:
+            throw new Error(`Unsupported data type in kvs expression: ${valueType}`);
+    }
+};
+exports.buildAttributeValue = buildAttributeValue;
+//# sourceMappingURL=buildAttributeValue.js.map

package/lib/commonjs/logic/dynamo/qpqDynamoOrm/buildAttributeValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildAttributeValue.js","sourceRoot":"","sources":["../../../../../src/logic/dynamo/qpqDynamoOrm/buildAttributeValue.ts"],"names":[],"mappings":";;;AAIA;;;;GAIG;AACI,MAAM,mBAAmB,GAAG,CAAC,KAA0B,EAAkB,EAAE;IAChF,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;IAC/B,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,EAAE,CAAC,EAAE,KAAe,EAAE,CAAC;QAEhC,KAAK,QAAQ;YACX,OAAO,EAAE,CAAC,EAAG,KAAgB,CAAC,QAAQ,EAAE,EAAE,CAAC;QAE7C,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,KAAgB,EAAE,CAAC;QAEpC,KAAK,QAAQ;YACX,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO;oBACL,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,2BAAmB,EAAC,IAAI,CAAC,CAAC;iBAClD,CAAC;YACJ,CAAC;iBAAM,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1B,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;qBAC9C,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,WAAW,KAAK,SAAS,CAAC;qBACtD,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,IAAA,2BAAmB,EAAC,WAAW,CAAC,CAAC,CAAC,CAAC;gBAEpF,OAAO;oBACL,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,mBAAmB,CAAC;iBAC3C,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACxB,CAAC;QACH;YACE,MAAM,IAAI,KAAK,CAAC,4CAA4C,SAAS,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC,CAAC;AA/BW,QAAA,mBAAmB,uBA+B9B","sourcesContent":["import { KvsAdvancedDataType } from 'quidproquo-core';\n\nimport { AttributeValue } from '@aws-sdk/client-dynamodb';\n\n/**\n * Convert a kvs value to its DynamoDB AttributeValue form. Recurses into\n * arrays and objects; object members with an undefined value are dropped\n * (DynamoDB has no representation for undefined).\n */\nexport const buildAttributeValue = (value: KvsAdvancedDataType): AttributeValue => {\n  const valueType = typeof value;\n  switch (valueType) {\n    case 'string':\n      return { S: value as string };\n\n    case 'number':\n      return { N: (value as number).toString() };\n\n    case 'boolean':\n      return { BOOL: value as boolean };\n\n    case 'object':\n      if (Array.isArray(value)) {\n        return {\n          L: value.map((item) => buildAttributeValue(item)),\n        };\n      } else if (value !== null) {\n        const objectKeyValuePairs = Object.entries(value)\n          .filter(([, memberValue]) => memberValue !== undefined)\n          .map(([memberKey, memberValue]) => [memberKey, buildAttributeValue(memberValue)]);\n\n        return {\n          M: Object.fromEntries(objectKeyValuePairs),\n        };\n      } else {\n        return { NULL: true };\n      }\n    default:\n      throw new Error(`Unsupported data type in kvs expression: ${valueType}`);\n  }\n};\n"]}

package/lib/commonjs/logic/dynamo/qpqDynamoOrm/buildDynamoQueryExpression.d.ts

@@ -0,0 +1,9 @@
+import { KvsQueryOperation } from 'quidproquo-core';
+/**
+ * Render a kvs query tree as a DynamoDB expression string. Attribute names and
+ * values are replaced with hashed placeholders; pair the result with
+ * buildExpressionAttributeNames / buildExpressionAttributeValues over the same
+ * queries. Returns undefined (not null) when there is no query so the result
+ * can feed optional SDK command fields (FilterExpression and friends) directly.
+ */
+export declare const buildDynamoQueryExpression: (query?: KvsQueryOperation) => string | undefined;

package/lib/commonjs/logic/dynamo/qpqDynamoOrm/buildDynamoQueryExpression.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDynamoQueryExpression = void 0;
+const quidproquo_core_1 = require("quidproquo-core");
+const getItemName_1 = require("./getItemName");
+const getValueName_1 = require("./getValueName");
+const isKvsLogicalOperator_1 = require("./isKvsLogicalOperator");
+const isKvsQueryCondition_1 = require("./isKvsQueryCondition");
+// Fail fast on a missing value: rendering a placeholder for undefined would
+// build an expression whose placeholder never appears in
+// ExpressionAttributeValues, which DynamoDB rejects with a confusing error.
+const getRequiredValueName = (query, value) => {
+    if (value === undefined) {
+        throw new Error(`Invalid query condition ${query.operation}: missing value for key [${query.key}]`);
+    }
+    return (0, getValueName_1.getValueName)(value);
+};
+const comparisonOperators = {
+    [quidproquo_core_1.KvsQueryOperationType.Equal]: '=',
+    [quidproquo_core_1.KvsQueryOperationType.NotEqual]: '<>',
+    [quidproquo_core_1.KvsQueryOperationType.LessThan]: '<',
+    [quidproquo_core_1.KvsQueryOperationType.LessThanOrEqual]: '<=',
+    [quidproquo_core_1.KvsQueryOperationType.GreaterThan]: '>',
+    [quidproquo_core_1.KvsQueryOperationType.GreaterThanOrEqual]: '>=',
+};
+const buildConditionExpression = (query) => {
+    const itemName = (0, getItemName_1.getItemName)(query.key);
+    switch (query.operation) {
+        case quidproquo_core_1.KvsQueryOperationType.Equal:
+        case quidproquo_core_1.KvsQueryOperationType.NotEqual:
+        case quidproquo_core_1.KvsQueryOperationType.LessThan:
+        case quidproquo_core_1.KvsQueryOperationType.LessThanOrEqual:
+        case quidproquo_core_1.KvsQueryOperationType.GreaterThan:
+        case quidproquo_core_1.KvsQueryOperationType.GreaterThanOrEqual:
+            return `${itemName} ${comparisonOperators[query.operation]} ${getRequiredValueName(query, query.valueA)}`;
+        case quidproquo_core_1.KvsQueryOperationType.Between:
+            return `${itemName} BETWEEN ${getRequiredValueName(query, query.valueA)} AND ${getRequiredValueName(query, query.valueB)}`;
+        case quidproquo_core_1.KvsQueryOperationType.In:
+            if (!Array.isArray(query.valueA)) {
+                throw new Error(`Invalid query condition ${query.operation}: expected an array of values for key [${query.key}]`);
+            }
+            return `${itemName} IN (${query.valueA.map((value) => (0, getValueName_1.getValueName)(value)).join(', ')})`;
+        case quidproquo_core_1.KvsQueryOperationType.Exists:
+            return `attribute_exists(${itemName})`;
+        case quidproquo_core_1.KvsQueryOperationType.NotExists:
+            return `attribute_not_exists(${itemName})`;
+        case quidproquo_core_1.KvsQueryOperationType.BeginsWith:
+            return `begins_with(${itemName}, ${getRequiredValueName(query, query.valueA)})`;
+        case quidproquo_core_1.KvsQueryOperationType.Contains:
+            return `contains(${itemName}, ${getRequiredValueName(query, query.valueA)})`;
+        case quidproquo_core_1.KvsQueryOperationType.NotContains:
+            return `NOT contains(${itemName}, ${getRequiredValueName(query, query.valueA)})`;
+        default:
+            throw new Error(`Invalid query operation: ${JSON.stringify(query)}`);
+    }
+};
+const buildLogicalExpression = (query) => {
+    const joiner = query.operation === quidproquo_core_1.KvsLogicalOperatorType.And ? ' AND ' : ' OR ';
+    return query.conditions.map((condition) => `(${buildQueryOperationExpression(condition)})`).join(joiner);
+};
+const buildQueryOperationExpression = (query) => {
+    if ((0, isKvsQueryCondition_1.isKvsQueryCondition)(query)) {
+        return buildConditionExpression(query);
+    }
+    if ((0, isKvsLogicalOperator_1.isKvsLogicalOperator)(query)) {
+        return buildLogicalExpression(query);
+    }
+    throw new Error(`Invalid query operation: ${JSON.stringify(query)}`);
+};
+/**
+ * Render a kvs query tree as a DynamoDB expression string. Attribute names and
+ * values are replaced with hashed placeholders; pair the result with
+ * buildExpressionAttributeNames / buildExpressionAttributeValues over the same
+ * queries. Returns undefined (not null) when there is no query so the result
+ * can feed optional SDK command fields (FilterExpression and friends) directly.
+ */
+const buildDynamoQueryExpression = (query) => {
+    if (!query) {
+        return undefined;
+    }
+    return buildQueryOperationExpression(query);
+};
+exports.buildDynamoQueryExpression = buildDynamoQueryExpression;
+//# sourceMappingURL=buildDynamoQueryExpression.js.map

package/lib/commonjs/logic/dynamo/qpqDynamoOrm/buildDynamoQueryExpression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildDynamoQueryExpression.js","sourceRoot":"","sources":["../../../../../src/logic/dynamo/qpqDynamoOrm/buildDynamoQueryExpression.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  KvsAdvancedDataType,\n  KvsLogicalOperator,\n  KvsLogicalOperatorType,\n  KvsQueryCondition,\n  KvsQueryOperation,\n  KvsQueryOperationType,\n} from 'quidproquo-core';\n\nimport { getItemName } from './getItemName';\nimport { getValueName } from './getValueName';\nimport { isKvsLogicalOperator } from './isKvsLogicalOperator';\nimport { isKvsQueryCondition } from './isKvsQueryCondition';\n\n// Fail fast on a missing value: rendering a placeholder for undefined would\n// build an expression whose placeholder never appears in\n// ExpressionAttributeValues, which DynamoDB rejects with a confusing error.\nconst getRequiredValueName = (query: KvsQueryCondition, value?: KvsAdvancedDataType): string => {\n  if (value === undefined) {\n    throw new Error(`Invalid query condition ${query.operation}: missing value for key [${query.key}]`);\n  }\n\n  return getValueName(value);\n};\n\nconst comparisonOperators: Partial<Record<KvsQueryOperationType, string>> = {\n  [KvsQueryOperationType.Equal]: '=',\n  [KvsQueryOperationType.NotEqual]: '<>',\n  [KvsQueryOperationType.LessThan]: '<',\n  [KvsQueryOperationType.LessThanOrEqual]: '<=',\n  [KvsQueryOperationType.GreaterThan]: '>',\n  [KvsQueryOperationType.GreaterThanOrEqual]: '>=',\n};\n\nconst buildConditionExpression = (query: KvsQueryCondition): string => {\n  const itemName = getItemName(query.key);\n\n  switch (query.operation) {\n    case KvsQueryOperationType.Equal:\n    case KvsQueryOperationType.NotEqual:\n    case KvsQueryOperationType.LessThan:\n    case KvsQueryOperationType.LessThanOrEqual:\n    case KvsQueryOperationType.GreaterThan:\n    case KvsQueryOperationType.GreaterThanOrEqual:\n      return `${itemName} ${comparisonOperators[query.operation]} ${getRequiredValueName(query, query.valueA)}`;\n\n    case KvsQueryOperationType.Between:\n      return `${itemName} BETWEEN ${getRequiredValueName(query, query.valueA)} AND ${getRequiredValueName(query, query.valueB)}`;\n\n    case KvsQueryOperationType.In:\n      if (!Array.isArray(query.valueA)) {\n        throw new Error(`Invalid query condition ${query.operation}: expected an array of values for key [${query.key}]`);\n      }\n      return `${itemName} IN (${query.valueA.map((value) => getValueName(value)).join(', ')})`;\n\n    case KvsQueryOperationType.Exists:\n      return `attribute_exists(${itemName})`;\n\n    case KvsQueryOperationType.NotExists:\n      return `attribute_not_exists(${itemName})`;\n\n    case KvsQueryOperationType.BeginsWith:\n      return `begins_with(${itemName}, ${getRequiredValueName(query, query.valueA)})`;\n\n    case KvsQueryOperationType.Contains:\n      return `contains(${itemName}, ${getRequiredValueName(query, query.valueA)})`;\n\n    case KvsQueryOperationType.NotContains:\n      return `NOT contains(${itemName}, ${getRequiredValueName(query, query.valueA)})`;\n\n    default:\n      throw new Error(`Invalid query operation: ${JSON.stringify(query)}`);\n  }\n};\n\nconst buildLogicalExpression = (query: KvsLogicalOperator): string => {\n  const joiner = query.operation === KvsLogicalOperatorType.And ? ' AND ' : ' OR ';\n\n  return query.conditions.map((condition) => `(${buildQueryOperationExpression(condition)})`).join(joiner);\n};\n\nconst buildQueryOperationExpression = (query: KvsQueryOperation): string => {\n  if (isKvsQueryCondition(query)) {\n    return buildConditionExpression(query);\n  }\n\n  if (isKvsLogicalOperator(query)) {\n    return buildLogicalExpression(query);\n  }\n\n  throw new Error(`Invalid query operation: ${JSON.stringify(query)}`);\n};\n\n/**\n * Render a kvs query tree as a DynamoDB expression string. Attribute names and\n * values are replaced with hashed placeholders; pair the result with\n * buildExpressionAttributeNames / buildExpressionAttributeValues over the same\n * queries. Returns undefined (not null) when there is no query so the result\n * can feed optional SDK command fields (FilterExpression and friends) directly.\n */\nexport const buildDynamoQueryExpression = (query?: KvsQueryOperation): string | undefined => {\n  if (!query) {\n    return undefined;\n  }\n\n  return buildQueryOperationExpression(query);\n};\n"]}

package/lib/commonjs/logic/dynamo/qpqDynamoOrm/buildDynamoUpdateExpression.d.ts

@@ -0,0 +1,9 @@
+import { KvsUpdate } from 'quidproquo-core';
+/**
+ * Render a kvs update as a DynamoDB UpdateExpression, grouping actions into
+ * SET / REMOVE / ADD / DELETE clauses. Attribute names and values are replaced
+ * with hashed placeholders; pair the result with
+ * buildUpdateExpressionAttributeNames / buildUpdateExpressionAttributeValues
+ * over the same updates.
+ */
+export declare const buildDynamoUpdateExpression: (updates: KvsUpdate) => string;

package/lib/commonjs/logic/dynamo/qpqDynamoOrm/buildDynamoUpdateExpression.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDynamoUpdateExpression = void 0;
+const quidproquo_core_1 = require("quidproquo-core");
+const getItemName_1 = require("./getItemName");
+const getValueName_1 = require("./getValueName");
+const getNestedItemName = (attributePath) => {
+    if (!Array.isArray(attributePath)) {
+        return (0, getItemName_1.getItemName)(attributePath);
+    }
+    const parts = attributePath.map((segment) => {
+        if (typeof segment === 'string') {
+            return `.${(0, getItemName_1.getItemName)(segment)}`;
+        }
+        // Only non-negative integers may be interpolated raw: anything else that
+        // sneaks past the types (via JSON payloads) would be stringified straight
+        // into the update expression, which is expression injection.
+        if (typeof segment === 'number' && Number.isInteger(segment) && segment >= 0) {
+            return `[${segment}]`;
+        }
+        throw new Error(`Invalid attribute path segment: ${JSON.stringify(segment)}`);
+    });
+    return parts.join('').replace(/^\./, '');
+};
+const buildSetPart = (update) => {
+    if (update.value === undefined || update.value === null) {
+        throw new Error("Value must be provided for 'SET' action");
+    }
+    return `${getNestedItemName(update.attributePath)} = ${(0, getValueName_1.getValueName)(update.value)}`;
+};
+const buildRemovePart = (update) => {
+    return getNestedItemName(update.attributePath);
+};
+const buildAddPart = (update) => {
+    if (update.value === undefined || update.value === null) {
+        throw new Error("Value must be provided for 'ADD' action");
+    }
+    return `${getNestedItemName(update.attributePath)} ${(0, getValueName_1.getValueName)(update.value)}`;
+};
+const buildDeletePart = (update) => {
+    if (update.value !== undefined && update.value !== null) {
+        return `${getNestedItemName(update.attributePath)} ${(0, getValueName_1.getValueName)(update.value)}`;
+    }
+    return getNestedItemName(update.attributePath);
+};
+const buildSetIfNotExistsPart = (update) => {
+    if (update.value === undefined || update.value === null) {
+        throw new Error("Value must be provided for 'SetIfNotExists' action");
+    }
+    const attrPath = getNestedItemName(update.attributePath);
+    return `${attrPath} = if_not_exists(${attrPath}, ${(0, getValueName_1.getValueName)(update.value)})`;
+};
+const buildIncrementPart = (update) => {
+    if (update.value === undefined || update.value === null) {
+        throw new Error("Increment value must be provided for 'Increment' action");
+    }
+    if (update.defaultValue === undefined || update.defaultValue === null) {
+        throw new Error("Default value must be provided for 'Increment' action");
+    }
+    const attrPath = getNestedItemName(update.attributePath);
+    return `${attrPath} = if_not_exists(${attrPath}, ${(0, getValueName_1.getValueName)(update.defaultValue)}) + ${(0, getValueName_1.getValueName)(update.value)}`;
+};
+const buildUpdateExpressionPart = (update) => {
+    switch (update.action) {
+        case quidproquo_core_1.KvsUpdateActionType.Set:
+            return buildSetPart(update);
+        case quidproquo_core_1.KvsUpdateActionType.Remove:
+            return buildRemovePart(update);
+        case quidproquo_core_1.KvsUpdateActionType.Add:
+            return buildAddPart(update);
+        case quidproquo_core_1.KvsUpdateActionType.Delete:
+            return buildDeletePart(update);
+        case quidproquo_core_1.KvsUpdateActionType.SetIfNotExists:
+            return buildSetIfNotExistsPart(update);
+        case quidproquo_core_1.KvsUpdateActionType.Increment:
+            return buildIncrementPart(update);
+        default:
+            throw new Error(`Invalid update action type: ${update.action}`);
+    }
+};
+// SetIfNotExists and Increment render as SET clauses too.
+const setActionTypes = [quidproquo_core_1.KvsUpdateActionType.Set, quidproquo_core_1.KvsUpdateActionType.SetIfNotExists, quidproquo_core_1.KvsUpdateActionType.Increment];
+const buildClause = (clause, actionTypes, kvsUpdate) => {
+    const actions = kvsUpdate.filter((update) => actionTypes.includes(update.action));
+    if (actions.length === 0) {
+        return '';
+    }
+    return `${clause} ${actions.map((update) => buildUpdateExpressionPart(update)).join(', ')}`;
+};
+/**
+ * Render a kvs update as a DynamoDB UpdateExpression, grouping actions into
+ * SET / REMOVE / ADD / DELETE clauses. Attribute names and values are replaced
+ * with hashed placeholders; pair the result with
+ * buildUpdateExpressionAttributeNames / buildUpdateExpressionAttributeValues
+ * over the same updates.
+ */
+const buildDynamoUpdateExpression = (updates) => {
+    const clauses = [
+        buildClause('SET', setActionTypes, updates),
+        buildClause('REMOVE', [quidproquo_core_1.KvsUpdateActionType.Remove], updates),
+        buildClause('ADD', [quidproquo_core_1.KvsUpdateActionType.Add], updates),
+        buildClause('DELETE', [quidproquo_core_1.KvsUpdateActionType.Delete], updates),
+    ].filter((expression) => !!expression);
+    return clauses.join(' ');
+};
+exports.buildDynamoUpdateExpression = buildDynamoUpdateExpression;
+//# sourceMappingURL=buildDynamoUpdateExpression.js.map