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

package/dist/shared/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,0CAAwB"}

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

@@ -1,74 +0,0 @@
-/**
- * Shared batch write utilities with UnprocessedItems retry logic
- * Eliminates duplication of the retry pattern across checkpointer, store, and history modules
- */
-import type { DynamoDBDocument } from '@aws-sdk/lib-dynamodb';
-interface PutWriteRequest {
-    PutRequest: {
-        Item: object;
-    };
-}
-interface DeleteWriteRequest {
-    DeleteRequest: {
-        Key: object;
-    };
-}
-type WriteRequest = PutWriteRequest | DeleteWriteRequest;
-/**
- * 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)
- * @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[], options?: BatchWriteOptions): Promise<void>;
-/**
- * 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)
- * @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[], options?: BatchWriteOptions): Promise<void>;
-export {};
-//# sourceMappingURL=batch-write.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,110 +0,0 @@
-"use strict";
-/**
- * Shared batch write utilities with UnprocessedItems retry logic
- * 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");
-/**
- * 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)
- * @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, options = {}) {
-    if (requestItems.length === 0)
-        return;
-    // 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 },
-            });
-        }, { 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.
- *
- * @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)
- * @param options.signal - Optional AbortSignal cancelling in-flight retries
- * @throws {BatchWriteIncompleteError} if any batch fails after exhausting retries
- */
-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, options);
-    }
-}
-//# sourceMappingURL=batch-write.js.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,25 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,23 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,66 +0,0 @@
-/**
- * Checkpoint compression utility using Node.js built-in zlib
- * Provides transparent gzip compression/decompression with smart thresholds
- */
-/**
- * Configuration for checkpoint compression
- */
-export interface CompressionConfig {
-    /** Whether compression is enabled (default: false) */
-    enabled: boolean;
-    /** Minimum payload size in bytes to trigger compression (default: 1024 = 1KB) */
-    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
- *
- * Features:
- * - Smart threshold: skips compression for payloads below `minSizeBytes`
- * - Auto-detection: `decompress()` transparently handles both compressed and uncompressed data
- * - Zero dependencies: uses Node.js built-in `zlib`
- */
-export declare class Compressor {
-    private readonly minSizeBytes;
-    private readonly level;
-    private readonly maxDecompressedBytes;
-    constructor(config: CompressionConfig);
-    /**
-     * Compress data if above the minimum size threshold
-     *
-     * @param data - Raw data to compress
-     * @returns Compressed data (gzip) or original data if below threshold
-     */
-    compress(data: Uint8Array): Promise<Uint8Array>;
-    /**
-     * 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 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;
-}
-//# sourceMappingURL=compressor.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,133 +0,0 @@
-"use strict";
-/**
- * Checkpoint compression utility using Node.js built-in zlib
- * Provides transparent gzip compression/decompression with smart thresholds
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Compressor = void 0;
-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 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
- *
- * Features:
- * - Smart threshold: skips compression for payloads below `minSizeBytes`
- * - Auto-detection: `decompress()` transparently handles both compressed and uncompressed data
- * - Zero dependencies: uses Node.js built-in `zlib`
- */
-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
-     *
-     * @param data - Raw data to compress
-     * @returns Compressed data (gzip) or original data if below threshold
-     */
-    async compress(data) {
-        if (data.length < this.minSizeBytes) {
-            return data;
-        }
-        const compressed = new Uint8Array(await gzipAsync(data, { level: this.level }));
-        // 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;
-        }
-        // 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 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) {
-        // 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;
-        }
-        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 (legacy-format detection).
-     */
-    static isGzipped(data) {
-        return data.length >= 2 && data[0] === GZIP_MAGIC[0] && data[1] === GZIP_MAGIC[1];
-    }
-}
-exports.Compressor = Compressor;
-//# sourceMappingURL=compressor.js.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,13 +0,0 @@
-/**
- * Shared constants for validation across store and checkpointer
- */
-export declare const MAX_TTL_DAYS: number;
-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;
-/**
- * Validate TTL days (shared logic)
- */
-export declare function validateTTLDays(ttlDays: number | undefined): void;
-//# sourceMappingURL=constants.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,35 +0,0 @@
-"use strict";
-/**
- * Shared constants for validation across store and checkpointer
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_UNPROCESSED_RETRIES = exports.BATCH_WRITE_MAX = exports.MAX_TOTAL_ITEMS_IN_MEMORY = exports.MAX_LOOP_ITERATIONS = exports.MAX_TTL_DAYS = void 0;
-exports.validateTTLDays = validateTTLDays;
-// Common DynamoDB limits
-exports.MAX_TTL_DAYS = 365 * 5; // 5 years
-// 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
-/**
- * Validate TTL days (shared logic)
- */
-function validateTTLDays(ttlDays) {
-    if (ttlDays === undefined) {
-        return;
-    }
-    if (typeof ttlDays !== 'number' || !Number.isInteger(ttlDays)) {
-        throw new Error('TTL days must be an integer');
-    }
-    if (ttlDays <= 0) {
-        throw new Error('TTL days must be positive');
-    }
-    if (ttlDays > exports.MAX_TTL_DAYS) {
-        throw new Error(`TTL days cannot exceed ${exports.MAX_TTL_DAYS}`);
-    }
-}
-//# sourceMappingURL=constants.js.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,14 +0,0 @@
-/**
- * Shared utilities and types
- */
-export * from './compressor';
-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 +0,0 @@
-{"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

@@ -1,30 +0,0 @@
-"use strict";
-/**
- * Shared utilities and types
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-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("./compressor"), exports);
-__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 +0,0 @@
-{"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"}