@wiscale/velesdb-wasm 3.2.1 → 3.3.0

package/README.md

@@ -281,7 +281,11 @@ The WASM build is optimized for client-side use cases but has some limitations c
 | Knowledge Graph (nodes, edges, traversal) | ✅ | ✅ |
 | Agent Memory (SemanticMemory) | ✅ | ✅ |
 | VelesQL parsing and validation | ✅ | ✅ |
-| VelesQL query execution | ✅ | ✅ |
+| VelesQL query execution | ✅ (see carve-outs below) | ✅ |
+| Column projection / aliases / window functions | ✅ | ✅ |
+| Aggregate `ORDER BY` (over a GROUP BY) | ✅ | ✅ |
+| Machine-readable error codes (`VELES-*`) | ✅ | ✅ |
+| `EXPLAIN` (core plan vocabulary) | ✅ | ✅ |
 | JOIN operations | ✅ (INNER, LEFT) | ✅ |
 | Aggregations (GROUP BY / HAVING) | ✅ | ✅ |
 | Set operations (UNION / INTERSECT / EXCEPT) | ✅ | ✅ |
@@ -295,14 +299,40 @@ The WASM build is optimized for client-side use cases but has some limitations c
 VelesQL parsing, validation, **and execution** are all available in WASM. You can
 parse queries and inspect their AST client-side, and you can run queries against
 a `WasmDatabase` via `executeQuery()`. The single-collection executor supports
-`SELECT` (with `WHERE`, `NEAR`, `similarity()`), `GROUP BY`/`HAVING`,
-aggregations, `ORDER BY`, `UNION`/`INTERSECT`/`EXCEPT`, `INNER`/`LEFT JOIN`,
+`SELECT` (with `WHERE`, `NEAR`, `similarity()`), **column projection / aliases /
+window functions** (`ROW_NUMBER`/`RANK`/`DENSE_RANK`), `GROUP BY`/`HAVING`,
+aggregations, `ORDER BY` (payload columns, `similarity()`, arithmetic
+expressions, and aggregate ORDER BY over a GROUP BY), a default `LIMIT 10`,
+`UNION`/`INTERSECT`/`EXCEPT`, `INNER`/`LEFT JOIN`,
 `INSERT`/`UPSERT`/`UPDATE`/`DELETE`, DDL, and 1–2 hop `MATCH` graph traversal.
