@wiscale/velesdb-wasm 1.0.1 → 1.1.0

package/README.md

@@ -99,6 +99,15 @@ class VectorStore {
   clear(): void;
   reserve(additional: number): void;  // Pre-allocate memory
   memory_usage(): number;  // Accurate for each storage mode
+  
+  // ⭐ NEW v1.1.0
+  multi_query_search(vectors: Float32Array, num_vectors: number, k: number, strategy?: string, rrf_k?: number): Array<[bigint, number]>;
+  hybrid_search(vector: Float32Array, text_query: string, k: number, vector_weight?: number, field?: string): Array<{id, score, payload}>;
+  batch_search(vectors: Float32Array, num_vectors: number, k: number): Array<Array<[bigint, number]>>;
+  
+  // Metadata-only store
+  static new_metadata_only(): VectorStore;
+  readonly is_metadata_only: boolean;
 }
 ```
 

package/package.json

@@ -5,7 +5,7 @@
     "Julien Lange <contact@wiscale.fr>"
   ],
   "description": "VelesDB for WebAssembly - Vector search in the browser",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "license": "SEE LICENSE IN ../../LICENSE",
   "repository": {
     "type": "git",

package/velesdb_wasm.d.ts

@@ -39,6 +39,20 @@ export class VectorStore {
    * Array of results with matching payloads.
    */
   text_search(query: string, k: number, field?: string | null): any;
+  /**
+   * Batch search for multiple vectors in parallel.
+   *
+   * # Arguments
+   *
+   * * `vectors` - Flat array of query vectors (concatenated)
+   * * `num_vectors` - Number of vectors
+   * * `k` - Results per query
+   *
+   * # Returns
+   *
+   * Array of arrays of (id, score) tuples.
+   */
+  batch_search(vectors: Float32Array, num_vectors: number, k: number): any;
   /**
    * Inserts multiple vectors in a single batch operation.
    *
@@ -58,6 +72,23 @@ export class VectorStore {
    * Returns memory usage estimate in bytes.
    */
   memory_usage(): number;
+  /**
+   * Performs hybrid search combining vector similarity and text search.
+   *
+   * Uses a simple weighted fusion of vector search and text search results.
+   *
+   * # Arguments
+   *
+   * * `query_vector` - Query vector for similarity search
+   * * `text_query` - Text query for payload search
+   * * `k` - Number of results to return
+   * * `vector_weight` - Weight for vector results (0.0-1.0, default 0.5)
+   *
+   * # Returns
+   *
+   * Array of fused results with id, score, and payload.
+   */
+  hybrid_search(query_vector: Float32Array, text_query: string, k: number, vector_weight?: number | null): any;
   /**
    * Creates a new vector store with specified storage mode for memory optimization.
    *
@@ -143,6 +174,31 @@ export class VectorStore {
    * - The metric byte is invalid
    */
   static import_from_bytes(bytes: Uint8Array): VectorStore;
+  /**
+   * Creates a metadata-only store (no vectors, only payloads).
+   *
+   * Useful for storing auxiliary data without vector embeddings.
+   */
+  static new_metadata_only(): VectorStore;
+  /**
+   * Performs multi-query search with result fusion.
+   *
+   * Executes searches for multiple query vectors and fuses results
+   * using the specified strategy.
+   *
+   * # Arguments
+   *
+   * * `vectors` - Array of query vectors (as flat array with dimension stride)
+   * * `num_vectors` - Number of vectors in the array
+   * * `k` - Number of results to return
+   * * `strategy` - Fusion strategy: "average", "maximum", "rrf"
+   * * `rrf_k` - RRF k parameter (only used when strategy = "rrf", default 60)
+   *
+   * # Returns
+   *
+   * Array of fused results with id and score.
+   */
+  multi_query_search(vectors: Float32Array, num_vectors: number, k: number, strategy: string, rrf_k?: number | null): any;
   /**
    * Searches with metadata filtering.
    *
@@ -292,6 +348,10 @@ export class VectorStore {
    * Returns the storage mode.
    */
   readonly storage_mode: string;
+  /**
+   * Returns true if this is a metadata-only store.
+   */
+  readonly is_metadata_only: boolean;
   /**
    * Returns the number of vectors in the store.
    */
@@ -311,20 +371,25 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 export interface InitOutput {
   readonly memory: WebAssembly.Memory;
   readonly __wbg_vectorstore_free: (a: number, b: number) => void;
+  readonly vectorstore_batch_search: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
   readonly vectorstore_clear: (a: number) => void;
   readonly vectorstore_delete_database: (a: number, b: number) => number;
   readonly vectorstore_dimension: (a: number) => number;
   readonly vectorstore_export_to_bytes: (a: number, b: number) => void;
   readonly vectorstore_get: (a: number, b: number, c: bigint) => void;
+  readonly vectorstore_hybrid_search: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
   readonly vectorstore_import_from_bytes: (a: number, b: number, c: number) => void;
   readonly vectorstore_insert: (a: number, b: number, c: bigint, d: number, e: number) => void;
   readonly vectorstore_insert_batch: (a: number, b: number, c: number) => void;
   readonly vectorstore_insert_with_payload: (a: number, b: number, c: bigint, d: number, e: number, f: number) => void;
   readonly vectorstore_is_empty: (a: number) => number;
+  readonly vectorstore_is_metadata_only: (a: number) => number;
   readonly vectorstore_len: (a: number) => number;
   readonly vectorstore_load: (a: number, b: number) => number;
   readonly vectorstore_memory_usage: (a: number) => number;
+  readonly vectorstore_multi_query_search: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
   readonly vectorstore_new: (a: number, b: number, c: number, d: number) => void;
+  readonly vectorstore_new_metadata_only: () => number;
   readonly vectorstore_new_with_mode: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
   readonly vectorstore_remove: (a: number, b: bigint) => number;
   readonly vectorstore_reserve: (a: number, b: number) => void;
@@ -334,11 +399,11 @@ export interface InitOutput {
   readonly vectorstore_storage_mode: (a: number, b: number) => void;
   readonly vectorstore_text_search: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
   readonly vectorstore_with_capacity: (a: number, b: number, c: number, d: number, e: number) => void;
-  readonly __wasm_bindgen_func_elem_133: (a: number, b: number, c: number) => void;
-  readonly __wasm_bindgen_func_elem_132: (a: number, b: number) => void;
-  readonly __wasm_bindgen_func_elem_489: (a: number, b: number, c: number) => void;
-  readonly __wasm_bindgen_func_elem_488: (a: number, b: number) => void;
-  readonly __wasm_bindgen_func_elem_536: (a: number, b: number, c: number, d: number) => void;
+  readonly __wasm_bindgen_func_elem_528: (a: number, b: number, c: number) => void;
+  readonly __wasm_bindgen_func_elem_527: (a: number, b: number) => void;
+  readonly __wasm_bindgen_func_elem_148: (a: number, b: number, c: number) => void;
+  readonly __wasm_bindgen_func_elem_147: (a: number, b: number) => void;
+  readonly __wasm_bindgen_func_elem_577: (a: number, b: number, c: number, d: number) => void;
   readonly __wbindgen_export: (a: number, b: number) => number;
   readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
   readonly __wbindgen_export3: (a: number) => void;

package/velesdb_wasm.js

@@ -251,16 +251,16 @@ if (!('encodeInto' in cachedTextEncoder)) {
 
 let WASM_VECTOR_LEN = 0;
 
-function __wasm_bindgen_func_elem_133(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_133(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_528(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_528(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_489(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_489(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_148(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_148(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_536(arg0, arg1, arg2, arg3) {
-    wasm.__wasm_bindgen_func_elem_536(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_577(arg0, arg1, arg2, arg3) {
+    wasm.__wasm_bindgen_func_elem_577(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }
 
 const __wbindgen_enum_IdbTransactionMode = ["readonly", "readwrite", "versionchange", "readwriteflush", "cleanup"];
@@ -360,6 +360,40 @@ export class VectorStore {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Batch search for multiple vectors in parallel.
+     *
+     * # Arguments
+     *
+     * * `vectors` - Flat array of query vectors (concatenated)
+     * * `num_vectors` - Number of vectors
+     * * `k` - Results per query
+     *
+     * # Returns
+     *
+     * Array of arrays of (id, score) tuples.
+     * @param {Float32Array} vectors
+     * @param {number} num_vectors
+     * @param {number} k
+     * @returns {any}
+     */
+    batch_search(vectors, num_vectors, k) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArrayF32ToWasm0(vectors, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.vectorstore_batch_search(retptr, this.__wbg_ptr, ptr0, len0, num_vectors, k);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Inserts multiple vectors in a single batch operation.
      *
@@ -416,6 +450,46 @@ export class VectorStore {
             wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Performs hybrid search combining vector similarity and text search.
+     *
+     * Uses a simple weighted fusion of vector search and text search results.
+     *
+     * # Arguments
+     *
+     * * `query_vector` - Query vector for similarity search
+     * * `text_query` - Text query for payload search
+     * * `k` - Number of results to return
+     * * `vector_weight` - Weight for vector results (0.0-1.0, default 0.5)
+     *
+     * # Returns
+     *
+     * Array of fused results with id, score, and payload.
+     * @param {Float32Array} query_vector
+     * @param {string} text_query
+     * @param {number} k
+     * @param {number | null} [vector_weight]
+     * @returns {any}
+     */
+    hybrid_search(query_vector, text_query, k, vector_weight) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArrayF32ToWasm0(query_vector, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(text_query, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.vectorstore_hybrid_search(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1, k, isLikeNone(vector_weight) ? 0x100000001 : Math.fround(vector_weight));
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Creates a new vector store with specified storage mode for memory optimization.
      *
@@ -554,6 +628,14 @@ export class VectorStore {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Returns true if this is a metadata-only store.
+     * @returns {boolean}
+     */
+    get is_metadata_only() {
+        const ret = wasm.vectorstore_is_metadata_only(this.__wbg_ptr);
+        return ret !== 0;
+    }
     /**
      * Imports a vector store from binary format.
      *
@@ -586,6 +668,59 @@ export class VectorStore {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Creates a metadata-only store (no vectors, only payloads).
+     *
+     * Useful for storing auxiliary data without vector embeddings.
+     * @returns {VectorStore}
+     */
+    static new_metadata_only() {
+        const ret = wasm.vectorstore_new_metadata_only();
+        return VectorStore.__wrap(ret);
+    }
+    /**
+     * Performs multi-query search with result fusion.
+     *
+     * Executes searches for multiple query vectors and fuses results
+     * using the specified strategy.
+     *
+     * # Arguments
+     *
+     * * `vectors` - Array of query vectors (as flat array with dimension stride)
+     * * `num_vectors` - Number of vectors in the array
+     * * `k` - Number of results to return
+     * * `strategy` - Fusion strategy: "average", "maximum", "rrf"
+     * * `rrf_k` - RRF k parameter (only used when strategy = "rrf", default 60)
+     *
+     * # Returns
+     *
+     * Array of fused results with id and score.
+     * @param {Float32Array} vectors
+     * @param {number} num_vectors
+     * @param {number} k
+     * @param {string} strategy
+     * @param {number | null} [rrf_k]
+     * @returns {any}
+     */
+    multi_query_search(vectors, num_vectors, k, strategy, rrf_k) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArrayF32ToWasm0(vectors, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(strategy, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.vectorstore_multi_query_search(retptr, this.__wbg_ptr, ptr0, len0, num_vectors, k, ptr1, len1, isLikeNone(rrf_k) ? 0x100000001 : (rrf_k) >>> 0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Searches with metadata filtering.
      *
@@ -1149,7 +1284,7 @@ function __wbg_get_imports() {
                 const a = state0.a;
                 state0.a = 0;
                 try {
-                    return __wasm_bindgen_func_elem_536(a, state0.b, arg0, arg1);
+                    return __wasm_bindgen_func_elem_577(a, state0.b, arg0, arg1);
                 } finally {
                     state0.a = a;
                 }
@@ -1270,9 +1405,9 @@ function __wbg_get_imports() {
         const ret = getStringFromWasm0(arg0, arg1);
         return addHeapObject(ret);
     };
-    imports.wbg.__wbindgen_cast_245e75e6849de722 = function(arg0, arg1) {
-        // Cast intrinsic for `Closure(Closure { dtor_idx: 7, function: Function { arguments: [NamedExternref("Event")], shim_idx: 8, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-        const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_132, __wasm_bindgen_func_elem_133);
+    imports.wbg.__wbindgen_cast_257c51b8abf9285e = function(arg0, arg1) {
+        // Cast intrinsic for `Closure(Closure { dtor_idx: 57, function: Function { arguments: [Externref], shim_idx: 58, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+        const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_527, __wasm_bindgen_func_elem_528);
         return addHeapObject(ret);
     };
     imports.wbg.__wbindgen_cast_4625c577ab2ec9ee = function(arg0) {
@@ -1280,6 +1415,11 @@ function __wbg_get_imports() {
         const ret = BigInt.asUintN(64, arg0);
         return addHeapObject(ret);
     };
+    imports.wbg.__wbindgen_cast_59e89726c7c5a9af = function(arg0, arg1) {
+        // Cast intrinsic for `Closure(Closure { dtor_idx: 8, function: Function { arguments: [NamedExternref("Event")], shim_idx: 9, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+        const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_147, __wasm_bindgen_func_elem_148);
+        return addHeapObject(ret);
+    };
     imports.wbg.__wbindgen_cast_9ae0607507abb057 = function(arg0) {
         // Cast intrinsic for `I64 -> Externref`.
         const ret = arg0;
@@ -1290,11 +1430,6 @@ function __wbg_get_imports() {
         const ret = arg0;
         return addHeapObject(ret);
     };
-    imports.wbg.__wbindgen_cast_e7ad0d7b317830d5 = function(arg0, arg1) {
-        // Cast intrinsic for `Closure(Closure { dtor_idx: 56, function: Function { arguments: [Externref], shim_idx: 57, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-        const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_488, __wasm_bindgen_func_elem_489);
-        return addHeapObject(ret);
-    };
     imports.wbg.__wbindgen_object_clone_ref = function(arg0) {
         const ret = getObject(arg0);
         return addHeapObject(ret);