@duckedup/nidus 0.83.0 → 0.85.0

package/README.md

@@ -1,6 +1,6 @@
 # @duckedup/nidus
 
-The JavaScript/TypeScript client for [nidus](https://nidus.duckedup.org) — a small,
+The JavaScript/TypeScript client for [nidus](https://nidus.duckedup.org), a small,
 fast vector store. This package connects to a running `nidus serve` instance over
 HTTP, whether it's on your laptop or a remote host.
 
@@ -18,7 +18,7 @@ wire contract lines up.
 
 ## Connecting
 
-"Local vs remote" is just the base URL — point the client at a local `nidus serve`
+"Local vs remote" is just the base URL: point the client at a local `nidus serve`
 or any reachable host.
 
 ```ts
@@ -36,8 +36,8 @@ const db = new NidusClient({
 
 ## Upserting and searching
 
-`attrs` accept plain JS values — strings, numbers, booleans, string arrays, `Date`s,
-and `null` — and are normalized to nidus's typed values for you. (For an explicit
+`attrs` accept plain JS values (strings, numbers, booleans, string arrays, `Date`s,
+and `null`) and are normalized to nidus's typed values for you. (For an explicit
 type, use the `v.*` helpers.)
 
 ```ts
@@ -46,7 +46,7 @@ await db.createCollection("docs");
 await db.upsert("docs", [
   { id: "a", vector: [0.1, 0.2, 0.3], attrs: { lang: "rust", year: 2024 } },
   { id: "b", vector: [0.4, 0.5, 0.6], attrs: { lang: "go", year: 2023 } },
-  // a text-only doc — omit the vector
+  // a text-only doc, omit the vector
   { id: "c", attrs: { body: "vector stores are neat" } },
 ]);
 
@@ -57,7 +57,7 @@ for (const hit of hits) {
 ```
 
 nidus has separate `Int` and `Float` attribute types and compares them same-type only,
-but JS has one `number` and `1.0 === 1` — so a plain number becomes an `Int` when
+but JS has one `number` and `1.0 === 1`, so a plain number becomes an `Int` when
 `Number.isInteger` says so and a `Float` otherwise. That means a whole-numbered
 measurement lands as an `Int` in whichever records it came out round, and a `Float`
 range filter then skips exactly those. Pin such a field with `v.float`:
@@ -70,7 +70,7 @@ await db.upsert("docs", [
     id: "d",
     attrs: {
       score: v.float(1), // a Float even though the value is whole
-      ratio: 0.75, // already a Float — not an integer
+      ratio: 0.75, // already a Float, not an integer
       year: 2024, // an Int
       seen: new Date(), // a DateTime: a UTC instant, epoch milliseconds
     },
@@ -80,7 +80,7 @@ await db.upsert("docs", [
 
 A `DateTime` carries no timezone and has millisecond resolution; it decodes back to a
 `Date`, so a decoded `attrs` map re-encodes to what it came from. `NaN` and `Infinity`
-throw — JSON has no spelling for them. The Go and Python SDKs have the numeric types JS
+throw: JSON has no spelling for them. The Go and Python SDKs have the numeric types JS
 lacks and decide from those instead, so a Python `2.0` or a Go `float64(2)` is a
 `Float` where a bare `2` here is an `Int`.
 
@@ -88,7 +88,7 @@ lacks and decide from those instead, so a Python `2.0` or a Go `float64(2)` is a
 
 Build an AND-filter with the `f.*` helpers. Each predicate is a positive assertion
 about a present attribute (an absent key matches nothing). Comparisons are same-type
-only, so an operand must encode to the attribute's type — `f.ge("score", v.float(2))`,
+only, so an operand must encode to the attribute's type: `f.ge("score", v.float(2))`,
 not `f.ge("score", 2)`, for a `Float` attribute.
 
 ```ts
@@ -106,7 +106,7 @@ const hits = await db.search({
 });
 ```
 
-Beyond the comparisons there are text predicates — approximate, token-wise, and
+Beyond the comparisons there are text predicates: approximate, token-wise, and
 regular-expression matching over a plain attribute (no full-text index required):
 
 ```ts
@@ -156,7 +156,7 @@ const hybrid = await db.hybridSearch({
 ```
 
 A query can search several fields at once, each with its own text, by sending `clauses`
-instead of the single field — folded by `combine`, `"Sum"` (a doc hitting title *and*
+instead of the single field, folded by `combine`, `"Sum"` (a doc hitting title *and*
 body outranks one hitting either) or `"Max"` (a long body cannot out-accumulate a
 precise title match). Weight the two hybrid legs with `vectorWeight`/`textWeight`.
 
@@ -196,7 +196,7 @@ for (const { field, fragments } of hits[0]?.annotations?.highlights ?? []) {
 ```
 
 nidus reports a span as a **UTF-8 byte** range, but a JS string is indexed in UTF-16
-code units — so a raw span slices the wrong text out of any non-ASCII excerpt. This SDK
+code units, so a raw span slices the wrong text out of any non-ASCII excerpt. This SDK
 converts them for you: `fragment.spans` are JS string indices, and `fragment.text.slice`
 is the matched term. If you compare them against the raw HTTP response, expect the
 numbers to differ wherever the excerpt is not ASCII.
@@ -205,7 +205,7 @@ numbers to differ wherever the excerpt is not ASCII.
 
 `searchWithPlan`, `searchSimilarWithPlan`, and `hybridSearchWithPlan` are siblings of
 `search`/`searchSimilar`/`hybridSearch` that return `{ hits, plan }` instead of a bare
-`Hit[]` — the plan reports which scan strategy the server took (`ann`, `exact`, …), how
+`Hit[]`: the plan reports which scan strategy the server took (`ann`, `exact`, …), how
 many rows it scanned, and per-stage timings in microseconds. `textSearch` has no plan.
 
 ```ts
@@ -260,7 +260,7 @@ with no usable timestamp is not penalized at all (`missing` defaults to `1`).
 ## Remembering and recalling (text-native)
 
 When the server is started with an embedder (`nidus serve --embed-provider …`), you
-can send **text** and let the server embed it — no need to compute vectors client-side.
+can send **text** and let the server embed it, no need to compute vectors client-side.
 `remember` embeds and upserts; `recall` embeds the query and vector-searches.
 
 ```ts
@@ -295,7 +295,7 @@ later near-duplicate.
 
 Both throw a `NidusError` with status `400` if the server has no embedder configured
 (the message names `--embed-provider`); `mode: "summarize"` without a summarizer is
-likewise a `400`. Dedupe needs that same embedder — it is a vector search under the
+likewise a `400`. Dedupe needs that same embedder: it is a vector search under the
 hood.
 
 Pass `reinforce: true` to have a `recall` stamp `nidus.access_count` and
@@ -318,6 +318,19 @@ await db.flush(); await db.compact();
 await db.dropCollection("docs");
 ```
 
+## Running in the browser (wasm)
+
+A separate, ESM-only subpath, `@duckedup/nidus/wasm`, runs nidus itself inside the
+browser via WebAssembly, storing data in the browser's Origin Private File System
+instead of talking to a `nidus serve` over HTTP. It is lazily imported so the default
+entry point above stays small.
+
+```ts
+import { acquireOpfsPool } from "@duckedup/nidus/wasm";
+```
+
+See https://nidus.duckedup.org for the full guide.
+
 ## Errors
 
 A failed request throws a `NidusError` carrying the HTTP status the server reported,
@@ -338,7 +351,7 @@ try {
 ```
 
 A status of `0` means a transport-level failure (the server was unreachable, or the
-request timed out — configure `timeoutMs` on the client).
+request timed out; configure `timeoutMs` on the client).
 
 ## License
 

package/dist/wasm/index.d.ts

@@ -0,0 +1,39 @@
+declare global {
+    interface FileSystemFileHandle {
+        createSyncAccessHandle(): Promise<FileSystemSyncAccessHandle>;
+    }
+    interface FileSystemSyncAccessHandle {
+        close(): void;
+    }
+}
+/** Mirrors `bindings/wasm/src/lib.rs`'s `#[wasm_bindgen]` exports. Can drift if that changes. */
+interface NidusHandleInstance {
+    upsert(collection: string, records: unknown): number;
+    search(collection: string, query: number[], topK: number): unknown;
+    flush(): void;
+    close(): void;
+}
+interface NidusHandleClass {
+    open(location: string, dimension: number): NidusHandleInstance;
+}
+interface OpfsPoolOptions {
+    /** Handles opened per grow (directory slot + body slots). Defaults to 8. */
+    slots?: number;
+    /** Directory name under the OPFS root to open slot files in. Defaults to "nidus". */
+    dir?: string;
+}
+interface OpfsPool {
+    /** The store constructor, ready to use: the pool it needs is already registered. */
+    readonly NidusHandle: NidusHandleClass;
+    /** Open `slots` more handles and register them with the wasm pool (async growth step). */
+    grow(): Promise<void>;
+    /** Run `writeOnce`; on a pool-exhausted error, grow the pool once and retry. */
+    withPoolGrowth<T>(writeOnce: () => T): Promise<T>;
+}
+/**
+ * Load the wasm module and open+register an initial pool of OPFS sync access handles.
+ * Mirrors `bindings/wasm/demo/worker.js`'s `openSlots`/`withPoolGrowth` (:17-25, :36-44).
+ */
+declare function acquireOpfsPool(opts?: OpfsPoolOptions): Promise<OpfsPool>;
+
+export { type NidusHandleClass, type NidusHandleInstance, type OpfsPool, type OpfsPoolOptions, acquireOpfsPool };

package/dist/wasm/index.js

@@ -0,0 +1,49 @@
+// src/wasm-helper.ts
+var modPromise;
+async function loadWasm() {
+  if (!modPromise) {
+    const specifier = "./nidus_wasm.js";
+    modPromise = import(specifier);
+  }
+  const mod = await modPromise;
+  await mod.default();
+  return mod;
+}
+async function openSlots(dir, count, next) {
+  const opened = [];
+  for (let i = 0; i < count; i++) {
+    const fileHandle = await dir.getFileHandle(`slot-${next.n++}`, { create: true });
+    opened.push(await fileHandle.createSyncAccessHandle());
+  }
+  return opened;
+}
+async function acquireOpfsPool(opts) {
+  const slots = opts?.slots ?? 8;
+  const mod = await loadWasm();
+  const root = await navigator.storage.getDirectory();
+  const dir = await root.getDirectoryHandle(opts?.dir ?? "nidus", { create: true });
+  const next = { n: 0 };
+  mod.init_opfs_pool(await openSlots(dir, slots, next));
+  return {
+    NidusHandle: mod.NidusHandle,
+    async grow() {
+      mod.grow_opfs_pool(await openSlots(dir, slots, next));
+    },
+    // Retries once on "OPFS pool exhausted" after growing (nidus-y67's documented
+    // design, not a bug): a sync write can't perform the async grow step itself.
+    async withPoolGrowth(writeOnce) {
+      try {
+        return writeOnce();
+      } catch (e) {
+        if (!String(e).includes("OPFS pool exhausted")) throw e;
+        mod.grow_opfs_pool(await openSlots(dir, slots, next));
+        return writeOnce();
+      }
+    }
+  };
+}
+export {
+  acquireOpfsPool
+};
+//! `@duckedup/nidus/wasm` — browser helper over the generated `nidus_wasm` module.
+//# sourceMappingURL=index.js.map

package/dist/wasm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/wasm-helper.ts"],"sourcesContent":["//! `@duckedup/nidus/wasm` — browser helper over the generated `nidus_wasm` module.\n//\n// Must typecheck with `bindings/wasm/pkg` absent (nidus-3hc): the module's surface is\n// declared locally below and reached via a dynamic `import()` of a non-literal\n// specifier, never a static import of the `nidus_wasm.js` this package copies into place.\n\n// OPFS sync access is worker-only and still missing from TS's lib.dom.d.ts.\ndeclare global {\n  interface FileSystemFileHandle {\n    createSyncAccessHandle(): Promise<FileSystemSyncAccessHandle>;\n  }\n  interface FileSystemSyncAccessHandle {\n    close(): void;\n  }\n}\n\n/** Mirrors `bindings/wasm/src/lib.rs`'s `#[wasm_bindgen]` exports. Can drift if that changes. */\nexport interface NidusHandleInstance {\n  upsert(collection: string, records: unknown): number;\n  search(collection: string, query: number[], topK: number): unknown;\n  flush(): void;\n  close(): void;\n}\n\nexport interface NidusHandleClass {\n  open(location: string, dimension: number): NidusHandleInstance;\n}\n\ninterface WasmModule {\n  default: (input?: unknown) => Promise<unknown>;\n  NidusHandle: NidusHandleClass;\n  init_opfs_pool: (handles: FileSystemSyncAccessHandle[]) => void;\n  grow_opfs_pool: (handles: FileSystemSyncAccessHandle[]) => void;\n}\n\nlet modPromise: Promise<WasmModule> | undefined;\n\nasync function loadWasm(): Promise<WasmModule> {\n  if (!modPromise) {\n    const specifier = \"./nidus_wasm.js\";\n    modPromise = import(specifier) as Promise<WasmModule>;\n  }\n  const mod = await modPromise;\n  await mod.default();\n  return mod;\n}\n\nexport interface OpfsPoolOptions {\n  /** Handles opened per grow (directory slot + body slots). Defaults to 8. */\n  slots?: number;\n  /** Directory name under the OPFS root to open slot files in. Defaults to \"nidus\". */\n  dir?: string;\n}\n\nexport interface OpfsPool {\n  /** The store constructor, ready to use: the pool it needs is already registered. */\n  readonly NidusHandle: NidusHandleClass;\n  /** Open `slots` more handles and register them with the wasm pool (async growth step). */\n  grow(): Promise<void>;\n  /** Run `writeOnce`; on a pool-exhausted error, grow the pool once and retry. */\n  withPoolGrowth<T>(writeOnce: () => T): Promise<T>;\n}\n\n// Mirrors bindings/wasm/demo/worker.js:17-25 (openSlots): the one async step OPFS needs\n// per handle (getFileHandle + createSyncAccessHandle); everything after is sync wasm.\nasync function openSlots(dir: FileSystemDirectoryHandle, count: number, next: { n: number }) {\n  const opened: FileSystemSyncAccessHandle[] = [];\n  for (let i = 0; i < count; i++) {\n    const fileHandle = await dir.getFileHandle(`slot-${next.n++}`, { create: true });\n    opened.push(await fileHandle.createSyncAccessHandle());\n  }\n  return opened;\n}\n\n/**\n * Load the wasm module and open+register an initial pool of OPFS sync access handles.\n * Mirrors `bindings/wasm/demo/worker.js`'s `openSlots`/`withPoolGrowth` (:17-25, :36-44).\n */\nexport async function acquireOpfsPool(opts?: OpfsPoolOptions): Promise<OpfsPool> {\n  const slots = opts?.slots ?? 8;\n  const mod = await loadWasm();\n  const root = await navigator.storage.getDirectory();\n  const dir = await root.getDirectoryHandle(opts?.dir ?? \"nidus\", { create: true });\n  const next = { n: 0 };\n\n  mod.init_opfs_pool(await openSlots(dir, slots, next));\n\n  return {\n    NidusHandle: mod.NidusHandle,\n    async grow() {\n      mod.grow_opfs_pool(await openSlots(dir, slots, next));\n    },\n    // Retries once on \"OPFS pool exhausted\" after growing (nidus-y67's documented\n    // design, not a bug): a sync write can't perform the async grow step itself.\n    async withPoolGrowth<T>(writeOnce: () => T): Promise<T> {\n      try {\n        return writeOnce();\n      } catch (e) {\n        if (!String(e).includes(\"OPFS pool exhausted\")) throw e;\n        mod.grow_opfs_pool(await openSlots(dir, slots, next));\n        return writeOnce();\n      }\n    },\n  };\n}\n"],"mappings":";AAmCA,IAAI;AAEJ,eAAe,WAAgC;AAC7C,MAAI,CAAC,YAAY;AACf,UAAM,YAAY;AAClB,iBAAa,OAAO;AAAA,EACtB;AACA,QAAM,MAAM,MAAM;AAClB,QAAM,IAAI,QAAQ;AAClB,SAAO;AACT;AAoBA,eAAe,UAAU,KAAgC,OAAe,MAAqB;AAC3F,QAAM,SAAuC,CAAC;AAC9C,WAAS,IAAI,GAAG,IAAI,OAAO,KAAK;AAC9B,UAAM,aAAa,MAAM,IAAI,cAAc,QAAQ,KAAK,GAAG,IAAI,EAAE,QAAQ,KAAK,CAAC;AAC/E,WAAO,KAAK,MAAM,WAAW,uBAAuB,CAAC;AAAA,EACvD;AACA,SAAO;AACT;AAMA,eAAsB,gBAAgB,MAA2C;AAC/E,QAAM,QAAQ,MAAM,SAAS;AAC7B,QAAM,MAAM,MAAM,SAAS;AAC3B,QAAM,OAAO,MAAM,UAAU,QAAQ,aAAa;AAClD,QAAM,MAAM,MAAM,KAAK,mBAAmB,MAAM,OAAO,SAAS,EAAE,QAAQ,KAAK,CAAC;AAChF,QAAM,OAAO,EAAE,GAAG,EAAE;AAEpB,MAAI,eAAe,MAAM,UAAU,KAAK,OAAO,IAAI,CAAC;AAEpD,SAAO;AAAA,IACL,aAAa,IAAI;AAAA,IACjB,MAAM,OAAO;AACX,UAAI,eAAe,MAAM,UAAU,KAAK,OAAO,IAAI,CAAC;AAAA,IACtD;AAAA;AAAA;AAAA,IAGA,MAAM,eAAkB,WAAgC;AACtD,UAAI;AACF,eAAO,UAAU;AAAA,MACnB,SAAS,GAAG;AACV,YAAI,CAAC,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAG,OAAM;AACtD,YAAI,eAAe,MAAM,UAAU,KAAK,OAAO,IAAI,CAAC;AACpD,eAAO,UAAU;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/wasm/nidus_wasm.d.ts

@@ -0,0 +1,106 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * An open store. Wraps `nidus::Nidus`; every method must run on the worker thread that
+ * registered its OPFS pool (for an `opfs://` location).
+ */
+export class NidusHandle {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Close the store. Consumes the handle: nidus's `Drop` releases the writer lock (a
+     * trivial always-held guard on OPFS), and the JS wrapper is invalidated with it.
+     */
+    close(): void;
+    /**
+     * Drop a collection's rows. The terminal's `clear` — dropping rather than deleting
+     * OPFS files underneath the pool's open handles.
+     */
+    drop_collection(collection: string): void;
+    /**
+     * fsync both files.
+     */
+    flush(): void;
+    /**
+     * A RAM/disk footprint snapshot, shaped like `FootprintDto`. The terminal's `stats`.
+     */
+    footprint(): any;
+    /**
+     * Open (creating if absent) a store at `location` — `opfs://name` (needs
+     * `init_opfs_pool` first, same thread) or `file://…`/a bare path.
+     */
+    static open(location: string, dimension: number): NidusHandle;
+    /**
+     * Open a RAM-only store, no persistence config. The terminal's fallback when the
+     * worker/OPFS handshake fails.
+     */
+    static open_in_memory(dimension: number): NidusHandle;
+    /**
+     * Nearest-neighbour search in `collection`, returning a JS array of hits shaped like
+     * `server::dto::HitDto`: `{collection, id, score, attrs}`.
+     */
+    search(collection: string, query: Float32Array, top_k: number): any;
+    /**
+     * Upsert records given as a JS array of `{id, vector?, attrs}` (mirrors
+     * `server::dto::UpsertRequest`'s `Record` shape); returns the count written.
+     */
+    upsert(collection: string, records: any): number;
+}
+
+/**
+ * Add freshly-opened handles to the pool already registered on this thread — the async
+ * growth step a `put` exhaustion error asks for. Same thread as `init_opfs_pool` only.
+ */
+export function grow_opfs_pool(handles: Array<any>): void;
+
+/**
+ * Adopt a fresh pool of already-opened OPFS handles (`handles[0]` is the directory slot,
+ * `handles[1..]` are body slots) and register it on this worker thread. Must run before any
+ * `NidusHandle::open("opfs://…")` call on the same thread.
+ */
+export function init_opfs_pool(handles: Array<any>): void;
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly __wbg_nidushandle_free: (a: number, b: number) => void;
+    readonly grow_opfs_pool: (a: number, b: number) => void;
+    readonly init_opfs_pool: (a: number, b: number) => void;
+    readonly nidushandle_close: (a: number) => void;
+    readonly nidushandle_drop_collection: (a: number, b: number, c: number, d: number) => void;
+    readonly nidushandle_flush: (a: number, b: number) => void;
+    readonly nidushandle_footprint: (a: number, b: number) => void;
+    readonly nidushandle_open: (a: number, b: number, c: number, d: number) => void;
+    readonly nidushandle_open_in_memory: (a: number, b: number) => void;
+    readonly nidushandle_search: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly nidushandle_upsert: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly __wbindgen_export: (a: number, b: number) => number;
+    readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_export3: (a: number) => void;
+    readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;

package/dist/wasm/nidus_wasm.js

@@ -0,0 +1,803 @@
+/* @ts-self-types="./nidus_wasm.d.ts" */
+
+/**
+ * An open store. Wraps `nidus::Nidus`; every method must run on the worker thread that
+ * registered its OPFS pool (for an `opfs://` location).
+ */
+export class NidusHandle {
+    static __wrap(ptr) {
+        const obj = Object.create(NidusHandle.prototype);
+        obj.__wbg_ptr = ptr;
+        NidusHandleFinalization.register(obj, obj.__wbg_ptr, obj);
+        return obj;
+    }
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        NidusHandleFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_nidushandle_free(ptr, 0);
+    }
+    /**
+     * Close the store. Consumes the handle: nidus's `Drop` releases the writer lock (a
+     * trivial always-held guard on OPFS), and the JS wrapper is invalidated with it.
+     */
+    close() {
+        const ptr = this.__destroy_into_raw();
+        wasm.nidushandle_close(ptr);
+    }
+    /**
+     * Drop a collection's rows. The terminal's `clear` — dropping rather than deleting
+     * OPFS files underneath the pool's open handles.
+     * @param {string} collection
+     */
+    drop_collection(collection) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(collection, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.nidushandle_drop_collection(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            if (r1) {
+                throw takeObject(r0);
+            }
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * fsync both files.
+     */
+    flush() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.nidushandle_flush(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            if (r1) {
+                throw takeObject(r0);
+            }
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * A RAM/disk footprint snapshot, shaped like `FootprintDto`. The terminal's `stats`.
+     * @returns {any}
+     */
+    footprint() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.nidushandle_footprint(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Open (creating if absent) a store at `location` — `opfs://name` (needs
+     * `init_opfs_pool` first, same thread) or `file://…`/a bare path.
+     * @param {string} location
+     * @param {number} dimension
+     * @returns {NidusHandle}
+     */
+    static open(location, dimension) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(location, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.nidushandle_open(retptr, ptr0, len0, dimension);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return NidusHandle.__wrap(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Open a RAM-only store, no persistence config. The terminal's fallback when the
+     * worker/OPFS handshake fails.
+     * @param {number} dimension
+     * @returns {NidusHandle}
+     */
+    static open_in_memory(dimension) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.nidushandle_open_in_memory(retptr, dimension);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return NidusHandle.__wrap(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Nearest-neighbour search in `collection`, returning a JS array of hits shaped like
+     * `server::dto::HitDto`: `{collection, id, score, attrs}`.
+     * @param {string} collection
+     * @param {Float32Array} query
+     * @param {number} top_k
+     * @returns {any}
+     */
+    search(collection, query, top_k) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(collection, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passArrayF32ToWasm0(query, wasm.__wbindgen_export);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.nidushandle_search(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1, top_k);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Upsert records given as a JS array of `{id, vector?, attrs}` (mirrors
+     * `server::dto::UpsertRequest`'s `Record` shape); returns the count written.
+     * @param {string} collection
+     * @param {any} records
+     * @returns {number}
+     */
+    upsert(collection, records) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(collection, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.nidushandle_upsert(retptr, this.__wbg_ptr, ptr0, len0, addHeapObject(records));
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return r0 >>> 0;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+}
+if (Symbol.dispose) NidusHandle.prototype[Symbol.dispose] = NidusHandle.prototype.free;
+
+/**
+ * Add freshly-opened handles to the pool already registered on this thread — the async
+ * growth step a `put` exhaustion error asks for. Same thread as `init_opfs_pool` only.
+ * @param {Array<any>} handles
+ */
+export function grow_opfs_pool(handles) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        wasm.grow_opfs_pool(retptr, addHeapObject(handles));
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        if (r1) {
+            throw takeObject(r0);
+        }
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+}
+
+/**
+ * Adopt a fresh pool of already-opened OPFS handles (`handles[0]` is the directory slot,
+ * `handles[1..]` are body slots) and register it on this worker thread. Must run before any
+ * `NidusHandle::open("opfs://…")` call on the same thread.
+ * @param {Array<any>} handles
+ */
+export function init_opfs_pool(handles) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        wasm.init_opfs_pool(retptr, addHeapObject(handles));
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        if (r1) {
+            throw takeObject(r0);
+        }
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+}
+function __wbg_get_imports() {
+    const import0 = {
+        __proto__: null,
+        __wbg_Error_ef53bc310eb298a0: function(arg0, arg1) {
+            const ret = Error(getStringFromWasm0(arg0, arg1));
+            return addHeapObject(ret);
+        },
+        __wbg_Number_6b506e6536831eaa: function(arg0) {
+            const ret = Number(getObject(arg0));
+            return ret;
+        },
+        __wbg_String_8564e559799eccda: function(arg0, arg1) {
+            const ret = String(getObject(arg1));
+            const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
+        __wbg___wbindgen_bigint_get_as_i64_38130e98eecd467d: function(arg0, arg1) {
+            const v = getObject(arg1);
+            const ret = typeof(v) === 'bigint' ? v : undefined;
+            getDataViewMemory0().setBigInt64(arg0 + 8 * 1, isLikeNone(ret) ? BigInt(0) : ret, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+        },
+        __wbg___wbindgen_boolean_get_1a45e2c38d4d41b9: function(arg0) {
+            const v = getObject(arg0);
+            const ret = typeof(v) === 'boolean' ? v : undefined;
+            return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
+        },
+        __wbg___wbindgen_debug_string_0accd80f45e5faa2: function(arg0, arg1) {
+            const ret = debugString(getObject(arg1));
+            const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
+        __wbg___wbindgen_in_70a403a56e771704: function(arg0, arg1) {
+            const ret = getObject(arg0) in getObject(arg1);
+            return ret;
+        },
+        __wbg___wbindgen_is_bigint_6ffd6468a9bc44b9: function(arg0) {
+            const ret = typeof(getObject(arg0)) === 'bigint';
+            return ret;
+        },
+        __wbg___wbindgen_is_function_754e9f305ff6029e: function(arg0) {
+            const ret = typeof(getObject(arg0)) === 'function';
+            return ret;
+        },
+        __wbg___wbindgen_is_object_56732c2bc353f41d: function(arg0) {
+            const val = getObject(arg0);
+            const ret = typeof(val) === 'object' && val !== null;
+            return ret;
+        },
+        __wbg___wbindgen_is_string_c236cabd84a4d769: function(arg0) {
+            const ret = typeof(getObject(arg0)) === 'string';
+            return ret;
+        },
+        __wbg___wbindgen_is_undefined_67b456be8673d3d7: function(arg0) {
+            const ret = getObject(arg0) === undefined;
+            return ret;
+        },
+        __wbg___wbindgen_jsval_eq_1068e624fa87f6ab: function(arg0, arg1) {
+            const ret = getObject(arg0) === getObject(arg1);
+            return ret;
+        },
+        __wbg___wbindgen_jsval_loose_eq_2c56564c75129511: function(arg0, arg1) {
+            const ret = getObject(arg0) == getObject(arg1);
+            return ret;
+        },
+        __wbg___wbindgen_number_get_9bb1761122181af2: function(arg0, arg1) {
+            const obj = getObject(arg1);
+            const ret = typeof(obj) === 'number' ? obj : undefined;
+            getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+        },
+        __wbg___wbindgen_string_get_72bdf95d3ae505b1: function(arg0, arg1) {
+            const obj = getObject(arg1);
+            const ret = typeof(obj) === 'string' ? obj : undefined;
+            var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            var len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
+        __wbg___wbindgen_throw_1506f2235d1bdba0: function(arg0, arg1) {
+            throw new Error(getStringFromWasm0(arg0, arg1));
+        },
+        __wbg_call_40e4174f169eaca7: function() { return handleError(function (arg0, arg1, arg2, arg3) {
+            const ret = getObject(arg0).call(getObject(arg1), getObject(arg2), getObject(arg3));
+            return addHeapObject(ret);
+        }, arguments); },
+        __wbg_call_8a89609d89f6608a: function() { return handleError(function (arg0, arg1) {
+            const ret = getObject(arg0).call(getObject(arg1));
+            return addHeapObject(ret);
+        }, arguments); },
+        __wbg_call_9c758de292015997: function() { return handleError(function (arg0, arg1, arg2) {
+            const ret = getObject(arg0).call(getObject(arg1), getObject(arg2));
+            return addHeapObject(ret);
+        }, arguments); },
+        __wbg_done_60cf307fcc680536: function(arg0) {
+            const ret = getObject(arg0).done;
+            return ret;
+        },
+        __wbg_entries_04b37a02507f1713: function(arg0) {
+            const ret = Object.entries(getObject(arg0));
+            return addHeapObject(ret);
+        },
+        __wbg_get_1f8f054ddbaa7db2: function() { return handleError(function (arg0, arg1) {
+            const ret = Reflect.get(getObject(arg0), getObject(arg1));
+            return addHeapObject(ret);
+        }, arguments); },
+        __wbg_get_2b48c7d0d006a781: function(arg0, arg1) {
+            const ret = getObject(arg0)[arg1 >>> 0];
+            return addHeapObject(ret);
+        },
+        __wbg_get_de6a0f7d4d18a304: function() { return handleError(function (arg0, arg1) {
+            const ret = Reflect.get(getObject(arg0), getObject(arg1));
+            return addHeapObject(ret);
+        }, arguments); },
+        __wbg_get_unchecked_33f6e5c9e2f2d6b2: function(arg0, arg1) {
+            const ret = getObject(arg0)[arg1 >>> 0];
+            return addHeapObject(ret);
+        },
+        __wbg_get_with_ref_key_6412cf3094599694: function(arg0, arg1) {
+            const ret = getObject(arg0)[getObject(arg1)];
+            return addHeapObject(ret);
+        },
+        __wbg_instanceof_ArrayBuffer_8f49811467741499: function(arg0) {
+            let result;
+            try {
+                result = getObject(arg0) instanceof ArrayBuffer;
+            } catch (_) {
+                result = false;
+            }
+            const ret = result;
+            return ret;
+        },
+        __wbg_instanceof_Uint8Array_86f30649f63ef9c2: function(arg0) {
+            let result;
+            try {
+                result = getObject(arg0) instanceof Uint8Array;
+            } catch (_) {
+                result = false;
+            }
+            const ret = result;
+            return ret;
+        },
+        __wbg_isArray_67c2c9c4313f4448: function(arg0) {
+            const ret = Array.isArray(getObject(arg0));
+            return ret;
+        },
+        __wbg_isSafeInteger_66acec27e09e99a7: function(arg0) {
+            const ret = Number.isSafeInteger(getObject(arg0));
+            return ret;
+        },
+        __wbg_iterator_8732428d309e270e: function() {
+            const ret = Symbol.iterator;
+            return addHeapObject(ret);
+        },
+        __wbg_length_4a591ecaa01354d9: function(arg0) {
+            const ret = getObject(arg0).length;
+            return ret;
+        },
+        __wbg_length_66f1a4b2e9026940: function(arg0) {
+            const ret = getObject(arg0).length;
+            return ret;
+        },
+        __wbg_new_578aeef4b6b94378: function(arg0) {
+            const ret = new Uint8Array(getObject(arg0));
+            return addHeapObject(ret);
+        },
+        __wbg_new_622fc80556be2e26: function() {
+            const ret = new Map();
+            return addHeapObject(ret);
+        },
+        __wbg_new_ce1ab61c1c2b300d: function() {
+            const ret = new Object();
+            return addHeapObject(ret);
+        },
+        __wbg_new_d90091b82fdf5b91: function() {
+            const ret = new Array();
+            return addHeapObject(ret);
+        },
+        __wbg_new_with_length_36a4998e27b014c5: function(arg0) {
+            const ret = new Uint8Array(arg0 >>> 0);
+            return addHeapObject(ret);
+        },
+        __wbg_next_9e03acdf51c4960d: function(arg0) {
+            const ret = getObject(arg0).next;
+            return addHeapObject(ret);
+        },
+        __wbg_next_eb8ca7351fa27906: function() { return handleError(function (arg0) {
+            const ret = getObject(arg0).next();
+            return addHeapObject(ret);
+        }, arguments); },
+        __wbg_now_190933fa139cc119: function() {
+            const ret = Date.now();
+            return ret;
+        },
+        __wbg_prototypesetcall_3249fc62a0fafa30: function(arg0, arg1, arg2) {
+            Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), getObject(arg2));
+        },
+        __wbg_set_29c99a8aac1c01e5: function(arg0, arg1, arg2) {
+            getObject(arg0).set(getArrayU8FromWasm0(arg1, arg2));
+        },
+        __wbg_set_52b1e1eb5bed906a: function(arg0, arg1, arg2) {
+            const ret = getObject(arg0).set(getObject(arg1), getObject(arg2));
+            return addHeapObject(ret);
+        },
+        __wbg_set_6be42768c690e380: function(arg0, arg1, arg2) {
+            getObject(arg0)[takeObject(arg1)] = takeObject(arg2);
+        },
+        __wbg_set_6e30c9374c26414c: function() { return handleError(function (arg0, arg1, arg2) {
+            const ret = Reflect.set(getObject(arg0), getObject(arg1), getObject(arg2));
+            return ret;
+        }, arguments); },
+        __wbg_set_dca99999bba88a9a: function(arg0, arg1, arg2) {
+            getObject(arg0)[arg1 >>> 0] = takeObject(arg2);
+        },
+        __wbg_static_accessor_GLOBAL_9d53f2689e622ca1: function() {
+            const ret = typeof global === 'undefined' ? null : global;
+            return isLikeNone(ret) ? 0 : addHeapObject(ret);
+        },
+        __wbg_static_accessor_GLOBAL_THIS_a1a35cec07001a8a: function() {
+            const ret = typeof globalThis === 'undefined' ? null : globalThis;
+            return isLikeNone(ret) ? 0 : addHeapObject(ret);
+        },
+        __wbg_static_accessor_SELF_4c59f6c7ea29a144: function() {
+            const ret = typeof self === 'undefined' ? null : self;
+            return isLikeNone(ret) ? 0 : addHeapObject(ret);
+        },
+        __wbg_static_accessor_WINDOW_e70ae9f2eb052253: function() {
+            const ret = typeof window === 'undefined' ? null : window;
+            return isLikeNone(ret) ? 0 : addHeapObject(ret);
+        },
+        __wbg_value_f3625092ee4b37f4: function(arg0) {
+            const ret = getObject(arg0).value;
+            return addHeapObject(ret);
+        },
+        __wbindgen_cast_0000000000000001: function(arg0) {
+            // Cast intrinsic for `F64 -> Externref`.
+            const ret = arg0;
+            return addHeapObject(ret);
+        },
+        __wbindgen_cast_0000000000000002: function(arg0) {
+            // Cast intrinsic for `I64 -> Externref`.
+            const ret = arg0;
+            return addHeapObject(ret);
+        },
+        __wbindgen_cast_0000000000000003: function(arg0, arg1) {
+            // Cast intrinsic for `Ref(String) -> Externref`.
+            const ret = getStringFromWasm0(arg0, arg1);
+            return addHeapObject(ret);
+        },
+        __wbindgen_cast_0000000000000004: function(arg0) {
+            // Cast intrinsic for `U64 -> Externref`.
+            const ret = BigInt.asUintN(64, arg0);
+            return addHeapObject(ret);
+        },
+        __wbindgen_object_clone_ref: function(arg0) {
+            const ret = getObject(arg0);
+            return addHeapObject(ret);
+        },
+        __wbindgen_object_drop_ref: function(arg0) {
+            takeObject(arg0);
+        },
+    };
+    return {
+        __proto__: null,
+        "./nidus_wasm_bg.js": import0,
+    };
+}
+
+const NidusHandleFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_nidushandle_free(ptr, 1));
+
+function addHeapObject(obj) {
+    if (heap_next === heap.length) heap.push(heap.length + 1);
+    const idx = heap_next;
+    heap_next = heap[idx];
+
+    heap[idx] = obj;
+    return idx;
+}
+
+function debugString(val) {
+    // primitive types
+    const type = typeof val;
+    if (type == 'number' || type == 'boolean' || val == null) {
+        return  `${val}`;
+    }
+    if (type == 'string') {
+        return `"${val}"`;
+    }
+    if (type == 'symbol') {
+        const description = val.description;
+        if (description == null) {
+            return 'Symbol';
+        } else {
+            return `Symbol(${description})`;
+        }
+    }
+    if (type == 'function') {
+        const name = val.name;
+        if (typeof name == 'string' && name.length > 0) {
+            return `Function(${name})`;
+        } else {
+            return 'Function';
+        }
+    }
+    // objects
+    if (Array.isArray(val)) {
+        const length = val.length;
+        let debug = '[';
+        if (length > 0) {
+            debug += debugString(val[0]);
+        }
+        for(let i = 1; i < length; i++) {
+            debug += ', ' + debugString(val[i]);
+        }
+        debug += ']';
+        return debug;
+    }
+    // Test for built-in
+    const builtInMatches = /\[object ([^\]]+)\]/.exec(toString.call(val));
+    let className;
+    if (builtInMatches && builtInMatches.length > 1) {
+        className = builtInMatches[1];
+    } else {
+        // Failed to match the standard '[object ClassName]'
+        return toString.call(val);
+    }
+    if (className == 'Object') {
+        // we're a user defined class or Object
+        // JSON.stringify avoids problems with cycles, and is generally much
+        // easier than looping through ownProperties of `val`.
+        try {
+            return 'Object(' + JSON.stringify(val) + ')';
+        } catch (_) {
+            return 'Object';
+        }
+    }
+    // errors
+    if (val instanceof Error) {
+        return `${val.name}: ${val.message}\n${val.stack}`;
+    }
+    // TODO we could test for more things here, like `Set`s and `Map`s.
+    return className;
+}
+
+function dropObject(idx) {
+    if (idx < 1028) return;
+    heap[idx] = heap_next;
+    heap_next = idx;
+}
+
+function getArrayU8FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
+}
+
+let cachedDataViewMemory0 = null;
+function getDataViewMemory0() {
+    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
+        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
+    }
+    return cachedDataViewMemory0;
+}
+
+let cachedFloat32ArrayMemory0 = null;
+function getFloat32ArrayMemory0() {
+    if (cachedFloat32ArrayMemory0 === null || cachedFloat32ArrayMemory0.byteLength === 0) {
+        cachedFloat32ArrayMemory0 = new Float32Array(wasm.memory.buffer);
+    }
+    return cachedFloat32ArrayMemory0;
+}
+
+function getStringFromWasm0(ptr, len) {
+    return decodeText(ptr >>> 0, len);
+}
+
+let cachedUint8ArrayMemory0 = null;
+function getUint8ArrayMemory0() {
+    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
+        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
+    }
+    return cachedUint8ArrayMemory0;
+}
+
+function getObject(idx) { return heap[idx]; }
+
+function handleError(f, args) {
+    try {
+        return f.apply(this, args);
+    } catch (e) {
+        wasm.__wbindgen_export3(addHeapObject(e));
+    }
+}
+
+let heap = new Array(1024).fill(undefined);
+heap.push(undefined, null, true, false);
+
+let heap_next = heap.length;
+
+function isLikeNone(x) {
+    return x === undefined || x === null;
+}
+
+function passArrayF32ToWasm0(arg, malloc) {
+    const ptr = malloc(arg.length * 4, 4) >>> 0;
+    getFloat32ArrayMemory0().set(arg, ptr / 4);
+    WASM_VECTOR_LEN = arg.length;
+    return ptr;
+}
+
+function passStringToWasm0(arg, malloc, realloc) {
+    if (realloc === undefined) {
+        const buf = cachedTextEncoder.encode(arg);
+        const ptr = malloc(buf.length, 1) >>> 0;
+        getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
+        WASM_VECTOR_LEN = buf.length;
+        return ptr;
+    }
+
+    let len = arg.length;
+    let ptr = malloc(len, 1) >>> 0;
+
+    const mem = getUint8ArrayMemory0();
+
+    let offset = 0;
+
+    for (; offset < len; offset++) {
+        const code = arg.charCodeAt(offset);
+        if (code > 0x7F) break;
+        mem[ptr + offset] = code;
+    }
+    if (offset !== len) {
+        if (offset !== 0) {
+            arg = arg.slice(offset);
+        }
+        ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
+        const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
+        const ret = cachedTextEncoder.encodeInto(arg, view);
+
+        offset += ret.written;
+        ptr = realloc(ptr, len, offset, 1) >>> 0;
+    }
+
+    WASM_VECTOR_LEN = offset;
+    return ptr;
+}
+
+function takeObject(idx) {
+    const ret = getObject(idx);
+    dropObject(idx);
+    return ret;
+}
+
+let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+cachedTextDecoder.decode();
+const MAX_SAFARI_DECODE_BYTES = 2146435072;
+let numBytesDecoded = 0;
+function decodeText(ptr, len) {
+    numBytesDecoded += len;
+    if (numBytesDecoded >= MAX_SAFARI_DECODE_BYTES) {
+        cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+        cachedTextDecoder.decode();
+        numBytesDecoded = len;
+    }
+    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+}
+
+const cachedTextEncoder = new TextEncoder();
+
+if (!('encodeInto' in cachedTextEncoder)) {
+    cachedTextEncoder.encodeInto = function (arg, view) {
+        const buf = cachedTextEncoder.encode(arg);
+        view.set(buf);
+        return {
+            read: arg.length,
+            written: buf.length
+        };
+    };
+}
+
+let WASM_VECTOR_LEN = 0;
+
+let wasmModule, wasmInstance, wasm;
+function __wbg_finalize_init(instance, module) {
+    wasmInstance = instance;
+    wasm = instance.exports;
+    wasmModule = module;
+    cachedDataViewMemory0 = null;
+    cachedFloat32ArrayMemory0 = null;
+    cachedUint8ArrayMemory0 = null;
+    return wasm;
+}
+
+async function __wbg_load(module, imports) {
+    if (typeof Response === 'function' && module instanceof Response) {
+        if (typeof WebAssembly.instantiateStreaming === 'function') {
+            try {
+                return await WebAssembly.instantiateStreaming(module, imports);
+            } catch (e) {
+                const validResponse = module.ok && expectedResponseType(module.type);
+
+                if (validResponse && module.headers.get('Content-Type') !== 'application/wasm') {
+                    console.warn("`WebAssembly.instantiateStreaming` failed because your server does not serve Wasm with `application/wasm` MIME type. Falling back to `WebAssembly.instantiate` which is slower. Original error:\n", e);
+
+                } else { throw e; }
+            }
+        }
+
+        const bytes = await module.arrayBuffer();
+        return await WebAssembly.instantiate(bytes, imports);
+    } else {
+        const instance = await WebAssembly.instantiate(module, imports);
+
+        if (instance instanceof WebAssembly.Instance) {
+            return { instance, module };
+        } else {
+            return instance;
+        }
+    }
+
+    function expectedResponseType(type) {
+        switch (type) {
+            case 'basic': case 'cors': case 'default': return true;
+        }
+        return false;
+    }
+}
+
+function initSync(module) {
+    if (wasm !== undefined) return wasm;
+
+
+    if (module !== undefined) {
+        if (Object.getPrototypeOf(module) === Object.prototype) {
+            ({module} = module)
+        } else {
+            console.warn('using deprecated parameters for `initSync()`; pass a single object instead')
+        }
+    }
+
+    const imports = __wbg_get_imports();
+    if (!(module instanceof WebAssembly.Module)) {
+        module = new WebAssembly.Module(module);
+    }
+    const instance = new WebAssembly.Instance(module, imports);
+    return __wbg_finalize_init(instance, module);
+}
+
+async function __wbg_init(module_or_path) {
+    if (wasm !== undefined) return wasm;
+
+
+    if (module_or_path !== undefined) {
+        if (Object.getPrototypeOf(module_or_path) === Object.prototype) {
+            ({module_or_path} = module_or_path)
+        } else {
+            console.warn('using deprecated parameters for the initialization function; pass a single object instead')
+        }
+    }
+
+    if (module_or_path === undefined) {
+        module_or_path = new URL('nidus_wasm_bg.wasm', import.meta.url);
+    }
+    const imports = __wbg_get_imports();
+
+    if (typeof module_or_path === 'string' || (typeof Request === 'function' && module_or_path instanceof Request) || (typeof URL === 'function' && module_or_path instanceof URL)) {
+        module_or_path = fetch(module_or_path);
+    }
+
+    const { instance, module } = await __wbg_load(await module_or_path, imports);
+
+    return __wbg_finalize_init(instance, module);
+}
+
+export { initSync, __wbg_init as default };

package/dist/wasm/nidus_wasm_bg.wasm.d.ts

@@ -0,0 +1,18 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const __wbg_nidushandle_free: (a: number, b: number) => void;
+export const grow_opfs_pool: (a: number, b: number) => void;
+export const init_opfs_pool: (a: number, b: number) => void;
+export const nidushandle_close: (a: number) => void;
+export const nidushandle_drop_collection: (a: number, b: number, c: number, d: number) => void;
+export const nidushandle_flush: (a: number, b: number) => void;
+export const nidushandle_footprint: (a: number, b: number) => void;
+export const nidushandle_open: (a: number, b: number, c: number, d: number) => void;
+export const nidushandle_open_in_memory: (a: number, b: number) => void;
+export const nidushandle_search: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+export const nidushandle_upsert: (a: number, b: number, c: number, d: number, e: number) => void;
+export const __wbindgen_export: (a: number, b: number) => number;
+export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_export3: (a: number) => void;
+export const __wbindgen_add_to_stack_pointer: (a: number) => number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckedup/nidus",
-  "version": "0.83.0",
+  "version": "0.85.0",
   "description": "JavaScript/TypeScript client for nidus — a small, fast vector store. Connects to a local or remote `nidus serve` over HTTP.",
   "type": "module",
   "license": "MIT",
@@ -35,6 +35,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./wasm": {
+      "types": "./dist/wasm/index.d.ts",
+      "import": "./dist/wasm/index.js"
     }
   },
   "sideEffects": false,
@@ -46,12 +50,14 @@
     "provenance": true
   },
   "scripts": {
-    "build": "tsup",
+    "build": "npm run clean && tsup && node scripts/build-wasm-subpath.mjs",
+    "build:wasm-required": "npm run clean && tsup && NIDUS_WASM_REQUIRED=1 node scripts/build-wasm-subpath.mjs",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
-    "test:unit": "vitest run test/unit.test.ts",
+    "test:unit": "vitest run test/unit.test.ts test/wasm-subpath.test.ts",
     "test:integration": "vitest run test/integration.test.ts",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\""
   },
   "devDependencies": {
     "@types/node": "^22.10.0",