-
-The only VelesQL features that still require the REST server are
-**cross-collection `MATCH` (`@collection`)** — which needs Database-level query
-routing — and `MATCH` traversals beyond 2 hops. `RIGHT`/`FULL JOIN` and
-`TRAIN QUANTIZER` are rejected with a descriptive error.
+`EXPLAIN` uses the same plan vocabulary as the REST server (core
+`QueryPlan::to_plan_steps()`), and execution errors carry machine-readable
+`VELES-*` codes.
+
+#### Features that require the REST server (rejected with a descriptive error)
+
+These are **loud rejections**, not silent no-ops — WASM never returns a
+wrong-but-quiet result for an unsupported shape:
+
+- **Cross-collection `MATCH` (`@collection`)** — needs Database-level routing.
+- **`MATCH` traversals beyond 2 hops.**
+- **`RIGHT` / `FULL JOIN`** and **`TRAIN QUANTIZER`.**
+- **`LET` score bindings** — `LET x = ... SELECT ...` is rejected (`LET bindings
+  are not supported in WASM`).
+- **Scalar subqueries** — `WHERE x = (SELECT ...)` is rejected (`Subqueries are
+  not supported in WASM`).
+- **`USING FUSION(strategy='weighted'|'rsf')` on a single-vector `NEAR`** — WASM
+  has no BM25/graph branch to fuse against, so these weight-sensitive strategies
+  are rejected (use `rrf`/`maximum`/`average`, or a metadata filter without
+  `FUSION`). On a multi-vector `NEAR_FUSED` query the strategy is **not**
+  rejected, but only `rrf` / `average` / `maximum` are honored — `weighted` /
+  `rsf` silently fall back to RRF (matching core's `fused_config_to_strategy`).
+- **`ORDER BY similarity(field, $v)`** (a named/secondary vector) — WASM stores
+  only the primary vector, so the named-vector form is rejected on both the
+  `SELECT` and `MATCH` paths. Use `ORDER BY similarity()` (the search score) or a
+  payload column. The `MATCH` path performs no vector scoring, so it additionally
+  rejects bare `similarity()` and arithmetic `ORDER BY` (order by `depth` or
+  `alias.property` instead).
 
 ```javascript
 import { VelesQL } from '@wiscale/velesdb-wasm';

package/package.json

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

package/velesdb_wasm.d.ts

@@ -1390,9 +1390,9 @@ export interface InitOutput {
     readonly graphnode_id: (a: number) => bigint;
     readonly vectorstore_dimension: (a: number) => number;
     readonly wasmdatabase_collection_count: (a: number) => number;
-    readonly __wasm_bindgen_func_elem_1266: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_1282: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_412: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_1308: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_1324: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_438: (a: number, b: number, c: 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

@@ -3148,6 +3148,10 @@ function __wbg_get_imports() {
             const ret = getObject(arg0).createObjectStore(getStringFromWasm0(arg1, arg2));
             return addHeapObject(ret);
         }, arguments); },
+        __wbg_defineProperty_83586bc35b9ff065: function(arg0, arg1, arg2) {
+            const ret = Object.defineProperty(getObject(arg0), getObject(arg1), getObject(arg2));
+            return addHeapObject(ret);
+        },
         __wbg_deleteDatabase_4335c8782ceae0d9: function() { return handleError(function (arg0, arg1, arg2) {
             const ret = getObject(arg0).deleteDatabase(getStringFromWasm0(arg1, arg2));
             return addHeapObject(ret);
@@ -3290,6 +3294,10 @@ function __wbg_get_imports() {
             const ret = new Map();
             return addHeapObject(ret);
         },
+        __wbg_new_1f236d63ba0c4784: function(arg0, arg1) {
+            const ret = new Error(getStringFromWasm0(arg0, arg1));
+            return addHeapObject(ret);
+        },
         __wbg_new_310879b66b6e95e1: function() {
             const ret = new Array();
             return addHeapObject(ret);
@@ -3305,7 +3313,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return __wasm_bindgen_func_elem_1282(a, state0.b, arg0, arg1);
+                        return __wasm_bindgen_func_elem_1324(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -3327,7 +3335,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return __wasm_bindgen_func_elem_1282(a, state0.b, arg0, arg1);
+                        return __wasm_bindgen_func_elem_1324(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -3398,6 +3406,10 @@ function __wbg_get_imports() {
         __wbg_set_78ea6a19f4818587: function(arg0, arg1, arg2) {
             getObject(arg0)[arg1 >>> 0] = takeObject(arg2);
         },
+        __wbg_set_a0e911be3da02782: function() { return handleError(function (arg0, arg1, arg2) {
+            const ret = Reflect.set(getObject(arg0), getObject(arg1), getObject(arg2));
+            return ret;
+        }, arguments); },
         __wbg_set_facb7a5914e0fa39: function(arg0, arg1, arg2) {
             const ret = getObject(arg0).set(getObject(arg1), getObject(arg2));
             return addHeapObject(ret);
@@ -3463,13 +3475,13 @@ function __wbg_get_imports() {
             console.warn(getObject(arg0));
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 275, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_1266);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 280, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_1308);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("Event")], shim_idx: 7, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_412);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("Event")], shim_idx: 8, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_438);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000003: function(arg0) {
@@ -3506,14 +3518,14 @@ function __wbg_get_imports() {
     };
 }
 
-function __wasm_bindgen_func_elem_412(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_412(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_438(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_438(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_1266(arg0, arg1, arg2) {
+function __wasm_bindgen_func_elem_1308(arg0, arg1, arg2) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.__wasm_bindgen_func_elem_1266(retptr, arg0, arg1, addHeapObject(arg2));
+        wasm.__wasm_bindgen_func_elem_1308(retptr, arg0, arg1, addHeapObject(arg2));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         if (r1) {
@@ -3524,8 +3536,8 @@ function __wasm_bindgen_func_elem_1266(arg0, arg1, arg2) {
     }
 }
 
-function __wasm_bindgen_func_elem_1282(arg0, arg1, arg2, arg3) {
-    wasm.__wasm_bindgen_func_elem_1282(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_1324(arg0, arg1, arg2, arg3) {
+    wasm.__wasm_bindgen_func_elem_1324(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }