@oracle/langchain-oracledb 0.2.0 → 1.1.0

package/dist/chatMessageHistories.js

@@ -0,0 +1,338 @@
+import { BaseListChatMessageHistory } from "@langchain/core/chat_history";
+import { dropTablePurge } from "./vectorstores.js";
+import { createHash } from "node:crypto";
+import oracledb from "oracledb";
+import { ErrorCode, throwError, handleError, createErrorFromCodeWithCause, } from "./errors.js";
+import { mapStoredMessageToChatMessage, } from "@langchain/core/messages";
+import { withConnection, quoteIdentifier, } from "./utils.js";
+const DEFAULT_TABLE_NAME = "langchain_message_store";
+const DEFAULT_SESSION_ID_KEY = "session_id";
+const DEFAULT_HISTORY_KEY = "message";
+const DEFAULT_ID_KEY = 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 = 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,
+ * });
+ *
+ * ```
+ */
+export class OracleChatMessageHistory extends 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) {
+            throwError(ErrorCode.VALIDATION_INVALID_INPUT, "sessionId must be a non-empty string");
+        }
+        if (client == null) {
+            throwError(ErrorCode.VALIDATION_MISSING_REQUIRED_PARAMETER, "client");
+        }
+        if (historySize !== undefined &&
+            (!Number.isSafeInteger(historySize) || historySize < 1)) {
+            throwError(ErrorCode.VALIDATION_INVALID_INPUT, "historySize must be greater than 0");
+        }
+        this.client = client;
+        this.sessionId = sessionId;
+        this.historySize = historySize;
+        this.quotedTableName = quoteIdentifier(tableName);
+        this.quotedSessionIdKey = quoteIdentifier(sessionIdKey);
+        this.quotedHistoryKey = 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 = quoteIdentifier(tableName);
+            const quotedSessionIdKey = quoteIdentifier(sessionIdKey);
+            const quotedHistoryKey = 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 ${quoteIdentifier(indexName)}
+        ON ${quotedTableName} (${quotedSessionIdKey})
+      `;
+            await withConnection(client, async (connection) => {
+                await connection.execute(createTableSql);
+                if (createIndex) {
+                    await connection.execute(createIndexSql);
+                }
+            });
+        }
+        catch (error) {
+            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 withConnection(client, async (connection) => {
+                await dropTablePurge(connection, tableName);
+            });
+        }
+        catch (error) {
+            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 withConnection(this.client, async (connection) => {
+                await connection.execute(this.insertQuery, binds);
+                await connection.commit();
+            });
+        }
+        catch (error) {
+            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 withConnection(this.client, async (connection) => {
+                await connection.executeMany(this.insertQuery, rows, {
+                    autoCommit: false,
+                });
+                await connection.commit();
+            });
+        }
+        catch (error) {
+            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 withConnection(this.client, (connection) => connection.execute(query, params, {
+                outFormat: oracledb.OUT_FORMAT_OBJECT,
+                fetchInfo: {
+                    payload: { type: oracledb.STRING },
+                },
+            }));
+            return (result.rows ?? []).map((row) => {
+                try {
+                    return mapStoredMessageToChatMessage(JSON.parse(row.payload));
+                }
+                catch (error) {
+                    throw createErrorFromCodeWithCause(ErrorCode.HISTORY_DESERIALIZATION_FAILED, error);
+                }
+            });
+        }
+        catch (error) {
+            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 withConnection(this.client, async (connection) => {
+                await connection.execute(this.deleteQuery, { session_id: this.sessionId }, { autoCommit: true });
+            });
+        }
+        catch (error) {
+            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 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 createErrorFromCodeWithCause(ErrorCode.HISTORY_REPLACEMENT_FAILED, cause);
+                }
+            });
+        }
+        catch (error) {
+            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
+    `;
+    }
+}
+//# sourceMappingURL=chatMessageHistories.js.map

package/dist/chatMessageHistories.js.map

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

package/dist/document_loaders.cjs

@@ -35,6 +35,7 @@ const node_path_1 = __importDefault(require("node:path"));
 const oracledb_1 = __importDefault(require("oracledb"));
 const htmlparser2 = __importStar(require("htmlparser2"));
 const base_1 = require("@langchain/core/document_loaders/base");
+const errors_js_1 = require("./errors.cjs");
 function* listDir(dir) {
     const files = node_fs_1.default.readdirSync(dir, { withFileTypes: true });
     for (const file of files) {
@@ -103,12 +104,12 @@ class OracleDocLoader extends base_1.BaseDocumentLoader {
         }
         else if ("tablename" in this.pref) {
             if (!("owner" in this.pref) || !("colname" in this.pref)) {
-                throw new Error("Invalid preferences: missing owner or colname");
+                (0, errors_js_1.throwError)(errors_js_1.ErrorCode.VALIDATION_INVALID_INPUT, "Invalid preferences: missing owner or colname");
             }
             docs.push(...(await this._loadFromTable(this.pref.owner, this.pref.tablename, this.pref.colname)));
         }
         else {
-            throw new Error("Invalid preferences: missing file, dir, or tablename");
+            (0, errors_js_1.throwError)(errors_js_1.ErrorCode.VALIDATION_INVALID_INPUT, "Invalid preferences: missing file, dir, or tablename");
         }
         return docs;
     }
@@ -159,7 +160,7 @@ class OracleDocLoader extends base_1.BaseDocumentLoader {
             await this.conn.execute(sql, binds);
         }
         catch {
-            throw new Error("Invalid owner, table, or column name");
+            (0, errors_js_1.throwError)(errors_js_1.ErrorCode.VALIDATION_INVALID_IDENTIFIER, `${owner}.${table}.${col}`);
         }
         const result = await this.conn.execute((`select dbms_vector_chain.utl_to_text(t.${this.pref.colname}, :pref) text,\
                   dbms_vector_chain.utl_to_text(t.${this.pref.colname}, json('{"plaintext": "false"}')) metadata\

package/dist/document_loaders.cjs.map

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

package/dist/document_loaders.js

@@ -6,6 +6,7 @@ import path from "node:path";
 import oracledb from "oracledb";
 import * as htmlparser2 from "htmlparser2";
 import { BaseDocumentLoader } from "@langchain/core/document_loaders/base";
+import { ErrorCode, throwError } from "./errors.js";
 function* listDir(dir) {
     const files = fs.readdirSync(dir, { withFileTypes: true });
     for (const file of files) {
@@ -74,12 +75,12 @@ export class OracleDocLoader extends BaseDocumentLoader {
         }
         else if ("tablename" in this.pref) {
             if (!("owner" in this.pref) || !("colname" in this.pref)) {
-                throw new Error("Invalid preferences: missing owner or colname");
+                throwError(ErrorCode.VALIDATION_INVALID_INPUT, "Invalid preferences: missing owner or colname");
             }
             docs.push(...(await this._loadFromTable(this.pref.owner, this.pref.tablename, this.pref.colname)));
         }
         else {
-            throw new Error("Invalid preferences: missing file, dir, or tablename");
+            throwError(ErrorCode.VALIDATION_INVALID_INPUT, "Invalid preferences: missing file, dir, or tablename");
         }
         return docs;
     }
@@ -130,7 +131,7 @@ export class OracleDocLoader extends BaseDocumentLoader {
             await this.conn.execute(sql, binds);
         }
         catch {
-            throw new Error("Invalid owner, table, or column name");
+            throwError(ErrorCode.VALIDATION_INVALID_IDENTIFIER, `${owner}.${table}.${col}`);
         }
         const result = await this.conn.execute((`select dbms_vector_chain.utl_to_text(t.${this.pref.colname}, :pref) text,\
                   dbms_vector_chain.utl_to_text(t.${this.pref.colname}, json('{"plaintext": "false"}')) metadata\

package/dist/document_loaders.js.map

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

package/dist/errors.cjs

@@ -0,0 +1,123 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.throwError = exports.createErrorFromCodeWithCause = exports.createErrorFromCode = exports.isLangChainOracleError = exports.createError = exports.handleError = exports.LangChainOracleError = exports.ErrorCode = void 0;
+exports.ErrorCode = {
+    VALIDATION_INVALID_INPUT: "VALIDATION_INVALID_INPUT",
+    VALIDATION_MISSING_REQUIRED_PARAMETER: "VALIDATION_MISSING_REQUIRED_PARAMETER",
+    VALIDATION_INVALID_IDENTIFIER: "VALIDATION_INVALID_IDENTIFIER",
+    FILTER_INVALID_METADATA_KEY: "FILTER_INVALID_METADATA_KEY",
+    FILTER_INVALID_VALUE: "FILTER_INVALID_VALUE",
+    FILTER_UNSUPPORTED_OPERATOR: "FILTER_UNSUPPORTED_OPERATOR",
+    VECTOR_INVALID_CONFIGURATION: "VECTOR_INVALID_CONFIGURATION",
+    VECTOR_INVALID_VALUE: "VECTOR_INVALID_VALUE",
+    VECTOR_UNSUPPORTED_REPRESENTATION: "VECTOR_UNSUPPORTED_REPRESENTATION",
+    VECTOR_INVALID_INDEX_PARAMETERS: "VECTOR_INVALID_INDEX_PARAMETERS",
+    STATE_INVALID: "STATE_INVALID",
+    QUERY_NO_ROWS_FOUND: "QUERY_NO_ROWS_FOUND",
+    CACHE_DESERIALIZATION_FAILED: "CACHE_DESERIALIZATION_FAILED",
+    HISTORY_DESERIALIZATION_FAILED: "HISTORY_DESERIALIZATION_FAILED",
+    HISTORY_REPLACEMENT_FAILED: "HISTORY_REPLACEMENT_FAILED",
+    SYSTEM_ERROR: "SYSTEM_ERROR",
+};
+const LANGCHAIN_ORACLE_ERROR_BRAND = Symbol.for("@oracle/langchain-oracledb/LangChainOracleError");
+/**
+ * A specialized exception representing domain-specific failures within the
+ * LangChain Oracle integration. Extends the native JavaScript `Error` to preserve
+ * stack traces. Lower-level driver errors are safely isolated inside the `cause`
+ * property to protect against shifting node-oracledb definitions.
+ */
+class LangChainOracleError extends Error {
+    constructor(code, message, cause) {
+        super(message);
+        Object.defineProperty(this, "code", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "cause", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, _a, {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: true
+        });
+        // Hardcode the class name so logs show "LangChainOracleError: ..."
+        this.name = "LangChainOracleError";
+        this.code = code;
+        // Save the raw node-oracledb error (or validation error) for root-cause analysis
+        this.cause = cause;
+    }
+}
+exports.LangChainOracleError = LangChainOracleError;
+_a = LANGCHAIN_ORACLE_ERROR_BRAND;
+function handleError(error) {
+    // Preserve LangChainOracleError instances created by this package instead of
+    // wrapping them again as generic SYSTEM_ERROR failures.
+    if (isLangChainOracleError(error)) {
+        throw error;
+    }
+    // Preserve a useful message for both real Error instances and thrown
+    // object literals shaped like { message: string }.
+    const details = typeof error === "object" &&
+        error !== null &&
+        "message" in error &&
+        typeof error.message === "string"
+        ? error.message
+        : String(error);
+    // Preserve the original cause when wrapping an unexpected error.
+    throw createErrorFromCodeWithCause(exports.ErrorCode.SYSTEM_ERROR, error, `An unexpected error occurred during the operation. ${details}`);
+}
+exports.handleError = handleError;
+function createError(code, message, cause) {
+    return new LangChainOracleError(code, message, cause);
+}
+exports.createError = createError;
+// Identifies LangChainOracleError instances created by this package, not generic
+// node-oracledb or database errors such as NJS- or ORA- codes.
+function isLangChainOracleError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        LANGCHAIN_ORACLE_ERROR_BRAND in error);
+}
+exports.isLangChainOracleError = isLangChainOracleError;
+const errorMessageFactories = {
+    [exports.ErrorCode.VALIDATION_INVALID_INPUT]: (message) => message,
+    [exports.ErrorCode.VALIDATION_MISSING_REQUIRED_PARAMETER]: (parameter) => `${parameter} parameter is required...`,
+    [exports.ErrorCode.VALIDATION_INVALID_IDENTIFIER]: (identifier) => `Identifier name ${identifier} is not valid.`,
+    [exports.ErrorCode.FILTER_INVALID_METADATA_KEY]: (column) => `Invalid metadata key '${String(column)}'. Only letters, numbers, underscores, nesting via '.', and array wildcards '[*]' are allowed.`,
+    [exports.ErrorCode.FILTER_INVALID_VALUE]: (message) => message,
+    [exports.ErrorCode.FILTER_UNSUPPORTED_OPERATOR]: (operator) => `Unsupported operator: ${operator}`,
+    [exports.ErrorCode.VECTOR_INVALID_CONFIGURATION]: (message) => message,
+    [exports.ErrorCode.VECTOR_INVALID_VALUE]: (message) => message,
+    [exports.ErrorCode.VECTOR_UNSUPPORTED_REPRESENTATION]: (message) => message,
+    [exports.ErrorCode.VECTOR_INVALID_INDEX_PARAMETERS]: (invalidKeys) => `Invalid parameter(s): ${invalidKeys.join(", ")}`,
+    [exports.ErrorCode.STATE_INVALID]: (message) => message,
+    [exports.ErrorCode.QUERY_NO_ROWS_FOUND]: () => "No rows found.",
+    [exports.ErrorCode.CACHE_DESERIALIZATION_FAILED]: () => "Failed to deserialize cached generations.",
+    [exports.ErrorCode.HISTORY_DESERIALIZATION_FAILED]: () => "Failed to deserialize a stored history message.",
+    [exports.ErrorCode.HISTORY_REPLACEMENT_FAILED]: () => "Failed to replace stored history messages.",
+    [exports.ErrorCode.SYSTEM_ERROR]: (message) => message,
+};
+function getErrorMessage(code, ...args) {
+    return errorMessageFactories[code](...args);
+}
+function createErrorFromCode(code, ...args) {
+    return createError(code, getErrorMessage(code, ...args));
+}
+exports.createErrorFromCode = createErrorFromCode;
+function createErrorFromCodeWithCause(code, cause, ...args) {
+    return createError(code, getErrorMessage(code, ...args), cause);
+}
+exports.createErrorFromCodeWithCause = createErrorFromCodeWithCause;
+function throwError(code, ...args) {
+    throw createErrorFromCode(code, ...args);
+}
+exports.throwError = throwError;
+//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

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

package/dist/errors.d.cts

@@ -0,0 +1,57 @@
+export declare const ErrorCode: {
+    readonly VALIDATION_INVALID_INPUT: "VALIDATION_INVALID_INPUT";
+    readonly VALIDATION_MISSING_REQUIRED_PARAMETER: "VALIDATION_MISSING_REQUIRED_PARAMETER";
+    readonly VALIDATION_INVALID_IDENTIFIER: "VALIDATION_INVALID_IDENTIFIER";
+    readonly FILTER_INVALID_METADATA_KEY: "FILTER_INVALID_METADATA_KEY";
+    readonly FILTER_INVALID_VALUE: "FILTER_INVALID_VALUE";
+    readonly FILTER_UNSUPPORTED_OPERATOR: "FILTER_UNSUPPORTED_OPERATOR";
+    readonly VECTOR_INVALID_CONFIGURATION: "VECTOR_INVALID_CONFIGURATION";
+    readonly VECTOR_INVALID_VALUE: "VECTOR_INVALID_VALUE";
+    readonly VECTOR_UNSUPPORTED_REPRESENTATION: "VECTOR_UNSUPPORTED_REPRESENTATION";
+    readonly VECTOR_INVALID_INDEX_PARAMETERS: "VECTOR_INVALID_INDEX_PARAMETERS";
+    readonly STATE_INVALID: "STATE_INVALID";
+    readonly QUERY_NO_ROWS_FOUND: "QUERY_NO_ROWS_FOUND";
+    readonly CACHE_DESERIALIZATION_FAILED: "CACHE_DESERIALIZATION_FAILED";
+    readonly HISTORY_DESERIALIZATION_FAILED: "HISTORY_DESERIALIZATION_FAILED";
+    readonly HISTORY_REPLACEMENT_FAILED: "HISTORY_REPLACEMENT_FAILED";
+    readonly SYSTEM_ERROR: "SYSTEM_ERROR";
+};
+export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
+declare const LANGCHAIN_ORACLE_ERROR_BRAND: unique symbol;
+type ErrorArgs = {
+    [ErrorCode.VALIDATION_INVALID_INPUT]: [message: string];
+    [ErrorCode.VALIDATION_MISSING_REQUIRED_PARAMETER]: [parameter: string];
+    [ErrorCode.VALIDATION_INVALID_IDENTIFIER]: [identifier: string];
+    [ErrorCode.FILTER_INVALID_METADATA_KEY]: [column: string];
+    [ErrorCode.FILTER_INVALID_VALUE]: [message: string];
+    [ErrorCode.FILTER_UNSUPPORTED_OPERATOR]: [operator: string];
+    [ErrorCode.VECTOR_INVALID_CONFIGURATION]: [message: string];
+    [ErrorCode.VECTOR_INVALID_VALUE]: [message: string];
+    [ErrorCode.VECTOR_UNSUPPORTED_REPRESENTATION]: [message: string];
+    [ErrorCode.VECTOR_INVALID_INDEX_PARAMETERS]: [invalidKeys: string[]];
+    [ErrorCode.STATE_INVALID]: [message: string];
+    [ErrorCode.QUERY_NO_ROWS_FOUND]: [];
+    [ErrorCode.CACHE_DESERIALIZATION_FAILED]: [];
+    [ErrorCode.HISTORY_DESERIALIZATION_FAILED]: [];
+    [ErrorCode.HISTORY_REPLACEMENT_FAILED]: [];
+    [ErrorCode.SYSTEM_ERROR]: [message: string];
+};
+/**
+ * A specialized exception representing domain-specific failures within the
+ * LangChain Oracle integration. Extends the native JavaScript `Error` to preserve
+ * stack traces. Lower-level driver errors are safely isolated inside the `cause`
+ * property to protect against shifting node-oracledb definitions.
+ */
+export declare class LangChainOracleError extends Error {
+    readonly code: ErrorCode;
+    readonly cause?: unknown;
+    readonly [LANGCHAIN_ORACLE_ERROR_BRAND] = true;
+    constructor(code: ErrorCode, message: string, cause?: unknown);
+}
+export declare function handleError(error: unknown): never;
+export declare function createError(code: ErrorCode, message: string, cause?: unknown): LangChainOracleError;
+export declare function isLangChainOracleError(error: unknown): error is LangChainOracleError;
+export declare function createErrorFromCode<K extends ErrorCode>(code: K, ...args: ErrorArgs[K]): LangChainOracleError;
+export declare function createErrorFromCodeWithCause<K extends ErrorCode>(code: K, cause: unknown, ...args: ErrorArgs[K]): LangChainOracleError;
+export declare function throwError<K extends ErrorCode>(code: K, ...args: ErrorArgs[K]): never;
+export {};