@loradb/lora-wasm 0.5.6 → 0.8.0

package/pkg-web/lora_wasm.js

@@ -173,17 +173,17 @@ function takeFromExternrefTable0(idx) {
     return value;
 }
 
-function getArrayU8FromWasm0(ptr, len) {
-    ptr = ptr >>> 0;
-    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
-}
-
 function passArray8ToWasm0(arg, malloc) {
     const ptr = malloc(arg.length * 1, 1) >>> 0;
     getUint8ArrayMemory0().set(arg, ptr / 1);
     WASM_VECTOR_LEN = arg.length;
     return ptr;
 }
+
+function getArrayU8FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
+}
 /**
  * Call once at module start to install a panic hook that routes Rust
  * panics to `console.error`. No-op if compiled without the default feature.
@@ -251,23 +251,37 @@ export class WasmDatabase {
         return takeFromExternrefTable0(ret[0]);
     }
     /**
-     * @returns {number}
+     * Replace the graph state with a database snapshot decoded from `bytes`.
+     * Legacy store snapshot bytes are accepted for compatibility.
+     *
+     * Returns a plain object matching the shape of `SnapshotMeta`:
+     * `{ formatVersion, nodeCount, relationshipCount, walLsn }`.
+     * @param {Uint8Array} bytes
+     * @param {any} options
+     * @returns {any}
      */
