@taladb/web 0.9.1 → 0.9.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taladb/web",
-  "version": "0.9.1",
+  "version": "0.9.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,7 +5,7 @@
     "thinkgrid-labs"
   ],
   "description": "TalaDB browser WASM bindings (wasm-bindgen + OPFS) and Cloudflare Workers",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "license": "MIT",
   "files": [
     "taladb_web_bg.wasm",

package/pkg/taladb_web.d.ts

@@ -142,6 +142,16 @@ export class TalaDBWasm {
      * ```
      */
     static openWithSnapshot(snapshot?: Uint8Array | null): TalaDBWasm;
+    /**
+     * Persist the application migration version. Called after each migration's
+     * body succeeds so a crash mid-run resumes from the last applied version.
+     */
+    setUserVersion(version: number): void;
+    /**
+     * Read the current application migration version (0 if never set). Backs
+     * the `openDB({ migrations })` runner, which advances it per migration.
+     */
+    userVersion(): number;
 }
 
 export class WorkerDB {
@@ -246,6 +256,11 @@ export class WorkerDB {
      * Find one document. Returns a JSON object or `"null"`.
      */
     findOne(collection: string, filter_json: string): string;
+    /**
+     * Force batched (eventual) OPFS writes to durable storage. No-op under the
+     * default immediate durability. Backs `db.flush()`.
+     */
+    flush(): void;
     /**
      * Import a remote changeset and merge it into the local database using
      * Last-Write-Wins conflict resolution.
@@ -259,6 +274,13 @@ export class WorkerDB {
      * ```
      */
     importChangeset(changeset_json: string): number;
+    /**
+     * Import a remote changeset through a tolerant structural validator built
+     * from `schemas_json` (`{ "<collection>": { version, required, types,
+     * defaults } }`). Returns a JSON `{ applied, skipped, quarantined }`.
+     * Rejected documents are set aside (see `quarantined`), never dropped.
+     */
+    importChangesetValidated(changeset_json: string, schemas_json: string): string;
     /**
      * Insert a document. Returns the new ULID as a string.
      */
@@ -328,6 +350,22 @@ export class WorkerDB {
      * ```
      */
     static openWithSnapshot(data?: Uint8Array | null): WorkerDB;
+    /**
+     * Documents set aside in `collection`'s quarantine table, as a JSON array
+     * of `{ document, reason, changedAt }`.
+     */
+    quarantined(collection: string): string;
+    /**
+     * Set write durability: `eventual = true` batches OPFS fsyncs for
+     * throughput (call `flush()` to force), `false` (default) fsyncs each
+     * commit. Derived from `durability.flush_every_write` by the worker.
+     */
+    setDurability(eventual: boolean): void;
+    /**
+     * Persist the application migration version. Called after each migration's
+     * body succeeds so a crash mid-run resumes from the last applied version.
+     */
+    setUserVersion(version: number): void;
     syncPending(): bigint;
     syncStatus(): string;
     /**
@@ -345,6 +383,11 @@ export class WorkerDB {
      * No-op when the `vector-hnsw` feature is disabled or the index is flat-only.
      */
     upgradeVectorIndex(collection: string, field: string): void;
+    /**
+     * Read the current application migration version (0 if never set). Backs
+     * the `openDB({ migrations })` runner, which advances it per migration.
+     */
+    userVersion(): number;
 }
 
 /**
@@ -420,7 +463,9 @@ export interface InitOutput {
     readonly workerdb_find: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly workerdb_findNearest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number, number, number];
     readonly workerdb_findOne: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly workerdb_flush: (a: number) => [number, number];
     readonly workerdb_importChangeset: (a: number, b: number, c: number) => [number, number, number];
+    readonly workerdb_importChangesetValidated: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly workerdb_insert: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly workerdb_insertMany: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly workerdb_listCollections: (a: number) => [number, number, number, number];
@@ -430,11 +475,15 @@ export interface InitOutput {
     readonly workerdb_openWithConfigAndSnapshot: (a: number, b: number, c: number, d: number) => [number, number, number];
     readonly workerdb_openWithOpfs: (a: any) => [number, number, number];
     readonly workerdb_openWithSnapshot: (a: number, b: number) => [number, number, number];
+    readonly workerdb_quarantined: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly workerdb_setDurability: (a: number, b: number) => void;
+    readonly workerdb_setUserVersion: (a: number, b: number) => [number, number];
     readonly workerdb_syncPending: (a: number) => bigint;
     readonly workerdb_syncStatus: (a: number) => [number, number];
     readonly workerdb_updateMany: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number];
     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];
@@ -462,17 +511,19 @@ export interface InitOutput {
     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 init: () => void;
     readonly opfs_open_backend: (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 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 wasm_bindgen_60ce93de3f474933___closure__destroy___dyn_core_7d5f0a2ba6a62c33___ops__function__FnMut__wasm_bindgen_60ce93de3f474933___JsValue____Output_______: (a: number, b: number) => void;
     readonly wasm_bindgen_60ce93de3f474933___closure__destroy___dyn_core_7d5f0a2ba6a62c33___ops__function__FnMut_____Output_______: (a: number, b: number) => void;
     readonly wasm_bindgen_60ce93de3f474933___closure__destroy___dyn_core_7d5f0a2ba6a62c33___ops__function__FnMut__wasm_bindgen_60ce93de3f474933___JsValue____Output___core_7d5f0a2ba6a62c33___result__Result_____wasm_bindgen_60ce93de3f474933___JsError___: (a: number, b: number) => void;
-    readonly wasm_bindgen_60ce93de3f474933___closure__destroy___dyn_core_7d5f0a2ba6a62c33___ops__function__FnMut__wasm_bindgen_60ce93de3f474933___JsValue____Output_______: (a: number, b: number) => void;
     readonly wasm_bindgen_60ce93de3f474933___convert__closures_____invoke___wasm_bindgen_60ce93de3f474933___JsValue__core_7d5f0a2ba6a62c33___result__Result_____wasm_bindgen_60ce93de3f474933___JsError___true_: (a: number, b: number, c: any) => [number, number];
     readonly wasm_bindgen_60ce93de3f474933___convert__closures_____invoke___js_sys_517e1093b71f55ec___Function_fn_wasm_bindgen_60ce93de3f474933___JsValue_____wasm_bindgen_60ce93de3f474933___sys__Undefined___js_sys_517e1093b71f55ec___Function_fn_wasm_bindgen_60ce93de3f474933___JsValue_____wasm_bindgen_60ce93de3f474933___sys__Undefined_______true_: (a: number, b: number, c: any, d: any) => void;
     readonly wasm_bindgen_60ce93de3f474933___convert__closures_____invoke___wasm_bindgen_60ce93de3f474933___JsValue______true_: (a: number, b: number, c: any) => void;

package/pkg/taladb_web.js

@@ -420,6 +420,29 @@ export class TalaDBWasm {
         }
         return TalaDBWasm.__wrap(ret[0]);
     }
+    /**
+     * Persist the application migration version. Called after each migration's
+     * body succeeds so a crash mid-run resumes from the last applied version.
+     * @param {number} version
+     */
+    setUserVersion(version) {
+        const ret = wasm.taladbwasm_setUserVersion(this.__wbg_ptr, version);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * Read the current application migration version (0 if never set). Backs
+     * the `openDB({ migrations })` runner, which advances it per migration.
+     * @returns {number}
+     */
+    userVersion() {
+        const ret = wasm.taladbwasm_userVersion(this.__wbg_ptr);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] >>> 0;
+    }
 }
 if (Symbol.dispose) TalaDBWasm.prototype[Symbol.dispose] = TalaDBWasm.prototype.free;
 
@@ -833,6 +856,16 @@ export class WorkerDB {
             wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
         }
     }
+    /**
+     * Force batched (eventual) OPFS writes to durable storage. No-op under the
+     * default immediate durability. Backs `db.flush()`.
+     */
+    flush() {
+        const ret = wasm.workerdb_flush(this.__wbg_ptr);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
     /**
      * Import a remote changeset and merge it into the local database using
      * Last-Write-Wins conflict resolution.
@@ -856,6 +889,37 @@ export class WorkerDB {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * Import a remote changeset through a tolerant structural validator built
+     * from `schemas_json` (`{ "<collection>": { version, required, types,
+     * defaults } }`). Returns a JSON `{ applied, skipped, quarantined }`.
+     * Rejected documents are set aside (see `quarantined`), never dropped.
+     * @param {string} changeset_json
+     * @param {string} schemas_json
+     * @returns {string}
+     */
+    importChangesetValidated(changeset_json, schemas_json) {
+        let deferred4_0;
+        let deferred4_1;
+        try {
+            const ptr0 = passStringToWasm0(changeset_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(schemas_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len1 = WASM_VECTOR_LEN;
+            const ret = wasm.workerdb_importChangesetValidated(this.__wbg_ptr, ptr0, len0, ptr1, len1);
+            var ptr3 = ret[0];
+            var len3 = ret[1];
+            if (ret[3]) {
+                ptr3 = 0; len3 = 0;
+                throw takeFromExternrefTable0(ret[2]);
+            }
+            deferred4_0 = ptr3;
+            deferred4_1 = len3;
+            return getStringFromWasm0(ptr3, len3);
+        } finally {
+            wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
+        }
+    }
     /**
      * Insert a document. Returns the new ULID as a string.
      * @param {string} collection
@@ -1067,6 +1131,52 @@ export class WorkerDB {
         }
         return WorkerDB.__wrap(ret[0]);
     }
+    /**
+     * Documents set aside in `collection`'s quarantine table, as a JSON array
+     * of `{ document, reason, changedAt }`.
+     * @param {string} collection
+     * @returns {string}
+     */
+    quarantined(collection) {
+        let deferred3_0;
+        let deferred3_1;
+        try {
+            const ptr0 = passStringToWasm0(collection, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len0 = WASM_VECTOR_LEN;
+            const ret = wasm.workerdb_quarantined(this.__wbg_ptr, ptr0, len0);
+            var ptr2 = ret[0];
+            var len2 = ret[1];
+            if (ret[3]) {
+                ptr2 = 0; len2 = 0;
+                throw takeFromExternrefTable0(ret[2]);
+            }
+            deferred3_0 = ptr2;
+            deferred3_1 = len2;
+            return getStringFromWasm0(ptr2, len2);
+        } finally {
+            wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+        }
+    }
+    /**
+     * Set write durability: `eventual = true` batches OPFS fsyncs for
+     * throughput (call `flush()` to force), `false` (default) fsyncs each
+     * commit. Derived from `durability.flush_every_write` by the worker.
+     * @param {boolean} eventual
+     */
+    setDurability(eventual) {
+        wasm.workerdb_setDurability(this.__wbg_ptr, eventual);
+    }
+    /**
+     * Persist the application migration version. Called after each migration's
+     * body succeeds so a crash mid-run resumes from the last applied version.
+     * @param {number} version
+     */
+    setUserVersion(version) {
+        const ret = wasm.workerdb_setUserVersion(this.__wbg_ptr, version);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
     /**
      * @returns {bigint}
      */
@@ -1147,6 +1257,18 @@ export class WorkerDB {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * Read the current application migration version (0 if never set). Backs
+     * the `openDB({ migrations })` runner, which advances it per migration.
+     * @returns {number}
+     */
+    userVersion() {
+        const ret = wasm.workerdb_userVersion(this.__wbg_ptr);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] >>> 0;
+    }
 }
 if (Symbol.dispose) WorkerDB.prototype[Symbol.dispose] = WorkerDB.prototype.free;
 
@@ -1850,18 +1972,18 @@ function __wbg_get_imports() {
             return ret;
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 215, function: Function { arguments: [], shim_idx: 216, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_60ce93de3f474933___closure__destroy___dyn_core_7d5f0a2ba6a62c33___ops__function__FnMut_____Output_______, wasm_bindgen_60ce93de3f474933___convert__closures_____invoke_______true_);
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 144, function: Function { arguments: [Externref], shim_idx: 145, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_60ce93de3f474933___closure__destroy___dyn_core_7d5f0a2ba6a62c33___ops__function__FnMut__wasm_bindgen_60ce93de3f474933___JsValue____Output_______, wasm_bindgen_60ce93de3f474933___convert__closures_____invoke___wasm_bindgen_60ce93de3f474933___JsValue______true_);
             return ret;
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 692, function: Function { arguments: [Externref], shim_idx: 693, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_60ce93de3f474933___closure__destroy___dyn_core_7d5f0a2ba6a62c33___ops__function__FnMut__wasm_bindgen_60ce93de3f474933___JsValue____Output___core_7d5f0a2ba6a62c33___result__Result_____wasm_bindgen_60ce93de3f474933___JsError___, wasm_bindgen_60ce93de3f474933___convert__closures_____invoke___wasm_bindgen_60ce93de3f474933___JsValue__core_7d5f0a2ba6a62c33___result__Result_____wasm_bindgen_60ce93de3f474933___JsError___true_);
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 224, function: Function { arguments: [], shim_idx: 225, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_60ce93de3f474933___closure__destroy___dyn_core_7d5f0a2ba6a62c33___ops__function__FnMut_____Output_______, wasm_bindgen_60ce93de3f474933___convert__closures_____invoke_______true_);
             return ret;
         },
         __wbindgen_cast_0000000000000003: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 71, function: Function { arguments: [Externref], shim_idx: 72, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_60ce93de3f474933___closure__destroy___dyn_core_7d5f0a2ba6a62c33___ops__function__FnMut__wasm_bindgen_60ce93de3f474933___JsValue____Output_______, wasm_bindgen_60ce93de3f474933___convert__closures_____invoke___wasm_bindgen_60ce93de3f474933___JsValue______true_);
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 707, function: Function { arguments: [Externref], shim_idx: 708, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_60ce93de3f474933___closure__destroy___dyn_core_7d5f0a2ba6a62c33___ops__function__FnMut__wasm_bindgen_60ce93de3f474933___JsValue____Output___core_7d5f0a2ba6a62c33___result__Result_____wasm_bindgen_60ce93de3f474933___JsError___, wasm_bindgen_60ce93de3f474933___convert__closures_____invoke___wasm_bindgen_60ce93de3f474933___JsValue__core_7d5f0a2ba6a62c33___result__Result_____wasm_bindgen_60ce93de3f474933___JsError___true_);
             return ret;
         },
         __wbindgen_cast_0000000000000004: function(arg0) {

package/pkg/taladb_web_bg.wasm.d.ts

@@ -21,7 +21,9 @@ export const workerdb_exportSnapshot: (a: number) => [number, number, number, nu
 export const workerdb_find: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
 export const workerdb_findNearest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number, number, number];
 export const workerdb_findOne: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+export const workerdb_flush: (a: number) => [number, number];
 export const workerdb_importChangeset: (a: number, b: number, c: number) => [number, number, number];
+export const workerdb_importChangesetValidated: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
 export const workerdb_insert: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
 export const workerdb_insertMany: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
 export const workerdb_listCollections: (a: number) => [number, number, number, number];
@@ -31,11 +33,15 @@ export const workerdb_openWithConfigAndOpfs: (a: any, b: number, c: number, d: n
 export const workerdb_openWithConfigAndSnapshot: (a: number, b: number, c: number, d: number) => [number, number, number];
 export const workerdb_openWithOpfs: (a: any) => [number, number, number];
 export const workerdb_openWithSnapshot: (a: number, b: number) => [number, number, number];
+export const workerdb_quarantined: (a: number, b: number, c: number) => [number, number, number, number];
+export const workerdb_setDurability: (a: number, b: number) => void;
+export const workerdb_setUserVersion: (a: number, b: number) => [number, number];
 export const workerdb_syncPending: (a: number) => bigint;
 export const workerdb_syncStatus: (a: number) => [number, number];
 export const workerdb_updateMany: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number];
 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];
@@ -63,17 +69,19 @@ export const taladbwasm_importChanges: (a: number, b: number, c: number) => [num
 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 init: () => void;
 export const opfs_open_backend: (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 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 wasm_bindgen_60ce93de3f474933___closure__destroy___dyn_core_7d5f0a2ba6a62c33___ops__function__FnMut__wasm_bindgen_60ce93de3f474933___JsValue____Output_______: (a: number, b: number) => void;
 export const wasm_bindgen_60ce93de3f474933___closure__destroy___dyn_core_7d5f0a2ba6a62c33___ops__function__FnMut_____Output_______: (a: number, b: number) => void;
 export const wasm_bindgen_60ce93de3f474933___closure__destroy___dyn_core_7d5f0a2ba6a62c33___ops__function__FnMut__wasm_bindgen_60ce93de3f474933___JsValue____Output___core_7d5f0a2ba6a62c33___result__Result_____wasm_bindgen_60ce93de3f474933___JsError___: (a: number, b: number) => void;
-export const wasm_bindgen_60ce93de3f474933___closure__destroy___dyn_core_7d5f0a2ba6a62c33___ops__function__FnMut__wasm_bindgen_60ce93de3f474933___JsValue____Output_______: (a: number, b: number) => void;
 export const wasm_bindgen_60ce93de3f474933___convert__closures_____invoke___wasm_bindgen_60ce93de3f474933___JsValue__core_7d5f0a2ba6a62c33___result__Result_____wasm_bindgen_60ce93de3f474933___JsError___true_: (a: number, b: number, c: any) => [number, number];
 export const wasm_bindgen_60ce93de3f474933___convert__closures_____invoke___js_sys_517e1093b71f55ec___Function_fn_wasm_bindgen_60ce93de3f474933___JsValue_____wasm_bindgen_60ce93de3f474933___sys__Undefined___js_sys_517e1093b71f55ec___Function_fn_wasm_bindgen_60ce93de3f474933___JsValue_____wasm_bindgen_60ce93de3f474933___sys__Undefined_______true_: (a: number, b: number, c: any, d: any) => void;
 export const wasm_bindgen_60ce93de3f474933___convert__closures_____invoke___wasm_bindgen_60ce93de3f474933___JsValue______true_: (a: number, b: number, c: any) => void;

package/worker/taladb.worker.js

@@ -258,7 +258,9 @@ async function idbSaveSnapshot(dbName, bytes) {
  * per document.  A max-interval cap ensures data is never more than 5 s stale
  * in IDB even under continuous write load.
  */
-const SNAPSHOT_DEBOUNCE_MS = 500;
+/** IDB snapshot debounce, in ms. Overridable via config `durability.flush_ms`
+ * at init (the OPFS/redb path uses `durability.flush_every_write` instead). */
+let snapshotDebounceMs = 500;
 const SNAPSHOT_MAX_INTERVAL_MS = 5000;
 
 /** setTimeout handle for the pending debounced flush. */
@@ -285,7 +287,7 @@ async function flushSnapshot() {
  * Schedule (or immediately trigger) an IDB snapshot write.
  *
  * - If the last flush was more than SNAPSHOT_MAX_INTERVAL_MS ago, flush now.
- * - Otherwise debounce: reset the timer to fire SNAPSHOT_DEBOUNCE_MS from now.
+ * - Otherwise debounce: reset the timer to fire snapshotDebounceMs from now.
  */
 function scheduleSnapshot() {
   const now = Date.now();
@@ -295,7 +297,23 @@ function scheduleSnapshot() {
     return;
   }
   clearTimeout(snapshotTimer);
-  snapshotTimer = setTimeout(() => { flushSnapshot().catch(() => {}); }, SNAPSHOT_DEBOUNCE_MS);
+  snapshotTimer = setTimeout(() => { flushSnapshot().catch(() => {}); }, snapshotDebounceMs);
+}
+
+/** Apply `durability` config to a freshly-opened WorkerDB instance: OPFS/redb
+ * durability from `flush_every_write`, and the IDB-fallback debounce from
+ * `flush_ms`. Returns the instance for chaining. */
+function applyDurability(inst) {
+  let flushEveryWrite = true;
+  try {
+    const d = activeConfigJson ? JSON.parse(activeConfigJson)?.durability : null;
+    if (d) {
+      if (typeof d.flush_every_write === 'boolean') flushEveryWrite = d.flush_every_write;
+      if (typeof d.flush_ms === 'number' && d.flush_ms >= 0) snapshotDebounceMs = d.flush_ms;
+    }
+  } catch { /* ignore malformed config */ }
+  inst?.setDurability?.(!flushEveryWrite); // feature-detect (older WASM lacks it)
+  return inst;
 }
 
 /**
@@ -514,6 +532,13 @@ async function dispatch(op, args) {
       db.compact();
       return null;
 
+    case 'flush':
+      // "Save now": force batched OPFS writes durable (no-op under immediate
+      // durability) and write the IDB fallback snapshot immediately.
+      db.flush?.();
+      await flushSnapshot();
+      return null;
+
     case 'syncStatus':
       return db.syncStatus();
 
@@ -543,6 +568,31 @@ async function dispatch(op, args) {
       return applied;
     }
 
+    case 'importChangesetValidated': {
+      // Tolerant validated import: normalize/skip/quarantine per schema, LWW.
+      // Returns a JSON string { applied, skipped, quarantined }.
+      const reportJson = db.importChangesetValidated(args.changesetJson, args.schemasJson);
+      const report = JSON.parse(reportJson);
+      // Quarantined documents are written to the quarantine table, so a batch
+      // that only quarantines still dirties the database. Without this, the IDB
+      // fallback would never snapshot them and they would be lost on reload —
+      // the opposite of the "never dropped on the floor" guarantee.
+      if ((report.applied ?? 0) > 0 || (report.quarantined ?? 0) > 0) onWriteCommitted();
+      return reportJson;
+    }
+
+    case 'quarantined':
+      // JSON array of documents set aside by a validated import.
+      return db.quarantined(args.collection);
+
+    case 'userVersion':
+      // Current application migration version (backs openDB({ migrations })).
+      return db.userVersion();
+
+    case 'setUserVersion':
+      db.setUserVersion(args.version);
+      return null;
+
     case 'close':
       // Give accepted HTTP push events a bounded opportunity to finish.
       {
@@ -661,15 +711,19 @@ async function doInit(dbName, configJson, passphrase = null) {
   // Uses the config-aware constructors when configJson is provided so that
   // HTTP push sync is wired up from the first write.
   function openWithSnapshot(snapshot) {
-    if (configJson) return WorkerDB.openWithConfigAndSnapshot(snapshot, configJson);
-    return WorkerDB.openWithSnapshot(snapshot);
+    const inst = configJson
+      ? WorkerDB.openWithConfigAndSnapshot(snapshot, configJson)
+      : WorkerDB.openWithSnapshot(snapshot);
+    return applyDurability(inst);
   }
   // Salt for key derivation, loaded/created in an OPFS sidecar (encrypted mode
   // only). Passed to the WASM open so the derived key is stable across opens.
   let salt = null;
   function openWithOpfs(syncHandle) {
     // openWithConfigAndOpfs(handle, configJson, passphrase?, salt?)
-    return WorkerDB.openWithConfigAndOpfs(syncHandle, configJson ?? null, passphrase, salt);
+    return applyDurability(
+      WorkerDB.openWithConfigAndOpfs(syncHandle, configJson ?? null, passphrase, salt),
+    );
   }
 
   const opfsAvailable = await checkOpfs();