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

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

@@ -1,9 +0,0 @@
-/**
- * Action functions for chat message history operations
- */
-export { getMessagesAction } from './get-messages';
-export { addMessageAction } from './add-message';
-export { addMessagesAction } from './add-messages';
-export { clearAction } from './clear';
-export { listSessionsAction } from './list-sessions';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/history/actions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/history/actions/index.js

@@ -1,17 +0,0 @@
-"use strict";
-/**
- * Action functions for chat message history operations
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.listSessionsAction = exports.clearAction = exports.addMessagesAction = exports.addMessageAction = exports.getMessagesAction = void 0;
-var get_messages_1 = require("./get-messages");
-Object.defineProperty(exports, "getMessagesAction", { enumerable: true, get: function () { return get_messages_1.getMessagesAction; } });
-var add_message_1 = require("./add-message");
-Object.defineProperty(exports, "addMessageAction", { enumerable: true, get: function () { return add_message_1.addMessageAction; } });
-var add_messages_1 = require("./add-messages");
-Object.defineProperty(exports, "addMessagesAction", { enumerable: true, get: function () { return add_messages_1.addMessagesAction; } });
-var clear_1 = require("./clear");
-Object.defineProperty(exports, "clearAction", { enumerable: true, get: function () { return clear_1.clearAction; } });
-var list_sessions_1 = require("./list-sessions");
-Object.defineProperty(exports, "listSessionsAction", { enumerable: true, get: function () { return list_sessions_1.listSessionsAction; } });
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/history/actions/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,+CAAmD;AAA1C,iHAAA,iBAAiB,OAAA;AAC1B,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA;AACzB,+CAAmD;AAA1C,iHAAA,iBAAiB,OAAA;AAC1B,iCAAsC;AAA7B,oGAAA,WAAW,OAAA;AACpB,iDAAqD;AAA5C,mHAAA,kBAAkB,OAAA"}

package/dist/history/index.d.ts

@@ -1,118 +0,0 @@
-/**
- * DynamoDB-based chat message history implementation for LangChain
- * Provides persistent storage for chat messages with automatic title generation
- */
-import { BaseMessage } from '@langchain/core/messages';
-import { DynamoDBSessionChatMessageHistory } from './session-adapter';
-import type { DynamoDBChatMessageHistoryOptions, SessionMetadata } from './types';
-/**
- * DynamoDB-backed chat message history with per-message-item storage.
- *
- * @remarks
- * Each session is capped at ~999 999 messages by the 6-digit message-index
- * sort-key padding. Sessions approaching this bound should be sharded by the
- * caller; see `formatMessageIndex` for details.
- */
-export declare class DynamoDBChatMessageHistory {
-    private readonly ddbClient;
-    private readonly client;
-    private readonly tableName;
-    private readonly ttlDays?;
-    private readonly ownsClient;
-    /**
-     * Create a new DynamoDB chat message history instance
-     *
-     * @param options - Configuration options for the chat message history
-     * @param options.tableName - Name of the DynamoDB table to use
-     * @param options.ttlDays - Optional TTL in days for automatic cleanup (1-1825 days)
-     * @param options.clientConfig - Optional DynamoDB client configuration
-     * @param options.client - Optional pre-built DynamoDBDocument client (takes precedence over clientConfig)
-     */
-    constructor(options: DynamoDBChatMessageHistoryOptions);
-    /**
-     * Release underlying DynamoDB client resources.
-     * Call this when the history is no longer needed to prevent resource leaks.
-     * Skips cleanup if a shared client was injected via options.
-     */
-    destroy(): void;
-    /**
-     * Get all messages for a session
-     * Messages are returned in chronological order
-     *
-     * @param userId - User identifier
-     * @param sessionId - Session identifier
-     * @returns Array of BaseMessage objects in chronological order
-     * @throws Error if the operation fails or validation fails
-     */
-    getMessages(userId: string, sessionId: string, options?: {
-        signal?: AbortSignal;
-    }): Promise<BaseMessage[]>;
-    /**
-     * Add a single message to a session
-     * Generates title from the first message if this is a new session
-     *
-     * @param userId - User identifier
-     * @param sessionId - Session identifier
-     * @param message - The BaseMessage to add to the session
-     * @param title - Optional session title (auto-generated from the first message if not provided)
-     * @throws Error if the operation fails or validation fails
-     */
-    addMessage(userId: string, sessionId: string, message: BaseMessage, title?: string, options?: {
-        signal?: AbortSignal;
-    }): Promise<void>;
-    /**
-     * Add multiple messages to a session
-     * Generates title from the first message if this is a new session
-     * Preferred over calling addMessage multiple times for performance
-     *
-     * @param userId - User identifier
-     * @param sessionId - Session identifier
-     * @param messages - Array of BaseMessage objects to add
-     * @param title - Optional session title (auto-generated from the first message if not provided)
-     * @throws Error if the operation fails or validation fails
-     */
-    addMessages(userId: string, sessionId: string, messages: BaseMessage[], title?: string, options?: {
-        signal?: AbortSignal;
-    }): Promise<void>;
-    /**
-     * Clear all messages in a session
-     * Deletes the session item from DynamoDB
-     *
-     * @param userId - User identifier
-     * @param sessionId - Session identifier
-     * @throws Error if the operation fails or validation fails
-     */
-    clear(userId: string, sessionId: string, options?: {
-        signal?: AbortSignal;
-    }): Promise<void>;
-    /**
-     * List all sessions for a user, sorted by most recent
-     * Returns metadata only (excludes messages for performance)
-     *
-     * @param userId - User ID to list sessions for
-     * @param limit - Optional maximum number of sessions to return (default: no limit)
-     * @returns Array of session metadata, sorted by most recent first
-     * @throws Error if the operation fails or validation fails
-     */
-    listSessions(userId: string, limit?: number, options?: {
-        signal?: AbortSignal;
-    }): Promise<SessionMetadata[]>;
-    /**
-     * Bind this store to a single `(userId, sessionId)` pair and return a
-     * `BaseListChatMessageHistory` compatible instance — the shape LangChain's
-     * `RunnableWithMessageHistory` expects from `getMessageHistory(sessionId)`.
-     *
-     * @example
-     * ```ts
-     * const store = new DynamoDBChatMessageHistory({ tableName });
-     * new RunnableWithMessageHistory({
-     *   runnable,
-     *   getMessageHistory: (sessionId) => store.forSession(userId, sessionId),
-     *   // ...
-     * });
-     * ```
-     */
-    forSession(userId: string, sessionId: string): DynamoDBSessionChatMessageHistory;
-}
-export { DynamoDBSessionChatMessageHistory } from './session-adapter';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAUvD,OAAO,EAAE,iCAAiC,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,iCAAiC,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAElF;;;;;;;GAOG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IAErC;;;;;;;;OAQG;gBACS,OAAO,EAAE,iCAAiC;IAUtD;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAMf;;;;;;;;OAQG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACrC,OAAO,CAAC,WAAW,EAAE,CAAC;IAUzB;;;;;;;;;OASG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACrC,OAAO,CAAC,IAAI,CAAC;IAahB;;;;;;;;;;OAUG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACrC,OAAO,CAAC,IAAI,CAAC;IAahB;;;;;;;OAOG;IACG,KAAK,CACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACrC,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;;;;;OAQG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACrC,OAAO,CAAC,eAAe,EAAE,CAAC;IAU7B;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iCAAiC;CASjF;AAED,OAAO,EAAE,iCAAiC,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/history/index.js

