@farukada/aws-langgraph-dynamodb-ts 0.2.2 → 0.3.1

package/dist/shared/codec/s3/read-write.d.ts

@@ -0,0 +1,14 @@
+import type { S3Client } from '@aws-sdk/client-s3';
+/** Parameters for {@link uploadObject}. */
+export interface UploadParams {
+    bucket: string;
+    key: string;
+    data: Uint8Array;
+    serverSideEncryption?: string;
+    sseKmsKeyId?: string;
+}
+/** Upload `data` to S3, wrapping failures as `S3_OFFLOAD_FAILED`. */
+export declare function uploadObject(client: S3Client, params: UploadParams): Promise<void>;
+/** Download an object's bytes, wrapping failures/empty bodies as `S3_OFFLOAD_FAILED`. */
+export declare function downloadObject(client: S3Client, bucket: string, key: string): Promise<Uint8Array>;
+//# sourceMappingURL=read-write.d.ts.map

package/dist/shared/codec/s3/read-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-write.d.ts","sourceRoot":"","sources":["../../../../src/shared/codec/s3/read-write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAwB,MAAM,oBAAoB,CAAC;AAMzE,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qEAAqE;AACrE,wBAAsB,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBxF;AAED,yFAAyF;AACzF,wBAAsB,cAAc,CAClC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,CAAC,CAWrB"}

package/dist/shared/codec/s3/read-write.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadObject = uploadObject;
+exports.downloadObject = downloadObject;
+const error_code_1 = require("../../errors/error-code");
+const wrap_error_1 = require("../../errors/wrap-error");
+const client_1 = require("./client");
+/** Upload `data` to S3, wrapping failures as `S3_OFFLOAD_FAILED`. */
+async function uploadObject(client, params) {
+    const { PutObjectCommand } = await (0, client_1.loadS3Sdk)();
+    try {
+        await client.send(new PutObjectCommand({
+            Bucket: params.bucket,
+            Key: params.key,
+            Body: params.data,
+            ContentType: 'application/octet-stream',
+            ServerSideEncryption: params.serverSideEncryption,
+            ...(params.sseKmsKeyId ? { SSEKMSKeyId: params.sseKmsKeyId } : {}),
+        }));
+    }
+    catch (error) {
+        throw (0, wrap_error_1.wrapError)(error, error_code_1.ErrorCode.S3_OFFLOAD_FAILED, {
+            operation: 'upload',
+            key: params.key,
+        });
+    }
+}
+/** Download an object's bytes, wrapping failures/empty bodies as `S3_OFFLOAD_FAILED`. */
+async function downloadObject(client, bucket, key) {
+    const { GetObjectCommand } = await (0, client_1.loadS3Sdk)();
+    try {
+        const response = await client.send(new GetObjectCommand({ Bucket: bucket, Key: key }));
+        if (!response.Body) {
+            throw new Error(`S3 object body is empty for key: ${key}`);
+        }
+        return new Uint8Array(await response.Body.transformToByteArray());
+    }
+    catch (error) {
+        throw (0, wrap_error_1.wrapError)(error, error_code_1.ErrorCode.S3_OFFLOAD_FAILED, { operation: 'download', key });
+    }
+}
+//# sourceMappingURL=read-write.js.map

package/dist/shared/codec/s3/read-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-write.js","sourceRoot":"","sources":["../../../../src/shared/codec/s3/read-write.ts"],"names":[],"mappings":";;AAgBA,oCAmBC;AAGD,wCAeC;AAnDD,wDAAoD;AACpD,wDAAoD;AACpD,qCAAqC;AAWrC,qEAAqE;AAC9D,KAAK,UAAU,YAAY,CAAC,MAAgB,EAAE,MAAoB;IACvE,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,IAAA,kBAAS,GAAE,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CACf,IAAI,gBAAgB,CAAC;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,0BAA0B;YACvC,oBAAoB,EAAE,MAAM,CAAC,oBAAwD;YACrF,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC,CACH,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAA,sBAAS,EAAC,KAAc,EAAE,sBAAS,CAAC,iBAAiB,EAAE;YAC3D,SAAS,EAAE,QAAQ;YACnB,GAAG,EAAE,MAAM,CAAC,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,yFAAyF;AAClF,KAAK,UAAU,cAAc,CAClC,MAAgB,EAChB,MAAc,EACd,GAAW;IAEX,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,IAAA,kBAAS,GAAE,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACvF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAA,sBAAS,EAAC,KAAc,EAAE,sBAAS,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC"}

package/dist/shared/constants.d.ts

