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

package/dist/history/internal/session-update.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSessionUpdateItem = buildSessionUpdateItem;
+const keys_1 = require("./keys");
+/**
+ * Build the metadata `Update` transact-item: `ADD` the message count and `SET`
+ * `updatedAt` every time, while `createdAt`, `sessionId`, `title`, and the `ttl`
+ * anchor are written once via `if_not_exists`. Folding the `ttl` anchor in here
+ * means the first append fixes one shared expiry atomically with the count, with
+ * no separate pre-write that could orphan a metadata-only row.
+ */
+function buildSessionUpdateItem(tableName, fields) {
+    const names = {
+        '#count': 'messageCount',
+        '#u': 'updatedAt',
+        '#c': 'createdAt',
+        '#sid': 'sessionId',
+    };
+    const values = {
+        ':n': fields.count,
+        ':u': fields.now,
+        ':c': fields.now,
+        ':sid': fields.sessionId,
+    };
+    const sets = ['#u = :u', '#c = if_not_exists(#c, :c)', '#sid = if_not_exists(#sid, :sid)'];
+    if (fields.title !== undefined) {
+        names['#title'] = 'title';
+        values[':title'] = fields.title;
+        sets.push('#title = if_not_exists(#title, :title)');
+    }
+    if (fields.ttlTimestamp !== undefined) {
+        names['#ttl'] = 'ttl';
+        values[':ttl'] = fields.ttlTimestamp;
+        sets.push('#ttl = if_not_exists(#ttl, :ttl)');
+    }
+    return {
+        Update: {
+            TableName: tableName,
+            Key: { PK: (0, keys_1.sessionPartition)(fields.sessionId), SK: keys_1.SESSION_SORT_KEY },
+            UpdateExpression: `ADD #count :n SET ${sets.join(', ')}`,
+            ExpressionAttributeNames: names,
+            ExpressionAttributeValues: values,
+        },
+    };
+}
+//# sourceMappingURL=session-update.js.map

package/dist/history/internal/session-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-update.js","sourceRoot":"","sources":["../../../src/history/internal/session-update.ts"],"names":[],"mappings":";;AAuBA,wDAoCC;AAzDD,iCAA4D;AAc5D;;;;;;GAMG;AACH,SAAgB,sBAAsB,CACpC,SAAiB,EACjB,MAA2B;IAE3B,MAAM,KAAK,GAA2B;QACpC,QAAQ,EAAE,cAAc;QACxB,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,WAAW;KACpB,CAAC;IACF,MAAM,MAAM,GAAyC;QACnD,IAAI,EAAE,MAAM,CAAC,KAAK;QAClB,IAAI,EAAE,MAAM,CAAC,GAAG;QAChB,IAAI,EAAE,MAAM,CAAC,GAAG;QAChB,MAAM,EAAE,MAAM,CAAC,SAAS;KACzB,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,4BAA4B,EAAE,kCAAkC,CAAC,CAAC;IAC3F,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,KAAK,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;QAC1B,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACtC,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;QACtB,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAChD,CAAC;IACD,OAAO;QACL,MAAM,EAAE;YACN,SAAS,EAAE,SAAS;YACpB,GAAG,EAAE,EAAE,EAAE,EAAE,IAAA,uBAAgB,EAAC,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,uBAAgB,EAAE;YACrE,gBAAgB,EAAE,qBAAqB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACxD,wBAAwB,EAAE,KAAK;YAC/B,yBAAyB,EAAE,MAAM;SAClC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,28 @@
+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 { DynamoDBChatMessageHistoryOptions } from '../types';
+/** Resolved collaborators shared by every chat-history action. */
+export interface HistoryContext {
+    client: DynamoDBDocument;
+    tableName: string;
+    serde: SerializerProtocol;
+    compression?: CompressionConfig;
+    offloader?: S3Offloader;
+    ttl?: TtlOption;
+    logger: Logger;
+    ulid: () => string;
+}
+/** Result of wiring up a chat-history adapter from its options. */
+export interface HistorySetup {
+    context: HistoryContext;
+    ddbClient: DynamoDBClient | undefined;
+    ownsClient: boolean;
+}
+/** Resolve the client, optional S3 offloader, and serializer into a context. */
+export declare function setUpHistory(options: DynamoDBChatMessageHistoryOptions): HistorySetup;
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/history/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;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,6BAA6B,CAAC;AAEzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,UAAU,CAAC;AAElE,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,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;IACf,IAAI,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,cAAc,GAAG,SAAS,CAAC;IACtC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,OAAO,EAAE,iCAAiC,GAAG,YAAY,CAgBrF"}

