@oracle/langchain-oracledb 0.2.0 → 1.1.0

package/dist/errors.d.ts

@@ -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 {};

package/dist/errors.js

@@ -0,0 +1,113 @@
+var _a;
+export const 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.
+ */
+export 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;
+    }
+}
+_a = LANGCHAIN_ORACLE_ERROR_BRAND;
+export 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(ErrorCode.SYSTEM_ERROR, error, `An unexpected error occurred during the operation. ${details}`);
+}
+export function createError(code, message, cause) {
+    return new LangChainOracleError(code, message, cause);
+}
+// Identifies LangChainOracleError instances created by this package, not generic
+// node-oracledb or database errors such as NJS- or ORA- codes.
+export function isLangChainOracleError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        LANGCHAIN_ORACLE_ERROR_BRAND in error);
+}
+const errorMessageFactories = {
+    [ErrorCode.VALIDATION_INVALID_INPUT]: (message) => message,
+    [ErrorCode.VALIDATION_MISSING_REQUIRED_PARAMETER]: (parameter) => `${parameter} parameter is required...`,
+    [ErrorCode.VALIDATION_INVALID_IDENTIFIER]: (identifier) => `Identifier name ${identifier} is not valid.`,
+    [ErrorCode.FILTER_INVALID_METADATA_KEY]: (column) => `Invalid metadata key '${String(column)}'. Only letters, numbers, underscores, nesting via '.', and array wildcards '[*]' are allowed.`,
+    [ErrorCode.FILTER_INVALID_VALUE]: (message) => message,
+    [ErrorCode.FILTER_UNSUPPORTED_OPERATOR]: (operator) => `Unsupported operator: ${operator}`,
+    [ErrorCode.VECTOR_INVALID_CONFIGURATION]: (message) => message,
+    [ErrorCode.VECTOR_INVALID_VALUE]: (message) => message,
+    [ErrorCode.VECTOR_UNSUPPORTED_REPRESENTATION]: (message) => message,
+    [ErrorCode.VECTOR_INVALID_INDEX_PARAMETERS]: (invalidKeys) => `Invalid parameter(s): ${invalidKeys.join(", ")}`,
+    [ErrorCode.STATE_INVALID]: (message) => message,
+    [ErrorCode.QUERY_NO_ROWS_FOUND]: () => "No rows found.",
+    [ErrorCode.CACHE_DESERIALIZATION_FAILED]: () => "Failed to deserialize cached generations.",
+    [ErrorCode.HISTORY_DESERIALIZATION_FAILED]: () => "Failed to deserialize a stored history message.",
+    [ErrorCode.HISTORY_REPLACEMENT_FAILED]: () => "Failed to replace stored history messages.",
+    [ErrorCode.SYSTEM_ERROR]: (message) => message,
+};
+function getErrorMessage(code, ...args) {
+    return errorMessageFactories[code](...args);
+}
+export function createErrorFromCode(code, ...args) {
+    return createError(code, getErrorMessage(code, ...args));
+}
+export function createErrorFromCodeWithCause(code, cause, ...args) {
+    return createError(code, getErrorMessage(code, ...args), cause);
+}
+export function throwError(code, ...args) {
+    throw createErrorFromCode(code, ...args);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.cjs

@@ -14,9 +14,20 @@ 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.throwError = exports.isLangChainOracleError = exports.createErrorFromCodeWithCause = exports.createErrorFromCode = exports.createError = exports.LangChainOracleError = exports.ErrorCode = void 0;
 __exportStar(require("./document_loaders.cjs"), exports);
 __exportStar(require("./embeddings.cjs"), exports);
+var errors_js_1 = require("./errors.cjs");
+Object.defineProperty(exports, "ErrorCode", { enumerable: true, get: function () { return errors_js_1.ErrorCode; } });
+Object.defineProperty(exports, "LangChainOracleError", { enumerable: true, get: function () { return errors_js_1.LangChainOracleError; } });
+Object.defineProperty(exports, "createError", { enumerable: true, get: function () { return errors_js_1.createError; } });
+Object.defineProperty(exports, "createErrorFromCode", { enumerable: true, get: function () { return errors_js_1.createErrorFromCode; } });
+Object.defineProperty(exports, "createErrorFromCodeWithCause", { enumerable: true, get: function () { return errors_js_1.createErrorFromCodeWithCause; } });
+Object.defineProperty(exports, "isLangChainOracleError", { enumerable: true, get: function () { return errors_js_1.isLangChainOracleError; } });
+Object.defineProperty(exports, "throwError", { enumerable: true, get: function () { return errors_js_1.throwError; } });
 __exportStar(require("./summary.cjs"), exports);
 __exportStar(require("./text_splitter.cjs"), exports);
 __exportStar(require("./vectorstores.cjs"), exports);
+__exportStar(require("./chatMessageHistories.cjs"), exports);
+__exportStar(require("./cache.cjs"), exports);
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,kDAAgC;AAChC,+CAA6B;AAC7B,qDAAmC;AACnC,oDAAkC"}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,kDAAgC;AAChC,yCAQqB;AAPnB,sGAAA,SAAS,OAAA;AACT,iHAAA,oBAAoB,OAAA;AACpB,wGAAA,WAAW,OAAA;AACX,gHAAA,mBAAmB,OAAA;AACnB,yHAAA,4BAA4B,OAAA;AAC5B,mHAAA,sBAAsB,OAAA;AACtB,uGAAA,UAAU,OAAA;AAEZ,+CAA6B;AAC7B,qDAAmC;AACnC,oDAAkC;AAClC,4DAA0C;AAC1C,6CAA2B"}

