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

package/dist/checkpointer/internal/item-reader.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readCheckpoint = readCheckpoint;
+exports.readMetadata = readMetadata;
+exports.toPendingWrites = toPendingWrites;
+const codec_1 = require("../../shared/codec/codec");
+const item_writer_1 = require("./item-writer");
+/** Decode the checkpoint stored in a PAYLOAD item. */
+async function readCheckpoint(context, item) {
+    return (0, codec_1.decodePayload)(item.checkpoint, (0, item_writer_1.codecDeps)(context));
+}
+/** Decode the metadata stored in a META item. */
+async function readMetadata(context, item) {
+    return (0, codec_1.decodePayload)(item.metadata, (0, item_writer_1.codecDeps)(context));
+}
+/** Decode WRITE items into `[taskId, channel, value]` pending-write tuples. */
+async function toPendingWrites(context, items) {
+    const deps = (0, item_writer_1.codecDeps)(context);
+    const pending = [];
+    for (const item of items) {
+        const value = await (0, codec_1.decodePayload)(item.value, deps);
+        pending.push([item.taskId, item.channel, value]);
+    }
+    return pending;
+}
+//# sourceMappingURL=item-reader.js.map

package/dist/checkpointer/internal/item-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-reader.js","sourceRoot":"","sources":["../../../src/checkpointer/internal/item-reader.ts"],"names":[],"mappings":";;AAYA,wCAKC;AAGD,oCAKC;AAGD,0CAWC;AAjCD,oDAAyD;AAEzD,+CAA0C;AAG1C,sDAAsD;AAC/C,KAAK,UAAU,cAAc,CAClC,OAA4B,EAC5B,IAA2B;IAE3B,OAAO,IAAA,qBAAa,EAAa,IAAI,CAAC,UAAU,EAAE,IAAA,uBAAS,EAAC,OAAO,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,iDAAiD;AAC1C,KAAK,UAAU,YAAY,CAChC,OAA4B,EAC5B,IAAwB;IAExB,OAAO,IAAA,qBAAa,EAAqB,IAAI,CAAC,QAAQ,EAAE,IAAA,uBAAS,EAAC,OAAO,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,+EAA+E;AACxE,KAAK,UAAU,eAAe,CACnC,OAA4B,EAC5B,KAA4B;IAE5B,MAAM,IAAI,GAAG,IAAA,uBAAS,EAAC,OAAO,CAAC,CAAC;IAChC,MAAM,OAAO,GAA6B,EAAE,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,IAAA,qBAAa,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/checkpointer/internal/item-writer.d.ts

@@ -0,0 +1,14 @@
+import type { Checkpoint, CheckpointMetadata, PendingWrite } from '@langchain/langgraph-checkpoint';
+import { type CodecDeps } from '../../shared/codec/codec';
+import type { CheckpointMetaItem, CheckpointPayloadItem, CheckpointWriteItem } from '../types';
+import type { CheckpointerContext } from './setup';
+/** Map a context to the codec collaborators. */
+export declare function codecDeps(context: CheckpointerContext): CodecDeps;
+/** Encode a checkpoint + metadata into its META and PAYLOAD items. */
+export declare function buildCheckpointItems(context: CheckpointerContext, threadId: string, checkpointNs: string, checkpoint: Checkpoint, metadata: CheckpointMetadata, parentCheckpointId?: string, ttlTimestamp?: number): Promise<{
+    meta: CheckpointMetaItem;
+    payload: CheckpointPayloadItem;
+}>;
+/** Encode a task's pending writes into one item per write. */
+export declare function buildWriteItems(context: CheckpointerContext, threadId: string, checkpointNs: string, checkpointId: string, taskId: string, writes: PendingWrite[], ttlTimestamp?: number): Promise<CheckpointWriteItem[]>;
+//# sourceMappingURL=item-writer.d.ts.map

package/dist/checkpointer/internal/item-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-writer.d.ts","sourceRoot":"","sources":["../../../src/checkpointer/internal/item-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGpG,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,gDAAgD;AAChD,wBAAgB,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,CAEjE;AAOD,sEAAsE;AACtE,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,kBAAkB,EAC5B,kBAAkB,CAAC,EAAE,MAAM,EAC3B,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,qBAAqB,CAAA;CAAE,CAAC,CAwBvE;AAED,8DAA8D;AAC9D,wBAAsB,eAAe,CACnC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,EAAE,EACtB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAqBhC"}

