@taladb/web 0.11.2 → 0.11.4

package/README.md

@@ -10,7 +10,7 @@ Browser WASM bindings for TalaDB — persistent local-first storage via WASM + O
 ## What it provides
 
 - Rust core compiled to WebAssembly via `wasm-bindgen`
-- Persistent storage using [OPFS](https://developer.mozilla.org/en-US/docs/Web/API/File_System_API/Origin_private_file_system) (`FileSystemSyncAccessHandle`) — runs on a dedicated SharedWorker so the main thread is never blocked
+- Persistent storage using [OPFS](https://developer.mozilla.org/en-US/docs/Web/API/File_System_API/Origin_private_file_system) (`FileSystemSyncAccessHandle`) — runs on a DedicatedWorker so the main thread is never blocked
 - In-memory fallback for environments without OPFS support
 - Bundle size target: < 400 KB gzipped
 
@@ -58,7 +58,7 @@ export default defineConfig({
 
 ### Web Worker (OPFS)
 
-TalaDB spawns a SharedWorker internally to own the OPFS file handle. No extra configuration is required — the worker script is bundled inside this package at `@taladb/web/worker/taladb.worker.js`.
+TalaDB spawns a DedicatedWorker internally to own the OPFS file handle. No extra configuration is required — the worker script is bundled inside this package at `@taladb/web/worker/taladb.worker.js`.
 
 ## Direct usage (advanced)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taladb/web",
-  "version": "0.11.2",
+  "version": "0.11.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/README.md

@@ -10,7 +10,7 @@ Browser WASM bindings for TalaDB — persistent local-first storage via WASM + O
 ## What it provides
 
 - Rust core compiled to WebAssembly via `wasm-bindgen`
-- Persistent storage using [OPFS](https://developer.mozilla.org/en-US/docs/Web/API/File_System_API/Origin_private_file_system) (`FileSystemSyncAccessHandle`) — runs on a dedicated SharedWorker so the main thread is never blocked
+- Persistent storage using [OPFS](https://developer.mozilla.org/en-US/docs/Web/API/File_System_API/Origin_private_file_system) (`FileSystemSyncAccessHandle`) — runs on a DedicatedWorker so the main thread is never blocked
 - In-memory fallback for environments without OPFS support
 - Bundle size target: < 400 KB gzipped
 
@@ -58,7 +58,7 @@ export default defineConfig({
 
 ### Web Worker (OPFS)
 
-TalaDB spawns a SharedWorker internally to own the OPFS file handle. No extra configuration is required — the worker script is bundled inside this package at `@taladb/web/worker/taladb.worker.js`.
+TalaDB spawns a DedicatedWorker internally to own the OPFS file handle. No extra configuration is required — the worker script is bundled inside this package at `@taladb/web/worker/taladb.worker.js`.
 
 ## Direct usage (advanced)
 

package/pkg/package.json

@@ -5,7 +5,7 @@
     "taladb"
   ],
   "description": "TalaDB browser WASM bindings (wasm-bindgen + OPFS)",
-  "version": "0.11.2",
+  "version": "0.11.4",
   "license": "MIT OR Apache-2.0",
   "repository": {
     "type": "git",

package/pkg/taladb_web.d.ts

@@ -32,7 +32,7 @@ export class CollectionWasm {
      * `dimensions`           - expected vector length.
      * `metric`               - optional: `"cosine"` (default), `"dot"`, or `"euclidean"`.
      * `index_type`           - optional: `"flat"` (default) or `"hnsw"`.
-     * `hnsw_m`               - HNSW connectivity (default 16).
+     * `hnsw_m`               - HNSW connectivity (2–128, default 32).
      * `hnsw_ef_construction` - build quality (default 200).
      */
     createVectorIndex(field: string, dimensions: number, metric?: string | null, index_type?: string | null, hnsw_m?: number | null, hnsw_ef_construction?: number | null): void;
@@ -111,6 +111,10 @@ export class CollectionWasm {
      * Rebuild the HNSW graph from the current flat vector table.
      */
     upgradeVectorIndex(field: string): void;
+    /**
+     * Internal JSON protocol for advanced vector search and index lifecycle.
+     */
+    vectorCommand(request_json: string): string;
 }
 
 export class TalaDBWasm {
@@ -199,7 +203,7 @@ export class WorkerDB {
      *
      * - `metric_str`: `"cosine"` (default) | `"dot"` | `"euclidean"`
      * - `index_type`: `"flat"` (default) | `"hnsw"`
-     * - `hnsw_m`: HNSW connectivity (default 16, only used when `index_type = "hnsw"`)
+     * - `hnsw_m`: HNSW connectivity (2–128, default 32)
      * - `hnsw_ef_construction`: build-time quality (default 200, only used when `index_type = "hnsw"`)
      */
     createVectorIndex(collection: string, field: string, dimensions: number, metric_str?: string | null, index_type?: string | null, hnsw_m?: number | null, hnsw_ef_construction?: number | null): void;
@@ -232,7 +236,7 @@ export class WorkerDB {
      * Pass the returned bytes to `idbSaveSnapshot` to persist across page reloads.
      * On next open, pass the same bytes to `openWithSnapshot` to restore all data.
      */
-    exportSnapshot(): Uint8Array;
+    exportSnapshot(max_bytes?: number | null): Uint8Array;
     /**
      * Find documents. Returns a JSON array of document objects.
      */
@@ -303,7 +307,7 @@ export class WorkerDB {
     /**
      * Open a database backed by an OPFS `FileSystemSyncAccessHandle`.
      *
-     * Call sequence in the SharedWorker:
+     * Call sequence in the DedicatedWorker:
      * ```js
      * const handle = await file_handle.createSyncAccessHandle();
      * const workerDb = WorkerDB.openWithOpfs(handle);
@@ -355,7 +359,7 @@ export class WorkerDB {
      * Rebuild the HNSW graph for a vector index from the current flat vector
      * table.  Use after bulk inserts or when ANN recall has degraded.
      *
-     * No-op when the `vector-hnsw` feature is disabled or the index is flat-only.
+     * A flat index is promoted with default HNSW options.
      */
     upgradeVectorIndex(collection: string, field: string): void;
     /**
@@ -376,6 +380,10 @@ export class WorkerDB {
      * the `openDB({ migrations })` runner, which advances it per migration.
      */
     userVersion(): number;
+    /**
+     * Internal JSON protocol for advanced vector search and index lifecycle.
+     */
+    vectorCommand(collection: string, request_json: string): string;
     /**
      * This collection's write generation — a counter bumped once per committed
      * mutation.
@@ -465,6 +473,7 @@ export interface InitOutput {
     readonly collectionwasm_updateMany: (a: number, b: any, c: any) => [number, number, number];
     readonly collectionwasm_updateOne: (a: number, b: any, c: any) => [number, number, number];
     readonly collectionwasm_upgradeVectorIndex: (a: number, b: number, c: number) => [number, number];
+    readonly collectionwasm_vectorCommand: (a: number, b: number, c: number) => [number, 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;
@@ -493,7 +502,7 @@ export interface InitOutput {
     readonly workerdb_dropFtsIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
     readonly workerdb_dropIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
     readonly workerdb_dropVectorIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
-    readonly workerdb_exportSnapshot: (a: number) => [number, number, number, number];
+    readonly workerdb_exportSnapshot: (a: number, b: number) => [number, number, number, number];
     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];
@@ -516,6 +525,7 @@ export interface InitOutput {
     readonly workerdb_upgradeVectorIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
     readonly workerdb_upsertManyWithIds: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly workerdb_userVersion: (a: number) => [number, number, number];
+    readonly workerdb_vectorCommand: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly workerdb_writeGeneration: (a: number, b: number, c: number) => [number, number, number];
     readonly init: () => void;
     readonly wasm_bindgen_e9a25e3ce4b9afff___closure__destroy___dyn_core_f0fd674eaa06beef___ops__function__FnMut__wasm_bindgen_e9a25e3ce4b9afff___JsValue____Output_______: (a: number, b: number) => void;

package/pkg/taladb_web.js

@@ -85,7 +85,7 @@ export class CollectionWasm {
      * `dimensions`           - expected vector length.
      * `metric`               - optional: `"cosine"` (default), `"dot"`, or `"euclidean"`.
      * `index_type`           - optional: `"flat"` (default) or `"hnsw"`.
-     * `hnsw_m`               - HNSW connectivity (default 16).
+     * `hnsw_m`               - HNSW connectivity (2–128, default 32).
      * `hnsw_ef_construction` - build quality (default 200).
      * @param {string} field
      * @param {number} dimensions
@@ -351,6 +351,31 @@ export class CollectionWasm {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * Internal JSON protocol for advanced vector search and index lifecycle.
+     * @param {string} request_json
+     * @returns {string}
+     */
+    vectorCommand(request_json) {
+        let deferred3_0;
+        let deferred3_1;
+        try {
+            const ptr0 = passStringToWasm0(request_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len0 = WASM_VECTOR_LEN;
+            const ret = wasm.collectionwasm_vectorCommand(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);
+        }
+    }
 }
 if (Symbol.dispose) CollectionWasm.prototype[Symbol.dispose] = CollectionWasm.prototype.free;
 
@@ -606,7 +631,7 @@ export class WorkerDB {
      *
      * - `metric_str`: `"cosine"` (default) | `"dot"` | `"euclidean"`
      * - `index_type`: `"flat"` (default) | `"hnsw"`
-     * - `hnsw_m`: HNSW connectivity (default 16, only used when `index_type = "hnsw"`)
+     * - `hnsw_m`: HNSW connectivity (2–128, default 32)
      * - `hnsw_ef_construction`: build-time quality (default 200, only used when `index_type = "hnsw"`)
      * @param {string} collection
      * @param {string} field
@@ -745,10 +770,11 @@ export class WorkerDB {
      *
      * Pass the returned bytes to `idbSaveSnapshot` to persist across page reloads.
      * On next open, pass the same bytes to `openWithSnapshot` to restore all data.
+     * @param {number | null} [max_bytes]
      * @returns {Uint8Array}
      */
-    exportSnapshot() {
-        const ret = wasm.workerdb_exportSnapshot(this.__wbg_ptr);
+    exportSnapshot(max_bytes) {
+        const ret = wasm.workerdb_exportSnapshot(this.__wbg_ptr, isLikeNone(max_bytes) ? 0x100000001 : (max_bytes) >>> 0);
         if (ret[3]) {
             throw takeFromExternrefTable0(ret[2]);
         }
@@ -1074,7 +1100,7 @@ export class WorkerDB {
     /**
      * Open a database backed by an OPFS `FileSystemSyncAccessHandle`.
      *
-     * Call sequence in the SharedWorker:
+     * Call sequence in the DedicatedWorker:
      * ```js
      * const handle = await file_handle.createSyncAccessHandle();
      * const workerDb = WorkerDB.openWithOpfs(handle);
@@ -1219,7 +1245,7 @@ export class WorkerDB {
      * Rebuild the HNSW graph for a vector index from the current flat vector
      * table.  Use after bulk inserts or when ANN recall has degraded.
      *
-     * No-op when the `vector-hnsw` feature is disabled or the index is flat-only.
+     * A flat index is promoted with default HNSW options.
      * @param {string} collection
      * @param {string} field
      */
@@ -1282,6 +1308,34 @@ export class WorkerDB {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * Internal JSON protocol for advanced vector search and index lifecycle.
+     * @param {string} collection
+     * @param {string} request_json
+     * @returns {string}
+     */
+    vectorCommand(collection, request_json) {
+        let deferred4_0;
+        let deferred4_1;
+        try {
+            const ptr0 = passStringToWasm0(collection, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(request_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len1 = WASM_VECTOR_LEN;
+            const ret = wasm.workerdb_vectorCommand(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);
+        }
+    }
     /**
      * This collection's write generation — a counter bumped once per committed
      * mutation.
@@ -1562,6 +1616,9 @@ function __wbg_get_imports() {
             const ret = arg0.getFile();
             return ret;
         },
+        __wbg_getRandomValues_3f44b700395062e5: function() { return handleError(function (arg0, arg1) {
+            globalThis.crypto.getRandomValues(getArrayU8FromWasm0(arg0, arg1));
+        }, arguments); },
         __wbg_getRandomValues_76dfc69825c9c552: function() { return handleError(function (arg0, arg1) {
             globalThis.crypto.getRandomValues(getArrayU8FromWasm0(arg0, arg1));
         }, arguments); },
@@ -1785,6 +1842,14 @@ function __wbg_get_imports() {
             const ret = Date.now();
             return ret;
         },
+        __wbg_now_e7c6795a7f81e10f: function(arg0) {
+            const ret = arg0.now();
+            return ret;
+        },
+        __wbg_performance_3fcf6e32a7e1ed0a: function(arg0) {
+            const ret = arg0.performance;
+            return ret;
+        },
         __wbg_prototypesetcall_d62e5099504357e6: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
         },
@@ -1880,7 +1945,7 @@ function __wbg_get_imports() {
             return ret;
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 561, function: Function { arguments: [Externref], shim_idx: 562, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 623, function: Function { arguments: [Externref], shim_idx: 624, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen_e9a25e3ce4b9afff___closure__destroy___dyn_core_f0fd674eaa06beef___ops__function__FnMut__wasm_bindgen_e9a25e3ce4b9afff___JsValue____Output___core_f0fd674eaa06beef___result__Result_____wasm_bindgen_e9a25e3ce4b9afff___JsError___, wasm_bindgen_e9a25e3ce4b9afff___convert__closures_____invoke___wasm_bindgen_e9a25e3ce4b9afff___JsValue__core_f0fd674eaa06beef___result__Result_____wasm_bindgen_e9a25e3ce4b9afff___JsError___true_);
             return ret;
         },

package/pkg/taladb_web_bg.wasm.d.ts

@@ -26,6 +26,7 @@ export const collectionwasm_searchText: (a: number, b: number, c: number, d: num
 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 collectionwasm_vectorCommand: (a: number, b: number, c: number) => [number, 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;
@@ -54,7 +55,7 @@ export const workerdb_dropCompoundIndex: (a: number, b: number, c: number, d: nu
 export const workerdb_dropFtsIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
 export const workerdb_dropIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
 export const workerdb_dropVectorIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
-export const workerdb_exportSnapshot: (a: number) => [number, number, number, number];
+export const workerdb_exportSnapshot: (a: number, b: number) => [number, number, number, number];
 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];
@@ -77,6 +78,7 @@ export const workerdb_updateOne: (a: number, b: number, c: number, d: number, e:
 export const workerdb_upgradeVectorIndex: (a: number, b: number, c: number, d: number, e: number) => [number, number];
 export const workerdb_upsertManyWithIds: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
 export const workerdb_userVersion: (a: number) => [number, number, number];
+export const workerdb_vectorCommand: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
 export const workerdb_writeGeneration: (a: number, b: number, c: number) => [number, number, number];
 export const init: () => void;
 export const wasm_bindgen_e9a25e3ce4b9afff___closure__destroy___dyn_core_f0fd674eaa06beef___ops__function__FnMut__wasm_bindgen_e9a25e3ce4b9afff___JsValue____Output_______: (a: number, b: number) => void;