@@ -0,0 +1,37 @@
+/** Maximum TTL expressed in days (5 years). */
+export declare const MAX_TTL_DAYS: number;
+/** Maximum TTL expressed in seconds (100 years). */
+export declare const MAX_TTL_SECONDS: number;
+/** Hard cap on query-pagination loop iterations (runaway-loop guard). */
+export declare const MAX_LOOP_ITERATIONS = 1000;
+/** Hard cap on items collected into memory across a paginated query. */
+export declare const MAX_TOTAL_ITEMS_IN_MEMORY = 10000;
+/** DynamoDB BatchWriteItem maximum requests per call. */
+export declare const BATCH_WRITE_MAX = 25;
+/** DynamoDB BatchGetItem maximum keys per call. */
+export declare const BATCH_GET_MAX = 100;
+/** Maximum retries draining UnprocessedItems / UnprocessedKeys. */
+export declare const MAX_UNPROCESSED_RETRIES = 10;
+/** Starting delay for UnprocessedItems / UnprocessedKeys backoff loops. */
+export declare const INITIAL_BACKOFF_DELAY_MS = 100;
+/** Maximum backoff delay for retry loops. */
+export declare const MAX_BACKOFF_DELAY_MS = 5000;
+/** S3 DeleteObjects maximum keys per request. */
+export declare const S3_DELETE_BATCH_MAX = 1000;
+/** Default payload size that triggers S3 offload (350 KB; 50 KB under the DDB 400 KB cap). */
+export declare const DEFAULT_S3_THRESHOLD_BYTES: number;
+/** Default S3 key prefix for offloaded payloads. */
+export declare const DEFAULT_S3_KEY_PREFIX = "langgraph-checkpoints/";
+/** Default S3 server-side encryption algorithm. */
+export declare const DEFAULT_S3_SSE = "AES256";
+/** Default minimum payload size before gzip compression is attempted. */
+export declare const DEFAULT_COMPRESSION_MIN_BYTES = 1024;
+/** Default gzip compression level (balanced speed/ratio). */
+export declare const DEFAULT_COMPRESSION_LEVEL = 6;
+/** Default gzip-bomb guard: maximum decompressed output (50 MiB). */
+export declare const DEFAULT_MAX_DECOMPRESSED_BYTES: number;
+/** Default maximum attempts for transient-error retries. */
+export declare const DEFAULT_RETRY_MAX_ATTEMPTS = 5;
+/** Default cap on candidates the in-DB semantic ranker will score. */
+export declare const DEFAULT_MAX_SEARCH_CANDIDATES = 1000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/shared/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,eAAO,MAAM,YAAY,QAAU,CAAC;AAEpC,oDAAoD;AACpD,eAAO,MAAM,eAAe,QAA2B,CAAC;AAExD,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,wEAAwE;AACxE,eAAO,MAAM,yBAAyB,QAAQ,CAAC;AAE/C,yDAAyD;AACzD,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,mDAAmD;AACnD,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,iDAAiD;AACjD,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,8FAA8F;AAC9F,eAAO,MAAM,0BAA0B,QAAa,CAAC;AAErD,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAE9D,mDAAmD;AACnD,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,yEAAyE;AACzE,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD,6DAA6D;AAC7D,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,qEAAqE;AACrE,eAAO,MAAM,8BAA8B,QAAmB,CAAC;AAE/D,4DAA4D;AAC5D,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,sEAAsE;AACtE,eAAO,MAAM,6BAA6B,OAAO,CAAC"}

package/dist/shared/constants.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MAX_SEARCH_CANDIDATES = exports.DEFAULT_RETRY_MAX_ATTEMPTS = exports.DEFAULT_MAX_DECOMPRESSED_BYTES = exports.DEFAULT_COMPRESSION_LEVEL = exports.DEFAULT_COMPRESSION_MIN_BYTES = exports.DEFAULT_S3_SSE = exports.DEFAULT_S3_KEY_PREFIX = exports.DEFAULT_S3_THRESHOLD_BYTES = exports.S3_DELETE_BATCH_MAX = exports.MAX_BACKOFF_DELAY_MS = exports.INITIAL_BACKOFF_DELAY_MS = exports.MAX_UNPROCESSED_RETRIES = exports.BATCH_GET_MAX = exports.BATCH_WRITE_MAX = exports.MAX_TOTAL_ITEMS_IN_MEMORY = exports.MAX_LOOP_ITERATIONS = exports.MAX_TTL_SECONDS = exports.MAX_TTL_DAYS = void 0;
+/** Maximum TTL expressed in days (5 years). */
+exports.MAX_TTL_DAYS = 365 * 5;
+/** Maximum TTL expressed in seconds (100 years). */
+exports.MAX_TTL_SECONDS = 100 * 365 * 24 * 60 * 60;
+/** Hard cap on query-pagination loop iterations (runaway-loop guard). */
+exports.MAX_LOOP_ITERATIONS = 1000;
+/** Hard cap on items collected into memory across a paginated query. */
+exports.MAX_TOTAL_ITEMS_IN_MEMORY = 10000;
+/** DynamoDB BatchWriteItem maximum requests per call. */
+exports.BATCH_WRITE_MAX = 25;
+/** DynamoDB BatchGetItem maximum keys per call. */
+exports.BATCH_GET_MAX = 100;
+/** Maximum retries draining UnprocessedItems / UnprocessedKeys. */
+exports.MAX_UNPROCESSED_RETRIES = 10;
+/** Starting delay for UnprocessedItems / UnprocessedKeys backoff loops. */
+exports.INITIAL_BACKOFF_DELAY_MS = 100;
+/** Maximum backoff delay for retry loops. */
+exports.MAX_BACKOFF_DELAY_MS = 5000;
+/** S3 DeleteObjects maximum keys per request. */
+exports.S3_DELETE_BATCH_MAX = 1000;
+/** Default payload size that triggers S3 offload (350 KB; 50 KB under the DDB 400 KB cap). */
+exports.DEFAULT_S3_THRESHOLD_BYTES = 350 * 1024;
+/** Default S3 key prefix for offloaded payloads. */
+exports.DEFAULT_S3_KEY_PREFIX = 'langgraph-checkpoints/';
+/** Default S3 server-side encryption algorithm. */
+exports.DEFAULT_S3_SSE = 'AES256';
+/** Default minimum payload size before gzip compression is attempted. */
+exports.DEFAULT_COMPRESSION_MIN_BYTES = 1024;
+/** Default gzip compression level (balanced speed/ratio). */
+exports.DEFAULT_COMPRESSION_LEVEL = 6;
+/** Default gzip-bomb guard: maximum decompressed output (50 MiB). */
+exports.DEFAULT_MAX_DECOMPRESSED_BYTES = 50 * 1024 * 1024;
+/** Default maximum attempts for transient-error retries. */
+exports.DEFAULT_RETRY_MAX_ATTEMPTS = 5;
+/** Default cap on candidates the in-DB semantic ranker will score. */
+exports.DEFAULT_MAX_SEARCH_CANDIDATES = 1000;
+//# sourceMappingURL=constants.js.map

