hermes-wasm 1.8.127 → 1.8.129

package/README.md

@@ -326,3 +326,36 @@ Browser JS
     └── IndexRegistry (multi-index management)
             └── Map<name, RemoteIndex>
 ```
+
+## Structured search diagnostics
+
+`searchStructured` accepts `includeRrfScores` for fusion queries and `tracing`
+for any supported structured query. Both default to false:
+
+```js
+const response = await index.searchStructured({
+  query: {
+    fusion: {
+      queries: [
+        { name: "title", query: { match: { field: "title", text: "rust" } } },
+        { name: "body", query: { match: { field: "body", text: "rust" } } },
+      ],
+    },
+  },
+  limit: 10,
+  includeRrfScores: true,
+  tracing: true,
+});
+console.log(response.hits[0].rrf_score, response.hits[0].rrf_contributions);
+console.log(response.trace.shards[0].queries);
+```
+
+Responses use snake_case, matching other WASM search results. RRF attribution
+uses complete bounded branch lists before pagination and leaves `score`
+unchanged. The local trace includes each branch's query tree, raw candidate
+scores/ordinals and selected addresses, without hydrating discarded documents.
+It contains one local shard with empty broker/backend IDs. The trace observes
+the configured retrieval depth and does not run Boolean clauses independently.
+The diagnostic window is capped at 10,000; candidate/ordinal bounds and a 64 MiB
+JSON response limit reject oversized exports. WASM supports its existing RRF and
+weighted-sum fusion modes; server L1/reranker features remain server APIs.

package/hermes_wasm.d.ts

@@ -67,6 +67,10 @@ export class IpfsIndex {
      * Import cache
      */
     import_cache(data: Uint8Array): void;
+    /**
+     * Load cache from IndexedDB
+     */
+    load_cache_from_idb(): Promise<boolean>;
     /**
      * Load index using JavaScript fetch functions
      *
@@ -74,10 +78,6 @@ export class IpfsIndex {
      * @param size_fn - JS function: (path: string) => Promise<number>
      */
     load(fetch_fn: Function, size_fn: Function): Promise<void>;
-    /**
-     * Load cache from IndexedDB
-     */
-    load_cache_from_idb(): Promise<boolean>;
     /**
      * Load index with IndexedDB cache pre-loaded
      *
@@ -284,6 +284,12 @@ export class RemoteIndex {
      * network requests for previously fetched data.
      */
     import_cache(data: Uint8Array): void;
+    /**
+     * Load the slice cache from IndexedDB
+     *
+     * Call this after load() to restore cached data from a previous session.
+     */
+    load_cache_from_idb(): Promise<boolean>;
     /**
      * Load index from URL using hermes-core Index with slice caching
      *
@@ -291,12 +297,6 @@ export class RemoteIndex {
      * to prefill the cache with hot data, reducing cold-start latency.
      */
     load(): Promise<void>;
-    /**
-     * Load the slice cache from IndexedDB
-     *
-     * Call this after load() to restore cached data from a previous session.
-     */
-    load_cache_from_idb(): Promise<boolean>;
     /**
      * Load index with IndexedDB cache pre-loaded
      *

package/hermes_wasm.js

@@ -176,6 +176,14 @@ export class IpfsIndex {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * Load cache from IndexedDB
+     * @returns {Promise<boolean>}
+     */
+    load_cache_from_idb() {
+        const ret = wasm.ipfsindex_load_cache_from_idb(this.__wbg_ptr);
+        return ret;
+    }
     /**
      * Load index using JavaScript fetch functions
      *
@@ -189,14 +197,6 @@ export class IpfsIndex {
         const ret = wasm.ipfsindex_load(this.__wbg_ptr, fetch_fn, size_fn);
         return ret;
     }
-    /**
-     * Load cache from IndexedDB
-     * @returns {Promise<boolean>}
-     */
-    load_cache_from_idb() {
-        const ret = wasm.ipfsindex_load_cache_from_idb(this.__wbg_ptr);
-        return ret;
-    }
     /**
      * Load index with IndexedDB cache pre-loaded
      *
@@ -628,6 +628,16 @@ export class RemoteIndex {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * Load the slice cache from IndexedDB
+     *
+     * Call this after load() to restore cached data from a previous session.
+     * @returns {Promise<boolean>}
+     */
+    load_cache_from_idb() {
+        const ret = wasm.remoteindex_load_cache_from_idb(this.__wbg_ptr);
+        return ret;
+    }
     /**
      * Load index from URL using hermes-core Index with slice caching
      *
@@ -639,16 +649,6 @@ export class RemoteIndex {
         const ret = wasm.remoteindex_load(this.__wbg_ptr);
         return ret;
     }
-    /**
-     * Load the slice cache from IndexedDB
-     *
-     * Call this after load() to restore cached data from a previous session.
-     * @returns {Promise<boolean>}
-     */
-    load_cache_from_idb() {
-        const ret = wasm.remoteindex_load_cache_from_idb(this.__wbg_ptr);
-        return ret;
-    }
     /**
      * Load index with IndexedDB cache pre-loaded
      *
@@ -1344,22 +1344,22 @@ function __wbg_get_imports() {
             console.warn(arg0);
         },
         __wbindgen_generic_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 1916, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 1958, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen_7dc0dc7663c6ddce___convert__closures_____invoke___wasm_bindgen_7dc0dc7663c6ddce___JsValue__core_ed718c3d60ebd546___result__Result_____wasm_bindgen_7dc0dc7663c6ddce___JsError___true_);
             return ret;
         },
         __wbindgen_generic_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("Event")], shim_idx: 378, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("Event")], shim_idx: 501, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen_7dc0dc7663c6ddce___convert__closures_____invoke___web_sys_456b715baf4530bf___features__gen_IdbVersionChangeEvent__IdbVersionChangeEvent______true_);
             return ret;
         },
         __wbindgen_generic_0000000000000003: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("IDBVersionChangeEvent")], shim_idx: 378, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("IDBVersionChangeEvent")], shim_idx: 501, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen_7dc0dc7663c6ddce___convert__closures_____invoke___web_sys_456b715baf4530bf___features__gen_IdbVersionChangeEvent__IdbVersionChangeEvent______true__66);
             return ret;
         },
         __wbindgen_generic_0000000000000004: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 1048, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 1090, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen_7dc0dc7663c6ddce___convert__closures_____invoke_______true_);
             return ret;
         },

package/package.json

@@ -5,7 +5,7 @@
     "izihawa"
   ],
   "description": "WASM bindings for Hermes search engine",
-  "version": "1.8.127",
+  "version": "1.8.129",
   "license": "MIT",
   "repository": {
     "type": "git",