eigen-db 4.3.0 → 5.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/dist/eigen-db.js CHANGED
@@ -1,9 +1,9 @@
1
- class k extends Error {
1
+ class x extends Error {
2
2
  constructor(e) {
3
3
  super(`Capacity exceeded. Max vectors for this dimension size is ~${e}.`), this.name = "VectorCapacityExceededError";
4
4
  }
5
5
  }
6
- class _ {
6
+ class N {
7
7
  dirHandle = null;
8
8
  dirName;
9
9
  constructor(e) {
@@ -25,7 +25,7 @@ class _ {
25
25
  }
26
26
  }
27
27
  async append(e, t) {
28
- const s = await (await this.getDir()).getFileHandle(e, { create: !0 }), n = await s.createWritable({ keepExistingData: !0 }), i = await s.getFile();
28
+ const r = await (await this.getDir()).getFileHandle(e, { create: !0 }), n = await r.createWritable({ keepExistingData: !0 }), i = await r.getFile();
29
29
  await n.seek(i.size), await n.write(t), await n.close();
30
30
  }
31
31
  async write(e, t) {
@@ -36,16 +36,16 @@ class _ {
36
36
  await (await navigator.storage.getDirectory()).removeEntry(this.dirName, { recursive: !0 }), this.dirHandle = null;
37
37
  }
38
38
  }
39
- class v {
39
+ class U {
40
40
  files = /* @__PURE__ */ new Map();
41
41
  async readAll(e) {
42
42
  const t = this.files.get(e);
43
43
  if (!t || t.length === 0) return new Uint8Array(0);
44
- const r = t.reduce((i, a) => i + a.byteLength, 0), s = new Uint8Array(r);
44
+ const s = t.reduce((i, a) => i + a.byteLength, 0), r = new Uint8Array(s);
45
45
  let n = 0;
46
46
  for (const i of t)
47
- s.set(i, n), n += i.byteLength;
48
- return s;
47
+ r.set(i, n), n += i.byteLength;
48
+ return r;
49
49
  }
50
50
  async append(e, t) {
51
51
  this.files.has(e) || this.files.set(e, []), this.files.get(e).push(new Uint8Array(t));
@@ -57,46 +57,46 @@ class v {
57
57
  this.files.clear();
58
58
  }
59
59
  }
60
- function S(c) {
60
+ function T(o) {
61
61
  let e = 0;
62
- for (let s = 0; s < c.length; s++)
63
- e += c[s] * c[s];
62
+ for (let r = 0; r < o.length; r++)
63
+ e += o[r] * o[r];
64
64
  const t = Math.sqrt(e);
65
65
  if (t === 0) return;
66
- const r = 1 / t;
67
- for (let s = 0; s < c.length; s++)
68
- c[s] *= r;
66
+ const s = 1 / t;
67
+ for (let r = 0; r < o.length; r++)
68
+ o[r] *= s;
69
69
  }
70
- function O(c, e, t, r, s) {
71
- for (let n = 0; n < r; n++) {
70
+ function Q(o, e, t, s, r) {
71
+ for (let n = 0; n < s; n++) {
72
72
  let i = 0;
73
- const a = n * s;
74
- for (let o = 0; o < s; o++)
75
- i += c[o] * e[a + o];
73
+ const a = n * r;
74
+ for (let c = 0; c < r; c++)
75
+ i += o[c] * e[a + c];
76
76
  t[n] = i;
77
77
  }
78
78
  }
79
- const U = new TextEncoder(), x = new TextDecoder();
80
- function d(c) {
81
- const e = c.map((a) => U.encode(a)), t = e.reduce((a, o) => a + 4 + o.byteLength, 0), r = new ArrayBuffer(t), s = new DataView(r), n = new Uint8Array(r);
79
+ const V = new TextEncoder(), _ = new TextDecoder();
80
+ function b(o) {
81
+ const e = o.map((a) => V.encode(a)), t = e.reduce((a, c) => a + 4 + c.byteLength, 0), s = new ArrayBuffer(t), r = new DataView(s), n = new Uint8Array(s);
82
82
  let i = 0;
83
83
  for (const a of e)
84
- s.setUint32(i, a.byteLength, !0), i += 4, n.set(a, i), i += a.byteLength;
84
+ r.setUint32(i, a.byteLength, !0), i += 4, n.set(a, i), i += a.byteLength;
85
85
  return n;
86
86
  }
87
- function g(c) {
88
- const e = [], t = new DataView(c.buffer, c.byteOffset, c.byteLength);
89
- let r = 0;
90
- for (; r < c.byteLength; ) {
91
- const s = t.getUint32(r, !0);
92
- r += 4;
93
- const n = x.decode(c.subarray(r, r + s));
94
- e.push(n), r += s;
87
+ function C(o) {
88
+ const e = [], t = new DataView(o.buffer, o.byteOffset, o.byteLength);
89
+ let s = 0;
90
+ for (; s < o.byteLength; ) {
91
+ const r = t.getUint32(s, !0);
92
+ s += 4;
93
+ const n = _.decode(o.subarray(s, s + r));
94
+ e.push(n), s += r;
95
95
  }
96
96
  return e;
97
97
  }
98
- const m = 65536, w = 65536;
99
- class Q {
98
+ const m = 65536, E = 65536;
99
+ class D {
100
100
  memory;
101
101
  dimensions;
102
102
  queryOffset;
@@ -104,9 +104,9 @@ class Q {
104
104
  _vectorCount;
105
105
  constructor(e, t = 0) {
106
106
  this.dimensions = e, this.queryOffset = 0;
107
- const r = e * 4;
108
- this.dbOffset = Math.ceil(r / m) * m;
109
- const s = t * e * 4, n = this.dbOffset + s, i = Math.max(1, Math.ceil(n / m));
107
+ const s = e * 4;
108
+ this.dbOffset = Math.ceil(s / m) * m;
109
+ const r = t * e * 4, n = this.dbOffset + r, i = Math.max(1, Math.ceil(n / m));
110
110
  this.memory = new WebAssembly.Memory({ initial: i }), this._vectorCount = t;
111
111
  }
112
112
  /** Current number of vectors stored */
@@ -126,7 +126,7 @@ class Q {
126
126
  * Accounts for query buffer, DB space, and scores buffer.
127
127
  */
128
128
  get maxVectors() {
129
- const e = w * m - this.dbOffset, t = this.dimensions * 4 + 4;
129
+ const e = E * m - this.dbOffset, t = this.dimensions * 4 + 4;
130
130
  return Math.floor(e / t);
131
131
  }
132
132
  /**
@@ -134,10 +134,10 @@ class Q {
134
134
  * Calls memory.grow() if needed.
135
135
  */
136
136
  ensureCapacity(e) {
137
- const t = this._vectorCount + e, r = this.dbOffset + t * this.dimensions * 4 + t * 4, s = this.memory.buffer.byteLength;
138
- if (r > s) {
139
- const n = Math.ceil((r - s) / m);
140
- if (s / m + n > w)
137
+ const t = this._vectorCount + e, s = this.dbOffset + t * this.dimensions * 4 + t * 4, r = this.memory.buffer.byteLength;
138
+ if (s > r) {
139
+ const n = Math.ceil((s - r) / m);
140
+ if (r / m + n > E)
141
141
  throw new Error("WASM memory limit exceeded");
142
142
  this.memory.grow(n);
143
143
  }
@@ -154,9 +154,9 @@ class Q {
154
154
  */
155
155
  appendVectors(e) {
156
156
  const t = this.dbOffset + this._vectorCount * this.dimensions * 4;
157
- let r = t;
158
- for (const s of e)
159
- new Float32Array(this.memory.buffer, r, this.dimensions).set(s), r += this.dimensions * 4;
157
+ let s = t;
158
+ for (const r of e)
159
+ new Float32Array(this.memory.buffer, s, this.dimensions).set(r), s += this.dimensions * 4;
160
160
  return this._vectorCount += e.length, t;
161
161
  }
162
162
  /**
@@ -183,8 +183,8 @@ class Q {
183
183
  * Write a vector to a specific slot in the database region.
184
184
  */
185
185
  writeVector(e, t) {
186
- const r = this.dbOffset + e * this.dimensions * 4;
187
- new Float32Array(this.memory.buffer, r, this.dimensions).set(t);
186
+ const s = this.dbOffset + e * this.dimensions * 4;
187
+ new Float32Array(this.memory.buffer, s, this.dimensions).set(t);
188
188
  }
189
189
  /**
190
190
  * Reset the vector count to zero, logically clearing the database.
@@ -201,59 +201,62 @@ class Q {
201
201
  this._vectorCount = e;
202
202
  }
203
203
  }
204
- function D(c, e, t, r) {
205
- const s = c.length;
206
- if (s === 0) return [];
207
- const n = new Uint32Array(s);
208
- for (let o = 0; o < s; o++) n[o] = o;
209
- n.sort((o, h) => c[h] - c[o]);
210
- const i = Math.min(t, s), a = [];
211
- for (let o = 0; o < i; o++) {
212
- const h = n[o], f = c[h];
213
- if (r !== void 0 && f < r) break;
214
- a.push({ key: e(h), similarity: f });
215
- }
216
- return a;
204
+ function p(o, e, t) {
205
+ return !(e !== void 0 && o < e || t !== void 0 && o > t);
217
206
  }
218
- function L(c, e, t, r) {
219
- const s = c.length;
220
- if (s === 0) return [];
221
- const n = new Uint32Array(s);
222
- for (let a = 0; a < s; a++) n[a] = a;
223
- n.sort((a, o) => c[o] - c[a]);
224
- const i = Math.min(t, s);
225
- return {
207
+ function L(o, e, t) {
208
+ const { limit: s, order: r, minSimilarity: n, maxSimilarity: i } = t, a = o.length;
209
+ if (a === 0) return [];
210
+ const c = new Uint32Array(a);
211
+ for (let l = 0; l < a; l++) c[l] = l;
212
+ r === "ascend" ? c.sort((l, y) => o[l] - o[y]) : c.sort((l, y) => o[y] - o[l]);
213
+ const A = Math.min(s, a), h = [];
214
+ for (let l = 0; l < a && h.length < A; l++) {
215
+ const y = c[l], f = o[y];
216
+ p(f, n, i) && h.push({ key: e(y), similarity: f });
217
+ }
218
+ return h;
219
+ }
220
+ function F(o, e, t) {
221
+ const { limit: s, order: r, minSimilarity: n, maxSimilarity: i } = t, a = o.length;
222
+ if (a === 0) return [];
223
+ const c = new Uint32Array(a);
224
+ for (let A = 0; A < a; A++) c[A] = A;
225
+ return r === "ascend" ? c.sort((A, h) => o[A] - o[h]) : c.sort((A, h) => o[h] - o[A]), {
226
226
  [Symbol.iterator]() {
227
- let a = 0;
227
+ let A = 0, h = 0;
228
228
  return {
229
229
  next() {
230
- if (a >= i) return { done: !0, value: void 0 };
231
- const o = n[a++], h = c[o];
232
- return r !== void 0 && h < r ? { done: !0, value: void 0 } : {
233
- done: !1,
234
- value: { key: e(o), similarity: h }
235
- };
230
+ for (; A < a && h < s; ) {
231
+ const l = c[A++], y = o[l];
232
+ if (p(y, n, i))
233
+ return h++, {
234
+ done: !1,
235
+ value: { key: e(l), similarity: y }
236
+ };
237
+ }
238
+ return { done: !0, value: void 0 };
236
239
  }
237
240
  };
238
241
  }
239
242
  };
240
243
  }
241
- const V = "AGFzbQEAAAABDgJgAn9/AGAFf39/f38AAg8BA2VudgZtZW1vcnkCAAEDAwIAAQcaAglub3JtYWxpemUAAApzZWFyY2hfYWxsAAEKpgQCrQIFAX8BewN9AXsCf/0MAAAAAAAAAAAAAAAAAAAAACEDIAFBfHEhCEEAIQICQANAIAIgCE8NASAAIAJBAnRqIQkgAyAJ/QAEACAJ/QAEAP3mAf3kASEDIAJBBGohAgwACwsgA/0fACAD/R8BkiAD/R8CIAP9HwOSkiEEAkADQCACIAFPDQEgACACQQJ0aiEJIAQgCSoCACAJKgIAlJIhBCACQQFqIQIMAAsLIASRIQUgBUMAAAAAWwRADwtDAACAPyAFlSEGIAb9EyEHQQAhAgJAA0AgAiAITw0BIAAgAkECdGohCSAJIAn9AAQAIAf95gH9CwQAIAJBBGohAgwACwsCQANAIAIgAU8NASAAIAJBAnRqIQkgCSAJKgIAIAaUOAIAIAJBAWohAgwACwsL9AEEAn8BewF9BX8gBEF8cSEKIARBAnQhDUEAIQUCQANAIAUgA08NASABIAUgDWxqIQn9DAAAAAAAAAAAAAAAAAAAAAAhB0EAIQYCQANAIAYgCk8NASAAIAZBAnRqIQsgCSAGQQJ0aiEMIAcgC/0ABAAgDP0ABAD95gH95AEhByAGQQRqIQYMAAsLIAf9HwAgB/0fAZIgB/0fAiAH/R8DkpIhCAJAA0AgBiAETw0BIAAgBkECdGohCyAJIAZBAnRqIQwgCCALKgIAIAwqAgCUkiEIIAZBAWohBgwACwsgAiAFQQJ0aiAIOAIAIAVBAWohBQwACwsL";
242
- function T() {
243
- const c = atob(V), e = new Uint8Array(c.length);
244
- for (let t = 0; t < c.length; t++)
245
- e[t] = c.charCodeAt(t);
244
+ const z = "AGFzbQEAAAABDgJgAn9/AGAFf39/f38AAg8BA2VudgZtZW1vcnkCAAEDAwIAAQcaAglub3JtYWxpemUAAApzZWFyY2hfYWxsAAEKpgQCrQIFAX8BewN9AXsCf/0MAAAAAAAAAAAAAAAAAAAAACEDIAFBfHEhCEEAIQICQANAIAIgCE8NASAAIAJBAnRqIQkgAyAJ/QAEACAJ/QAEAP3mAf3kASEDIAJBBGohAgwACwsgA/0fACAD/R8BkiAD/R8CIAP9HwOSkiEEAkADQCACIAFPDQEgACACQQJ0aiEJIAQgCSoCACAJKgIAlJIhBCACQQFqIQIMAAsLIASRIQUgBUMAAAAAWwRADwtDAACAPyAFlSEGIAb9EyEHQQAhAgJAA0AgAiAITw0BIAAgAkECdGohCSAJIAn9AAQAIAf95gH9CwQAIAJBBGohAgwACwsCQANAIAIgAU8NASAAIAJBAnRqIQkgCSAJKgIAIAaUOAIAIAJBAWohAgwACwsL9AEEAn8BewF9BX8gBEF8cSEKIARBAnQhDUEAIQUCQANAIAUgA08NASABIAUgDWxqIQn9DAAAAAAAAAAAAAAAAAAAAAAhB0EAIQYCQANAIAYgCk8NASAAIAZBAnRqIQsgCSAGQQJ0aiEMIAcgC/0ABAAgDP0ABAD95gH95AEhByAGQQRqIQYMAAsLIAf9HwAgB/0fAZIgB/0fAiAH/R8DkpIhCAJAA0AgBiAETw0BIAAgBkECdGohCyAJIAZBAnRqIQwgCCALKgIAIAwqAgCUkiEIIAZBAWohBgwACwsgAiAFQQJ0aiAIOAIAIAVBAWohBQwACwsL";
245
+ function q() {
246
+ const o = atob(z), e = new Uint8Array(o.length);
247
+ for (let t = 0; t < o.length; t++)
248
+ e[t] = o.charCodeAt(t);
246
249
  return e;
247
250
  }
248
- async function F(c, e) {
251
+ async function R(o, e) {
249
252
  const t = { env: { memory: e } };
250
- return (await WebAssembly.instantiate(c, t)).instance.exports;
253
+ return (await WebAssembly.instantiate(o, t)).instance.exports;
251
254
  }
252
- const b = "vectors.bin", E = "keys.bin", C = 1111770949, u = 1, I = 24, z = 65536;
253
- class M {
255
+ const I = "vectors.bin", M = "keys.bin", S = 1111770949, d = 1, B = 24, H = 65536;
256
+ class k {
254
257
  memoryManager;
255
258
  storage;
256
- dimensions;
259
+ _dimensions;
257
260
  shouldNormalize;
258
261
  wasmExports;
259
262
  /** Maps key to its slot index in the vector array */
@@ -262,46 +265,98 @@ class M {
262
265
  slotToKey;
263
266
  /** Whether this instance has been closed */
264
267
  closed = !1;
265
- constructor(e, t, r, s, n, i, a) {
266
- this.memoryManager = e, this.storage = t, this.dimensions = r, this.shouldNormalize = s, this.wasmExports = n, this.keyToSlot = i, this.slotToKey = a;
268
+ constructor(e, t, s, r, n, i, a) {
269
+ this.memoryManager = e, this.storage = t, this._dimensions = s, this.shouldNormalize = r, this.wasmExports = n, this.keyToSlot = i, this.slotToKey = a;
267
270
  }
268
271
  static async open(e) {
269
- const t = e.storage ?? new v(), r = e.normalize !== !1, [s, n] = await Promise.all([t.readAll(b), t.readAll(E)]), i = n.byteLength > 0 ? g(n) : [], a = s.byteLength / (e.dimensions * 4), o = /* @__PURE__ */ new Map(), h = [];
270
- for (let A = 0; A < i.length; A++)
271
- o.set(i[A], A), h[A] = i[A];
272
- const f = new Q(e.dimensions, a);
273
- s.byteLength > 0 && f.loadVectorBytes(s, a);
272
+ const t = e.storage ?? new U(), s = e.normalize !== !1, [r, n] = await Promise.all([t.readAll(I), t.readAll(M)]), i = n.byteLength > 0 ? C(n) : [], a = r.byteLength / (e.dimensions * 4), c = /* @__PURE__ */ new Map(), A = [];
273
+ for (let f = 0; f < i.length; f++)
274
+ c.set(i[f], f), A[f] = i[f];
275
+ const h = new D(e.dimensions, a);
276
+ r.byteLength > 0 && h.loadVectorBytes(r, a);
274
277
  let l = null;
275
- const y = e.wasmBinary !== void 0 ? e.wasmBinary : T();
278
+ const y = e.wasmBinary !== void 0 ? e.wasmBinary : q();
276
279
  if (y !== null)
277
280
  try {
278
- l = await F(y, f.memory);
281
+ l = await R(y, h.memory);
279
282
  } catch {
280
283
  }
281
- return new M(f, t, e.dimensions, r, l, o, h);
284
+ return new k(h, t, e.dimensions, s, l, c, A);
282
285
  }
283
286
  /** Total number of key-value pairs in the database */
284
287
  get size() {
285
288
  return this.keyToSlot.size;
286
289
  }
290
+ /** Number of dimensions per vector */
291
+ get dimensions() {
292
+ return this._dimensions;
293
+ }
294
+ /**
295
+ * Check whether a key exists in the database.
296
+ * Uses the internal key-to-slot map for O(1) lookup.
297
+ */
298
+ has(e) {
299
+ return this.assertOpen(), this.keyToSlot.has(e);
300
+ }
301
+ /**
302
+ * Delete an entry by key. Returns true if the key existed, false otherwise.
303
+ * Uses swap-and-pop to avoid gaps in the underlying vector array.
304
+ */
305
+ delete(e) {
306
+ this.assertOpen();
307
+ const t = this.keyToSlot.get(e);
308
+ if (t === void 0) return !1;
309
+ const s = this.memoryManager.vectorCount - 1;
310
+ if (t !== s) {
311
+ const r = new Float32Array(this.memoryManager.readVector(s));
312
+ this.memoryManager.writeVector(t, r);
313
+ const n = this.slotToKey[s];
314
+ this.keyToSlot.set(n, t), this.slotToKey[t] = n;
315
+ }
316
+ return this.keyToSlot.delete(e), this.slotToKey.length = s, this.memoryManager.setVectorCount(s), !0;
317
+ }
318
+ /**
319
+ * Returns an iterable of all keys in the database.
320
+ */
321
+ keys() {
322
+ return this.assertOpen(), this.keyToSlot.keys();
323
+ }
324
+ /**
325
+ * Returns an iterable of [key, value] pairs.
326
+ * Values are returned as plain number array copies.
327
+ */
328
+ entries() {
329
+ this.assertOpen();
330
+ const e = this.keyToSlot, t = this.memoryManager;
331
+ return (function* () {
332
+ for (const [s, r] of e)
333
+ yield [s, Array.from(t.readVector(r))];
334
+ })();
335
+ }
336
+ /**
337
+ * Implements the iterable protocol. Same as entries().
338
+ */
339
+ [Symbol.iterator]() {
340
+ return this.entries();
341
+ }
287
342
  /**
288
343
  * Set a key-value pair. If the key already exists, its vector is overwritten (last-write-wins).
289
344
  * The value is a number[] or Float32Array of length equal to the configured dimensions.
290
345
  */
291
- set(e, t, r) {
292
- if (this.assertOpen(), t.length !== this.dimensions)
293
- throw new Error(`Vector dimension mismatch: expected ${this.dimensions}, got ${t.length}`);
294
- const s = new Float32Array(t);
295
- (r?.normalize ?? this.shouldNormalize) && this.normalizeVector(s);
346
+ set(e, t, s) {
347
+ if (this.assertOpen(), t.length !== this._dimensions)
348
+ throw new Error(`Vector dimension mismatch: expected ${this._dimensions}, got ${t.length}`);
349
+ const r = new Float32Array(t);
350
+ (s?.normalize ?? this.shouldNormalize) && this.normalizeVector(r);
296
351
  const i = this.keyToSlot.get(e);
297
352
  if (i !== void 0)
298
- this.memoryManager.writeVector(i, s);
353
+ this.memoryManager.writeVector(i, r);
299
354
  else {
300
355
  if (this.memoryManager.vectorCount + 1 > this.memoryManager.maxVectors)
301
- throw new k(this.memoryManager.maxVectors);
356
+ throw new x(this.memoryManager.maxVectors);
302
357
  this.memoryManager.ensureCapacity(1);
303
- const o = this.memoryManager.vectorCount;
304
- this.memoryManager.appendVectors([s]), this.keyToSlot.set(e, o), this.slotToKey[o] = e;
358
+ const c = this.memoryManager.vectorCount;
359
+ this.memoryManager.appendVectors([r]), this.keyToSlot.set(e, c), this.slotToKey[c] = e;
305
360
  }
306
361
  }
307
362
  /**
@@ -318,8 +373,8 @@ class M {
318
373
  * Set multiple key-value pairs at once. Last-write-wins applies within the batch.
319
374
  */
320
375
  setMany(e) {
321
- for (const [t, r] of e)
322
- this.set(t, r);
376
+ for (const [t, s] of e)
377
+ this.set(t, s);
323
378
  }
324
379
  /**
325
380
  * Get vectors for multiple keys. Returns undefined for keys that don't exist.
@@ -329,53 +384,53 @@ class M {
329
384
  }
330
385
  query(e, t) {
331
386
  this.assertOpen();
332
- const r = t?.topK ?? 1 / 0, s = t?.minSimilarity, n = t && "iterable" in t && t.iterable;
387
+ const s = t?.limit ?? 1 / 0, r = t?.order ?? "descend", n = t?.minSimilarity, i = t?.maxSimilarity, a = t && "iterable" in t && t.iterable;
333
388
  if (this.size === 0)
334
389
  return [];
335
- if (e.length !== this.dimensions)
336
- throw new Error(`Query vector dimension mismatch: expected ${this.dimensions}, got ${e.length}`);
337
- const i = new Float32Array(e);
338
- (t?.normalize ?? this.shouldNormalize) && this.normalizeVector(i), this.memoryManager.writeQuery(i), this.memoryManager.ensureCapacity(0);
339
- const o = this.memoryManager.vectorCount, h = this.memoryManager.scoresOffset;
390
+ if (e.length !== this._dimensions)
391
+ throw new Error(`Query vector dimension mismatch: expected ${this._dimensions}, got ${e.length}`);
392
+ const c = new Float32Array(e);
393
+ (t?.normalize ?? this.shouldNormalize) && this.normalizeVector(c), this.memoryManager.writeQuery(c), this.memoryManager.ensureCapacity(0);
394
+ const h = this.memoryManager.vectorCount, l = this.memoryManager.scoresOffset;
340
395
  if (this.wasmExports)
341
396
  this.wasmExports.search_all(
342
397
  this.memoryManager.queryOffset,
343
398
  this.memoryManager.dbOffset,
399
+ l,
344
400
  h,
345
- o,
346
- this.dimensions
401
+ this._dimensions
347
402
  );
348
403
  else {
349
- const A = new Float32Array(
404
+ const u = new Float32Array(
350
405
  this.memoryManager.memory.buffer,
351
406
  this.memoryManager.queryOffset,
352
- this.dimensions
353
- ), B = new Float32Array(
407
+ this._dimensions
408
+ ), O = new Float32Array(
354
409
  this.memoryManager.memory.buffer,
355
410
  this.memoryManager.dbOffset,
356
- o * this.dimensions
357
- ), p = new Float32Array(this.memoryManager.memory.buffer, h, o);
358
- O(A, B, p, o, this.dimensions);
411
+ h * this._dimensions
412
+ ), v = new Float32Array(this.memoryManager.memory.buffer, l, h);
413
+ Q(u, O, v, h, this._dimensions);
359
414
  }
360
- const f = new Float32Array(this.memoryManager.readScores()), l = this.slotToKey, y = (A) => l[A];
361
- return n ? L(f, y, r, s) : D(f, y, r, s);
415
+ const y = new Float32Array(this.memoryManager.readScores()), f = this.slotToKey, g = (u) => f[u], w = { limit: s, order: r, minSimilarity: n, maxSimilarity: i };
416
+ return a ? F(y, g, w) : L(y, g, w);
362
417
  }
363
418
  /**
364
419
  * Persist the current in-memory state to storage.
365
420
  */
366
421
  async flush() {
367
422
  this.assertOpen();
368
- const e = this.memoryManager.vectorCount, t = new Uint8Array(e * this.dimensions * 4);
423
+ const e = this.memoryManager.vectorCount, t = new Uint8Array(e * this._dimensions * 4);
369
424
  if (e > 0) {
370
- const s = new Uint8Array(
425
+ const r = new Uint8Array(
371
426
  this.memoryManager.memory.buffer,
372
427
  this.memoryManager.dbOffset,
373
- e * this.dimensions * 4
428
+ e * this._dimensions * 4
374
429
  );
375
- t.set(s);
430
+ t.set(r);
376
431
  }
377
- const r = d(this.slotToKey);
378
- await Promise.all([this.storage.write(b, t), this.storage.write(E, r)]);
432
+ const s = b(this.slotToKey);
433
+ await Promise.all([this.storage.write(I, t), this.storage.write(M, s)]);
379
434
  }
380
435
  /**
381
436
  * Flush data to storage and release the instance.
@@ -401,23 +456,23 @@ class M {
401
456
  */
402
457
  async export() {
403
458
  this.assertOpen();
404
- const e = this.memoryManager.vectorCount, t = e * this.dimensions * 4, r = d(this.slotToKey), s = r.byteLength, n = new ArrayBuffer(I), i = new DataView(n);
405
- i.setUint32(0, C, !0), i.setUint32(4, u, !0), i.setUint32(8, this.dimensions, !0), i.setUint32(12, e, !0), i.setUint32(16, t, !0), i.setUint32(20, s, !0);
459
+ const e = this.memoryManager.vectorCount, t = e * this._dimensions * 4, s = b(this.slotToKey), r = s.byteLength, n = new ArrayBuffer(B), i = new DataView(n);
460
+ i.setUint32(0, S, !0), i.setUint32(4, d, !0), i.setUint32(8, this._dimensions, !0), i.setUint32(12, e, !0), i.setUint32(16, t, !0), i.setUint32(20, r, !0);
406
461
  const a = this.memoryManager;
407
- let o = "header", h = 0;
462
+ let c = "header", A = 0;
408
463
  return new ReadableStream({
409
- pull(f) {
410
- switch (o) {
464
+ pull(h) {
465
+ switch (c) {
411
466
  case "header":
412
- f.enqueue(new Uint8Array(n)), o = t > 0 ? "vectors" : s > 0 ? "keys" : "done", o === "done" && f.close();
467
+ h.enqueue(new Uint8Array(n)), c = t > 0 ? "vectors" : r > 0 ? "keys" : "done", c === "done" && h.close();
413
468
  break;
414
469
  case "vectors": {
415
- const l = t - h, y = Math.min(l, z), A = new Uint8Array(y);
416
- A.set(new Uint8Array(a.memory.buffer, a.dbOffset + h, y)), f.enqueue(A), h += y, h >= t && (o = s > 0 ? "keys" : "done", o === "done" && f.close());
470
+ const l = t - A, y = Math.min(l, H), f = new Uint8Array(y);
471
+ f.set(new Uint8Array(a.memory.buffer, a.dbOffset + A, y)), h.enqueue(f), A += y, A >= t && (c = r > 0 ? "keys" : "done", c === "done" && h.close());
417
472
  break;
418
473
  }
419
474
  case "keys":
420
- f.enqueue(r), o = "done", f.close();
475
+ h.enqueue(s), c = "done", h.close();
421
476
  break;
422
477
  }
423
478
  }
@@ -432,29 +487,29 @@ class M {
432
487
  */
433
488
  async import(e) {
434
489
  this.assertOpen();
435
- const t = new q(e), r = await t.readExact(I), s = new DataView(r.buffer, r.byteOffset, r.byteLength);
436
- if (s.getUint32(0, !0) !== C)
490
+ const t = new K(e), s = await t.readExact(B), r = new DataView(s.buffer, s.byteOffset, s.byteLength);
491
+ if (r.getUint32(0, !0) !== S)
437
492
  throw new Error("Invalid import data: unrecognized format");
438
- const i = s.getUint32(4, !0);
439
- if (i !== u)
440
- throw new Error(`Unsupported import version: expected ${u}, got ${i}`);
441
- const a = s.getUint32(8, !0);
442
- if (a !== this.dimensions)
443
- throw new Error(`Import dimension mismatch: expected ${this.dimensions}, got ${a}`);
444
- const o = s.getUint32(12, !0), h = s.getUint32(16, !0), f = s.getUint32(20, !0);
445
- if (this.keyToSlot.clear(), this.slotToKey.length = 0, this.memoryManager.reset(), o > 0) {
446
- this.memoryManager.ensureCapacity(o);
493
+ const i = r.getUint32(4, !0);
494
+ if (i !== d)
495
+ throw new Error(`Unsupported import version: expected ${d}, got ${i}`);
496
+ const a = r.getUint32(8, !0);
497
+ if (a !== this._dimensions)
498
+ throw new Error(`Import dimension mismatch: expected ${this._dimensions}, got ${a}`);
499
+ const c = r.getUint32(12, !0), A = r.getUint32(16, !0), h = r.getUint32(20, !0);
500
+ if (this.keyToSlot.clear(), this.slotToKey.length = 0, this.memoryManager.reset(), c > 0) {
501
+ this.memoryManager.ensureCapacity(c);
447
502
  let l = 0;
448
- await t.readChunked(h, (y) => {
503
+ await t.readChunked(A, (y) => {
449
504
  new Uint8Array(this.memoryManager.memory.buffer, this.memoryManager.dbOffset + l, y.byteLength).set(
450
505
  y
451
506
  ), l += y.byteLength;
452
- }), this.memoryManager.setVectorCount(o);
507
+ }), this.memoryManager.setVectorCount(c);
453
508
  }
454
- if (f > 0) {
455
- const l = await t.readExact(f), y = g(l);
456
- for (let A = 0; A < y.length; A++)
457
- this.keyToSlot.set(y[A], A), this.slotToKey[A] = y[A];
509
+ if (h > 0) {
510
+ const l = await t.readExact(h), y = C(l);
511
+ for (let f = 0; f < y.length; f++)
512
+ this.keyToSlot.set(y[f], f), this.slotToKey[f] = y[f];
458
513
  }
459
514
  t.release();
460
515
  }
@@ -465,17 +520,17 @@ class M {
465
520
  if (this.wasmExports) {
466
521
  const t = this.memoryManager.queryOffset;
467
522
  new Float32Array(this.memoryManager.memory.buffer, t, e.length).set(e), this.wasmExports.normalize(t, e.length);
468
- const r = new Float32Array(this.memoryManager.memory.buffer, t, e.length);
469
- e.set(r);
523
+ const s = new Float32Array(this.memoryManager.memory.buffer, t, e.length);
524
+ e.set(s);
470
525
  } else
471
- S(e);
526
+ T(e);
472
527
  }
473
528
  assertOpen() {
474
529
  if (this.closed)
475
530
  throw new Error("VectorDB instance has been closed");
476
531
  }
477
532
  }
478
- class q {
533
+ class K {
479
534
  reader;
480
535
  buffer = new Uint8Array(0);
481
536
  constructor(e) {
@@ -489,32 +544,32 @@ class q {
489
544
  return this.buffer = this.buffer.subarray(e), i;
490
545
  }
491
546
  const t = [];
492
- let r = this.buffer.byteLength;
493
- for (r > 0 && (t.push(this.buffer), this.buffer = new Uint8Array(0)); r < e; ) {
547
+ let s = this.buffer.byteLength;
548
+ for (s > 0 && (t.push(this.buffer), this.buffer = new Uint8Array(0)); s < e; ) {
494
549
  const { done: i, value: a } = await this.reader.read();
495
550
  if (i) throw new Error("Invalid import data: unexpected end of stream");
496
- t.push(a), r += a.byteLength;
551
+ t.push(a), s += a.byteLength;
497
552
  }
498
- const s = new Uint8Array(r);
553
+ const r = new Uint8Array(s);
499
554
  let n = 0;
500
555
  for (const i of t)
501
- s.set(i, n), n += i.byteLength;
502
- return r > e ? (this.buffer = s.subarray(e), s.subarray(0, e)) : s;
556
+ r.set(i, n), n += i.byteLength;
557
+ return s > e ? (this.buffer = r.subarray(e), r.subarray(0, e)) : r;
503
558
  }
504
559
  /**
505
560
  * Read `totalBytes` from the stream in chunks, calling `onChunk` for each.
506
561
  * Avoids allocating a single large buffer for the full data.
507
562
  */
508
563
  async readChunked(e, t) {
509
- let r = e;
564
+ let s = e;
510
565
  if (this.buffer.byteLength > 0) {
511
- const s = Math.min(this.buffer.byteLength, r);
512
- t(this.buffer.subarray(0, s)), r -= s, this.buffer = this.buffer.subarray(s);
566
+ const r = Math.min(this.buffer.byteLength, s);
567
+ t(this.buffer.subarray(0, r)), s -= r, this.buffer = this.buffer.subarray(r);
513
568
  }
514
- for (; r > 0; ) {
515
- const { done: s, value: n } = await this.reader.read();
516
- if (s) throw new Error("Invalid import data: unexpected end of stream");
517
- n.byteLength <= r ? (t(n), r -= n.byteLength) : (t(n.subarray(0, r)), this.buffer = n.slice(r), r = 0);
569
+ for (; s > 0; ) {
570
+ const { done: r, value: n } = await this.reader.read();
571
+ if (r) throw new Error("Invalid import data: unexpected end of stream");
572
+ n.byteLength <= s ? (t(n), s -= n.byteLength) : (t(n.subarray(0, s)), this.buffer = n.slice(s), s = 0);
518
573
  }
519
574
  }
520
575
  /** Release the stream reader lock. */
@@ -523,9 +578,9 @@ class q {
523
578
  }
524
579
  }
525
580
  export {
526
- M as DB,
527
- v as InMemoryStorageProvider,
528
- _ as OPFSStorageProvider,
529
- k as VectorCapacityExceededError
581
+ k as DB,
582
+ U as InMemoryStorageProvider,
583
+ N as OPFSStorageProvider,
584
+ x as VectorCapacityExceededError
530
585
  };
531
586
  //# sourceMappingURL=eigen-db.js.map