@taladb/web 0.6.1 → 0.7.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taladb/web",
-  "version": "0.6.1",
+  "version": "0.7.3",
   "description": "TalaDB WASM bindings — document queries and vector search in the browser",
   "main": "pkg/taladb_web.js",
   "types": "pkg/taladb_web.d.ts",

package/pkg/package.json

@@ -4,8 +4,8 @@
   "collaborators": [
     "thinkgrid-labs"
   ],
-  "description": "TalaDB browser WASM bindings (wasm-bindgen + OPFS)",
-  "version": "0.6.1",
+  "description": "TalaDB browser WASM bindings (wasm-bindgen + OPFS) and Cloudflare Workers",
+  "version": "0.7.3",
   "license": "MIT",
   "files": [
     "taladb_web_bg.wasm",

package/pkg/taladb_web.d.ts

@@ -16,11 +16,11 @@ export class CollectionWasm {
     /**
      * Create a vector index on `field`.
      *
-     * `dimensions`           — expected vector length.
-     * `metric`               — optional: `"cosine"` (default), `"dot"`, or `"euclidean"`.
-     * `index_type`           — optional: `"flat"` (default) or `"hnsw"`.
-     * `hnsw_m`               — HNSW connectivity (default 16).
-     * `hnsw_ef_construction` — build quality (default 200).
+     * `dimensions`           - expected vector length.
+     * `metric`               - optional: `"cosine"` (default), `"dot"`, or `"euclidean"`.
+     * `index_type`           - optional: `"flat"` (default) or `"hnsw"`.
+     * `hnsw_m`               - HNSW connectivity (default 16).
+     * `hnsw_ef_construction` - build quality (default 200).
      */
     createVectorIndex(field: string, dimensions: number, metric?: string | null, index_type?: string | null, hnsw_m?: number | null, hnsw_ef_construction?: number | null): void;
     /**
@@ -46,7 +46,7 @@ export class CollectionWasm {
     /**
      * Find the `top_k` nearest documents to `query` on a vector index.
      *
-     * `filter` — optional pre-filter (same format as `find`). Pass `null` to
+     * `filter` - optional pre-filter (same format as `find`). Pass `null` to
      *            search across all documents that have the vector field.
      *
      * Returns a JSON array of `{ document: {...}, score: number }` objects.
@@ -108,7 +108,7 @@ export class TalaDBWasm {
      * ```js
      * const bytes = await opfs_load_snapshot('myapp.db');   // null on first open
      * const db = TalaDBWasm.openWithSnapshot(bytes);
-     * // … mutations …
+     * // ... mutations ...
      * await opfs_flush_snapshot('myapp.db', db.exportSnapshot());
      * ```
      */
@@ -119,6 +119,18 @@ export class WorkerDB {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Compact the underlying OPFS / redb storage file, reclaiming space freed
+     * by deletes and updates.
+     *
+     * Call this during idle periods (e.g. once on app startup after tombstone
+     * compaction). No-op on in-memory (IDB-fallback) databases.
+     *
+     * ```js
+     * db.compact();
+     * ```
+     */
+    compact(): void;
     /**
      * Remove tombstones older than `before_ms` from the given collection.
      *
@@ -202,7 +214,7 @@ export class WorkerDB {
      * ```js
      * const resp = await fetch('/sync?since=' + lastSync);
      * const applied = db.importChangeset(await resp.text());
-     * if (applied > 0) { /* refresh UI */ }
+     * if (applied > 0) { rerender(); }
      * ```
      */
     importChangeset(changeset_json: string): number;
@@ -231,7 +243,9 @@ export class WorkerDB {
     /**
      * Open a database backed by OPFS with HTTP push sync config.
      *
-     * `config_json` — JSON-serialised `TalaDbConfig`, or `null` to open without sync.
+     * Not available when compiled with the `cf-workers` feature.
+     *
+     * `config_json` - JSON-serialised `TalaDbConfig`, or `null` to open without sync.
      *
      * ```js
      * const handle = await file_handle.createSyncAccessHandle();
@@ -242,7 +256,7 @@ export class WorkerDB {
     /**
      * Open a database from an optional snapshot with HTTP push sync config.
      *
-     * `config_json` — JSON-serialised `TalaDbConfig`, or `null` to open without sync.
+     * `config_json` - JSON-serialised `TalaDbConfig`, or `null` to open without sync.
      *
      * ```js
      * const db = WorkerDB.openWithConfigAndSnapshot(snapshot, JSON.stringify(config));
@@ -252,6 +266,8 @@ export class WorkerDB {
     /**
      * Open a database backed by an OPFS `FileSystemSyncAccessHandle`.
      *
+     * Not available when compiled with the `cf-workers` feature.
+     *
      * Call sequence in the SharedWorker:
      * ```js
      * const handle = await file_handle.createSyncAccessHandle();
@@ -342,6 +358,7 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly __wbg_workerdb_free: (a: number, b: number) => void;
+    readonly workerdb_compact: (a: number) => [number, number];
     readonly workerdb_compactTombstones: (a: number, b: number, c: number, d: number) => [number, number, number];
     readonly workerdb_count: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
     readonly workerdb_createFtsIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
@@ -387,25 +404,25 @@ export interface InitOutput {
     readonly collectionwasm_updateMany: (a: number, b: any, c: any) => [number, number, number];
     readonly collectionwasm_updateOne: (a: number, b: any, c: any) => [number, number, number];
     readonly collectionwasm_upgradeVectorIndex: (a: number, b: number, c: number) => [number, number];
-    readonly taladbwasm_collection: (a: number, b: number, c: number) => number;
+    readonly taladbwasm_collection: (a: number, b: number, c: number) => [number, number, number];
     readonly taladbwasm_exportSnapshot: (a: number) => [number, number, number, number];
     readonly taladbwasm_openInMemory: () => [number, number, number];
     readonly taladbwasm_openWithSnapshot: (a: number, b: number) => [number, number, number];
     readonly init: () => void;
-    readonly idb_load_snapshot: (a: number, b: number) => any;
-    readonly idb_save_snapshot: (a: number, b: number, c: number, d: number) => any;
     readonly is_opfs_available: () => any;
     readonly opfs_delete_snapshot: (a: number, b: number) => any;
     readonly opfs_flush_snapshot: (a: number, b: number, c: number, d: number) => any;
     readonly opfs_load_snapshot: (a: number, b: number) => any;
+    readonly idb_load_snapshot: (a: number, b: number) => any;
+    readonly idb_save_snapshot: (a: number, b: number, c: number, d: number) => any;
     readonly opfs_open_backend: (a: number, b: number) => any;
-    readonly wasm_bindgen__closure__destroy__h72641f1e1c5255af: (a: number, b: number) => void;
-    readonly wasm_bindgen__closure__destroy__h478053cb26acc43f: (a: number, b: number) => void;
-    readonly wasm_bindgen__closure__destroy__h1febc128ce23ccd1: (a: number, b: number) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__h3022e61d849d0b12: (a: number, b: number, c: any) => [number, number];
-    readonly wasm_bindgen__convert__closures_____invoke__h470c93d8a24e0015: (a: number, b: number, c: any, d: any) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__h296c8d2fd599fbcf: (a: number, b: number, c: any) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__h325a87e086f6f78c: (a: number, b: number) => void;
+    readonly wasm_bindgen__closure__destroy__hf5d71bc2d02a6064: (a: number, b: number) => void;
+    readonly wasm_bindgen__closure__destroy__h48e8a8f67ee293c6: (a: number, b: number) => void;
+    readonly wasm_bindgen__closure__destroy__h8b8dc50e88fa67bc: (a: number, b: number) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__hfb64ebab929241fc: (a: number, b: number, c: any) => [number, number];
+    readonly wasm_bindgen__convert__closures_____invoke__h31b79bb0cf86afae: (a: number, b: number, c: any, d: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h57a4f572d4d576bf: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__had96e062ebd712a6: (a: number, b: number) => void;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_exn_store: (a: number) => void;

package/pkg/taladb_web.js

@@ -45,11 +45,11 @@ export class CollectionWasm {
     /**
      * Create a vector index on `field`.
      *
-     * `dimensions`           — expected vector length.
-     * `metric`               — optional: `"cosine"` (default), `"dot"`, or `"euclidean"`.
-     * `index_type`           — optional: `"flat"` (default) or `"hnsw"`.
-     * `hnsw_m`               — HNSW connectivity (default 16).
-     * `hnsw_ef_construction` — build quality (default 200).
+     * `dimensions`           - expected vector length.
+     * `metric`               - optional: `"cosine"` (default), `"dot"`, or `"euclidean"`.
+     * `index_type`           - optional: `"flat"` (default) or `"hnsw"`.
+     * `hnsw_m`               - HNSW connectivity (default 16).
+     * `hnsw_ef_construction` - build quality (default 200).
      * @param {string} field
      * @param {number} dimensions
      * @param {string | null} [metric]
@@ -132,7 +132,7 @@ export class CollectionWasm {
     /**
      * Find the `top_k` nearest documents to `query` on a vector index.
      *
-     * `filter` — optional pre-filter (same format as `find`). Pass `null` to
+     * `filter` - optional pre-filter (same format as `find`). Pass `null` to
      *            search across all documents that have the vector field.
      *
      * Returns a JSON array of `{ document: {...}, score: number }` objects.
@@ -268,7 +268,10 @@ export class TalaDBWasm {
         const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
         const ret = wasm.taladbwasm_collection(this.__wbg_ptr, ptr0, len0);
-        return CollectionWasm.__wrap(ret);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return CollectionWasm.__wrap(ret[0]);
     }
     /**
      * Serialize the entire in-memory database to bytes.
@@ -308,7 +311,7 @@ export class TalaDBWasm {
      * ```js
      * const bytes = await opfs_load_snapshot('myapp.db');   // null on first open
      * const db = TalaDBWasm.openWithSnapshot(bytes);
-     * // … mutations …
+     * // ... mutations ...
      * await opfs_flush_snapshot('myapp.db', db.exportSnapshot());
      * ```
      * @param {Uint8Array | null} [snapshot]
@@ -344,6 +347,23 @@ export class WorkerDB {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_workerdb_free(ptr, 0);
     }
+    /**
+     * Compact the underlying OPFS / redb storage file, reclaiming space freed
+     * by deletes and updates.
+     *
+     * Call this during idle periods (e.g. once on app startup after tombstone
+     * compaction). No-op on in-memory (IDB-fallback) databases.
+     *
+     * ```js
+     * db.compact();
+     * ```
+     */
+    compact() {
+        const ret = wasm.workerdb_compact(this.__wbg_ptr);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
     /**
      * Remove tombstones older than `before_ms` from the given collection.
      *
@@ -670,7 +690,7 @@ export class WorkerDB {
      * ```js
      * const resp = await fetch('/sync?since=' + lastSync);
      * const applied = db.importChangeset(await resp.text());
-     * if (applied > 0) { /* refresh UI */ }
+     * if (applied > 0) { rerender(); }
      * ```
      * @param {string} changeset_json
      * @returns {number}
@@ -803,7 +823,9 @@ export class WorkerDB {
     /**
      * Open a database backed by OPFS with HTTP push sync config.
      *
-     * `config_json` — JSON-serialised `TalaDbConfig`, or `null` to open without sync.
+     * Not available when compiled with the `cf-workers` feature.
+     *
+     * `config_json` - JSON-serialised `TalaDbConfig`, or `null` to open without sync.
      *
      * ```js
      * const handle = await file_handle.createSyncAccessHandle();
@@ -825,7 +847,7 @@ export class WorkerDB {
     /**
      * Open a database from an optional snapshot with HTTP push sync config.
      *
-     * `config_json` — JSON-serialised `TalaDbConfig`, or `null` to open without sync.
+     * `config_json` - JSON-serialised `TalaDbConfig`, or `null` to open without sync.
      *
      * ```js
      * const db = WorkerDB.openWithConfigAndSnapshot(snapshot, JSON.stringify(config));
@@ -848,6 +870,8 @@ export class WorkerDB {
     /**
      * Open a database backed by an OPFS `FileSystemSyncAccessHandle`.
      *
+     * Not available when compiled with the `cf-workers` feature.
+     *
      * Call sequence in the SharedWorker:
      * ```js
      * const handle = await file_handle.createSyncAccessHandle();
@@ -1429,7 +1453,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return wasm_bindgen__convert__closures_____invoke__h470c93d8a24e0015(a, state0.b, arg0, arg1);
+                        return wasm_bindgen__convert__closures_____invoke__h31b79bb0cf86afae(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -1451,7 +1475,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return wasm_bindgen__convert__closures_____invoke__h470c93d8a24e0015(a, state0.b, arg0, arg1);
+                        return wasm_bindgen__convert__closures_____invoke__h31b79bb0cf86afae(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -1612,18 +1636,18 @@ function __wbg_get_imports() {
             return ret;
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 102, function: Function { arguments: [Externref], shim_idx: 103, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h72641f1e1c5255af, wasm_bindgen__convert__closures_____invoke__h296c8d2fd599fbcf);
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 137, function: Function { arguments: [Externref], shim_idx: 138, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__hf5d71bc2d02a6064, wasm_bindgen__convert__closures_____invoke__h57a4f572d4d576bf);
             return ret;
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 181, function: Function { arguments: [], shim_idx: 182, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h478053cb26acc43f, wasm_bindgen__convert__closures_____invoke__h325a87e086f6f78c);
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 187, function: Function { arguments: [], shim_idx: 188, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h48e8a8f67ee293c6, wasm_bindgen__convert__closures_____invoke__had96e062ebd712a6);
             return ret;
         },
         __wbindgen_cast_0000000000000003: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 589, function: Function { arguments: [Externref], shim_idx: 590, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h1febc128ce23ccd1, wasm_bindgen__convert__closures_____invoke__h3022e61d849d0b12);
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 629, function: Function { arguments: [Externref], shim_idx: 630, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h8b8dc50e88fa67bc, wasm_bindgen__convert__closures_____invoke__hfb64ebab929241fc);
             return ret;
         },
         __wbindgen_cast_0000000000000004: function(arg0) {
@@ -1669,23 +1693,23 @@ function __wbg_get_imports() {
     };
 }
 
-function wasm_bindgen__convert__closures_____invoke__h325a87e086f6f78c(arg0, arg1) {
-    wasm.wasm_bindgen__convert__closures_____invoke__h325a87e086f6f78c(arg0, arg1);
+function wasm_bindgen__convert__closures_____invoke__had96e062ebd712a6(arg0, arg1) {
+    wasm.wasm_bindgen__convert__closures_____invoke__had96e062ebd712a6(arg0, arg1);
 }
 
-function wasm_bindgen__convert__closures_____invoke__h296c8d2fd599fbcf(arg0, arg1, arg2) {
-    wasm.wasm_bindgen__convert__closures_____invoke__h296c8d2fd599fbcf(arg0, arg1, arg2);
+function wasm_bindgen__convert__closures_____invoke__h57a4f572d4d576bf(arg0, arg1, arg2) {
+    wasm.wasm_bindgen__convert__closures_____invoke__h57a4f572d4d576bf(arg0, arg1, arg2);
 }
 
-function wasm_bindgen__convert__closures_____invoke__h3022e61d849d0b12(arg0, arg1, arg2) {
-    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h3022e61d849d0b12(arg0, arg1, arg2);
+function wasm_bindgen__convert__closures_____invoke__hfb64ebab929241fc(arg0, arg1, arg2) {
+    const ret = wasm.wasm_bindgen__convert__closures_____invoke__hfb64ebab929241fc(arg0, arg1, arg2);
     if (ret[1]) {
         throw takeFromExternrefTable0(ret[0]);
     }
 }
 
-function wasm_bindgen__convert__closures_____invoke__h470c93d8a24e0015(arg0, arg1, arg2, arg3) {
-    wasm.wasm_bindgen__convert__closures_____invoke__h470c93d8a24e0015(arg0, arg1, arg2, arg3);
+function wasm_bindgen__convert__closures_____invoke__h31b79bb0cf86afae(arg0, arg1, arg2, arg3) {
+    wasm.wasm_bindgen__convert__closures_____invoke__h31b79bb0cf86afae(arg0, arg1, arg2, arg3);
 }
 
 

package/pkg/taladb_web_bg.wasm.d.ts

@@ -2,6 +2,7 @@
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
 export const __wbg_workerdb_free: (a: number, b: number) => void;
+export const workerdb_compact: (a: number) => [number, number];
 export const workerdb_compactTombstones: (a: number, b: number, c: number, d: number) => [number, number, number];
 export const workerdb_count: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
 export const workerdb_createFtsIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
@@ -47,25 +48,25 @@ export const collectionwasm_insertMany: (a: number, b: any) => [number, number,
 export const collectionwasm_updateMany: (a: number, b: any, c: any) => [number, number, number];
 export const collectionwasm_updateOne: (a: number, b: any, c: any) => [number, number, number];
 export const collectionwasm_upgradeVectorIndex: (a: number, b: number, c: number) => [number, number];
-export const taladbwasm_collection: (a: number, b: number, c: number) => number;
+export const taladbwasm_collection: (a: number, b: number, c: number) => [number, number, number];
 export const taladbwasm_exportSnapshot: (a: number) => [number, number, number, number];
 export const taladbwasm_openInMemory: () => [number, number, number];
 export const taladbwasm_openWithSnapshot: (a: number, b: number) => [number, number, number];
 export const init: () => void;
-export const idb_load_snapshot: (a: number, b: number) => any;
-export const idb_save_snapshot: (a: number, b: number, c: number, d: number) => any;
 export const is_opfs_available: () => any;
 export const opfs_delete_snapshot: (a: number, b: number) => any;
 export const opfs_flush_snapshot: (a: number, b: number, c: number, d: number) => any;
 export const opfs_load_snapshot: (a: number, b: number) => any;
+export const idb_load_snapshot: (a: number, b: number) => any;
+export const idb_save_snapshot: (a: number, b: number, c: number, d: number) => any;
 export const opfs_open_backend: (a: number, b: number) => any;
-export const wasm_bindgen__closure__destroy__h72641f1e1c5255af: (a: number, b: number) => void;
-export const wasm_bindgen__closure__destroy__h478053cb26acc43f: (a: number, b: number) => void;
-export const wasm_bindgen__closure__destroy__h1febc128ce23ccd1: (a: number, b: number) => void;
-export const wasm_bindgen__convert__closures_____invoke__h3022e61d849d0b12: (a: number, b: number, c: any) => [number, number];
-export const wasm_bindgen__convert__closures_____invoke__h470c93d8a24e0015: (a: number, b: number, c: any, d: any) => void;
-export const wasm_bindgen__convert__closures_____invoke__h296c8d2fd599fbcf: (a: number, b: number, c: any) => void;
-export const wasm_bindgen__convert__closures_____invoke__h325a87e086f6f78c: (a: number, b: number) => void;
+export const wasm_bindgen__closure__destroy__hf5d71bc2d02a6064: (a: number, b: number) => void;
+export const wasm_bindgen__closure__destroy__h48e8a8f67ee293c6: (a: number, b: number) => void;
+export const wasm_bindgen__closure__destroy__h8b8dc50e88fa67bc: (a: number, b: number) => void;
+export const wasm_bindgen__convert__closures_____invoke__hfb64ebab929241fc: (a: number, b: number, c: any) => [number, number];
+export const wasm_bindgen__convert__closures_____invoke__h31b79bb0cf86afae: (a: number, b: number, c: any, d: any) => void;
+export const wasm_bindgen__convert__closures_____invoke__h57a4f572d4d576bf: (a: number, b: number, c: any) => void;
+export const wasm_bindgen__convert__closures_____invoke__had96e062ebd712a6: (a: number, b: number) => void;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_exn_store: (a: number) => void;

package/worker/taladb.worker.js

@@ -49,6 +49,7 @@
  * upgradeVectorIndex { collection, field }
  * findNearest       { collection, field, queryJson, topK, filterJson? }
  * listCollections   {}                             → JSON string[]
+ * compact           {}                             → null
  * compactTombstones { collection, beforeMs }       → number pruned
  * exportChangeset   { collectionsJson, sinceMs? }  → JSON changeset string
  * importChangeset   { changesetJson }              → number of applied changes
@@ -459,6 +460,11 @@ async function dispatch(op, args) {
     case 'listCollections':
       return db.listCollections();
 
+    case 'compact':
+      // Compact the storage file, reclaiming freed space. No-op on IDB fallback.
+      db.compact();
+      return null;
+
     case 'compactTombstones':
       // Prune tombstones older than beforeMs from a collection.
       // Returns the count of tombstones removed.
@@ -499,7 +505,7 @@ async function dispatch(op, args) {
 // ---------------------------------------------------------------------------
 
 async function doInit(dbName, configJson) {
-  const wasm = await import('../pkg/taladb_web.js');
+  const wasm = await import(/* @vite-ignore */ '../pkg/taladb_web.js');
   await wasm.default();
 
   // Hoist to module scope so snapshot reloads in dispatch() can use it.