package/dist/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":";;;AAAA,+CAA+C;AAClC,QAAA,YAAY,GAAG,GAAG,GAAG,CAAC,CAAC;AAEpC,oDAAoD;AACvC,QAAA,eAAe,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAExD,yEAAyE;AAC5D,QAAA,mBAAmB,GAAG,IAAI,CAAC;AAExC,wEAAwE;AAC3D,QAAA,yBAAyB,GAAG,KAAK,CAAC;AAE/C,yDAAyD;AAC5C,QAAA,eAAe,GAAG,EAAE,CAAC;AAElC,mDAAmD;AACtC,QAAA,aAAa,GAAG,GAAG,CAAC;AAEjC,mEAAmE;AACtD,QAAA,uBAAuB,GAAG,EAAE,CAAC;AAE1C,2EAA2E;AAC9D,QAAA,wBAAwB,GAAG,GAAG,CAAC;AAE5C,6CAA6C;AAChC,QAAA,oBAAoB,GAAG,IAAI,CAAC;AAEzC,iDAAiD;AACpC,QAAA,mBAAmB,GAAG,IAAI,CAAC;AAExC,8FAA8F;AACjF,QAAA,0BAA0B,GAAG,GAAG,GAAG,IAAI,CAAC;AAErD,oDAAoD;AACvC,QAAA,qBAAqB,GAAG,wBAAwB,CAAC;AAE9D,mDAAmD;AACtC,QAAA,cAAc,GAAG,QAAQ,CAAC;AAEvC,yEAAyE;AAC5D,QAAA,6BAA6B,GAAG,IAAI,CAAC;AAElD,6DAA6D;AAChD,QAAA,yBAAyB,GAAG,CAAC,CAAC;AAE3C,qEAAqE;AACxD,QAAA,8BAA8B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/D,4DAA4D;AAC/C,QAAA,0BAA0B,GAAG,CAAC,CAAC;AAE5C,sEAAsE;AACzD,QAAA,6BAA6B,GAAG,IAAI,CAAC"}

package/dist/shared/dynamodb/backoff.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Sleep for `ms` milliseconds, cancellable via `signal`. If `signal` is already
+ * aborted the promise rejects synchronously with the abort reason (or an
+ * {@link AbortError}); otherwise the timer resolves and the listener is removed.
+ */
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+/** Next exponential-backoff delay: double `currentMs`, capped at `maxMs`. */
+export declare function nextBackoffDelay(currentMs: number, maxMs?: number): number;
+/**
+ * Apply AWS-recommended full jitter: a uniform random value in `[0, delayMs)`.
+ *
+ * @param rng - RNG seam returning `[0, 1)`. Defaults to `Math.random`.
+ */
+export declare function fullJitter(delayMs: number, rng?: () => number): number;
+//# sourceMappingURL=backoff.d.ts.map

package/dist/shared/dynamodb/backoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.d.ts","sourceRoot":"","sources":["../../../src/shared/dynamodb/backoff.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBrE;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAA6B,GAAG,MAAM,CAEhG;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,MAAoB,GAAG,MAAM,CAEnF"}

