@taladb/web 0.10.1 → 0.10.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taladb/web",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "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

@@ -5,14 +5,19 @@
     "taladb"
   ],
   "description": "TalaDB browser WASM bindings (wasm-bindgen + OPFS) and Cloudflare Workers",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/taladb/taladb"
+  },
   "files": [
     "taladb_web_bg.wasm",
     "taladb_web.js",
     "taladb_web.d.ts"
   ],
   "main": "taladb_web.js",
+  "homepage": "https://github.com/taladb/taladb",
   "types": "taladb_web.d.ts",
   "sideEffects": [
     "./snippets/*"

package/pkg/taladb_web.d.ts

@@ -457,6 +457,15 @@ export class WorkerDB {
      * the `openDB({ migrations })` runner, which advances it per migration.
      */
     userVersion(): number;
+    /**
+     * This collection's write generation — a counter bumped once per committed
+     * mutation.
+     *
+     * Backs `subscribe()`: a live query can compare one integer per tick
+     * instead of re-running the query and `JSON.stringify`-ing the whole
+     * result set to see whether anything moved.
+     */
+    writeGeneration(collection: string): number;
 }
 
 /**
@@ -512,7 +521,49 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
+    readonly __wbg_collectionwasm_free: (a: number, b: number) => void;
+    readonly __wbg_taladbwasm_free: (a: number, b: number) => void;
     readonly __wbg_workerdb_free: (a: number, b: number) => void;
+    readonly collectionwasm_aggregate: (a: number, b: any) => [number, number, number];
+    readonly collectionwasm_count: (a: number, b: any) => [number, number, number];
+    readonly collectionwasm_createCompoundIndex: (a: number, b: number, c: number) => [number, number];
+    readonly collectionwasm_createFtsIndex: (a: number, b: number, c: number) => [number, number];
+    readonly collectionwasm_createIndex: (a: number, b: number, c: number) => [number, number];
+    readonly collectionwasm_createVectorIndex: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number];
+    readonly collectionwasm_deleteMany: (a: number, b: any) => [number, number, number];
+    readonly collectionwasm_deleteManyWithIds: (a: number, b: any, c: number, d: number) => [number, number, number];
+    readonly collectionwasm_deleteOne: (a: number, b: any) => [number, number, number];
+    readonly collectionwasm_dropCompoundIndex: (a: number, b: number, c: number) => [number, number];
+    readonly collectionwasm_dropFtsIndex: (a: number, b: number, c: number) => [number, number];
+    readonly collectionwasm_dropIndex: (a: number, b: number, c: number) => [number, number];
+    readonly collectionwasm_dropVectorIndex: (a: number, b: number, c: number) => [number, number];
+    readonly collectionwasm_find: (a: number, b: any) => [number, number, number];
+    readonly collectionwasm_findNearest: (a: number, b: number, c: number, d: number, e: number, f: number, g: any) => [number, number, number];
+    readonly collectionwasm_findOne: (a: number, b: any) => [number, number, number];
+    readonly collectionwasm_hybridSearch: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: any, l: any) => [number, number, number];
+    readonly collectionwasm_insert: (a: number, b: any) => [number, number, number, number];
+    readonly collectionwasm_insertMany: (a: number, b: any) => [number, number, number];
+    readonly collectionwasm_replaceManyWithIds: (a: number, b: any, c: number, d: number) => [number, number, number];
+    readonly collectionwasm_searchText: (a: number, b: number, c: number, d: number, e: number, f: number, g: any, h: any) => [number, number, number];
+    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 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 opfs_open_backend: (a: number, b: number) => any;
+    readonly taladbwasm_collection: (a: number, b: number, c: number) => [number, number, number];
+    readonly taladbwasm_exportChanges: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly taladbwasm_exportSnapshot: (a: number) => [number, number, number, number];
+    readonly taladbwasm_importChanges: (a: number, b: number, c: number) => [number, number, number];
+    readonly taladbwasm_listCollectionNames: (a: number) => [number, number, number, number];
+    readonly taladbwasm_openInMemory: () => [number, number, number];
+    readonly taladbwasm_openWithSnapshot: (a: number, b: number) => [number, number, number];
+    readonly taladbwasm_setUserVersion: (a: number, b: number) => [number, number];
+    readonly taladbwasm_userVersion: (a: number) => [number, number, number];
     readonly workerdb_aggregate: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly workerdb_compact: (a: number) => [number, number];
     readonly workerdb_compactTombstones: (a: number, b: number, c: number, d: number) => [number, number, number];
@@ -557,56 +608,13 @@ export interface InitOutput {
     readonly workerdb_updateOne: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number];
     readonly workerdb_upgradeVectorIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
     readonly workerdb_userVersion: (a: number) => [number, number, number];
-    readonly __wbg_collectionwasm_free: (a: number, b: number) => void;
-    readonly __wbg_taladbwasm_free: (a: number, b: number) => void;
-    readonly collectionwasm_aggregate: (a: number, b: any) => [number, number, number];
-    readonly collectionwasm_count: (a: number, b: any) => [number, number, number];
-    readonly collectionwasm_createCompoundIndex: (a: number, b: number, c: number) => [number, number];
-    readonly collectionwasm_createFtsIndex: (a: number, b: number, c: number) => [number, number];
-    readonly collectionwasm_createIndex: (a: number, b: number, c: number) => [number, number];
-    readonly collectionwasm_createVectorIndex: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number];
-    readonly collectionwasm_deleteMany: (a: number, b: any) => [number, number, number];
-    readonly collectionwasm_deleteManyWithIds: (a: number, b: any, c: number, d: number) => [number, number, number];
-    readonly collectionwasm_deleteOne: (a: number, b: any) => [number, number, number];
-    readonly collectionwasm_dropCompoundIndex: (a: number, b: number, c: number) => [number, number];
-    readonly collectionwasm_dropFtsIndex: (a: number, b: number, c: number) => [number, number];
-    readonly collectionwasm_dropIndex: (a: number, b: number, c: number) => [number, number];
-    readonly collectionwasm_dropVectorIndex: (a: number, b: number, c: number) => [number, number];
-    readonly collectionwasm_find: (a: number, b: any) => [number, number, number];
-    readonly collectionwasm_findNearest: (a: number, b: number, c: number, d: number, e: number, f: number, g: any) => [number, number, number];
-    readonly collectionwasm_findOne: (a: number, b: any) => [number, number, number];
-    readonly collectionwasm_hybridSearch: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: any, l: any) => [number, number, number];
-    readonly collectionwasm_insert: (a: number, b: any) => [number, number, number, number];
-    readonly collectionwasm_insertMany: (a: number, b: any) => [number, number, number];
-    readonly collectionwasm_replaceManyWithIds: (a: number, b: any, c: number, d: number) => [number, number, number];
-    readonly collectionwasm_searchText: (a: number, b: number, c: number, d: number, e: number, f: number, g: any, h: any) => [number, number, number];
-    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, number, number];
-    readonly taladbwasm_exportChanges: (a: number, b: number, c: number, d: number) => [number, number, number, number];
-    readonly taladbwasm_exportSnapshot: (a: number) => [number, number, number, number];
-    readonly taladbwasm_importChanges: (a: number, b: number, c: number) => [number, number, number];
-    readonly taladbwasm_listCollectionNames: (a: number) => [number, number, number, number];
-    readonly taladbwasm_openInMemory: () => [number, number, number];
-    readonly taladbwasm_openWithSnapshot: (a: number, b: number) => [number, number, number];
-    readonly taladbwasm_setUserVersion: (a: number, b: number) => [number, number];
-    readonly taladbwasm_userVersion: (a: number) => [number, number, number];
+    readonly workerdb_writeGeneration: (a: number, b: number, c: 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 opfs_open_backend: (a: number, b: 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 wasm_bindgen_4501a39796791c69___closure__destroy___dyn_core_9b3796e30d99ddb7___ops__function__FnMut__wasm_bindgen_4501a39796791c69___JsValue____Output_______: (a: number, b: number) => void;
-    readonly wasm_bindgen_4501a39796791c69___closure__destroy___dyn_core_9b3796e30d99ddb7___ops__function__FnMut_____Output_______: (a: number, b: number) => void;
-    readonly wasm_bindgen_4501a39796791c69___closure__destroy___dyn_core_9b3796e30d99ddb7___ops__function__FnMut__wasm_bindgen_4501a39796791c69___JsValue____Output___core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_4501a39796791c69___JsError___: (a: number, b: number) => void;
-    readonly wasm_bindgen_4501a39796791c69___convert__closures_____invoke___wasm_bindgen_4501a39796791c69___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_4501a39796791c69___JsError___true_: (a: number, b: number, c: any) => [number, number];
-    readonly wasm_bindgen_4501a39796791c69___convert__closures_____invoke___js_sys_d1fdfe5cb3da44fc___Function_fn_wasm_bindgen_4501a39796791c69___JsValue_____wasm_bindgen_4501a39796791c69___sys__Undefined___js_sys_d1fdfe5cb3da44fc___Function_fn_wasm_bindgen_4501a39796791c69___JsValue_____wasm_bindgen_4501a39796791c69___sys__Undefined_______true_: (a: number, b: number, c: any, d: any) => void;
-    readonly wasm_bindgen_4501a39796791c69___convert__closures_____invoke___wasm_bindgen_4501a39796791c69___JsValue______true_: (a: number, b: number, c: any) => void;
-    readonly wasm_bindgen_4501a39796791c69___convert__closures_____invoke_______true_: (a: number, b: number) => void;
+    readonly wasm_bindgen_188fd7264b65779d___closure__destroy___dyn_core_9b3796e30d99ddb7___ops__function__FnMut__wasm_bindgen_188fd7264b65779d___JsValue____Output___core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_188fd7264b65779d___JsError___: (a: number, b: number) => void;
+    readonly wasm_bindgen_188fd7264b65779d___closure__destroy___dyn_core_9b3796e30d99ddb7___ops__function__FnMut__wasm_bindgen_188fd7264b65779d___JsValue____Output_______: (a: number, b: number) => void;
+    readonly wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___wasm_bindgen_188fd7264b65779d___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_188fd7264b65779d___JsError___true_: (a: number, b: number, c: any) => [number, number];
+    readonly wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___js_sys_6ed69cd23706a2fe___Function_fn_wasm_bindgen_188fd7264b65779d___JsValue_____wasm_bindgen_188fd7264b65779d___sys__Undefined___js_sys_6ed69cd23706a2fe___Function_fn_wasm_bindgen_188fd7264b65779d___JsValue_____wasm_bindgen_188fd7264b65779d___sys__Undefined_______true_: (a: number, b: number, c: any, d: any) => void;
+    readonly wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___wasm_bindgen_188fd7264b65779d___JsValue______true_: (a: number, b: number, c: any) => 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

@@ -1531,6 +1531,25 @@ export class WorkerDB {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * This collection's write generation — a counter bumped once per committed
+     * mutation.
+     *
+     * Backs `subscribe()`: a live query can compare one integer per tick
+     * instead of re-running the query and `JSON.stringify`-ing the whole
+     * result set to see whether anything moved.
+     * @param {string} collection
+     * @returns {number}
+     */
+    writeGeneration(collection) {
+        const ptr0 = passStringToWasm0(collection, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.workerdb_writeGeneration(this.__wbg_ptr, ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0];
+    }
 }
 if (Symbol.dispose) WorkerDB.prototype[Symbol.dispose] = WorkerDB.prototype.free;
 
@@ -1726,15 +1745,6 @@ function __wbg_get_imports() {
         __wbg__wbg_cb_unref_6b5b6b8576d35cb1: function(arg0) {
             arg0._wbg_cb_unref();
         },
-        __wbg_abort_5ef96933660780b7: function(arg0) {
-            arg0.abort();
-        },
-        __wbg_abort_6479c2d794ebf2ee: function(arg0, arg1) {
-            arg0.abort(arg1);
-        },
-        __wbg_append_608dfb635ee8998f: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4) {
-            arg0.append(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4));
-        }, arguments); },
         __wbg_apply_ac9afb97ca32f169: function() { return handleError(function (arg0, arg1, arg2) {
             const ret = arg0.apply(arg1, arg2);
             return ret;
@@ -1759,10 +1769,6 @@ function __wbg_get_imports() {
             const ret = arg0.call(arg1);
             return ret;
         }, arguments); },
-        __wbg_clearTimeout_6b8d9a38b9263d65: function(arg0) {
-            const ret = clearTimeout(arg0);
-            return ret;
-        },
         __wbg_close_8b24f0978d9a4917: function(arg0) {
             const ret = arg0.close();
             return ret;
@@ -1794,14 +1800,6 @@ function __wbg_get_imports() {
                 wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
             }
         },
-        __wbg_fetch_5550a88cf343aaa9: function(arg0, arg1) {
-            const ret = arg0.fetch(arg1);
-            return ret;
-        },
-        __wbg_fetch_9dad4fe911207b37: function(arg0) {
-            const ret = fetch(arg0);
-            return ret;
-        },
         __wbg_flush_1eca046e0ff7c399: function() { return handleError(function (arg0) {
             arg0.flush();
         }, arguments); },
@@ -1847,14 +1845,6 @@ function __wbg_get_imports() {
             const ret = arg0[arg1 >>> 0];
             return ret;
         },
-        __wbg_has_926ef2ff40b308cf: function() { return handleError(function (arg0, arg1) {
-            const ret = Reflect.has(arg0, arg1);
-            return ret;
-        }, arguments); },
-        __wbg_headers_eb2234545f9ff993: function(arg0) {
-            const ret = arg0.headers;
-            return ret;
-        },
         __wbg_instanceof_ArrayBuffer_101e2bf31071a9f6: function(arg0) {
             let result;
             try {
@@ -1935,16 +1925,6 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Response_9b4d9fd451e051b1: function(arg0) {
-            let result;
-            try {
-                result = arg0 instanceof Response;
-            } catch (_) {
-                result = false;
-            }
-            const ret = result;
-            return ret;
-        },
         __wbg_instanceof_Uint8Array_740438561a5b956d: function(arg0) {
             let result;
             try {
@@ -1993,10 +1973,6 @@ function __wbg_get_imports() {
             const ret = arg0.navigator;
             return ret;
         },
-        __wbg_new_0837727332ac86ba: function() { return handleError(function () {
-            const ret = new Headers();
-            return ret;
-        }, arguments); },
         __wbg_new_227d7c05414eb861: function() {
             const ret = new Error();
             return ret;
@@ -2017,10 +1993,6 @@ function __wbg_get_imports() {
             const ret = new Object();
             return ret;
         },
-        __wbg_new_c518c60af666645b: function() { return handleError(function () {
-            const ret = new AbortController();
-            return ret;
-        }, arguments); },
         __wbg_new_d098e265629cd10f: function(arg0, arg1) {
             try {
                 var state0 = {a: arg0, b: arg1};
@@ -2028,7 +2000,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return wasm_bindgen_4501a39796791c69___convert__closures_____invoke___js_sys_d1fdfe5cb3da44fc___Function_fn_wasm_bindgen_4501a39796791c69___JsValue_____wasm_bindgen_4501a39796791c69___sys__Undefined___js_sys_d1fdfe5cb3da44fc___Function_fn_wasm_bindgen_4501a39796791c69___JsValue_____wasm_bindgen_4501a39796791c69___sys__Undefined_______true_(a, state0.b, arg0, arg1);
+                        return wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___js_sys_6ed69cd23706a2fe___Function_fn_wasm_bindgen_188fd7264b65779d___JsValue_____wasm_bindgen_188fd7264b65779d___sys__Undefined___js_sys_6ed69cd23706a2fe___Function_fn_wasm_bindgen_188fd7264b65779d___JsValue_____wasm_bindgen_188fd7264b65779d___sys__Undefined_______true_(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -2050,7 +2022,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return wasm_bindgen_4501a39796791c69___convert__closures_____invoke___js_sys_d1fdfe5cb3da44fc___Function_fn_wasm_bindgen_4501a39796791c69___JsValue_____wasm_bindgen_4501a39796791c69___sys__Undefined___js_sys_d1fdfe5cb3da44fc___Function_fn_wasm_bindgen_4501a39796791c69___JsValue_____wasm_bindgen_4501a39796791c69___sys__Undefined_______true_(a, state0.b, arg0, arg1);
+                        return wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___js_sys_6ed69cd23706a2fe___Function_fn_wasm_bindgen_188fd7264b65779d___JsValue_____wasm_bindgen_188fd7264b65779d___sys__Undefined___js_sys_6ed69cd23706a2fe___Function_fn_wasm_bindgen_188fd7264b65779d___JsValue_____wasm_bindgen_188fd7264b65779d___sys__Undefined_______true_(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -2065,10 +2037,6 @@ function __wbg_get_imports() {
             const ret = new Uint8Array(arg0 >>> 0);
             return ret;
         },
-        __wbg_new_with_str_and_init_b4b54d1a819bc724: function() { return handleError(function (arg0, arg1, arg2) {
-            const ret = new Request(getStringFromWasm0(arg0, arg1), arg2);
-            return ret;
-        }, arguments); },
         __wbg_next_11b99ee6237339e3: function() { return handleError(function (arg0) {
             const ret = arg0.next();
             return ret;
@@ -2122,10 +2090,6 @@ function __wbg_get_imports() {
             const ret = Promise.resolve(arg0);
             return ret;
         },
-        __wbg_setTimeout_f757f00851f76c42: function(arg0, arg1) {
-            const ret = setTimeout(arg0, arg1);
-            return ret;
-        },
         __wbg_set_282384002438957f: function(arg0, arg1, arg2) {
             arg0[arg1 >>> 0] = arg2;
         },
@@ -2140,34 +2104,9 @@ function __wbg_get_imports() {
             const ret = arg0.set(arg1, arg2);
             return ret;
         },
-        __wbg_set_body_a3d856b097dfda04: function(arg0, arg1) {
-            arg0.body = arg1;
-        },
-        __wbg_set_cache_ec7e430c6056ebda: function(arg0, arg1) {
-            arg0.cache = __wbindgen_enum_RequestCache[arg1];
-        },
         __wbg_set_create_ef897736206a6f05: function(arg0, arg1) {
             arg0.create = arg1 !== 0;
         },
-        __wbg_set_credentials_ed63183445882c65: function(arg0, arg1) {
-            arg0.credentials = __wbindgen_enum_RequestCredentials[arg1];
-        },
-        __wbg_set_headers_3c8fecc693b75327: function(arg0, arg1) {
-            arg0.headers = arg1;
-        },
-        __wbg_set_method_8c015e8bcafd7be1: function(arg0, arg1, arg2) {
-            arg0.method = getStringFromWasm0(arg1, arg2);
-        },
-        __wbg_set_mode_5a87f2c809cf37c2: function(arg0, arg1) {
-            arg0.mode = __wbindgen_enum_RequestMode[arg1];
-        },
-        __wbg_set_signal_0cebecb698f25d21: function(arg0, arg1) {
-            arg0.signal = arg1;
-        },
-        __wbg_signal_166e1da31adcac18: function(arg0) {
-            const ret = arg0.signal;
-            return ret;
-        },
         __wbg_stack_3b0d974bbf31e44f: function(arg0, arg1) {
             const ret = arg1.stack;
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -2191,18 +2130,10 @@ function __wbg_get_imports() {
             const ret = typeof window === 'undefined' ? null : window;
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
         },
-        __wbg_status_318629ab93a22955: function(arg0) {
-            const ret = arg0.status;
-            return ret;
-        },
         __wbg_storage_63fa6fa9455d2153: function(arg0) {
             const ret = arg0.storage;
             return ret;
         },
-        __wbg_stringify_5ae93966a84901ac: function() { return handleError(function (arg0) {
-            const ret = JSON.stringify(arg0);
-            return ret;
-        }, arguments); },
         __wbg_subarray_a068d24e39478a8a: function(arg0, arg1, arg2) {
             const ret = arg0.subarray(arg1 >>> 0, arg2 >>> 0);
             return ret;
@@ -2218,13 +2149,6 @@ function __wbg_get_imports() {
         __wbg_truncate_af8ac1613ab66393: function() { return handleError(function (arg0, arg1) {
             arg0.truncate(arg1);
         }, arguments); },
-        __wbg_url_7fefc1820fba4e0c: function(arg0, arg1) {
-            const ret = arg1.url;
-            const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-            const len1 = WASM_VECTOR_LEN;
-            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
-            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
-        },
         __wbg_value_21fc78aab0322612: function(arg0) {
             const ret = arg0.value;
             return ret;
@@ -2234,46 +2158,41 @@ function __wbg_get_imports() {
             return ret;
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 142, function: Function { arguments: [Externref], shim_idx: 143, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_4501a39796791c69___closure__destroy___dyn_core_9b3796e30d99ddb7___ops__function__FnMut__wasm_bindgen_4501a39796791c69___JsValue____Output_______, wasm_bindgen_4501a39796791c69___convert__closures_____invoke___wasm_bindgen_4501a39796791c69___JsValue______true_);
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 560, function: Function { arguments: [Externref], shim_idx: 561, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_188fd7264b65779d___closure__destroy___dyn_core_9b3796e30d99ddb7___ops__function__FnMut__wasm_bindgen_188fd7264b65779d___JsValue____Output___core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_188fd7264b65779d___JsError___, wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___wasm_bindgen_188fd7264b65779d___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_188fd7264b65779d___JsError___true_);
             return ret;
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 222, function: Function { arguments: [], shim_idx: 223, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_4501a39796791c69___closure__destroy___dyn_core_9b3796e30d99ddb7___ops__function__FnMut_____Output_______, wasm_bindgen_4501a39796791c69___convert__closures_____invoke_______true_);
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 7, function: Function { arguments: [Externref], shim_idx: 8, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_188fd7264b65779d___closure__destroy___dyn_core_9b3796e30d99ddb7___ops__function__FnMut__wasm_bindgen_188fd7264b65779d___JsValue____Output_______, wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___wasm_bindgen_188fd7264b65779d___JsValue______true_);
             return ret;
         },
-        __wbindgen_cast_0000000000000003: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 702, function: Function { arguments: [Externref], shim_idx: 703, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_4501a39796791c69___closure__destroy___dyn_core_9b3796e30d99ddb7___ops__function__FnMut__wasm_bindgen_4501a39796791c69___JsValue____Output___core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_4501a39796791c69___JsError___, wasm_bindgen_4501a39796791c69___convert__closures_____invoke___wasm_bindgen_4501a39796791c69___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_4501a39796791c69___JsError___true_);
-            return ret;
-        },
-        __wbindgen_cast_0000000000000004: function(arg0) {
+        __wbindgen_cast_0000000000000003: function(arg0) {
             // Cast intrinsic for `F64 -> Externref`.
             const ret = arg0;
             return ret;
         },
-        __wbindgen_cast_0000000000000005: function(arg0) {
+        __wbindgen_cast_0000000000000004: function(arg0) {
             // Cast intrinsic for `I64 -> Externref`.
             const ret = arg0;
             return ret;
         },
-        __wbindgen_cast_0000000000000006: function(arg0, arg1) {
+        __wbindgen_cast_0000000000000005: function(arg0, arg1) {
             // Cast intrinsic for `Ref(Slice(U8)) -> NamedExternref("Uint8Array")`.
             const ret = getArrayU8FromWasm0(arg0, arg1);
             return ret;
         },
-        __wbindgen_cast_0000000000000007: function(arg0, arg1) {
+        __wbindgen_cast_0000000000000006: function(arg0, arg1) {
             // Cast intrinsic for `Ref(String) -> Externref`.
             const ret = getStringFromWasm0(arg0, arg1);
             return ret;
         },
-        __wbindgen_cast_0000000000000008: function(arg0) {
+        __wbindgen_cast_0000000000000007: function(arg0) {
             // Cast intrinsic for `U64 -> Externref`.
             const ret = BigInt.asUintN(64, arg0);
             return ret;
         },
-        __wbindgen_cast_0000000000000009: function(arg0, arg1) {
+        __wbindgen_cast_0000000000000008: function(arg0, arg1) {
             var v0 = getArrayU8FromWasm0(arg0, arg1).slice();
             wasm.__wbindgen_free(arg0, arg1 * 1, 1);
             // Cast intrinsic for `Vector(U8) -> Externref`.
@@ -2296,33 +2215,21 @@ function __wbg_get_imports() {
     };
 }
 
-function wasm_bindgen_4501a39796791c69___convert__closures_____invoke_______true_(arg0, arg1) {
-    wasm.wasm_bindgen_4501a39796791c69___convert__closures_____invoke_______true_(arg0, arg1);
-}
-
-function wasm_bindgen_4501a39796791c69___convert__closures_____invoke___wasm_bindgen_4501a39796791c69___JsValue______true_(arg0, arg1, arg2) {
-    wasm.wasm_bindgen_4501a39796791c69___convert__closures_____invoke___wasm_bindgen_4501a39796791c69___JsValue______true_(arg0, arg1, arg2);
+function wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___wasm_bindgen_188fd7264b65779d___JsValue______true_(arg0, arg1, arg2) {
+    wasm.wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___wasm_bindgen_188fd7264b65779d___JsValue______true_(arg0, arg1, arg2);
 }
 
-function wasm_bindgen_4501a39796791c69___convert__closures_____invoke___wasm_bindgen_4501a39796791c69___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_4501a39796791c69___JsError___true_(arg0, arg1, arg2) {
-    const ret = wasm.wasm_bindgen_4501a39796791c69___convert__closures_____invoke___wasm_bindgen_4501a39796791c69___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_4501a39796791c69___JsError___true_(arg0, arg1, arg2);
+function wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___wasm_bindgen_188fd7264b65779d___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_188fd7264b65779d___JsError___true_(arg0, arg1, arg2) {
+    const ret = wasm.wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___wasm_bindgen_188fd7264b65779d___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_188fd7264b65779d___JsError___true_(arg0, arg1, arg2);
     if (ret[1]) {
         throw takeFromExternrefTable0(ret[0]);
     }
 }
 
-function wasm_bindgen_4501a39796791c69___convert__closures_____invoke___js_sys_d1fdfe5cb3da44fc___Function_fn_wasm_bindgen_4501a39796791c69___JsValue_____wasm_bindgen_4501a39796791c69___sys__Undefined___js_sys_d1fdfe5cb3da44fc___Function_fn_wasm_bindgen_4501a39796791c69___JsValue_____wasm_bindgen_4501a39796791c69___sys__Undefined_______true_(arg0, arg1, arg2, arg3) {
-    wasm.wasm_bindgen_4501a39796791c69___convert__closures_____invoke___js_sys_d1fdfe5cb3da44fc___Function_fn_wasm_bindgen_4501a39796791c69___JsValue_____wasm_bindgen_4501a39796791c69___sys__Undefined___js_sys_d1fdfe5cb3da44fc___Function_fn_wasm_bindgen_4501a39796791c69___JsValue_____wasm_bindgen_4501a39796791c69___sys__Undefined_______true_(arg0, arg1, arg2, arg3);
+function wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___js_sys_6ed69cd23706a2fe___Function_fn_wasm_bindgen_188fd7264b65779d___JsValue_____wasm_bindgen_188fd7264b65779d___sys__Undefined___js_sys_6ed69cd23706a2fe___Function_fn_wasm_bindgen_188fd7264b65779d___JsValue_____wasm_bindgen_188fd7264b65779d___sys__Undefined_______true_(arg0, arg1, arg2, arg3) {
+    wasm.wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___js_sys_6ed69cd23706a2fe___Function_fn_wasm_bindgen_188fd7264b65779d___JsValue_____wasm_bindgen_188fd7264b65779d___sys__Undefined___js_sys_6ed69cd23706a2fe___Function_fn_wasm_bindgen_188fd7264b65779d___JsValue_____wasm_bindgen_188fd7264b65779d___sys__Undefined_______true_(arg0, arg1, arg2, arg3);
 }
 
-
-const __wbindgen_enum_RequestCache = ["default", "no-store", "reload", "no-cache", "force-cache", "only-if-cached"];
-
-
-const __wbindgen_enum_RequestCredentials = ["omit", "same-origin", "include"];
-
-
-const __wbindgen_enum_RequestMode = ["same-origin", "no-cors", "cors", "navigate"];
 const CollectionWasmFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_collectionwasm_free(ptr >>> 0, 1));

package/pkg/taladb_web_bg.wasm.d.ts

@@ -1,7 +1,49 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
+export const __wbg_collectionwasm_free: (a: number, b: number) => void;
+export const __wbg_taladbwasm_free: (a: number, b: number) => void;
 export const __wbg_workerdb_free: (a: number, b: number) => void;
+export const collectionwasm_aggregate: (a: number, b: any) => [number, number, number];
+export const collectionwasm_count: (a: number, b: any) => [number, number, number];
+export const collectionwasm_createCompoundIndex: (a: number, b: number, c: number) => [number, number];
+export const collectionwasm_createFtsIndex: (a: number, b: number, c: number) => [number, number];
+export const collectionwasm_createIndex: (a: number, b: number, c: number) => [number, number];
+export const collectionwasm_createVectorIndex: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number];
+export const collectionwasm_deleteMany: (a: number, b: any) => [number, number, number];
+export const collectionwasm_deleteManyWithIds: (a: number, b: any, c: number, d: number) => [number, number, number];
+export const collectionwasm_deleteOne: (a: number, b: any) => [number, number, number];
+export const collectionwasm_dropCompoundIndex: (a: number, b: number, c: number) => [number, number];
+export const collectionwasm_dropFtsIndex: (a: number, b: number, c: number) => [number, number];
+export const collectionwasm_dropIndex: (a: number, b: number, c: number) => [number, number];
+export const collectionwasm_dropVectorIndex: (a: number, b: number, c: number) => [number, number];
+export const collectionwasm_find: (a: number, b: any) => [number, number, number];
+export const collectionwasm_findNearest: (a: number, b: number, c: number, d: number, e: number, f: number, g: any) => [number, number, number];
+export const collectionwasm_findOne: (a: number, b: any) => [number, number, number];
+export const collectionwasm_hybridSearch: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: any, l: any) => [number, number, number];
+export const collectionwasm_insert: (a: number, b: any) => [number, number, number, number];
+export const collectionwasm_insertMany: (a: number, b: any) => [number, number, number];
+export const collectionwasm_replaceManyWithIds: (a: number, b: any, c: number, d: number) => [number, number, number];
+export const collectionwasm_searchText: (a: number, b: number, c: number, d: number, e: number, f: number, g: any, h: any) => [number, 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 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 opfs_open_backend: (a: number, b: number) => any;
+export const taladbwasm_collection: (a: number, b: number, c: number) => [number, number, number];
+export const taladbwasm_exportChanges: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+export const taladbwasm_exportSnapshot: (a: number) => [number, number, number, number];
+export const taladbwasm_importChanges: (a: number, b: number, c: number) => [number, number, number];
+export const taladbwasm_listCollectionNames: (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 taladbwasm_setUserVersion: (a: number, b: number) => [number, number];
+export const taladbwasm_userVersion: (a: number) => [number, number, number];
 export const workerdb_aggregate: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
 export const workerdb_compact: (a: number) => [number, number];
 export const workerdb_compactTombstones: (a: number, b: number, c: number, d: number) => [number, number, number];
@@ -46,56 +88,13 @@ export const workerdb_updateMany: (a: number, b: number, c: number, d: number, e
 export const workerdb_updateOne: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number];
 export const workerdb_upgradeVectorIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
 export const workerdb_userVersion: (a: number) => [number, number, number];
-export const __wbg_collectionwasm_free: (a: number, b: number) => void;
-export const __wbg_taladbwasm_free: (a: number, b: number) => void;
-export const collectionwasm_aggregate: (a: number, b: any) => [number, number, number];
-export const collectionwasm_count: (a: number, b: any) => [number, number, number];
-export const collectionwasm_createCompoundIndex: (a: number, b: number, c: number) => [number, number];
-export const collectionwasm_createFtsIndex: (a: number, b: number, c: number) => [number, number];
-export const collectionwasm_createIndex: (a: number, b: number, c: number) => [number, number];
-export const collectionwasm_createVectorIndex: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number];
-export const collectionwasm_deleteMany: (a: number, b: any) => [number, number, number];
-export const collectionwasm_deleteManyWithIds: (a: number, b: any, c: number, d: number) => [number, number, number];
-export const collectionwasm_deleteOne: (a: number, b: any) => [number, number, number];
-export const collectionwasm_dropCompoundIndex: (a: number, b: number, c: number) => [number, number];
-export const collectionwasm_dropFtsIndex: (a: number, b: number, c: number) => [number, number];
-export const collectionwasm_dropIndex: (a: number, b: number, c: number) => [number, number];
-export const collectionwasm_dropVectorIndex: (a: number, b: number, c: number) => [number, number];
-export const collectionwasm_find: (a: number, b: any) => [number, number, number];
-export const collectionwasm_findNearest: (a: number, b: number, c: number, d: number, e: number, f: number, g: any) => [number, number, number];
-export const collectionwasm_findOne: (a: number, b: any) => [number, number, number];
-export const collectionwasm_hybridSearch: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: any, l: any) => [number, number, number];
-export const collectionwasm_insert: (a: number, b: any) => [number, number, number, number];
-export const collectionwasm_insertMany: (a: number, b: any) => [number, number, number];
-export const collectionwasm_replaceManyWithIds: (a: number, b: any, c: number, d: number) => [number, number, number];
-export const collectionwasm_searchText: (a: number, b: number, c: number, d: number, e: number, f: number, g: any, h: any) => [number, 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, number, number];
-export const taladbwasm_exportChanges: (a: number, b: number, c: number, d: number) => [number, number, number, number];
-export const taladbwasm_exportSnapshot: (a: number) => [number, number, number, number];
-export const taladbwasm_importChanges: (a: number, b: number, c: number) => [number, number, number];
-export const taladbwasm_listCollectionNames: (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 taladbwasm_setUserVersion: (a: number, b: number) => [number, number];
-export const taladbwasm_userVersion: (a: number) => [number, number, number];
+export const workerdb_writeGeneration: (a: number, b: number, c: 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 opfs_open_backend: (a: number, b: 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 wasm_bindgen_4501a39796791c69___closure__destroy___dyn_core_9b3796e30d99ddb7___ops__function__FnMut__wasm_bindgen_4501a39796791c69___JsValue____Output_______: (a: number, b: number) => void;
-export const wasm_bindgen_4501a39796791c69___closure__destroy___dyn_core_9b3796e30d99ddb7___ops__function__FnMut_____Output_______: (a: number, b: number) => void;
-export const wasm_bindgen_4501a39796791c69___closure__destroy___dyn_core_9b3796e30d99ddb7___ops__function__FnMut__wasm_bindgen_4501a39796791c69___JsValue____Output___core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_4501a39796791c69___JsError___: (a: number, b: number) => void;
-export const wasm_bindgen_4501a39796791c69___convert__closures_____invoke___wasm_bindgen_4501a39796791c69___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_4501a39796791c69___JsError___true_: (a: number, b: number, c: any) => [number, number];
-export const wasm_bindgen_4501a39796791c69___convert__closures_____invoke___js_sys_d1fdfe5cb3da44fc___Function_fn_wasm_bindgen_4501a39796791c69___JsValue_____wasm_bindgen_4501a39796791c69___sys__Undefined___js_sys_d1fdfe5cb3da44fc___Function_fn_wasm_bindgen_4501a39796791c69___JsValue_____wasm_bindgen_4501a39796791c69___sys__Undefined_______true_: (a: number, b: number, c: any, d: any) => void;
-export const wasm_bindgen_4501a39796791c69___convert__closures_____invoke___wasm_bindgen_4501a39796791c69___JsValue______true_: (a: number, b: number, c: any) => void;
-export const wasm_bindgen_4501a39796791c69___convert__closures_____invoke_______true_: (a: number, b: number) => void;
+export const wasm_bindgen_188fd7264b65779d___closure__destroy___dyn_core_9b3796e30d99ddb7___ops__function__FnMut__wasm_bindgen_188fd7264b65779d___JsValue____Output___core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_188fd7264b65779d___JsError___: (a: number, b: number) => void;
+export const wasm_bindgen_188fd7264b65779d___closure__destroy___dyn_core_9b3796e30d99ddb7___ops__function__FnMut__wasm_bindgen_188fd7264b65779d___JsValue____Output_______: (a: number, b: number) => void;
+export const wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___wasm_bindgen_188fd7264b65779d___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_188fd7264b65779d___JsError___true_: (a: number, b: number, c: any) => [number, number];
+export const wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___js_sys_6ed69cd23706a2fe___Function_fn_wasm_bindgen_188fd7264b65779d___JsValue_____wasm_bindgen_188fd7264b65779d___sys__Undefined___js_sys_6ed69cd23706a2fe___Function_fn_wasm_bindgen_188fd7264b65779d___JsValue_____wasm_bindgen_188fd7264b65779d___sys__Undefined_______true_: (a: number, b: number, c: any, d: any) => void;
+export const wasm_bindgen_188fd7264b65779d___convert__closures_____invoke___wasm_bindgen_188fd7264b65779d___JsValue______true_: (a: number, b: number, c: any) => 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

@@ -117,6 +117,26 @@ let pendingSnapshotResolve = null;
  */
 const initPromises = new Map();
 
+/**
+ * WASM fetch + compile, started at module scope rather than inside `doInit`.
+ *
+ * The worker is spawned and its module evaluated well before the main thread's
+ * `init` message arrives. Waiting for that message to *begin* downloading ~1 MB
+ * of WASM left the whole spawn-and-post round trip idle; kicking it off here
+ * overlaps the two. `doInit` simply awaits this.
+ *
+ * A rejection here is not unhandled: `doInit` awaits it and surfaces the error
+ * to the caller as a failed `init`. The no-op catch keeps the runtime from
+ * reporting it as unhandled in the window between module eval and that await.
+ * @type {Promise<typeof import('../pkg/taladb_web')>}
+ */
+const wasmReady = (async () => {
+  const wasm = await import(/* @vite-ignore */ '../pkg/taladb_web.js');
+  await wasm.default();
+  return wasm;
+})();
+wasmReady.catch(() => {});
+
 /** The dbName that was successfully initialised (or is being initialised). */
 let activeDbName = null;
 
@@ -479,6 +499,10 @@ async function dispatch(op, args) {
     case 'count':
       return db.count(args.collection, args.filterJson ?? 'null');
 
+    // Cheap change-detection for subscribe(): one integer, no query.
+    case 'writeGeneration':
+      return db.writeGeneration(args.collection);
+
     case 'aggregate':
       return db.aggregate(args.collection, args.pipelineJson ?? '[]');
 
@@ -688,14 +712,29 @@ async function loadOrCreateSalt(root, saltFileName) {
 // ---------------------------------------------------------------------------
 
 async function doInit(dbName, configJson, passphrase = null) {
-  const wasm = await import(/* @vite-ignore */ '../pkg/taladb_web.js');
-  await wasm.default();
+  encrypted = typeof passphrase === 'string' && passphrase.length > 0;
+
+  const opfsAvailable = canUseOpfs();
+
+  // Compiling ~1 MB of WASM and setting up OPFS are independent, and OPFS setup
+  // is four awaited round trips (getDirectory → getFileHandle → lock →
+  // createSyncAccessHandle). Starting both now lets the storage latency hide
+  // behind the compile instead of following it.
+  //
+  // `wasmReady` was already kicked off at module scope — see its declaration.
+  const opfsSetup = opfsAvailable
+    ? (async () => {
+        const root = await navigator.storage.getDirectory();
+        const fileName = `taladb_${dbName.replaceAll(/[/\\:]/g, '_')}.redb`;
+        return { root, fileName, fileHandle: await root.getFileHandle(fileName, { create: true }) };
+      })().catch(() => null)
+    : Promise.resolve(null);
+
+  const wasm = await wasmReady;
 
   // Hoist to module scope so snapshot reloads in dispatch() can use it.
   WorkerDB = wasm.WorkerDB;
 
-  encrypted = typeof passphrase === 'string' && passphrase.length > 0;
-
   // Open the BroadcastChannel now that we know the db name.
   if (typeof BroadcastChannel !== 'undefined') {
     broadcastChannel = new BroadcastChannel(`taladb:${dbName}`);
@@ -762,16 +801,13 @@ async function doInit(dbName, configJson, passphrase = null) {
     );
   }
 
-  const opfsAvailable = await checkOpfs();
-  if (!opfsAvailable) {
-    if (encrypted) {
-      throw new Error(
-        'TalaDB encryption requires OPFS, which is unavailable in this browser context. ' +
-        'Refusing to open — the in-memory/IndexedDB fallback cannot encrypt at rest.'
-      );
-    }
-    warn('OPFS unavailable — falling back to IndexedDB-backed in-memory');
-    const snapshot = await idbLoadSnapshot(dbName);
+  /**
+   * Open an in-memory database seeded from the last IndexedDB snapshot, and
+   * keep flushing snapshots back. The degradation path whenever OPFS is
+   * unusable. Never valid for encrypted databases — the snapshot is plaintext.
+   */
+  async function openIdbFallback(name) {
+    const snapshot = await idbLoadSnapshot(name);
     db = openWithSnapshot(snapshot);
     idbFallback = true;
     snapshotWriter = true;
@@ -780,12 +816,24 @@ async function doInit(dbName, configJson, passphrase = null) {
     } else {
       log('New in-memory database — writes will be persisted to IndexedDB');
     }
+  }
+
+  // `opfsSetup` resolves to null when OPFS is unusable — either the capability
+  // check said so up front, or getDirectory/getFileHandle actually failed.
+  const opfs = await opfsSetup;
+  if (!opfs) {
+    if (encrypted) {
+      throw new Error(
+        'TalaDB encryption requires OPFS, which is unavailable in this browser context. ' +
+        'Refusing to open — the in-memory/IndexedDB fallback cannot encrypt at rest.'
+      );
+    }
+    warn('OPFS unavailable — falling back to IndexedDB-backed in-memory');
+    await openIdbFallback(dbName);
     return;
   }
 
-  const root = await navigator.storage.getDirectory();
-  const fileName = `taladb_${dbName.replaceAll(/[/\\:]/g, '_')}.redb`;
-  const fileHandle = await root.getFileHandle(fileName, { create: true });
+  const { root, fileName, fileHandle } = opfs;
 
   // Encrypted mode: the 16-byte key-derivation salt lives in an OPFS sidecar
   // file next to the DB. It is loaded/created only AFTER this tab has won the
@@ -796,7 +844,20 @@ async function doInit(dbName, configJson, passphrase = null) {
     // Web Locks not available — open directly (single-tab safe only).
     warn('Web Locks unavailable — multi-tab write safety disabled');
     if (encrypted) salt = await loadOrCreateSalt(root, `${fileName}.salt`);
-    const syncHandle = await fileHandle.createSyncAccessHandle();
+    let syncHandle;
+    try {
+      syncHandle = await fileHandle.createSyncAccessHandle();
+    } catch (e) {
+      // `createSyncAccessHandle` can exist on the prototype and still throw —
+      // Firefox without storage access, a cross-origin iframe, a revoked
+      // permission. The removed probe file used to surface that as "OPFS
+      // unavailable"; catching it here keeps the same graceful degradation
+      // rather than failing the open outright.
+      if (encrypted) throw e; // the IDB fallback cannot encrypt at rest
+      warn('OPFS sync access unavailable — falling back to IndexedDB:', e);
+      await openIdbFallback(dbName);
+      return;
+    }
     try {
       db = openWithOpfs(syncHandle);
     } catch (e) {
@@ -863,7 +924,18 @@ async function doInit(dbName, configJson, passphrase = null) {
       let syncHandle = null;
       try {
         if (encrypted) salt = await loadOrCreateSalt(root, `${fileName}.salt`);
-        syncHandle = await fileHandle.createSyncAccessHandle();
+        try {
+          syncHandle = await fileHandle.createSyncAccessHandle();
+        } catch (e) {
+          // See the no-locks branch: the method can exist and still throw, and
+          // that used to be caught by the probe file. Degrade to IndexedDB
+          // instead of failing the open.
+          if (encrypted) throw e; // the IDB fallback cannot encrypt at rest
+          warn('OPFS sync access unavailable — falling back to IndexedDB:', e);
+          await openIdbFallback(dbName);
+          resolve();
+          return; // releases the Web Lock — this tab is not the OPFS holder
+        }
         db = openWithOpfs(syncHandle);
         snapshotWriter = !encrypted; // encrypted DBs never write a plaintext IDB snapshot
         log(`Opened "${fileName}" via OPFS (Web Locks)`);
@@ -893,21 +965,24 @@ async function doInit(dbName, configJson, passphrase = null) {
 // OPFS capability probe
 // ---------------------------------------------------------------------------
 
-async function checkOpfs() {
-  try {
-    const root = await navigator.storage.getDirectory();
-    // Probe createSyncAccessHandle — only available in Dedicated Workers.
-    // getDirectory() succeeding alone is not sufficient.
-    // Use a unique filename so concurrent workers don't collide on the same
-    // probe file (each createSyncAccessHandle is exclusive).
-    const probeName = `_taladb_probe_${Date.now()}_${Math.random().toString(36).slice(2)}`;
-    const probe = await root.getFileHandle(probeName, { create: true });
-    if (typeof probe.createSyncAccessHandle !== 'function') return false;
-    const handle = await probe.createSyncAccessHandle();
-    handle.close();
-    await root.removeEntry(probeName);
-    return true;
-  } catch {
-    return false;
-  }
+/**
+ * Whether this context can do synchronous OPFS I/O.
+ *
+ * This used to create a uniquely-named probe file, open a sync access handle on
+ * it, close it, and delete it — four sequential OPFS round trips on every cold
+ * start, immediately before the real open performed the identical sequence on
+ * the actual database file and would have failed the same way. The capability
+ * check below is synchronous and free; anything the probe would have caught
+ * (permissions, cross-origin isolation, a non-Worker scope) surfaces from the
+ * real open, which `doInit` already handles by falling back to IndexedDB.
+ *
+ * @returns {boolean}
+ */
+function canUseOpfs() {
+  return (
+    typeof navigator !== 'undefined' &&
+    typeof navigator.storage?.getDirectory === 'function' &&
+    typeof FileSystemFileHandle !== 'undefined' &&
+    typeof FileSystemFileHandle.prototype?.createSyncAccessHandle === 'function'
+  );
 }