@farukada/aws-langgraph-dynamodb-ts 0.1.0 → 0.2.0

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

@@ -15,22 +15,60 @@ interface DeleteWriteRequest {
 }
 type WriteRequest = PutWriteRequest | DeleteWriteRequest;
 /**
- * Execute a single batchWrite call with exponential backoff retry for UnprocessedItems
+ * Error thrown when `batchWriteWithRetry` / `batchWriteAllWithRetry` exhaust
+ * their UnprocessedItems retry budget. Carries enough information for the
+ * caller to reason about recovery: how many items persisted before the giveup,
+ * how many are still un-acked, and which items remained un-acked.
+ *
+ * *Partial-success semantics:* DynamoDB's BatchWriteItem is not atomic across
+ * items in a batch, and `batchWriteAllWithRetry` issues a sequence of 25-item
+ * batches. When this error is thrown, any item not listed in `unprocessed` has
+ * already been acked by DynamoDB. Callers that need all-or-nothing must drive
+ * reconciliation from `unprocessed` (retry, compensating delete, or surface to
+ * the user) — this helper cannot roll back the successful rows for you.
+ */
+export declare class BatchWriteIncompleteError extends Error {
+    readonly succeededCount: number;
+    readonly unprocessed: WriteRequest[];
+    constructor(succeededCount: number, unprocessed: WriteRequest[], retries: number);
+}
+export interface BatchWriteOptions {
+    /** Optional AbortSignal — short-circuits retry backoff and rejects with the abort reason. */
+    signal?: AbortSignal;
+}
+/**
+ * Execute a single batchWrite call with exponential backoff retry for UnprocessedItems.
+ *
+ * @remarks
+ * On exhaustion of the UnprocessedItems retry budget this throws a
+ * {@link BatchWriteIncompleteError} that carries the un-acked items — items
+ * NOT listed there were acked by DynamoDB and persist in the table. There is
+ * no rollback: callers that need an all-or-nothing write must use
+ * `TransactWriteItems` (capped at 100 items per request) instead of this
+ * helper.
  *
  * @param client - DynamoDB Document client
  * @param tableName - Target DynamoDB table name
  * @param requestItems - Array of write requests (PutRequest or DeleteRequest objects)
- * @throws Error if retries are exhausted with remaining unprocessed items
+ * @param options.signal - Optional AbortSignal cancelling in-flight retries
+ * @throws {BatchWriteIncompleteError} if retries are exhausted with items still unprocessed
  */
-export declare function batchWriteWithRetry(client: DynamoDBDocument, tableName: string, requestItems: WriteRequest[]): Promise<void>;
+export declare function batchWriteWithRetry(client: DynamoDBDocument, tableName: string, requestItems: WriteRequest[], options?: BatchWriteOptions): Promise<void>;
 /**
- * Execute batch writes for an arbitrary number of items, chunking into batches of 25
+ * Execute batch writes for an arbitrary number of items, chunking into batches of 25.
+ *
+ * @remarks
+ * Each batch is retried independently. On failure of one batch, any preceding
+ * batches in the same call have already been acked by DynamoDB. This helper
+ * does not span a transaction across batches — see
+ * {@link batchWriteWithRetry} for the partial-success contract.
  *
  * @param client - DynamoDB Document client
  * @param tableName - Target DynamoDB table name
  * @param requestItems - Array of write requests (can exceed 25)
- * @throws Error if any batch fails after exhausting retries
+ * @param options.signal - Optional AbortSignal cancelling in-flight retries
+ * @throws {BatchWriteIncompleteError} if any batch fails after exhausting retries
  */
-export declare function batchWriteAllWithRetry(client: DynamoDBDocument, tableName: string, requestItems: WriteRequest[]): Promise<void>;
+export declare function batchWriteAllWithRetry(client: DynamoDBDocument, tableName: string, requestItems: WriteRequest[], options?: BatchWriteOptions): Promise<void>;
 export {};
 //# sourceMappingURL=batch-write.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"batch-write.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/batch-write.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAK9D,UAAU,eAAe;IACvB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED,UAAU,kBAAkB;IAC1B,aAAa,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED,KAAK,YAAY,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,YAAY,EAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,YAAY,EAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAOf"}