@@ -1,179 +0,0 @@
-"use strict";
-/**
- * DynamoDB-based chat message history implementation for LangChain
- * Provides persistent storage for chat messages with automatic title generation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DynamoDBSessionChatMessageHistory = exports.DynamoDBChatMessageHistory = void 0;
-const shared_1 = require("../shared");
-const actions_1 = require("./actions");
-const session_adapter_1 = require("./session-adapter");
-/**
- * DynamoDB-backed chat message history with per-message-item storage.
- *
- * @remarks
- * Each session is capped at ~999 999 messages by the 6-digit message-index
- * sort-key padding. Sessions approaching this bound should be sharded by the
- * caller; see `formatMessageIndex` for details.
- */
-class DynamoDBChatMessageHistory {
-    ddbClient;
-    client;
-    tableName;
-    ttlDays;
-    ownsClient;
-    /**
-     * Create a new DynamoDB chat message history instance
-     *
-     * @param options - Configuration options for the chat message history
-     * @param options.tableName - Name of the DynamoDB table to use
-     * @param options.ttlDays - Optional TTL in days for automatic cleanup (1-1825 days)
-     * @param options.clientConfig - Optional DynamoDB client configuration
-     * @param options.client - Optional pre-built DynamoDBDocument client (takes precedence over clientConfig)
-     */
-    constructor(options) {
-        ({
-            ddbClient: this.ddbClient,
-            client: this.client,
-            ownsClient: this.ownsClient,
-        } = (0, shared_1.resolveDynamoDBClient)(options));
-        this.tableName = options.tableName;
-        this.ttlDays = options.ttlDays;
-    }
-    /**
-     * Release underlying DynamoDB client resources.
-     * Call this when the history is no longer needed to prevent resource leaks.
-     * Skips cleanup if a shared client was injected via options.
-     */
-    destroy() {
-        if (this.ownsClient && this.ddbClient) {
-            this.ddbClient.destroy();
-        }
-    }
-    /**
-     * Get all messages for a session
-     * Messages are returned in chronological order
-     *
-     * @param userId - User identifier
-     * @param sessionId - Session identifier
-     * @returns Array of BaseMessage objects in chronological order
-     * @throws Error if the operation fails or validation fails
-     */
-    async getMessages(userId, sessionId, options = {}) {
-        return await (0, actions_1.getMessagesAction)({
-            client: this.client,
-            tableName: this.tableName,
-            userId,
-            sessionId,
-            signal: options.signal,
-        });
-    }
-    /**
-     * Add a single message to a session
-     * Generates title from the first message if this is a new session
-     *
-     * @param userId - User identifier
-     * @param sessionId - Session identifier
-     * @param message - The BaseMessage to add to the session
-     * @param title - Optional session title (auto-generated from the first message if not provided)
-     * @throws Error if the operation fails or validation fails
-     */
-    async addMessage(userId, sessionId, message, title, options = {}) {
-        await (0, actions_1.addMessageAction)({
-            client: this.client,
-            tableName: this.tableName,
-            userId,
-            sessionId,
-            message,
-            title,
-            ttlDays: this.ttlDays,
-            signal: options.signal,
-        });
-    }
-    /**
-     * Add multiple messages to a session
-     * Generates title from the first message if this is a new session
-     * Preferred over calling addMessage multiple times for performance
-     *
-     * @param userId - User identifier
-     * @param sessionId - Session identifier
-     * @param messages - Array of BaseMessage objects to add
-     * @param title - Optional session title (auto-generated from the first message if not provided)
-     * @throws Error if the operation fails or validation fails
-     */
-    async addMessages(userId, sessionId, messages, title, options = {}) {
-        await (0, actions_1.addMessagesAction)({
-            client: this.client,
-            tableName: this.tableName,
-            userId,
-            sessionId,
-            messages,
-            title,
-            ttlDays: this.ttlDays,
-            signal: options.signal,
-        });
-    }
-    /**
-     * Clear all messages in a session
-     * Deletes the session item from DynamoDB
-     *
-     * @param userId - User identifier
-     * @param sessionId - Session identifier
-     * @throws Error if the operation fails or validation fails
-     */
-    async clear(userId, sessionId, options = {}) {
-        await (0, actions_1.clearAction)({
-            client: this.client,
-            tableName: this.tableName,
-            userId,
-            sessionId,
-            signal: options.signal,
-        });
-    }
-    /**
-     * List all sessions for a user, sorted by most recent
-     * Returns metadata only (excludes messages for performance)
-     *
-     * @param userId - User ID to list sessions for
-     * @param limit - Optional maximum number of sessions to return (default: no limit)
-     * @returns Array of session metadata, sorted by most recent first
-     * @throws Error if the operation fails or validation fails
-     */
-    async listSessions(userId, limit, options = {}) {
-        return await (0, actions_1.listSessionsAction)({
-            client: this.client,
-            tableName: this.tableName,
-            userId,
-            limit,
-            signal: options.signal,
-        });
-    }
-    /**
-     * Bind this store to a single `(userId, sessionId)` pair and return a
-     * `BaseListChatMessageHistory` compatible instance — the shape LangChain's
-     * `RunnableWithMessageHistory` expects from `getMessageHistory(sessionId)`.
-     *
-     * @example
-     * ```ts
-     * const store = new DynamoDBChatMessageHistory({ tableName });
-     * new RunnableWithMessageHistory({
-     *   runnable,
-     *   getMessageHistory: (sessionId) => store.forSession(userId, sessionId),
-     *   // ...
-     * });
-     * ```
-     */
-    forSession(userId, sessionId) {
-        return new session_adapter_1.DynamoDBSessionChatMessageHistory({
-            client: this.client,
-            tableName: this.tableName,
-            userId,
-            sessionId,
-            ttlDays: this.ttlDays,
-        });
-    }
-}
-exports.DynamoDBChatMessageHistory = DynamoDBChatMessageHistory;
-var session_adapter_2 = require("./session-adapter");
-Object.defineProperty(exports, "DynamoDBSessionChatMessageHistory", { enumerable: true, get: function () { return session_adapter_2.DynamoDBSessionChatMessageHistory; } });
-//# sourceMappingURL=index.js.map