package/dist/checkpointer/internal/item-writer.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codecDeps = codecDeps;
+exports.buildCheckpointItems = buildCheckpointItems;
+exports.buildWriteItems = buildWriteItems;
+const langgraph_checkpoint_1 = require("@langchain/langgraph-checkpoint");
+const codec_1 = require("../../shared/codec/codec");
+const keys_1 = require("./keys");
+/** Map a context to the codec collaborators. */
+function codecDeps(context) {
+    return { serde: context.serde, compression: context.compression, offloader: context.offloader };
+}
+function withTtl(item, ttlTimestamp) {
+    if (ttlTimestamp !== undefined)
+        item.ttl = ttlTimestamp;
+    return item;
+}
+/** Encode a checkpoint + metadata into its META and PAYLOAD items. */
+async function buildCheckpointItems(context, threadId, checkpointNs, checkpoint, metadata, parentCheckpointId, ttlTimestamp) {
+    const deps = codecDeps(context);
+    const pk = (0, keys_1.partitionKey)(threadId);
+    const checkpointDescriptor = await (0, codec_1.encodePayload)(checkpoint, deps, {
+        keyParts: [threadId, checkpointNs, checkpoint.id, 'checkpoint'],
+    });
+    const metadataDescriptor = await (0, codec_1.encodePayload)(metadata, deps, {
+        keyParts: [threadId, checkpointNs, checkpoint.id, 'metadata'],
+    });
+    const meta = {
+        PK: pk,
+        SK: (0, keys_1.metaSortKey)(checkpointNs, checkpoint.id),
+        threadId,
+        checkpointNs,
+        checkpointId: checkpoint.id,
+        metadata: metadataDescriptor,
+    };
+    if (parentCheckpointId !== undefined)
+        meta.parentCheckpointId = parentCheckpointId;
+    const payload = {
+        PK: pk,
+        SK: (0, keys_1.payloadSortKey)(checkpointNs, checkpoint.id),
+        checkpoint: checkpointDescriptor,
+    };
+    return { meta: withTtl(meta, ttlTimestamp), payload: withTtl(payload, ttlTimestamp) };
+}
+/** Encode a task's pending writes into one item per write. */
+async function buildWriteItems(context, threadId, checkpointNs, checkpointId, taskId, writes, ttlTimestamp) {
+    const deps = codecDeps(context);
+    const pk = (0, keys_1.partitionKey)(threadId);
+    const items = [];
+    for (let positional = 0; positional < writes.length; positional++) {
+        const [channel, value] = writes[positional];
+        const index = langgraph_checkpoint_1.WRITES_IDX_MAP[channel] ?? positional;
+        const descriptor = await (0, codec_1.encodePayload)(value, deps, {
+            keyParts: [threadId, checkpointNs, checkpointId, taskId, `write-${index}`],
+        });
+        const item = {
+            PK: pk,
+            SK: (0, keys_1.writeSortKey)(checkpointNs, checkpointId, taskId, index),
+            taskId,
+            index,
+            channel,
+            value: descriptor,
+        };
+        items.push(withTtl(item, ttlTimestamp));
+    }
+    return items;
+}
+//# sourceMappingURL=item-writer.js.map

package/dist/checkpointer/internal/item-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-writer.js","sourceRoot":"","sources":["../../../src/checkpointer/internal/item-writer.ts"],"names":[],"mappings":"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"}

package/dist/checkpointer/internal/keys.d.ts

@@ -0,0 +1,15 @@
+/** Reserved separator joining sort-key segments; forbidden inside any segment. */
+export declare const SORT_KEY_SEPARATOR = "#";
+/** Partition key for a thread: the thread id itself. */
+export declare function partitionKey(threadId: string): string;
+/** Sort key for a checkpoint's lightweight metadata item. */
+export declare function metaSortKey(checkpointNs: string, checkpointId: string): string;
+/** `begins_with` prefix selecting every META item in a namespace (for list). */
+export declare function metaSortKeyPrefix(checkpointNs: string): string;
+/** Sort key for a checkpoint's heavy payload item. */
+export declare function payloadSortKey(checkpointNs: string, checkpointId: string): string;
+/** Sort key for a single pending write. */
+export declare function writeSortKey(checkpointNs: string, checkpointId: string, taskId: string, index: number): string;
+/** `begins_with` prefix selecting every WRITE item for one checkpoint. */
+export declare function writeSortKeyPrefix(checkpointNs: string, checkpointId: string): string;
+//# sourceMappingURL=keys.d.ts.map

package/dist/checkpointer/internal/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/checkpointer/internal/keys.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAmBtC,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,CAKR;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAErF"}

