@taladb/web 0.9.3 → 0.9.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taladb/web",
-  "version": "0.9.3",
+  "version": "0.9.4",
   "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.3",
+  "version": "0.9.4",
   "license": "MIT",
   "files": [
     "taladb_web_bg.wasm",

package/pkg/taladb_web.d.ts

@@ -36,6 +36,10 @@ export class CollectionWasm {
      * Delete all matching documents. Returns the count deleted.
      */
     deleteMany(filter: any): number;
+    /**
+     * Delete many documents by id, in one commit. Returns the number removed.
+     */
+    deleteManyWithIds(ids: any, origin: string): number;
     /**
      * Delete the first matching document. Returns true if deleted.
      */
@@ -77,6 +81,18 @@ export class CollectionWasm {
      * Insert multiple documents. Returns an array of ULID string ids.
      */
     insertMany(docs: any): any;
+    /**
+     * Upsert many documents **by caller-supplied `_id`**, in one commit.
+     *
+     * Unlike [`Self::insert_many`] — which mints a fresh ULID and discards `_id` —
+     * this honours the id on each document, which is what lets replication address
+     * a remote row by a *derived* id so repeated fetches converge on one document
+     * instead of duplicating it.
+     *
+     * `origin` is `"remote"` for authoritative rows replicated in from an origin,
+     * or `"local"` for ordinary user writes.
+     */
+    replaceManyWithIds(docs: any, origin: string): any;
     /**
      * Update all matching documents. Returns the count updated.
      */
@@ -211,6 +227,10 @@ export class WorkerDB {
      * Delete all matching documents. Returns the count deleted.
      */
     deleteMany(collection: string, filter_json: string): number;
+    /**
+     * Delete many documents by id, in one commit. Returns the number removed.
+     */
+    deleteManyWithIds(collection: string, ids_json: string, origin: string): number;
     /**
      * Delete the first matching document. Returns `true` / `false`.
      */
@@ -355,6 +375,19 @@ export class WorkerDB {
      * of `{ document, reason, changedAt }`.
      */
     quarantined(collection: string): string;
+    /**
+     * Upsert many documents **by caller-supplied `_id`**, in one commit.
+     *
+     * Unlike `insert_many` — which discards `_id` and mints a fresh ULID — this
+     * honours the id in each document. That is what lets the replication
+     * coordinator address a remote row by a *derived* id (see `deriveDocId`) and
+     * have repeated fetches converge on one document instead of duplicating it.
+     *
+     * `origin` is `"remote"` for authoritative rows replicated in from an origin,
+     * or `"local"` for ordinary user writes. Remote rows are marked so they can
+     * never replicate back out — see `Collection::replace_many_with_ids`.
+     */
+    replaceManyWithIds(collection: string, docs_json: string, origin: string): string;
     /**
      * Set write durability: `eventual = true` batches OPFS fsyncs for
      * throughput (call `flush()` to force), `false` (default) fsyncs each
@@ -453,6 +486,7 @@ export interface InitOutput {
     readonly workerdb_createIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
     readonly workerdb_createVectorIndex: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => [number, number];
     readonly workerdb_deleteMany: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+    readonly workerdb_deleteManyWithIds: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number];
     readonly workerdb_deleteOne: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
     readonly workerdb_dropCompoundIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
     readonly workerdb_dropFtsIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
@@ -476,6 +510,7 @@ export interface InitOutput {
     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_replaceManyWithIds: (a: number, b: number, c: number, d: number, e: number, f: number, g: 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;
@@ -492,6 +527,7 @@ export interface InitOutput {
     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_dropIndex: (a: number, b: number, c: number) => [number, number];
@@ -501,6 +537,7 @@ export interface InitOutput {
     readonly collectionwasm_findOne: (a: number, b: 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_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];
@@ -514,9 +551,9 @@ export interface InitOutput {
     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 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;

package/pkg/taladb_web.js

@@ -106,6 +106,21 @@ export class CollectionWasm {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * Delete many documents by id, in one commit. Returns the number removed.
+     * @param {any} ids
+     * @param {string} origin
+     * @returns {number}
+     */
+    deleteManyWithIds(ids, origin) {
+        const ptr0 = passStringToWasm0(origin, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.collectionwasm_deleteManyWithIds(this.__wbg_ptr, ids, ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] >>> 0;
+    }
     /**
      * Delete the first matching document. Returns true if deleted.
      * @param {any} filter
@@ -237,6 +252,29 @@ export class CollectionWasm {
         }
         return takeFromExternrefTable0(ret[0]);
     }
+    /**
+     * Upsert many documents **by caller-supplied `_id`**, in one commit.
+     *
+     * Unlike [`Self::insert_many`] — which mints a fresh ULID and discards `_id` —
+     * this honours the id on each document, which is what lets replication address
+     * a remote row by a *derived* id so repeated fetches converge on one document
+     * instead of duplicating it.
+     *
+     * `origin` is `"remote"` for authoritative rows replicated in from an origin,
+     * or `"local"` for ordinary user writes.
+     * @param {any} docs
+     * @param {string} origin
+     * @returns {any}
+     */
+    replaceManyWithIds(docs, origin) {
+        const ptr0 = passStringToWasm0(origin, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.collectionwasm_replaceManyWithIds(this.__wbg_ptr, docs, ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * Update all matching documents. Returns the count updated.
      * @param {any} filter
@@ -640,6 +678,26 @@ export class WorkerDB {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * Delete many documents by id, in one commit. Returns the number removed.
+     * @param {string} collection
+     * @param {string} ids_json
+     * @param {string} origin
+     * @returns {number}
+     */
+    deleteManyWithIds(collection, ids_json, origin) {
+        const ptr0 = passStringToWasm0(collection, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(ids_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passStringToWasm0(origin, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len2 = WASM_VECTOR_LEN;
+        const ret = wasm.workerdb_deleteManyWithIds(this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] >>> 0;
+    }
     /**
      * Delete the first matching document. Returns `true` / `false`.
      * @param {string} collection
@@ -1157,6 +1215,46 @@ export class WorkerDB {
             wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
         }
     }
+    /**
+     * Upsert many documents **by caller-supplied `_id`**, in one commit.
+     *
+     * Unlike `insert_many` — which discards `_id` and mints a fresh ULID — this
+     * honours the id in each document. That is what lets the replication
+     * coordinator address a remote row by a *derived* id (see `deriveDocId`) and
+     * have repeated fetches converge on one document instead of duplicating it.
+     *
+     * `origin` is `"remote"` for authoritative rows replicated in from an origin,
+     * or `"local"` for ordinary user writes. Remote rows are marked so they can
+     * never replicate back out — see `Collection::replace_many_with_ids`.
+     * @param {string} collection
+     * @param {string} docs_json
+     * @param {string} origin
+     * @returns {string}
+     */
+    replaceManyWithIds(collection, docs_json, origin) {
+        let deferred5_0;
+        let deferred5_1;
+        try {
+            const ptr0 = passStringToWasm0(collection, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(docs_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len1 = WASM_VECTOR_LEN;
+            const ptr2 = passStringToWasm0(origin, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len2 = WASM_VECTOR_LEN;
+            const ret = wasm.workerdb_replaceManyWithIds(this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2);
+            var ptr4 = ret[0];
+            var len4 = ret[1];
+            if (ret[3]) {
+                ptr4 = 0; len4 = 0;
+                throw takeFromExternrefTable0(ret[2]);
+            }
+            deferred5_0 = ptr4;
+            deferred5_1 = len4;
+            return getStringFromWasm0(ptr4, len4);
+        } finally {
+            wasm.__wbindgen_free(deferred5_0, deferred5_1, 1);
+        }
+    }
     /**
      * Set write durability: `eventual = true` batches OPFS fsyncs for
      * throughput (call `flush()` to force), `false` (default) fsyncs each
@@ -1972,17 +2070,17 @@ function __wbg_get_imports() {
             return ret;
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 144, function: Function { arguments: [Externref], shim_idx: 145, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 141, function: Function { arguments: [Externref], shim_idx: 142, 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: 224, function: Function { arguments: [], shim_idx: 225, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // 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_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: 700, function: Function { arguments: [Externref], shim_idx: 701, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 698, function: Function { arguments: [Externref], shim_idx: 699, 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;
         },

package/pkg/taladb_web_bg.wasm.d.ts

@@ -11,6 +11,7 @@ export const workerdb_createFtsIndex: (a: number, b: number, c: number, d: numbe
 export const workerdb_createIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
 export const workerdb_createVectorIndex: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => [number, number];
 export const workerdb_deleteMany: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+export const workerdb_deleteManyWithIds: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number];
 export const workerdb_deleteOne: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
 export const workerdb_dropCompoundIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
 export const workerdb_dropFtsIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
@@ -34,6 +35,7 @@ export const workerdb_openWithConfigAndSnapshot: (a: number, b: number, c: numbe
 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_replaceManyWithIds: (a: number, b: number, c: number, d: number, e: number, f: number, g: 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;
@@ -50,6 +52,7 @@ export const collectionwasm_createCompoundIndex: (a: number, b: number, c: numbe
 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_dropIndex: (a: number, b: number, c: number) => [number, number];
@@ -59,6 +62,7 @@ export const collectionwasm_findNearest: (a: number, b: number, c: number, d: nu
 export const collectionwasm_findOne: (a: number, b: 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_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];
@@ -72,9 +76,9 @@ export const taladbwasm_openWithSnapshot: (a: number, b: number) => [number, num
 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 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;

package/worker/taladb.worker.js

@@ -432,6 +432,18 @@ async function dispatch(op, args) {
       return result;
     }
 
+    case 'replaceManyWithIds': {
+      const result = db.replaceManyWithIds(args.collection, args.docsJson, args.origin);
+      onWriteCommitted();
+      return result;
+    }
+
+    case 'deleteManyWithIds': {
+      const result = db.deleteManyWithIds(args.collection, args.idsJson, args.origin);
+      onWriteCommitted();
+      return result;
+    }
+
     case 'find':
       return db.find(args.collection, args.filterJson ?? 'null');