package/dist/shared/dynamodb/backoff.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = sleep;
+exports.nextBackoffDelay = nextBackoffDelay;
+exports.fullJitter = fullJitter;
+const constants_1 = require("../constants");
+const errors_1 = require("../errors/errors");
+/**
+ * Sleep for `ms` milliseconds, cancellable via `signal`. If `signal` is already
+ * aborted the promise rejects synchronously with the abort reason (or an
+ * {@link AbortError}); otherwise the timer resolves and the listener is removed.
+ */
+function sleep(ms, signal) {
+    if (signal?.aborted) {
+        return Promise.reject(signal.reason ?? new errors_1.AbortError());
+    }
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const onAbort = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            reject(signal?.reason ?? new errors_1.AbortError());
+        };
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/** Next exponential-backoff delay: double `currentMs`, capped at `maxMs`. */
+function nextBackoffDelay(currentMs, maxMs = constants_1.MAX_BACKOFF_DELAY_MS) {
+    return Math.min(currentMs * 2, maxMs);
+}
+/**
+ * Apply AWS-recommended full jitter: a uniform random value in `[0, delayMs)`.
+ *
+ * @param rng - RNG seam returning `[0, 1)`. Defaults to `Math.random`.
+ */
+function fullJitter(delayMs, rng = Math.random) {
+    return rng() * delayMs;
+}
+//# sourceMappingURL=backoff.js.map

package/dist/shared/dynamodb/backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.js","sourceRoot":"","sources":["../../../src/shared/dynamodb/backoff.ts"],"names":[],"mappings":";;AAQA,sBAoBC;AAGD,4CAEC;AAOD,gCAEC;AA1CD,4CAAoD;AACpD,6CAA8C;AAE9C;;;;GAIG;AACH,SAAgB,KAAK,CAAC,EAAU,EAAE,MAAoB;IACpD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,mBAAU,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,IAAI,mBAAU,EAAE,CAAC,CAAC;QAC7C,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,6EAA6E;AAC7E,SAAgB,gBAAgB,CAAC,SAAiB,EAAE,QAAgB,gCAAoB;IACtF,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,OAAe,EAAE,MAAoB,IAAI,CAAC,MAAM;IACzE,OAAO,GAAG,EAAE,GAAG,OAAO,CAAC;AACzB,CAAC"}

package/dist/shared/dynamodb/batch-write.d.ts

@@ -0,0 +1,10 @@
+import type { DynamoDBDocument } from '@aws-sdk/lib-dynamodb';
+import { DrainOptions } from './drain-unprocessed';
+import type { WriteRequest } from './types';
+/**
+ * Write an arbitrary number of requests, chunked into batches of 25 (the
+ * BatchWriteItem limit). Each batch drains its UnprocessedItems independently.
+ * Partial-success applies across batches — see {@link BatchWriteIncompleteError}.
+ */
+export declare function batchWriteAll(client: DynamoDBDocument, tableName: string, requests: WriteRequest[], options?: DrainOptions): Promise<void>;
+//# sourceMappingURL=batch-write.d.ts.map

package/dist/shared/dynamodb/batch-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-write.d.ts","sourceRoot":"","sources":["../../../src/shared/dynamodb/batch-write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,EAAE,YAAY,EAA0B,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/shared/dynamodb/batch-write.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.batchWriteAll = batchWriteAll;
+const constants_1 = require("../constants");
+const drain_unprocessed_1 = require("./drain-unprocessed");
+/**
+ * Write an arbitrary number of requests, chunked into batches of 25 (the
+ * BatchWriteItem limit). Each batch drains its UnprocessedItems independently.
+ * Partial-success applies across batches — see {@link BatchWriteIncompleteError}.
+ */
+async function batchWriteAll(client, tableName, requests, options = {}) {
+    for (let offset = 0; offset < requests.length; offset += constants_1.BATCH_WRITE_MAX) {
+        const chunk = requests.slice(offset, offset + constants_1.BATCH_WRITE_MAX);
+        await (0, drain_unprocessed_1.drainUnprocessedWrites)(client, tableName, chunk, options);
+    }
+}
+//# sourceMappingURL=batch-write.js.map

package/dist/shared/dynamodb/batch-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-write.js","sourceRoot":"","sources":["../../../src/shared/dynamodb/batch-write.ts"],"names":[],"mappings":";;AAWA,sCAUC;AAnBD,4CAA+C;AAC/C,2DAA2E;AAG3E;;;;GAIG;AACI,KAAK,UAAU,aAAa,CACjC,MAAwB,EACxB,SAAiB,EACjB,QAAwB,EACxB,UAAwB,EAAE;IAE1B,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,2BAAe,EAAE,CAAC;QACzE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,2BAAe,CAAC,CAAC;QAC/D,MAAM,IAAA,0CAAsB,EAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/shared/dynamodb/client.d.ts