package/dist/checkpointer/internal/keys.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SORT_KEY_SEPARATOR = void 0;
+exports.partitionKey = partitionKey;
+exports.metaSortKey = metaSortKey;
+exports.metaSortKeyPrefix = metaSortKeyPrefix;
+exports.payloadSortKey = payloadSortKey;
+exports.writeSortKey = writeSortKey;
+exports.writeSortKeyPrefix = writeSortKeyPrefix;
+/** Reserved separator joining sort-key segments; forbidden inside any segment. */
+exports.SORT_KEY_SEPARATOR = '#';
+/** Fixed digit width for the WRITE index so sort keys order numerically. */
+const WRITE_INDEX_PAD_WIDTH = 10;
+/**
+ * Added to every write index before padding so the special negative slots from
+ * `WRITES_IDX_MAP` (-1 ERROR .. -4 RESUME) encode as non-negative, sortable
+ * integers that order below positional (0+) writes.
+ */
+const WRITE_INDEX_OFFSET = 8;
+/** Sort-key kinds for the checkpoints table (the approved SK separation). */
+var CheckpointItemKind;
+(function (CheckpointItemKind) {
+    CheckpointItemKind["META"] = "META";
+    CheckpointItemKind["PAYLOAD"] = "PAYLOAD";
+    CheckpointItemKind["WRITE"] = "WRITE";
+})(CheckpointItemKind || (CheckpointItemKind = {}));
+/** Partition key for a thread: the thread id itself. */
+function partitionKey(threadId) {
+    return threadId;
+}
+/** Sort key for a checkpoint's lightweight metadata item. */
+function metaSortKey(checkpointNs, checkpointId) {
+    return `${CheckpointItemKind.META}${exports.SORT_KEY_SEPARATOR}${checkpointNs}${exports.SORT_KEY_SEPARATOR}${checkpointId}`;
+}
+/** `begins_with` prefix selecting every META item in a namespace (for list). */
+function metaSortKeyPrefix(checkpointNs) {
+    return `${CheckpointItemKind.META}${exports.SORT_KEY_SEPARATOR}${checkpointNs}${exports.SORT_KEY_SEPARATOR}`;
+}
+/** Sort key for a checkpoint's heavy payload item. */
+function payloadSortKey(checkpointNs, checkpointId) {
+    return `${CheckpointItemKind.PAYLOAD}${exports.SORT_KEY_SEPARATOR}${checkpointNs}${exports.SORT_KEY_SEPARATOR}${checkpointId}`;
+}
+/** Sort key for a single pending write. */
+function writeSortKey(checkpointNs, checkpointId, taskId, index) {
+    const paddedIndex = (index + WRITE_INDEX_OFFSET).toString().padStart(WRITE_INDEX_PAD_WIDTH, '0');
+    return [CheckpointItemKind.WRITE, checkpointNs, checkpointId, taskId, paddedIndex].join(exports.SORT_KEY_SEPARATOR);
+}
+/** `begins_with` prefix selecting every WRITE item for one checkpoint. */
+function writeSortKeyPrefix(checkpointNs, checkpointId) {
+    return `${CheckpointItemKind.WRITE}${exports.SORT_KEY_SEPARATOR}${checkpointNs}${exports.SORT_KEY_SEPARATOR}${checkpointId}${exports.SORT_KEY_SEPARATOR}`;
+}
+//# sourceMappingURL=keys.js.map

package/dist/checkpointer/internal/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/checkpointer/internal/keys.ts"],"names":[],"mappings":";;;AAqBA,oCAEC;AAGD,kCAEC;AAGD,8CAEC;AAGD,wCAEC;AAGD,oCAUC;AAGD,gDAEC;AAxDD,kFAAkF;AACrE,QAAA,kBAAkB,GAAG,GAAG,CAAC;AAEtC,4EAA4E;AAC5E,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B,6EAA6E;AAC7E,IAAK,kBAIJ;AAJD,WAAK,kBAAkB;IACrB,mCAAa,CAAA;IACb,yCAAmB,CAAA;IACnB,qCAAe,CAAA;AACjB,CAAC,EAJI,kBAAkB,KAAlB,kBAAkB,QAItB;AAED,wDAAwD;AACxD,SAAgB,YAAY,CAAC,QAAgB;IAC3C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,6DAA6D;AAC7D,SAAgB,WAAW,CAAC,YAAoB,EAAE,YAAoB;IACpE,OAAO,GAAG,kBAAkB,CAAC,IAAI,GAAG,0BAAkB,GAAG,YAAY,GAAG,0BAAkB,GAAG,YAAY,EAAE,CAAC;AAC9G,CAAC;AAED,gFAAgF;AAChF,SAAgB,iBAAiB,CAAC,YAAoB;IACpD,OAAO,GAAG,kBAAkB,CAAC,IAAI,GAAG,0BAAkB,GAAG,YAAY,GAAG,0BAAkB,EAAE,CAAC;AAC/F,CAAC;AAED,sDAAsD;AACtD,SAAgB,cAAc,CAAC,YAAoB,EAAE,YAAoB;IACvE,OAAO,GAAG,kBAAkB,CAAC,OAAO,GAAG,0BAAkB,GAAG,YAAY,GAAG,0BAAkB,GAAG,YAAY,EAAE,CAAC;AACjH,CAAC;AAED,2CAA2C;AAC3C,SAAgB,YAAY,CAC1B,YAAoB,EACpB,YAAoB,EACpB,MAAc,EACd,KAAa;IAEb,MAAM,WAAW,GAAG,CAAC,KAAK,GAAG,kBAAkB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;IACjG,OAAO,CAAC,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,IAAI,CACrF,0BAAkB,CACnB,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,SAAgB,kBAAkB,CAAC,YAAoB,EAAE,YAAoB;IAC3E,OAAO,GAAG,kBAAkB,CAAC,KAAK,GAAG,0BAAkB,GAAG,YAAY,GAAG,0BAAkB,GAAG,YAAY,GAAG,0BAAkB,EAAE,CAAC;AACpI,CAAC"}