package/dist/index.d.cts

@@ -1,5 +1,8 @@
 export * from "./document_loaders.js";
 export * from "./embeddings.js";
+export { ErrorCode, LangChainOracleError, createError, createErrorFromCode, createErrorFromCodeWithCause, isLangChainOracleError, throwError, } from "./errors.js";
 export * from "./summary.js";
 export * from "./text_splitter.js";
 export * from "./vectorstores.js";
+export * from "./chatMessageHistories.js";
+export * from "./cache.js";

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 export * from "./document_loaders.js";
 export * from "./embeddings.js";
+export { ErrorCode, LangChainOracleError, createError, createErrorFromCode, createErrorFromCodeWithCause, isLangChainOracleError, throwError, } from "./errors.js";
 export * from "./summary.js";
 export * from "./text_splitter.js";
 export * from "./vectorstores.js";
+export * from "./chatMessageHistories.js";
+export * from "./cache.js";

package/dist/index.js

@@ -1,6 +1,9 @@
 export * from "./document_loaders.js";
 export * from "./embeddings.js";
+export { ErrorCode, LangChainOracleError, createError, createErrorFromCode, createErrorFromCodeWithCause, isLangChainOracleError, throwError, } from "./errors.js";
 export * from "./summary.js";
 export * from "./text_splitter.js";
 export * from "./vectorstores.js";
+export * from "./chatMessageHistories.js";
+export * from "./cache.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,4BAA4B,EAC5B,sBAAsB,EACtB,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC"}

package/dist/utils.cjs

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quoteIdentifier = exports.withConnection = void 0;
+const errors_js_1 = require("./errors.cjs");
+async function withConnection(dbSource, fn) {
+    if (dbSource == null) {
+        (0, errors_js_1.throwError)(errors_js_1.ErrorCode.VALIDATION_MISSING_REQUIRED_PARAMETER, "client");
+    }
+    const client = typeof dbSource === "function" ? await dbSource() : dbSource;
+    const isPool = "getConnection" in client;
+    const connection = isPool ? await client.getConnection() : client;
+    let result;
+    try {
+        result = await fn(connection);
+    }
+    catch (error) {
+        if (isPool) {
+            try {
+                await connection.close();
+            }
+            catch (closeError) {
+                throw new AggregateError([error, closeError], "Operation failed, and connection cleanup failed.");
+            }
+        }
+        throw error;
+    }
+    if (isPool) {
+        await connection.close();
+    }
+    return result;
+}
+exports.withConnection = withConnection;
+function quoteIdentifier(identifier) {
+    const name = identifier.trim();
+    const validateRegex = /^(?:"[^"]+"|[^".]+)(?:\.(?:"[^"]+"|[^".]+))*$/;
+    if (!validateRegex.test(name)) {
+        (0, errors_js_1.throwError)(errors_js_1.ErrorCode.VALIDATION_INVALID_IDENTIFIER, identifier);
+    }
+    // Extract quoted and unquoted identifier parts.
+    const matchRegex = /"([^"]+)"|([^".]+)/g;
+    const groups = [];
+    for (const match of name.matchAll(matchRegex)) {
+        groups.push(match[1] || match[2]);
+    }
+    const quotedParts = groups.map((g) => `"${g}"`);
+    return quotedParts.join(".");
+}
+exports.quoteIdentifier = quoteIdentifier;
+//# sourceMappingURL=utils.cjs.map

package/dist/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;AACA,2CAAoD;AAQ7C,KAAK,UAAU,cAAc,CAClC,QAAiD,EACjD,EAAmD;IAEnD,IAAI,QAAQ,IAAI,IAAI,EAAE;QACpB,IAAA,sBAAU,EAAC,qBAAS,CAAC,qCAAqC,EAAE,QAAQ,CAAC,CAAC;KACvE;IACD,MAAM,MAAM,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC5E,MAAM,MAAM,GAAG,eAAe,IAAI,MAAM,CAAC;IACzC,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAElE,IAAI,MAAS,CAAC;IAEd,IAAI;QACF,MAAM,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC;KAC/B;IAAC,OAAO,KAAK,EAAE;QACd,IAAI,MAAM,EAAE;YACV,IAAI;gBACF,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;aAC1B;YAAC,OAAO,UAAU,EAAE;gBACnB,MAAM,IAAI,cAAc,CACtB,CAAC,KAAK,EAAE,UAAU,CAAC,EACnB,kDAAkD,CACnD,CAAC;aACH;SACF;QAED,MAAM,KAAK,CAAC;KACb;IAED,IAAI,MAAM,EAAE;QACV,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;KAC1B;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAnCD,wCAmCC;AAED,SAAgB,eAAe,CAAC,UAAkB;IAChD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAE/B,MAAM,aAAa,GAAG,+CAA+C,CAAC;IACtE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC7B,IAAA,sBAAU,EAAC,qBAAS,CAAC,6BAA6B,EAAE,UAAU,CAAC,CAAC;KACjE;IAED,gDAAgD;IAChD,MAAM,UAAU,GAAG,qBAAqB,CAAC;IACzC,MAAM,MAAM,GAAG,EAAE,CAAC;IAElB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE;QAC7C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KACnC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,OAAO,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAjBD,0CAiBC"}

