quidproquo-actionprocessor-awslambda 0.1.14 → 0.1.16

package/lib/commonjs/getActionProcessor/core/keyValueStore/getKeyValueStoreUpsertManyActionProcessor.d.ts

@@ -0,0 +1,2 @@
+import { ActionProcessorListResolver } from 'quidproquo-core';
+export declare const getKeyValueStoreUpsertManyActionProcessor: ActionProcessorListResolver;

package/lib/commonjs/getActionProcessor/core/keyValueStore/getKeyValueStoreUpsertManyActionProcessor.js

@@ -0,0 +1,64 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getKeyValueStoreUpsertManyActionProcessor = void 0;
+const quidproquo_config_aws_1 = require("quidproquo-config-aws");
+const quidproquo_core_1 = require("quidproquo-core");
+const awsNamingUtils_1 = require("../../../awsNamingUtils");
+const dynamo_1 = require("../../../logic/dynamo");
+// The batch sibling of Upsert: BatchWriteItem in chunks of 25, partial-acceptance
+// retry inside batchPutItems. Streams emit one record per item no matter how it
+// was written, so downstream projectors see the same records as N single upserts.
+// Unconditional (no ifNotExists — BatchWriteItem carries no conditions).
+const getProcessKeyValueStoreUpsertMany = (qpqConfig) => {
+    return (_a) => __awaiter(void 0, [_a], void 0, function* ({ keyValueStoreName, items, options }) {
+        const dynamoTableName = (0, awsNamingUtils_1.getKvsDynamoTableNameFromConfig)(keyValueStoreName, qpqConfig, 'kvs');
+        const region = quidproquo_config_aws_1.qpqConfigAwsUtils.getApplicationModuleDeployRegion(qpqConfig);
+        try {
+            const storeConfig = (0, quidproquo_core_1.resolveKvsStoreConfigOrThrow)(qpqConfig, keyValueStoreName);
+            // Same-key duplicates are rejected UP FRONT, before anything is written.
+            // Dynamo itself only rejects them when both land in the same 25-item
+            // chunk — across chunks the later write silently wins — so left to the
+            // service the outcome would depend on item position.
+            const seenKeys = new Set();
+            for (const item of items) {
+                const itemKey = [storeConfig.partitionKey, ...storeConfig.sortKeys].map((key) => String(item[key.key])).join('#');
+                if (seenKeys.has(itemKey)) {
+                    return (0, quidproquo_core_1.actionResultError)(quidproquo_core_1.KeyValueStoreUpsertManyErrorTypeEnum.DuplicateKey, `Duplicate key [${itemKey}] in batch upsert to [${keyValueStoreName}]`);
+                }
+                seenKeys.add(itemKey);
+            }
+            // The scope lives inside the stored partition key value, so each item is
+            // persisted with a composed pk; reads strip it back off.
+            const scoped = (0, quidproquo_core_1.getScopedKvsTranslatorOrThrow)(qpqConfig, keyValueStoreName, options === null || options === void 0 ? void 0 : options.scope);
+            yield (0, dynamo_1.batchPutItems)(dynamoTableName, items.map((item) => scoped.item(item)), region);
+            return (0, quidproquo_core_1.actionResult)(void 0);
+        }
+        catch (error) {
+            return (0, quidproquo_core_1.actionResultErrorFromCaughtError)(error, {
+                InternalServerError: () => (0, quidproquo_core_1.actionResultError)(quidproquo_core_1.KeyValueStoreUpsertManyErrorTypeEnum.ServiceUnavailable, 'KVS Service Unavailable'),
+                ResourceNotFoundException: () => (0, quidproquo_core_1.actionResultError)(quidproquo_core_1.KeyValueStoreUpsertManyErrorTypeEnum.ResourceNotFound, 'KVS Resource Not Found'),
+                // Retries exhausted on UnprocessedItems — sustained throttle, a transient
+                // fault: callers must see ServiceUnavailable, not a permanent failure.
+                BatchWriteUnprocessedItemsError: () => (0, quidproquo_core_1.actionResultError)(quidproquo_core_1.KeyValueStoreUpsertManyErrorTypeEnum.ServiceUnavailable, 'KVS batch write throttled'),
+                InvalidScopeError: (error) => (0, quidproquo_core_1.actionResultError)(quidproquo_core_1.KeyValueStoreUpsertManyErrorTypeEnum.InvalidScope, error.message),
+                KvsStoreNotFoundError: (error) => (0, quidproquo_core_1.actionResultError)(quidproquo_core_1.KeyValueStoreUpsertManyErrorTypeEnum.StoreNotFound, error.message),
+            });
+        }
+    });
+};
+const getKeyValueStoreUpsertManyActionProcessor = (qpqConfig) => __awaiter(void 0, void 0, void 0, function* () {
+    return ({
+        [quidproquo_core_1.KeyValueStoreActionType.UpsertMany]: getProcessKeyValueStoreUpsertMany(qpqConfig),
+    });
+});
+exports.getKeyValueStoreUpsertManyActionProcessor = getKeyValueStoreUpsertManyActionProcessor;
+//# sourceMappingURL=getKeyValueStoreUpsertManyActionProcessor.js.map

package/lib/commonjs/getActionProcessor/core/keyValueStore/getKeyValueStoreUpsertManyActionProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getKeyValueStoreUpsertManyActionProcessor.js","sourceRoot":"","sources":["../../../../../src/getActionProcessor/core/keyValueStore/getKeyValueStoreUpsertManyActionProcessor.ts"],"names":[],"mappings":"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","sourcesContent":["import { qpqConfigAwsUtils } from 'quidproquo-config-aws';\nimport {\n  ActionProcessorList,\n  ActionProcessorListResolver,\n  actionResult,\n  actionResultError,\n  actionResultErrorFromCaughtError,\n  getScopedKvsTranslatorOrThrow,\n  KeyValueStoreActionType,\n  KeyValueStoreUpsertManyActionProcessor,\n  KeyValueStoreUpsertManyErrorTypeEnum,\n  QPQConfig,\n  resolveKvsStoreConfigOrThrow,\n} from 'quidproquo-core';\n\nimport { getKvsDynamoTableNameFromConfig } from '../../../awsNamingUtils';\nimport { batchPutItems } from '../../../logic/dynamo';\n\n// The batch sibling of Upsert: BatchWriteItem in chunks of 25, partial-acceptance\n// retry inside batchPutItems. Streams emit one record per item no matter how it\n// was written, so downstream projectors see the same records as N single upserts.\n// Unconditional (no ifNotExists — BatchWriteItem carries no conditions).\nconst getProcessKeyValueStoreUpsertMany = (qpqConfig: QPQConfig): KeyValueStoreUpsertManyActionProcessor<any> => {\n  return async ({ keyValueStoreName, items, options }) => {\n    const dynamoTableName = getKvsDynamoTableNameFromConfig(keyValueStoreName, qpqConfig, 'kvs');\n    const region = qpqConfigAwsUtils.getApplicationModuleDeployRegion(qpqConfig);\n\n    try {\n      const storeConfig = resolveKvsStoreConfigOrThrow(qpqConfig, keyValueStoreName);\n\n      // Same-key duplicates are rejected UP FRONT, before anything is written.\n      // Dynamo itself only rejects them when both land in the same 25-item\n      // chunk — across chunks the later write silently wins — so left to the\n      // service the outcome would depend on item position.\n      const seenKeys = new Set<string>();\n      for (const item of items) {\n        const itemKey = [storeConfig.partitionKey, ...storeConfig.sortKeys].map((key) => String(item[key.key])).join('#');\n        if (seenKeys.has(itemKey)) {\n          return actionResultError(\n            KeyValueStoreUpsertManyErrorTypeEnum.DuplicateKey,\n            `Duplicate key [${itemKey}] in batch upsert to [${keyValueStoreName}]`,\n          );\n        }\n        seenKeys.add(itemKey);\n      }\n\n      // The scope lives inside the stored partition key value, so each item is\n      // persisted with a composed pk; reads strip it back off.\n      const scoped = getScopedKvsTranslatorOrThrow(qpqConfig, keyValueStoreName, options?.scope);\n\n      await batchPutItems(\n        dynamoTableName,\n        items.map((item) => scoped.item(item)),\n        region,\n      );\n\n      return actionResult(void 0);\n    } catch (error: unknown) {\n      return actionResultErrorFromCaughtError(error, {\n        InternalServerError: () => actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.ServiceUnavailable, 'KVS Service Unavailable'),\n        ResourceNotFoundException: () => actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.ResourceNotFound, 'KVS Resource Not Found'),\n        // Retries exhausted on UnprocessedItems — sustained throttle, a transient\n        // fault: callers must see ServiceUnavailable, not a permanent failure.\n        BatchWriteUnprocessedItemsError: () =>\n          actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.ServiceUnavailable, 'KVS batch write throttled'),\n        InvalidScopeError: (error) => actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.InvalidScope, error.message),\n        KvsStoreNotFoundError: (error) => actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.StoreNotFound, error.message),\n      });\n    }\n  };\n};\n\nexport const getKeyValueStoreUpsertManyActionProcessor: ActionProcessorListResolver = async (qpqConfig: QPQConfig): Promise<ActionProcessorList> => ({\n  [KeyValueStoreActionType.UpsertMany]: getProcessKeyValueStoreUpsertMany(qpqConfig),\n});\n"]}