+{"version":3,"file":"batch-write.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/batch-write.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAM9D,UAAU,eAAe;IACvB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED,UAAU,kBAAkB;IAC1B,aAAa,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED,KAAK,YAAY,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAEzD;;;;;;;;;;;;GAYG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,YAAY,EAAE,CAAC;gBAEzB,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM;CAUjF;AAED,MAAM,WAAW,iBAAiB;IAChC,6FAA6F;IAC7F,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,YAAY,EAAE,EAC5B,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAuCf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,YAAY,EAAE,EAC5B,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAOf"}

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

@@ -4,59 +4,107 @@
  * Eliminates duplication of the retry pattern across checkpointer, store, and history modules
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchWriteIncompleteError = void 0;
 exports.batchWriteWithRetry = batchWriteWithRetry;
 exports.batchWriteAllWithRetry = batchWriteAllWithRetry;
 const constants_1 = require("./constants");
 const retry_1 = require("./retry");
+const sleep_1 = require("./sleep");
 /**
- * Execute a single batchWrite call with exponential backoff retry for UnprocessedItems
+ * Error thrown when `batchWriteWithRetry` / `batchWriteAllWithRetry` exhaust
+ * their UnprocessedItems retry budget. Carries enough information for the
+ * caller to reason about recovery: how many items persisted before the giveup,
+ * how many are still un-acked, and which items remained un-acked.
+ *
+ * *Partial-success semantics:* DynamoDB's BatchWriteItem is not atomic across
+ * items in a batch, and `batchWriteAllWithRetry` issues a sequence of 25-item
+ * batches. When this error is thrown, any item not listed in `unprocessed` has
+ * already been acked by DynamoDB. Callers that need all-or-nothing must drive
+ * reconciliation from `unprocessed` (retry, compensating delete, or surface to
+ * the user) — this helper cannot roll back the successful rows for you.
+ */
+class BatchWriteIncompleteError extends Error {
+    succeededCount;
+    unprocessed;
+    constructor(succeededCount, unprocessed, retries) {
+        super(`batchWrite did not drain after ${retries} UnprocessedItems retries: ` +
+            `${succeededCount} item(s) persisted, ${unprocessed.length} still un-acked. ` +
+            `Inspect err.unprocessed to drive reconciliation.`);
+        this.name = 'BatchWriteIncompleteError';
+        this.succeededCount = succeededCount;
+        this.unprocessed = unprocessed;
+    }
+}
+exports.BatchWriteIncompleteError = BatchWriteIncompleteError;
+/**
+ * Execute a single batchWrite call with exponential backoff retry for UnprocessedItems.
+ *
+ * @remarks
+ * On exhaustion of the UnprocessedItems retry budget this throws a
+ * {@link BatchWriteIncompleteError} that carries the un-acked items — items
+ * NOT listed there were acked by DynamoDB and persist in the table. There is
+ * no rollback: callers that need an all-or-nothing write must use
+ * `TransactWriteItems` (capped at 100 items per request) instead of this
+ * helper.
  *
  * @param client - DynamoDB Document client
  * @param tableName - Target DynamoDB table name
  * @param requestItems - Array of write requests (PutRequest or DeleteRequest objects)
- * @throws Error if retries are exhausted with remaining unprocessed items
+ * @param options.signal - Optional AbortSignal cancelling in-flight retries
+ * @throws {BatchWriteIncompleteError} if retries are exhausted with items still unprocessed
  */