package/dist/history/index.js.map

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

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

@@ -1,184 +0,0 @@
-/**
- * Type definitions for chat message history
- * Uses per-message storage pattern: each message is a separate DynamoDB item
- */
-import { DynamoDBClientConfig } from '@aws-sdk/client-dynamodb';
-import { DynamoDBDocument } from '@aws-sdk/lib-dynamodb';
-import type { BaseMessage, StoredMessage } from '@langchain/core/messages';
-/**
- * Configuration options for DynamoDBChatMessageHistory
- *
- * @remarks
- * **TTL semantics — important:**
- *
- * - The **session metadata** item's `ttl` attribute is refreshed on every
- *   `addMessage` / `addMessages` call, so `listSessions()` reflects a session as
- *   live as long as new messages keep arriving within `ttlDays`.
- * - Individual **message items** get a TTL stamped at write time and each
- *   expires independently. A long-lived session that ingests new messages every
- *   few days can develop gaps where old messages expire while newer ones
- *   persist.
- *
- * If you need a strict "keep the whole conversation as long as it is active"
- * contract, set `ttlDays` significantly larger than your expected session
- * lifetime, or manage deletion yourself via `clear()`.
- */
-export interface DynamoDBChatMessageHistoryOptions {
-    /** Name of the DynamoDB table to use for storage */
-    tableName: string;
-    /**
-     * Optional TTL in days for stored items (1-1825 days).
-     *
-     * Metadata TTL is sliding (refreshed on every write). Per-message TTL is
-     * fixed at each message's write time — see the class-level remarks for
-     * implications on long-lived sessions.
-     */
-    ttlDays?: number;
-    /** Optional DynamoDB client configuration */
-    clientConfig?: DynamoDBClientConfig;
-    /** Optional pre-built DynamoDBDocument client (takes precedence over clientConfig) */
-    client?: DynamoDBDocument;
-}
-/**
- * DynamoDB item for session metadata
- * PK: userId, SK: sessionId
- */
-export interface DynamoDBSessionMetadataItem {
-    /** User identifier (partition key) */
-    userId: string;
-    /** Session identifier (sort key) */
-    sessionId: string;
-    /** Item type discriminator */
-    itemType: 'metadata';
-    /** Session title (auto-generated from the first message) */
-    title: string;
-    /** Timestamp when session was created (milliseconds) */
-    createdAt: number;
-    /** Timestamp when the session was last updated (milliseconds) */
-    updatedAt: number;
-    /** Number of messages in the session */
-    messageCount: number;
-    /** Optional TTL timestamp (Unix timestamp in seconds) */
-    ttl?: number;
-}
-/**
- * DynamoDB item for an individual message
- * PK: userId, SK: sessionId#msg#NNNNNN
- */
-export interface DynamoDBMessageItem {
-    /** User identifier (partition key) */
-    userId: string;
-    /** Composite sort key: sessionId#msg#NNNNNN */
-    sessionId: string;
-    /** Item type discriminator */
-    itemType: 'message';
-    /** Zero-based message index */
-    messageIndex: number;
-    /** Serialized message in LangChain StoredMessage format */
-    message: StoredMessage;
-    /** Optional TTL timestamp (Unix timestamp in seconds) */
-    ttl?: number;
-}
-/**
- * Session metadata for listing (excludes messages)
- */
-export interface SessionMetadata {
-    /** Session identifier */
-    sessionId: string;
-    /** Session title */
-    title: string;
-    /** Timestamp when session was created (milliseconds) */
-    createdAt: number;
-    /** Timestamp when the session was last updated (milliseconds) */
-    updatedAt: number;
-    /** Number of messages in the session */
-    messageCount: number;
-}
-/**
- * Parameters for get message action
- */
-export interface GetMessagesActionParams {
-    /** DynamoDB document client */
-    client: DynamoDBDocument;
-    /** Name of the table */
-    tableName: string;
-    /** User identifier */
-    userId: string;
-    /** Session identifier */
-    sessionId: string;
-    /** Optional AbortSignal — cancels in-flight retries */
-    signal?: AbortSignal;
-}
-/**
- * Parameters for add message action
- */
-export interface AddMessageActionParams {
-    /** DynamoDB document client */
-    client: DynamoDBDocument;
-    /** Name of the table */
-    tableName: string;
-    /** User identifier */
-    userId: string;
-    /** Session identifier */
-    sessionId: string;
-    /** Message to add */
-    message: BaseMessage;
-    /** Optional session title (auto-generated if not provided) */
-    title?: string;
-    /** Optional TTL in days */
-    ttlDays?: number;
-    /** Optional AbortSignal — cancels in-flight retries */
-    signal?: AbortSignal;
-}
-/**
- * Parameters for add messages action
- */
-export interface AddMessagesActionParams {
-    /** DynamoDB document client */
-    client: DynamoDBDocument;
-    /** Name of the table */
-    tableName: string;
-    /** User identifier */
-    userId: string;
-    /** Session identifier */
-    sessionId: string;
-    /** Messages to add */
-    messages: BaseMessage[];
-    /** Optional session title (auto-generated if not provided) */
-    title?: string;
-    /** Optional TTL in days */
-    ttlDays?: number;
-    /** Optional AbortSignal — cancels in-flight retries */
-    signal?: AbortSignal;
-}
-/**
- * Parameters for clear action
- */
-export interface ClearActionParams {
-    /** DynamoDB document client */
-    client: DynamoDBDocument;
-    /** Name of the table */
-    tableName: string;
-    /** User identifier */
-    userId: string;
-    /** Session identifier */
-    sessionId: string;
-    /** Optional AbortSignal — cancels in-flight retries */
-    signal?: AbortSignal;
-}
-/**
- * Parameters for list sessions action
- */
-export interface ListSessionsActionParams {
-    /** DynamoDB document client */
-    client: DynamoDBDocument;
-    /** Name of the table */
-    tableName: string;
-    /** User identifier */
-    userId: string;
-    /** Optional maximum number of sessions to return */
-    limit?: number;
-    /** Optional AbortSignal — cancels in-flight retries */
-    signal?: AbortSignal;
-}
-//# sourceMappingURL=index.d.ts.map

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

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