package/lib/commonjs/getActionProcessor/core/keyValueStore/index.js

@@ -18,8 +18,9 @@ const getKeyValueStoreScanActionProcessor_1 = require("./getKeyValueStoreScanAct
 const getKeyValueStoreScanAllScopesActionProcessor_1 = require("./getKeyValueStoreScanAllScopesActionProcessor");
 const getKeyValueStoreUpdateActionProcessor_1 = require("./getKeyValueStoreUpdateActionProcessor");
 const getKeyValueStoreUpsertActionProcessor_1 = require("./getKeyValueStoreUpsertActionProcessor");
+const getKeyValueStoreUpsertManyActionProcessor_1 = require("./getKeyValueStoreUpsertManyActionProcessor");
 const getKeyValueStoreActionProcessor = (qpqConfig, dynamicModuleLoader) => __awaiter(void 0, void 0, void 0, function* () {
-    return (Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (yield (0, getKeyValueStoreDeleteActionProcessor_1.getKeyValueStoreDeleteActionProcessor)(qpqConfig, dynamicModuleLoader))), (yield (0, getKeyValueStoreGetActionProcessor_1.getKeyValueStoreGetActionProcessor)(qpqConfig, dynamicModuleLoader))), (yield (0, getKeyValueStoreGetAllActionProcessor_1.getKeyValueStoreGetAllActionProcessor)(qpqConfig, dynamicModuleLoader))), (yield (0, getKeyValueStoreUpsertActionProcessor_1.getKeyValueStoreUpsertActionProcessor)(qpqConfig, dynamicModuleLoader))), (yield (0, getKeyValueStoreUpdateActionProcessor_1.getKeyValueStoreUpdateActionProcessor)(qpqConfig, dynamicModuleLoader))), (yield (0, getKeyValueStoreQueryActionProcessor_1.getKeyValueStoreQueryActionProcessor)(qpqConfig, dynamicModuleLoader))), (yield (0, getKeyValueStoreScanActionProcessor_1.getKeyValueStoreScanActionProcessor)(qpqConfig, dynamicModuleLoader))), (yield (0, getKeyValueStoreScanAllScopesActionProcessor_1.getKeyValueStoreScanAllScopesActionProcessor)(qpqConfig, dynamicModuleLoader))));
+    return (Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (yield (0, getKeyValueStoreDeleteActionProcessor_1.getKeyValueStoreDeleteActionProcessor)(qpqConfig, dynamicModuleLoader))), (yield (0, getKeyValueStoreGetActionProcessor_1.getKeyValueStoreGetActionProcessor)(qpqConfig, dynamicModuleLoader))), (yield (0, getKeyValueStoreGetAllActionProcessor_1.getKeyValueStoreGetAllActionProcessor)(qpqConfig, dynamicModuleLoader))), (yield (0, getKeyValueStoreUpsertActionProcessor_1.getKeyValueStoreUpsertActionProcessor)(qpqConfig, dynamicModuleLoader))), (yield (0, getKeyValueStoreUpsertManyActionProcessor_1.getKeyValueStoreUpsertManyActionProcessor)(qpqConfig, dynamicModuleLoader))), (yield (0, getKeyValueStoreUpdateActionProcessor_1.getKeyValueStoreUpdateActionProcessor)(qpqConfig, dynamicModuleLoader))), (yield (0, getKeyValueStoreQueryActionProcessor_1.getKeyValueStoreQueryActionProcessor)(qpqConfig, dynamicModuleLoader))), (yield (0, getKeyValueStoreScanActionProcessor_1.getKeyValueStoreScanActionProcessor)(qpqConfig, dynamicModuleLoader))), (yield (0, getKeyValueStoreScanAllScopesActionProcessor_1.getKeyValueStoreScanAllScopesActionProcessor)(qpqConfig, dynamicModuleLoader))));
 });
 exports.getKeyValueStoreActionProcessor = getKeyValueStoreActionProcessor;
 //# sourceMappingURL=index.js.map

package/lib/commonjs/getActionProcessor/core/keyValueStore/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/getActionProcessor/core/keyValueStore/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,mGAAgG;AAChG,6FAA0F;AAC1F,mGAAgG;AAChG,iGAA8F;AAC9F,+FAA4F;AAC5F,iHAA8G;AAC9G,mGAAgG;AAChG,mGAAgG;AAEzF,MAAM,+BAA+B,GAAgC,CAC1E,SAAoB,EACpB,mBAAwC,EACV,EAAE;IAAC,OAAA,qHAC9B,CAAC,MAAM,IAAA,6EAAqC,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,GAC7E,CAAC,MAAM,IAAA,uEAAkC,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,GAC1E,CAAC,MAAM,IAAA,6EAAqC,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,GAC7E,CAAC,MAAM,IAAA,6EAAqC,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,GAC7E,CAAC,MAAM,IAAA,6EAAqC,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,GAC7E,CAAC,MAAM,IAAA,2EAAoC,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,GAC5E,CAAC,MAAM,IAAA,yEAAmC,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,GAC3E,CAAC,MAAM,IAAA,2FAA4C,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,EACvF,CAAA;EAAA,CAAC;AAZU,QAAA,+BAA+B,mCAYzC","sourcesContent":["import { ActionProcessorList, ActionProcessorListResolver, DynamicModuleLoader, QPQConfig } from 'quidproquo-core';\n\nimport { getKeyValueStoreDeleteActionProcessor } from './getKeyValueStoreDeleteActionProcessor';\nimport { getKeyValueStoreGetActionProcessor } from './getKeyValueStoreGetActionProcessor';\nimport { getKeyValueStoreGetAllActionProcessor } from './getKeyValueStoreGetAllActionProcessor';\nimport { getKeyValueStoreQueryActionProcessor } from './getKeyValueStoreQueryActionProcessor';\nimport { getKeyValueStoreScanActionProcessor } from './getKeyValueStoreScanActionProcessor';\nimport { getKeyValueStoreScanAllScopesActionProcessor } from './getKeyValueStoreScanAllScopesActionProcessor';\nimport { getKeyValueStoreUpdateActionProcessor } from './getKeyValueStoreUpdateActionProcessor';\nimport { getKeyValueStoreUpsertActionProcessor } from './getKeyValueStoreUpsertActionProcessor';\n\nexport const getKeyValueStoreActionProcessor: ActionProcessorListResolver = async (\n  qpqConfig: QPQConfig,\n  dynamicModuleLoader: DynamicModuleLoader,\n): Promise<ActionProcessorList> => ({\n  ...(await getKeyValueStoreDeleteActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreGetActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreGetAllActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreUpsertActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreUpdateActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreQueryActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreScanActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreScanAllScopesActionProcessor(qpqConfig, dynamicModuleLoader)),\n});\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/getActionProcessor/core/keyValueStore/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,mGAAgG;AAChG,6FAA0F;AAC1F,mGAAgG;AAChG,iGAA8F;AAC9F,+FAA4F;AAC5F,iHAA8G;AAC9G,mGAAgG;AAChG,mGAAgG;AAChG,2GAAwG;AAEjG,MAAM,+BAA+B,GAAgC,CAC1E,SAAoB,EACpB,mBAAwC,EACV,EAAE;IAAC,OAAA,mIAC9B,CAAC,MAAM,IAAA,6EAAqC,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,GAC7E,CAAC,MAAM,IAAA,uEAAkC,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,GAC1E,CAAC,MAAM,IAAA,6EAAqC,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,GAC7E,CAAC,MAAM,IAAA,6EAAqC,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,GAC7E,CAAC,MAAM,IAAA,qFAAyC,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,GACjF,CAAC,MAAM,IAAA,6EAAqC,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,GAC7E,CAAC,MAAM,IAAA,2EAAoC,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,GAC5E,CAAC,MAAM,IAAA,yEAAmC,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,GAC3E,CAAC,MAAM,IAAA,2FAA4C,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,EACvF,CAAA;EAAA,CAAC;AAbU,QAAA,+BAA+B,mCAazC","sourcesContent":["import { ActionProcessorList, ActionProcessorListResolver, DynamicModuleLoader, QPQConfig } from 'quidproquo-core';\n\nimport { getKeyValueStoreDeleteActionProcessor } from './getKeyValueStoreDeleteActionProcessor';\nimport { getKeyValueStoreGetActionProcessor } from './getKeyValueStoreGetActionProcessor';\nimport { getKeyValueStoreGetAllActionProcessor } from './getKeyValueStoreGetAllActionProcessor';\nimport { getKeyValueStoreQueryActionProcessor } from './getKeyValueStoreQueryActionProcessor';\nimport { getKeyValueStoreScanActionProcessor } from './getKeyValueStoreScanActionProcessor';\nimport { getKeyValueStoreScanAllScopesActionProcessor } from './getKeyValueStoreScanAllScopesActionProcessor';\nimport { getKeyValueStoreUpdateActionProcessor } from './getKeyValueStoreUpdateActionProcessor';\nimport { getKeyValueStoreUpsertActionProcessor } from './getKeyValueStoreUpsertActionProcessor';\nimport { getKeyValueStoreUpsertManyActionProcessor } from './getKeyValueStoreUpsertManyActionProcessor';\n\nexport const getKeyValueStoreActionProcessor: ActionProcessorListResolver = async (\n  qpqConfig: QPQConfig,\n  dynamicModuleLoader: DynamicModuleLoader,\n): Promise<ActionProcessorList> => ({\n  ...(await getKeyValueStoreDeleteActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreGetActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreGetAllActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreUpsertActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreUpsertManyActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreUpdateActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreQueryActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreScanActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreScanAllScopesActionProcessor(qpqConfig, dynamicModuleLoader)),\n});\n"]}

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