@@ -0,0 +1,21 @@
+import { DynamoDBClient, type DynamoDBClientConfig } from '@aws-sdk/client-dynamodb';
+import { DynamoDBDocument } from '@aws-sdk/lib-dynamodb';
+/** A resolved DynamoDB client plus its ownership flag. */
+export interface ResolvedDynamoDBClient {
+    ddbClient: DynamoDBClient | undefined;
+    client: DynamoDBDocument;
+    ownsClient: boolean;
+}
+/** Options for {@link resolveDynamoDBClient}. */
+export interface ResolveClientOptions {
+    client?: DynamoDBDocument;
+    clientConfig?: DynamoDBClientConfig;
+    createClient?: (config: DynamoDBClientConfig) => DynamoDBClient;
+}
+/**
+ * Resolve the DocumentClient for an adapter. An injected `client` is used as-is
+ * and not owned; otherwise a client is built from `clientConfig` (via the
+ * `createClient` seam) and owned, so the adapter destroys it on `destroy()`.
+ */
+export declare function resolveDynamoDBClient(options: ResolveClientOptions): ResolvedDynamoDBClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/shared/dynamodb/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/shared/dynamodb/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,0DAA0D;AAC1D,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,cAAc,GAAG,SAAS,CAAC;IACtC,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,cAAc,CAAC;CACjE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,GAAG,sBAAsB,CAO3F"}

package/dist/shared/dynamodb/client.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDynamoDBClient = resolveDynamoDBClient;
+const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
+const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
+/**
+ * Resolve the DocumentClient for an adapter. An injected `client` is used as-is
+ * and not owned; otherwise a client is built from `clientConfig` (via the
+ * `createClient` seam) and owned, so the adapter destroys it on `destroy()`.
+ */
+function resolveDynamoDBClient(options) {
+    if (options.client) {
+        return { ddbClient: undefined, client: options.client, ownsClient: false };
+    }
+    const createClient = options.createClient ?? ((config) => new client_dynamodb_1.DynamoDBClient(config));
+    const ddbClient = createClient(options.clientConfig ?? {});
+    return { ddbClient, client: lib_dynamodb_1.DynamoDBDocument.from(ddbClient), ownsClient: true };
+}
+//# sourceMappingURL=client.js.map

package/dist/shared/dynamodb/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/shared/dynamodb/client.ts"],"names":[],"mappings":";;AAsBA,sDAOC;AA7BD,8DAAqF;AACrF,wDAAyD;AAgBzD;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,OAA6B;IACjE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC7E,CAAC;IACD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,gCAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACtF,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,+BAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACnF,CAAC"}

package/dist/shared/dynamodb/drain-unprocessed.d.ts

@@ -0,0 +1,15 @@
+import type { DynamoDBDocument } from '@aws-sdk/lib-dynamodb';
+import type { WriteRequest } from './types';
+/** Backoff/abort options shared by the drain helpers. */
+export interface DrainOptions {
+    signal?: AbortSignal;
+    rng?: () => number;
+    maxRetries?: number;
+}
+/**
+ * Submit `requests` via BatchWriteItem and re-submit UnprocessedItems with
+ * full-jitter backoff until the batch drains. Throws
+ * {@link BatchWriteIncompleteError} if it cannot drain within the retry budget.
+ */
+export declare function drainUnprocessedWrites(client: DynamoDBDocument, tableName: string, requests: WriteRequest[], options?: DrainOptions): Promise<void>;
+//# sourceMappingURL=drain-unprocessed.d.ts.map

package/dist/shared/dynamodb/drain-unprocessed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain-unprocessed.d.ts","sourceRoot":"","sources":["../../../src/shared/dynamodb/drain-unprocessed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAM9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/shared/dynamodb/drain-unprocessed.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.drainUnprocessedWrites = drainUnprocessedWrites;
+const constants_1 = require("../constants");
+const errors_1 = require("../errors/errors");
+const backoff_1 = require("./backoff");
+const retry_1 = require("./retry");
+/**
+ * Submit `requests` via BatchWriteItem and re-submit UnprocessedItems with
+ * full-jitter backoff until the batch drains. Throws
+ * {@link BatchWriteIncompleteError} if it cannot drain within the retry budget.
+ */
+async function drainUnprocessedWrites(client, tableName, requests, options = {}) {
+    if (requests.length === 0)
+        return;
+    const maxRetries = options.maxRetries ?? constants_1.MAX_UNPROCESSED_RETRIES;
+    const initialCount = requests.length;
+    let pending = requests;
+    let delay = constants_1.INITIAL_BACKOFF_DELAY_MS;
+    let retries = 0;
+    while (pending.length > 0) {
+        const result = await (0, retry_1.withDynamoDBRetry)(() => client.batchWrite({ RequestItems: { [tableName]: pending } }), { signal: options.signal });
+        const leftover = result.UnprocessedItems?.[tableName] ?? [];
+        if (leftover.length === 0)
+            return;
+        retries += 1;
+        if (retries > maxRetries) {
+            throw new errors_1.BatchWriteIncompleteError(initialCount - leftover.length, leftover, maxRetries);
+        }
+        await (0, backoff_1.sleep)((0, backoff_1.fullJitter)(delay, options.rng), options.signal);
+        delay = (0, backoff_1.nextBackoffDelay)(delay);
+        pending = leftover;
+    }
+}
+//# sourceMappingURL=drain-unprocessed.js.map