package/dist/checkpointer/internal/query.d.ts

@@ -0,0 +1,16 @@
+import type { QueryCommandInput } from '@aws-sdk/lib-dynamodb';
+/** Options for {@link beginsWithQuery}. */
+export interface BeginsWithQueryOptions {
+    limit?: number;
+    ascending?: boolean;
+    consistent?: boolean;
+}
+/** Build a Query input selecting every item in a partition (all sort keys). */
+export declare function partitionQuery(tableName: string, partition: string): QueryCommandInput;
+/**
+ * Build a Query input selecting items whose partition equals `partition` and
+ * whose sort key begins with `skPrefix`. Names are aliased so reserved words
+ * never appear bare. Defaults to newest-first ordering.
+ */
+export declare function beginsWithQuery(tableName: string, partition: string, skPrefix: string, options?: BeginsWithQueryOptions): QueryCommandInput;
+//# sourceMappingURL=query.d.ts.map

package/dist/checkpointer/internal/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/checkpointer/internal/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAOtF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,sBAA2B,GACnC,iBAAiB,CAWnB"}

package/dist/checkpointer/internal/query.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.partitionQuery = partitionQuery;
+exports.beginsWithQuery = beginsWithQuery;
+/** Build a Query input selecting every item in a partition (all sort keys). */
+function partitionQuery(tableName, partition) {
+    return {
+        TableName: tableName,
+        KeyConditionExpression: '#pk = :pk',
+        ExpressionAttributeNames: { '#pk': 'PK' },
+        ExpressionAttributeValues: { ':pk': partition },
+    };
+}
+/**
+ * Build a Query input selecting items whose partition equals `partition` and
+ * whose sort key begins with `skPrefix`. Names are aliased so reserved words
+ * never appear bare. Defaults to newest-first ordering.
+ */
+function beginsWithQuery(tableName, partition, skPrefix, options = {}) {
+    const params = {
+        TableName: tableName,
+        KeyConditionExpression: '#pk = :pk AND begins_with(#sk, :skPrefix)',
+        ExpressionAttributeNames: { '#pk': 'PK', '#sk': 'SK' },
+        ExpressionAttributeValues: { ':pk': partition, ':skPrefix': skPrefix },
+        ScanIndexForward: options.ascending ?? false,
+    };
+    if (options.limit !== undefined)
+        params.Limit = options.limit;
+    if (options.consistent)
+        params.ConsistentRead = true;
+    return params;
+}
+//# sourceMappingURL=query.js.map

package/dist/checkpointer/internal/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/checkpointer/internal/query.ts"],"names":[],"mappings":";;AAUA,wCAOC;AAOD,0CAgBC;AA/BD,+EAA+E;AAC/E,SAAgB,cAAc,CAAC,SAAiB,EAAE,SAAiB;IACjE,OAAO;QACL,SAAS,EAAE,SAAS;QACpB,sBAAsB,EAAE,WAAW;QACnC,wBAAwB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;QACzC,yBAAyB,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;KAChD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe,CAC7B,SAAiB,EACjB,SAAiB,EACjB,QAAgB,EAChB,UAAkC,EAAE;IAEpC,MAAM,MAAM,GAAsB;QAChC,SAAS,EAAE,SAAS;QACpB,sBAAsB,EAAE,2CAA2C;QACnE,wBAAwB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;QACtD,yBAAyB,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE;QACtE,gBAAgB,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;KAC7C,CAAC;IACF,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC9D,IAAI,OAAO,CAAC,UAAU;QAAE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IACrD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/checkpointer/internal/setup.d.ts