package/dist/utils.d.cts

@@ -0,0 +1,5 @@
+import oracledb from "oracledb";
+export type OracleDBClient = oracledb.Pool | oracledb.Connection;
+export type OracleDBClientProvider = () => Promise<OracleDBClient>;
+export declare function withConnection<T>(dbSource: OracleDBClient | OracleDBClientProvider, fn: (Connection: oracledb.Connection) => Promise<T>): Promise<T>;
+export declare function quoteIdentifier(identifier: string): string;

package/dist/utils.d.ts

@@ -0,0 +1,5 @@
+import oracledb from "oracledb";
+export type OracleDBClient = oracledb.Pool | oracledb.Connection;
+export type OracleDBClientProvider = () => Promise<OracleDBClient>;
+export declare function withConnection<T>(dbSource: OracleDBClient | OracleDBClientProvider, fn: (Connection: oracledb.Connection) => Promise<T>): Promise<T>;
+export declare function quoteIdentifier(identifier: string): string;

package/dist/utils.js

@@ -0,0 +1,44 @@
+import { ErrorCode, throwError } from "./errors.js";
+export async function withConnection(dbSource, fn) {
+    if (dbSource == null) {
+        throwError(ErrorCode.VALIDATION_MISSING_REQUIRED_PARAMETER, "client");
+    }
+    const client = typeof dbSource === "function" ? await dbSource() : dbSource;
+    const isPool = "getConnection" in client;
+    const connection = isPool ? await client.getConnection() : client;
+    let result;
+    try {
+        result = await fn(connection);
+    }
+    catch (error) {
+        if (isPool) {
+            try {
+                await connection.close();
+            }
+            catch (closeError) {
+                throw new AggregateError([error, closeError], "Operation failed, and connection cleanup failed.");
+            }
+        }
+        throw error;
+    }
+    if (isPool) {
+        await connection.close();
+    }
+    return result;
+}
+export function quoteIdentifier(identifier) {
+    const name = identifier.trim();
+    const validateRegex = /^(?:"[^"]+"|[^".]+)(?:\.(?:"[^"]+"|[^".]+))*$/;
+    if (!validateRegex.test(name)) {
+        throwError(ErrorCode.VALIDATION_INVALID_IDENTIFIER, identifier);
+    }
+    // Extract quoted and unquoted identifier parts.
+    const matchRegex = /"([^"]+)"|([^".]+)/g;
+    const groups = [];
+    for (const match of name.matchAll(matchRegex)) {
+        groups.push(match[1] || match[2]);
+    }
+    const quotedParts = groups.map((g) => `"${g}"`);
+    return quotedParts.join(".");
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQpD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAiD,EACjD,EAAmD;IAEnD,IAAI,QAAQ,IAAI,IAAI,EAAE;QACpB,UAAU,CAAC,SAAS,CAAC,qCAAqC,EAAE,QAAQ,CAAC,CAAC;KACvE;IACD,MAAM,MAAM,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC5E,MAAM,MAAM,GAAG,eAAe,IAAI,MAAM,CAAC;IACzC,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAElE,IAAI,MAAS,CAAC;IAEd,IAAI;QACF,MAAM,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC;KAC/B;IAAC,OAAO,KAAK,EAAE;QACd,IAAI,MAAM,EAAE;YACV,IAAI;gBACF,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;aAC1B;YAAC,OAAO,UAAU,EAAE;gBACnB,MAAM,IAAI,cAAc,CACtB,CAAC,KAAK,EAAE,UAAU,CAAC,EACnB,kDAAkD,CACnD,CAAC;aACH;SACF;QAED,MAAM,KAAK,CAAC;KACb;IAED,IAAI,MAAM,EAAE;QACV,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;KAC1B;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAE/B,MAAM,aAAa,GAAG,+CAA+C,CAAC;IACtE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC7B,UAAU,CAAC,SAAS,CAAC,6BAA6B,EAAE,UAAU,CAAC,CAAC;KACjE;IAED,gDAAgD;IAChD,MAAM,UAAU,GAAG,qBAAqB,CAAC;IACzC,MAAM,MAAM,GAAG,EAAE,CAAC;IAElB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE;QAC7C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KACnC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,OAAO,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC"}