@taladb/web 0.11.3 → 0.11.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taladb/web",
-  "version": "0.11.3",
+  "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/package.json

@@ -5,7 +5,7 @@
     "taladb"
   ],
   "description": "TalaDB browser WASM bindings (wasm-bindgen + OPFS)",
-  "version": "0.11.3",
+  "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 (only 32 is supported).
+     * `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 (only 32 is supported)
+     * - `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;
@@ -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;
@@ -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 (only 32 is supported).
+     * `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 (only 32 is supported)
+     * - `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
@@ -1220,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
      */
@@ -1283,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.
@@ -1563,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); },
@@ -1786,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);
         },
@@ -1881,7 +1945,7 @@ function __wbg_get_imports() {
             return ret;
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 569, function: Function { arguments: [Externref], shim_idx: 570, 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;
@@ -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;

package/worker/taladb.worker.js

@@ -165,12 +165,12 @@ async function executeOwned(op, args) {
   if (op === 'hello') return { epoch, encrypted, config: activeConfigJson };
   if (op === 'capabilities') return { storage: backend, durableWrites: immediate,
     maxSnapshotBytes: backend === 'indexeddb' ? MAX_SNAPSHOT_BYTES : null, storageError,
-    hnsw: false, owner: true };
+    hnsw: true, owner: true };
   if (op === 'flush') { db.flush(); await flushSnapshot(); return null; }
   if (storageError && immediate) throw new Error(`TalaDB persistence failed; reopen the database: ${storageError}`);
   if (JSON.stringify(args).length > MAX_REQUEST_BYTES) throw new Error('TalaDB request exceeds 32 MiB; split the batch');
   const result = executeOp(op, args);
-  if (mutations.has(op)) {
+  if (mutations.has(op) || (op === 'vectorCommand' && ['create', 'beginBuild', 'stepBuild', 'cancelBuild'].includes(JSON.parse(args.requestJson).op))) {
     if (backend === 'indexeddb') {
       dirty = true;
       if (immediate) await flushSnapshot(); else scheduleFlush();
@@ -375,6 +375,9 @@ function executeOp(op, args) {
       db.upgradeVectorIndex(args.collection, args.field);
       return null;
 
+    case 'vectorCommand':
+      return db.vectorCommand(args.collection, args.requestJson);
+
     case 'findNearest':
       return db.findNearest(
         args.collection,