package/dist/shared/dynamodb/drain-unprocessed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain-unprocessed.js","sourceRoot":"","sources":["../../../src/shared/dynamodb/drain-unprocessed.ts"],"names":[],"mappings":";;AAoBA,wDA2BC;AA7CD,4CAAiF;AACjF,6CAA6D;AAC7D,uCAAgE;AAChE,mCAA4C;AAU5C;;;;GAIG;AACI,KAAK,UAAU,sBAAsB,CAC1C,MAAwB,EACxB,SAAiB,EACjB,QAAwB,EACxB,UAAwB,EAAE;IAE1B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAClC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mCAAuB,CAAC;IACjE,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC;IACrC,IAAI,OAAO,GAAG,QAAQ,CAAC;IACvB,IAAI,KAAK,GAAG,oCAAwB,CAAC;IACrC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAiB,EACpC,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,EACnE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC3B,CAAC;QACF,MAAM,QAAQ,GAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC,SAAS,CAAgC,IAAI,EAAE,CAAC;QAC5F,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAClC,OAAO,IAAI,CAAC,CAAC;QACb,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;YACzB,MAAM,IAAI,kCAAyB,CAAC,YAAY,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,IAAA,eAAK,EAAC,IAAA,oBAAU,EAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5D,KAAK,GAAG,IAAA,0BAAgB,EAAC,KAAK,CAAC,CAAC;QAChC,OAAO,GAAG,QAAQ,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/shared/dynamodb/paginate-core.d.ts

@@ -0,0 +1,22 @@
+import type { DocItem } from './types';
+/** One page of results plus the key to resume from (undefined when exhausted). */
+export interface PageResult {
+    items: DocItem[];
+    lastKey: DocItem | undefined;
+}
+/** Options shared by the paginators built on {@link paginatePages}. */
+export interface PaginateCoreOptions {
+    signal?: AbortSignal;
+    maxItems?: number;
+    maxIterations?: number;
+}
+/**
+ * Drive a paged DynamoDB read to completion, yielding each item. Continues past
+ * empty pages, honors the abort signal before each fetch, and enforces iteration
+ * + in-memory item caps. `fetchPage` performs one page read. When a cap is hit
+ * while more data remains, throws {@link ResultTruncatedError} rather than
+ * silently returning a partial result; pass `Infinity` caps to read to true
+ * completion (e.g. for deletes).
+ */
+export declare function paginatePages(fetchPage: (startKey: DocItem | undefined) => Promise<PageResult>, options?: PaginateCoreOptions): AsyncGenerator<DocItem>;
+//# sourceMappingURL=paginate-core.d.ts.map

package/dist/shared/dynamodb/paginate-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate-core.d.ts","sourceRoot":"","sources":["../../../src/shared/dynamodb/paginate-core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,kFAAkF;AAClF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B;AAED,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA4BD;;;;;;;GAOG;AACH,wBAAuB,aAAa,CAClC,SAAS,EAAE,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,KAAK,OAAO,CAAC,UAAU,CAAC,EACjE,OAAO,GAAE,mBAAwB,GAChC,cAAc,CAAC,OAAO,CAAC,CAazB"}