package/dist/history/types/index.js

@@ -1,7 +0,0 @@
-"use strict";
-/**
- * Type definitions for chat message history
- * Uses per-message storage pattern: each message is a separate DynamoDB item
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=index.js.map

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

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

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

@@ -1,9 +0,0 @@
-/**
- * Utility functions for chat message history
- */
-export * from './validation';
-export * from './title-generator';
-export * from './update-expression-builder';
-export * from './optimistic-retry';
-export { withDynamoDBRetry } from '../../shared/utils';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"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,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/history/utils/index.js

@@ -1,27 +0,0 @@
-"use strict";
-/**
- * Utility functions for chat message history
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.withDynamoDBRetry = void 0;
-__exportStar(require("./validation"), exports);
-__exportStar(require("./title-generator"), exports);
-__exportStar(require("./update-expression-builder"), exports);
-__exportStar(require("./optimistic-retry"), 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 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/history/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,oDAAkC;AAClC,8DAA4C;AAC5C,qDAAmC;AACnC,4CAAuD;AAA9C,0GAAA,iBAAiB,OAAA"}

package/dist/history/utils/optimistic-retry.d.ts

@@ -1,31 +0,0 @@
-/**
- * Optimistic-concurrency retry helper shared by addMessage / addMessages.
- *
- * These actions read the current messageCount, then run a transaction that writes
- * new items and updates the counter with a ConditionExpression. On concurrent
- * modification the condition fails; we re-read and retry up to N times.
- */
-export declare const MAX_OPTIMISTIC_RETRIES = 5;
-/**
- * Returns true for errors that indicate an optimistic-lock conflict that is
- * safe to retry — either a bare `ConditionalCheckFailedException`, or a
- * `TransactionCanceledException` where every reported `CancellationReason` is
- * either `ConditionalCheckFailed` or `None`.
- *
- * DynamoDB's `CancellationReasons` array pairs 1:1 with the TransactItems it
- * was handed: participants that did not block the transaction report `None`.
- * Mixed-outcome cases — a `ConditionalCheckFailed` in item 0 alongside a
- * `ValidationError` or `ItemCollectionSizeLimitExceeded` in item 1 — are
- * permanent: retrying the whole transaction will never resolve the permanent
- * sub-reason, so we must propagate instead of looping.
- */
-export declare function isConditionalCheckFailure(err: unknown): boolean;
-/**
- * Run `fn` until it succeeds or until MAX_OPTIMISTIC_RETRIES attempts exhaust.
- *
- * - On conditional-check failure (any attempt but the last), `fn` is re-invoked.
- * - On any other error, the error is re-thrown immediately.
- * - On exhaustion, a labelled error is thrown so the caller can identify it.
- */
-export declare function withOptimisticRetry<T>(label: string, fn: (attempt: number) => Promise<T>): Promise<T>;
-//# sourceMappingURL=optimistic-retry.d.ts.map

package/dist/history/utils/optimistic-retry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"optimistic-retry.d.ts","sourceRoot":"","sources":["../../../src/history/utils/optimistic-retry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAqB/D;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC,CAAC,CAAC,CAYZ"}