package/dist/history/internal/setup.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setUpHistory = setUpHistory;
+const json_serde_1 = require("../../shared/codec/json-serde");
+const offloader_1 = require("../../shared/codec/s3/offloader");
+const client_1 = require("../../shared/dynamodb/client");
+const logger_1 = require("../../shared/logging/logger");
+const ulid_1 = require("../../shared/ulid");
+/** Resolve the client, optional S3 offloader, and serializer into a context. */
+function setUpHistory(options) {
+    const resolved = (0, client_1.resolveDynamoDBClient)(options);
+    return {
+        context: {
+            client: resolved.client,
+            tableName: options.tableName,
+            serde: options.serde ?? json_serde_1.JSON_SERDE,
+            compression: options.compression,
+            offloader: options.s3 ? new offloader_1.S3Offloader(options.s3) : undefined,
+            ttl: options.ttl,
+            logger: (0, logger_1.resolveLogger)(options.logger),
+            ulid: (0, ulid_1.createUlidFactory)(),
+        },
+        ddbClient: resolved.ddbClient,
+        ownsClient: resolved.ownsClient,
+    };
+}
+//# sourceMappingURL=setup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/history/internal/setup.ts"],"names":[],"mappings":";;AAiCA,oCAgBC;AA5CD,8DAA2D;AAC3D,+DAA8D;AAC9D,yDAAqE;AACrE,wDAAyE;AACzE,4CAAsD;AAuBtD,gFAAgF;AAChF,SAAgB,YAAY,CAAC,OAA0C;IACrE,MAAM,QAAQ,GAAG,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAChD,OAAO;QACL,OAAO,EAAE;YACP,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,uBAAU;YAClC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,uBAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;YAC/D,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,IAAA,sBAAa,EAAC,OAAO,CAAC,MAAM,CAAC;YACrC,IAAI,EAAE,IAAA,wBAAiB,GAAE;SAC1B;QACD,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,CAAC;AACJ,CAAC"}

package/dist/history/internal/title-generator.d.ts

@@ -0,0 +1,7 @@
+import type { StoredMessage } from '@langchain/core/messages';
+/**
+ * Derive a session title from the first human message's text content, truncated
+ * to {@link MAX_TITLE_LENGTH}. Returns undefined when there is no usable text.
+ */
+export declare function deriveTitle(messages: StoredMessage[]): string | undefined;
+//# sourceMappingURL=title-generator.d.ts.map

package/dist/history/internal/title-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-generator.d.ts","sourceRoot":"","sources":["../../../src/history/internal/title-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAI9D;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,GAAG,SAAS,CAKzE"}

package/dist/history/internal/title-generator.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveTitle = deriveTitle;
+const MAX_TITLE_LENGTH = 80;
+/**
+ * Derive a session title from the first human message's text content, truncated
+ * to {@link MAX_TITLE_LENGTH}. Returns undefined when there is no usable text.
+ */
+function deriveTitle(messages) {
+    const firstHuman = messages.find((message) => message.type === 'human');
+    const content = firstHuman?.data.content;
+    if (typeof content !== 'string' || content.length === 0)
+        return undefined;
+    return content.length > MAX_TITLE_LENGTH ? `${content.slice(0, MAX_TITLE_LENGTH)}…` : content;
+}
+//# sourceMappingURL=title-generator.js.map

package/dist/history/internal/title-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-generator.js","sourceRoot":"","sources":["../../../src/history/internal/title-generator.ts"],"names":[],"mappings":";;AAQA,kCAKC;AAXD,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B;;;GAGG;AACH,SAAgB,WAAW,CAAC,QAAyB;IACnD,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC;IACzC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1E,OAAO,OAAO,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;AAChG,CAAC"}

package/dist/history/internal/ttl-anchor.d.ts

