@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.
@@ -0,0 +1,358 @@
1
+ "use strict";
2
+ /**
3
+ * FFI function bindings to liblattice C API.
4
+ *
5
+ * These are low-level bindings that directly map to the C functions.
6
+ * Use the wrapper in index.ts for a more ergonomic interface.
7
+ */
8
+ var __importDefault = (this && this.__importDefault) || function (mod) {
9
+ return (mod && mod.__esModule) ? mod : { "default": mod };
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.getBindings = getBindings;
13
+ const koffi_1 = __importDefault(require("koffi"));
14
+ const library_1 = require("./library");
15
+ // Define opaque types for handles
16
+ const LatticeDatabase = koffi_1.default.opaque('lattice_database');
17
+ const LatticeTxn = koffi_1.default.opaque('lattice_txn');
18
+ const LatticeQuery = koffi_1.default.opaque('lattice_query');
19
+ const LatticeResult = koffi_1.default.opaque('lattice_result');
20
+ const LatticeVectorResult = koffi_1.default.opaque('lattice_vector_result');
21
+ const LatticeFtsResult = koffi_1.default.opaque('lattice_fts_result');
22
+ const LatticeEdgeResult = koffi_1.default.opaque('lattice_edge_result');
23
+ const LatticeEmbeddingClient = koffi_1.default.opaque('lattice_embedding_client');
24
+ // Define struct for embedding config
25
+ const LatticeEmbeddingConfig = koffi_1.default.struct('lattice_embedding_config', {
26
+ endpoint: 'const char*',
27
+ model: 'const char*',
28
+ api_format: 'int',
29
+ api_key: 'const char*',
30
+ timeout_ms: 'uint32',
31
+ });
32
+ // Define struct for batch insert
33
+ const LatticeNodeWithVector = koffi_1.default.struct('lattice_node_with_vector', {
34
+ label: 'const char*',
35
+ vector: 'const float*',
36
+ dimensions: 'uint32',
37
+ });
38
+ // Define struct for open options
39
+ const LatticeOpenOptions = koffi_1.default.struct('lattice_open_options', {
40
+ create: 'bool',
41
+ read_only: 'bool',
42
+ cache_size_mb: 'uint32',
43
+ page_size: 'uint32',
44
+ enable_vector: 'bool',
45
+ vector_dimensions: 'uint16',
46
+ });
47
+ // Define struct for string in value union
48
+ const LatticeStringValue = koffi_1.default.struct('lattice_string_value', {
49
+ ptr: 'const char*',
50
+ len: 'uintptr_t', // size_t
51
+ });
52
+ // Define struct for bytes in value union
53
+ const LatticeBytesValue = koffi_1.default.struct('lattice_bytes_value', {
54
+ ptr: 'const uint8_t*',
55
+ len: 'uintptr_t', // size_t
56
+ });
57
+ // Define struct for vector in value union
58
+ const LatticeVectorValue = koffi_1.default.struct('lattice_vector_value', {
59
+ ptr: 'const float*',
60
+ dimensions: 'uint32',
61
+ });
62
+ // Define the value union data
63
+ const LatticeValueData = koffi_1.default.union('lattice_value_data', {
64
+ bool_val: 'bool',
65
+ int_val: 'int64',
66
+ float_val: 'double',
67
+ string_val: LatticeStringValue,
68
+ bytes_val: LatticeBytesValue,
69
+ vector_val: LatticeVectorValue,
70
+ });
71
+ // Define the full value struct
72
+ const LatticeValue = koffi_1.default.struct('lattice_value', {
73
+ type: 'int',
74
+ data: LatticeValueData,
75
+ });
76
+ let _bindings = null;
77
+ /**
78
+ * Try to bind a function, returning a throwing stub if not found.
79
+ * This allows graceful handling of functions not yet in the shared library.
80
+ */
81
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
82
+ function tryFunc(lib, name, ret, args) {
83
+ try {
84
+ return lib.func(name, ret, args);
85
+ }
86
+ catch {
87
+ return () => { throw new Error(`Function '${name}' is not available in the shared library`); };
88
+ }
89
+ }
90
+ /**
91
+ * Create the FFI bindings by loading functions from the library.
92
+ */
93
+ function createBindings() {
94
+ const lib = (0, library_1.getLibrary)();
95
+ // Pointer types for out parameters
96
+ const DatabasePtr = koffi_1.default.pointer(LatticeDatabase);
97
+ const DatabasePtrPtr = koffi_1.default.pointer(DatabasePtr);
98
+ const TxnPtr = koffi_1.default.pointer(LatticeTxn);
99
+ const TxnPtrPtr = koffi_1.default.pointer(TxnPtr);
100
+ const QueryPtr = koffi_1.default.pointer(LatticeQuery);
101
+ const QueryPtrPtr = koffi_1.default.pointer(QueryPtr);
102
+ const ResultPtr = koffi_1.default.pointer(LatticeResult);
103
+ const ResultPtrPtr = koffi_1.default.pointer(ResultPtr);
104
+ const VectorResultPtr = koffi_1.default.pointer(LatticeVectorResult);
105
+ const VectorResultPtrPtr = koffi_1.default.pointer(VectorResultPtr);
106
+ const FtsResultPtr = koffi_1.default.pointer(LatticeFtsResult);
107
+ const FtsResultPtrPtr = koffi_1.default.pointer(FtsResultPtr);
108
+ const EdgeResultPtr = koffi_1.default.pointer(LatticeEdgeResult);
109
+ const EdgeResultPtrPtr = koffi_1.default.pointer(EdgeResultPtr);
110
+ const OpenOptionsPtr = koffi_1.default.pointer(LatticeOpenOptions);
111
+ const ValuePtr = koffi_1.default.pointer(LatticeValue);
112
+ const EmbeddingClientPtr = koffi_1.default.pointer(LatticeEmbeddingClient);
113
+ const EmbeddingClientPtrPtr = koffi_1.default.pointer(EmbeddingClientPtr);
114
+ const EmbeddingConfigPtr = koffi_1.default.pointer(LatticeEmbeddingConfig);
115
+ const NodeWithVectorPtr = koffi_1.default.pointer(LatticeNodeWithVector);
116
+ return {
117
+ // Database operations
118
+ lattice_open: lib.func('lattice_open', 'int', [
119
+ 'str', // path
120
+ OpenOptionsPtr, // options
121
+ koffi_1.default.out(DatabasePtrPtr), // db_out
122
+ ]),
123
+ lattice_close: lib.func('lattice_close', 'int', [DatabasePtr]),
124
+ // Transaction operations
125
+ lattice_begin: lib.func('lattice_begin', 'int', [
126
+ DatabasePtr,
127
+ 'int', // mode
128
+ koffi_1.default.out(TxnPtrPtr), // txn_out
129
+ ]),
130
+ lattice_commit: lib.func('lattice_commit', 'int', [TxnPtr]),
131
+ lattice_rollback: lib.func('lattice_rollback', 'int', [TxnPtr]),
132
+ // Node operations
133
+ lattice_node_create: lib.func('lattice_node_create', 'int', [
134
+ TxnPtr,
135
+ 'str', // label
136
+ koffi_1.default.out(koffi_1.default.pointer('uint64')), // node_out
137
+ ]),
138
+ lattice_node_delete: lib.func('lattice_node_delete', 'int', [
139
+ TxnPtr,
140
+ 'uint64', // node_id
141
+ ]),
142
+ lattice_node_exists: lib.func('lattice_node_exists', 'int', [
143
+ TxnPtr,
144
+ 'uint64', // node_id
145
+ koffi_1.default.out(koffi_1.default.pointer('bool')), // exists_out
146
+ ]),
147
+ lattice_node_get_labels: lib.func('lattice_node_get_labels', 'int', [
148
+ TxnPtr,
149
+ 'uint64', // node_id
150
+ koffi_1.default.out(koffi_1.default.pointer('void*')), // labels_out - raw pointer for manual free
151
+ ]),
152
+ lattice_free_string: lib.func('lattice_free_string', 'void', ['void*']),
153
+ lattice_node_set_property: lib.func('lattice_node_set_property', 'int', [
154
+ TxnPtr,
155
+ 'uint64', // node_id
156
+ 'str', // key
157
+ ValuePtr, // value
158
+ ]),
159
+ lattice_node_get_property: lib.func('lattice_node_get_property', 'int', [
160
+ TxnPtr,
161
+ 'uint64', // node_id
162
+ 'str', // key
163
+ koffi_1.default.out(ValuePtr), // value_out
164
+ ]),
165
+ lattice_node_set_vector: lib.func('lattice_node_set_vector', 'int', [
166
+ TxnPtr,
167
+ 'uint64', // node_id
168
+ 'str', // key
169
+ koffi_1.default.pointer('float'), // vector
170
+ 'uint32', // dimensions
171
+ ]),
172
+ lattice_batch_insert: lib.func('lattice_batch_insert', 'int', [
173
+ TxnPtr,
174
+ NodeWithVectorPtr, // nodes array
175
+ 'uint32', // count
176
+ koffi_1.default.out(koffi_1.default.pointer('uint64')), // node_ids_out
177
+ koffi_1.default.out(koffi_1.default.pointer('uint32')), // count_out
178
+ ]),
179
+ // Vector search operations
180
+ lattice_vector_search: lib.func('lattice_vector_search', 'int', [
181
+ DatabasePtr,
182
+ koffi_1.default.pointer('float'), // vector
183
+ 'uint32', // dimensions
184
+ 'uint32', // k
185
+ 'uint16', // ef_search
186
+ koffi_1.default.out(VectorResultPtrPtr), // result_out
187
+ ]),
188
+ lattice_vector_result_count: lib.func('lattice_vector_result_count', 'uint32', [
189
+ VectorResultPtr,
190
+ ]),
191
+ lattice_vector_result_get: lib.func('lattice_vector_result_get', 'int', [
192
+ VectorResultPtr,
193
+ 'uint32', // index
194
+ koffi_1.default.out(koffi_1.default.pointer('uint64')), // node_id_out
195
+ koffi_1.default.out(koffi_1.default.pointer('float')), // distance_out
196
+ ]),
197
+ lattice_vector_result_free: lib.func('lattice_vector_result_free', 'void', [
198
+ VectorResultPtr,
199
+ ]),
200
+ // Full-text search operations
201
+ lattice_fts_index: lib.func('lattice_fts_index', 'int', [
202
+ TxnPtr,
203
+ 'uint64', // node_id
204
+ 'str', // text
205
+ 'uintptr_t', // text_len (size_t)
206
+ ]),
207
+ lattice_fts_search: lib.func('lattice_fts_search', 'int', [
208
+ DatabasePtr,
209
+ 'str', // query
210
+ 'uintptr_t', // query_len (size_t)
211
+ 'uint32', // limit
212
+ koffi_1.default.out(FtsResultPtrPtr), // result_out
213
+ ]),
214
+ lattice_fts_search_fuzzy: tryFunc(lib, 'lattice_fts_search_fuzzy', 'int', [
215
+ DatabasePtr,
216
+ 'str', // query
217
+ 'uintptr_t', // query_len (size_t)
218
+ 'uint32', // limit
219
+ 'uint32', // max_distance
220
+ 'uint32', // min_term_length
221
+ koffi_1.default.out(FtsResultPtrPtr), // result_out
222
+ ]),
223
+ lattice_fts_result_count: lib.func('lattice_fts_result_count', 'uint32', [
224
+ FtsResultPtr,
225
+ ]),
226
+ lattice_fts_result_get: lib.func('lattice_fts_result_get', 'int', [
227
+ FtsResultPtr,
228
+ 'uint32', // index
229
+ koffi_1.default.out(koffi_1.default.pointer('uint64')), // node_id_out
230
+ koffi_1.default.out(koffi_1.default.pointer('float')), // score_out
231
+ ]),
232
+ lattice_fts_result_free: lib.func('lattice_fts_result_free', 'void', [
233
+ FtsResultPtr,
234
+ ]),
235
+ // Edge operations
236
+ lattice_edge_create: lib.func('lattice_edge_create', 'int', [
237
+ TxnPtr,
238
+ 'uint64', // source
239
+ 'uint64', // target
240
+ 'str', // edge_type
241
+ koffi_1.default.out(koffi_1.default.pointer('uint64')), // edge_out
242
+ ]),
243
+ lattice_edge_delete: lib.func('lattice_edge_delete', 'int', [
244
+ TxnPtr,
245
+ 'uint64', // source
246
+ 'uint64', // target
247
+ 'str', // edge_type
248
+ ]),
249
+ lattice_edge_get_outgoing: lib.func('lattice_edge_get_outgoing', 'int', [
250
+ TxnPtr,
251
+ 'uint64', // node_id
252
+ koffi_1.default.out(EdgeResultPtrPtr), // result_out
253
+ ]),
254
+ lattice_edge_get_incoming: lib.func('lattice_edge_get_incoming', 'int', [
255
+ TxnPtr,
256
+ 'uint64', // node_id
257
+ koffi_1.default.out(EdgeResultPtrPtr), // result_out
258
+ ]),
259
+ lattice_edge_result_count: lib.func('lattice_edge_result_count', 'uint32', [
260
+ EdgeResultPtr,
261
+ ]),
262
+ lattice_edge_result_get: lib.func('lattice_edge_result_get', 'int', [
263
+ EdgeResultPtr,
264
+ 'uint32', // index
265
+ koffi_1.default.out(koffi_1.default.pointer('uint64')), // source_out
266
+ koffi_1.default.out(koffi_1.default.pointer('uint64')), // target_out
267
+ koffi_1.default.out(koffi_1.default.pointer('str')), // edge_type_out
268
+ koffi_1.default.out(koffi_1.default.pointer('uint32')), // edge_type_len_out
269
+ ]),
270
+ lattice_edge_result_free: lib.func('lattice_edge_result_free', 'void', [
271
+ EdgeResultPtr,
272
+ ]),
273
+ // Query operations
274
+ lattice_query_prepare: lib.func('lattice_query_prepare', 'int', [
275
+ DatabasePtr,
276
+ 'str', // cypher
277
+ koffi_1.default.out(QueryPtrPtr), // query_out
278
+ ]),
279
+ lattice_query_bind: lib.func('lattice_query_bind', 'int', [
280
+ QueryPtr,
281
+ 'str', // name
282
+ ValuePtr, // value
283
+ ]),
284
+ lattice_query_bind_vector: lib.func('lattice_query_bind_vector', 'int', [
285
+ QueryPtr,
286
+ 'str', // name
287
+ koffi_1.default.pointer('float'), // vector
288
+ 'uint32', // dimensions
289
+ ]),
290
+ lattice_query_execute: lib.func('lattice_query_execute', 'int', [
291
+ QueryPtr,
292
+ TxnPtr,
293
+ koffi_1.default.out(ResultPtrPtr), // result_out
294
+ ]),
295
+ lattice_query_free: lib.func('lattice_query_free', 'void', [QueryPtr]),
296
+ lattice_query_cache_clear: lib.func('lattice_query_cache_clear', 'int', [DatabasePtr]),
297
+ lattice_query_cache_stats: lib.func('lattice_query_cache_stats', 'int', [
298
+ DatabasePtr,
299
+ koffi_1.default.out(koffi_1.default.pointer('uint32')),
300
+ koffi_1.default.out(koffi_1.default.pointer('uint64')),
301
+ koffi_1.default.out(koffi_1.default.pointer('uint64')),
302
+ ]),
303
+ // Result operations
304
+ lattice_result_next: lib.func('lattice_result_next', 'bool', [ResultPtr]),
305
+ lattice_result_column_count: lib.func('lattice_result_column_count', 'uint32', [
306
+ ResultPtr,
307
+ ]),
308
+ lattice_result_column_name: lib.func('lattice_result_column_name', 'str', [
309
+ ResultPtr,
310
+ 'uint32', // index
311
+ ]),
312
+ lattice_result_get: lib.func('lattice_result_get', 'int', [
313
+ ResultPtr,
314
+ 'uint32', // index
315
+ koffi_1.default.out(ValuePtr), // value_out
316
+ ]),
317
+ lattice_result_free: lib.func('lattice_result_free', 'void', [ResultPtr]),
318
+ // Embedding operations (optional - may not be in all builds)
319
+ lattice_hash_embed: tryFunc(lib, 'lattice_hash_embed', 'int', [
320
+ 'str', // text
321
+ 'uintptr_t', // text_len (size_t)
322
+ 'uint16', // dimensions
323
+ koffi_1.default.out(koffi_1.default.pointer(koffi_1.default.pointer('float'))), // vector_out
324
+ koffi_1.default.out(koffi_1.default.pointer('uint32')), // dims_out
325
+ ]),
326
+ lattice_hash_embed_free: tryFunc(lib, 'lattice_hash_embed_free', 'void', [
327
+ koffi_1.default.pointer('float'), // vector
328
+ 'uint32', // dimensions
329
+ ]),
330
+ lattice_embedding_client_create: tryFunc(lib, 'lattice_embedding_client_create', 'int', [
331
+ EmbeddingConfigPtr, // config
332
+ koffi_1.default.out(EmbeddingClientPtrPtr), // client_out
333
+ ]),
334
+ lattice_embedding_client_embed: tryFunc(lib, 'lattice_embedding_client_embed', 'int', [
335
+ EmbeddingClientPtr, // client
336
+ 'str', // text
337
+ 'uintptr_t', // text_len (size_t)
338
+ koffi_1.default.out(koffi_1.default.pointer(koffi_1.default.pointer('float'))), // vector_out
339
+ koffi_1.default.out(koffi_1.default.pointer('uint32')), // dims_out
340
+ ]),
341
+ lattice_embedding_client_free: tryFunc(lib, 'lattice_embedding_client_free', 'void', [
342
+ EmbeddingClientPtr, // client
343
+ ]),
344
+ // Utility
345
+ lattice_version: lib.func('lattice_version', 'str', []),
346
+ lattice_error_message: lib.func('lattice_error_message', 'str', ['int']),
347
+ };
348
+ }
349
+ /**
350
+ * Get the FFI bindings (lazily initialized).
351
+ */
352
+ function getBindings() {
353
+ if (!_bindings) {
354
+ _bindings = createBindings();
355
+ }
356
+ return _bindings;
357
+ }
358
+ //# sourceMappingURL=bindings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bindings.js","sourceRoot":"","sources":["../../src/ffi/bindings.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,299 @@
1
+ /**
2
+ * High-level FFI wrapper with error handling and type conversion.
3
+ *
4
+ * This module provides an ergonomic TypeScript interface to the raw C bindings.
5
+ */
6
+ import { LatticeErrorCode } from './types';
7
+ export { isLibraryAvailable, getLibraryPath } from './library';
8
+ export { LatticeErrorCode, LatticeTxnMode, LatticeValueType } from './types';
9
+ /**
10
+ * Error class for Lattice operations.
11
+ */
12
+ export declare class LatticeError extends Error {
13
+ readonly code: LatticeErrorCode;
14
+ constructor(message: string, code: LatticeErrorCode);
15
+ }
16
+ /**
17
+ * Opaque handle to a database.
18
+ */
19
+ export type DatabaseHandle = unknown;
20
+ /**
21
+ * Opaque handle to a transaction.
22
+ */
23
+ export type TransactionHandle = unknown;
24
+ /**
25
+ * Opaque handle to a query.
26
+ */
27
+ export type QueryHandle = unknown;
28
+ /**
29
+ * Opaque handle to a result set.
30
+ */
31
+ export type ResultHandle = unknown;
32
+ /**
33
+ * Opaque handle to vector search results.
34
+ */
35
+ export type VectorResultHandle = unknown;
36
+ /**
37
+ * Opaque handle to FTS results.
38
+ */
39
+ export type FtsResultHandle = unknown;
40
+ /**
41
+ * Opaque handle to edge results.
42
+ */
43
+ export type EdgeResultHandle = unknown;
44
+ /**
45
+ * Opaque handle to an embedding client.
46
+ */
47
+ export type EmbeddingClientHandle = unknown;
48
+ /**
49
+ * Options for opening a database.
50
+ */
51
+ export interface OpenOptions {
52
+ create?: boolean;
53
+ readOnly?: boolean;
54
+ cacheSizeMb?: number;
55
+ pageSize?: number;
56
+ enableVector?: boolean;
57
+ vectorDimensions?: number;
58
+ }
59
+ /**
60
+ * High-level FFI wrapper class.
61
+ */
62
+ export declare class LatticeFFI {
63
+ private bindings;
64
+ constructor();
65
+ /**
66
+ * Check an error code and throw if not OK.
67
+ */
68
+ private checkError;
69
+ /**
70
+ * Get the library version.
71
+ */
72
+ version(): string;
73
+ /**
74
+ * Open a database.
75
+ */
76
+ open(path: string, options?: OpenOptions): DatabaseHandle;
77
+ /**
78
+ * Close a database.
79
+ */
80
+ close(db: DatabaseHandle): void;
81
+ /**
82
+ * Begin a transaction.
83
+ */
84
+ begin(db: DatabaseHandle, readOnly: boolean): TransactionHandle;
85
+ /**
86
+ * Commit a transaction.
87
+ */
88
+ commit(txn: TransactionHandle): void;
89
+ /**
90
+ * Rollback a transaction.
91
+ */
92
+ rollback(txn: TransactionHandle): void;
93
+ /**
94
+ * Create a node with an optional label.
95
+ */
96
+ createNode(txn: TransactionHandle, label?: string): bigint;
97
+ /**
98
+ * Delete a node.
99
+ */
100
+ deleteNode(txn: TransactionHandle, nodeId: bigint): void;
101
+ /**
102
+ * Check if a node exists.
103
+ */
104
+ nodeExists(txn: TransactionHandle, nodeId: bigint): boolean;
105
+ /**
106
+ * Get labels for a node.
107
+ */
108
+ getNodeLabels(txn: TransactionHandle, nodeId: bigint): string[];
109
+ /**
110
+ * Set a vector on a node.
111
+ */
112
+ setVector(txn: TransactionHandle, nodeId: bigint, key: string, vector: Float32Array): void;
113
+ /**
114
+ * Batch insert multiple nodes with vectors.
115
+ */
116
+ batchInsert(txn: TransactionHandle, nodes: Array<{
117
+ label: string;
118
+ vector: Float32Array;
119
+ }>): bigint[];
120
+ /**
121
+ * Set a property on a node.
122
+ */
123
+ setProperty(txn: TransactionHandle, nodeId: bigint, key: string, value: unknown): void;
124
+ /**
125
+ * Get a property from a node.
126
+ */
127
+ getProperty(txn: TransactionHandle, nodeId: bigint, key: string): unknown;
128
+ /**
129
+ * Get a value from a result set column.
130
+ */
131
+ resultGet(result: ResultHandle, index: number): unknown;
132
+ /**
133
+ * Bind a parameter to a query.
134
+ */
135
+ queryBind(query: QueryHandle, name: string, value: unknown): void;
136
+ /**
137
+ * Create an empty LatticeValue for use as an out parameter.
138
+ * koffi needs all union fields present to decode output properly.
139
+ */
140
+ private makeEmptyValue;
141
+ /**
142
+ * Convert a JS value to a LatticeValue struct for FFI.
143
+ * koffi unions require an object with a single property naming the active variant.
144
+ */
145
+ private jsToLatticeValue;
146
+ /**
147
+ * Convert a LatticeValue struct from FFI to a JS value.
148
+ */
149
+ private latticeValueToJs;
150
+ /**
151
+ * Search for similar vectors.
152
+ */
153
+ vectorSearch(db: DatabaseHandle, vector: Float32Array, k: number, efSearch?: number): VectorResultHandle;
154
+ /**
155
+ * Get the count of vector search results.
156
+ */
157
+ vectorResultCount(result: VectorResultHandle): number;
158
+ /**
159
+ * Get a vector search result by index.
160
+ */
161
+ vectorResultGet(result: VectorResultHandle, index: number): {
162
+ nodeId: bigint;
163
+ distance: number;
164
+ };
165
+ /**
166
+ * Free vector search results.
167
+ */
168
+ vectorResultFree(result: VectorResultHandle): void;
169
+ /**
170
+ * Index a document for full-text search.
171
+ */
172
+ ftsIndex(txn: TransactionHandle, nodeId: bigint, text: string): void;
173
+ /**
174
+ * Search for documents.
175
+ */
176
+ ftsSearch(db: DatabaseHandle, query: string, limit: number): FtsResultHandle;
177
+ /**
178
+ * Search for documents with fuzzy matching.
179
+ */
180
+ ftsSearchFuzzy(db: DatabaseHandle, query: string, limit: number, maxDistance?: number, minTermLength?: number): FtsResultHandle;
181
+ /**
182
+ * Get the count of FTS results.
183
+ */
184
+ ftsResultCount(result: FtsResultHandle): number;
185
+ /**
186
+ * Get an FTS result by index.
187
+ */
188
+ ftsResultGet(result: FtsResultHandle, index: number): {
189
+ nodeId: bigint;
190
+ score: number;
191
+ };
192
+ /**
193
+ * Free FTS results.
194
+ */
195
+ ftsResultFree(result: FtsResultHandle): void;
196
+ /**
197
+ * Create an edge between two nodes.
198
+ */
199
+ createEdge(txn: TransactionHandle, source: bigint, target: bigint, edgeType: string): bigint;
200
+ /**
201
+ * Delete an edge.
202
+ */
203
+ deleteEdge(txn: TransactionHandle, source: bigint, target: bigint, edgeType: string): void;
204
+ /**
205
+ * Get outgoing edges from a node.
206
+ */
207
+ getOutgoingEdges(txn: TransactionHandle, nodeId: bigint): EdgeResultHandle;
208
+ /**
209
+ * Get incoming edges to a node.
210
+ */
211
+ getIncomingEdges(txn: TransactionHandle, nodeId: bigint): EdgeResultHandle;
212
+ /**
213
+ * Get the count of edge results.
214
+ */
215
+ edgeResultCount(result: EdgeResultHandle): number;
216
+ /**
217
+ * Get an edge result by index.
218
+ */
219
+ edgeResultGet(result: EdgeResultHandle, index: number): {
220
+ source: bigint;
221
+ target: bigint;
222
+ edgeType: string;
223
+ };
224
+ /**
225
+ * Free edge results.
226
+ */
227
+ edgeResultFree(result: EdgeResultHandle): void;
228
+ /**
229
+ * Prepare a Cypher query.
230
+ */
231
+ queryPrepare(db: DatabaseHandle, cypher: string): QueryHandle;
232
+ /**
233
+ * Bind a vector parameter to a query.
234
+ */
235
+ queryBindVector(query: QueryHandle, name: string, vector: Float32Array): void;
236
+ /**
237
+ * Execute a prepared query.
238
+ */
239
+ queryExecute(query: QueryHandle, txn: TransactionHandle): ResultHandle;
240
+ /**
241
+ * Free a prepared query.
242
+ */
243
+ queryFree(query: QueryHandle): void;
244
+ /**
245
+ * Clear the query cache.
246
+ */
247
+ cacheClear(db: DatabaseHandle): void;
248
+ /**
249
+ * Get query cache statistics.
250
+ */
251
+ cacheStats(db: DatabaseHandle): {
252
+ entries: number;
253
+ hits: number;
254
+ misses: number;
255
+ };
256
+ /**
257
+ * Advance to the next row in results.
258
+ */
259
+ resultNext(result: ResultHandle): boolean;
260
+ /**
261
+ * Get the column count.
262
+ */
263
+ resultColumnCount(result: ResultHandle): number;
264
+ /**
265
+ * Get a column name.
266
+ */
267
+ resultColumnName(result: ResultHandle, index: number): string;
268
+ /**
269
+ * Free a result set.
270
+ */
271
+ resultFree(result: ResultHandle): void;
272
+ /**
273
+ * Generate a hash embedding (built-in, no external service).
274
+ */
275
+ hashEmbed(text: string, dimensions: number): Float32Array;
276
+ /**
277
+ * Create an HTTP embedding client.
278
+ */
279
+ embeddingClientCreate(config: {
280
+ endpoint: string;
281
+ model?: string;
282
+ apiFormat?: number;
283
+ apiKey?: string | null;
284
+ timeoutMs?: number;
285
+ }): EmbeddingClientHandle;
286
+ /**
287
+ * Generate an embedding via an HTTP embedding client.
288
+ */
289
+ embeddingClientEmbed(client: EmbeddingClientHandle, text: string): Float32Array;
290
+ /**
291
+ * Free an HTTP embedding client.
292
+ */
293
+ embeddingClientFree(client: EmbeddingClientHandle): void;
294
+ }
295
+ /**
296
+ * Get the FFI instance (lazily initialized).
297
+ */
298
+ export declare function getFFI(): LatticeFFI;
299
+ //# sourceMappingURL=index.d.ts.map