@farukada/aws-langgraph-dynamodb-ts 0.0.9 → 0.0.11

package/dist/factory.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * Factory for creating DynamoDB persistence instances with sensible defaults
+ * Provides convenient methods for instantiating checkpointer, store, and chat history
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamoDBFactory = void 0;
+const checkpointer_1 = require("./checkpointer");
+const store_1 = require("./store");
+const history_1 = require("./history");
+/**
+ * Default table names with standard prefix
+ */
+const DEFAULT_TABLE_PREFIX = 'langgraph';
+/**
+ * Factory class for creating DynamoDB persistence instances
+ */
+class DynamoDBFactory {
+    /**
+     * Create a DynamoDBSaver instance with sensible defaults
+     *
+     * @param options - Partial configuration options
+     * @param options.checkpointsTableName - Optional checkpoints table name (default: 'langgraph-checkpoints')
+     * @param options.writesTableName - Optional writes table name (default: 'langgraph-writes')
+     * @param options.ttlDays - Optional TTL in days for automatic cleanup
+     * @param options.serde - Optional custom serializer protocol
+     * @param options.clientConfig - Optional DynamoDB client configuration
+     * @returns Configured DynamoDBSaver instance
+     *
+     * @example
+     * ```TypeScript
+     * // Minimal configuration (uses defaults)
+     * const checkpointer = DynamoDBFactory.createSaver({
+     *   clientConfig: { region: 'us-east-1' }
+     * });
+     *
+     * // Custom table names and TTL
+     * const checkpointer = DynamoDBFactory.createSaver({
+     *   checkpointsTableName: 'my-checkpoints',
+     *   writesTableName: 'my-writes',
+     *   ttlDays: 30,
+     * });
+     * ```
+     */
+    static createSaver(options = {}) {
+        const config = {
+            checkpointsTableName: options.checkpointsTableName ?? `${DEFAULT_TABLE_PREFIX}-checkpoints`,
+            writesTableName: options.writesTableName ?? `${DEFAULT_TABLE_PREFIX}-writes`,
+            ttlDays: options.ttlDays,
+            serde: options.serde,
+            clientConfig: options.clientConfig,
+        };
+        return new checkpointer_1.DynamoDBSaver(config);
+    }
+    /**
+     * Create a DynamoDBStore instance with sensible defaults
+     *
+     * @param options - Partial configuration options
+     * @param options.memoryTableName - Optional memory table name (default: 'langgraph-memory')
+     * @param options.embedding - Optional Bedrock embeddings for semantic search
+     * @param options.ttlDays - Optional TTL in days for automatic cleanup
+     * @param options.clientConfig - Optional DynamoDB client configuration
+     * @returns Configured DynamoDBStore instance
+     *
+     * @example
+     * ```TypeScript
+     * // Without a semantic search
+     * const store = DynamoDBFactory.createStore({
+     *   clientConfig: { region: 'us-east-1' }
+     * });
+     *
+     * // With semantic search
+     * import { BedrockEmbeddings } from '@langchain/aws';
+     *
+     * const store = DynamoDBFactory.createStore({
+     *   embedding: new BedrockEmbeddings({
+     *     model: 'amazon.titan-embed-text-v1',
+     *   }),
+     *   ttlDays: 90,
+     * });
+     * ```
+     */
+    static createStore(options = {}) {
+        const config = {
+            memoryTableName: options.memoryTableName ?? `${DEFAULT_TABLE_PREFIX}-memory`,
+            embedding: options.embedding,
+            ttlDays: options.ttlDays,
+            clientConfig: options.clientConfig,
+        };
+        return new store_1.DynamoDBStore(config);
+    }
+    /**
+     * Create a DynamoDBChatMessageHistory instance with sensible defaults
+     *
+     * @param options - Partial configuration options
+     * @param options.tableName - Optional chat history table name (default: 'langgraph-chat-history')
+     * @param options.ttlDays - Optional TTL in days for automatic cleanup
+     * @param options.clientConfig - Optional DynamoDB client configuration
+     * @returns Configured DynamoDBChatMessageHistory instance
+     *
+     * @example
+     * ```TypeScript
+     * // Minimal configuration (uses defaults)
+     * const history = DynamoDBFactory.createChatMessageHistory({
+     *   clientConfig: { region: 'us-east-1' }
+     * });
+     *
+     * // Custom table name and TTL
+     * const history = DynamoDBFactory.createChatMessageHistory({
+     *   tableName: 'my-chat-history',
+     *   ttlDays: 365,
+     * });
+     * ```
+     */
+    static createChatMessageHistory(options = {}) {
+        const config = {
+            tableName: options.tableName ?? `${DEFAULT_TABLE_PREFIX}-chat-history`,
+            ttlDays: options.ttlDays,
+            clientConfig: options.clientConfig,
+        };
+        return new history_1.DynamoDBChatMessageHistory(config);
+    }
+    /**
+     * Create all DynamoDB persistence instances at once with a shared configuration
+     *
+     * @param options - Configuration options
+     * @param options.tablePrefix - Optional prefix for all table names (default: 'langgraph')
+     * @param options.ttlDays - Optional TTL in days for automatic cleanup (applies to all)
+     * @param options.clientConfig - Optional DynamoDB client configuration (shared)
+     * @param options.embedding - Optional Bedrock embeddings for semantic search in store
+     * @param options.serde - Optional custom serializer protocol for checkpointer
+     * @returns Object containing all three persistence instances
+     *
+     * @example
+     * ```TypeScript
+     * // Create all instances with shared configuration
+     * const { checkpointer, store, chatHistory } = DynamoDBFactory.createAll({
+     *   tablePrefix: 'my-app',
+     *   ttlDays: 30,
+     *   clientConfig: { region: 'us-east-1' },
+     * });
+     *
+     * // Use with LangGraph
+     * const app = workflow.compile({
+     *   checkpointer,
+     *   store,
+     * });
+     * ```
+     */
+    static createAll(options = {}) {
+        const prefix = options.tablePrefix ?? DEFAULT_TABLE_PREFIX;
+        return {
+            checkpointer: this.createSaver({
+                checkpointsTableName: `${prefix}-checkpoints`,
+                writesTableName: `${prefix}-writes`,
+                ttlDays: options.ttlDays,
+                serde: options.serde,
+                clientConfig: options.clientConfig,
+            }),
+            store: this.createStore({
+                memoryTableName: `${prefix}-memory`,
+                embedding: options.embedding,
+                ttlDays: options.ttlDays,
+                clientConfig: options.clientConfig,
+            }),
+            chatHistory: this.createChatMessageHistory({
+                tableName: `${prefix}-chat-history`,
+                ttlDays: options.ttlDays,
+                clientConfig: options.clientConfig,
+            }),
+        };
+    }
+}
+exports.DynamoDBFactory = DynamoDBFactory;
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAMH,iDAA+C;AAC/C,mCAAwC;AACxC,uCAAuD;AAKvD;;GAEG;AACH,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAa,eAAe;IAC1B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CAAC,WAAW,CAAC,UAAyC,EAAE;QAC5D,MAAM,MAAM,GAAyB;YACnC,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,GAAG,oBAAoB,cAAc;YAC3F,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,GAAG,oBAAoB,SAAS;YAC5E,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC;QAEF,OAAO,IAAI,4BAAa,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,WAAW,CAAC,UAAyC,EAAE;QAC5D,MAAM,MAAM,GAAyB;YACnC,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,GAAG,oBAAoB,SAAS;YAC5E,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC;QAEF,OAAO,IAAI,qBAAa,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,wBAAwB,CAC7B,UAAsD,EAAE;QAExD,MAAM,MAAM,GAAsC;YAChD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG,oBAAoB,eAAe;YACtE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC;QAEF,OAAO,IAAI,oCAA0B,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,SAAS,CACd,UAMI,EAAE;QAMN,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,IAAI,oBAAoB,CAAC;QAE3D,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC;gBAC7B,oBAAoB,EAAE,GAAG,MAAM,cAAc;gBAC7C,eAAe,EAAE,GAAG,MAAM,SAAS;gBACnC,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC;YACF,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC;gBACtB,eAAe,EAAE,GAAG,MAAM,SAAS;gBACnC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC;YACF,WAAW,EAAE,IAAI,CAAC,wBAAwB,CAAC;gBACzC,SAAS,EAAE,GAAG,MAAM,eAAe;gBACnC,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC;SACH,CAAC;IACJ,CAAC;CACF;AAhLD,0CAgLC"}