package/dist/shared/dynamodb/paginate-core.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paginatePages = paginatePages;
+const constants_1 = require("../constants");
+const errors_1 = require("../errors/errors");
+/** True when stopping at `index` of `page` would leave unyielded data behind. */
+function moreDataRemains(page, index) {
+    return index < page.items.length - 1 || page.lastKey !== undefined;
+}
+/**
+ * Yield one page's items, counting toward the shared `state.yielded` budget.
+ * Returns `true` when the in-memory cap is reached (caller stops); throws
+ * {@link ResultTruncatedError} if stopping would leave unyielded data behind.
+ */
+async function* yieldPageItems(page, state, maxItems) {
+    for (let index = 0; index < page.items.length; index++) {
+        yield page.items[index];
+        state.yielded += 1;
+        if (state.yielded >= maxItems) {
+            if (moreDataRemains(page, index))
+                throw new errors_1.ResultTruncatedError('maxItems', maxItems);
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Drive a paged DynamoDB read to completion, yielding each item. Continues past
+ * empty pages, honors the abort signal before each fetch, and enforces iteration
+ * + in-memory item caps. `fetchPage` performs one page read. When a cap is hit
+ * while more data remains, throws {@link ResultTruncatedError} rather than
+ * silently returning a partial result; pass `Infinity` caps to read to true
+ * completion (e.g. for deletes).
+ */
+async function* paginatePages(fetchPage, options = {}) {
+    const maxItems = options.maxItems ?? constants_1.MAX_TOTAL_ITEMS_IN_MEMORY;
+    const maxIterations = options.maxIterations ?? constants_1.MAX_LOOP_ITERATIONS;
+    const state = { yielded: 0 };
+    let startKey;
+    for (let iteration = 0; iteration < maxIterations; iteration++) {
+        if (options.signal?.aborted)
+            throw new errors_1.AbortError();
+        const page = await fetchPage(startKey);
+        if (yield* yieldPageItems(page, state, maxItems))
+            return;
+        startKey = page.lastKey;
+        if (startKey === undefined)
+            return;
+    }
+    throw new errors_1.ResultTruncatedError('maxIterations', maxIterations);
+}
+//# sourceMappingURL=paginate-core.js.map

package/dist/shared/dynamodb/paginate-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate-core.js","sourceRoot":"","sources":["../../../src/shared/dynamodb/paginate-core.ts"],"names":[],"mappings":";;AAmDA,sCAgBC;AAnED,4CAA8E;AAC9E,6CAAoE;AAgBpE,iFAAiF;AACjF,SAAS,eAAe,CAAC,IAAgB,EAAE,KAAa;IACtD,OAAO,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,KAAK,SAAS,CAAC,CAAC,cAAc,CAC5B,IAAgB,EAChB,KAA0B,EAC1B,QAAgB;IAEhB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACvD,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACxB,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QACnB,IAAI,KAAK,CAAC,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC9B,IAAI,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC;gBAAE,MAAM,IAAI,6BAAoB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YACvF,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,SAAS,CAAC,CAAC,aAAa,CAClC,SAAiE,EACjE,UAA+B,EAAE;IAEjC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,qCAAyB,CAAC;IAC/D,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,+BAAmB,CAAC;IACnE,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC7B,IAAI,QAA6B,CAAC;IAClC,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,aAAa,EAAE,SAAS,EAAE,EAAE,CAAC;QAC/D,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;YAAE,MAAM,IAAI,mBAAU,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO;QACzD,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QACxB,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO;IACrC,CAAC;IACD,MAAM,IAAI,6BAAoB,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;AACjE,CAAC"}

package/dist/shared/dynamodb/paginate.d.ts

@@ -0,0 +1,15 @@
+import type { DynamoDBDocument, QueryCommandInput } from '@aws-sdk/lib-dynamodb';
+import { type PaginateCoreOptions } from './paginate-core';
+import type { DocItem } from './types';
+/** Options for {@link paginateQuery}. */
+export interface PaginateOptions extends PaginateCoreOptions {
+    client: DynamoDBDocument;
+    params: QueryCommandInput;
+}
+/**
+ * Drive a DynamoDB Query across all pages, yielding each item. Follows
+ * `LastEvaluatedKey`, honors the abort signal, wraps each page in
+ * {@link withDynamoDBRetry}, and enforces runaway guards via the shared core.
+ */
+export declare function paginateQuery(options: PaginateOptions): AsyncGenerator<DocItem>;
+//# sourceMappingURL=paginate.d.ts.map

package/dist/shared/dynamodb/paginate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.d.ts","sourceRoot":"","sources":["../../../src/shared/dynamodb/paginate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,OAAO,EAAE,KAAK,mBAAmB,EAAiB,MAAM,iBAAiB,CAAC;AAE1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,yCAAyC;AACzC,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAAC,OAAO,CAAC,CAW/E"}

package/dist/shared/dynamodb/paginate.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paginateQuery = paginateQuery;
+const paginate_core_1 = require("./paginate-core");
+const retry_1 = require("./retry");
+/**
+ * Drive a DynamoDB Query across all pages, yielding each item. Follows
+ * `LastEvaluatedKey`, honors the abort signal, wraps each page in
+ * {@link withDynamoDBRetry}, and enforces runaway guards via the shared core.
+ */
+function paginateQuery(options) {
+    return (0, paginate_core_1.paginatePages)(async (startKey) => {
+        const page = await (0, retry_1.withDynamoDBRetry)(() => options.client.query({ ...options.params, ExclusiveStartKey: startKey }), { signal: options.signal });
+        return {
+            items: page.Items ?? [],
+            lastKey: page.LastEvaluatedKey,
+        };
+    }, options);
+}
+//# sourceMappingURL=paginate.js.map

package/dist/shared/dynamodb/paginate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.js","sourceRoot":"","sources":["../../../src/shared/dynamodb/paginate.ts"],"names":[],"mappings":";;AAiBA,sCAWC;AA1BD,mDAA0E;AAC1E,mCAA4C;AAS5C;;;;GAIG;AACH,SAAgB,aAAa,CAAC,OAAwB;IACpD,OAAO,IAAA,6BAAa,EAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG,MAAM,IAAA,yBAAiB,EAClC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,EAC9E,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC3B,CAAC;QACF,OAAO;YACL,KAAK,EAAG,IAAI,CAAC,KAA+B,IAAI,EAAE;YAClD,OAAO,EAAE,IAAI,CAAC,gBAAuC;SACtD,CAAC;IACJ,CAAC,EAAE,OAAO,CAAC,CAAC;AACd,CAAC"}

package/dist/shared/dynamodb/retry-classifier.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Default retryable transient signals. TransactionCanceledException is
+ * intentionally absent (its reasons include permanent failures);
+ * TransactionConflictException (transient row contention) IS retryable.
+ */
+export declare const DEFAULT_RETRYABLE_ERRORS: readonly string[];
+/** True when `error` (or any cause in its chain) matches a retryable signal. */
+export declare function isRetryableError(error: Error, retryableErrors: readonly string[]): boolean;
+//# sourceMappingURL=retry-classifier.d.ts.map

package/dist/shared/dynamodb/retry-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-classifier.d.ts","sourceRoot":"","sources":["../../../src/shared/dynamodb/retry-classifier.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAcrD,CAAC;AAwDF,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAK1F"}

package/dist/shared/dynamodb/retry-classifier.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RETRYABLE_ERRORS = void 0;
+exports.isRetryableError = isRetryableError;
+const MAX_CAUSE_DEPTH = 32;
+/**
+ * Default retryable transient signals. TransactionCanceledException is
+ * intentionally absent (its reasons include permanent failures);
+ * TransactionConflictException (transient row contention) IS retryable.
+ */
+exports.DEFAULT_RETRYABLE_ERRORS = [
+    'ProvisionedThroughputExceededException',
+    'ThrottlingException',
+    'RequestLimitExceeded',
+    'InternalServerError',
+    'ServiceUnavailable',
+    'TransactionConflictException',
+    'ECONNRESET',
+    'ECONNREFUSED',
+    'ETIMEDOUT',
+    'EPIPE',
+    'EAI_AGAIN',
+    'NetworkingError',
+    'TimeoutError',
+];
+/**
+ * Cancellation reason codes (from a `TransactionCanceledException`'s
+ * `CancellationReasons`) that are transient and safe to retry. `None` marks an
+ * item that was not the cause and is ignored.
+ */
+const TRANSIENT_CANCELLATION_REASONS = [
+    'None',
+    'TransactionConflict',
+    'ThrottlingError',
+    'ProvisionedThroughputExceeded',
+];
+/**
+ * When `error` is a transaction cancellation carrying reasons, return whether
+ * every reason is transient; otherwise undefined so normal signal matching
+ * applies. A bare cancellation with no reasons is treated as non-retryable.
+ */
+function transactionCancellationRetryable(error) {
+    const reasons = error.CancellationReasons;
+    if (!reasons)
+        return undefined;
+    return reasons.every((reason) => reason.Code === undefined || TRANSIENT_CANCELLATION_REASONS.includes(reason.Code));
+}
+function collectSignals(error) {
+    const seen = new WeakSet();
+    const signals = [];
+    const walk = (node, depth) => {
+        if (depth > MAX_CAUSE_DEPTH || node === null || typeof node !== 'object' || seen.has(node)) {
+            return;
+        }
+        seen.add(node);
+        const fields = node;
+        for (const value of [fields.name, fields.code, fields.errno, fields.syscall]) {
+            if (typeof value === 'string')
+                signals.push(value);
+        }
+        if (fields.cause)
+            walk(fields.cause, depth + 1);
+    };
+    walk(error, 0);
+    return signals;
+}
+/** True when `error` (or any cause in its chain) matches a retryable signal. */
+function isRetryableError(error, retryableErrors) {
+    const cancellation = transactionCancellationRetryable(error);
+    if (cancellation !== undefined)
+        return cancellation;
+    const signals = collectSignals(error);
+    return signals.some((signal) => retryableErrors.some((retryable) => signal.includes(retryable)));
+}
+//# sourceMappingURL=retry-classifier.js.map

package/dist/shared/dynamodb/retry-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-classifier.js","sourceRoot":"","sources":["../../../src/shared/dynamodb/retry-classifier.ts"],"names":[],"mappings":";;;AA8EA,4CAKC;AAnFD,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B;;;;GAIG;AACU,QAAA,wBAAwB,GAAsB;IACzD,wCAAwC;IACxC,qBAAqB;IACrB,sBAAsB;IACtB,qBAAqB;IACrB,oBAAoB;IACpB,8BAA8B;IAC9B,YAAY;IACZ,cAAc;IACd,WAAW;IACX,OAAO;IACP,WAAW;IACX,iBAAiB;IACjB,cAAc;CACf,CAAC;AAEF;;;;GAIG;AACH,MAAM,8BAA8B,GAAsB;IACxD,MAAM;IACN,qBAAqB;IACrB,iBAAiB;IACjB,+BAA+B;CAChC,CAAC;AAOF;;;;GAIG;AACH,SAAS,gCAAgC,CAAC,KAAY;IACpD,MAAM,OAAO,GAAI,KAAwD,CAAC,mBAAmB,CAAC;IAC9F,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,OAAO,CAAC,KAAK,CAClB,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,8BAA8B,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAC9F,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAY;IAClC,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;IACnC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,CAAC,IAAW,EAAE,KAAa,EAAQ,EAAE;QAChD,IAAI,KAAK,GAAG,eAAe,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3F,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,MAAM,MAAM,GAAG,IAMd,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7E,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,MAAM,CAAC,KAAK;YAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC;IACF,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACf,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,SAAgB,gBAAgB,CAAC,KAAY,EAAE,eAAkC;IAC/E,MAAM,YAAY,GAAG,gCAAgC,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC;IACpD,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AACnG,CAAC"}