@loradb/lora-wasm 0.2.0 → 0.4.0

package/dist/index.d.ts

@@ -18,6 +18,18 @@ import type { LoraParams, LoraValue, QueryResult } from "./types.js";
 import { WasmDatabase } from "./loader-node.js";
 export * from "./types.js";
 export { createWorkerDatabase, type WorkerDatabase } from "./worker-client.js";
+/**
+ * Metadata returned by `saveSnapshotToBytes` / `loadSnapshotFromBytes`.
+ * Mirrors the Rust `SnapshotMeta` struct and matches the shape used by
+ * every other binding — `walLsn` is reserved for the future
+ * WAL/checkpoint hybrid and is `null` for pure snapshots.
+ */
+export interface SnapshotMeta {
+    formatVersion: number;
+    nodeCount: number;
+    relationshipCount: number;
+    walLsn: number | null;
+}
 /**
  * In-memory Lora graph database running on the WASM engine.
  *
@@ -33,6 +45,18 @@ declare class DatabaseImpl {
     clear(): Promise<void>;
     nodeCount(): Promise<number>;
     relationshipCount(): Promise<number>;
+    /**
+     * Serialize the current graph to a `Uint8Array`. WASM has no filesystem
+     * access — the caller is responsible for persisting the bytes (IndexedDB,
+     * localStorage, fetch POST, `fs.writeFileSync` in Node, etc.) and passing
+     * them back to `loadSnapshotFromBytes` on a future database instance.
+     */
+    saveSnapshotToBytes(): Promise<Uint8Array>;
+    /**
+     * Replace the current graph state with a snapshot decoded from `bytes`.
+     * Returns metadata describing the restored snapshot.
+     */
+    loadSnapshotFromBytes(bytes: Uint8Array): Promise<SnapshotMeta>;
     /** Release the underlying wasm handle. Subsequent calls will throw. */
     dispose(): void;
 }

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../ts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAoB,MAAM,kBAAkB,CAAC;AAElE,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAS/E;;;;;;;GAOG;AACH,cAAM,YAAY;;gBAGJ,KAAK,EAAE,YAAY,CAAC,OAAO,YAAY,CAAC;IAI9C,OAAO,CACX,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/D,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IASxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAI1C,uEAAuE;IACvE,OAAO,IAAI,IAAI;CAGhB;AAED;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,CAAC;AAEpC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,QAAQ,CAAC,CAGxD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../ts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAoB,MAAM,kBAAkB,CAAC;AAElE,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AASD;;;;;;;GAOG;AACH,cAAM,YAAY;;gBAGJ,KAAK,EAAE,YAAY,CAAC,OAAO,YAAY,CAAC;IAI9C,OAAO,CACX,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/D,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IASxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAI1C;;;;;OAKG;IACG,mBAAmB,IAAI,OAAO,CAAC,UAAU,CAAC;IAQhD;;;OAGG;IACG,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IAQrE,uEAAuE;IACvE,OAAO,IAAI,IAAI;CAGhB;AAED;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,CAAC;AAEpC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,QAAQ,CAAC,CAGxD"}

package/dist/index.js