@@ -0,0 +1,31 @@
+import type { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import type { DynamoDBDocument } from '@aws-sdk/lib-dynamodb';
+import type { SerializerProtocol } from '@langchain/langgraph-checkpoint';
+import type { CompressionConfig } from '../../shared/codec/compression';
+import { S3Offloader } from '../../shared/codec/s3/offloader';
+import { type Logger } from '../../shared/logging/logger';
+import type { TtlOption } from '../../shared/validation/ttl';
+import type { DynamoDBSaverOptions } from '../types';
+/** Resolved collaborators shared by every checkpointer action. */
+export interface CheckpointerContext {
+    client: DynamoDBDocument;
+    tableName: string;
+    serde: SerializerProtocol;
+    compression?: CompressionConfig;
+    offloader?: S3Offloader;
+    ttl?: TtlOption;
+    logger: Logger;
+}
+/** Result of wiring up a checkpointer from its options. */
+export interface CheckpointerSetup {
+    context: CheckpointerContext;
+    ddbClient: DynamoDBClient | undefined;
+    ownsClient: boolean;
+}
+/**
+ * Resolve the DynamoDB client, optional S3 offloader, and logging into the
+ * context every action receives, plus the ownership info the class needs to
+ * tear resources down.
+ */
+export declare function setUpCheckpointer(options: DynamoDBSaverOptions, serde: SerializerProtocol): CheckpointerSetup;
+//# sourceMappingURL=setup.d.ts.map

package/dist/checkpointer/internal/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/checkpointer/internal/setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD,kEAAkE;AAClE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,SAAS,EAAE,cAAc,GAAG,SAAS,CAAC;IACtC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,kBAAkB,GACxB,iBAAiB,CAgBnB"}

package/dist/checkpointer/internal/setup.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setUpCheckpointer = setUpCheckpointer;
+const offloader_1 = require("../../shared/codec/s3/offloader");
+const client_1 = require("../../shared/dynamodb/client");
+const logger_1 = require("../../shared/logging/logger");
+/**
+ * Resolve the DynamoDB client, optional S3 offloader, and logging into the
+ * context every action receives, plus the ownership info the class needs to
+ * tear resources down.
+ */
+function setUpCheckpointer(options, serde) {
+    const resolved = (0, client_1.resolveDynamoDBClient)(options);
+    const offloader = options.s3 ? new offloader_1.S3Offloader(options.s3) : undefined;
+    return {
+        context: {
+            client: resolved.client,
+            tableName: options.tableName,
+            serde,
+            compression: options.compression,
+            offloader,
+            ttl: options.ttl,
+            logger: (0, logger_1.resolveLogger)(options.logger),
+        },
+        ddbClient: resolved.ddbClient,
+        ownsClient: resolved.ownsClient,
+    };
+}
+//# sourceMappingURL=setup.js.map

package/dist/checkpointer/internal/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/checkpointer/internal/setup.ts"],"names":[],"mappings":";;AAkCA,8CAmBC;AAhDD,+DAA8D;AAC9D,yDAAqE;AACrE,wDAAyE;AAsBzE;;;;GAIG;AACH,SAAgB,iBAAiB,CAC/B,OAA6B,EAC7B,KAAyB;IAEzB,MAAM,QAAQ,GAAG,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,uBAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,OAAO;QACL,OAAO,EAAE;YACP,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,KAAK;YACL,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS;YACT,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,IAAA,sBAAa,EAAC,OAAO,CAAC,MAAM,CAAC;SACtC;QACD,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,CAAC;AACJ,CAAC"}

package/dist/checkpointer/internal/validation.d.ts

@@ -0,0 +1,9 @@
+/** Validate a thread id is a non-empty, separator-free string. */
+export declare function validateThreadId(threadId: string): void;
+/** Validate a checkpoint namespace is separator-free (empty is the root namespace). */
+export declare function validateCheckpointNs(checkpointNs: string): void;
+/** Validate a checkpoint id is a non-empty, separator-free string. */
+export declare function validateCheckpointId(checkpointId: string): void;
+/** Validate a task id is a non-empty, separator-free string. */
+export declare function validateTaskId(taskId: string): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/checkpointer/internal/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/checkpointer/internal/validation.ts"],"names":[],"mappings":"AAGA,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGvD;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAG/D;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAGnD"}

package/dist/checkpointer/internal/validation.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateThreadId = validateThreadId;
+exports.validateCheckpointNs = validateCheckpointNs;
+exports.validateCheckpointId = validateCheckpointId;
+exports.validateTaskId = validateTaskId;
+const primitives_1 = require("../../shared/validation/primitives");
+const keys_1 = require("./keys");
+/** Validate a thread id is a non-empty, separator-free string. */
+function validateThreadId(threadId) {
+    (0, primitives_1.validateNonEmptyString)(threadId, 'thread_id');
+    (0, primitives_1.assertNoSeparator)(threadId, keys_1.SORT_KEY_SEPARATOR, 'thread_id');
+}
+/** Validate a checkpoint namespace is separator-free (empty is the root namespace). */
+function validateCheckpointNs(checkpointNs) {
+    (0, primitives_1.assertNoSeparator)(checkpointNs, keys_1.SORT_KEY_SEPARATOR, 'checkpoint_ns');
+}
+/** Validate a checkpoint id is a non-empty, separator-free string. */
+function validateCheckpointId(checkpointId) {
+    (0, primitives_1.validateNonEmptyString)(checkpointId, 'checkpoint_id');
+    (0, primitives_1.assertNoSeparator)(checkpointId, keys_1.SORT_KEY_SEPARATOR, 'checkpoint_id');
+}
+/** Validate a task id is a non-empty, separator-free string. */
+function validateTaskId(taskId) {
+    (0, primitives_1.validateNonEmptyString)(taskId, 'taskId');
+    (0, primitives_1.assertNoSeparator)(taskId, keys_1.SORT_KEY_SEPARATOR, 'taskId');
+}
+//# sourceMappingURL=validation.js.map

package/dist/checkpointer/internal/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/checkpointer/internal/validation.ts"],"names":[],"mappings":";;AAIA,4CAGC;AAGD,oDAEC;AAGD,oDAGC;AAGD,wCAGC;AAxBD,mEAA+F;AAC/F,iCAA4C;AAE5C,kEAAkE;AAClE,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,IAAA,mCAAsB,EAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC9C,IAAA,8BAAiB,EAAC,QAAQ,EAAE,yBAAkB,EAAE,WAAW,CAAC,CAAC;AAC/D,CAAC;AAED,uFAAuF;AACvF,SAAgB,oBAAoB,CAAC,YAAoB;IACvD,IAAA,8BAAiB,EAAC,YAAY,EAAE,yBAAkB,EAAE,eAAe,CAAC,CAAC;AACvE,CAAC;AAED,sEAAsE;AACtE,SAAgB,oBAAoB,CAAC,YAAoB;IACvD,IAAA,mCAAsB,EAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IACtD,IAAA,8BAAiB,EAAC,YAAY,EAAE,yBAAkB,EAAE,eAAe,CAAC,CAAC;AACvE,CAAC;AAED,gEAAgE;AAChE,SAAgB,cAAc,CAAC,MAAc;IAC3C,IAAA,mCAAsB,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzC,IAAA,8BAAiB,EAAC,MAAM,EAAE,yBAAkB,EAAE,QAAQ,CAAC,CAAC;AAC1D,CAAC"}

package/dist/checkpointer/saver.d.ts

@@ -0,0 +1,21 @@
+import type { RunnableConfig } from '@langchain/core/runnables';
+import { BaseCheckpointSaver, type Checkpoint, type CheckpointListOptions, type CheckpointMetadata, type CheckpointTuple, type PendingWrite } from '@langchain/langgraph-checkpoint';
+import type { DynamoDBSaverOptions } from './types';
+/**
+ * DynamoDB-backed LangGraph checkpoint saver. A thin orchestrator: it resolves
+ * its collaborators once and delegates every operation to a focused action.
+ */
+export declare class DynamoDBSaver extends BaseCheckpointSaver {
+    private readonly context;
+    private readonly ownsClient;
+    private readonly ddbClient;
+    constructor(options: DynamoDBSaverOptions);
+    getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined>;
+    list(config: RunnableConfig, options?: CheckpointListOptions): AsyncGenerator<CheckpointTuple>;
+    put(config: RunnableConfig, checkpoint: Checkpoint, metadata: CheckpointMetadata): Promise<RunnableConfig>;
+    putWrites(config: RunnableConfig, writes: PendingWrite[], taskId: string): Promise<void>;
+    deleteThread(threadId: string): Promise<void>;
+    /** Release owned resources (the underlying client and any S3 client). */
+    destroy(): void;
+}
+//# sourceMappingURL=saver.d.ts.map

package/dist/checkpointer/saver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saver.d.ts","sourceRoot":"","sources":["../../src/checkpointer/saver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EACL,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC;AAQzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD;;;GAGG;AACH,qBAAa,aAAc,SAAQ,mBAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoD;gBAElE,OAAO,EAAE,oBAAoB;IAQnC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAI5E,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAAC,eAAe,CAAC;IAIxF,GAAG,CACP,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,cAAc,CAAC;IAIpB,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,yEAAyE;IACzE,OAAO,IAAI,IAAI;CAIhB"}

package/dist/checkpointer/saver.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamoDBSaver = void 0;
+const langgraph_checkpoint_1 = require("@langchain/langgraph-checkpoint");
+const delete_thread_1 = require("./actions/delete-thread");
+const get_tuple_1 = require("./actions/get-tuple");
+const list_1 = require("./actions/list");
+const put_1 = require("./actions/put");
+const put_writes_1 = require("./actions/put-writes");
+const setup_1 = require("./internal/setup");
+/**
+ * DynamoDB-backed LangGraph checkpoint saver. A thin orchestrator: it resolves
+ * its collaborators once and delegates every operation to a focused action.
+ */
+class DynamoDBSaver extends langgraph_checkpoint_1.BaseCheckpointSaver {
+    context;
+    ownsClient;
+    ddbClient;
+    constructor(options) {
+        super(options.serde);
+        const setup = (0, setup_1.setUpCheckpointer)(options, this.serde);
+        this.context = setup.context;
+        this.ownsClient = setup.ownsClient;
+        this.ddbClient = setup.ddbClient;
+    }
+    async getTuple(config) {
+        return (0, get_tuple_1.getCheckpointTuple)(this.context, config);
+    }
+    list(config, options) {
+        return (0, list_1.listCheckpoints)(this.context, config, options);
+    }
+    async put(config, checkpoint, metadata) {
+        return (0, put_1.putCheckpoint)(this.context, config, checkpoint, metadata);
+    }
+    async putWrites(config, writes, taskId) {
+        return (0, put_writes_1.putWrites)(this.context, config, writes, taskId);
+    }
+    async deleteThread(threadId) {
+        return (0, delete_thread_1.deleteThread)(this.context, threadId);
+    }
+    /** Release owned resources (the underlying client and any S3 client). */
+    destroy() {
+        this.context.offloader?.destroy();
+        if (this.ownsClient)
+            this.ddbClient?.destroy();
+    }
+}
+exports.DynamoDBSaver = DynamoDBSaver;
+//# sourceMappingURL=saver.js.map

package/dist/checkpointer/saver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saver.js","sourceRoot":"","sources":["../../src/checkpointer/saver.ts"],"names":[],"mappings":";;;AACA,0EAOyC;AAEzC,2DAA6E;AAC7E,mDAAyD;AACzD,yCAAiD;AACjD,uCAA8C;AAC9C,qDAAoE;AACpE,4CAA+E;AAG/E;;;GAGG;AACH,MAAa,aAAc,SAAQ,0CAAmB;IACnC,OAAO,CAAsB;IAC7B,UAAU,CAAU;IACpB,SAAS,CAAoD;IAE9E,YAAY,OAA6B;QACvC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACrB,MAAM,KAAK,GAAG,IAAA,yBAAiB,EAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAsB;QACnC,OAAO,IAAA,8BAAkB,EAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,CAAC,MAAsB,EAAE,OAA+B;QAC1D,OAAO,IAAA,sBAAe,EAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,GAAG,CACP,MAAsB,EACtB,UAAsB,EACtB,QAA4B;QAE5B,OAAO,IAAA,mBAAa,EAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAsB,EAAE,MAAsB,EAAE,MAAc;QAC5E,OAAO,IAAA,sBAAe,EAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAgB;QACjC,OAAO,IAAA,4BAAkB,EAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,yEAAyE;IACzE,OAAO;QACL,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,UAAU;YAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;IACjD,CAAC;CACF;AA1CD,sCA0CC"}

package/dist/checkpointer/types.d.ts

@@ -0,0 +1,43 @@
+import type { SerializerProtocol } from '@langchain/langgraph-checkpoint';
+import type { PayloadDescriptor } from '../shared/codec/codec';
+import type { BaseAdapterOptions, CodecOptions } from '../shared/options';
+/** Options for {@link DynamoDBSaver}. */
+export type DynamoDBSaverOptions = BaseAdapterOptions & CodecOptions & {
+    /** Optional serializer override (defaults to LangGraph's JSON serializer). */
+    serde?: SerializerProtocol;
+};
+/** Narrowed shape of `RunnableConfig.configurable` the saver relies on. */
+export interface CheckpointConfigurable {
+    thread_id: string;
+    checkpoint_ns?: string;
+    checkpoint_id?: string;
+}
+/** The lightweight `META#` item: structural fields + serialized metadata. */
+export interface CheckpointMetaItem {
+    PK: string;
+    SK: string;
+    threadId: string;
+    checkpointNs: string;
+    checkpointId: string;
+    parentCheckpointId?: string;
+    metadata: PayloadDescriptor;
+    ttl?: number;
+}
+/** The heavy `PAYLOAD#` item: the serialized checkpoint. */
+export interface CheckpointPayloadItem {
+    PK: string;
+    SK: string;
+    checkpoint: PayloadDescriptor;
+    ttl?: number;
+}
+/** A `WRITE#` item: one pending write for a checkpoint/task. */
+export interface CheckpointWriteItem {
+    PK: string;
+    SK: string;
+    taskId: string;
+    index: number;
+    channel: string;
+    value: PayloadDescriptor;
+    ttl?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/checkpointer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/checkpointer/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1E,yCAAyC;AACzC,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,GACnD,YAAY,GAAG;IACb,8EAA8E;IAC9E,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B,CAAC;AAEJ,2EAA2E;AAC3E,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,4DAA4D;AAC5D,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,iBAAiB,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,iBAAiB,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd"}

package/dist/{store/types/index.js → checkpointer/types.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=types.js.map

package/dist/checkpointer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/checkpointer/types.ts"],"names":[],"mappings":""}

package/dist/factory/factory.d.ts

@@ -0,0 +1,41 @@
+import { DynamoDBClient, type DynamoDBClientConfig } from '@aws-sdk/client-dynamodb';
+import { DynamoDBSaver } from '../checkpointer/saver';
+import type { DynamoDBSaverOptions } from '../checkpointer/types';
+import { DynamoDBChatMessageHistory } from '../history/chat-message-history';
+import type { DynamoDBChatMessageHistoryOptions } from '../history/types';
+import type { Logger } from '../shared/logging/logger';
+import { DynamoDBStore } from '../store/store';
+import type { DynamoDBStoreOptions } from '../store/types';
+/** Shared client/logger defaults applied to every adapter the factory builds. */
+export interface FactoryBaseOptions {
+    clientConfig?: DynamoDBClientConfig;
+    createClient?: (config: DynamoDBClientConfig) => DynamoDBClient;
+    logger?: Logger;
+}
+/** Per-adapter options for {@link DynamoDBFactory.createAll} (client is shared). */
+export interface CreateAllOptions {
+    saver: Omit<DynamoDBSaverOptions, 'client'>;
+    store: Omit<DynamoDBStoreOptions, 'client'>;
+    history: Omit<DynamoDBChatMessageHistoryOptions, 'client'>;
+}
+/** The three adapters sharing one client, plus a combined `destroy`. */
+export interface CreatedAdapters {
+    saver: DynamoDBSaver;
+    store: DynamoDBStore;
+    history: DynamoDBChatMessageHistory;
+    destroy: () => void;
+}
+/**
+ * Convenience constructors for the adapters. Individual `create*` methods each
+ * build their own client; {@link createAll} builds one shared client used by all
+ * three and returns a combined `destroy` that tears everything down once.
+ */
+export declare class DynamoDBFactory {
+    private readonly base;
+    constructor(base?: FactoryBaseOptions);
+    createSaver(options: DynamoDBSaverOptions): DynamoDBSaver;
+    createStore(options: DynamoDBStoreOptions): DynamoDBStore;
+    createChatMessageHistory(options: DynamoDBChatMessageHistoryOptions): DynamoDBChatMessageHistory;
+    createAll(options: CreateAllOptions): CreatedAdapters;
+}
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/factory/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGrF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,cAAc,CAAC;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IAC5C,KAAK,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IAC5C,OAAO,EAAE,IAAI,CAAC,iCAAiC,EAAE,QAAQ,CAAC,CAAC;CAC5D;AAED,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,0BAA0B,CAAC;IACpC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;GAIG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,GAAE,kBAAuB;IAE1D,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa;IAIzD,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa;IAIzD,wBAAwB,CAAC,OAAO,EAAE,iCAAiC,GAAG,0BAA0B;IAIhG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe;CAmBtD"}

package/dist/factory/factory.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamoDBFactory = void 0;
+const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
+const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
+const saver_1 = require("../checkpointer/saver");
+const chat_message_history_1 = require("../history/chat-message-history");
+const store_1 = require("../store/store");
+/**
+ * Convenience constructors for the adapters. Individual `create*` methods each
+ * build their own client; {@link createAll} builds one shared client used by all
+ * three and returns a combined `destroy` that tears everything down once.
+ */
+class DynamoDBFactory {
+    base;
+    constructor(base = {}) {
+        this.base = base;
+    }
+    createSaver(options) {
+        return new saver_1.DynamoDBSaver({ ...this.base, ...options });
+    }
+    createStore(options) {
+        return new store_1.DynamoDBStore({ ...this.base, ...options });
+    }
+    createChatMessageHistory(options) {
+        return new chat_message_history_1.DynamoDBChatMessageHistory({ ...this.base, ...options });
+    }
+    createAll(options) {
+        const build = this.base.createClient ?? ((config) => new client_dynamodb_1.DynamoDBClient(config));
+        const ddbClient = build(this.base.clientConfig ?? {});
+        const client = lib_dynamodb_1.DynamoDBDocument.from(ddbClient);
+        const saver = new saver_1.DynamoDBSaver({ ...this.base, ...options.saver, client });
+        const store = new store_1.DynamoDBStore({ ...this.base, ...options.store, client });
+        const history = new chat_message_history_1.DynamoDBChatMessageHistory({ ...this.base, ...options.history, client });
+        return {
+            saver,
+            store,
+            history,
+            destroy: () => {
+                saver.destroy();
+                store.destroy();
+                history.destroy();
+                ddbClient.destroy();
+            },
+        };
+    }
+}
+exports.DynamoDBFactory = DynamoDBFactory;
+//# sourceMappingURL=factory.js.map