-async function batchWriteWithRetry(client, tableName, requestItems) {
+async function batchWriteWithRetry(client, tableName, requestItems, options = {}) {
     if (requestItems.length === 0)
         return;
-    await (0, retry_1.withDynamoDBRetry)(async () => {
-        const result = await client.batchWrite({
-            RequestItems: {
-                [tableName]: requestItems,
-            },
-        });
-        let unprocessed = result.UnprocessedItems?.[tableName];
-        let retryDelay = 100;
-        let retryCount = 0;
-        while (unprocessed && unprocessed.length > 0) {
-            retryCount++;
-            if (retryCount > constants_1.MAX_UNPROCESSED_RETRIES) {
-                throw new Error(`Failed to process all items after ${constants_1.MAX_UNPROCESSED_RETRIES} retries. ` +
-                    `${unprocessed.length} items remain unprocessed.`);
-            }
-            await new Promise((resolve) => setTimeout(resolve, retryDelay));
-            retryDelay = Math.min(retryDelay * 2, 5000);
-            const retryResult = await client.batchWrite({
-                RequestItems: { [tableName]: unprocessed },
+    // Loop over UnprocessedItems OUTSIDE the transient-error retry wrapper.
+    // This way a ThrottlingException during an UnprocessedItems follow-up call
+    // doesn't cause the outer loop to re-submit items that already succeeded —
+    // which would be an idempotency problem for DeleteRequests against items
+    // that have since been recreated.
+    const initialCount = requestItems.length;
+    let pending = requestItems;
+    let retryDelay = sleep_1.INITIAL_BACKOFF_DELAY_MS;
+    let retryCount = 0;
+    while (pending.length > 0) {
+        const result = await (0, retry_1.withDynamoDBRetry)(async () => {
+            return await client.batchWrite({
+                RequestItems: { [tableName]: pending },
             });
-            unprocessed = retryResult.UnprocessedItems?.[tableName];
+        }, { signal: options.signal });
+        const unprocessed = result.UnprocessedItems?.[tableName] ?? [];
+        if (unprocessed.length === 0)
+            return;
+        retryCount++;
+        if (retryCount > constants_1.MAX_UNPROCESSED_RETRIES) {
+            throw new BatchWriteIncompleteError(initialCount - unprocessed.length, unprocessed, constants_1.MAX_UNPROCESSED_RETRIES);
         }
-    });
+        // Full jitter so concurrent batch writers don't re-pressure the partition together.
+        await (0, sleep_1.sleep)((0, sleep_1.fullJitter)(retryDelay), options.signal);
+        retryDelay = (0, sleep_1.nextBackoffDelay)(retryDelay);
+        pending = unprocessed;
+    }
 }
 /**
- * Execute batch writes for an arbitrary number of items, chunking into batches of 25
+ * Execute batch writes for an arbitrary number of items, chunking into batches of 25.
+ *
+ * @remarks
+ * Each batch is retried independently. On failure of one batch, any preceding
+ * batches in the same call have already been acked by DynamoDB. This helper
+ * does not span a transaction across batches — see
+ * {@link batchWriteWithRetry} for the partial-success contract.
  *
  * @param client - DynamoDB Document client
  * @param tableName - Target DynamoDB table name
  * @param requestItems - Array of write requests (can exceed 25)
- * @throws Error if any batch fails after exhausting retries
+ * @param options.signal - Optional AbortSignal cancelling in-flight retries
+ * @throws {BatchWriteIncompleteError} if any batch fails after exhausting retries
  */
-async function batchWriteAllWithRetry(client, tableName, requestItems) {
+async function batchWriteAllWithRetry(client, tableName, requestItems, options = {}) {
     if (requestItems.length === 0)
         return;
     for (let i = 0; i < requestItems.length; i += constants_1.BATCH_WRITE_MAX) {
         const batch = requestItems.slice(i, i + constants_1.BATCH_WRITE_MAX);
-        await batchWriteWithRetry(client, tableName, batch);
+        await batchWriteWithRetry(client, tableName, batch, options);
     }
 }
 //# sourceMappingURL=batch-write.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"batch-write.js","sourceRoot":"","sources":["../../../src/shared/utils/batch-write.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAyBH,kDAiCC;AAUD,wDAWC;AA3ED,2CAAuE;AACvE,mCAA4C;AAY5C;;;;;;;GAOG;AACI,KAAK,UAAU,mBAAmB,CACvC,MAAwB,EACxB,SAAiB,EACjB,YAA4B;IAE5B,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEtC,MAAM,IAAA,yBAAiB,EAAC,KAAK,IAAI,EAAE;QACjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;YACrC,YAAY,EAAE;gBACZ,CAAC,SAAS,CAAC,EAAE,YAAY;aAC1B;SACF,CAAC,CAAC;QAEH,IAAI,WAAW,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC,SAAS,CAAC,CAAC;QACvD,IAAI,UAAU,GAAG,GAAG,CAAC;QACrB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,OAAO,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,UAAU,EAAE,CAAC;YACb,IAAI,UAAU,GAAG,mCAAuB,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CACb,qCAAqC,mCAAuB,YAAY;oBACtE,GAAG,WAAW,CAAC,MAAM,4BAA4B,CACpD,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;YAChE,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;YAC5C,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;gBAC1C,YAAY,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE;aAC3C,CAAC,CAAC;YACH,WAAW,GAAG,WAAW,CAAC,gBAAgB,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,sBAAsB,CAC1C,MAAwB,EACxB,SAAiB,EACjB,YAA4B;IAE5B,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,IAAI,2BAAe,EAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,2BAAe,CAAC,CAAC;QACzD,MAAM,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}
+{"version":3,"file":"batch-write.js","sourceRoot":"","sources":["../../../src/shared/utils/batch-write.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAqEH,kDA4CC;AAiBD,wDAYC;AA1ID,2CAAuE;AACvE,mCAA4C;AAC5C,mCAAwF;AAYxF;;;;;;;;;;;;GAYG;AACH,MAAa,yBAA0B,SAAQ,KAAK;IACzC,cAAc,CAAS;IACvB,WAAW,CAAiB;IAErC,YAAY,cAAsB,EAAE,WAA2B,EAAE,OAAe;QAC9E,KAAK,CACH,kCAAkC,OAAO,6BAA6B;YACpE,GAAG,cAAc,uBAAuB,WAAW,CAAC,MAAM,mBAAmB;YAC7E,kDAAkD,CACrD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF;AAdD,8DAcC;AAOD;;;;;;;;;;;;;;;;GAgBG;AACI,KAAK,UAAU,mBAAmB,CACvC,MAAwB,EACxB,SAAiB,EACjB,YAA4B,EAC5B,UAA6B,EAAE;IAE/B,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEtC,wEAAwE;IACxE,2EAA2E;IAC3E,2EAA2E;IAC3E,yEAAyE;IACzE,kCAAkC;IAClC,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC;IACzC,IAAI,OAAO,GAAmB,YAAY,CAAC;IAC3C,IAAI,UAAU,GAAG,gCAAwB,CAAC;IAC1C,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAiB,EACpC,KAAK,IAAI,EAAE;YACT,OAAO,MAAM,MAAM,CAAC,UAAU,CAAC;gBAC7B,YAAY,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE;aACvC,CAAC,CAAC;QACL,CAAC,EACD,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC3B,CAAC;QAEF,MAAM,WAAW,GAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC,SAAS,CAAgC,IAAI,EAAE,CAAC;QAC/F,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAErC,UAAU,EAAE,CAAC;QACb,IAAI,UAAU,GAAG,mCAAuB,EAAE,CAAC;YACzC,MAAM,IAAI,yBAAyB,CACjC,YAAY,GAAG,WAAW,CAAC,MAAM,EACjC,WAAW,EACX,mCAAuB,CACxB,CAAC;QACJ,CAAC;QACD,oFAAoF;QACpF,MAAM,IAAA,aAAK,EAAC,IAAA,kBAAU,EAAC,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,UAAU,GAAG,IAAA,wBAAgB,EAAC,UAAU,CAAC,CAAC;QAC1C,OAAO,GAAG,WAAW,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACI,KAAK,UAAU,sBAAsB,CAC1C,MAAwB,EACxB,SAAiB,EACjB,YAA4B,EAC5B,UAA6B,EAAE;IAE/B,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,IAAI,2BAAe,EAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,2BAAe,CAAC,CAAC;QACzD,MAAM,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/shared/utils/client-factory.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared DynamoDB client resolution for DynamoDBSaver / DynamoDBStore /
+ * DynamoDBChatMessageHistory.
+ *
+ * Each module supports two construction modes:
+ *   1. Pass `client` (pre-built DynamoDBDocument): we do not own it and skip cleanup.
+ *   2. Pass `clientConfig` (or nothing): we build our own client and own its lifecycle.
+ *
+ * This helper captures the if/else and the `ownsClient` flag in one place.
+ */
+import { DynamoDBClient, type DynamoDBClientConfig } from '@aws-sdk/client-dynamodb';
+import { DynamoDBDocument } from '@aws-sdk/lib-dynamodb';
+export interface ResolvedDynamoDBClient {
+    /** Underlying DynamoDB client — undefined when an external client was injected. */
+    ddbClient: DynamoDBClient | undefined;
+    /** DocumentClient wrapper used for all operations. */
+    client: DynamoDBDocument;
+    /** True when this library owns the underlying client and must destroy it. */
+    ownsClient: boolean;
+}
+export declare function resolveDynamoDBClient(options: {
+    client?: DynamoDBDocument;
+    clientConfig?: DynamoDBClientConfig;
+}): ResolvedDynamoDBClient;
+//# sourceMappingURL=client-factory.d.ts.map

package/dist/shared/utils/client-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-factory.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/client-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,mFAAmF;IACnF,SAAS,EAAE,cAAc,GAAG,SAAS,CAAC;IACtC,sDAAsD;IACtD,MAAM,EAAE,gBAAgB,CAAC;IACzB,6EAA6E;IAC7E,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC,GAAG,sBAAsB,CAMzB"}

package/dist/shared/utils/client-factory.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Shared DynamoDB client resolution for DynamoDBSaver / DynamoDBStore /
+ * DynamoDBChatMessageHistory.
+ *
+ * Each module supports two construction modes:
+ *   1. Pass `client` (pre-built DynamoDBDocument): we do not own it and skip cleanup.
+ *   2. Pass `clientConfig` (or nothing): we build our own client and own its lifecycle.
+ *
+ * This helper captures the if/else and the `ownsClient` flag in one place.
+ */
+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");
+function resolveDynamoDBClient(options) {
+    if (options.client) {
+        return { ddbClient: undefined, client: options.client, ownsClient: false };
+    }
+    const ddbClient = new client_dynamodb_1.DynamoDBClient(options.clientConfig || {});
+    return { ddbClient, client: lib_dynamodb_1.DynamoDBDocument.from(ddbClient), ownsClient: true };
+}
+//# sourceMappingURL=client-factory.js.map

package/dist/shared/utils/client-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-factory.js","sourceRoot":"","sources":["../../../src/shared/utils/client-factory.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAcH,sDASC;AArBD,8DAAqF;AACrF,wDAAyD;AAWzD,SAAgB,qBAAqB,CAAC,OAGrC;IACC,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,SAAS,GAAG,IAAI,gCAAc,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IACjE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,+BAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACnF,CAAC"}

package/dist/shared/utils/compressor.d.ts

@@ -12,6 +12,12 @@ export interface CompressionConfig {
     minSizeBytes?: number;
     /** Gzip compression level 1-9 (default: 6 = balanced speed/ratio) */
     level?: number;
+    /**
+     * Hard cap on decompressed output size in bytes (default: 50 MiB).
+     * Protects against gzip-bomb payloads. Decompression throws if the output
+     * would exceed this cap.
+     */
+    maxDecompressedBytes?: number;
 }
 /**
  * Compressor for checkpoint data using gzip
@@ -24,6 +30,7 @@ export interface CompressionConfig {
 export declare class Compressor {
     private readonly minSizeBytes;
     private readonly level;
+    private readonly maxDecompressedBytes;
     constructor(config: CompressionConfig);
     /**
      * Compress data if above the minimum size threshold
@@ -33,15 +40,26 @@ export declare class Compressor {
      */
     compress(data: Uint8Array): Promise<Uint8Array>;
     /**
-     * Decompress data if gzip magic header is detected, otherwise passthrough
-     * This provides full backward compatibility with uncompressed data
+     * Decompress data if it is library-compressed, otherwise passthrough.
+     *
+     * Detection order:
+     *   1. LGC marker: new-format payloads produced by compress() above.
+     *   2. Gzip magic: legacy payloads from before the marker was introduced;
+     *      decompressed for backward compatibility.
+     *
+     * Raw user binary that happens to start with the gzip magic bytes is still at
+     * risk under (2), but new writes use the marker and will be unambiguous.
      *
      * @param data - Potentially compressed data
      * @returns Decompressed data
      */
     decompress(data: Uint8Array): Promise<Uint8Array>;
     /**
-     * Check if data starts with the gzip magic number
+     * Check if data carries the library's compression marker.
+     */
+    static hasCompressedMarker(data: Uint8Array): boolean;
+    /**
+     * Check if data starts with the gzip magic number (legacy-format detection).
      */
     static isGzipped(data: Uint8Array): boolean;
 }

package/dist/shared/utils/compressor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compressor.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/compressor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,MAAM,EAAE,iBAAiB;IAKrC;;;;;OAKG;IACG,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAgBrD;;;;;;OAMG;IACG,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAQvD;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;CAG5C"}
+{"version":3,"file":"compressor.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/compressor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiCH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;gBAElC,MAAM,EAAE,iBAAiB;IAMrC;;;;;OAKG;IACG,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAqBrD;;;;;;;;;;;;;OAaG;IACG,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IA8BvD;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAQrD;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;CAG5C"}

package/dist/shared/utils/compressor.js

@@ -9,8 +9,28 @@ const node_util_1 = require("node:util");
 const node_zlib_1 = require("node:zlib");
 const gzipAsync = (0, node_util_1.promisify)(node_zlib_1.gzip);
 const gunzipAsync = (0, node_util_1.promisify)(node_zlib_1.gunzip);
-/** Gzip magic number bytes for auto-detection */
+/** Gzip magic number bytes for auto-detection of legacy payloads */
 const GZIP_MAGIC = new Uint8Array([0x1f, 0x8b]);
+/**
+ * 3-byte marker stamped at the start of new compressed payloads. Unambiguously
+ * identifies "this is library-compressed" so we do not try to gunzip raw binary
+ * that happens to start with the gzip magic bytes. Legacy payloads (pre-marker)
+ * are still decompressed on a gzip-magic fallback — see `decompress()`.
+ *
+ * Bytes 0x4C 0x47 0x43 spell "LGC" (LangGraph-Compressed).
+ */
+const COMPRESSED_MARKER = new Uint8Array([0x4c, 0x47, 0x43]);
+/**
+ * Default maximum decompressed output size: 50 MiB.
+ *
+ * Guards against "gzip bomb" payloads that are small on disk / in DynamoDB but
+ * expand to multi-gigabyte buffers that would OOM the process. Raise this via
+ * `CompressionConfig.maxDecompressedBytes` only if a legitimate workload needs
+ * larger checkpoints (remember: a DynamoDB item is hard-capped at 400 KB, so
+ * values above this threshold must originate from S3 offloading and should be
+ * treated with the same scrutiny).
+ */
+const DEFAULT_MAX_DECOMPRESSED_BYTES = 50 * 1024 * 1024;
 /**
  * Compressor for checkpoint data using gzip
  *
@@ -22,9 +42,11 @@ const GZIP_MAGIC = new Uint8Array([0x1f, 0x8b]);
 class Compressor {
     minSizeBytes;
     level;
+    maxDecompressedBytes;
     constructor(config) {
         this.minSizeBytes = config.minSizeBytes ?? 1024;
         this.level = config.level ?? 6;
+        this.maxDecompressedBytes = config.maxDecompressedBytes ?? DEFAULT_MAX_DECOMPRESSED_BYTES;
     }
     /**
      * Compress data if above the minimum size threshold
@@ -37,28 +59,71 @@ class Compressor {
             return data;
         }
         const compressed = new Uint8Array(await gzipAsync(data, { level: this.level }));
-        // Only use compressed output if it saves at least 10% space.
-        // This avoids data expansion for already-compressed or random binary payloads.
-        if (compressed.length >= data.length * 0.9) {
+        // Only use compressed output if it saves enough space to pay for the 3-byte
+        // marker overhead plus a reasonable margin (10%). Avoids data expansion for
+        // already-compressed or random binary payloads.
+        if (compressed.length + COMPRESSED_MARKER.length >= data.length * 0.9) {
             return data;
         }
-        return compressed;
+        // Prepend the LGC marker so decompress() can unambiguously identify our output.
+        const out = new Uint8Array(COMPRESSED_MARKER.length + compressed.length);
+        out.set(COMPRESSED_MARKER, 0);
+        out.set(compressed, COMPRESSED_MARKER.length);
+        return out;
     }
     /**
-     * Decompress data if gzip magic header is detected, otherwise passthrough
-     * This provides full backward compatibility with uncompressed data
+     * Decompress data if it is library-compressed, otherwise passthrough.
+     *
+     * Detection order:
+     *   1. LGC marker: new-format payloads produced by compress() above.
+     *   2. Gzip magic: legacy payloads from before the marker was introduced;
+     *      decompressed for backward compatibility.
+     *
+     * Raw user binary that happens to start with the gzip magic bytes is still at
+     * risk under (2), but new writes use the marker and will be unambiguous.
      *
      * @param data - Potentially compressed data
      * @returns Decompressed data
      */
     async decompress(data) {
-        if (!Compressor.isGzipped(data)) {
+        // zlib rejects with an ERR_BUFFER_TOO_LARGE when the decompressed output
+        // would exceed maxOutputLength — caps memory use on hostile gzip-bomb input.
+        const opts = { maxOutputLength: this.maxDecompressedBytes };
+        try {
+            if (Compressor.hasCompressedMarker(data)) {
+                const payload = data.subarray(COMPRESSED_MARKER.length);
+                return new Uint8Array(await gunzipAsync(payload, opts));
+            }
+            if (Compressor.isGzipped(data)) {
+                // Legacy, pre-marker payload
+                return new Uint8Array(await gunzipAsync(data, opts));
+            }
             return data;
         }
-        return new Uint8Array(await gunzipAsync(data));
+        catch (err) {
+            if (err &&
+                typeof err === 'object' &&
+                err.code === 'ERR_BUFFER_TOO_LARGE') {
+                throw new Error(`Refusing to decompress payload: decompressed output would exceed ${this.maxDecompressedBytes} bytes. ` +
+                    `Raise Compressor's maxDecompressedBytes if this limit is too low.`, { cause: err });
+            }
+            throw err;
+        }
+    }
+    /**
+     * Check if data carries the library's compression marker.
+     */
+    static hasCompressedMarker(data) {
+        if (data.length < COMPRESSED_MARKER.length)
+            return false;
+        for (let i = 0; i < COMPRESSED_MARKER.length; i++) {
+            if (data[i] !== COMPRESSED_MARKER[i])
+                return false;
+        }
+        return true;
     }
     /**
-     * Check if data starts with the gzip magic number
+     * Check if data starts with the gzip magic number (legacy-format detection).
      */
     static isGzipped(data) {
         return data.length >= 2 && data[0] === GZIP_MAGIC[0] && data[1] === GZIP_MAGIC[1];

package/dist/shared/utils/compressor.js.map

@@ -1 +1 @@
-{"version":3,"file":"compressor.js","sourceRoot":"","sources":["../../../src/shared/utils/compressor.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,yCAAsC;AACtC,yCAAyC;AAEzC,MAAM,SAAS,GAAG,IAAA,qBAAS,EAAC,gBAAI,CAAC,CAAC;AAClC,MAAM,WAAW,GAAG,IAAA,qBAAS,EAAC,kBAAM,CAAC,CAAC;AAEtC,iDAAiD;AACjD,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAchD;;;;;;;GAOG;AACH,MAAa,UAAU;IACJ,YAAY,CAAS;IACrB,KAAK,CAAS;IAE/B,YAAY,MAAyB;QACnC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAgB;QAC7B,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAEhF,6DAA6D;QAC7D,+EAA+E;QAC/E,IAAI,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CAAC,IAAgB;QAC/B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,UAAU,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAgB;QAC/B,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC;IACpF,CAAC;CACF;AApDD,gCAoDC"}
+{"version":3,"file":"compressor.js","sourceRoot":"","sources":["../../../src/shared/utils/compressor.ts"],"names":[],"mappings":"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"}

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

@@ -2,7 +2,7 @@
  * Shared constants for validation across store and checkpointer
  */
 export declare const MAX_TTL_DAYS: number;
-export declare const MAX_LOOP_ITERATIONS = 100;
+export declare const MAX_LOOP_ITERATIONS = 1000;
 export declare const MAX_TOTAL_ITEMS_IN_MEMORY = 10000;
 export declare const BATCH_WRITE_MAX = 25;
 export declare const MAX_UNPROCESSED_RETRIES = 10;

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,YAAY,QAAU,CAAC;AACpC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,yBAAyB,QAAQ,CAAC;AAC/C,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAgBjE"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,YAAY,QAAU,CAAC;AAKpC,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,yBAAyB,QAAQ,CAAC;AAC/C,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAgBjE"}

package/dist/shared/utils/constants.js

@@ -7,7 +7,11 @@ exports.MAX_UNPROCESSED_RETRIES = exports.BATCH_WRITE_MAX = exports.MAX_TOTAL_IT
 exports.validateTTLDays = validateTTLDays;
 // Common DynamoDB limits
 exports.MAX_TTL_DAYS = 365 * 5; // 5 years
-exports.MAX_LOOP_ITERATIONS = 100; // Maximum loop iterations to prevent infinite loops
+// A DynamoDB Query page is bounded by ~1MB. 1000 iterations × 1MB = ~1GB of data,
+// which is well beyond MAX_TOTAL_ITEMS_IN_MEMORY anyway, so the lower memory cap
+// stays the real guard. Previously 100 — too tight for long chat histories or
+// filter-heavy searches where many pages yield few matching items.
+exports.MAX_LOOP_ITERATIONS = 1000;
 exports.MAX_TOTAL_ITEMS_IN_MEMORY = 10000; // Maximum items to collect in memory
 exports.BATCH_WRITE_MAX = 25; // DynamoDB BatchWriteItem limit per request
 exports.MAX_UNPROCESSED_RETRIES = 10; // Maximum retries for UnprocessedItems loops

package/dist/shared/utils/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/shared/utils/constants.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAYH,0CAgBC;AA1BD,yBAAyB;AACZ,QAAA,YAAY,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU;AAClC,QAAA,mBAAmB,GAAG,GAAG,CAAC,CAAC,oDAAoD;AAC/E,QAAA,yBAAyB,GAAG,KAAK,CAAC,CAAC,qCAAqC;AACxE,QAAA,eAAe,GAAG,EAAE,CAAC,CAAC,4CAA4C;AAClE,QAAA,uBAAuB,GAAG,EAAE,CAAC,CAAC,6CAA6C;AAExF;;GAEG;AACH,SAAgB,eAAe,CAAC,OAA2B;IACzD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,OAAO,GAAG,oBAAY,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,0BAA0B,oBAAY,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/shared/utils/constants.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAgBH,0CAgBC;AA9BD,yBAAyB;AACZ,QAAA,YAAY,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU;AAC/C,kFAAkF;AAClF,iFAAiF;AACjF,8EAA8E;AAC9E,mEAAmE;AACtD,QAAA,mBAAmB,GAAG,IAAI,CAAC;AAC3B,QAAA,yBAAyB,GAAG,KAAK,CAAC,CAAC,qCAAqC;AACxE,QAAA,eAAe,GAAG,EAAE,CAAC,CAAC,4CAA4C;AAClE,QAAA,uBAAuB,GAAG,EAAE,CAAC,CAAC,6CAA6C;AAExF;;GAEG;AACH,SAAgB,eAAe,CAAC,OAA2B;IACzD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,OAAO,GAAG,oBAAY,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,0BAA0B,oBAAY,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/dist/shared/utils/index.d.ts

@@ -6,6 +6,9 @@ export * from './constants';
 export * from './logger';
 export * from './retry';
 export * from './s3-offloader';
+export * from './s3-orphans';
 export * from './batch-write';
+export * from './client-factory';
+export * from './sleep';
 export * from './ttl';
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC"}

package/dist/shared/utils/index.js

@@ -22,6 +22,9 @@ __exportStar(require("./constants"), exports);
 __exportStar(require("./logger"), exports);
 __exportStar(require("./retry"), exports);
 __exportStar(require("./s3-offloader"), exports);
+__exportStar(require("./s3-orphans"), exports);
 __exportStar(require("./batch-write"), exports);
+__exportStar(require("./client-factory"), exports);
+__exportStar(require("./sleep"), exports);
 __exportStar(require("./ttl"), exports);
 //# sourceMappingURL=index.js.map

package/dist/shared/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,8CAA4B;AAC5B,2CAAyB;AACzB,0CAAwB;AACxB,iDAA+B;AAC/B,gDAA8B;AAC9B,wCAAsB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,8CAA4B;AAC5B,2CAAyB;AACzB,0CAAwB;AACxB,iDAA+B;AAC/B,+CAA6B;AAC7B,gDAA8B;AAC9B,mDAAiC;AACjC,0CAAwB;AACxB,wCAAsB"}

package/dist/shared/utils/logger.d.ts

@@ -45,4 +45,31 @@ export declare function getLogger(): Logger;
  * Reset the logger to the default console-based implementation
  */
 export declare function resetLogger(): void;
+/**
+ * Recursively clone an object, replacing values at any secret-looking key with
+ * `[REDACTED]`. Cycles are broken with a WeakSet. Leaves primitives and non-
+ * enumerable values untouched. Does not mutate the input.
+ *
+ * @param value - Arbitrary value to redact
+ * @param patterns - Lower-cased substrings to match against each key
+ */
+export declare function redactSecrets(value: unknown, patterns?: readonly string[]): unknown;
+/**
+ * Wrap an existing logger with automatic secret redaction applied to the
+ * variadic args (the message string itself is passed through unchanged — don't
+ * interpolate secrets into messages). Strings in args are left as-is; only
+ * object properties whose keys match a secret pattern are replaced.
+ *
+ * @example
+ * ```ts
+ * import { setGlobalLogger, redactLogger, getLogger } from '@farukada/aws-langgraph-dynamodb-ts';
+ * setGlobalLogger(redactLogger(getLogger()));
+ * ```
+ *
+ * @param inner - Logger to wrap
+ * @param options.extraKeys - Additional lower-cased substrings to treat as secret keys
+ */
+export declare function redactLogger(inner: Logger, options?: {
+    extraKeys?: readonly string[];
+}): Logger;
 //# sourceMappingURL=logger.d.ts.map

package/dist/shared/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAuBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAuBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AA8BD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,SAAS,MAAM,EAAgC,GACxD,OAAO,CA0BT;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAO,GAC9C,MAAM,CAWR"}