@@ -0,0 +1,5 @@
+import { KvsObjectDataType } from 'quidproquo-core';
+export declare class BatchWriteUnprocessedItemsError extends Error {
+    constructor(tableName: string, unprocessedCount: number, attempts: number);
+}
+export declare function batchPutItems(tableName: string, items: KvsObjectDataType[], region: string): Promise<void>;

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

@@ -0,0 +1,62 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchWriteUnprocessedItemsError = void 0;
+exports.batchPutItems = batchPutItems;
+const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
+const createAwsClient_1 = require("../createAwsClient");
+const qpqDynamoOrm_1 = require("./qpqDynamoOrm");
+// BatchWriteItem accepts at most 25 writes per call.
+const BATCH_WRITE_MAX_ITEMS = 25;
+// UnprocessedItems is DynamoDB's throttle back-pressure, not an error: the
+// service accepted part of the batch and hands the rest back for resubmission.
+// Retry with backoff; only a batch that STAYS unprocessed is a real failure.
+const MAX_UNPROCESSED_RETRIES = 8;
+const RETRY_BASE_DELAY_MS = 50;
+// Errors are matched by NAME in the processors' error tables, so the name is
+// the API. Exhausted retries mean sustained throttle — a transient fault the
+// processor must classify as ServiceUnavailable, never a generic (permanent)
+// failure.
+class BatchWriteUnprocessedItemsError extends Error {
+    constructor(tableName, unprocessedCount, attempts) {
+        super(`BatchWriteItem to [${tableName}] still has ${unprocessedCount} unprocessed items after ${attempts} attempts`);
+        this.name = 'BatchWriteUnprocessedItemsError';
+    }
+}
+exports.BatchWriteUnprocessedItemsError = BatchWriteUnprocessedItemsError;
+const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+// Unconditional batched puts. No ConditionExpression exists on BatchWriteItem,
+// so unlike putItem there is no ifNotExists — callers must only batch items
+// whose keys are unique by construction (see askKeyValueStoreUpsertMany).
+function batchPutItems(tableName, items, region) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const dynamoDBClient = (0, createAwsClient_1.createAwsClient)(client_dynamodb_1.DynamoDBClient, { region });
+        for (let offset = 0; offset < items.length; offset += BATCH_WRITE_MAX_ITEMS) {
+            let writeRequests = items
+                .slice(offset, offset + BATCH_WRITE_MAX_ITEMS)
+                .map((item) => ({ PutRequest: { Item: (0, qpqDynamoOrm_1.convertObjectToDynamoItem)(item) } }));
+            for (let attempt = 0; writeRequests.length > 0; attempt += 1) {
+                if (attempt > MAX_UNPROCESSED_RETRIES) {
+                    throw new BatchWriteUnprocessedItemsError(tableName, writeRequests.length, attempt);
+                }
+                if (attempt > 0) {
+                    yield delay(RETRY_BASE_DELAY_MS * Math.pow(2, (attempt - 1)));
+                }
+                const response = yield dynamoDBClient.send(new client_dynamodb_1.BatchWriteItemCommand({
+                    RequestItems: { [tableName]: writeRequests },
+                }));
+                writeRequests = (_b = (_a = response.UnprocessedItems) === null || _a === void 0 ? void 0 : _a[tableName]) !== null && _b !== void 0 ? _b : [];
+            }
+        }
+    });
+}
+//# sourceMappingURL=batchPutItems.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batchPutItems.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/batchPutItems.ts"],"names":[],"mappings":";;;;;;;;;;;;AAgCA,sCA0BC;AAxDD,8DAA+F;AAE/F,wDAAqD;AACrD,iDAA2D;AAE3D,qDAAqD;AACrD,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC,2EAA2E;AAC3E,+EAA+E;AAC/E,6EAA6E;AAC7E,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAClC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,WAAW;AACX,MAAa,+BAAgC,SAAQ,KAAK;IACxD,YAAY,SAAiB,EAAE,gBAAwB,EAAE,QAAgB;QACvE,KAAK,CAAC,sBAAsB,SAAS,eAAe,gBAAgB,4BAA4B,QAAQ,WAAW,CAAC,CAAC;QACrH,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;IAChD,CAAC;CACF;AALD,0EAKC;AAED,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAEhF,+EAA+E;AAC/E,4EAA4E;AAC5E,0EAA0E;AAC1E,SAAsB,aAAa,CAAC,SAAiB,EAAE,KAA0B,EAAE,MAAc;;;QAC/F,MAAM,cAAc,GAAG,IAAA,iCAAe,EAAC,gCAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnE,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,qBAAqB,EAAE,CAAC;YAC5E,IAAI,aAAa,GAAmB,KAAK;iBACtC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAAC;iBAC7C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,IAAA,wCAAyB,EAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAE9E,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;gBAC7D,IAAI,OAAO,GAAG,uBAAuB,EAAE,CAAC;oBACtC,MAAM,IAAI,+BAA+B,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACtF,CAAC;gBAED,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBAChB,MAAM,KAAK,CAAC,mBAAmB,GAAG,SAAA,CAAC,EAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAA,CAAC,CAAC;gBACxD,CAAC;gBAED,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,IAAI,CACxC,IAAI,uCAAqB,CAAC;oBACxB,YAAY,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE;iBAC7C,CAAC,CACH,CAAC;gBAEF,aAAa,GAAG,MAAA,MAAA,QAAQ,CAAC,gBAAgB,0CAAG,SAAS,CAAC,mCAAI,EAAE,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;CAAA","sourcesContent":["import { KvsObjectDataType } from 'quidproquo-core';\n\nimport { BatchWriteItemCommand, DynamoDBClient, WriteRequest } from '@aws-sdk/client-dynamodb';\n\nimport { createAwsClient } from '../createAwsClient';\nimport { convertObjectToDynamoItem } from './qpqDynamoOrm';\n\n// BatchWriteItem accepts at most 25 writes per call.\nconst BATCH_WRITE_MAX_ITEMS = 25;\n\n// UnprocessedItems is DynamoDB's throttle back-pressure, not an error: the\n// service accepted part of the batch and hands the rest back for resubmission.\n// Retry with backoff; only a batch that STAYS unprocessed is a real failure.\nconst MAX_UNPROCESSED_RETRIES = 8;\nconst RETRY_BASE_DELAY_MS = 50;\n\n// Errors are matched by NAME in the processors' error tables, so the name is\n// the API. Exhausted retries mean sustained throttle — a transient fault the\n// processor must classify as ServiceUnavailable, never a generic (permanent)\n// failure.\nexport class BatchWriteUnprocessedItemsError extends Error {\n  constructor(tableName: string, unprocessedCount: number, attempts: number) {\n    super(`BatchWriteItem to [${tableName}] still has ${unprocessedCount} unprocessed items after ${attempts} attempts`);\n    this.name = 'BatchWriteUnprocessedItemsError';\n  }\n}\n\nconst delay = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));\n\n// Unconditional batched puts. No ConditionExpression exists on BatchWriteItem,\n// so unlike putItem there is no ifNotExists — callers must only batch items\n// whose keys are unique by construction (see askKeyValueStoreUpsertMany).\nexport async function batchPutItems(tableName: string, items: KvsObjectDataType[], region: string): Promise<void> {\n  const dynamoDBClient = createAwsClient(DynamoDBClient, { region });\n\n  for (let offset = 0; offset < items.length; offset += BATCH_WRITE_MAX_ITEMS) {\n    let writeRequests: WriteRequest[] = items\n      .slice(offset, offset + BATCH_WRITE_MAX_ITEMS)\n      .map((item) => ({ PutRequest: { Item: convertObjectToDynamoItem(item) } }));\n\n    for (let attempt = 0; writeRequests.length > 0; attempt += 1) {\n      if (attempt > MAX_UNPROCESSED_RETRIES) {\n        throw new BatchWriteUnprocessedItemsError(tableName, writeRequests.length, attempt);\n      }\n\n      if (attempt > 0) {\n        await delay(RETRY_BASE_DELAY_MS * 2 ** (attempt - 1));\n      }\n\n      const response = await dynamoDBClient.send(\n        new BatchWriteItemCommand({\n          RequestItems: { [tableName]: writeRequests },\n        }),\n      );\n\n      writeRequests = response.UnprocessedItems?.[tableName] ?? [];\n    }\n  }\n}\n"]}

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

