@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
package/README.md
ADDED
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
# LatticeDB TypeScript Bindings
|
|
2
|
+
|
|
3
|
+
TypeScript/Node.js bindings for [LatticeDB](https://github.com/jeffhajewski/latticedb), an embedded knowledge graph database for AI and RAG applications.
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install lattice-db
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Quick Start
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
import { Database } from 'lattice-db';
|
|
15
|
+
|
|
16
|
+
// Open or create a database
|
|
17
|
+
const db = new Database('knowledge.db', { create: true });
|
|
18
|
+
await db.open();
|
|
19
|
+
|
|
20
|
+
// Create nodes and relationships
|
|
21
|
+
await db.write(async (txn) => {
|
|
22
|
+
const alice = await txn.createNode({
|
|
23
|
+
labels: ['Person'],
|
|
24
|
+
properties: { name: 'Alice', age: 30 }
|
|
25
|
+
});
|
|
26
|
+
|
|
27
|
+
const bob = await txn.createNode({
|
|
28
|
+
labels: ['Person'],
|
|
29
|
+
properties: { name: 'Bob', age: 25 }
|
|
30
|
+
});
|
|
31
|
+
|
|
32
|
+
await txn.createEdge(alice.id, bob.id, 'KNOWS');
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
// Query with Cypher
|
|
36
|
+
const result = await db.query('MATCH (n:Person) RETURN n.name, n.age');
|
|
37
|
+
for (const row of result.rows) {
|
|
38
|
+
console.log(row);
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
await db.close();
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
## Features
|
|
45
|
+
|
|
46
|
+
- **Property Graph** - Nodes and edges with labels and properties
|
|
47
|
+
- **Vector Search** - HNSW-based k-NN search for embeddings
|
|
48
|
+
- **Full-Text Search** - BM25-ranked search with tokenization
|
|
49
|
+
- **Cypher Queries** - Pattern matching with `<=>` (vector) and `@@` (FTS) extensions
|
|
50
|
+
- **Transactions** - ACID-compliant read/write transactions
|
|
51
|
+
- **TypeScript** - Full type definitions included
|
|
52
|
+
|
|
53
|
+
## API Reference
|
|
54
|
+
|
|
55
|
+
### Database
|
|
56
|
+
|
|
57
|
+
```typescript
|
|
58
|
+
const db = new Database(path: string, options?: DatabaseOptions);
|
|
59
|
+
|
|
60
|
+
interface DatabaseOptions {
|
|
61
|
+
create?: boolean; // Create if not exists (default: false)
|
|
62
|
+
readOnly?: boolean; // Open read-only (default: false)
|
|
63
|
+
cacheSizeMb?: number; // Cache size in MB (default: 100)
|
|
64
|
+
enableVector?: boolean; // Enable vector storage (default: false)
|
|
65
|
+
vectorDimensions?: number; // Vector dimensions (default: 128)
|
|
66
|
+
}
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
#### Methods
|
|
70
|
+
|
|
71
|
+
- `await db.open()` - Open the database connection
|
|
72
|
+
- `await db.close()` - Close the database connection
|
|
73
|
+
- `await db.read(fn)` - Execute a read-only transaction
|
|
74
|
+
- `await db.write(fn)` - Execute a read-write transaction
|
|
75
|
+
- `await db.query(cypher, params?)` - Execute a Cypher query
|
|
76
|
+
- `await db.vectorSearch(vector, options?)` - k-NN vector search
|
|
77
|
+
- `await db.ftsSearch(query, options?)` - Full-text search
|
|
78
|
+
- `db.isOpen()` - Check if database is open
|
|
79
|
+
- `db.getPath()` - Get database file path
|
|
80
|
+
|
|
81
|
+
### Transaction
|
|
82
|
+
|
|
83
|
+
```typescript
|
|
84
|
+
await db.write(async (txn) => {
|
|
85
|
+
// Node operations
|
|
86
|
+
const node = await txn.createNode({ labels: ['Label'], properties: { key: 'value' } });
|
|
87
|
+
await txn.deleteNode(nodeId);
|
|
88
|
+
const exists = await txn.nodeExists(nodeId);
|
|
89
|
+
const node = await txn.getNode(nodeId);
|
|
90
|
+
|
|
91
|
+
// Property operations
|
|
92
|
+
await txn.setProperty(nodeId, 'key', 'value');
|
|
93
|
+
const value = await txn.getProperty(nodeId, 'key');
|
|
94
|
+
|
|
95
|
+
// Vector operations
|
|
96
|
+
await txn.setVector(nodeId, 'embedding', new Float32Array([...]));
|
|
97
|
+
|
|
98
|
+
// FTS operations
|
|
99
|
+
await txn.ftsIndex(nodeId, 'text to index');
|
|
100
|
+
|
|
101
|
+
// Edge operations
|
|
102
|
+
const edge = await txn.createEdge(sourceId, targetId, 'EDGE_TYPE');
|
|
103
|
+
await txn.deleteEdge(sourceId, targetId, 'EDGE_TYPE');
|
|
104
|
+
const outgoing = await txn.getOutgoingEdges(nodeId);
|
|
105
|
+
const incoming = await txn.getIncomingEdges(nodeId);
|
|
106
|
+
});
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
### Query Examples
|
|
110
|
+
|
|
111
|
+
```typescript
|
|
112
|
+
// Basic pattern matching
|
|
113
|
+
const result = await db.query('MATCH (n:Person) RETURN n.name');
|
|
114
|
+
|
|
115
|
+
// With parameters
|
|
116
|
+
const result = await db.query(
|
|
117
|
+
'MATCH (n:Person) WHERE n.name = $name RETURN n',
|
|
118
|
+
{ name: 'Alice' }
|
|
119
|
+
);
|
|
120
|
+
|
|
121
|
+
// Vector similarity search
|
|
122
|
+
const result = await db.query(
|
|
123
|
+
'MATCH (n:Document) WHERE n.embedding <=> $query < 0.5 RETURN n.title',
|
|
124
|
+
{ query: new Float32Array([...]) }
|
|
125
|
+
);
|
|
126
|
+
|
|
127
|
+
// Full-text search
|
|
128
|
+
const result = await db.query(
|
|
129
|
+
'MATCH (n:Document) WHERE n.content @@ "machine learning" RETURN n.title'
|
|
130
|
+
);
|
|
131
|
+
|
|
132
|
+
// Data mutation
|
|
133
|
+
await db.query('CREATE (n:Person {name: "Alice", age: 30})');
|
|
134
|
+
await db.query('MATCH (n:Person {name: "Alice"}) SET n.age = 31');
|
|
135
|
+
await db.query('MATCH (n:Person {name: "Alice"}) REMOVE n.age');
|
|
136
|
+
await db.query('MATCH (n:Person {name: "Bob"}) DETACH DELETE n');
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
## Building from Source
|
|
140
|
+
|
|
141
|
+
Requires Node.js 18+ and the LatticeDB native library to be built.
|
|
142
|
+
|
|
143
|
+
```bash
|
|
144
|
+
# From the latticedb root directory
|
|
145
|
+
zig build shared
|
|
146
|
+
|
|
147
|
+
# Build the TypeScript bindings
|
|
148
|
+
cd bindings/typescript
|
|
149
|
+
npm install
|
|
150
|
+
npm run build:all
|
|
151
|
+
|
|
152
|
+
# Run tests
|
|
153
|
+
npm test
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
## License
|
|
157
|
+
|
|
158
|
+
MIT
|
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Database class for Lattice TypeScript bindings.
|
|
3
|
+
*/
|
|
4
|
+
import { Transaction } from './transaction';
|
|
5
|
+
import { QueryResult, VectorSearchResult, PropertyValue, VectorSearchOptions, FtsSearchOptions } from './types';
|
|
6
|
+
/**
|
|
7
|
+
* Options for opening a database.
|
|
8
|
+
*/
|
|
9
|
+
export interface DatabaseOptions {
|
|
10
|
+
/** Create database if it doesn't exist */
|
|
11
|
+
create?: boolean;
|
|
12
|
+
/** Open in read-only mode */
|
|
13
|
+
readOnly?: boolean;
|
|
14
|
+
/** Cache size in megabytes */
|
|
15
|
+
cacheSizeMb?: number;
|
|
16
|
+
/** Enable vector storage */
|
|
17
|
+
enableVector?: boolean;
|
|
18
|
+
/** Vector dimensions (default: 128) */
|
|
19
|
+
vectorDimensions?: number;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Lattice database connection.
|
|
23
|
+
*
|
|
24
|
+
* @example
|
|
25
|
+
* ```typescript
|
|
26
|
+
* const db = new Database('knowledge.db', { create: true });
|
|
27
|
+
* await db.open();
|
|
28
|
+
*
|
|
29
|
+
* await db.write(async (txn) => {
|
|
30
|
+
* const nodeId = await txn.createNode({ labels: ['Person'], properties: { name: 'Alice' } });
|
|
31
|
+
* });
|
|
32
|
+
*
|
|
33
|
+
* const result = await db.query('MATCH (n:Person) RETURN n.name');
|
|
34
|
+
* console.log(result.rows);
|
|
35
|
+
*
|
|
36
|
+
* await db.close();
|
|
37
|
+
* ```
|
|
38
|
+
*/
|
|
39
|
+
export declare class Database {
|
|
40
|
+
private readonly path;
|
|
41
|
+
private readonly options;
|
|
42
|
+
private ffi;
|
|
43
|
+
private dbHandle;
|
|
44
|
+
private closed;
|
|
45
|
+
/**
|
|
46
|
+
* Create a new database connection.
|
|
47
|
+
*
|
|
48
|
+
* @param path - Path to the database file
|
|
49
|
+
* @param options - Database options
|
|
50
|
+
*/
|
|
51
|
+
constructor(path: string, options?: DatabaseOptions);
|
|
52
|
+
/**
|
|
53
|
+
* Open the database connection.
|
|
54
|
+
*/
|
|
55
|
+
open(): Promise<void>;
|
|
56
|
+
/**
|
|
57
|
+
* Close the database connection.
|
|
58
|
+
*/
|
|
59
|
+
close(): Promise<void>;
|
|
60
|
+
/**
|
|
61
|
+
* Execute a read-only transaction.
|
|
62
|
+
*
|
|
63
|
+
* @param fn - Transaction function
|
|
64
|
+
* @returns Result of the transaction function
|
|
65
|
+
*/
|
|
66
|
+
read<T>(fn: (txn: Transaction) => Promise<T>): Promise<T>;
|
|
67
|
+
/**
|
|
68
|
+
* Execute a read-write transaction.
|
|
69
|
+
*
|
|
70
|
+
* @param fn - Transaction function
|
|
71
|
+
* @returns Result of the transaction function
|
|
72
|
+
*/
|
|
73
|
+
write<T>(fn: (txn: Transaction) => Promise<T>): Promise<T>;
|
|
74
|
+
/**
|
|
75
|
+
* Execute a Cypher query.
|
|
76
|
+
*
|
|
77
|
+
* @param cypher - Cypher query string
|
|
78
|
+
* @param parameters - Query parameters
|
|
79
|
+
* @returns Query results
|
|
80
|
+
*/
|
|
81
|
+
query(cypher: string, parameters?: Record<string, PropertyValue>): Promise<QueryResult>;
|
|
82
|
+
/**
|
|
83
|
+
* Search for similar vectors.
|
|
84
|
+
*
|
|
85
|
+
* @param vector - Query vector
|
|
86
|
+
* @param options - Search options
|
|
87
|
+
* @returns Search results
|
|
88
|
+
*/
|
|
89
|
+
vectorSearch(vector: Float32Array, options?: VectorSearchOptions): Promise<VectorSearchResult[]>;
|
|
90
|
+
/**
|
|
91
|
+
* Full-text search.
|
|
92
|
+
*
|
|
93
|
+
* @param query - Search query
|
|
94
|
+
* @param options - Search options
|
|
95
|
+
* @returns Matching nodes with scores
|
|
96
|
+
*/
|
|
97
|
+
ftsSearch(query: string, options?: FtsSearchOptions): Promise<Array<{
|
|
98
|
+
nodeId: bigint;
|
|
99
|
+
score: number;
|
|
100
|
+
}>>;
|
|
101
|
+
/**
|
|
102
|
+
* Fuzzy full-text search with typo tolerance.
|
|
103
|
+
*
|
|
104
|
+
* @param query - Search query
|
|
105
|
+
* @param options - Search options including maxDistance and minTermLength
|
|
106
|
+
* @returns Matching nodes with scores
|
|
107
|
+
*/
|
|
108
|
+
ftsSearchFuzzy(query: string, options?: FtsSearchOptions & {
|
|
109
|
+
maxDistance?: number;
|
|
110
|
+
minTermLength?: number;
|
|
111
|
+
}): Promise<Array<{
|
|
112
|
+
nodeId: bigint;
|
|
113
|
+
score: number;
|
|
114
|
+
}>>;
|
|
115
|
+
/**
|
|
116
|
+
* Clear the query cache.
|
|
117
|
+
*
|
|
118
|
+
* Removes all cached parsed queries, forcing re-parsing on next execution.
|
|
119
|
+
*/
|
|
120
|
+
cacheClear(): Promise<void>;
|
|
121
|
+
/**
|
|
122
|
+
* Get query cache statistics.
|
|
123
|
+
*
|
|
124
|
+
* @returns Object with entries count, hit count, and miss count.
|
|
125
|
+
*/
|
|
126
|
+
cacheStats(): Promise<{
|
|
127
|
+
entries: number;
|
|
128
|
+
hits: number;
|
|
129
|
+
misses: number;
|
|
130
|
+
}>;
|
|
131
|
+
/**
|
|
132
|
+
* Get the database file path.
|
|
133
|
+
*/
|
|
134
|
+
getPath(): string;
|
|
135
|
+
/**
|
|
136
|
+
* Check if the database is open.
|
|
137
|
+
*/
|
|
138
|
+
isOpen(): boolean;
|
|
139
|
+
/**
|
|
140
|
+
* Ensure the database is open.
|
|
141
|
+
*/
|
|
142
|
+
private ensureOpen;
|
|
143
|
+
}
|
|
144
|
+
//# sourceMappingURL=database.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAOjB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,GAAG,CAA2B;IACtC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;;OAKG;gBACS,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB;IAYvD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;;;;OAKG;IACG,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAY/D;;;;;OAKG;IACG,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAiBhE;;;;;;OAMG;IACG,KAAK,CACT,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GACzC,OAAO,CAAC,WAAW,CAAC;IAoDvB;;;;;;OAMG;IACG,YAAY,CAChB,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAoBhC;;;;;;OAMG;IACG,SAAS,CACb,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAkBpD;;;;;;OAMG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,gBAAgB,GAAG;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5E,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAoBpD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAK9E;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,OAAO,CAAC,UAAU;CAKnB"}
|
package/dist/database.js
ADDED
|
@@ -0,0 +1,292 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Database class for Lattice TypeScript bindings.
|
|
4
|
+
*/
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.Database = void 0;
|
|
7
|
+
const transaction_1 = require("./transaction");
|
|
8
|
+
const ffi_1 = require("./ffi");
|
|
9
|
+
/**
|
|
10
|
+
* Lattice database connection.
|
|
11
|
+
*
|
|
12
|
+
* @example
|
|
13
|
+
* ```typescript
|
|
14
|
+
* const db = new Database('knowledge.db', { create: true });
|
|
15
|
+
* await db.open();
|
|
16
|
+
*
|
|
17
|
+
* await db.write(async (txn) => {
|
|
18
|
+
* const nodeId = await txn.createNode({ labels: ['Person'], properties: { name: 'Alice' } });
|
|
19
|
+
* });
|
|
20
|
+
*
|
|
21
|
+
* const result = await db.query('MATCH (n:Person) RETURN n.name');
|
|
22
|
+
* console.log(result.rows);
|
|
23
|
+
*
|
|
24
|
+
* await db.close();
|
|
25
|
+
* ```
|
|
26
|
+
*/
|
|
27
|
+
class Database {
|
|
28
|
+
path;
|
|
29
|
+
options;
|
|
30
|
+
ffi = null;
|
|
31
|
+
dbHandle = null;
|
|
32
|
+
closed = false;
|
|
33
|
+
/**
|
|
34
|
+
* Create a new database connection.
|
|
35
|
+
*
|
|
36
|
+
* @param path - Path to the database file
|
|
37
|
+
* @param options - Database options
|
|
38
|
+
*/
|
|
39
|
+
constructor(path, options = {}) {
|
|
40
|
+
this.path = path;
|
|
41
|
+
this.options = {
|
|
42
|
+
create: false,
|
|
43
|
+
readOnly: false,
|
|
44
|
+
cacheSizeMb: 100,
|
|
45
|
+
enableVector: false,
|
|
46
|
+
vectorDimensions: 128,
|
|
47
|
+
...options,
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* Open the database connection.
|
|
52
|
+
*/
|
|
53
|
+
async open() {
|
|
54
|
+
if (this.dbHandle !== null) {
|
|
55
|
+
return;
|
|
56
|
+
}
|
|
57
|
+
this.ffi = (0, ffi_1.getFFI)();
|
|
58
|
+
this.dbHandle = this.ffi.open(this.path, {
|
|
59
|
+
create: this.options.create,
|
|
60
|
+
readOnly: this.options.readOnly,
|
|
61
|
+
cacheSizeMb: this.options.cacheSizeMb,
|
|
62
|
+
enableVector: this.options.enableVector,
|
|
63
|
+
vectorDimensions: this.options.vectorDimensions,
|
|
64
|
+
});
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Close the database connection.
|
|
68
|
+
*/
|
|
69
|
+
async close() {
|
|
70
|
+
if (this.closed || this.dbHandle === null || this.ffi === null) {
|
|
71
|
+
return;
|
|
72
|
+
}
|
|
73
|
+
this.ffi.close(this.dbHandle);
|
|
74
|
+
this.dbHandle = null;
|
|
75
|
+
this.closed = true;
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* Execute a read-only transaction.
|
|
79
|
+
*
|
|
80
|
+
* @param fn - Transaction function
|
|
81
|
+
* @returns Result of the transaction function
|
|
82
|
+
*/
|
|
83
|
+
async read(fn) {
|
|
84
|
+
this.ensureOpen();
|
|
85
|
+
const txnHandle = this.ffi.begin(this.dbHandle, true);
|
|
86
|
+
const txn = new transaction_1.Transaction(this.ffi, txnHandle, true);
|
|
87
|
+
try {
|
|
88
|
+
const result = await fn(txn);
|
|
89
|
+
return result;
|
|
90
|
+
}
|
|
91
|
+
finally {
|
|
92
|
+
txn.rollback();
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* Execute a read-write transaction.
|
|
97
|
+
*
|
|
98
|
+
* @param fn - Transaction function
|
|
99
|
+
* @returns Result of the transaction function
|
|
100
|
+
*/
|
|
101
|
+
async write(fn) {
|
|
102
|
+
if (this.options.readOnly) {
|
|
103
|
+
throw new Error('Cannot write to a read-only database');
|
|
104
|
+
}
|
|
105
|
+
this.ensureOpen();
|
|
106
|
+
const txnHandle = this.ffi.begin(this.dbHandle, false);
|
|
107
|
+
const txn = new transaction_1.Transaction(this.ffi, txnHandle, false);
|
|
108
|
+
try {
|
|
109
|
+
const result = await fn(txn);
|
|
110
|
+
txn.commit();
|
|
111
|
+
return result;
|
|
112
|
+
}
|
|
113
|
+
catch (error) {
|
|
114
|
+
txn.rollback();
|
|
115
|
+
throw error;
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
* Execute a Cypher query.
|
|
120
|
+
*
|
|
121
|
+
* @param cypher - Cypher query string
|
|
122
|
+
* @param parameters - Query parameters
|
|
123
|
+
* @returns Query results
|
|
124
|
+
*/
|
|
125
|
+
async query(cypher, parameters) {
|
|
126
|
+
this.ensureOpen();
|
|
127
|
+
const ffi = this.ffi;
|
|
128
|
+
// Prepare query
|
|
129
|
+
const query = ffi.queryPrepare(this.dbHandle, cypher);
|
|
130
|
+
try {
|
|
131
|
+
// Bind parameters
|
|
132
|
+
if (parameters) {
|
|
133
|
+
for (const [name, value] of Object.entries(parameters)) {
|
|
134
|
+
if (value instanceof Float32Array) {
|
|
135
|
+
ffi.queryBindVector(query, name, value);
|
|
136
|
+
}
|
|
137
|
+
else {
|
|
138
|
+
ffi.queryBind(query, name, value);
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
// Execute within an auto-created read transaction
|
|
143
|
+
const txnHandle = ffi.begin(this.dbHandle, true);
|
|
144
|
+
try {
|
|
145
|
+
const result = ffi.queryExecute(query, txnHandle);
|
|
146
|
+
try {
|
|
147
|
+
// Read columns
|
|
148
|
+
const columnCount = ffi.resultColumnCount(result);
|
|
149
|
+
const columns = [];
|
|
150
|
+
for (let i = 0; i < columnCount; i++) {
|
|
151
|
+
columns.push(ffi.resultColumnName(result, i));
|
|
152
|
+
}
|
|
153
|
+
// Read rows
|
|
154
|
+
const rows = [];
|
|
155
|
+
while (ffi.resultNext(result)) {
|
|
156
|
+
const row = {};
|
|
157
|
+
for (let i = 0; i < columnCount; i++) {
|
|
158
|
+
row[columns[i]] = ffi.resultGet(result, i);
|
|
159
|
+
}
|
|
160
|
+
rows.push(row);
|
|
161
|
+
}
|
|
162
|
+
return { columns, rows };
|
|
163
|
+
}
|
|
164
|
+
finally {
|
|
165
|
+
ffi.resultFree(result);
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
finally {
|
|
169
|
+
ffi.rollback(txnHandle);
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
finally {
|
|
173
|
+
ffi.queryFree(query);
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
/**
|
|
177
|
+
* Search for similar vectors.
|
|
178
|
+
*
|
|
179
|
+
* @param vector - Query vector
|
|
180
|
+
* @param options - Search options
|
|
181
|
+
* @returns Search results
|
|
182
|
+
*/
|
|
183
|
+
async vectorSearch(vector, options) {
|
|
184
|
+
this.ensureOpen();
|
|
185
|
+
const ffi = this.ffi;
|
|
186
|
+
const k = options?.k ?? 10;
|
|
187
|
+
const efSearch = options?.efSearch ?? 0;
|
|
188
|
+
const resultHandle = ffi.vectorSearch(this.dbHandle, vector, k, efSearch);
|
|
189
|
+
try {
|
|
190
|
+
const count = ffi.vectorResultCount(resultHandle);
|
|
191
|
+
const results = [];
|
|
192
|
+
for (let i = 0; i < count; i++) {
|
|
193
|
+
const r = ffi.vectorResultGet(resultHandle, i);
|
|
194
|
+
results.push({ nodeId: r.nodeId, distance: r.distance });
|
|
195
|
+
}
|
|
196
|
+
return results;
|
|
197
|
+
}
|
|
198
|
+
finally {
|
|
199
|
+
ffi.vectorResultFree(resultHandle);
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
/**
|
|
203
|
+
* Full-text search.
|
|
204
|
+
*
|
|
205
|
+
* @param query - Search query
|
|
206
|
+
* @param options - Search options
|
|
207
|
+
* @returns Matching nodes with scores
|
|
208
|
+
*/
|
|
209
|
+
async ftsSearch(query, options) {
|
|
210
|
+
this.ensureOpen();
|
|
211
|
+
const ffi = this.ffi;
|
|
212
|
+
const limit = options?.limit ?? 10;
|
|
213
|
+
const resultHandle = ffi.ftsSearch(this.dbHandle, query, limit);
|
|
214
|
+
try {
|
|
215
|
+
const count = ffi.ftsResultCount(resultHandle);
|
|
216
|
+
const results = [];
|
|
217
|
+
for (let i = 0; i < count; i++) {
|
|
218
|
+
results.push(ffi.ftsResultGet(resultHandle, i));
|
|
219
|
+
}
|
|
220
|
+
return results;
|
|
221
|
+
}
|
|
222
|
+
finally {
|
|
223
|
+
ffi.ftsResultFree(resultHandle);
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
/**
|
|
227
|
+
* Fuzzy full-text search with typo tolerance.
|
|
228
|
+
*
|
|
229
|
+
* @param query - Search query
|
|
230
|
+
* @param options - Search options including maxDistance and minTermLength
|
|
231
|
+
* @returns Matching nodes with scores
|
|
232
|
+
*/
|
|
233
|
+
async ftsSearchFuzzy(query, options) {
|
|
234
|
+
this.ensureOpen();
|
|
235
|
+
const ffi = this.ffi;
|
|
236
|
+
const limit = options?.limit ?? 10;
|
|
237
|
+
const maxDistance = options?.maxDistance ?? 0;
|
|
238
|
+
const minTermLength = options?.minTermLength ?? 0;
|
|
239
|
+
const resultHandle = ffi.ftsSearchFuzzy(this.dbHandle, query, limit, maxDistance, minTermLength);
|
|
240
|
+
try {
|
|
241
|
+
const count = ffi.ftsResultCount(resultHandle);
|
|
242
|
+
const results = [];
|
|
243
|
+
for (let i = 0; i < count; i++) {
|
|
244
|
+
results.push(ffi.ftsResultGet(resultHandle, i));
|
|
245
|
+
}
|
|
246
|
+
return results;
|
|
247
|
+
}
|
|
248
|
+
finally {
|
|
249
|
+
ffi.ftsResultFree(resultHandle);
|
|
250
|
+
}
|
|
251
|
+
}
|
|
252
|
+
/**
|
|
253
|
+
* Clear the query cache.
|
|
254
|
+
*
|
|
255
|
+
* Removes all cached parsed queries, forcing re-parsing on next execution.
|
|
256
|
+
*/
|
|
257
|
+
async cacheClear() {
|
|
258
|
+
this.ensureOpen();
|
|
259
|
+
this.ffi.cacheClear(this.dbHandle);
|
|
260
|
+
}
|
|
261
|
+
/**
|
|
262
|
+
* Get query cache statistics.
|
|
263
|
+
*
|
|
264
|
+
* @returns Object with entries count, hit count, and miss count.
|
|
265
|
+
*/
|
|
266
|
+
async cacheStats() {
|
|
267
|
+
this.ensureOpen();
|
|
268
|
+
return this.ffi.cacheStats(this.dbHandle);
|
|
269
|
+
}
|
|
270
|
+
/**
|
|
271
|
+
* Get the database file path.
|
|
272
|
+
*/
|
|
273
|
+
getPath() {
|
|
274
|
+
return this.path;
|
|
275
|
+
}
|
|
276
|
+
/**
|
|
277
|
+
* Check if the database is open.
|
|
278
|
+
*/
|
|
279
|
+
isOpen() {
|
|
280
|
+
return this.dbHandle !== null && !this.closed;
|
|
281
|
+
}
|
|
282
|
+
/**
|
|
283
|
+
* Ensure the database is open.
|
|
284
|
+
*/
|
|
285
|
+
ensureOpen() {
|
|
286
|
+
if (this.dbHandle === null || this.closed) {
|
|
287
|
+
throw new Error('Database is not open');
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
}
|
|
291
|
+
exports.Database = Database;
|
|
292
|
+
//# sourceMappingURL=database.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"database.js","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* FFI function bindings to liblattice C API.
|
|
3
|
+
*
|
|
4
|
+
* These are low-level bindings that directly map to the C functions.
|
|
5
|
+
* Use the wrapper in index.ts for a more ergonomic interface.
|
|
6
|
+
*/
|
|
7
|
+
export interface LatticeBindings {
|
|
8
|
+
lattice_open: (path: string, options: unknown, db_out: unknown[]) => number;
|
|
9
|
+
lattice_close: (db: unknown) => number;
|
|
10
|
+
lattice_begin: (db: unknown, mode: number, txn_out: unknown[]) => number;
|
|
11
|
+
lattice_commit: (txn: unknown) => number;
|
|
12
|
+
lattice_rollback: (txn: unknown) => number;
|
|
13
|
+
lattice_node_create: (txn: unknown, label: string | null, node_out: Buffer) => number;
|
|
14
|
+
lattice_node_delete: (txn: unknown, node_id: bigint) => number;
|
|
15
|
+
lattice_node_exists: (txn: unknown, node_id: bigint, exists_out: Buffer) => number;
|
|
16
|
+
lattice_node_get_labels: (txn: unknown, node_id: bigint, labels_out: unknown[]) => number;
|
|
17
|
+
lattice_free_string: (str: unknown) => void;
|
|
18
|
+
lattice_node_set_property: (txn: unknown, node_id: bigint, key: string, value: unknown) => number;
|
|
19
|
+
lattice_node_get_property: (txn: unknown, node_id: bigint, key: string, value_out: unknown) => number;
|
|
20
|
+
lattice_node_set_vector: (txn: unknown, node_id: bigint, key: string, vector: Float32Array, dimensions: number) => number;
|
|
21
|
+
lattice_batch_insert: (txn: unknown, nodes: unknown, count: number, node_ids_out: Buffer, count_out: Buffer) => number;
|
|
22
|
+
lattice_vector_search: (db: unknown, vector: Float32Array, dimensions: number, k: number, ef_search: number, result_out: unknown[]) => number;
|
|
23
|
+
lattice_vector_result_count: (result: unknown) => number;
|
|
24
|
+
lattice_vector_result_get: (result: unknown, index: number, node_id_out: Buffer, distance_out: Buffer) => number;
|
|
25
|
+
lattice_vector_result_free: (result: unknown) => void;
|
|
26
|
+
lattice_fts_index: (txn: unknown, node_id: bigint, text: string, text_len: number) => number;
|
|
27
|
+
lattice_fts_search: (db: unknown, query: string, query_len: number, limit: number, result_out: unknown[]) => number;
|
|
28
|
+
lattice_fts_search_fuzzy: (db: unknown, query: string, query_len: number, limit: number, max_distance: number, min_term_length: number, result_out: unknown[]) => number;
|
|
29
|
+
lattice_fts_result_count: (result: unknown) => number;
|
|
30
|
+
lattice_fts_result_get: (result: unknown, index: number, node_id_out: Buffer, score_out: Buffer) => number;
|
|
31
|
+
lattice_fts_result_free: (result: unknown) => void;
|
|
32
|
+
lattice_edge_create: (txn: unknown, source: bigint, target: bigint, edge_type: string, edge_out: Buffer) => number;
|
|
33
|
+
lattice_edge_delete: (txn: unknown, source: bigint, target: bigint, edge_type: string) => number;
|
|
34
|
+
lattice_edge_get_outgoing: (txn: unknown, node_id: bigint, result_out: unknown[]) => number;
|
|
35
|
+
lattice_edge_get_incoming: (txn: unknown, node_id: bigint, result_out: unknown[]) => number;
|
|
36
|
+
lattice_edge_result_count: (result: unknown) => number;
|
|
37
|
+
lattice_edge_result_get: (result: unknown, index: number, source_out: Buffer, target_out: Buffer, edge_type_out: unknown[], edge_type_len_out: Buffer) => number;
|
|
38
|
+
lattice_edge_result_free: (result: unknown) => void;
|
|
39
|
+
lattice_query_prepare: (db: unknown, cypher: string, query_out: unknown[]) => number;
|
|
40
|
+
lattice_query_bind: (query: unknown, name: string, value: unknown) => number;
|
|
41
|
+
lattice_query_bind_vector: (query: unknown, name: string, vector: Float32Array, dimensions: number) => number;
|
|
42
|
+
lattice_query_execute: (query: unknown, txn: unknown, result_out: unknown[]) => number;
|
|
43
|
+
lattice_query_free: (query: unknown) => void;
|
|
44
|
+
lattice_query_cache_clear: (db: unknown) => number;
|
|
45
|
+
lattice_query_cache_stats: (db: unknown, entries_out: Buffer, hits_out: Buffer, misses_out: Buffer) => number;
|
|
46
|
+
lattice_result_next: (result: unknown) => boolean;
|
|
47
|
+
lattice_result_column_count: (result: unknown) => number;
|
|
48
|
+
lattice_result_column_name: (result: unknown, index: number) => string;
|
|
49
|
+
lattice_result_get: (result: unknown, index: number, value_out: unknown) => number;
|
|
50
|
+
lattice_result_free: (result: unknown) => void;
|
|
51
|
+
lattice_hash_embed: (text: string, text_len: number, dimensions: number, vector_out: unknown[], dims_out: Buffer) => number;
|
|
52
|
+
lattice_hash_embed_free: (vector: unknown, dimensions: number) => void;
|
|
53
|
+
lattice_embedding_client_create: (config: unknown, client_out: unknown[]) => number;
|
|
54
|
+
lattice_embedding_client_embed: (client: unknown, text: string, text_len: number, vector_out: unknown[], dims_out: Buffer) => number;
|
|
55
|
+
lattice_embedding_client_free: (client: unknown) => void;
|
|
56
|
+
lattice_version: () => string;
|
|
57
|
+
lattice_error_message: (code: number) => string;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Get the FFI bindings (lazily initialized).
|
|
61
|
+
*/
|
|
62
|
+
export declare function getBindings(): LatticeBindings;
|
|
63
|
+
//# sourceMappingURL=bindings.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../src/ffi/bindings.ts"],"names":[],"mappings":"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"}
|