package/dist/history/actions/add-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-message.d.ts","sourceRoot":"","sources":["../../../src/history/actions/add-message.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAWvD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAU,QAAQ,sBAAsB,KAAG,OAAO,CAAC,IAAI,CAyDnF,CAAC"}
+{"version":3,"file":"add-message.d.ts","sourceRoot":"","sources":["../../../src/history/actions/add-message.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAYvD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAU,QAAQ,sBAAsB,KAAG,OAAO,CAAC,IAAI,CAkCnF,CAAC"}

package/dist/history/actions/add-message.js

@@ -20,33 +20,17 @@ const addMessageAction = async (params) => {
     (0, utils_1.validateMessage)(message);
     (0, utils_1.validateTitle)(title);
     (0, utils_1.validateTTLDays)(ttlDays);
-    const now = Date.now();
     // Generate a title if this is the first message and no title provided
     let sessionTitle = title;
     if (!sessionTitle) {
         sessionTitle = (0, utils_1.generateTitle)(message);
     }
-    // Build update expression
-    const updateExpressionParts = ['updatedAt = :updatedAt'];
-    const expressionAttributeValues = {
-        ':updatedAt': now,
-        ':createdAt': now,
-        ':emptyList': [],
-        ':one': 1,
-        ':message': [message],
-    };
-    if (sessionTitle) {
-        updateExpressionParts.push('title = if_not_exists(title, :title)');
-        expressionAttributeValues[':title'] = sessionTitle;
-    }
-    updateExpressionParts.push('messages = list_append(if_not_exists(messages, :emptyList), :message)');
-    updateExpressionParts.push('messageCount = if_not_exists(messageCount, :zero) + :one');
-    expressionAttributeValues[':zero'] = 0;
-    // Add TTL if configured
-    if (ttlDays !== undefined) {
-        updateExpressionParts.push('ttl = :ttl');
-        expressionAttributeValues[':ttl'] = Math.floor(Date.now() / 1000) + ttlDays * 24 * 60 * 60;
-    }
+    // Build update expression using utility
+    const { updateExpression, expressionAttributeValues } = (0, utils_1.buildMessageUpdateExpression)({
+        messages: message,
+        title: sessionTitle,
+        ttlDays,
+    });
     // Execute with retry logic
     await (0, utils_1.withDynamoDBRetry)(async () => {
         await client.update({
@@ -55,7 +39,7 @@ const addMessageAction = async (params) => {
                 userId,
                 sessionId,
             },
-            UpdateExpression: `SET ${updateExpressionParts.join(', ')}, createdAt = if_not_exists(createdAt, :createdAt)`,
+            UpdateExpression: updateExpression,
             ExpressionAttributeValues: expressionAttributeValues,
         });
     });

package/dist/history/actions/add-message.js.map

@@ -1 +1 @@
-{"version":3,"file":"add-message.js","sourceRoot":"","sources":["../../../src/history/actions/add-message.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,oCAQkB;AAElB;;;;;;GAMG;AACI,MAAM,gBAAgB,GAAG,KAAK,EAAE,MAA8B,EAAiB,EAAE;IACtF,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAEjF,kBAAkB;IAClB,IAAA,sBAAc,EAAC,MAAM,CAAC,CAAC;IACvB,IAAA,yBAAiB,EAAC,SAAS,CAAC,CAAC;IAC7B,IAAA,uBAAe,EAAC,OAAO,CAAC,CAAC;IACzB,IAAA,qBAAa,EAAC,KAAK,CAAC,CAAC;IACrB,IAAA,uBAAe,EAAC,OAAO,CAAC,CAAC;IAEzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,sEAAsE;IACtE,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,IAAA,qBAAa,EAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,0BAA0B;IAC1B,MAAM,qBAAqB,GAAa,CAAC,wBAAwB,CAAC,CAAC;IACnE,MAAM,yBAAyB,GAAwB;QACrD,YAAY,EAAE,GAAG;QACjB,YAAY,EAAE,GAAG;QACjB,YAAY,EAAE,EAAE;QAChB,MAAM,EAAE,CAAC;QACT,UAAU,EAAE,CAAC,OAAO,CAAC;KACtB,CAAC;IAEF,IAAI,YAAY,EAAE,CAAC;QACjB,qBAAqB,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACnE,yBAAyB,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC;IACrD,CAAC;IAED,qBAAqB,CAAC,IAAI,CACxB,uEAAuE,CACxE,CAAC;IACF,qBAAqB,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;IACvF,yBAAyB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEvC,wBAAwB;IACxB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzC,yBAAyB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAC7F,CAAC;IAED,2BAA2B;IAC3B,MAAM,IAAA,yBAAiB,EAAC,KAAK,IAAI,EAAE;QACjC,MAAM,MAAM,CAAC,MAAM,CAAC;YAClB,SAAS,EAAE,SAAS;YACpB,GAAG,EAAE;gBACH,MAAM;gBACN,SAAS;aACV;YACD,gBAAgB,EAAE,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,oDAAoD;YAC7G,yBAAyB,EAAE,yBAAyB;SACrD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAzDW,QAAA,gBAAgB,oBAyD3B"}
+{"version":3,"file":"add-message.js","sourceRoot":"","sources":["../../../src/history/actions/add-message.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,oCASkB;AAElB;;;;;;GAMG;AACI,MAAM,gBAAgB,GAAG,KAAK,EAAE,MAA8B,EAAiB,EAAE;IACtF,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAEjF,kBAAkB;IAClB,IAAA,sBAAc,EAAC,MAAM,CAAC,CAAC;IACvB,IAAA,yBAAiB,EAAC,SAAS,CAAC,CAAC;IAC7B,IAAA,uBAAe,EAAC,OAAO,CAAC,CAAC;IACzB,IAAA,qBAAa,EAAC,KAAK,CAAC,CAAC;IACrB,IAAA,uBAAe,EAAC,OAAO,CAAC,CAAC;IAEzB,sEAAsE;IACtE,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,IAAA,qBAAa,EAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,wCAAwC;IACxC,MAAM,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,GAAG,IAAA,oCAA4B,EAAC;QACnF,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,YAAY;QACnB,OAAO;KACR,CAAC,CAAC;IAEH,2BAA2B;IAC3B,MAAM,IAAA,yBAAiB,EAAC,KAAK,IAAI,EAAE;QACjC,MAAM,MAAM,CAAC,MAAM,CAAC;YAClB,SAAS,EAAE,SAAS;YACpB,GAAG,EAAE;gBACH,MAAM;gBACN,SAAS;aACV;YACD,gBAAgB,EAAE,gBAAgB;YAClC,yBAAyB,EAAE,yBAAyB;SACrD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAlCW,QAAA,gBAAgB,oBAkC3B"}

package/dist/history/actions/add-messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-messages.d.ts","sourceRoot":"","sources":["../../../src/history/actions/add-messages.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAWxD;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAU,QAAQ,uBAAuB,KAAG,OAAO,CAAC,IAAI,CAyDrF,CAAC"}
+{"version":3,"file":"add-messages.d.ts","sourceRoot":"","sources":["../../../src/history/actions/add-messages.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAYxD;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAU,QAAQ,uBAAuB,KAAG,OAAO,CAAC,IAAI,CAkCrF,CAAC"}

package/dist/history/actions/add-messages.js

@@ -21,33 +21,17 @@ const addMessagesAction = async (params) => {
     (0, utils_1.validateMessages)(messages);
     (0, utils_1.validateTitle)(title);
     (0, utils_1.validateTTLDays)(ttlDays);
-    const now = Date.now();
     // Generate a title if this is the first message batch and no title provided
     let sessionTitle = title;
     if (!sessionTitle) {
         sessionTitle = (0, utils_1.generateTitle)(messages[0]);
     }
-    // Build update expression
-    const updateExpressionParts = ['updatedAt = :updatedAt'];
-    const expressionAttributeValues = {
-        ':updatedAt': now,
-        ':createdAt': now,
-        ':emptyList': [],
-        ':messageCount': messages.length,
-        ':messages': messages,
-    };
-    if (sessionTitle) {
-        updateExpressionParts.push('title = if_not_exists(title, :title)');
-        expressionAttributeValues[':title'] = sessionTitle;
-    }
-    updateExpressionParts.push('messages = list_append(if_not_exists(messages, :emptyList), :messages)');
-    updateExpressionParts.push('messageCount = if_not_exists(messageCount, :zero) + :messageCount');
-    expressionAttributeValues[':zero'] = 0;
-    // Add TTL if configured
-    if (ttlDays !== undefined) {
-        updateExpressionParts.push('ttl = :ttl');
-        expressionAttributeValues[':ttl'] = Math.floor(Date.now() / 1000) + ttlDays * 24 * 60 * 60;
-    }
+    // Build update expression using utility
+    const { updateExpression, expressionAttributeValues } = (0, utils_1.buildMessageUpdateExpression)({
+        messages,
+        title: sessionTitle,
+        ttlDays,
+    });
     // Execute with retry logic
     await (0, utils_1.withDynamoDBRetry)(async () => {
         await client.update({
@@ -56,7 +40,7 @@ const addMessagesAction = async (params) => {
                 userId,
                 sessionId,
             },
-            UpdateExpression: `SET ${updateExpressionParts.join(', ')}, createdAt = if_not_exists(createdAt, :createdAt)`,
+            UpdateExpression: updateExpression,
             ExpressionAttributeValues: expressionAttributeValues,
         });
     });

package/dist/history/actions/add-messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"add-messages.js","sourceRoot":"","sources":["../../../src/history/actions/add-messages.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,oCAQkB;AAElB;;;;;;;GAOG;AACI,MAAM,iBAAiB,GAAG,KAAK,EAAE,MAA+B,EAAiB,EAAE;IACxF,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAElF,kBAAkB;IAClB,IAAA,sBAAc,EAAC,MAAM,CAAC,CAAC;IACvB,IAAA,yBAAiB,EAAC,SAAS,CAAC,CAAC;IAC7B,IAAA,wBAAgB,EAAC,QAAQ,CAAC,CAAC;IAC3B,IAAA,qBAAa,EAAC,KAAK,CAAC,CAAC;IACrB,IAAA,uBAAe,EAAC,OAAO,CAAC,CAAC;IAEzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,4EAA4E;IAC5E,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,IAAA,qBAAa,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,0BAA0B;IAC1B,MAAM,qBAAqB,GAAa,CAAC,wBAAwB,CAAC,CAAC;IACnE,MAAM,yBAAyB,GAAwB;QACrD,YAAY,EAAE,GAAG;QACjB,YAAY,EAAE,GAAG;QACjB,YAAY,EAAE,EAAE;QAChB,eAAe,EAAE,QAAQ,CAAC,MAAM;QAChC,WAAW,EAAE,QAAQ;KACtB,CAAC;IAEF,IAAI,YAAY,EAAE,CAAC;QACjB,qBAAqB,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACnE,yBAAyB,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC;IACrD,CAAC;IAED,qBAAqB,CAAC,IAAI,CACxB,wEAAwE,CACzE,CAAC;IACF,qBAAqB,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;IAChG,yBAAyB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEvC,wBAAwB;IACxB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzC,yBAAyB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAC7F,CAAC;IAED,2BAA2B;IAC3B,MAAM,IAAA,yBAAiB,EAAC,KAAK,IAAI,EAAE;QACjC,MAAM,MAAM,CAAC,MAAM,CAAC;YAClB,SAAS,EAAE,SAAS;YACpB,GAAG,EAAE;gBACH,MAAM;gBACN,SAAS;aACV;YACD,gBAAgB,EAAE,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,oDAAoD;YAC7G,yBAAyB,EAAE,yBAAyB;SACrD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAzDW,QAAA,iBAAiB,qBAyD5B"}
+{"version":3,"file":"add-messages.js","sourceRoot":"","sources":["../../../src/history/actions/add-messages.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,oCASkB;AAElB;;;;;;;GAOG;AACI,MAAM,iBAAiB,GAAG,KAAK,EAAE,MAA+B,EAAiB,EAAE;IACxF,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAElF,kBAAkB;IAClB,IAAA,sBAAc,EAAC,MAAM,CAAC,CAAC;IACvB,IAAA,yBAAiB,EAAC,SAAS,CAAC,CAAC;IAC7B,IAAA,wBAAgB,EAAC,QAAQ,CAAC,CAAC;IAC3B,IAAA,qBAAa,EAAC,KAAK,CAAC,CAAC;IACrB,IAAA,uBAAe,EAAC,OAAO,CAAC,CAAC;IAEzB,4EAA4E;IAC5E,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,IAAA,qBAAa,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,wCAAwC;IACxC,MAAM,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,GAAG,IAAA,oCAA4B,EAAC;QACnF,QAAQ;QACR,KAAK,EAAE,YAAY;QACnB,OAAO;KACR,CAAC,CAAC;IAEH,2BAA2B;IAC3B,MAAM,IAAA,yBAAiB,EAAC,KAAK,IAAI,EAAE;QACjC,MAAM,MAAM,CAAC,MAAM,CAAC;YAClB,SAAS,EAAE,SAAS;YACpB,GAAG,EAAE;gBACH,MAAM;gBACN,SAAS;aACV;YACD,gBAAgB,EAAE,gBAAgB;YAClC,yBAAyB,EAAE,yBAAyB;SACrD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAlCW,QAAA,iBAAiB,qBAkC5B"}

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

@@ -3,5 +3,6 @@
  */
 export * from './validation';
 export * from './title-generator';
+export * from './update-expression-builder';
 export { withDynamoDBRetry } from '../../shared/utils';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/history/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/history/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/history/utils/index.js

@@ -20,6 +20,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.withDynamoDBRetry = void 0;
 __exportStar(require("./validation"), exports);
 __exportStar(require("./title-generator"), exports);
+__exportStar(require("./update-expression-builder"), exports);
 var utils_1 = require("../../shared/utils");
 Object.defineProperty(exports, "withDynamoDBRetry", { enumerable: true, get: function () { return utils_1.withDynamoDBRetry; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/history/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,oDAAkC;AAClC,4CAAuD;AAA9C,0GAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/history/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,oDAAkC;AAClC,8DAA4C;AAC5C,4CAAuD;AAA9C,0GAAA,iBAAiB,OAAA"}

package/dist/history/utils/update-expression-builder.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Update expression builder for chat message history
+ * Provides centralized logic for building DynamoDB update expressions
+ */
+import type { BaseMessage } from '@langchain/core/messages';
+/**
+ * Parameters for building message update expression
+ */
+export interface BuildMessageUpdateExpressionParams {
+    /** Single message or array of messages to add */
+    messages: BaseMessage | BaseMessage[];
+    /** Optional session title */
+    title?: string;
+    /** Optional TTL in days */
+    ttlDays?: number;
+}
+/**
+ * Result of building update expression
+ */
+export interface UpdateExpressionResult {
+    /** DynamoDB UpdateExpression string */
+    updateExpression: string;
+    /** Expression attribute values */
+    expressionAttributeValues: Record<string, any>;
+}
+/**
+ * Build DynamoDB update expression for adding messages to a session
+ * Handles both single messages and message arrays
+ *
+ * @param params - Parameters for building the expression
+ * @returns Update expression and attribute values
+ */
+export declare function buildMessageUpdateExpression(params: BuildMessageUpdateExpressionParams): UpdateExpressionResult;
+//# sourceMappingURL=update-expression-builder.d.ts.map

package/dist/history/utils/update-expression-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-expression-builder.d.ts","sourceRoot":"","sources":["../../../src/history/utils/update-expression-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAI5D;;GAEG;AACH,MAAM,WAAW,kCAAkC;IACjD,iDAAiD;IACjD,QAAQ,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IACtC,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,kCAAkC;IAClC,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChD;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,kCAAkC,GACzC,sBAAsB,CAqDxB"}

package/dist/history/utils/update-expression-builder.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Update expression builder for chat message history
+ * Provides centralized logic for building DynamoDB update expressions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMessageUpdateExpression = buildMessageUpdateExpression;
+const shared_1 = require("../../shared");
+/**
+ * Build DynamoDB update expression for adding messages to a session
+ * Handles both single messages and message arrays
+ *
+ * @param params - Parameters for building the expression
+ * @returns Update expression and attribute values
+ */
+function buildMessageUpdateExpression(params) {
+    const { messages, title, ttlDays } = params;
+    const now = Date.now();
+    const isArray = Array.isArray(messages);
+    const messageArray = isArray ? messages : [messages];
+    const messageCount = messageArray.length;
+    // Build update expression parts
+    const updateExpressionParts = ['updatedAt = :updatedAt'];
+    const expressionAttributeValues = {
+        ':updatedAt': now,
+        ':createdAt': now,
+        ':emptyList': [],
+        ':zero': 0,
+    };
+    // Add title if provided
+    if (title) {
+        updateExpressionParts.push('title = if_not_exists(title, :title)');
+        expressionAttributeValues[':title'] = title;
+    }
+    // Add messages
+    if (isArray) {
+        updateExpressionParts.push('messages = list_append(if_not_exists(messages, :emptyList), :messages)');
+        updateExpressionParts.push('messageCount = if_not_exists(messageCount, :zero) + :messageCount');
+        expressionAttributeValues[':messages'] = messageArray;
+        expressionAttributeValues[':messageCount'] = messageCount;
+    }
+    else {
+        updateExpressionParts.push('messages = list_append(if_not_exists(messages, :emptyList), :message)');
+        updateExpressionParts.push('messageCount = if_not_exists(messageCount, :zero) + :one');
+        expressionAttributeValues[':message'] = messageArray;
+        expressionAttributeValues[':one'] = 1;
+    }
+    // Add TTL if configured
+    if (ttlDays !== undefined) {
+        updateExpressionParts.push('ttl = :ttl');
+        expressionAttributeValues[':ttl'] = (0, shared_1.calculateTTLTimestamp)(ttlDays);
+    }
+    // Build final update expression
+    const updateExpression = `SET ${updateExpressionParts.join(', ')}, createdAt = if_not_exists(createdAt, :createdAt)`;
+    return {
+        updateExpression,
+        expressionAttributeValues,
+    };
+}
+//# sourceMappingURL=update-expression-builder.js.map

package/dist/history/utils/update-expression-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-expression-builder.js","sourceRoot":"","sources":["../../../src/history/utils/update-expression-builder.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAmCH,oEAuDC;AAtFD,yCAAqD;AAwBrD;;;;;;GAMG;AACH,SAAgB,4BAA4B,CAC1C,MAA0C;IAE1C,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC;IAEzC,gCAAgC;IAChC,MAAM,qBAAqB,GAAa,CAAC,wBAAwB,CAAC,CAAC;IACnE,MAAM,yBAAyB,GAAwB;QACrD,YAAY,EAAE,GAAG;QACjB,YAAY,EAAE,GAAG;QACjB,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,CAAC;KACX,CAAC;IAEF,wBAAwB;IACxB,IAAI,KAAK,EAAE,CAAC;QACV,qBAAqB,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACnE,yBAAyB,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IAC9C,CAAC;IAED,eAAe;IACf,IAAI,OAAO,EAAE,CAAC;QACZ,qBAAqB,CAAC,IAAI,CACxB,wEAAwE,CACzE,CAAC;QACF,qBAAqB,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;QAChG,yBAAyB,CAAC,WAAW,CAAC,GAAG,YAAY,CAAC;QACtD,yBAAyB,CAAC,eAAe,CAAC,GAAG,YAAY,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,qBAAqB,CAAC,IAAI,CACxB,uEAAuE,CACxE,CAAC;QACF,qBAAqB,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;QACvF,yBAAyB,CAAC,UAAU,CAAC,GAAG,YAAY,CAAC;QACrD,yBAAyB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,wBAAwB;IACxB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzC,yBAAyB,CAAC,MAAM,CAAC,GAAG,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IACrE,CAAC;IAED,gCAAgC;IAChC,MAAM,gBAAgB,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,oDAAoD,CAAC;IAErH,OAAO;QACL,gBAAgB;QAChB,yBAAyB;KAC1B,CAAC;AACJ,CAAC"}

package/dist/history/utils/validation.d.ts

@@ -14,14 +14,14 @@ export declare class HistoryValidationError extends Error {
  * @param userId - User identifier to validate
  * @throws HistoryValidationError if validation fails
  */
-export declare function validateUserId(userId: string): void;
+export declare function validateUserId(userId: any): void;
 /**
  * Validate session ID
  *
  * @param sessionId - Session identifier to validate
  * @throws HistoryValidationError if validation fails
  */
-export declare function validateSessionId(sessionId: string): void;
+export declare function validateSessionId(sessionId: any): void;
 /**
  * Validate a single message
  *
@@ -42,14 +42,14 @@ export declare function validateMessages(messages: BaseMessage[]): void;
  * @param title - Optional title string to validate
  * @throws HistoryValidationError if validation fails
  */
-export declare function validateTitle(title: string | undefined): void;
+export declare function validateTitle(title: any): void;
 /**
  * Validate list limit parameter
  *
  * @param limit - Optional maximum number of items to return
  * @throws HistoryValidationError if validation fails
  */
-export declare function validateLimit(limit: number | undefined): void;
+export declare function validateLimit(limit: any): void;
 /**
  * Validate TTL days (wraps shared validation with a history-specific error type)
  *

package/dist/history/utils/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/history/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAUvD;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAoBnD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAoBzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAa1D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAyB9D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAc7D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAgB7D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAOjE"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/history/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAUvD;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAoBhD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,CAoBtD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAa1D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAyB9D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CAc9C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CAgB9C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAOjE"}

package/dist/history/utils/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/history/utils/validation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/history/utils/validation.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -4,4 +4,5 @@ export { DynamoDBStore } from './store';
 export type { DynamoDBStoreOptions } from './store/types';
 export { DynamoDBChatMessageHistory } from './history';
 export type { DynamoDBChatMessageHistoryOptions, SessionMetadata } from './history/types';
+export { DynamoDBFactory } from './factory';
 //# 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,MAAM,WAAW,CAAC;AACvD,YAAY,EAAE,iCAAiC,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}
+{"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,MAAM,WAAW,CAAC;AACvD,YAAY,EAAE,iCAAiC,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DynamoDBChatMessageHistory = exports.DynamoDBStore = exports.DynamoDBSaver = void 0;
+exports.DynamoDBFactory = 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");
 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; } });
+var factory_1 = require("./factory");
+Object.defineProperty(exports, "DynamoDBFactory", { enumerable: true, get: function () { return factory_1.DynamoDBFactory; } });
 //# 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,qCAAuD;AAA9C,qHAAA,0BAA0B,OAAA"}
+{"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,qCAAuD;AAA9C,qHAAA,0BAA0B,OAAA;AAEnC,qCAA4C;AAAnC,0GAAA,eAAe,OAAA"}

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

@@ -1,6 +1,7 @@
 /**
- * Shared utilities for store and checkpointer
+ * Shared utilities and types
  */
-export * from './retry';
 export * from './constants';
+export * from './retry';
+export * from './ttl';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC"}

package/dist/shared/utils/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Shared utilities for store and checkpointer
+ * Shared utilities and types
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -17,6 +17,7 @@ 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("./retry"), exports);
 __exportStar(require("./constants"), exports);
+__exportStar(require("./retry"), exports);
+__exportStar(require("./ttl"), exports);
 //# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * TTL (Time-To-Live) utility functions
+ * Provide centralized TTL calculation for DynamoDB items
+ */
+/**
+ * Calculate Unix timestamp for TTL expiration
+ *
+ * @param ttlDays - Number of days until expiration
+ * @returns Unix timestamp in seconds for DynamoDB TTL attribute
+ * @throws Error if ttlDays would cause overflow
+ */
+export declare function calculateTTLTimestamp(ttlDays: number): number;
+//# sourceMappingURL=ttl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/ttl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAU7D"}

package/dist/shared/utils/ttl.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * TTL (Time-To-Live) utility functions
+ * Provide centralized TTL calculation for DynamoDB items
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateTTLTimestamp = calculateTTLTimestamp;
+/**
+ * Calculate Unix timestamp for TTL expiration
+ *
+ * @param ttlDays - Number of days until expiration
+ * @returns Unix timestamp in seconds for DynamoDB TTL attribute
+ * @throws Error if ttlDays would cause overflow
+ */
+function calculateTTLTimestamp(ttlDays) {
+    const ttlSeconds = ttlDays * 24 * 60 * 60;
+    const timestamp = Math.floor(Date.now() / 1000) + ttlSeconds;
+    // Sanity check: ensure we don't overflow Unix timestamp
+    if (timestamp > 2147483647) {
+        throw new Error('TTL would overflow Unix timestamp (max date: 2038-01-19)');
+    }
+    return timestamp;
+}
+//# sourceMappingURL=ttl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.js","sourceRoot":"","sources":["../../../src/shared/utils/ttl.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AASH,sDAUC;AAjBD;;;;;;GAMG;AACH,SAAgB,qBAAqB,CAAC,OAAe;IACnD,MAAM,UAAU,GAAG,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,UAAU,CAAC;IAE7D,wDAAwD;IACxD,IAAI,SAAS,GAAG,UAAU,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/store/actions/put-operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"put-operation.d.ts","sourceRoot":"","sources":["../../../src/store/actions/put-operation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAYpD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAU,QAAQ,wBAAwB,KAAG,OAAO,CAAC,IAAI,CAsFvF,CAAC"}
+{"version":3,"file":"put-operation.d.ts","sourceRoot":"","sources":["../../../src/store/actions/put-operation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAapD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAU,QAAQ,wBAAwB,KAAG,OAAO,CAAC,IAAI,CAqFvF,CAAC"}