-    relationshipCount() {
-        const ret = wasm.wasmdatabase_relationshipCount(this.__wbg_ptr);
-        return ret >>> 0;
+    loadSnapshot(bytes, options) {
+        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmdatabase_loadSnapshot(this.__wbg_ptr, ptr0, len0, options);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
     }
     /**
-     * Serialize the graph into a byte buffer. The caller is responsible for
-     * writing it to disk, IndexedDB, localStorage, or wherever — WASM does
-     * not have direct filesystem access. The returned bytes can later be
-     * passed to `loadSnapshotFromBytes` on any `WasmDatabase` instance.
+     * Serialize the graph into database snapshot bytes. The caller is
+     * responsible for writing them to IndexedDB, localStorage, a server, or
+     * another host-provided store — WASM has no direct filesystem access.
+     * The returned bytes can later be passed to `loadSnapshot` on any
+     * `WasmDatabase` instance.
      *
      * Returns the serialized bytes as a `Uint8Array`.
+     * @param {any} options
      * @returns {Uint8Array}
      */
-    saveSnapshotToBytes() {
-        const ret = wasm.wasmdatabase_saveSnapshotToBytes(this.__wbg_ptr);
+    saveSnapshot(options) {
+        const ret = wasm.wasmdatabase_saveSnapshot(this.__wbg_ptr, options);
         if (ret[3]) {
             throw takeFromExternrefTable0(ret[2]);
         }
@@ -276,21 +290,34 @@ export class WasmDatabase {
         return v1;
     }
     /**
-     * Replace the graph state with a snapshot decoded from `bytes`.
+     * Execute a Lora query and return the result as a binary buffer.
      *
-     * Returns a plain object matching the shape of `SnapshotMeta`:
-     * `{ formatVersion, nodeCount, relationshipCount, walLsn }`.
-     * @param {Uint8Array} bytes
-     * @returns {any}
+     * Wire format is the shared `lora_binding_buffer` layout. The TS
+     * wrapper decodes it once into the same `{ columns, rows }` shape
+     * `execute()` returns, but in a tight V8 loop instead of going
+     * through `serde_wasm_bindgen` value-by-value. Materially faster
+     * on bulk reads.
+     * @param {string} query
+     * @param {any} params
+     * @returns {Uint8Array}
      */
-    loadSnapshotFromBytes(bytes) {
-        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+    executeBuffer(query, params) {
+        const ptr0 = passStringToWasm0(query, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.wasmdatabase_loadSnapshotFromBytes(this.__wbg_ptr, ptr0, len0);
-        if (ret[2]) {
-            throw takeFromExternrefTable0(ret[1]);
+        const ret = wasm.wasmdatabase_executeBuffer(this.__wbg_ptr, ptr0, len0, params);
+        if (ret[3]) {
+            throw takeFromExternrefTable0(ret[2]);
         }
-        return takeFromExternrefTable0(ret[0]);
+        var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        return v2;
+    }
+    /**
+     * @returns {number}
+     */
+    relationshipCount() {
+        const ret = wasm.wasmdatabase_relationshipCount(this.__wbg_ptr);
+        return ret >>> 0;
     }
     constructor() {
         const ret = wasm.wasmdatabase_new();
@@ -320,6 +347,43 @@ export class WasmDatabase {
         }
         return takeFromExternrefTable0(ret[0]);
     }
+    /**
+     * Compile a query and return its plan without executing it.
+     *
+     * Mutating queries (CREATE / MERGE / SET / DELETE / REMOVE) leave
+     * the graph untouched — this method never runs the executor.
+     * @param {string} query
+     * @param {any} params
+     * @returns {any}
+     */
+    explain(query, params) {
+        const ptr0 = passStringToWasm0(query, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmdatabase_explain(this.__wbg_ptr, ptr0, len0, params);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
+    /**
+     * Execute a query and return the plan plus runtime metrics.
+     *
+     * **PROFILE executes the query for real.** Mutating queries are
+     * persisted exactly as in `execute()`. Use `explain()` to inspect
+     * a mutating plan without running it.
+     * @param {string} query
+     * @param {any} params
+     * @returns {any}
+     */
+    profile(query, params) {
+        const ptr0 = passStringToWasm0(query, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmdatabase_profile(this.__wbg_ptr, ptr0, len0, params);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
 }
 
 const WasmQueryStreamFinalization = (typeof FinalizationRegistry === 'undefined')
@@ -421,6 +485,14 @@ function __wbg_get_imports() {
         const ret = arg0.call(arg1);
         return ret;
     }, arguments) };
+    imports.wbg.__wbg_call_7cccdd69e0791ae2 = function() { return handleError(function (arg0, arg1, arg2) {
+        const ret = arg0.call(arg1, arg2);
+        return ret;
+    }, arguments) };
+    imports.wbg.__wbg_crypto_86f2631e91b51511 = function(arg0) {
+        const ret = arg0.crypto;
+        return ret;
+    };
     imports.wbg.__wbg_done_769e5ede4b31c67b = function(arg0) {
         const ret = arg0.done;
         return ret;
@@ -440,6 +512,9 @@ function __wbg_get_imports() {
             wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
         }
     };
+    imports.wbg.__wbg_getRandomValues_b3f15fcbfabb0f8b = function() { return handleError(function (arg0, arg1) {
+        arg0.getRandomValues(arg1);
+    }, arguments) };
     imports.wbg.__wbg_get_67b2ba62fc30de12 = function() { return handleError(function (arg0, arg1) {
         const ret = Reflect.get(arg0, arg1);
         return ret;
@@ -498,6 +573,10 @@ function __wbg_get_imports() {
         const ret = arg0.length;
         return ret;
     };
+    imports.wbg.__wbg_msCrypto_d562bbe83e0d4b91 = function(arg0) {
+        const ret = arg0.msCrypto;
+        return ret;
+    };
     imports.wbg.__wbg_new_405e22f390576ce2 = function() {
         const ret = new Object();
         return ret;
@@ -518,6 +597,18 @@ function __wbg_get_imports() {
         const ret = new Uint8Array(arg0);
         return ret;
     };
+    imports.wbg.__wbg_newnoargs_105ed471475aaf50 = function(arg0, arg1) {
+        const ret = new Function(getStringFromWasm0(arg0, arg1));
+        return ret;
+    };
+    imports.wbg.__wbg_newwithbyteoffsetandlength_d97e637ebe145a9a = function(arg0, arg1, arg2) {
+        const ret = new Uint8Array(arg0, arg1 >>> 0, arg2 >>> 0);
+        return ret;
+    };
+    imports.wbg.__wbg_newwithlength_a381634e90c276d4 = function(arg0) {
+        const ret = new Uint8Array(arg0 >>> 0);
+        return ret;
+    };
     imports.wbg.__wbg_next_25feadfc0913fea9 = function(arg0) {
         const ret = arg0.next;
         return ret;
@@ -526,10 +617,25 @@ function __wbg_get_imports() {
         const ret = arg0.next();
         return ret;
     }, arguments) };
+    imports.wbg.__wbg_node_e1f24f89a7336c2e = function(arg0) {
+        const ret = arg0.node;
+        return ret;
+    };
     imports.wbg.__wbg_now_807e54c39636c349 = function() {
         const ret = Date.now();
         return ret;
     };
+    imports.wbg.__wbg_process_3975fd6c72f520aa = function(arg0) {
+        const ret = arg0.process;
+        return ret;
+    };
+    imports.wbg.__wbg_randomFillSync_f8c153b79f285817 = function() { return handleError(function (arg0, arg1) {
+        arg0.randomFillSync(arg1);
+    }, arguments) };
+    imports.wbg.__wbg_require_b74f47fc2d022fd6 = function() { return handleError(function () {
+        const ret = module.require;
+        return ret;
+    }, arguments) };
     imports.wbg.__wbg_set_37837023f3d740e8 = function(arg0, arg1, arg2) {
         arg0[arg1 >>> 0] = arg2;
     };
@@ -550,10 +656,34 @@ function __wbg_get_imports() {
         getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
         getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
     };
+    imports.wbg.__wbg_static_accessor_GLOBAL_88a902d13a557d07 = function() {
+        const ret = typeof global === 'undefined' ? null : global;
+        return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
+    };
+    imports.wbg.__wbg_static_accessor_GLOBAL_THIS_56578be7e9f832b0 = function() {
+        const ret = typeof globalThis === 'undefined' ? null : globalThis;
+        return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
+    };
+    imports.wbg.__wbg_static_accessor_SELF_37c5d418e4bf5819 = function() {
+        const ret = typeof self === 'undefined' ? null : self;
+        return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
+    };
+    imports.wbg.__wbg_static_accessor_WINDOW_5de37043a91a9c40 = function() {
+        const ret = typeof window === 'undefined' ? null : window;
+        return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
+    };
+    imports.wbg.__wbg_subarray_aa9065fa9dc5df96 = function(arg0, arg1, arg2) {
+        const ret = arg0.subarray(arg1 >>> 0, arg2 >>> 0);
+        return ret;
+    };
     imports.wbg.__wbg_value_cd1ffa7b1ab794f1 = function(arg0) {
         const ret = arg0.value;
         return ret;
     };
+    imports.wbg.__wbg_versions_4e31226f5e8dc909 = function(arg0) {
+        const ret = arg0.versions;
+        return ret;
+    };
     imports.wbg.__wbindgen_bigint_from_i64 = function(arg0) {
         const ret = arg0;
         return ret;

package/pkg-web/lora_wasm_bg.wasm.d.ts

@@ -5,12 +5,15 @@ export const __wbg_wasmdatabase_free: (a: number, b: number) => void;
 export const __wbg_wasmquerystream_free: (a: number, b: number) => void;
 export const wasmdatabase_clear: (a: number) => void;
 export const wasmdatabase_execute: (a: number, b: number, c: number, d: any) => [number, number, number];
-export const wasmdatabase_loadSnapshotFromBytes: (a: number, b: number, c: number) => [number, number, number];
+export const wasmdatabase_executeBuffer: (a: number, b: number, c: number, d: any) => [number, number, number, number];
+export const wasmdatabase_explain: (a: number, b: number, c: number, d: any) => [number, number, number];
+export const wasmdatabase_loadSnapshot: (a: number, b: number, c: number, d: any) => [number, number, number];
 export const wasmdatabase_new: () => number;
 export const wasmdatabase_nodeCount: (a: number) => number;
 export const wasmdatabase_openStream: (a: number, b: number, c: number, d: any) => [number, number, number];
+export const wasmdatabase_profile: (a: number, b: number, c: number, d: any) => [number, number, number];
 export const wasmdatabase_relationshipCount: (a: number) => number;
-export const wasmdatabase_saveSnapshotToBytes: (a: number) => [number, number, number, number];
+export const wasmdatabase_saveSnapshot: (a: number, b: any) => [number, number, number, number];
 export const wasmdatabase_transaction: (a: number, b: any, c: number, d: number) => [number, number, number];
 export const wasmquerystream_close: (a: number) => void;
 export const wasmquerystream_columns: (a: number) => [number, number, number];

package/pkg-web/package.json

@@ -5,7 +5,7 @@
     "LoraDB, Inc."
   ],
   "description": "WebAssembly bindings for the Lora in-memory graph database",
-  "version": "0.5.6",
+  "version": "0.8.0",
   "license": "BUSL-1.1",
   "files": [
     "lora_wasm_bg.wasm",