@@ -56,6 +56,32 @@ class DatabaseImpl {
     async relationshipCount() {
         return this.#inner.relationshipCount();
     }
+    /**
+     * Serialize the current graph to a `Uint8Array`. WASM has no filesystem
+     * access — the caller is responsible for persisting the bytes (IndexedDB,
+     * localStorage, fetch POST, `fs.writeFileSync` in Node, etc.) and passing
+     * them back to `loadSnapshotFromBytes` on a future database instance.
+     */
+    async saveSnapshotToBytes() {
+        try {
+            return this.#inner.saveSnapshotToBytes();
+        }
+        catch (err) {
+            throw wrapError(err);
+        }
+    }
+    /**
+     * Replace the current graph state with a snapshot decoded from `bytes`.
+     * Returns metadata describing the restored snapshot.
+     */
+    async loadSnapshotFromBytes(bytes) {
+        try {
+            return this.#inner.loadSnapshotFromBytes(bytes);
+        }
+        catch (err) {
+            throw wrapError(err);
+        }
+    }
     /** Release the underlying wasm handle. Subsequent calls will throw. */
     dispose() {
         this.#inner.free();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../ts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAElE,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAuB,MAAM,oBAAoB,CAAC;AAE/E,IAAI,YAAY,GAAG,KAAK,CAAC;AACzB,SAAS,kBAAkB;IACzB,IAAI,YAAY;QAAE,OAAO;IACzB,QAAQ,EAAE,CAAC;IACX,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,YAAY;IACP,MAAM,CAAoC;IAEnD,YAAY,KAAwC;QAClD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,OAAO,CAEX,KAAa,EAAE,MAAmB;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,MAAM,IAAI,IAAI,CAAY,CAAC,CAAC;YACpE,OAAO,GAAqB,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;IACzC,CAAC;IAED,uEAAuE;IACvE,OAAO;QACL,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;CACF;AAUD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,kBAAkB,EAAE,CAAC;IACrB,OAAO,IAAI,YAAY,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../ts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAElE,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAuB,MAAM,oBAAoB,CAAC;AAe/E,IAAI,YAAY,GAAG,KAAK,CAAC;AACzB,SAAS,kBAAkB;IACzB,IAAI,YAAY;QAAE,OAAO;IACzB,QAAQ,EAAE,CAAC;IACX,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,YAAY;IACP,MAAM,CAAoC;IAEnD,YAAY,KAAwC;QAClD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,OAAO,CAEX,KAAa,EAAE,MAAmB;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,MAAM,IAAI,IAAI,CAAY,CAAC,CAAC;YACpE,OAAO,GAAqB,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,mBAAmB;QACvB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,qBAAqB,CAAC,KAAiB;QAC3C,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAiB,CAAC;QAClE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,OAAO;QACL,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;CACF;AAUD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,kBAAkB,EAAE,CAAC;IACrB,OAAO,IAAI,YAAY,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;AAC9C,CAAC"}

package/dist/loader-node.d.ts

@@ -7,6 +7,16 @@ export interface NativeModule {
     WasmDatabase: new () => NativeWasmDatabase;
     init: () => void;
 }
+/**
+ * Shape of the snapshot metadata emitted by `loadSnapshotFromBytes`. The
+ * native Rust layer returns this as a plain JS object via `serde-wasm-bindgen`.
+ */
+export interface NativeSnapshotMeta {
+    formatVersion: number;
+    nodeCount: number;
+    relationshipCount: number;
+    walLsn: number | null;
+}
 export declare const WasmDatabase: new () => NativeWasmDatabase;
 export declare const init: () => void;
 //# sourceMappingURL=loader-node.d.ts.map

package/dist/loader-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader-node.d.ts","sourceRoot":"","sources":["../ts/loader-node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,UAAU,kBAAkB,CAAC;IAC3C,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAOD,eAAO,MAAM,YAAY,YATC,kBASkB,CAAC;AAC7C,eAAO,MAAM,IAAI,QATH,IASc,CAAC"}
+{"version":3,"file":"loader-node.d.ts","sourceRoot":"","sources":["../ts/loader-node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,UAAU,kBAAkB,CAAC;IAC3C,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAOD,eAAO,MAAM,YAAY,YApBC,kBAoBkB,CAAC;AAC7C,eAAO,MAAM,IAAI,QApBH,IAoBc,CAAC"}

package/dist/loader-node.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader-node.js","sourceRoot":"","sources":["../ts/loader-node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQ5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,2EAA2E;AAC3E,wCAAwC;AACxC,MAAM,GAAG,GAAG,OAAO,CAAC,0BAA0B,CAAiB,CAAC;AAEhE,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;AAC7C,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC"}
+{"version":3,"file":"loader-node.js","sourceRoot":"","sources":["../ts/loader-node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAmB5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,2EAA2E;AAC3E,wCAAwC;AACxC,MAAM,GAAG,GAAG,OAAO,CAAC,0BAA0B,CAAiB,CAAC;AAEhE,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;AAC7C,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loradb/lora-wasm",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "WebAssembly bindings for the Lora in-memory graph database",
   "license": "BUSL-1.1",
   "author": "LoraDB, Inc.",

package/pkg-bundler/lora_wasm.d.ts

@@ -12,6 +12,22 @@ export class WasmDatabase {
   free(): void;
   nodeCount(): number;
   relationshipCount(): number;
+  /**
+   * 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.
+   *
+   * Returns the serialized bytes as a `Uint8Array`.
+   */
+  saveSnapshotToBytes(): Uint8Array;
+  /**
+   * Replace the graph state with a snapshot decoded from `bytes`.
+   *
+   * Returns a plain object matching the shape of `SnapshotMeta`:
+   * `{ formatVersion, nodeCount, relationshipCount, walLsn }`.
+   */
+  loadSnapshotFromBytes(bytes: Uint8Array): any;
   constructor();
   clear(): void;
   /**

package/pkg-bundler/lora_wasm_bg.js

@@ -180,6 +180,18 @@ function takeFromExternrefTable0(idx) {
     wasm.__externref_table_dealloc(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;
+}
 /**
  * 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.
@@ -221,6 +233,41 @@ export class WasmDatabase {
         const ret = wasm.wasmdatabase_relationshipCount(this.__wbg_ptr);
         return 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.
+     *
+     * Returns the serialized bytes as a `Uint8Array`.
+     * @returns {Uint8Array}
+     */
+    saveSnapshotToBytes() {
+        const ret = wasm.wasmdatabase_saveSnapshotToBytes(this.__wbg_ptr);
+        if (ret[3]) {
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        return v1;
+    }
+    /**
+     * Replace the graph state with a snapshot decoded from `bytes`.
+     *
+     * Returns a plain object matching the shape of `SnapshotMeta`:
+     * `{ formatVersion, nodeCount, relationshipCount, walLsn }`.
+     * @param {Uint8Array} bytes
+     * @returns {any}
+     */
+    loadSnapshotFromBytes(bytes) {
+        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmdatabase_loadSnapshotFromBytes(this.__wbg_ptr, ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     constructor() {
         const ret = wasm.wasmdatabase_new();
         this.__wbg_ptr = ret >>> 0;

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

@@ -4,9 +4,11 @@ export const memory: WebAssembly.Memory;
 export const __wbg_wasmdatabase_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_new: () => number;
 export const wasmdatabase_nodeCount: (a: number) => number;
 export const wasmdatabase_relationshipCount: (a: number) => number;
+export const wasmdatabase_saveSnapshotToBytes: (a: number) => [number, number, number, number];
 export const init: () => void;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;

package/pkg-bundler/package.json

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

package/pkg-node/lora_wasm.d.ts

@@ -12,6 +12,22 @@ export class WasmDatabase {
   free(): void;
   nodeCount(): number;
   relationshipCount(): number;
+  /**
+   * 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.
+   *
+   * Returns the serialized bytes as a `Uint8Array`.
+   */
+  saveSnapshotToBytes(): Uint8Array;
+  /**
+   * Replace the graph state with a snapshot decoded from `bytes`.
+   *
+   * Returns a plain object matching the shape of `SnapshotMeta`:
+   * `{ formatVersion, nodeCount, relationshipCount, walLsn }`.
+   */
+  loadSnapshotFromBytes(bytes: Uint8Array): any;
   constructor();
   clear(): void;
   /**

package/pkg-node/lora_wasm.js

@@ -176,6 +176,18 @@ function takeFromExternrefTable0(idx) {
     wasm.__externref_table_dealloc(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;
+}
 /**
  * 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.
@@ -217,6 +229,41 @@ class WasmDatabase {
         const ret = wasm.wasmdatabase_relationshipCount(this.__wbg_ptr);
         return 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.
+     *
+     * Returns the serialized bytes as a `Uint8Array`.
+     * @returns {Uint8Array}
+     */
+    saveSnapshotToBytes() {
+        const ret = wasm.wasmdatabase_saveSnapshotToBytes(this.__wbg_ptr);
+        if (ret[3]) {
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        return v1;
+    }
+    /**
+     * Replace the graph state with a snapshot decoded from `bytes`.
+     *
+     * Returns a plain object matching the shape of `SnapshotMeta`:
+     * `{ formatVersion, nodeCount, relationshipCount, walLsn }`.
+     * @param {Uint8Array} bytes
+     * @returns {any}
+     */
+    loadSnapshotFromBytes(bytes) {
+        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmdatabase_loadSnapshotFromBytes(this.__wbg_ptr, ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     constructor() {
         const ret = wasm.wasmdatabase_new();
         this.__wbg_ptr = ret >>> 0;

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

@@ -4,9 +4,11 @@ export const memory: WebAssembly.Memory;
 export const __wbg_wasmdatabase_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_new: () => number;
 export const wasmdatabase_nodeCount: (a: number) => number;
 export const wasmdatabase_relationshipCount: (a: number) => number;
+export const wasmdatabase_saveSnapshotToBytes: (a: number) => [number, number, number, number];
 export const init: () => void;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;

package/pkg-node/package.json

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

package/pkg-web/lora_wasm.d.ts

@@ -12,6 +12,22 @@ export class WasmDatabase {
   free(): void;
   nodeCount(): number;
   relationshipCount(): number;
+  /**
+   * 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.
+   *
+   * Returns the serialized bytes as a `Uint8Array`.
+   */
+  saveSnapshotToBytes(): Uint8Array;
+  /**
+   * Replace the graph state with a snapshot decoded from `bytes`.
+   *
+   * Returns a plain object matching the shape of `SnapshotMeta`:
+   * `{ formatVersion, nodeCount, relationshipCount, walLsn }`.
+   */
+  loadSnapshotFromBytes(bytes: Uint8Array): any;
   constructor();
   clear(): void;
   /**
@@ -31,9 +47,11 @@ export interface InitOutput {
   readonly __wbg_wasmdatabase_free: (a: number, b: number) => void;
   readonly wasmdatabase_clear: (a: number) => void;
   readonly wasmdatabase_execute: (a: number, b: number, c: number, d: any) => [number, number, number];
+  readonly wasmdatabase_loadSnapshotFromBytes: (a: number, b: number, c: number) => [number, number, number];
   readonly wasmdatabase_new: () => number;
   readonly wasmdatabase_nodeCount: (a: number) => number;
   readonly wasmdatabase_relationshipCount: (a: number) => number;
+  readonly wasmdatabase_saveSnapshotToBytes: (a: number) => [number, number, number, number];
   readonly init: () => void;
   readonly __wbindgen_malloc: (a: number, b: number) => number;
   readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;

package/pkg-web/lora_wasm.js

@@ -172,6 +172,18 @@ function takeFromExternrefTable0(idx) {
     wasm.__externref_table_dealloc(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;
+}
 /**
  * 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.
@@ -213,6 +225,41 @@ export class WasmDatabase {
         const ret = wasm.wasmdatabase_relationshipCount(this.__wbg_ptr);
         return 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.
+     *
+     * Returns the serialized bytes as a `Uint8Array`.
+     * @returns {Uint8Array}
+     */
+    saveSnapshotToBytes() {
+        const ret = wasm.wasmdatabase_saveSnapshotToBytes(this.__wbg_ptr);
+        if (ret[3]) {
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        return v1;
+    }
+    /**
+     * Replace the graph state with a snapshot decoded from `bytes`.
+     *
+     * Returns a plain object matching the shape of `SnapshotMeta`:
+     * `{ formatVersion, nodeCount, relationshipCount, walLsn }`.
+     * @param {Uint8Array} bytes
+     * @returns {any}
+     */
+    loadSnapshotFromBytes(bytes) {
+        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmdatabase_loadSnapshotFromBytes(this.__wbg_ptr, ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     constructor() {
         const ret = wasm.wasmdatabase_new();
         this.__wbg_ptr = ret >>> 0;

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

@@ -4,9 +4,11 @@ export const memory: WebAssembly.Memory;
 export const __wbg_wasmdatabase_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_new: () => number;
 export const wasmdatabase_nodeCount: (a: number) => number;
 export const wasmdatabase_relationshipCount: (a: number) => number;
+export const wasmdatabase_saveSnapshotToBytes: (a: number) => [number, number, number, number];
 export const init: () => void;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: 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.2.0",
+  "version": "0.4.0",
   "license": "BUSL-1.1",
   "files": [
     "lora_wasm_bg.wasm",