@@ -0,0 +1,12 @@
+import type { HistoryContext } from './setup';
+/**
+ * Resolve the session's creation-anchored TTL: the value already stored on the
+ * SESSION item if one exists, otherwise the supplied `candidate`. This is a
+ * strongly-consistent read, never a write, so it cannot leave a metadata-only
+ * orphan row when the following append transaction fails. The append transaction
+ * itself sets the anchor via `if_not_exists`, so concurrent first appends still
+ * converge on a single shared expiry, and every later append reuses it — giving
+ * all message items in a session one uniform expiry.
+ */
+export declare function resolveTtlAnchor(context: HistoryContext, sessionId: string, candidate: number): Promise<number>;
+//# sourceMappingURL=ttl-anchor.d.ts.map

package/dist/history/internal/ttl-anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl-anchor.d.ts","sourceRoot":"","sources":["../../../src/history/internal/ttl-anchor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAYjB"}

package/dist/history/internal/ttl-anchor.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTtlAnchor = resolveTtlAnchor;
+const retry_1 = require("../../shared/dynamodb/retry");
+const keys_1 = require("./keys");
+/**
+ * Resolve the session's creation-anchored TTL: the value already stored on the
+ * SESSION item if one exists, otherwise the supplied `candidate`. This is a
+ * strongly-consistent read, never a write, so it cannot leave a metadata-only
+ * orphan row when the following append transaction fails. The append transaction
+ * itself sets the anchor via `if_not_exists`, so concurrent first appends still
+ * converge on a single shared expiry, and every later append reuses it — giving
+ * all message items in a session one uniform expiry.
+ */
+async function resolveTtlAnchor(context, sessionId, candidate) {
+    const result = await (0, retry_1.withDynamoDBRetry)(() => context.client.get({
+        TableName: context.tableName,
+        Key: { PK: (0, keys_1.sessionPartition)(sessionId), SK: keys_1.SESSION_SORT_KEY },
+        ConsistentRead: true,
+        ProjectionExpression: '#ttl',
+        ExpressionAttributeNames: { '#ttl': 'ttl' },
+    }));
+    const ttl = result.Item?.ttl;
+    return typeof ttl === 'number' ? ttl : candidate;
+}
+//# sourceMappingURL=ttl-anchor.js.map

package/dist/history/internal/ttl-anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl-anchor.js","sourceRoot":"","sources":["../../../src/history/internal/ttl-anchor.ts"],"names":[],"mappings":";;AAaA,4CAgBC;AA7BD,uDAAgE;AAChE,iCAA4D;AAG5D;;;;;;;;GAQG;AACI,KAAK,UAAU,gBAAgB,CACpC,OAAuB,EACvB,SAAiB,EACjB,SAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAiB,EAAC,GAAG,EAAE,CAC1C,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,GAAG,EAAE,EAAE,EAAE,EAAE,IAAA,uBAAgB,EAAC,SAAS,CAAC,EAAE,EAAE,EAAE,uBAAgB,EAAE;QAC9D,cAAc,EAAE,IAAI;QACpB,oBAAoB,EAAE,MAAM;QAC5B,wBAAwB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;KAC5C,CAAC,CACH,CAAC;IACF,MAAM,GAAG,GAAI,MAAM,CAAC,IAAqC,EAAE,GAAG,CAAC;IAC/D,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC"}

package/dist/history/session-adapter.d.ts

@@ -1,36 +1,20 @@
-/**
- * Adapter that exposes a single (userId, sessionId) pair through the
- * LangChain `BaseListChatMessageHistory` contract so the DynamoDB-backed
- * history can be plugged into `RunnableWithMessageHistory` and anywhere else
- * that expects the standard interface.
- *
- * Use {@link DynamoDBChatMessageHistory.forSession} to obtain one; see that
- * method's JSDoc for the LangChain integration pattern.
- */
-import type { DynamoDBDocument } from '@aws-sdk/lib-dynamodb';
 import { BaseListChatMessageHistory } from '@langchain/core/chat_history';
 import type { BaseMessage } from '@langchain/core/messages';