@@ -1,3 +1,4 @@
+export * from './batchPutItems';
 export * from './convertDynamoMapToObject';
 export * from './deleteItem';
 export * from './getAllItems';

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

@@ -14,6 +14,7 @@ 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("./batchPutItems"), exports);
 __exportStar(require("./convertDynamoMapToObject"), exports);
 __exportStar(require("./deleteItem"), exports);
 __exportStar(require("./getAllItems"), exports);

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,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"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,6DAA2C;AAC3C,+CAA6B;AAC7B,gDAA8B;AAC9B,4CAA0B;AAC1B,4CAA0B;AAC1B,0CAAwB;AACxB,yCAAuB;AACvB,+CAA6B","sourcesContent":["export * from './batchPutItems';\nexport * 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.js

@@ -13,16 +13,10 @@ exports.putItem = putItem;
 const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
 const createAwsClient_1 = require("../createAwsClient");
 const qpqDynamoOrm_1 = require("./qpqDynamoOrm");
-// 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;
-};
 function putItem(tableName, item, attributes, options, region) {
     return __awaiter(this, void 0, void 0, function* () {
         const dynamoDBClient = (0, createAwsClient_1.createAwsClient)(client_dynamodb_1.DynamoDBClient, { region });
-        yield dynamoDBClient.send(new client_dynamodb_1.PutItemCommand(Object.assign({ TableName: tableName, Item: convertObjectToDynamoItem(item) }, (options.ifNotExistsAttribute
+        yield dynamoDBClient.send(new client_dynamodb_1.PutItemCommand(Object.assign({ TableName: tableName, Item: (0, qpqDynamoOrm_1.convertObjectToDynamoItem)(item) }, (options.ifNotExistsAttribute
             ? {
                 ConditionExpression: 'attribute_not_exists(#ineAttr)',
                 ExpressionAttributeNames: { '#ineAttr': options.ifNotExistsAttribute },

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

@@ -1 +1 @@
-{"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"]}
+{"version":3,"file":"putItem.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/putItem.ts"],"names":[],"mappings":";;;;;;;;;;;AAsBA,0BAqBC;AAzCD,8DAA0E;AAE1E,wDAAqD;AACrD,iDAA2D;AAiB3D,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,IAAA,wCAAyB,EAAC,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 { DynamoDBClient, PutItemCommand } from '@aws-sdk/client-dynamodb';\n\nimport { createAwsClient } from '../createAwsClient';\nimport { convertObjectToDynamoItem } 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\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/convertObjectToDynamoItem.d.ts

@@ -0,0 +1,3 @@
+import { KvsObjectDataType } from 'quidproquo-core';
+import { AttributeValue } from '@aws-sdk/client-dynamodb';
+export declare const convertObjectToDynamoItem: (obj: KvsObjectDataType) => Record<string, AttributeValue>;

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

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertObjectToDynamoItem = void 0;
+const buildAttributeValue_1 = require("./buildAttributeValue");
+// 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, buildAttributeValue_1.buildAttributeValue)(obj).M;
+};
+exports.convertObjectToDynamoItem = convertObjectToDynamoItem;
+//# sourceMappingURL=convertObjectToDynamoItem.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"convertObjectToDynamoItem.js","sourceRoot":"","sources":["../../../../../src/logic/dynamo/qpqDynamoOrm/convertObjectToDynamoItem.ts"],"names":[],"mappings":";;;AAIA,+DAA4D;AAE5D,6EAA6E;AAC7E,2EAA2E;AAC3E,+DAA+D;AACxD,MAAM,yBAAyB,GAAG,CAAC,GAAsB,EAAkC,EAAE;IAClG,OAAO,IAAA,yCAAmB,EAAC,GAAG,CAAC,CAAC,CAAE,CAAC;AACrC,CAAC,CAAC;AAFW,QAAA,yBAAyB,6BAEpC","sourcesContent":["import { KvsObjectDataType } from 'quidproquo-core';\n\nimport { AttributeValue } from '@aws-sdk/client-dynamodb';\n\nimport { buildAttributeValue } from './buildAttributeValue';\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.\nexport const convertObjectToDynamoItem = (obj: KvsObjectDataType): Record<string, AttributeValue> => {\n  return buildAttributeValue(obj).M!;\n};\n"]}

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

@@ -1,4 +1,5 @@
 export * from './buildAttributeValue';
+export * from './convertObjectToDynamoItem';
 export * from './buildDynamoQueryExpression';
 export * from './buildDynamoUpdateExpression';
 export * from './buildExpressionAttributeNames';

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

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./buildAttributeValue"), exports);
+__exportStar(require("./convertObjectToDynamoItem"), exports);
 __exportStar(require("./buildDynamoQueryExpression"), exports);
 __exportStar(require("./buildDynamoUpdateExpression"), exports);
 __exportStar(require("./buildExpressionAttributeNames"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/logic/dynamo/qpqDynamoOrm/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,+DAA6C;AAC7C,gEAA8C;AAC9C,kEAAgD;AAChD,mEAAiD;AACjD,wEAAsD;AACtD,yEAAuD;AACvD,8DAA4C;AAC5C,wEAAsD;AACtD,4CAA0B;AAC1B,gDAA8B;AAC9B,iDAA+B;AAC/B,yDAAuC;AACvC,wDAAsC","sourcesContent":["export * from './buildAttributeValue';\nexport * from './buildDynamoQueryExpression';\nexport * from './buildDynamoUpdateExpression';\nexport * from './buildExpressionAttributeNames';\nexport * from './buildExpressionAttributeValues';\nexport * from './buildUpdateExpressionAttributeNames';\nexport * from './buildUpdateExpressionAttributeValues';\nexport * from './flattenKvsQueryConditions';\nexport * from './getDynamoTableIndexByConfigAndQuery';\nexport * from './getHash';\nexport * from './getItemName';\nexport * from './getValueName';\nexport * from './isKvsLogicalOperator';\nexport * from './isKvsQueryCondition';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/logic/dynamo/qpqDynamoOrm/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,8DAA4C;AAC5C,+DAA6C;AAC7C,gEAA8C;AAC9C,kEAAgD;AAChD,mEAAiD;AACjD,wEAAsD;AACtD,yEAAuD;AACvD,8DAA4C;AAC5C,wEAAsD;AACtD,4CAA0B;AAC1B,gDAA8B;AAC9B,iDAA+B;AAC/B,yDAAuC;AACvC,wDAAsC","sourcesContent":["export * from './buildAttributeValue';\nexport * from './convertObjectToDynamoItem';\nexport * from './buildDynamoQueryExpression';\nexport * from './buildDynamoUpdateExpression';\nexport * from './buildExpressionAttributeNames';\nexport * from './buildExpressionAttributeValues';\nexport * from './buildUpdateExpressionAttributeNames';\nexport * from './buildUpdateExpressionAttributeValues';\nexport * from './flattenKvsQueryConditions';\nexport * from './getDynamoTableIndexByConfigAndQuery';\nexport * from './getHash';\nexport * from './getItemName';\nexport * from './getValueName';\nexport * from './isKvsLogicalOperator';\nexport * from './isKvsQueryCondition';\n"]}

package/lib/esm/getActionProcessor/core/keyValueStore/getKeyValueStoreUpsertManyActionProcessor.d.ts

@@ -0,0 +1,2 @@
+import { ActionProcessorListResolver } from 'quidproquo-core';
+export declare const getKeyValueStoreUpsertManyActionProcessor: ActionProcessorListResolver;

package/lib/esm/getActionProcessor/core/keyValueStore/getKeyValueStoreUpsertManyActionProcessor.js

@@ -0,0 +1,49 @@
+import { qpqConfigAwsUtils } from 'quidproquo-config-aws';
+import { actionResult, actionResultError, actionResultErrorFromCaughtError, getScopedKvsTranslatorOrThrow, KeyValueStoreActionType, KeyValueStoreUpsertManyErrorTypeEnum, resolveKvsStoreConfigOrThrow, } from 'quidproquo-core';
+import { getKvsDynamoTableNameFromConfig } from '../../../awsNamingUtils';
+import { batchPutItems } from '../../../logic/dynamo';
+// The batch sibling of Upsert: BatchWriteItem in chunks of 25, partial-acceptance
+// retry inside batchPutItems. Streams emit one record per item no matter how it
+// was written, so downstream projectors see the same records as N single upserts.
+// Unconditional (no ifNotExists — BatchWriteItem carries no conditions).
+const getProcessKeyValueStoreUpsertMany = (qpqConfig) => {
+    return async ({ keyValueStoreName, items, options }) => {
+        const dynamoTableName = getKvsDynamoTableNameFromConfig(keyValueStoreName, qpqConfig, 'kvs');
+        const region = qpqConfigAwsUtils.getApplicationModuleDeployRegion(qpqConfig);
+        try {
+            const storeConfig = resolveKvsStoreConfigOrThrow(qpqConfig, keyValueStoreName);
+            // Same-key duplicates are rejected UP FRONT, before anything is written.
+            // Dynamo itself only rejects them when both land in the same 25-item
+            // chunk — across chunks the later write silently wins — so left to the
+            // service the outcome would depend on item position.
+            const seenKeys = new Set();
+            for (const item of items) {
+                const itemKey = [storeConfig.partitionKey, ...storeConfig.sortKeys].map((key) => String(item[key.key])).join('#');
+                if (seenKeys.has(itemKey)) {
+                    return actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.DuplicateKey, `Duplicate key [${itemKey}] in batch upsert to [${keyValueStoreName}]`);
+                }
+                seenKeys.add(itemKey);
+            }
+            // The scope lives inside the stored partition key value, so each item is
+            // persisted with a composed pk; reads strip it back off.
+            const scoped = getScopedKvsTranslatorOrThrow(qpqConfig, keyValueStoreName, options?.scope);
+            await batchPutItems(dynamoTableName, items.map((item) => scoped.item(item)), region);
+            return actionResult(void 0);
+        }
+        catch (error) {
+            return actionResultErrorFromCaughtError(error, {
+                InternalServerError: () => actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.ServiceUnavailable, 'KVS Service Unavailable'),
+                ResourceNotFoundException: () => actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.ResourceNotFound, 'KVS Resource Not Found'),
+                // Retries exhausted on UnprocessedItems — sustained throttle, a transient
+                // fault: callers must see ServiceUnavailable, not a permanent failure.
+                BatchWriteUnprocessedItemsError: () => actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.ServiceUnavailable, 'KVS batch write throttled'),
+                InvalidScopeError: (error) => actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.InvalidScope, error.message),
+                KvsStoreNotFoundError: (error) => actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.StoreNotFound, error.message),
+            });
+        }
+    };
+};
+export const getKeyValueStoreUpsertManyActionProcessor = async (qpqConfig) => ({
+    [KeyValueStoreActionType.UpsertMany]: getProcessKeyValueStoreUpsertMany(qpqConfig),
+});
+//# sourceMappingURL=getKeyValueStoreUpsertManyActionProcessor.js.map

package/lib/esm/getActionProcessor/core/keyValueStore/getKeyValueStoreUpsertManyActionProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getKeyValueStoreUpsertManyActionProcessor.js","sourceRoot":"","sources":["../../../../../src/getActionProcessor/core/keyValueStore/getKeyValueStoreUpsertManyActionProcessor.ts"],"names":[],"mappings":"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","sourcesContent":["import { qpqConfigAwsUtils } from 'quidproquo-config-aws';\nimport {\n  ActionProcessorList,\n  ActionProcessorListResolver,\n  actionResult,\n  actionResultError,\n  actionResultErrorFromCaughtError,\n  getScopedKvsTranslatorOrThrow,\n  KeyValueStoreActionType,\n  KeyValueStoreUpsertManyActionProcessor,\n  KeyValueStoreUpsertManyErrorTypeEnum,\n  QPQConfig,\n  resolveKvsStoreConfigOrThrow,\n} from 'quidproquo-core';\n\nimport { getKvsDynamoTableNameFromConfig } from '../../../awsNamingUtils';\nimport { batchPutItems } from '../../../logic/dynamo';\n\n// The batch sibling of Upsert: BatchWriteItem in chunks of 25, partial-acceptance\n// retry inside batchPutItems. Streams emit one record per item no matter how it\n// was written, so downstream projectors see the same records as N single upserts.\n// Unconditional (no ifNotExists — BatchWriteItem carries no conditions).\nconst getProcessKeyValueStoreUpsertMany = (qpqConfig: QPQConfig): KeyValueStoreUpsertManyActionProcessor<any> => {\n  return async ({ keyValueStoreName, items, options }) => {\n    const dynamoTableName = getKvsDynamoTableNameFromConfig(keyValueStoreName, qpqConfig, 'kvs');\n    const region = qpqConfigAwsUtils.getApplicationModuleDeployRegion(qpqConfig);\n\n    try {\n      const storeConfig = resolveKvsStoreConfigOrThrow(qpqConfig, keyValueStoreName);\n\n      // Same-key duplicates are rejected UP FRONT, before anything is written.\n      // Dynamo itself only rejects them when both land in the same 25-item\n      // chunk — across chunks the later write silently wins — so left to the\n      // service the outcome would depend on item position.\n      const seenKeys = new Set<string>();\n      for (const item of items) {\n        const itemKey = [storeConfig.partitionKey, ...storeConfig.sortKeys].map((key) => String(item[key.key])).join('#');\n        if (seenKeys.has(itemKey)) {\n          return actionResultError(\n            KeyValueStoreUpsertManyErrorTypeEnum.DuplicateKey,\n            `Duplicate key [${itemKey}] in batch upsert to [${keyValueStoreName}]`,\n          );\n        }\n        seenKeys.add(itemKey);\n      }\n\n      // The scope lives inside the stored partition key value, so each item is\n      // persisted with a composed pk; reads strip it back off.\n      const scoped = getScopedKvsTranslatorOrThrow(qpqConfig, keyValueStoreName, options?.scope);\n\n      await batchPutItems(\n        dynamoTableName,\n        items.map((item) => scoped.item(item)),\n        region,\n      );\n\n      return actionResult(void 0);\n    } catch (error: unknown) {\n      return actionResultErrorFromCaughtError(error, {\n        InternalServerError: () => actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.ServiceUnavailable, 'KVS Service Unavailable'),\n        ResourceNotFoundException: () => actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.ResourceNotFound, 'KVS Resource Not Found'),\n        // Retries exhausted on UnprocessedItems — sustained throttle, a transient\n        // fault: callers must see ServiceUnavailable, not a permanent failure.\n        BatchWriteUnprocessedItemsError: () =>\n          actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.ServiceUnavailable, 'KVS batch write throttled'),\n        InvalidScopeError: (error) => actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.InvalidScope, error.message),\n        KvsStoreNotFoundError: (error) => actionResultError(KeyValueStoreUpsertManyErrorTypeEnum.StoreNotFound, error.message),\n      });\n    }\n  };\n};\n\nexport const getKeyValueStoreUpsertManyActionProcessor: ActionProcessorListResolver = async (qpqConfig: QPQConfig): Promise<ActionProcessorList> => ({\n  [KeyValueStoreActionType.UpsertMany]: getProcessKeyValueStoreUpsertMany(qpqConfig),\n});\n"]}

package/lib/esm/getActionProcessor/core/keyValueStore/index.js

@@ -6,11 +6,13 @@ import { getKeyValueStoreScanActionProcessor } from './getKeyValueStoreScanActio
 import { getKeyValueStoreScanAllScopesActionProcessor } from './getKeyValueStoreScanAllScopesActionProcessor';
 import { getKeyValueStoreUpdateActionProcessor } from './getKeyValueStoreUpdateActionProcessor';
 import { getKeyValueStoreUpsertActionProcessor } from './getKeyValueStoreUpsertActionProcessor';
+import { getKeyValueStoreUpsertManyActionProcessor } from './getKeyValueStoreUpsertManyActionProcessor';
 export const getKeyValueStoreActionProcessor = async (qpqConfig, dynamicModuleLoader) => ({
     ...(await getKeyValueStoreDeleteActionProcessor(qpqConfig, dynamicModuleLoader)),
     ...(await getKeyValueStoreGetActionProcessor(qpqConfig, dynamicModuleLoader)),
     ...(await getKeyValueStoreGetAllActionProcessor(qpqConfig, dynamicModuleLoader)),
     ...(await getKeyValueStoreUpsertActionProcessor(qpqConfig, dynamicModuleLoader)),
+    ...(await getKeyValueStoreUpsertManyActionProcessor(qpqConfig, dynamicModuleLoader)),
     ...(await getKeyValueStoreUpdateActionProcessor(qpqConfig, dynamicModuleLoader)),
     ...(await getKeyValueStoreQueryActionProcessor(qpqConfig, dynamicModuleLoader)),
     ...(await getKeyValueStoreScanActionProcessor(qpqConfig, dynamicModuleLoader)),

package/lib/esm/getActionProcessor/core/keyValueStore/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/getActionProcessor/core/keyValueStore/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAAE,kCAAkC,EAAE,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAAE,oCAAoC,EAAE,MAAM,wCAAwC,CAAC;AAC9F,OAAO,EAAE,mCAAmC,EAAE,MAAM,uCAAuC,CAAC;AAC5F,OAAO,EAAE,4CAA4C,EAAE,MAAM,gDAAgD,CAAC;AAC9G,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC;AAEhG,MAAM,CAAC,MAAM,+BAA+B,GAAgC,KAAK,EAC/E,SAAoB,EACpB,mBAAwC,EACV,EAAE,CAAC,CAAC;IAClC,GAAG,CAAC,MAAM,qCAAqC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAChF,GAAG,CAAC,MAAM,kCAAkC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAC7E,GAAG,CAAC,MAAM,qCAAqC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAChF,GAAG,CAAC,MAAM,qCAAqC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAChF,GAAG,CAAC,MAAM,qCAAqC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAChF,GAAG,CAAC,MAAM,oCAAoC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAC/E,GAAG,CAAC,MAAM,mCAAmC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAC9E,GAAG,CAAC,MAAM,4CAA4C,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;CACxF,CAAC,CAAC","sourcesContent":["import { ActionProcessorList, ActionProcessorListResolver, DynamicModuleLoader, QPQConfig } from 'quidproquo-core';\n\nimport { getKeyValueStoreDeleteActionProcessor } from './getKeyValueStoreDeleteActionProcessor';\nimport { getKeyValueStoreGetActionProcessor } from './getKeyValueStoreGetActionProcessor';\nimport { getKeyValueStoreGetAllActionProcessor } from './getKeyValueStoreGetAllActionProcessor';\nimport { getKeyValueStoreQueryActionProcessor } from './getKeyValueStoreQueryActionProcessor';\nimport { getKeyValueStoreScanActionProcessor } from './getKeyValueStoreScanActionProcessor';\nimport { getKeyValueStoreScanAllScopesActionProcessor } from './getKeyValueStoreScanAllScopesActionProcessor';\nimport { getKeyValueStoreUpdateActionProcessor } from './getKeyValueStoreUpdateActionProcessor';\nimport { getKeyValueStoreUpsertActionProcessor } from './getKeyValueStoreUpsertActionProcessor';\n\nexport const getKeyValueStoreActionProcessor: ActionProcessorListResolver = async (\n  qpqConfig: QPQConfig,\n  dynamicModuleLoader: DynamicModuleLoader,\n): Promise<ActionProcessorList> => ({\n  ...(await getKeyValueStoreDeleteActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreGetActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreGetAllActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreUpsertActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreUpdateActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreQueryActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreScanActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreScanAllScopesActionProcessor(qpqConfig, dynamicModuleLoader)),\n});\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/getActionProcessor/core/keyValueStore/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAAE,kCAAkC,EAAE,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAAE,oCAAoC,EAAE,MAAM,wCAAwC,CAAC;AAC9F,OAAO,EAAE,mCAAmC,EAAE,MAAM,uCAAuC,CAAC;AAC5F,OAAO,EAAE,4CAA4C,EAAE,MAAM,gDAAgD,CAAC;AAC9G,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAAE,yCAAyC,EAAE,MAAM,6CAA6C,CAAC;AAExG,MAAM,CAAC,MAAM,+BAA+B,GAAgC,KAAK,EAC/E,SAAoB,EACpB,mBAAwC,EACV,EAAE,CAAC,CAAC;IAClC,GAAG,CAAC,MAAM,qCAAqC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAChF,GAAG,CAAC,MAAM,kCAAkC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAC7E,GAAG,CAAC,MAAM,qCAAqC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAChF,GAAG,CAAC,MAAM,qCAAqC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAChF,GAAG,CAAC,MAAM,yCAAyC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IACpF,GAAG,CAAC,MAAM,qCAAqC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAChF,GAAG,CAAC,MAAM,oCAAoC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAC/E,GAAG,CAAC,MAAM,mCAAmC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAC9E,GAAG,CAAC,MAAM,4CAA4C,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;CACxF,CAAC,CAAC","sourcesContent":["import { ActionProcessorList, ActionProcessorListResolver, DynamicModuleLoader, QPQConfig } from 'quidproquo-core';\n\nimport { getKeyValueStoreDeleteActionProcessor } from './getKeyValueStoreDeleteActionProcessor';\nimport { getKeyValueStoreGetActionProcessor } from './getKeyValueStoreGetActionProcessor';\nimport { getKeyValueStoreGetAllActionProcessor } from './getKeyValueStoreGetAllActionProcessor';\nimport { getKeyValueStoreQueryActionProcessor } from './getKeyValueStoreQueryActionProcessor';\nimport { getKeyValueStoreScanActionProcessor } from './getKeyValueStoreScanActionProcessor';\nimport { getKeyValueStoreScanAllScopesActionProcessor } from './getKeyValueStoreScanAllScopesActionProcessor';\nimport { getKeyValueStoreUpdateActionProcessor } from './getKeyValueStoreUpdateActionProcessor';\nimport { getKeyValueStoreUpsertActionProcessor } from './getKeyValueStoreUpsertActionProcessor';\nimport { getKeyValueStoreUpsertManyActionProcessor } from './getKeyValueStoreUpsertManyActionProcessor';\n\nexport const getKeyValueStoreActionProcessor: ActionProcessorListResolver = async (\n  qpqConfig: QPQConfig,\n  dynamicModuleLoader: DynamicModuleLoader,\n): Promise<ActionProcessorList> => ({\n  ...(await getKeyValueStoreDeleteActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreGetActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreGetAllActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreUpsertActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreUpsertManyActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreUpdateActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreQueryActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreScanActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getKeyValueStoreScanAllScopesActionProcessor(qpqConfig, dynamicModuleLoader)),\n});\n"]}

package/lib/esm/logic/dynamo/batchPutItems.d.ts

@@ -0,0 +1,5 @@
+import { KvsObjectDataType } from 'quidproquo-core';
+export declare class BatchWriteUnprocessedItemsError extends Error {
+    constructor(tableName: string, unprocessedCount: number, attempts: number);
+}
+export declare function batchPutItems(tableName: string, items: KvsObjectDataType[], region: string): Promise<void>;

package/lib/esm/logic/dynamo/batchPutItems.js

@@ -0,0 +1,45 @@
+import { BatchWriteItemCommand, DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { createAwsClient } from '../createAwsClient';
+import { convertObjectToDynamoItem } from './qpqDynamoOrm';
+// BatchWriteItem accepts at most 25 writes per call.
+const BATCH_WRITE_MAX_ITEMS = 25;
+// UnprocessedItems is DynamoDB's throttle back-pressure, not an error: the
+// service accepted part of the batch and hands the rest back for resubmission.
+// Retry with backoff; only a batch that STAYS unprocessed is a real failure.
+const MAX_UNPROCESSED_RETRIES = 8;
+const RETRY_BASE_DELAY_MS = 50;
+// Errors are matched by NAME in the processors' error tables, so the name is
+// the API. Exhausted retries mean sustained throttle — a transient fault the
+// processor must classify as ServiceUnavailable, never a generic (permanent)
+// failure.
+export class BatchWriteUnprocessedItemsError extends Error {
+    constructor(tableName, unprocessedCount, attempts) {
+        super(`BatchWriteItem to [${tableName}] still has ${unprocessedCount} unprocessed items after ${attempts} attempts`);
+        this.name = 'BatchWriteUnprocessedItemsError';
+    }
+}
+const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+// Unconditional batched puts. No ConditionExpression exists on BatchWriteItem,
+// so unlike putItem there is no ifNotExists — callers must only batch items
+// whose keys are unique by construction (see askKeyValueStoreUpsertMany).
+export async function batchPutItems(tableName, items, region) {
+    const dynamoDBClient = createAwsClient(DynamoDBClient, { region });
+    for (let offset = 0; offset < items.length; offset += BATCH_WRITE_MAX_ITEMS) {
+        let writeRequests = items
+            .slice(offset, offset + BATCH_WRITE_MAX_ITEMS)
+            .map((item) => ({ PutRequest: { Item: convertObjectToDynamoItem(item) } }));
+        for (let attempt = 0; writeRequests.length > 0; attempt += 1) {
+            if (attempt > MAX_UNPROCESSED_RETRIES) {
+                throw new BatchWriteUnprocessedItemsError(tableName, writeRequests.length, attempt);
+            }
+            if (attempt > 0) {
+                await delay(RETRY_BASE_DELAY_MS * 2 ** (attempt - 1));
+            }
+            const response = await dynamoDBClient.send(new BatchWriteItemCommand({
+                RequestItems: { [tableName]: writeRequests },
+            }));
+            writeRequests = response.UnprocessedItems?.[tableName] ?? [];
+        }
+    }
+}
+//# sourceMappingURL=batchPutItems.js.map

package/lib/esm/logic/dynamo/batchPutItems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchPutItems.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/batchPutItems.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAgB,MAAM,0BAA0B,CAAC;AAE/F,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,qDAAqD;AACrD,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC,2EAA2E;AAC3E,+EAA+E;AAC/E,6EAA6E;AAC7E,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAClC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,WAAW;AACX,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IACxD,YAAY,SAAiB,EAAE,gBAAwB,EAAE,QAAgB;QACvE,KAAK,CAAC,sBAAsB,SAAS,eAAe,gBAAgB,4BAA4B,QAAQ,WAAW,CAAC,CAAC;QACrH,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;IAChD,CAAC;CACF;AAED,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAEhF,+EAA+E;AAC/E,4EAA4E;AAC5E,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAiB,EAAE,KAA0B,EAAE,MAAc;IAC/F,MAAM,cAAc,GAAG,eAAe,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAEnE,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,qBAAqB,EAAE,CAAC;QAC5E,IAAI,aAAa,GAAmB,KAAK;aACtC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAAC;aAC7C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAE9E,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YAC7D,IAAI,OAAO,GAAG,uBAAuB,EAAE,CAAC;gBACtC,MAAM,IAAI,+BAA+B,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACtF,CAAC;YAED,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,MAAM,KAAK,CAAC,mBAAmB,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;YACxD,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,IAAI,CACxC,IAAI,qBAAqB,CAAC;gBACxB,YAAY,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE;aAC7C,CAAC,CACH,CAAC;YAEF,aAAa,GAAG,QAAQ,CAAC,gBAAgB,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC/D,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import { KvsObjectDataType } from 'quidproquo-core';\n\nimport { BatchWriteItemCommand, DynamoDBClient, WriteRequest } from '@aws-sdk/client-dynamodb';\n\nimport { createAwsClient } from '../createAwsClient';\nimport { convertObjectToDynamoItem } from './qpqDynamoOrm';\n\n// BatchWriteItem accepts at most 25 writes per call.\nconst BATCH_WRITE_MAX_ITEMS = 25;\n\n// UnprocessedItems is DynamoDB's throttle back-pressure, not an error: the\n// service accepted part of the batch and hands the rest back for resubmission.\n// Retry with backoff; only a batch that STAYS unprocessed is a real failure.\nconst MAX_UNPROCESSED_RETRIES = 8;\nconst RETRY_BASE_DELAY_MS = 50;\n\n// Errors are matched by NAME in the processors' error tables, so the name is\n// the API. Exhausted retries mean sustained throttle — a transient fault the\n// processor must classify as ServiceUnavailable, never a generic (permanent)\n// failure.\nexport class BatchWriteUnprocessedItemsError extends Error {\n  constructor(tableName: string, unprocessedCount: number, attempts: number) {\n    super(`BatchWriteItem to [${tableName}] still has ${unprocessedCount} unprocessed items after ${attempts} attempts`);\n    this.name = 'BatchWriteUnprocessedItemsError';\n  }\n}\n\nconst delay = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));\n\n// Unconditional batched puts. No ConditionExpression exists on BatchWriteItem,\n// so unlike putItem there is no ifNotExists — callers must only batch items\n// whose keys are unique by construction (see askKeyValueStoreUpsertMany).\nexport async function batchPutItems(tableName: string, items: KvsObjectDataType[], region: string): Promise<void> {\n  const dynamoDBClient = createAwsClient(DynamoDBClient, { region });\n\n  for (let offset = 0; offset < items.length; offset += BATCH_WRITE_MAX_ITEMS) {\n    let writeRequests: WriteRequest[] = items\n      .slice(offset, offset + BATCH_WRITE_MAX_ITEMS)\n      .map((item) => ({ PutRequest: { Item: convertObjectToDynamoItem(item) } }));\n\n    for (let attempt = 0; writeRequests.length > 0; attempt += 1) {\n      if (attempt > MAX_UNPROCESSED_RETRIES) {\n        throw new BatchWriteUnprocessedItemsError(tableName, writeRequests.length, attempt);\n      }\n\n      if (attempt > 0) {\n        await delay(RETRY_BASE_DELAY_MS * 2 ** (attempt - 1));\n      }\n\n      const response = await dynamoDBClient.send(\n        new BatchWriteItemCommand({\n          RequestItems: { [tableName]: writeRequests },\n        }),\n      );\n\n      writeRequests = response.UnprocessedItems?.[tableName] ?? [];\n    }\n  }\n}\n"]}

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

@@ -1,3 +1,4 @@
+export * from './batchPutItems';
 export * from './convertDynamoMapToObject';
 export * from './deleteItem';
 export * from './getAllItems';

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

@@ -1,3 +1,4 @@
+export * from './batchPutItems';
 export * from './convertDynamoMapToObject';
 export * from './deleteItem';
 export * from './getAllItems';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC","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"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC","sourcesContent":["export * from './batchPutItems';\nexport * 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/esm/logic/dynamo/putItem.js

@@ -1,12 +1,6 @@
 import { DynamoDBClient, PutItemCommand } from '@aws-sdk/client-dynamodb';
 import { createAwsClient } from '../createAwsClient';
-import { buildAttributeValue } from './qpqDynamoOrm';
-// 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 buildAttributeValue(obj).M;
-};
+import { convertObjectToDynamoItem } from './qpqDynamoOrm';
 export async function putItem(tableName, item, attributes, options, region) {
     const dynamoDBClient = createAwsClient(DynamoDBClient, { region });
     await dynamoDBClient.send(new PutItemCommand({

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

@@ -1 +1 @@
-{"version":3,"file":"putItem.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/putItem.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,cAAc,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1F,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAiBrD,6EAA6E;AAC7E,2EAA2E;AAC3E,+DAA+D;AAC/D,MAAM,yBAAyB,GAAG,CAAC,GAAsB,EAAkC,EAAE;IAC3F,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC;AACrC,CAAC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,SAAiB,EACjB,IAAuB,EACvB,UAAoB,EACpB,OAAuB,EACvB,MAAc;IAEd,MAAM,cAAc,GAAG,eAAe,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAEnE,MAAM,cAAc,CAAC,IAAI,CACvB,IAAI,cAAc,CAAC;QACjB,SAAS,EAAE,SAAS;QACpB,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC;QACrC,GAAG,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;KACR,CAAC,CACH,CAAC;AACJ,CAAC","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"]}
+{"version":3,"file":"putItem.js","sourceRoot":"","sources":["../../../../src/logic/dynamo/putItem.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAiB3D,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,SAAiB,EACjB,IAAuB,EACvB,UAAoB,EACpB,OAAuB,EACvB,MAAc;IAEd,MAAM,cAAc,GAAG,eAAe,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAEnE,MAAM,cAAc,CAAC,IAAI,CACvB,IAAI,cAAc,CAAC;QACjB,SAAS,EAAE,SAAS;QACpB,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC;QACrC,GAAG,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;KACR,CAAC,CACH,CAAC;AACJ,CAAC","sourcesContent":["import { KvsKey, KvsObjectDataType } from 'quidproquo-core';\n\nimport { DynamoDBClient, PutItemCommand } from '@aws-sdk/client-dynamodb';\n\nimport { createAwsClient } from '../createAwsClient';\nimport { convertObjectToDynamoItem } 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\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/esm/logic/dynamo/qpqDynamoOrm/convertObjectToDynamoItem.d.ts

@@ -0,0 +1,3 @@
+import { KvsObjectDataType } from 'quidproquo-core';
+import { AttributeValue } from '@aws-sdk/client-dynamodb';
+export declare const convertObjectToDynamoItem: (obj: KvsObjectDataType) => Record<string, AttributeValue>;

package/lib/esm/logic/dynamo/qpqDynamoOrm/convertObjectToDynamoItem.js

@@ -0,0 +1,8 @@
+import { buildAttributeValue } from './buildAttributeValue';
+// 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.
+export const convertObjectToDynamoItem = (obj) => {
+    return buildAttributeValue(obj).M;
+};
+//# sourceMappingURL=convertObjectToDynamoItem.js.map

package/lib/esm/logic/dynamo/qpqDynamoOrm/convertObjectToDynamoItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertObjectToDynamoItem.js","sourceRoot":"","sources":["../../../../../src/logic/dynamo/qpqDynamoOrm/convertObjectToDynamoItem.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,6EAA6E;AAC7E,2EAA2E;AAC3E,+DAA+D;AAC/D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAsB,EAAkC,EAAE;IAClG,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC;AACrC,CAAC,CAAC","sourcesContent":["import { KvsObjectDataType } from 'quidproquo-core';\n\nimport { AttributeValue } from '@aws-sdk/client-dynamodb';\n\nimport { buildAttributeValue } from './buildAttributeValue';\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.\nexport const convertObjectToDynamoItem = (obj: KvsObjectDataType): Record<string, AttributeValue> => {\n  return buildAttributeValue(obj).M!;\n};\n"]}

package/lib/esm/logic/dynamo/qpqDynamoOrm/index.d.ts

@@ -1,4 +1,5 @@
 export * from './buildAttributeValue';
+export * from './convertObjectToDynamoItem';
 export * from './buildDynamoQueryExpression';
 export * from './buildDynamoUpdateExpression';
 export * from './buildExpressionAttributeNames';

package/lib/esm/logic/dynamo/qpqDynamoOrm/index.js

@@ -1,4 +1,5 @@
 export * from './buildAttributeValue';
+export * from './convertObjectToDynamoItem';
 export * from './buildDynamoQueryExpression';
 export * from './buildDynamoUpdateExpression';
 export * from './buildExpressionAttributeNames';

package/lib/esm/logic/dynamo/qpqDynamoOrm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/logic/dynamo/qpqDynamoOrm/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC","sourcesContent":["export * from './buildAttributeValue';\nexport * from './buildDynamoQueryExpression';\nexport * from './buildDynamoUpdateExpression';\nexport * from './buildExpressionAttributeNames';\nexport * from './buildExpressionAttributeValues';\nexport * from './buildUpdateExpressionAttributeNames';\nexport * from './buildUpdateExpressionAttributeValues';\nexport * from './flattenKvsQueryConditions';\nexport * from './getDynamoTableIndexByConfigAndQuery';\nexport * from './getHash';\nexport * from './getItemName';\nexport * from './getValueName';\nexport * from './isKvsLogicalOperator';\nexport * from './isKvsQueryCondition';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/logic/dynamo/qpqDynamoOrm/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC","sourcesContent":["export * from './buildAttributeValue';\nexport * from './convertObjectToDynamoItem';\nexport * from './buildDynamoQueryExpression';\nexport * from './buildDynamoUpdateExpression';\nexport * from './buildExpressionAttributeNames';\nexport * from './buildExpressionAttributeValues';\nexport * from './buildUpdateExpressionAttributeNames';\nexport * from './buildUpdateExpressionAttributeValues';\nexport * from './flattenKvsQueryConditions';\nexport * from './getDynamoTableIndexByConfigAndQuery';\nexport * from './getHash';\nexport * from './getItemName';\nexport * from './getValueName';\nexport * from './isKvsLogicalOperator';\nexport * from './isKvsQueryCondition';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quidproquo-actionprocessor-awslambda",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/esm/index.js",
@@ -63,11 +63,11 @@
     "lodash": "^4.17.21",
     "node-cache": "^5.1.2",
     "node-match-path": "^0.6.3",
-    "quidproquo-actionprocessor-js": "0.1.14",
-    "quidproquo-actionprocessor-node": "0.1.14",
-    "quidproquo-config-aws": "0.1.14",
-    "quidproquo-core": "0.1.14",
-    "quidproquo-webserver": "0.1.14"
+    "quidproquo-actionprocessor-js": "0.1.16",
+    "quidproquo-actionprocessor-node": "0.1.16",
+    "quidproquo-config-aws": "0.1.16",
+    "quidproquo-core": "0.1.16",
+    "quidproquo-webserver": "0.1.16"
   },
   "devDependencies": {
     "@types/busboy": "^1.5.0",
@@ -75,7 +75,7 @@
     "@types/lodash": "^4.14.194",
     "@types/node": "^22.13.13",
     "esbuild": "^0.25.8",
-    "quidproquo-tsconfig": "0.1.14",
+    "quidproquo-tsconfig": "0.1.16",
     "typescript": "^5.8.2"
   }
 }