@hajewski/latticedb 0.1.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 +158 -0
- package/dist/database.d.ts +144 -0
- package/dist/database.d.ts.map +1 -0
- package/dist/database.js +292 -0
- package/dist/database.js.map +1 -0
- package/dist/ffi/bindings.d.ts +63 -0
- package/dist/ffi/bindings.d.ts.map +1 -0
- package/dist/ffi/bindings.js +358 -0
- package/dist/ffi/bindings.js.map +1 -0
- package/dist/ffi/index.d.ts +299 -0
- package/dist/ffi/index.d.ts.map +1 -0
- package/dist/ffi/index.js +628 -0
- package/dist/ffi/index.js.map +1 -0
- package/dist/ffi/library.d.ts +25 -0
- package/dist/ffi/library.d.ts.map +1 -0
- package/dist/ffi/library.js +178 -0
- package/dist/ffi/library.js.map +1 -0
- package/dist/ffi/types.d.ts +58 -0
- package/dist/ffi/types.d.ts.map +1 -0
- package/dist/ffi/types.js +23 -0
- package/dist/ffi/types.js.map +1 -0
- package/dist/index.d.ts +37 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +54 -0
- package/dist/index.js.map +1 -0
- package/dist/native.d.ts +98 -0
- package/dist/native.d.ts.map +1 -0
- package/dist/native.js +52 -0
- package/dist/native.js.map +1 -0
- package/dist/transaction.d.ts +149 -0
- package/dist/transaction.d.ts.map +1 -0
- package/dist/transaction.js +298 -0
- package/dist/transaction.js.map +1 -0
- package/dist/types.d.ts +123 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +43 -0
- package/dist/types.js.map +1 -0
- package/package.json +58 -0
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Library finding and loading for koffi FFI.
|
|
3
|
+
*
|
|
4
|
+
* Search order mirrors Python bindings:
|
|
5
|
+
* 1. LATTICE_LIB_PATH environment variable
|
|
6
|
+
* 2. Bundled in package (lib/<platform>/)
|
|
7
|
+
* 3. Development build (zig-out/lib/)
|
|
8
|
+
* 4. System paths
|
|
9
|
+
*/
|
|
10
|
+
import koffi from 'koffi';
|
|
11
|
+
/**
|
|
12
|
+
* Get the loaded koffi library instance.
|
|
13
|
+
*
|
|
14
|
+
* @throws Error if library cannot be found or loaded.
|
|
15
|
+
*/
|
|
16
|
+
export declare function getLibrary(): koffi.IKoffiLib;
|
|
17
|
+
/**
|
|
18
|
+
* Check if the native library is available.
|
|
19
|
+
*/
|
|
20
|
+
export declare function isLibraryAvailable(): boolean;
|
|
21
|
+
/**
|
|
22
|
+
* Get the path to the loaded library, or null if not loaded.
|
|
23
|
+
*/
|
|
24
|
+
export declare function getLibraryPath(): string | null;
|
|
25
|
+
//# sourceMappingURL=library.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/ffi/library.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AA+F1B;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,KAAK,CAAC,SAAS,CAsB5C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAO5C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAE9C"}
|
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Library finding and loading for koffi FFI.
|
|
4
|
+
*
|
|
5
|
+
* Search order mirrors Python bindings:
|
|
6
|
+
* 1. LATTICE_LIB_PATH environment variable
|
|
7
|
+
* 2. Bundled in package (lib/<platform>/)
|
|
8
|
+
* 3. Development build (zig-out/lib/)
|
|
9
|
+
* 4. System paths
|
|
10
|
+
*/
|
|
11
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
12
|
+
if (k2 === undefined) k2 = k;
|
|
13
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
14
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
15
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
16
|
+
}
|
|
17
|
+
Object.defineProperty(o, k2, desc);
|
|
18
|
+
}) : (function(o, m, k, k2) {
|
|
19
|
+
if (k2 === undefined) k2 = k;
|
|
20
|
+
o[k2] = m[k];
|
|
21
|
+
}));
|
|
22
|
+
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
23
|
+
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
24
|
+
}) : function(o, v) {
|
|
25
|
+
o["default"] = v;
|
|
26
|
+
});
|
|
27
|
+
var __importStar = (this && this.__importStar) || (function () {
|
|
28
|
+
var ownKeys = function(o) {
|
|
29
|
+
ownKeys = Object.getOwnPropertyNames || function (o) {
|
|
30
|
+
var ar = [];
|
|
31
|
+
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
|
|
32
|
+
return ar;
|
|
33
|
+
};
|
|
34
|
+
return ownKeys(o);
|
|
35
|
+
};
|
|
36
|
+
return function (mod) {
|
|
37
|
+
if (mod && mod.__esModule) return mod;
|
|
38
|
+
var result = {};
|
|
39
|
+
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
|
|
40
|
+
__setModuleDefault(result, mod);
|
|
41
|
+
return result;
|
|
42
|
+
};
|
|
43
|
+
})();
|
|
44
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
45
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
46
|
+
};
|
|
47
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
48
|
+
exports.getLibrary = getLibrary;
|
|
49
|
+
exports.isLibraryAvailable = isLibraryAvailable;
|
|
50
|
+
exports.getLibraryPath = getLibraryPath;
|
|
51
|
+
const koffi_1 = __importDefault(require("koffi"));
|
|
52
|
+
const fs = __importStar(require("fs"));
|
|
53
|
+
const path = __importStar(require("path"));
|
|
54
|
+
const os = __importStar(require("os"));
|
|
55
|
+
/**
|
|
56
|
+
* Get the library filename for the current platform.
|
|
57
|
+
*/
|
|
58
|
+
function getLibName() {
|
|
59
|
+
switch (process.platform) {
|
|
60
|
+
case 'darwin':
|
|
61
|
+
return 'liblattice.dylib';
|
|
62
|
+
case 'win32':
|
|
63
|
+
return 'lattice.dll';
|
|
64
|
+
default:
|
|
65
|
+
return 'liblattice.so';
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* Get the platform-architecture directory name.
|
|
70
|
+
*/
|
|
71
|
+
function getPlatformDir() {
|
|
72
|
+
const platform = process.platform;
|
|
73
|
+
const arch = process.arch; // 'x64', 'arm64', etc.
|
|
74
|
+
return `${platform}-${arch}`;
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* Find the lattice shared library.
|
|
78
|
+
*
|
|
79
|
+
* @returns Path to the library, or null if not found.
|
|
80
|
+
*/
|
|
81
|
+
function findLibrary() {
|
|
82
|
+
const libName = getLibName();
|
|
83
|
+
// 1. Environment variable override (explicit path)
|
|
84
|
+
const envPath = process.env.LATTICE_LIB_PATH;
|
|
85
|
+
if (envPath) {
|
|
86
|
+
if (fs.existsSync(envPath)) {
|
|
87
|
+
// Could be direct path to library or directory containing it
|
|
88
|
+
const stats = fs.statSync(envPath);
|
|
89
|
+
if (stats.isFile()) {
|
|
90
|
+
return envPath;
|
|
91
|
+
}
|
|
92
|
+
if (stats.isDirectory()) {
|
|
93
|
+
const libPath = path.join(envPath, libName);
|
|
94
|
+
if (fs.existsSync(libPath)) {
|
|
95
|
+
return libPath;
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
// 2. Bundled in package (for npm installs)
|
|
101
|
+
// Goes up from src/ffi/ to package root, then into lib/
|
|
102
|
+
const bundledPath = path.join(__dirname, '../../lib', getPlatformDir(), libName);
|
|
103
|
+
if (fs.existsSync(bundledPath)) {
|
|
104
|
+
return bundledPath;
|
|
105
|
+
}
|
|
106
|
+
// 3. Development build (zig-out/lib)
|
|
107
|
+
// Goes up from bindings/typescript/src/ffi/ to repo root
|
|
108
|
+
const devPath = path.join(__dirname, '../../../../zig-out/lib', libName);
|
|
109
|
+
if (fs.existsSync(devPath)) {
|
|
110
|
+
return devPath;
|
|
111
|
+
}
|
|
112
|
+
// 4. System paths
|
|
113
|
+
const systemPaths = [
|
|
114
|
+
'/usr/local/lib',
|
|
115
|
+
'/usr/lib',
|
|
116
|
+
path.join(os.homedir(), '.local/lib'),
|
|
117
|
+
];
|
|
118
|
+
// Add platform-specific paths
|
|
119
|
+
if (process.platform === 'darwin') {
|
|
120
|
+
systemPaths.unshift('/opt/homebrew/lib');
|
|
121
|
+
systemPaths.unshift('/usr/local/opt/latticedb/lib');
|
|
122
|
+
}
|
|
123
|
+
for (const dir of systemPaths) {
|
|
124
|
+
const libPath = path.join(dir, libName);
|
|
125
|
+
if (fs.existsSync(libPath)) {
|
|
126
|
+
return libPath;
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
return null;
|
|
130
|
+
}
|
|
131
|
+
// Cached library instance
|
|
132
|
+
let _lib = null;
|
|
133
|
+
let _libPath = null;
|
|
134
|
+
/**
|
|
135
|
+
* Get the loaded koffi library instance.
|
|
136
|
+
*
|
|
137
|
+
* @throws Error if library cannot be found or loaded.
|
|
138
|
+
*/
|
|
139
|
+
function getLibrary() {
|
|
140
|
+
if (_lib) {
|
|
141
|
+
return _lib;
|
|
142
|
+
}
|
|
143
|
+
const libPath = findLibrary();
|
|
144
|
+
if (!libPath) {
|
|
145
|
+
throw new Error('Could not find liblattice shared library. ' +
|
|
146
|
+
'Set LATTICE_LIB_PATH environment variable, ' +
|
|
147
|
+
'or install lattice-db with bundled binaries, ' +
|
|
148
|
+
'or build from source with "zig build shared".');
|
|
149
|
+
}
|
|
150
|
+
try {
|
|
151
|
+
_lib = koffi_1.default.load(libPath);
|
|
152
|
+
_libPath = libPath;
|
|
153
|
+
return _lib;
|
|
154
|
+
}
|
|
155
|
+
catch (err) {
|
|
156
|
+
throw new Error(`Failed to load liblattice from ${libPath}: ${err}`);
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
/**
|
|
160
|
+
* Check if the native library is available.
|
|
161
|
+
*/
|
|
162
|
+
function isLibraryAvailable() {
|
|
163
|
+
try {
|
|
164
|
+
if (_lib)
|
|
165
|
+
return true;
|
|
166
|
+
return findLibrary() !== null;
|
|
167
|
+
}
|
|
168
|
+
catch {
|
|
169
|
+
return false;
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
/**
|
|
173
|
+
* Get the path to the loaded library, or null if not loaded.
|
|
174
|
+
*/
|
|
175
|
+
function getLibraryPath() {
|
|
176
|
+
return _libPath;
|
|
177
|
+
}
|
|
178
|
+
//# sourceMappingURL=library.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"library.js","sourceRoot":"","sources":["../../src/ffi/library.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* TypeScript types and constants for the FFI layer.
|
|
3
|
+
*
|
|
4
|
+
* Note: koffi type registrations are done in bindings.ts to avoid
|
|
5
|
+
* circular dependencies and ensure proper initialization order.
|
|
6
|
+
*/
|
|
7
|
+
/**
|
|
8
|
+
* Error codes from lattice.h
|
|
9
|
+
*/
|
|
10
|
+
export declare const enum LatticeErrorCode {
|
|
11
|
+
Ok = 0,
|
|
12
|
+
Error = -1,
|
|
13
|
+
IoError = -2,
|
|
14
|
+
Corruption = -3,
|
|
15
|
+
NotFound = -4,
|
|
16
|
+
AlreadyExists = -5,
|
|
17
|
+
InvalidArg = -6,
|
|
18
|
+
TxnAborted = -7,
|
|
19
|
+
LockTimeout = -8,
|
|
20
|
+
ReadOnly = -9,
|
|
21
|
+
Full = -10,
|
|
22
|
+
VersionMismatch = -11,
|
|
23
|
+
Checksum = -12,
|
|
24
|
+
OutOfMemory = -13
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Transaction modes
|
|
28
|
+
*/
|
|
29
|
+
export declare const enum LatticeTxnMode {
|
|
30
|
+
ReadOnly = 0,
|
|
31
|
+
ReadWrite = 1
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Value types for properties
|
|
35
|
+
*/
|
|
36
|
+
export declare const enum LatticeValueType {
|
|
37
|
+
Null = 0,
|
|
38
|
+
Bool = 1,
|
|
39
|
+
Int = 2,
|
|
40
|
+
Float = 3,
|
|
41
|
+
String = 4,
|
|
42
|
+
Bytes = 5,
|
|
43
|
+
Vector = 6,
|
|
44
|
+
List = 7,
|
|
45
|
+
Map = 8
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Default open options matching LATTICE_OPEN_OPTIONS_DEFAULT
|
|
49
|
+
*/
|
|
50
|
+
export declare function defaultOpenOptions(): {
|
|
51
|
+
create: boolean;
|
|
52
|
+
read_only: boolean;
|
|
53
|
+
cache_size_mb: number;
|
|
54
|
+
page_size: number;
|
|
55
|
+
enable_vector: boolean;
|
|
56
|
+
vector_dimensions: number;
|
|
57
|
+
};
|
|
58
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ffi/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,0BAAkB,gBAAgB;IAChC,EAAE,IAAI;IACN,KAAK,KAAK;IACV,OAAO,KAAK;IACZ,UAAU,KAAK;IACf,QAAQ,KAAK;IACb,aAAa,KAAK;IAClB,UAAU,KAAK;IACf,UAAU,KAAK;IACf,WAAW,KAAK;IAChB,QAAQ,KAAK;IACb,IAAI,MAAM;IACV,eAAe,MAAM;IACrB,QAAQ,MAAM;IACd,WAAW,MAAM;CAClB;AAED;;GAEG;AACH,0BAAkB,cAAc;IAC9B,QAAQ,IAAI;IACZ,SAAS,IAAI;CACd;AAED;;GAEG;AACH,0BAAkB,gBAAgB;IAChC,IAAI,IAAI;IACR,IAAI,IAAI;IACR,GAAG,IAAI;IACP,KAAK,IAAI;IACT,MAAM,IAAI;IACV,KAAK,IAAI;IACT,MAAM,IAAI;IACV,IAAI,IAAI;IACR,GAAG,IAAI;CACR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CASA"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* TypeScript types and constants for the FFI layer.
|
|
4
|
+
*
|
|
5
|
+
* Note: koffi type registrations are done in bindings.ts to avoid
|
|
6
|
+
* circular dependencies and ensure proper initialization order.
|
|
7
|
+
*/
|
|
8
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
9
|
+
exports.defaultOpenOptions = defaultOpenOptions;
|
|
10
|
+
/**
|
|
11
|
+
* Default open options matching LATTICE_OPEN_OPTIONS_DEFAULT
|
|
12
|
+
*/
|
|
13
|
+
function defaultOpenOptions() {
|
|
14
|
+
return {
|
|
15
|
+
create: false,
|
|
16
|
+
read_only: false,
|
|
17
|
+
cache_size_mb: 100,
|
|
18
|
+
page_size: 4096,
|
|
19
|
+
enable_vector: false,
|
|
20
|
+
vector_dimensions: 128,
|
|
21
|
+
};
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ffi/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAgDH,gDAgBC;AAnBD;;GAEG;AACH,SAAgB,kBAAkB;IAQhC,OAAO;QACL,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,GAAG;QAClB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;QACpB,iBAAiB,EAAE,GAAG;KACvB,CAAC;AACJ,CAAC"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Lattice: Embedded Knowledge Graph Database
|
|
3
|
+
*
|
|
4
|
+
* TypeScript bindings for the Lattice database.
|
|
5
|
+
*
|
|
6
|
+
* @example
|
|
7
|
+
* ```typescript
|
|
8
|
+
* import { Database } from 'lattice-db';
|
|
9
|
+
*
|
|
10
|
+
* const db = new Database('knowledge.db', { create: true });
|
|
11
|
+
* await db.open();
|
|
12
|
+
*
|
|
13
|
+
* await db.write(async (txn) => {
|
|
14
|
+
* const node = await txn.createNode({
|
|
15
|
+
* labels: ['Person'],
|
|
16
|
+
* properties: { name: 'Alice', age: 30 }
|
|
17
|
+
* });
|
|
18
|
+
* console.log('Created node:', node.id);
|
|
19
|
+
* });
|
|
20
|
+
*
|
|
21
|
+
* const result = await db.query('MATCH (n:Person) RETURN n.name');
|
|
22
|
+
* for (const row of result.rows) {
|
|
23
|
+
* console.log(row);
|
|
24
|
+
* }
|
|
25
|
+
*
|
|
26
|
+
* await db.close();
|
|
27
|
+
* ```
|
|
28
|
+
*/
|
|
29
|
+
export { Database, DatabaseOptions } from './database';
|
|
30
|
+
export { Transaction } from './transaction';
|
|
31
|
+
export { Node, Edge, Value, QueryResult, VectorSearchResult, PropertyValue, CreateNodeOptions, CreateEdgeOptions, VectorSearchOptions, FtsSearchOptions, EmbeddingApiFormat, EmbeddingConfig, } from './types';
|
|
32
|
+
export { isLibraryAvailable } from './ffi';
|
|
33
|
+
/**
|
|
34
|
+
* Get the library version.
|
|
35
|
+
*/
|
|
36
|
+
export declare function version(): string;
|
|
37
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,GAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAE3C;;GAEG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAOhC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Lattice: Embedded Knowledge Graph Database
|
|
4
|
+
*
|
|
5
|
+
* TypeScript bindings for the Lattice database.
|
|
6
|
+
*
|
|
7
|
+
* @example
|
|
8
|
+
* ```typescript
|
|
9
|
+
* import { Database } from 'lattice-db';
|
|
10
|
+
*
|
|
11
|
+
* const db = new Database('knowledge.db', { create: true });
|
|
12
|
+
* await db.open();
|
|
13
|
+
*
|
|
14
|
+
* await db.write(async (txn) => {
|
|
15
|
+
* const node = await txn.createNode({
|
|
16
|
+
* labels: ['Person'],
|
|
17
|
+
* properties: { name: 'Alice', age: 30 }
|
|
18
|
+
* });
|
|
19
|
+
* console.log('Created node:', node.id);
|
|
20
|
+
* });
|
|
21
|
+
*
|
|
22
|
+
* const result = await db.query('MATCH (n:Person) RETURN n.name');
|
|
23
|
+
* for (const row of result.rows) {
|
|
24
|
+
* console.log(row);
|
|
25
|
+
* }
|
|
26
|
+
*
|
|
27
|
+
* await db.close();
|
|
28
|
+
* ```
|
|
29
|
+
*/
|
|
30
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
31
|
+
exports.isLibraryAvailable = exports.EmbeddingApiFormat = exports.Value = exports.Transaction = exports.Database = void 0;
|
|
32
|
+
exports.version = version;
|
|
33
|
+
var database_1 = require("./database");
|
|
34
|
+
Object.defineProperty(exports, "Database", { enumerable: true, get: function () { return database_1.Database; } });
|
|
35
|
+
var transaction_1 = require("./transaction");
|
|
36
|
+
Object.defineProperty(exports, "Transaction", { enumerable: true, get: function () { return transaction_1.Transaction; } });
|
|
37
|
+
var types_1 = require("./types");
|
|
38
|
+
Object.defineProperty(exports, "Value", { enumerable: true, get: function () { return types_1.Value; } });
|
|
39
|
+
Object.defineProperty(exports, "EmbeddingApiFormat", { enumerable: true, get: function () { return types_1.EmbeddingApiFormat; } });
|
|
40
|
+
var ffi_1 = require("./ffi");
|
|
41
|
+
Object.defineProperty(exports, "isLibraryAvailable", { enumerable: true, get: function () { return ffi_1.isLibraryAvailable; } });
|
|
42
|
+
/**
|
|
43
|
+
* Get the library version.
|
|
44
|
+
*/
|
|
45
|
+
function version() {
|
|
46
|
+
try {
|
|
47
|
+
const { getFFI } = require('./ffi');
|
|
48
|
+
return getFFI().version();
|
|
49
|
+
}
|
|
50
|
+
catch {
|
|
51
|
+
return '0.1.0';
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;AAuBH,0BAOC;AA5BD,uCAAuD;AAA9C,oGAAA,QAAQ,OAAA;AACjB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,iCAaiB;AAVf,8FAAA,KAAK,OAAA;AAQL,2GAAA,kBAAkB,OAAA;AAGpB,6BAA2C;AAAlC,yGAAA,kBAAkB,OAAA;AAE3B;;GAEG;AACH,SAAgB,OAAO;IACrB,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC"}
|
package/dist/native.d.ts
ADDED
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Native module loader and type definitions.
|
|
3
|
+
*
|
|
4
|
+
* This module loads the native N-API addon and provides TypeScript types
|
|
5
|
+
* for the raw native interface.
|
|
6
|
+
*/
|
|
7
|
+
/**
|
|
8
|
+
* Native edge object returned from edge traversal.
|
|
9
|
+
*/
|
|
10
|
+
export interface NativeEdge {
|
|
11
|
+
sourceId: bigint;
|
|
12
|
+
targetId: bigint;
|
|
13
|
+
type: string;
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Native query result.
|
|
17
|
+
*/
|
|
18
|
+
export interface NativeQueryResult {
|
|
19
|
+
columns: string[];
|
|
20
|
+
rows: Array<Record<string, unknown>>;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Native vector search result.
|
|
24
|
+
*/
|
|
25
|
+
export interface NativeVectorResult {
|
|
26
|
+
nodeId: bigint;
|
|
27
|
+
distance: number;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Native FTS search result.
|
|
31
|
+
*/
|
|
32
|
+
export interface NativeFtsResult {
|
|
33
|
+
nodeId: bigint;
|
|
34
|
+
score: number;
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* Native Transaction class interface.
|
|
38
|
+
*/
|
|
39
|
+
export interface NativeTransaction {
|
|
40
|
+
commit(): void;
|
|
41
|
+
rollback(): void;
|
|
42
|
+
createNode(label?: string): bigint;
|
|
43
|
+
deleteNode(nodeId: bigint): void;
|
|
44
|
+
nodeExists(nodeId: bigint): boolean;
|
|
45
|
+
getLabels(nodeId: bigint): string[] | null;
|
|
46
|
+
setProperty(nodeId: bigint, key: string, value: unknown): void;
|
|
47
|
+
getProperty(nodeId: bigint, key: string): unknown;
|
|
48
|
+
setVector(nodeId: bigint, key: string, vector: Float32Array): void;
|
|
49
|
+
ftsIndex(nodeId: bigint, text: string): void;
|
|
50
|
+
createEdge(sourceId: bigint, targetId: bigint, edgeType: string): bigint;
|
|
51
|
+
deleteEdge(sourceId: bigint, targetId: bigint, edgeType: string): void;
|
|
52
|
+
getOutgoingEdges(nodeId: bigint): NativeEdge[];
|
|
53
|
+
getIncomingEdges(nodeId: bigint): NativeEdge[];
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Native Database class interface.
|
|
57
|
+
*/
|
|
58
|
+
export interface NativeDatabase {
|
|
59
|
+
open(path: string, options?: {
|
|
60
|
+
create?: boolean;
|
|
61
|
+
readOnly?: boolean;
|
|
62
|
+
cacheSizeMb?: number;
|
|
63
|
+
enableVector?: boolean;
|
|
64
|
+
vectorDimensions?: number;
|
|
65
|
+
}): void;
|
|
66
|
+
close(): void;
|
|
67
|
+
begin(readOnly?: boolean): NativeTransaction;
|
|
68
|
+
isOpen(): boolean;
|
|
69
|
+
query(cypher: string, parameters?: Record<string, unknown>): NativeQueryResult;
|
|
70
|
+
vectorSearch(vector: Float32Array, options?: {
|
|
71
|
+
k?: number;
|
|
72
|
+
efSearch?: number;
|
|
73
|
+
}): NativeVectorResult[];
|
|
74
|
+
ftsSearch(query: string, options?: {
|
|
75
|
+
limit?: number;
|
|
76
|
+
}): NativeFtsResult[];
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* Native module interface.
|
|
80
|
+
*/
|
|
81
|
+
export interface NativeModule {
|
|
82
|
+
Database: new () => NativeDatabase;
|
|
83
|
+
Transaction: new () => NativeTransaction;
|
|
84
|
+
version(): string;
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* The loaded native module, or null if not available.
|
|
88
|
+
*/
|
|
89
|
+
export declare const native: NativeModule | null;
|
|
90
|
+
/**
|
|
91
|
+
* Check if the native module is available.
|
|
92
|
+
*/
|
|
93
|
+
export declare function isNativeAvailable(): boolean;
|
|
94
|
+
/**
|
|
95
|
+
* Get the native module, throwing if not available.
|
|
96
|
+
*/
|
|
97
|
+
export declare function getNative(): NativeModule;
|
|
98
|
+
//# sourceMappingURL=native.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"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"}
|
package/dist/native.js
ADDED
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Native module loader and type definitions.
|
|
4
|
+
*
|
|
5
|
+
* This module loads the native N-API addon and provides TypeScript types
|
|
6
|
+
* for the raw native interface.
|
|
7
|
+
*/
|
|
8
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
9
|
+
exports.native = void 0;
|
|
10
|
+
exports.isNativeAvailable = isNativeAvailable;
|
|
11
|
+
exports.getNative = getNative;
|
|
12
|
+
/**
|
|
13
|
+
* Try to load the native module.
|
|
14
|
+
*/
|
|
15
|
+
function loadNative() {
|
|
16
|
+
try {
|
|
17
|
+
// Try to load from the build directory
|
|
18
|
+
// eslint-disable-next-line @typescript-eslint/no-require-imports
|
|
19
|
+
return require('../build/Release/lattice_native.node');
|
|
20
|
+
}
|
|
21
|
+
catch {
|
|
22
|
+
try {
|
|
23
|
+
// Try debug build
|
|
24
|
+
// eslint-disable-next-line @typescript-eslint/no-require-imports
|
|
25
|
+
return require('../build/Debug/lattice_native.node');
|
|
26
|
+
}
|
|
27
|
+
catch {
|
|
28
|
+
return null;
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* The loaded native module, or null if not available.
|
|
34
|
+
*/
|
|
35
|
+
exports.native = loadNative();
|
|
36
|
+
/**
|
|
37
|
+
* Check if the native module is available.
|
|
38
|
+
*/
|
|
39
|
+
function isNativeAvailable() {
|
|
40
|
+
return exports.native !== null;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Get the native module, throwing if not available.
|
|
44
|
+
*/
|
|
45
|
+
function getNative() {
|
|
46
|
+
if (exports.native === null) {
|
|
47
|
+
throw new Error('Native module not available. ' +
|
|
48
|
+
'Make sure the native addon is built with "npm run build:native".');
|
|
49
|
+
}
|
|
50
|
+
return exports.native;
|
|
51
|
+
}
|
|
52
|
+
//# sourceMappingURL=native.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAgHH,8CAEC;AAKD,8BAQC;AA1CD;;GAEG;AACH,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,uCAAuC;QACvC,iEAAiE;QACjE,OAAO,OAAO,CAAC,sCAAsC,CAAiB,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,kBAAkB;YAClB,iEAAiE;YACjE,OAAO,OAAO,CAAC,oCAAoC,CAAiB,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACU,QAAA,MAAM,GAAwB,UAAU,EAAE,CAAC;AAExD;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,cAAM,KAAK,IAAI,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS;IACvB,IAAI,cAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,+BAA+B;YAC/B,kEAAkE,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,cAAM,CAAC;AAChB,CAAC"}
|