@oracle/langchain-oracledb 0.2.0 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +7 -1
- package/dist/document_loaders.cjs +4 -3
- package/dist/document_loaders.cjs.map +1 -1
- package/dist/document_loaders.js +4 -3
- package/dist/document_loaders.js.map +1 -1
- package/dist/errors.cjs +99 -0
- package/dist/errors.cjs.map +1 -0
- package/dist/errors.d.cts +50 -0
- package/dist/errors.d.ts +50 -0
- package/dist/errors.js +90 -0
- package/dist/errors.js.map +1 -0
- package/dist/index.cjs +1 -0
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +1 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/vectorstores.cjs +100 -60
- package/dist/vectorstores.cjs.map +1 -1
- package/dist/vectorstores.d.cts +10 -3
- package/dist/vectorstores.d.ts +10 -3
- package/dist/vectorstores.js +97 -59
- package/dist/vectorstores.js.map +1 -1
- package/package.json +24 -23
package/README.md
CHANGED
|
@@ -1,7 +1,13 @@
|
|
|
1
1
|
# @oracle/langchain-oracledb
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/@oracle/langchain-oracledb)
|
|
4
|
+
[](https://www.npmjs.com/package/@oracle/langchain-oracledb)
|
|
5
|
+
[](https://github.com/oracle/langchain-oracle/blob/main/libs/js/langchain-oracledb/LICENSE)
|
|
6
|
+
|
|
3
7
|
This package contains the LangChain.js integrations for Oracle Database.
|
|
4
8
|
|
|
9
|
+
> ⭐ If this package is useful to you, consider [starring the repository](https://github.com/oracle/langchain-oracle) — it helps other developers discover these integrations.
|
|
10
|
+
|
|
5
11
|
## Installation
|
|
6
12
|
|
|
7
13
|
```bash npm2yarn
|
|
@@ -17,7 +23,7 @@ You can do so by adding an appropriate field to your project's `package.json` li
|
|
|
17
23
|
"name": "your-project",
|
|
18
24
|
"version": "0.1.0",
|
|
19
25
|
"dependencies": {
|
|
20
|
-
"@oracle/langchain-oracledb": "^0.
|
|
26
|
+
"@oracle/langchain-oracledb": "^1.0.0",
|
|
21
27
|
"@langchain/core": "^1.0.0"
|
|
22
28
|
},
|
|
23
29
|
"resolutions": {
|
|
@@ -35,6 +35,7 @@ const node_path_1 = __importDefault(require("node:path"));
|
|
|
35
35
|
const oracledb_1 = __importDefault(require("oracledb"));
|
|
36
36
|
const htmlparser2 = __importStar(require("htmlparser2"));
|
|
37
37
|
const base_1 = require("@langchain/core/document_loaders/base");
|
|
38
|
+
const errors_js_1 = require("./errors.cjs");
|
|
38
39
|
function* listDir(dir) {
|
|
39
40
|
const files = node_fs_1.default.readdirSync(dir, { withFileTypes: true });
|
|
40
41
|
for (const file of files) {
|
|
@@ -103,12 +104,12 @@ class OracleDocLoader extends base_1.BaseDocumentLoader {
|
|
|
103
104
|
}
|
|
104
105
|
else if ("tablename" in this.pref) {
|
|
105
106
|
if (!("owner" in this.pref) || !("colname" in this.pref)) {
|
|
106
|
-
|
|
107
|
+
(0, errors_js_1.throwError)(errors_js_1.ErrorCode.VALIDATION_INVALID_INPUT, "Invalid preferences: missing owner or colname");
|
|
107
108
|
}
|
|
108
109
|
docs.push(...(await this._loadFromTable(this.pref.owner, this.pref.tablename, this.pref.colname)));
|
|
109
110
|
}
|
|
110
111
|
else {
|
|
111
|
-
|
|
112
|
+
(0, errors_js_1.throwError)(errors_js_1.ErrorCode.VALIDATION_INVALID_INPUT, "Invalid preferences: missing file, dir, or tablename");
|
|
112
113
|
}
|
|
113
114
|
return docs;
|
|
114
115
|
}
|
|
@@ -159,7 +160,7 @@ class OracleDocLoader extends base_1.BaseDocumentLoader {
|
|
|
159
160
|
await this.conn.execute(sql, binds);
|
|
160
161
|
}
|
|
161
162
|
catch {
|
|
162
|
-
|
|
163
|
+
(0, errors_js_1.throwError)(errors_js_1.ErrorCode.VALIDATION_INVALID_IDENTIFIER, `${owner}.${table}.${col}`);
|
|
163
164
|
}
|
|
164
165
|
const result = await this.conn.execute((`select dbms_vector_chain.utl_to_text(t.${this.pref.colname}, :pref) text,\
|
|
165
166
|
dbms_vector_chain.utl_to_text(t.${this.pref.colname}, json('{"plaintext": "false"}')) metadata\
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"document_loaders.cjs","sourceRoot":"","sources":["../src/document_loaders.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,sDAAsD;AACtD,uDAAuD;AACvD,yDAAqD;AACrD,sDAAyB;AACzB,0DAA6B;AAC7B,wDAAgC;AAChC,yDAA2C;AAC3C,gEAA2E;
|
|
1
|
+
{"version":3,"file":"document_loaders.cjs","sourceRoot":"","sources":["../src/document_loaders.ts"],"names":[],"mappings":"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"}
|
package/dist/document_loaders.js
CHANGED
|
@@ -6,6 +6,7 @@ import path from "node:path";
|
|
|
6
6
|
import oracledb from "oracledb";
|
|
7
7
|
import * as htmlparser2 from "htmlparser2";
|
|
8
8
|
import { BaseDocumentLoader } from "@langchain/core/document_loaders/base";
|
|
9
|
+
import { ErrorCode, throwError } from "./errors.js";
|
|
9
10
|
function* listDir(dir) {
|
|
10
11
|
const files = fs.readdirSync(dir, { withFileTypes: true });
|
|
11
12
|
for (const file of files) {
|
|
@@ -74,12 +75,12 @@ export class OracleDocLoader extends BaseDocumentLoader {
|
|
|
74
75
|
}
|
|
75
76
|
else if ("tablename" in this.pref) {
|
|
76
77
|
if (!("owner" in this.pref) || !("colname" in this.pref)) {
|
|
77
|
-
|
|
78
|
+
throwError(ErrorCode.VALIDATION_INVALID_INPUT, "Invalid preferences: missing owner or colname");
|
|
78
79
|
}
|
|
79
80
|
docs.push(...(await this._loadFromTable(this.pref.owner, this.pref.tablename, this.pref.colname)));
|
|
80
81
|
}
|
|
81
82
|
else {
|
|
82
|
-
|
|
83
|
+
throwError(ErrorCode.VALIDATION_INVALID_INPUT, "Invalid preferences: missing file, dir, or tablename");
|
|
83
84
|
}
|
|
84
85
|
return docs;
|
|
85
86
|
}
|
|
@@ -130,7 +131,7 @@ export class OracleDocLoader extends BaseDocumentLoader {
|
|
|
130
131
|
await this.conn.execute(sql, binds);
|
|
131
132
|
}
|
|
132
133
|
catch {
|
|
133
|
-
|
|
134
|
+
throwError(ErrorCode.VALIDATION_INVALID_IDENTIFIER, `${owner}.${table}.${col}`);
|
|
134
135
|
}
|
|
135
136
|
const result = await this.conn.execute((`select dbms_vector_chain.utl_to_text(t.${this.pref.colname}, :pref) text,\
|
|
136
137
|
dbms_vector_chain.utl_to_text(t.${this.pref.colname}, json('{"plaintext": "false"}')) metadata\
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"document_loaders.js","sourceRoot":"","sources":["../src/document_loaders.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,uDAAuD;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,WAAW,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;
|
|
1
|
+
{"version":3,"file":"document_loaders.js","sourceRoot":"","sources":["../src/document_loaders.ts"],"names":[],"mappings":"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"}
|
package/dist/errors.cjs
ADDED
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var _a;
|
|
3
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
4
|
+
exports.throwError = exports.createErrorFromCodeWithCause = exports.createErrorFromCode = exports.isLangChainOracleError = exports.createError = exports.LangChainOracleError = exports.ErrorCode = void 0;
|
|
5
|
+
exports.ErrorCode = {
|
|
6
|
+
VALIDATION_INVALID_INPUT: "VALIDATION_INVALID_INPUT",
|
|
7
|
+
VALIDATION_MISSING_REQUIRED_PARAMETER: "VALIDATION_MISSING_REQUIRED_PARAMETER",
|
|
8
|
+
VALIDATION_INVALID_IDENTIFIER: "VALIDATION_INVALID_IDENTIFIER",
|
|
9
|
+
FILTER_INVALID_METADATA_KEY: "FILTER_INVALID_METADATA_KEY",
|
|
10
|
+
FILTER_INVALID_VALUE: "FILTER_INVALID_VALUE",
|
|
11
|
+
FILTER_UNSUPPORTED_OPERATOR: "FILTER_UNSUPPORTED_OPERATOR",
|
|
12
|
+
VECTOR_INVALID_CONFIGURATION: "VECTOR_INVALID_CONFIGURATION",
|
|
13
|
+
VECTOR_INVALID_VALUE: "VECTOR_INVALID_VALUE",
|
|
14
|
+
VECTOR_UNSUPPORTED_REPRESENTATION: "VECTOR_UNSUPPORTED_REPRESENTATION",
|
|
15
|
+
VECTOR_INVALID_INDEX_PARAMETERS: "VECTOR_INVALID_INDEX_PARAMETERS",
|
|
16
|
+
STATE_INVALID: "STATE_INVALID",
|
|
17
|
+
QUERY_NO_ROWS_FOUND: "QUERY_NO_ROWS_FOUND",
|
|
18
|
+
SYSTEM_ERROR: "SYSTEM_ERROR",
|
|
19
|
+
};
|
|
20
|
+
const LANGCHAIN_ORACLE_ERROR_BRAND = Symbol.for("@oracle/langchain-oracledb/LangChainOracleError");
|
|
21
|
+
/**
|
|
22
|
+
* A specialized exception representing domain-specific failures within the
|
|
23
|
+
* LangChain Oracle integration. Extends the native JavaScript `Error` to preserve
|
|
24
|
+
* stack traces. Lower-level driver errors are safely isolated inside the `cause`
|
|
25
|
+
* property to protect against shifting node-oracledb definitions.
|
|
26
|
+
*/
|
|
27
|
+
class LangChainOracleError extends Error {
|
|
28
|
+
constructor(code, message, cause) {
|
|
29
|
+
super(message);
|
|
30
|
+
Object.defineProperty(this, "code", {
|
|
31
|
+
enumerable: true,
|
|
32
|
+
configurable: true,
|
|
33
|
+
writable: true,
|
|
34
|
+
value: void 0
|
|
35
|
+
});
|
|
36
|
+
Object.defineProperty(this, "cause", {
|
|
37
|
+
enumerable: true,
|
|
38
|
+
configurable: true,
|
|
39
|
+
writable: true,
|
|
40
|
+
value: void 0
|
|
41
|
+
});
|
|
42
|
+
Object.defineProperty(this, _a, {
|
|
43
|
+
enumerable: true,
|
|
44
|
+
configurable: true,
|
|
45
|
+
writable: true,
|
|
46
|
+
value: true
|
|
47
|
+
});
|
|
48
|
+
// Hardcode the class name so logs show "LangChainOracleError: ..."
|
|
49
|
+
this.name = "LangChainOracleError";
|
|
50
|
+
this.code = code;
|
|
51
|
+
// Save the raw node-oracledb error (or validation error) for root-cause analysis
|
|
52
|
+
this.cause = cause;
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
exports.LangChainOracleError = LangChainOracleError;
|
|
56
|
+
_a = LANGCHAIN_ORACLE_ERROR_BRAND;
|
|
57
|
+
function createError(code, message, cause) {
|
|
58
|
+
return new LangChainOracleError(code, message, cause);
|
|
59
|
+
}
|
|
60
|
+
exports.createError = createError;
|
|
61
|
+
// Identifies LangChainOracleError instances created by this package, not generic
|
|
62
|
+
// node-oracledb or database errors such as NJS- or ORA- codes.
|
|
63
|
+
function isLangChainOracleError(error) {
|
|
64
|
+
return (typeof error === "object" &&
|
|
65
|
+
error !== null &&
|
|
66
|
+
LANGCHAIN_ORACLE_ERROR_BRAND in error);
|
|
67
|
+
}
|
|
68
|
+
exports.isLangChainOracleError = isLangChainOracleError;
|
|
69
|
+
const errorMessageFactories = {
|
|
70
|
+
[exports.ErrorCode.VALIDATION_INVALID_INPUT]: (message) => message,
|
|
71
|
+
[exports.ErrorCode.VALIDATION_MISSING_REQUIRED_PARAMETER]: (parameter) => `${parameter} parameter is required...`,
|
|
72
|
+
[exports.ErrorCode.VALIDATION_INVALID_IDENTIFIER]: (identifier) => `Identifier name ${identifier} is not valid.`,
|
|
73
|
+
[exports.ErrorCode.FILTER_INVALID_METADATA_KEY]: (column) => `Invalid metadata key '${String(column)}'. Only letters, numbers, underscores, nesting via '.', and array wildcards '[*]' are allowed.`,
|
|
74
|
+
[exports.ErrorCode.FILTER_INVALID_VALUE]: (message) => message,
|
|
75
|
+
[exports.ErrorCode.FILTER_UNSUPPORTED_OPERATOR]: (operator) => `Unsupported operator: ${operator}`,
|
|
76
|
+
[exports.ErrorCode.VECTOR_INVALID_CONFIGURATION]: (message) => message,
|
|
77
|
+
[exports.ErrorCode.VECTOR_INVALID_VALUE]: (message) => message,
|
|
78
|
+
[exports.ErrorCode.VECTOR_UNSUPPORTED_REPRESENTATION]: (message) => message,
|
|
79
|
+
[exports.ErrorCode.VECTOR_INVALID_INDEX_PARAMETERS]: (invalidKeys) => `Invalid parameter(s): ${invalidKeys.join(", ")}`,
|
|
80
|
+
[exports.ErrorCode.STATE_INVALID]: (message) => message,
|
|
81
|
+
[exports.ErrorCode.QUERY_NO_ROWS_FOUND]: () => "No rows found.",
|
|
82
|
+
[exports.ErrorCode.SYSTEM_ERROR]: (message) => message,
|
|
83
|
+
};
|
|
84
|
+
function getErrorMessage(code, ...args) {
|
|
85
|
+
return errorMessageFactories[code](...args);
|
|
86
|
+
}
|
|
87
|
+
function createErrorFromCode(code, ...args) {
|
|
88
|
+
return createError(code, getErrorMessage(code, ...args));
|
|
89
|
+
}
|
|
90
|
+
exports.createErrorFromCode = createErrorFromCode;
|
|
91
|
+
function createErrorFromCodeWithCause(code, cause, ...args) {
|
|
92
|
+
return createError(code, getErrorMessage(code, ...args), cause);
|
|
93
|
+
}
|
|
94
|
+
exports.createErrorFromCodeWithCause = createErrorFromCodeWithCause;
|
|
95
|
+
function throwError(code, ...args) {
|
|
96
|
+
throw createErrorFromCode(code, ...args);
|
|
97
|
+
}
|
|
98
|
+
exports.throwError = throwError;
|
|
99
|
+
//# sourceMappingURL=errors.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.cjs","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;;AAAa,QAAA,SAAS,GAAG;IACvB,wBAAwB,EAAE,0BAA0B;IACpD,qCAAqC,EACnC,uCAAuC;IACzC,6BAA6B,EAAE,+BAA+B;IAC9D,2BAA2B,EAAE,6BAA6B;IAC1D,oBAAoB,EAAE,sBAAsB;IAC5C,2BAA2B,EAAE,6BAA6B;IAC1D,4BAA4B,EAAE,8BAA8B;IAC5D,oBAAoB,EAAE,sBAAsB;IAC5C,iCAAiC,EAAE,mCAAmC;IACtE,+BAA+B,EAAE,iCAAiC;IAClE,aAAa,EAAE,eAAe;IAC9B,mBAAmB,EAAE,qBAAqB;IAC1C,YAAY,EAAE,cAAc;CACpB,CAAC;AAKX,MAAM,4BAA4B,GAAG,MAAM,CAAC,GAAG,CAC7C,iDAAiD,CAClD,CAAC;AAkBF;;;;;GAKG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAO7C,YAAY,IAAe,EAAE,OAAe,EAAE,KAAe;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAPR;;;;;WAAgB;QAEhB;;;;;WAAgB;QAEhB;;;;mBAAiC,IAAI;WAAC;QAK7C,mEAAmE;QACnE,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,iFAAiF;QACjF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAjBD,oDAiBC;KAZW,4BAA4B;AAcxC,SAAgB,WAAW,CACzB,IAAe,EACf,OAAe,EACf,KAAe;IAEf,OAAO,IAAI,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC;AAND,kCAMC;AAED,iFAAiF;AACjF,+DAA+D;AAC/D,SAAgB,sBAAsB,CACpC,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,4BAA4B,IAAI,KAAK,CACtC,CAAC;AACJ,CAAC;AARD,wDAQC;AAED,MAAM,qBAAqB,GAEvB;IACF,CAAC,iBAAS,CAAC,wBAAwB,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;IAC1D,CAAC,iBAAS,CAAC,qCAAqC,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,CAC/D,GAAG,SAAS,2BAA2B;IACzC,CAAC,iBAAS,CAAC,6BAA6B,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,CACxD,mBAAmB,UAAU,gBAAgB;IAC/C,CAAC,iBAAS,CAAC,2BAA2B,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAClD,yBAAyB,MAAM,CAAC,MAAM,CAAC,gGAAgG;IACzI,CAAC,iBAAS,CAAC,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;IACtD,CAAC,iBAAS,CAAC,2BAA2B,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CACpD,yBAAyB,QAAQ,EAAE;IACrC,CAAC,iBAAS,CAAC,4BAA4B,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;IAC9D,CAAC,iBAAS,CAAC,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;IACtD,CAAC,iBAAS,CAAC,iCAAiC,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;IACnE,CAAC,iBAAS,CAAC,+BAA+B,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,CAC3D,yBAAyB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;IACnD,CAAC,iBAAS,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;IAC/C,CAAC,iBAAS,CAAC,mBAAmB,CAAC,EAAE,GAAG,EAAE,CAAC,gBAAgB;IACvD,CAAC,iBAAS,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;CAC/C,CAAC;AAEF,SAAS,eAAe,CACtB,IAAO,EACP,GAAG,IAAkB;IAErB,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,SAAgB,mBAAmB,CACjC,IAAO,EACP,GAAG,IAAkB;IAErB,OAAO,WAAW,CAAC,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;AAC3D,CAAC;AALD,kDAKC;AAED,SAAgB,4BAA4B,CAC1C,IAAO,EACP,KAAc,EACd,GAAG,IAAkB;IAErB,OAAO,WAAW,CAAC,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;AAClE,CAAC;AAND,oEAMC;AAED,SAAgB,UAAU,CACxB,IAAO,EACP,GAAG,IAAkB;IAErB,MAAM,mBAAmB,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;AAC3C,CAAC;AALD,gCAKC"}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
export declare const ErrorCode: {
|
|
2
|
+
readonly VALIDATION_INVALID_INPUT: "VALIDATION_INVALID_INPUT";
|
|
3
|
+
readonly VALIDATION_MISSING_REQUIRED_PARAMETER: "VALIDATION_MISSING_REQUIRED_PARAMETER";
|
|
4
|
+
readonly VALIDATION_INVALID_IDENTIFIER: "VALIDATION_INVALID_IDENTIFIER";
|
|
5
|
+
readonly FILTER_INVALID_METADATA_KEY: "FILTER_INVALID_METADATA_KEY";
|
|
6
|
+
readonly FILTER_INVALID_VALUE: "FILTER_INVALID_VALUE";
|
|
7
|
+
readonly FILTER_UNSUPPORTED_OPERATOR: "FILTER_UNSUPPORTED_OPERATOR";
|
|
8
|
+
readonly VECTOR_INVALID_CONFIGURATION: "VECTOR_INVALID_CONFIGURATION";
|
|
9
|
+
readonly VECTOR_INVALID_VALUE: "VECTOR_INVALID_VALUE";
|
|
10
|
+
readonly VECTOR_UNSUPPORTED_REPRESENTATION: "VECTOR_UNSUPPORTED_REPRESENTATION";
|
|
11
|
+
readonly VECTOR_INVALID_INDEX_PARAMETERS: "VECTOR_INVALID_INDEX_PARAMETERS";
|
|
12
|
+
readonly STATE_INVALID: "STATE_INVALID";
|
|
13
|
+
readonly QUERY_NO_ROWS_FOUND: "QUERY_NO_ROWS_FOUND";
|
|
14
|
+
readonly SYSTEM_ERROR: "SYSTEM_ERROR";
|
|
15
|
+
};
|
|
16
|
+
export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
|
|
17
|
+
declare const LANGCHAIN_ORACLE_ERROR_BRAND: unique symbol;
|
|
18
|
+
type ErrorArgs = {
|
|
19
|
+
[ErrorCode.VALIDATION_INVALID_INPUT]: [message: string];
|
|
20
|
+
[ErrorCode.VALIDATION_MISSING_REQUIRED_PARAMETER]: [parameter: string];
|
|
21
|
+
[ErrorCode.VALIDATION_INVALID_IDENTIFIER]: [identifier: string];
|
|
22
|
+
[ErrorCode.FILTER_INVALID_METADATA_KEY]: [column: string];
|
|
23
|
+
[ErrorCode.FILTER_INVALID_VALUE]: [message: string];
|
|
24
|
+
[ErrorCode.FILTER_UNSUPPORTED_OPERATOR]: [operator: string];
|
|
25
|
+
[ErrorCode.VECTOR_INVALID_CONFIGURATION]: [message: string];
|
|
26
|
+
[ErrorCode.VECTOR_INVALID_VALUE]: [message: string];
|
|
27
|
+
[ErrorCode.VECTOR_UNSUPPORTED_REPRESENTATION]: [message: string];
|
|
28
|
+
[ErrorCode.VECTOR_INVALID_INDEX_PARAMETERS]: [invalidKeys: string[]];
|
|
29
|
+
[ErrorCode.STATE_INVALID]: [message: string];
|
|
30
|
+
[ErrorCode.QUERY_NO_ROWS_FOUND]: [];
|
|
31
|
+
[ErrorCode.SYSTEM_ERROR]: [message: string];
|
|
32
|
+
};
|
|
33
|
+
/**
|
|
34
|
+
* A specialized exception representing domain-specific failures within the
|
|
35
|
+
* LangChain Oracle integration. Extends the native JavaScript `Error` to preserve
|
|
36
|
+
* stack traces. Lower-level driver errors are safely isolated inside the `cause`
|
|
37
|
+
* property to protect against shifting node-oracledb definitions.
|
|
38
|
+
*/
|
|
39
|
+
export declare class LangChainOracleError extends Error {
|
|
40
|
+
readonly code: ErrorCode;
|
|
41
|
+
readonly cause?: unknown;
|
|
42
|
+
readonly [LANGCHAIN_ORACLE_ERROR_BRAND] = true;
|
|
43
|
+
constructor(code: ErrorCode, message: string, cause?: unknown);
|
|
44
|
+
}
|
|
45
|
+
export declare function createError(code: ErrorCode, message: string, cause?: unknown): LangChainOracleError;
|
|
46
|
+
export declare function isLangChainOracleError(error: unknown): error is LangChainOracleError;
|
|
47
|
+
export declare function createErrorFromCode<K extends ErrorCode>(code: K, ...args: ErrorArgs[K]): LangChainOracleError;
|
|
48
|
+
export declare function createErrorFromCodeWithCause<K extends ErrorCode>(code: K, cause: unknown, ...args: ErrorArgs[K]): LangChainOracleError;
|
|
49
|
+
export declare function throwError<K extends ErrorCode>(code: K, ...args: ErrorArgs[K]): never;
|
|
50
|
+
export {};
|
package/dist/errors.d.ts
ADDED
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
export declare const ErrorCode: {
|
|
2
|
+
readonly VALIDATION_INVALID_INPUT: "VALIDATION_INVALID_INPUT";
|
|
3
|
+
readonly VALIDATION_MISSING_REQUIRED_PARAMETER: "VALIDATION_MISSING_REQUIRED_PARAMETER";
|
|
4
|
+
readonly VALIDATION_INVALID_IDENTIFIER: "VALIDATION_INVALID_IDENTIFIER";
|
|
5
|
+
readonly FILTER_INVALID_METADATA_KEY: "FILTER_INVALID_METADATA_KEY";
|
|
6
|
+
readonly FILTER_INVALID_VALUE: "FILTER_INVALID_VALUE";
|
|
7
|
+
readonly FILTER_UNSUPPORTED_OPERATOR: "FILTER_UNSUPPORTED_OPERATOR";
|
|
8
|
+
readonly VECTOR_INVALID_CONFIGURATION: "VECTOR_INVALID_CONFIGURATION";
|
|
9
|
+
readonly VECTOR_INVALID_VALUE: "VECTOR_INVALID_VALUE";
|
|
10
|
+
readonly VECTOR_UNSUPPORTED_REPRESENTATION: "VECTOR_UNSUPPORTED_REPRESENTATION";
|
|
11
|
+
readonly VECTOR_INVALID_INDEX_PARAMETERS: "VECTOR_INVALID_INDEX_PARAMETERS";
|
|
12
|
+
readonly STATE_INVALID: "STATE_INVALID";
|
|
13
|
+
readonly QUERY_NO_ROWS_FOUND: "QUERY_NO_ROWS_FOUND";
|
|
14
|
+
readonly SYSTEM_ERROR: "SYSTEM_ERROR";
|
|
15
|
+
};
|
|
16
|
+
export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
|
|
17
|
+
declare const LANGCHAIN_ORACLE_ERROR_BRAND: unique symbol;
|
|
18
|
+
type ErrorArgs = {
|
|
19
|
+
[ErrorCode.VALIDATION_INVALID_INPUT]: [message: string];
|
|
20
|
+
[ErrorCode.VALIDATION_MISSING_REQUIRED_PARAMETER]: [parameter: string];
|
|
21
|
+
[ErrorCode.VALIDATION_INVALID_IDENTIFIER]: [identifier: string];
|
|
22
|
+
[ErrorCode.FILTER_INVALID_METADATA_KEY]: [column: string];
|
|
23
|
+
[ErrorCode.FILTER_INVALID_VALUE]: [message: string];
|
|
24
|
+
[ErrorCode.FILTER_UNSUPPORTED_OPERATOR]: [operator: string];
|
|
25
|
+
[ErrorCode.VECTOR_INVALID_CONFIGURATION]: [message: string];
|
|
26
|
+
[ErrorCode.VECTOR_INVALID_VALUE]: [message: string];
|
|
27
|
+
[ErrorCode.VECTOR_UNSUPPORTED_REPRESENTATION]: [message: string];
|
|
28
|
+
[ErrorCode.VECTOR_INVALID_INDEX_PARAMETERS]: [invalidKeys: string[]];
|
|
29
|
+
[ErrorCode.STATE_INVALID]: [message: string];
|
|
30
|
+
[ErrorCode.QUERY_NO_ROWS_FOUND]: [];
|
|
31
|
+
[ErrorCode.SYSTEM_ERROR]: [message: string];
|
|
32
|
+
};
|
|
33
|
+
/**
|
|
34
|
+
* A specialized exception representing domain-specific failures within the
|
|
35
|
+
* LangChain Oracle integration. Extends the native JavaScript `Error` to preserve
|
|
36
|
+
* stack traces. Lower-level driver errors are safely isolated inside the `cause`
|
|
37
|
+
* property to protect against shifting node-oracledb definitions.
|
|
38
|
+
*/
|
|
39
|
+
export declare class LangChainOracleError extends Error {
|
|
40
|
+
readonly code: ErrorCode;
|
|
41
|
+
readonly cause?: unknown;
|
|
42
|
+
readonly [LANGCHAIN_ORACLE_ERROR_BRAND] = true;
|
|
43
|
+
constructor(code: ErrorCode, message: string, cause?: unknown);
|
|
44
|
+
}
|
|
45
|
+
export declare function createError(code: ErrorCode, message: string, cause?: unknown): LangChainOracleError;
|
|
46
|
+
export declare function isLangChainOracleError(error: unknown): error is LangChainOracleError;
|
|
47
|
+
export declare function createErrorFromCode<K extends ErrorCode>(code: K, ...args: ErrorArgs[K]): LangChainOracleError;
|
|
48
|
+
export declare function createErrorFromCodeWithCause<K extends ErrorCode>(code: K, cause: unknown, ...args: ErrorArgs[K]): LangChainOracleError;
|
|
49
|
+
export declare function throwError<K extends ErrorCode>(code: K, ...args: ErrorArgs[K]): never;
|
|
50
|
+
export {};
|
package/dist/errors.js
ADDED
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
var _a;
|
|
2
|
+
export const ErrorCode = {
|
|
3
|
+
VALIDATION_INVALID_INPUT: "VALIDATION_INVALID_INPUT",
|
|
4
|
+
VALIDATION_MISSING_REQUIRED_PARAMETER: "VALIDATION_MISSING_REQUIRED_PARAMETER",
|
|
5
|
+
VALIDATION_INVALID_IDENTIFIER: "VALIDATION_INVALID_IDENTIFIER",
|
|
6
|
+
FILTER_INVALID_METADATA_KEY: "FILTER_INVALID_METADATA_KEY",
|
|
7
|
+
FILTER_INVALID_VALUE: "FILTER_INVALID_VALUE",
|
|
8
|
+
FILTER_UNSUPPORTED_OPERATOR: "FILTER_UNSUPPORTED_OPERATOR",
|
|
9
|
+
VECTOR_INVALID_CONFIGURATION: "VECTOR_INVALID_CONFIGURATION",
|
|
10
|
+
VECTOR_INVALID_VALUE: "VECTOR_INVALID_VALUE",
|
|
11
|
+
VECTOR_UNSUPPORTED_REPRESENTATION: "VECTOR_UNSUPPORTED_REPRESENTATION",
|
|
12
|
+
VECTOR_INVALID_INDEX_PARAMETERS: "VECTOR_INVALID_INDEX_PARAMETERS",
|
|
13
|
+
STATE_INVALID: "STATE_INVALID",
|
|
14
|
+
QUERY_NO_ROWS_FOUND: "QUERY_NO_ROWS_FOUND",
|
|
15
|
+
SYSTEM_ERROR: "SYSTEM_ERROR",
|
|
16
|
+
};
|
|
17
|
+
const LANGCHAIN_ORACLE_ERROR_BRAND = Symbol.for("@oracle/langchain-oracledb/LangChainOracleError");
|
|
18
|
+
/**
|
|
19
|
+
* A specialized exception representing domain-specific failures within the
|
|
20
|
+
* LangChain Oracle integration. Extends the native JavaScript `Error` to preserve
|
|
21
|
+
* stack traces. Lower-level driver errors are safely isolated inside the `cause`
|
|
22
|
+
* property to protect against shifting node-oracledb definitions.
|
|
23
|
+
*/
|
|
24
|
+
export class LangChainOracleError extends Error {
|
|
25
|
+
constructor(code, message, cause) {
|
|
26
|
+
super(message);
|
|
27
|
+
Object.defineProperty(this, "code", {
|
|
28
|
+
enumerable: true,
|
|
29
|
+
configurable: true,
|
|
30
|
+
writable: true,
|
|
31
|
+
value: void 0
|
|
32
|
+
});
|
|
33
|
+
Object.defineProperty(this, "cause", {
|
|
34
|
+
enumerable: true,
|
|
35
|
+
configurable: true,
|
|
36
|
+
writable: true,
|
|
37
|
+
value: void 0
|
|
38
|
+
});
|
|
39
|
+
Object.defineProperty(this, _a, {
|
|
40
|
+
enumerable: true,
|
|
41
|
+
configurable: true,
|
|
42
|
+
writable: true,
|
|
43
|
+
value: true
|
|
44
|
+
});
|
|
45
|
+
// Hardcode the class name so logs show "LangChainOracleError: ..."
|
|
46
|
+
this.name = "LangChainOracleError";
|
|
47
|
+
this.code = code;
|
|
48
|
+
// Save the raw node-oracledb error (or validation error) for root-cause analysis
|
|
49
|
+
this.cause = cause;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
_a = LANGCHAIN_ORACLE_ERROR_BRAND;
|
|
53
|
+
export function createError(code, message, cause) {
|
|
54
|
+
return new LangChainOracleError(code, message, cause);
|
|
55
|
+
}
|
|
56
|
+
// Identifies LangChainOracleError instances created by this package, not generic
|
|
57
|
+
// node-oracledb or database errors such as NJS- or ORA- codes.
|
|
58
|
+
export function isLangChainOracleError(error) {
|
|
59
|
+
return (typeof error === "object" &&
|
|
60
|
+
error !== null &&
|
|
61
|
+
LANGCHAIN_ORACLE_ERROR_BRAND in error);
|
|
62
|
+
}
|
|
63
|
+
const errorMessageFactories = {
|
|
64
|
+
[ErrorCode.VALIDATION_INVALID_INPUT]: (message) => message,
|
|
65
|
+
[ErrorCode.VALIDATION_MISSING_REQUIRED_PARAMETER]: (parameter) => `${parameter} parameter is required...`,
|
|
66
|
+
[ErrorCode.VALIDATION_INVALID_IDENTIFIER]: (identifier) => `Identifier name ${identifier} is not valid.`,
|
|
67
|
+
[ErrorCode.FILTER_INVALID_METADATA_KEY]: (column) => `Invalid metadata key '${String(column)}'. Only letters, numbers, underscores, nesting via '.', and array wildcards '[*]' are allowed.`,
|
|
68
|
+
[ErrorCode.FILTER_INVALID_VALUE]: (message) => message,
|
|
69
|
+
[ErrorCode.FILTER_UNSUPPORTED_OPERATOR]: (operator) => `Unsupported operator: ${operator}`,
|
|
70
|
+
[ErrorCode.VECTOR_INVALID_CONFIGURATION]: (message) => message,
|
|
71
|
+
[ErrorCode.VECTOR_INVALID_VALUE]: (message) => message,
|
|
72
|
+
[ErrorCode.VECTOR_UNSUPPORTED_REPRESENTATION]: (message) => message,
|
|
73
|
+
[ErrorCode.VECTOR_INVALID_INDEX_PARAMETERS]: (invalidKeys) => `Invalid parameter(s): ${invalidKeys.join(", ")}`,
|
|
74
|
+
[ErrorCode.STATE_INVALID]: (message) => message,
|
|
75
|
+
[ErrorCode.QUERY_NO_ROWS_FOUND]: () => "No rows found.",
|
|
76
|
+
[ErrorCode.SYSTEM_ERROR]: (message) => message,
|
|
77
|
+
};
|
|
78
|
+
function getErrorMessage(code, ...args) {
|
|
79
|
+
return errorMessageFactories[code](...args);
|
|
80
|
+
}
|
|
81
|
+
export function createErrorFromCode(code, ...args) {
|
|
82
|
+
return createError(code, getErrorMessage(code, ...args));
|
|
83
|
+
}
|
|
84
|
+
export function createErrorFromCodeWithCause(code, cause, ...args) {
|
|
85
|
+
return createError(code, getErrorMessage(code, ...args), cause);
|
|
86
|
+
}
|
|
87
|
+
export function throwError(code, ...args) {
|
|
88
|
+
throw createErrorFromCode(code, ...args);
|
|
89
|
+
}
|
|
90
|
+
//# sourceMappingURL=errors.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
|
package/dist/index.cjs
CHANGED
|
@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
|
16
16
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
17
17
|
__exportStar(require("./document_loaders.cjs"), exports);
|
|
18
18
|
__exportStar(require("./embeddings.cjs"), exports);
|
|
19
|
+
__exportStar(require("./errors.cjs"), exports);
|
|
19
20
|
__exportStar(require("./summary.cjs"), exports);
|
|
20
21
|
__exportStar(require("./text_splitter.cjs"), exports);
|
|
21
22
|
__exportStar(require("./vectorstores.cjs"), exports);
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,kDAAgC;AAChC,+CAA6B;AAC7B,qDAAmC;AACnC,oDAAkC"}
|
|
1
|
+
{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,kDAAgC;AAChC,8CAA4B;AAC5B,+CAA6B;AAC7B,qDAAmC;AACnC,oDAAkC"}
|
package/dist/index.d.cts
CHANGED
package/dist/index.d.ts
CHANGED
package/dist/index.js
CHANGED
package/dist/index.js.map
CHANGED
|
@@ -1 +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"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}
|