@oracle/langchain-oracledb 1.0.0 → 1.1.0

package/dist/chatMessageHistories.cjs

@@ -0,0 +1,345 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OracleChatMessageHistory = void 0;
+const chat_history_1 = require("@langchain/core/chat_history");
+const vectorstores_js_1 = require("./vectorstores.cjs");
+const node_crypto_1 = require("node:crypto");
+const oracledb_1 = __importDefault(require("oracledb"));
+const errors_js_1 = require("./errors.cjs");
+const messages_1 = require("@langchain/core/messages");
+const utils_js_1 = require("./utils.cjs");
+const DEFAULT_TABLE_NAME = "langchain_message_store";
+const DEFAULT_SESSION_ID_KEY = "session_id";
+const DEFAULT_HISTORY_KEY = "message";
+const DEFAULT_ID_KEY = (0, utils_js_1.quoteIdentifier)("id");
+function unqualifiedIdentifier(name) {
+    return name.replaceAll('"', "").split(".").pop();
+}
+function defaultIndexName(tableName, sessionIdKey) {
+    const baseName = `idx_${unqualifiedIdentifier(tableName)}_` +
+        unqualifiedIdentifier(sessionIdKey);
+    const encoded = Buffer.from(baseName, "utf-8");
+    if (encoded.length <= 128)
+        return baseName;
+    const digest = (0, node_crypto_1.createHash)("sha1").update(encoded).digest("hex").slice(0, 8);
+    const prefix = new TextDecoder("utf-8").decode(encoded.subarray(0, 119), {
+        stream: true,
+    });
+    return `${prefix}_${digest}`;
+}
+/**
+ * Stores conversation messages in Oracle Database, with one row per message
+ * and a session ID identifying each conversation. Extends BaseListChatMessageHistory.
+ *
+ * Call `createTables()` before using the history unless the table already exists.
+ * A single table can hold many sessions separated by the configured session ID column.
+ * @example
+ * ```typescript
+ * // `pool` is an Oracle connection pool.
+ * await OracleChatMessageHistory.createTables({
+ *    client: pool,
+ *    tableName: "langchain_chat_histories"
+ * });
+ *
+ * const chatHistory = new OracleChatMessageHistory({
+ *   client: pool,
+ *   tableName: "langchain_chat_histories",
+ *   sessionId: "lc-example",
+ *   historySize: 20,
+ * });
+ *
+ * ```
+ */
+class OracleChatMessageHistory extends chat_history_1.BaseListChatMessageHistory {
+    /**
+     * Creates an OracleChatMessageHistory instance without performing database setup.
+     * @param {OracleChatMessageHistoryInput} options The history configuration.
+     * @param {OracleDBClient | OracleDBClientProvider} options.client The connection, pool, or async provider to use.
+     * @param {string} options.sessionId The session ID used to store and retrieve messages.
+     * @param {string} options.tableName Table used to store chat history rows. Defaults to `langchain_message_store`.
+     * @param {string} options.sessionIdKey Column containing the session identifier. Defaults to `session_id`.
+     * @param {string} options.historyKey Column containing the serialized message payload. Defaults to `message`.
+     * @param {number} options.historySize Optional maximum number of most recent messages to return.
+     * @throws If the client is missing, the session ID is empty or not a string,
+     * an identifier is invalid, or the history size is not a positive safe integer.
+     */
+    constructor({ client, sessionId, tableName = DEFAULT_TABLE_NAME, sessionIdKey = DEFAULT_SESSION_ID_KEY, historyKey = DEFAULT_HISTORY_KEY, historySize, }) {
+        super();
+        Object.defineProperty(this, "lc_namespace", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ["langchain", "stores", "message", "oracle"]
+        });
+        Object.defineProperty(this, "client", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "sessionId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "quotedTableName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "quotedSessionIdKey", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "quotedHistoryKey", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "historySize", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        if (typeof sessionId !== "string" || !sessionId) {
+            (0, errors_js_1.throwError)(errors_js_1.ErrorCode.VALIDATION_INVALID_INPUT, "sessionId must be a non-empty string");
+        }
+        if (client == null) {
+            (0, errors_js_1.throwError)(errors_js_1.ErrorCode.VALIDATION_MISSING_REQUIRED_PARAMETER, "client");
+        }
+        if (historySize !== undefined &&
+            (!Number.isSafeInteger(historySize) || historySize < 1)) {
+            (0, errors_js_1.throwError)(errors_js_1.ErrorCode.VALIDATION_INVALID_INPUT, "historySize must be greater than 0");
+        }
+        this.client = client;
+        this.sessionId = sessionId;
+        this.historySize = historySize;
+        this.quotedTableName = (0, utils_js_1.quoteIdentifier)(tableName);
+        this.quotedSessionIdKey = (0, utils_js_1.quoteIdentifier)(sessionIdKey);
+        this.quotedHistoryKey = (0, utils_js_1.quoteIdentifier)(historyKey);
+    }
+    /**
+     * Creates the history table and optional session index if they do not exist.
+     * @param {OracleChatMessageHistorySetupInput} options The database setup configuration.
+     * @param {boolean} options.createIndex Whether to create the session index. Defaults to `true`.
+     * @returns Promise that resolves when database setup completes.
+     */
+    static async createTables({ client, tableName = DEFAULT_TABLE_NAME, createIndex = true, sessionIdKey = DEFAULT_SESSION_ID_KEY, historyKey = DEFAULT_HISTORY_KEY, }) {
+        try {
+            const quotedTableName = (0, utils_js_1.quoteIdentifier)(tableName);
+            const quotedSessionIdKey = (0, utils_js_1.quoteIdentifier)(sessionIdKey);
+            const quotedHistoryKey = (0, utils_js_1.quoteIdentifier)(historyKey);
+            const createTableSql = `
+      CREATE TABLE IF NOT EXISTS ${quotedTableName} (
+        ${DEFAULT_ID_KEY} NUMBER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+        ${quotedSessionIdKey} VARCHAR2(255) NOT NULL,
+        ${quotedHistoryKey} CLOB NOT NULL,
+        created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP NOT NULL
+      )`;
+            const indexName = defaultIndexName(tableName, sessionIdKey);
+            const createIndexSql = `
+        CREATE INDEX IF NOT EXISTS ${(0, utils_js_1.quoteIdentifier)(indexName)}
+        ON ${quotedTableName} (${quotedSessionIdKey})
+      `;
+            await (0, utils_js_1.withConnection)(client, async (connection) => {
+                await connection.execute(createTableSql);
+                if (createIndex) {
+                    await connection.execute(createIndexSql);
+                }
+            });
+        }
+        catch (error) {
+            (0, errors_js_1.handleError)(error);
+        }
+    }
+    /**
+     * Drops and purges the history table if it exists, removing every session's messages.
+     * @param {OracleDBClient | OracleDBClientProvider} client The connection, pool, or async provider to use.
+     * @param {string} tableName The table to drop. Defaults to `langchain_message_store`.
+     * @returns Promise that resolves when the table has been dropped or does not exist.
+     */
+    static async dropTable(client, tableName = DEFAULT_TABLE_NAME) {
+        try {
+            await (0, utils_js_1.withConnection)(client, async (connection) => {
+                await (0, vectorstores_js_1.dropTablePurge)(connection, tableName);
+            });
+        }
+        catch (error) {
+            (0, errors_js_1.handleError)(error);
+        }
+    }
+    /**
+     * Adds one message to the session.
+     * @param {BaseMessage} message The message to store.
+     * @returns Promise that resolves when the message has been stored.
+     */
+    async addMessage(message) {
+        try {
+            const binds = [this.sessionId, JSON.stringify(message.toDict())];
+            await (0, utils_js_1.withConnection)(this.client, async (connection) => {
+                await connection.execute(this.insertQuery, binds);
+                await connection.commit();
+            });
+        }
+        catch (error) {
+            (0, errors_js_1.handleError)(error);
+        }
+    }
+    /**
+     * Adds a batch of messages in insertion order.
+     * @param {BaseMessage[]} messages The messages to store.
+     * @returns Promise that resolves when the messages have been stored.
+     */
+    async addMessages(messages) {
+        try {
+            if (messages.length === 0)
+                return;
+            const rows = messages.map((message) => [
+                this.sessionId,
+                JSON.stringify(message.toDict()),
+            ]);
+            await (0, utils_js_1.withConnection)(this.client, async (connection) => {
+                await connection.executeMany(this.insertQuery, rows, {
+                    autoCommit: false,
+                });
+                await connection.commit();
+            });
+        }
+        catch (error) {
+            (0, errors_js_1.handleError)(error);
+        }
+    }
+    /**
+     * Retrieves messages for the configured session in ascending ID order.
+     * When `historySize` is set, returns only the most recent messages in that order.
+     * @returns Promise resolving to the stored messages, or an empty array for an empty session.
+     */
+    async getMessages() {
+        try {
+            let query;
+            let params;
+            if (this.historySize === undefined) {
+                query = `
+        SELECT ${this.quotedHistoryKey} AS "payload", ${DEFAULT_ID_KEY}
+        FROM ${this.quotedTableName}
+        WHERE ${this.quotedSessionIdKey} = :session_id
+        ORDER BY ${DEFAULT_ID_KEY}
+      `;
+                params = { session_id: this.sessionId };
+            }
+            else {
+                query = `
+        SELECT payload AS "payload", ${DEFAULT_ID_KEY}
+        FROM (
+          SELECT ${this.quotedHistoryKey} AS payload, ${DEFAULT_ID_KEY}
+          FROM ${this.quotedTableName}
+          WHERE ${this.quotedSessionIdKey} = :session_id
+          ORDER BY ${DEFAULT_ID_KEY} DESC
+        )
+        WHERE ROWNUM <= :history_size
+        ORDER BY ${DEFAULT_ID_KEY}
+      `;
+                params = {
+                    session_id: this.sessionId,
+                    history_size: this.historySize,
+                };
+            }
+            const result = await (0, utils_js_1.withConnection)(this.client, (connection) => connection.execute(query, params, {
+                outFormat: oracledb_1.default.OUT_FORMAT_OBJECT,
+                fetchInfo: {
+                    payload: { type: oracledb_1.default.STRING },
+                },
+            }));
+            return (result.rows ?? []).map((row) => {
+                try {
+                    return (0, messages_1.mapStoredMessageToChatMessage)(JSON.parse(row.payload));
+                }
+                catch (error) {
+                    throw (0, errors_js_1.createErrorFromCodeWithCause)(errors_js_1.ErrorCode.HISTORY_DESERIALIZATION_FAILED, error);
+                }
+            });
+        }
+        catch (error) {
+            (0, errors_js_1.handleError)(error);
+        }
+    }
+    /**
+     * Deletes all messages belonging to the configured session.
+     * @returns Promise that resolves when this session's messages have been cleared.
+     */
+    async clear() {
+        try {
+            await (0, utils_js_1.withConnection)(this.client, async (connection) => {
+                await connection.execute(this.deleteQuery, { session_id: this.sessionId }, { autoCommit: true });
+            });
+        }
+        catch (error) {
+            (0, errors_js_1.handleError)(error);
+        }
+    }
+    /**
+     * Replaces the configured session's stored messages. An empty array clears the session.
+     * @param {BaseMessage[]} messages The replacement messages in insertion order.
+     * @returns Promise that resolves when the replacement has been committed.
+     */
+    async replaceMessages(messages) {
+        try {
+            const rows = messages.map((message) => [
+                this.sessionId,
+                JSON.stringify(message.toDict()),
+            ]);
+            await (0, utils_js_1.withConnection)(this.client, async (connection) => {
+                try {
+                    await connection.execute(this.deleteQuery, { session_id: this.sessionId }, { autoCommit: false });
+                    if (rows.length > 0) {
+                        await connection.executeMany(this.insertQuery, rows, {
+                            autoCommit: false,
+                            batchErrors: false,
+                        });
+                    }
+                    await connection.commit();
+                }
+                catch (error) {
+                    let cause = error;
+                    try {
+                        await connection.rollback();
+                    }
+                    catch (rollbackError) {
+                        cause = new AggregateError([error, rollbackError], "Replacing messages failed, and rollback also failed.");
+                    }
+                    throw (0, errors_js_1.createErrorFromCodeWithCause)(errors_js_1.ErrorCode.HISTORY_REPLACEMENT_FAILED, cause);
+                }
+            });
+        }
+        catch (error) {
+            (0, errors_js_1.handleError)(error);
+        }
+    }
+    get insertQuery() {
+        return `
+      INSERT INTO ${this.quotedTableName}
+        (
+          ${this.quotedSessionIdKey},
+          ${this.quotedHistoryKey}
+        )
+      VALUES (:1, :2)
+    `;
+    }
+    get deleteQuery() {
+        return `
+      DELETE FROM ${this.quotedTableName}
+      WHERE ${this.quotedSessionIdKey} = :session_id
+    `;
+    }
+}
+exports.OracleChatMessageHistory = OracleChatMessageHistory;
+//# sourceMappingURL=chatMessageHistories.cjs.map