-export interface DynamoDBSessionChatMessageHistoryParams {
-    client: DynamoDBDocument;
-    tableName: string;
-    userId: string;
-    sessionId: string;
-    ttlDays?: number;
+/** The session-scoped operations a single-session adapter delegates to. */
+export interface SessionBackend {
+    getMessages(sessionId: string): Promise<BaseMessage[]>;
+    addMessages(sessionId: string, messages: BaseMessage[]): Promise<void>;
+    clear(sessionId: string): Promise<void>;
 }
 /**
- * Single-session LangChain `BaseListChatMessageHistory` backed by the same
- * DynamoDB table used by `DynamoDBChatMessageHistory`. Instances close over a
- * specific `(userId, sessionId)` pair; pass through
- * `RunnableWithMessageHistory` via a `GetSessionHistoryCallable`.
+ * Single-session view over a {@link SessionBackend}, implementing LangChain's
+ * `BaseListChatMessageHistory` so it can drive `RunnableWithMessageHistory`.
  */
 export declare class DynamoDBSessionChatMessageHistory extends BaseListChatMessageHistory {
-    lc_namespace: string[];
-    private readonly client;
-    private readonly tableName;
-    private readonly userId;
+    private readonly backend;
     private readonly sessionId;
-    private readonly ttlDays?;
-    constructor(params: DynamoDBSessionChatMessageHistoryParams);
+    lc_namespace: string[];
+    constructor(backend: SessionBackend, sessionId: string);
     getMessages(): Promise<BaseMessage[]>;
     addMessage(message: BaseMessage): Promise<void>;
     addMessages(messages: BaseMessage[]): Promise<void>;

package/dist/history/session-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-adapter.d.ts","sourceRoot":"","sources":["../../src/history/session-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAI5D,MAAM,WAAW,uCAAuC;IACtD,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,iCAAkC,SAAQ,0BAA0B;IAC/E,YAAY,WAAkD;IAE9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;gBAEtB,MAAM,EAAE,uCAAuC;IASrD,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IASrC,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/C,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B"}
+{"version":3,"file":"session-adapter.d.ts","sourceRoot":"","sources":["../../src/history/session-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACvD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,qBAAa,iCAAkC,SAAQ,0BAA0B;IAI7E,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,YAAY,WAAkD;gBAG3C,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM;IAKpC,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAIrC,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvB"}

package/dist/history/session-adapter.js

@@ -1,73 +1,31 @@
 "use strict";
-/**
- * Adapter that exposes a single (userId, sessionId) pair through the
- * LangChain `BaseListChatMessageHistory` contract so the DynamoDB-backed
- * history can be plugged into `RunnableWithMessageHistory` and anywhere else
- * that expects the standard interface.
- *
- * Use {@link DynamoDBChatMessageHistory.forSession} to obtain one; see that
- * method's JSDoc for the LangChain integration pattern.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DynamoDBSessionChatMessageHistory = void 0;
 const chat_history_1 = require("@langchain/core/chat_history");
-const actions_1 = require("./actions");
 /**
- * Single-session LangChain `BaseListChatMessageHistory` backed by the same
- * DynamoDB table used by `DynamoDBChatMessageHistory`. Instances close over a
- * specific `(userId, sessionId)` pair; pass through
- * `RunnableWithMessageHistory` via a `GetSessionHistoryCallable`.
+ * Single-session view over a {@link SessionBackend}, implementing LangChain's
+ * `BaseListChatMessageHistory` so it can drive `RunnableWithMessageHistory`.
  */
 class DynamoDBSessionChatMessageHistory extends chat_history_1.BaseListChatMessageHistory {
-    lc_namespace = ['langchain', 'stores', 'message', 'dynamodb'];
-    client;
-    tableName;
-    userId;
+    backend;
     sessionId;
-    ttlDays;
-    constructor(params) {
+    lc_namespace = ['langchain', 'stores', 'message', 'dynamodb'];
+    constructor(backend, sessionId) {
         super();
-        this.client = params.client;
-        this.tableName = params.tableName;
-        this.userId = params.userId;
-        this.sessionId = params.sessionId;
-        this.ttlDays = params.ttlDays;
+        this.backend = backend;
+        this.sessionId = sessionId;
     }
-    async getMessages() {
-        return await (0, actions_1.getMessagesAction)({
-            client: this.client,
-            tableName: this.tableName,
-            userId: this.userId,
-            sessionId: this.sessionId,
-        });
+    getMessages() {
+        return this.backend.getMessages(this.sessionId);
     }
-    async addMessage(message) {
-        await (0, actions_1.addMessageAction)({
-            client: this.client,
-            tableName: this.tableName,
-            userId: this.userId,
-            sessionId: this.sessionId,
-            message,
-            ttlDays: this.ttlDays,
-        });
+    addMessage(message) {
+        return this.backend.addMessages(this.sessionId, [message]);
     }
-    async addMessages(messages) {
-        await (0, actions_1.addMessagesAction)({
-            client: this.client,
-            tableName: this.tableName,
-            userId: this.userId,
-            sessionId: this.sessionId,
-            messages,
-            ttlDays: this.ttlDays,
-        });
+    addMessages(messages) {
+        return this.backend.addMessages(this.sessionId, messages);
     }
-    async clear() {
-        await (0, actions_1.clearAction)({
-            client: this.client,
-            tableName: this.tableName,
-            userId: this.userId,
-            sessionId: this.sessionId,
-        });
+    clear() {
+        return this.backend.clear(this.sessionId);
     }
 }
 exports.DynamoDBSessionChatMessageHistory = DynamoDBSessionChatMessageHistory;

package/dist/history/session-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-adapter.js","sourceRoot":"","sources":["../../src/history/session-adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAGH,+DAA0E;AAG1E,uCAAgG;AAUhG;;;;;GAKG;AACH,MAAa,iCAAkC,SAAQ,yCAA0B;IAC/E,YAAY,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAE7C,MAAM,CAAmB;IACzB,SAAS,CAAS;IAClB,MAAM,CAAS;IACf,SAAS,CAAS;IAClB,OAAO,CAAU;IAElC,YAAY,MAA+C;QACzD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,MAAM,IAAA,2BAAiB,EAAC;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAoB;QACnC,MAAM,IAAA,0BAAgB,EAAC;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO;YACP,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAuB;QACvC,MAAM,IAAA,2BAAiB,EAAC;YACtB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ;YACR,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAA,qBAAW,EAAC;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC;CACF;AAzDD,8EAyDC"}
+{"version":3,"file":"session-adapter.js","sourceRoot":"","sources":["../../src/history/session-adapter.ts"],"names":[],"mappings":";;;AAAA,+DAA0E;AAU1E;;;GAGG;AACH,MAAa,iCAAkC,SAAQ,yCAA0B;IAI5D;IACA;IAJnB,YAAY,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAE9D,YACmB,OAAuB,EACvB,SAAiB;QAElC,KAAK,EAAE,CAAC;QAHS,YAAO,GAAP,OAAO,CAAgB;QACvB,cAAS,GAAT,SAAS,CAAQ;IAGpC,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,UAAU,CAAC,OAAoB;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,WAAW,CAAC,QAAuB;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;CACF;AAzBD,8EAyBC"}

package/dist/history/types.d.ts

@@ -0,0 +1,36 @@
+import type { SerializerProtocol } from '@langchain/langgraph-checkpoint';
+import type { PayloadDescriptor } from '../shared/codec/codec';
+import type { BaseAdapterOptions, CodecOptions } from '../shared/options';
+/** Options for {@link DynamoDBChatMessageHistory}. */
+export type DynamoDBChatMessageHistoryOptions = BaseAdapterOptions & CodecOptions & {
+    /** Optional serializer override (defaults to the JSON serializer). */
+    serde?: SerializerProtocol;
+};
+/** Summary of a stored chat session. */
+export interface SessionMetadata {
+    sessionId: string;
+    title?: string;
+    messageCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/** A single stored chat message item (one per message, ordered by its ULID). */
+export interface ChatMessageItem {
+    PK: string;
+    SK: string;
+    sessionId: string;
+    message: PayloadDescriptor;
+    ttl?: number;
+}
+/** The per-session metadata item, updated atomically as messages are appended. */
+export interface ChatSessionItem {
+    PK: string;
+    SK: string;
+    sessionId: string;
+    messageCount: number;
+    title?: string;
+    createdAt: string;
+    updatedAt: string;
+    ttl?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/history/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,sDAAsD;AACtD,MAAM,MAAM,iCAAiC,GAAG,kBAAkB,GAChE,YAAY,GAAG;IACb,sEAAsE;IACtE,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B,CAAC;AAEJ,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd"}

package/dist/history/types.js

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

package/dist/history/types.js.map

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

package/dist/index.d.ts

@@ -1,14 +1,22 @@
-export { DynamoDBSaver } from './checkpointer';
+export { DynamoDBSaver } from './checkpointer/saver';
 export type { DynamoDBSaverOptions } from './checkpointer/types';
-export { DynamoDBStore } from './store';
+export { DynamoDBStore } from './store/store';
 export type { DynamoDBStoreOptions } from './store/types';
-export { DynamoDBChatMessageHistory, DynamoDBSessionChatMessageHistory } from './history';
+export type { VectorReconcileResult } from './store/actions/reconcile-vector-index';
+export type { VectorBackend, VectorMatch, VectorRef } from './store/vector-backend';
+export { DynamoDBChatMessageHistory } from './history/chat-message-history';
+export { DynamoDBSessionChatMessageHistory } from './history/session-adapter';
 export type { DynamoDBChatMessageHistoryOptions, SessionMetadata } from './history/types';
-export { DynamoDBFactory } from './factory';
-export { setGlobalLogger, getLogger, resetLogger, redactLogger, redactSecrets, } from './shared/utils/logger';
-export type { Logger } from './shared/utils/logger';
-export type { CompressionConfig } from './shared/utils/compressor';
-export type { S3OffloadConfig } from './shared/utils/s3-offloader';
-export type { RetryOptions } from './shared/utils/retry';
-export { BatchWriteIncompleteError } from './shared/utils/batch-write';
+export { DynamoDBFactory } from './factory/factory';
+export type { CreateAllOptions, CreatedAdapters, FactoryBaseOptions } from './factory/factory';
+export { DynamoDbLangGraphError } from './shared/errors/base-error';
+export type { ErrorContext } from './shared/errors/base-error';
+export { ErrorCode } from './shared/errors/error-code';
+export { AbortError, BatchWriteIncompleteError, CompensationFailedError, ConflictError, ResultTruncatedError, RetryExhaustedError, ValidationError, } from './shared/errors/errors';
+export type { Logger, LogArgument } from './shared/logging/logger';
+export { redactLogger, redactSecrets } from './shared/logging/redaction';
+export type { BaseAdapterOptions, CodecOptions } from './shared/options';
+export type { TtlOption } from './shared/validation/ttl';
+export type { CompressionConfig } from './shared/codec/compression';
+export type { S3OffloadConfig } from './shared/codec/s3/config';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,iCAAiC,EAAE,MAAM,WAAW,CAAC;AAC1F,YAAY,EAAE,iCAAiC,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EACL,eAAe,EACf,SAAS,EACT,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,YAAY,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AACpF,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,iCAAiC,EAAE,MAAM,2BAA2B,CAAC;AAC9E,YAAY,EAAE,iCAAiC,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE/F,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EACL,UAAU,EACV,yBAAyB,EACzB,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEzE,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACzE,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,21 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BatchWriteIncompleteError = exports.redactSecrets = exports.redactLogger = exports.resetLogger = exports.getLogger = exports.setGlobalLogger = exports.DynamoDBFactory = exports.DynamoDBSessionChatMessageHistory = exports.DynamoDBChatMessageHistory = exports.DynamoDBStore = exports.DynamoDBSaver = void 0;
-var checkpointer_1 = require("./checkpointer");
-Object.defineProperty(exports, "DynamoDBSaver", { enumerable: true, get: function () { return checkpointer_1.DynamoDBSaver; } });
-var store_1 = require("./store");
+exports.redactSecrets = exports.redactLogger = exports.ValidationError = exports.RetryExhaustedError = exports.ResultTruncatedError = exports.ConflictError = exports.CompensationFailedError = exports.BatchWriteIncompleteError = exports.AbortError = exports.ErrorCode = exports.DynamoDbLangGraphError = exports.DynamoDBFactory = exports.DynamoDBSessionChatMessageHistory = exports.DynamoDBChatMessageHistory = exports.DynamoDBStore = exports.DynamoDBSaver = void 0;
+var saver_1 = require("./checkpointer/saver");
+Object.defineProperty(exports, "DynamoDBSaver", { enumerable: true, get: function () { return saver_1.DynamoDBSaver; } });
+var store_1 = require("./store/store");
 Object.defineProperty(exports, "DynamoDBStore", { enumerable: true, get: function () { return store_1.DynamoDBStore; } });
-var history_1 = require("./history");
-Object.defineProperty(exports, "DynamoDBChatMessageHistory", { enumerable: true, get: function () { return history_1.DynamoDBChatMessageHistory; } });
-Object.defineProperty(exports, "DynamoDBSessionChatMessageHistory", { enumerable: true, get: function () { return history_1.DynamoDBSessionChatMessageHistory; } });
-var factory_1 = require("./factory");
+var chat_message_history_1 = require("./history/chat-message-history");
+Object.defineProperty(exports, "DynamoDBChatMessageHistory", { enumerable: true, get: function () { return chat_message_history_1.DynamoDBChatMessageHistory; } });
+var session_adapter_1 = require("./history/session-adapter");
+Object.defineProperty(exports, "DynamoDBSessionChatMessageHistory", { enumerable: true, get: function () { return session_adapter_1.DynamoDBSessionChatMessageHistory; } });
+var factory_1 = require("./factory/factory");
 Object.defineProperty(exports, "DynamoDBFactory", { enumerable: true, get: function () { return factory_1.DynamoDBFactory; } });
-var logger_1 = require("./shared/utils/logger");
-Object.defineProperty(exports, "setGlobalLogger", { enumerable: true, get: function () { return logger_1.setGlobalLogger; } });
-Object.defineProperty(exports, "getLogger", { enumerable: true, get: function () { return logger_1.getLogger; } });
-Object.defineProperty(exports, "resetLogger", { enumerable: true, get: function () { return logger_1.resetLogger; } });
-Object.defineProperty(exports, "redactLogger", { enumerable: true, get: function () { return logger_1.redactLogger; } });
-Object.defineProperty(exports, "redactSecrets", { enumerable: true, get: function () { return logger_1.redactSecrets; } });
-var batch_write_1 = require("./shared/utils/batch-write");
-Object.defineProperty(exports, "BatchWriteIncompleteError", { enumerable: true, get: function () { return batch_write_1.BatchWriteIncompleteError; } });
+var base_error_1 = require("./shared/errors/base-error");
+Object.defineProperty(exports, "DynamoDbLangGraphError", { enumerable: true, get: function () { return base_error_1.DynamoDbLangGraphError; } });
+var error_code_1 = require("./shared/errors/error-code");
+Object.defineProperty(exports, "ErrorCode", { enumerable: true, get: function () { return error_code_1.ErrorCode; } });
+var errors_1 = require("./shared/errors/errors");
+Object.defineProperty(exports, "AbortError", { enumerable: true, get: function () { return errors_1.AbortError; } });
+Object.defineProperty(exports, "BatchWriteIncompleteError", { enumerable: true, get: function () { return errors_1.BatchWriteIncompleteError; } });
+Object.defineProperty(exports, "CompensationFailedError", { enumerable: true, get: function () { return errors_1.CompensationFailedError; } });
+Object.defineProperty(exports, "ConflictError", { enumerable: true, get: function () { return errors_1.ConflictError; } });
+Object.defineProperty(exports, "ResultTruncatedError", { enumerable: true, get: function () { return errors_1.ResultTruncatedError; } });
+Object.defineProperty(exports, "RetryExhaustedError", { enumerable: true, get: function () { return errors_1.RetryExhaustedError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
+var redaction_1 = require("./shared/logging/redaction");
+Object.defineProperty(exports, "redactLogger", { enumerable: true, get: function () { return redaction_1.redactLogger; } });
+Object.defineProperty(exports, "redactSecrets", { enumerable: true, get: function () { return redaction_1.redactSecrets; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+CAA+C;AAAtC,6GAAA,aAAa,OAAA;AAEtB,iCAAwC;AAA/B,sGAAA,aAAa,OAAA;AAEtB,qCAA0F;AAAjF,qHAAA,0BAA0B,OAAA;AAAE,4HAAA,iCAAiC,OAAA;AAEtE,qCAA4C;AAAnC,0GAAA,eAAe,OAAA;AACxB,gDAM+B;AAL7B,yGAAA,eAAe,OAAA;AACf,mGAAA,SAAS,OAAA;AACT,qGAAA,WAAW,OAAA;AACX,sGAAA,YAAY,OAAA;AACZ,uGAAA,aAAa,OAAA;AAOf,0DAAuE;AAA9D,wHAAA,yBAAyB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,8CAAqD;AAA5C,sGAAA,aAAa,OAAA;AAEtB,uCAA8C;AAArC,sGAAA,aAAa,OAAA;AAItB,uEAA4E;AAAnE,kIAAA,0BAA0B,OAAA;AACnC,6DAA8E;AAArE,oIAAA,iCAAiC,OAAA;AAE1C,6CAAoD;AAA3C,0GAAA,eAAe,OAAA;AAGxB,yDAAoE;AAA3D,oHAAA,sBAAsB,OAAA;AAE/B,yDAAuD;AAA9C,uGAAA,SAAS,OAAA;AAClB,iDAQgC;AAP9B,oGAAA,UAAU,OAAA;AACV,mHAAA,yBAAyB,OAAA;AACzB,iHAAA,uBAAuB,OAAA;AACvB,uGAAA,aAAa,OAAA;AACb,8GAAA,oBAAoB,OAAA;AACpB,6GAAA,mBAAmB,OAAA;AACnB,yGAAA,eAAe,OAAA;AAIjB,wDAAyE;AAAhE,yGAAA,YAAY,OAAA;AAAE,0GAAA,aAAa,OAAA"}

package/dist/shared/clock.d.ts

@@ -0,0 +1,3 @@
+/** Current time as an ISO-8601 string, derived from the (test-freezable) clock. */
+export declare function nowIso(): string;
+//# sourceMappingURL=clock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../src/shared/clock.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,wBAAgB,MAAM,IAAI,MAAM,CAE/B"}

package/dist/shared/clock.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nowIso = nowIso;
+/** Current time as an ISO-8601 string, derived from the (test-freezable) clock. */
+function nowIso() {
+    return new Date(Date.now()).toISOString();
+}
+//# sourceMappingURL=clock.js.map

package/dist/shared/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/shared/clock.ts"],"names":[],"mappings":";;AACA,wBAEC;AAHD,mFAAmF;AACnF,SAAgB,MAAM;IACpB,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAC5C,CAAC"}

package/dist/shared/codec/codec.d.ts

@@ -0,0 +1,44 @@
+import type { SerializerProtocol } from '@langchain/langgraph-checkpoint';
+import { CompressionConfig } from './compression';
+import type { S3Offloader } from './s3/offloader';
+/** Where an encoded payload lives. */
+export declare enum PayloadLocation {
+    INLINE = "INLINE",
+    S3 = "S3"
+}
+/** A payload stored inline as bytes in the DynamoDB item. */
+interface InlinePayloadDescriptor {
+    location: PayloadLocation.INLINE;
+    serdeType: string;
+    compressed: boolean;
+    bytes: Uint8Array;
+}
+/** A payload offloaded to S3, referenced by key. */
+interface S3PayloadDescriptor {
+    location: PayloadLocation.S3;
+    serdeType: string;
+    compressed: boolean;
+    s3Key: string;
+}
+/** The result of encoding a payload. */
+export type PayloadDescriptor = InlinePayloadDescriptor | S3PayloadDescriptor;
+/** Collaborators for the codec. */
+export interface CodecDeps {
+    serde: SerializerProtocol;
+    compression?: CompressionConfig;
+    offloader?: S3Offloader;
+}
+/** Options controlling where an offloaded payload's S3 key is built from. */
+export interface EncodeOptions {
+    keyParts: readonly string[];
+}
+/**
+ * Encode `value`: serialize via serde, compress (if configured), then offload
+ * to S3 when the compressed bytes exceed the offloader's threshold. Returns a
+ * descriptor recording how to read it back.
+ */
+export declare function encodePayload<T>(value: T, deps: CodecDeps, options: EncodeOptions): Promise<PayloadDescriptor>;
+/** Decode a {@link PayloadDescriptor} produced by {@link encodePayload}. */
+export declare function decodePayload<T>(descriptor: PayloadDescriptor, deps: CodecDeps): Promise<T>;
+export {};
+//# sourceMappingURL=codec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../../src/shared/codec/codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,OAAO,EAAE,iBAAiB,EAA2C,MAAM,eAAe,CAAC;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,sCAAsC;AACtC,oBAAY,eAAe;IACzB,MAAM,WAAW;IACjB,EAAE,OAAO;CACV;AAED,6DAA6D;AAC7D,UAAU,uBAAuB;IAC/B,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,oDAAoD;AACpD,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,eAAe,CAAC,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wCAAwC;AACxC,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GAAG,mBAAmB,CAAC;AAE9E,mCAAmC;AACnC,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,SAAS,CAAC,EAAE,WAAW,CAAC;CACzB;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AASD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAW5B;AAED,4EAA4E;AAC5E,wBAAsB,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAWjG"}