package/dist/chatMessageHistories.cjs.map

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

package/dist/chatMessageHistories.d.cts

@@ -0,0 +1,107 @@
+import { BaseListChatMessageHistory } from "@langchain/core/chat_history";
+import { BaseMessage } from "@langchain/core/messages";
+import { OracleDBClient, OracleDBClientProvider } from "./utils.js";
+interface OracleChatMessageHistoryBaseInput {
+    client: OracleDBClient | OracleDBClientProvider;
+    tableName?: string;
+    sessionIdKey?: string;
+    historyKey?: string;
+}
+interface OracleChatMessageHistoryInput extends OracleChatMessageHistoryBaseInput {
+    sessionId: string;
+    historySize?: number;
+}
+interface OracleChatMessageHistorySetupInput extends OracleChatMessageHistoryBaseInput {
+    createIndex?: boolean;
+}
+/**
+ * Stores conversation messages in Oracle Database, with one row per message
+ * and a session ID identifying each conversation. Extends BaseListChatMessageHistory.
+ *
+ * Call `createTables()` before using the history unless the table already exists.
+ * A single table can hold many sessions separated by the configured session ID column.
+ * @example
+ * ```typescript
+ * // `pool` is an Oracle connection pool.
+ * await OracleChatMessageHistory.createTables({
+ *    client: pool,
+ *    tableName: "langchain_chat_histories"
+ * });
+ *
+ * const chatHistory = new OracleChatMessageHistory({
+ *   client: pool,
+ *   tableName: "langchain_chat_histories",
+ *   sessionId: "lc-example",
+ *   historySize: 20,
+ * });
+ *
+ * ```
+ */
+export declare class OracleChatMessageHistory extends BaseListChatMessageHistory {
+    lc_namespace: string[];
+    readonly client: OracleDBClient | OracleDBClientProvider;
+    readonly sessionId: string;
+    private readonly quotedTableName;
+    private readonly quotedSessionIdKey;
+    private readonly quotedHistoryKey;
+    readonly historySize?: number | undefined;
+    /**
+     * Creates an OracleChatMessageHistory instance without performing database setup.
+     * @param {OracleChatMessageHistoryInput} options The history configuration.
+     * @param {OracleDBClient | OracleDBClientProvider} options.client The connection, pool, or async provider to use.
+     * @param {string} options.sessionId The session ID used to store and retrieve messages.
+     * @param {string} options.tableName Table used to store chat history rows. Defaults to `langchain_message_store`.
+     * @param {string} options.sessionIdKey Column containing the session identifier. Defaults to `session_id`.
+     * @param {string} options.historyKey Column containing the serialized message payload. Defaults to `message`.
+     * @param {number} options.historySize Optional maximum number of most recent messages to return.
+     * @throws If the client is missing, the session ID is empty or not a string,
+     * an identifier is invalid, or the history size is not a positive safe integer.
+     */
+    constructor({ client, sessionId, tableName, sessionIdKey, historyKey, historySize, }: OracleChatMessageHistoryInput);
+    /**
+     * Creates the history table and optional session index if they do not exist.
+     * @param {OracleChatMessageHistorySetupInput} options The database setup configuration.
+     * @param {boolean} options.createIndex Whether to create the session index. Defaults to `true`.
+     * @returns Promise that resolves when database setup completes.
+     */
+    static createTables({ client, tableName, createIndex, sessionIdKey, historyKey, }: OracleChatMessageHistorySetupInput): Promise<void>;
+    /**
+     * Drops and purges the history table if it exists, removing every session's messages.
+     * @param {OracleDBClient | OracleDBClientProvider} client The connection, pool, or async provider to use.
+     * @param {string} tableName The table to drop. Defaults to `langchain_message_store`.
+     * @returns Promise that resolves when the table has been dropped or does not exist.
+     */
+    static dropTable(client: OracleDBClient | OracleDBClientProvider, tableName?: string): Promise<void>;
+    /**
+     * Adds one message to the session.
+     * @param {BaseMessage} message The message to store.
+     * @returns Promise that resolves when the message has been stored.
+     */
+    addMessage(message: BaseMessage): Promise<void>;
+    /**
+     * Adds a batch of messages in insertion order.
+     * @param {BaseMessage[]} messages The messages to store.
+     * @returns Promise that resolves when the messages have been stored.
+     */
+    addMessages(messages: BaseMessage[]): Promise<void>;
+    /**
+     * Retrieves messages for the configured session in ascending ID order.
+     * When `historySize` is set, returns only the most recent messages in that order.
+     * @returns Promise resolving to the stored messages, or an empty array for an empty session.
+     */
+    getMessages(): Promise<BaseMessage[]>;
+    /**
+     * Deletes all messages belonging to the configured session.
+     * @returns Promise that resolves when this session's messages have been cleared.
+     */
+    clear(): Promise<void>;
+    /**
+     * Replaces the configured session's stored messages. An empty array clears the session.
+     * @param {BaseMessage[]} messages The replacement messages in insertion order.
+     * @returns Promise that resolves when the replacement has been committed.
+     */
+    replaceMessages(messages: BaseMessage[]): Promise<void>;
+    private get insertQuery();
+    private get deleteQuery();
+}
+export {};

package/dist/chatMessageHistories.d.ts

@@ -0,0 +1,107 @@
+import { BaseListChatMessageHistory } from "@langchain/core/chat_history";
+import { BaseMessage } from "@langchain/core/messages";
+import { OracleDBClient, OracleDBClientProvider } from "./utils.js";
+interface OracleChatMessageHistoryBaseInput {
+    client: OracleDBClient | OracleDBClientProvider;
+    tableName?: string;
+    sessionIdKey?: string;
+    historyKey?: string;
+}
+interface OracleChatMessageHistoryInput extends OracleChatMessageHistoryBaseInput {
+    sessionId: string;
+    historySize?: number;
+}
+interface OracleChatMessageHistorySetupInput extends OracleChatMessageHistoryBaseInput {
+    createIndex?: boolean;
+}
+/**
+ * Stores conversation messages in Oracle Database, with one row per message
+ * and a session ID identifying each conversation. Extends BaseListChatMessageHistory.
+ *
+ * Call `createTables()` before using the history unless the table already exists.
+ * A single table can hold many sessions separated by the configured session ID column.
+ * @example
+ * ```typescript
+ * // `pool` is an Oracle connection pool.
+ * await OracleChatMessageHistory.createTables({
+ *    client: pool,
+ *    tableName: "langchain_chat_histories"
+ * });
+ *
+ * const chatHistory = new OracleChatMessageHistory({
+ *   client: pool,
+ *   tableName: "langchain_chat_histories",
+ *   sessionId: "lc-example",
+ *   historySize: 20,
+ * });
+ *
+ * ```
+ */
+export declare class OracleChatMessageHistory extends BaseListChatMessageHistory {
+    lc_namespace: string[];
+    readonly client: OracleDBClient | OracleDBClientProvider;
+    readonly sessionId: string;
+    private readonly quotedTableName;
+    private readonly quotedSessionIdKey;
+    private readonly quotedHistoryKey;
+    readonly historySize?: number | undefined;
+    /**
+     * Creates an OracleChatMessageHistory instance without performing database setup.
+     * @param {OracleChatMessageHistoryInput} options The history configuration.
+     * @param {OracleDBClient | OracleDBClientProvider} options.client The connection, pool, or async provider to use.
+     * @param {string} options.sessionId The session ID used to store and retrieve messages.
+     * @param {string} options.tableName Table used to store chat history rows. Defaults to `langchain_message_store`.
+     * @param {string} options.sessionIdKey Column containing the session identifier. Defaults to `session_id`.
+     * @param {string} options.historyKey Column containing the serialized message payload. Defaults to `message`.
+     * @param {number} options.historySize Optional maximum number of most recent messages to return.
+     * @throws If the client is missing, the session ID is empty or not a string,
+     * an identifier is invalid, or the history size is not a positive safe integer.
+     */
+    constructor({ client, sessionId, tableName, sessionIdKey, historyKey, historySize, }: OracleChatMessageHistoryInput);
+    /**
+     * Creates the history table and optional session index if they do not exist.
+     * @param {OracleChatMessageHistorySetupInput} options The database setup configuration.
+     * @param {boolean} options.createIndex Whether to create the session index. Defaults to `true`.
+     * @returns Promise that resolves when database setup completes.
+     */
+    static createTables({ client, tableName, createIndex, sessionIdKey, historyKey, }: OracleChatMessageHistorySetupInput): Promise<void>;
+    /**
+     * Drops and purges the history table if it exists, removing every session's messages.
+     * @param {OracleDBClient | OracleDBClientProvider} client The connection, pool, or async provider to use.
+     * @param {string} tableName The table to drop. Defaults to `langchain_message_store`.
+     * @returns Promise that resolves when the table has been dropped or does not exist.
+     */
+    static dropTable(client: OracleDBClient | OracleDBClientProvider, tableName?: string): Promise<void>;
+    /**
+     * Adds one message to the session.
+     * @param {BaseMessage} message The message to store.
+     * @returns Promise that resolves when the message has been stored.
+     */
+    addMessage(message: BaseMessage): Promise<void>;
+    /**
+     * Adds a batch of messages in insertion order.
+     * @param {BaseMessage[]} messages The messages to store.
+     * @returns Promise that resolves when the messages have been stored.
+     */
+    addMessages(messages: BaseMessage[]): Promise<void>;
+    /**
+     * Retrieves messages for the configured session in ascending ID order.
+     * When `historySize` is set, returns only the most recent messages in that order.
+     * @returns Promise resolving to the stored messages, or an empty array for an empty session.
+     */
+    getMessages(): Promise<BaseMessage[]>;
+    /**
+     * Deletes all messages belonging to the configured session.
+     * @returns Promise that resolves when this session's messages have been cleared.
+     */
+    clear(): Promise<void>;
+    /**
+     * Replaces the configured session's stored messages. An empty array clears the session.
+     * @param {BaseMessage[]} messages The replacement messages in insertion order.
+     * @returns Promise that resolves when the replacement has been committed.
+     */
+    replaceMessages(messages: BaseMessage[]): Promise<void>;
+    private get insertQuery();
+    private get deleteQuery();
+}
+export {};