@loradb/lora-wasm 0.5.6 → 0.8.0

package/README.md

@@ -1,17 +1,17 @@
 # lora-wasm
 
-WebAssembly bindings for the [Lora](../../README.md) in-memory graph
+WebAssembly bindings for the [Lora](../../../README.md) in-memory graph
 database. The package is designed for browsers and Node.js and exposes a
 **strongly typed, async-facing API** that keeps the main thread responsive:
 heavy query work can run inside a Web Worker while your UI code simply awaits
 the result.
 
-> **Status:** prototype / feasibility check. Not published to npm.
+> **Package:** `@loradb/lora-wasm`.
 
 ## Build
 
 ```bash
-cd crates/lora-wasm
+cd crates/bindings/lora-wasm
 npm install
 npm run build              # wasm-pack (node + bundler) + tsc
 npm test                   # vitest
@@ -52,7 +52,7 @@ fails during startup, the package emits one `console.warn` and falls back to
 the in-process WASM engine so the app can still run.
 
 ```ts
-import { createDatabase, isNode } from "lora-wasm";
+import { createDatabase, isNode } from "@loradb/lora-wasm";
 
 const db = await createDatabase(); // Worker-backed in browsers when possible
 await db.execute("CREATE (:Person {name: $n})", { n: "Alice" });
@@ -63,6 +63,37 @@ for (const row of r.rows) {
 }
 ```
 
+### Explain & Profile
+
+`db.explain()` and `db.profile()` are first-class methods alongside
+`db.execute()`. They are intentionally *separate calls*, not a flag
+on `execute()`, so plan inspection and runtime metrics must be
+requested explicitly.
+
+```ts
+const plan = await db.explain(
+  "MATCH (p:Person) WHERE p.name = $name RETURN p",
+  { name: "Alice" },
+);
+console.log(plan.shape);          // "readOnly"
+console.log(plan.tree.operator);
+
+const profile = await db.profile(
+  "MATCH (p:Person) WHERE p.name = $name RETURN p",
+  { name: "Alice" },
+);
+console.log(profile.metrics.totalElapsedNs);
+console.log(profile.metrics.perOperator); // per-step inclusive timing
+```
+
+`explain()` never invokes the executor — calling it on a mutating
+query (`CREATE`, `MERGE`, `SET`, `DELETE`, `REMOVE`) leaves the graph
+untouched.
+
+> **`profile()` executes the query for real.** Mutating queries
+> produce the same side effects as `execute()`. Use `explain()` to
+> inspect a mutating plan without running it.
+
 To force the in-process engine:
 
 ```ts
@@ -84,7 +115,7 @@ const db = await createDatabase({ warnOnFallback: false });
 ### 2. Explicit main-thread WASM
 
 ```ts
-import { createMainThreadDatabase } from "lora-wasm";
+import { createMainThreadDatabase } from "@loradb/lora-wasm";
 
 const db = await createMainThreadDatabase();
 ```
@@ -116,35 +147,36 @@ useful for tests and for swapping execution backends behind the same API.
 
 ## Snapshots
 
-WASM has no filesystem access, so `saveSnapshot()` defaults to a `Uint8Array`.
-It also accepts typed formats: `"base64"` returns base64 text, `"blob"` returns
-a `Blob`, and `"download"` triggers a browser download from the main thread.
-
-`loadSnapshot` accepts a `WasmSnapshotSource`: `Uint8Array`, `ArrayBuffer`,
-`Blob`/`File`, `Response`, web `ReadableStream`, string URL, or `URL`. It does
-not include Node `Buffer`; use `Uint8Array` bytes when running the WASM package
-from Node.
+WASM has no filesystem access, so snapshots never accept string paths.
+`saveSnapshot()` defaults to `Uint8Array`, and can also return `ArrayBuffer`,
+`Blob`, `Response`, `ReadableStream`, or an object `URL`. `loadSnapshot`
+accepts `URL`, `Uint8Array`, `ArrayBuffer`, `Blob`, `Response`, and web
+`ReadableStream<Uint8Array | ArrayBuffer>`. The bytes use the database
+snapshot codec (`LORACOL1`) and can be loaded by native LoraDB. Older store
+snapshots use the current `LORACOL1` columnar format.
+Snapshot bytes are uncompressed by default; pass `{ compression: "gzip" }` or
+`{ compression: { format: "gzip", level: 1 } }` to save smaller
+WASM-portable snapshots. Gzip levels `0..9` are supported; level `1` is the
+fast default.
 
 ```ts
-import { createDatabase } from "lora-wasm";
+import { createDatabase } from "@loradb/lora-wasm";
 
 const db = await createDatabase();
 await db.execute("CREATE (:Person {name: 'Alice'})");
 
-const bytes = await db.saveSnapshotToBytes();
-const sameBytes = await db.saveSnapshot("binary");
-const blob = await db.saveSnapshot({ format: "blob" });
-await db.saveSnapshot({ format: "download", filename: "graph.lorasnap" });
+const bytes = await db.saveSnapshot();
+const compressed = await db.saveSnapshot({ compression: "gzip" });
+const blob = await db.saveSnapshot({ format: "blob", compression: "gzip" });
+const response = await db.saveSnapshot({ format: "response" });
 
 await db.loadSnapshot(bytes);
+await db.loadSnapshot(compressed);
 await db.loadSnapshot(blob);
-await db.loadSnapshot(new Response(bytes).body!);
+await db.loadSnapshot(response);
 await db.loadSnapshot(new URL("/graph.lorasnap", location.href));
 ```
 
-`loadSnapshotFromBytes(bytes)` remains available for the narrow
-`Uint8Array`-only path.
-
 ## Typed value model
 
 | TS type                              | Runtime shape                                                               |
@@ -171,31 +203,42 @@ Helper constructors: `date`, `time`, `datetime`, `localtime`, `localdatetime`,
 `isNode`, `isRelationship`, `isPath`, `isPoint`, `isTemporal`.
 
 > `distance()` on WGS-84-3D points ignores `height`. See
-> [functions reference](../../apps/loradb.com/docs/functions/overview.md) for the spatial
+> [functions reference](../../../apps/loradb.com/docs/functions/overview.md) for the spatial
 > reference and out-of-scope operations.
 
 ## Errors
 
-`db.execute(...)` and the worker client throw `LoraError` with a narrowed
-`code`:
+`db.execute(...)` and the worker client throw `LoraError` with a
+narrowed `code` from the `LoraErrorCode` union — these mirror
+`lora_database::LoraErrorCode` 1:1, plus `WORKER_ERROR` and `UNKNOWN`.
 
-- `LORA_ERROR` — parse / analyze / execute failure
-- `INVALID_PARAMS` — a param value could not be mapped to a Lora value
+Common ones:
+
+- `LORA_PARSE` — Cypher syntax could not be parsed
+- `LORA_SEMANTIC` — analysis failure (unknown variable, label, type mismatch, …)
+- `LORA_INVALID_PARAMS` — a parameter value could not be coerced to a `LoraValue`
+- `LORA_INVALID_VECTOR` — vector value failed dimension / coordinate-type validation
+- `LORA_TIMEOUT` — query exceeded its cooperative deadline
+- `LORA_IO`, `LORA_SNAPSHOT_CODEC`, `LORA_SNAPSHOT_CRYPTO` — storage / snapshot failures
+- `LORA_INTERNAL` — last-resort fallback when the engine cannot classify the failure
 - `WORKER_ERROR` — worker transport / lifecycle failure (worker client only)
 
+See `ts/types.ts` (`LoraErrorCode`) for the full list.
+
 ## Shared type contract
 
 The public TypeScript value model (`LoraValue`, `LoraNode`, …,
 `QueryResult`, `LoraError`) lives in a single canonical file at
-`crates/shared-ts/types.ts` and is copied into each consumer package by
+`crates/bindings/shared-ts/types.ts` and is copied into each consumer package by
 its `sync:types` npm script. CI runs `verify:types` to fail on drift.
 That keeps `lora-node` and `lora-wasm` locked to one identical
 public surface — consumers can swap backends without rewriting types.
 
 ## Known limitations
 
-- The wasm module is single-threaded. Parallel queries inside one worker
-  serialise; spawn more workers for true parallelism.
+- The wasm module runs inside one JavaScript runtime. Auto-commit reads can
+  overlap on engine snapshots; write commits serialize. Use more Workers for
+  separate graphs or stronger UI isolation.
 - I64 values are delivered as JS `number` and lose precision above 2^53.
   Applications that need bigint precision should use the native
   `lora-node` binding instead.
@@ -227,7 +270,7 @@ public surface — consumers can swap backends without rewriting types.
   forms, parameter validation errors, and concurrent queries across the
   worker message protocol.
 - The TypeScript public contract is shared verbatim with `lora-node`
-  via `crates/shared-ts/types.ts`, enforced by `verify:types` in CI.
+  via `crates/bindings/shared-ts/types.ts`, enforced by `verify:types` in CI.
 - `npm pack --dry-run` produces a 45-file, 6.6 MB tarball containing
   all three wasm bundles plus the compiled TS wrapper. No `file:` deps,
   no postinstall scripts.
@@ -244,9 +287,8 @@ public surface — consumers can swap backends without rewriting types.
 - I64 precision is capped at `Number.MAX_SAFE_INTEGER`. For larger
   integer properties we need a `bigint`-aware serializer on the wasm
   boundary.
-- The engine is synchronous inside wasm — a single Worker serialises
-  queries. Multi-tenant workloads need either multiple Workers (already
-  possible), or an engine-level cooperative scheduler.
+- The engine is synchronous inside wasm once a call enters the module. A slow
+  query blocks that Worker until completion.
 - No query cancellation or progress streaming crosses the Worker
   boundary; a slow query blocks that Worker until completion.
 

package/dist/decode.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Decoder for the binary result format produced by the native side.
+ *
+ * The native `execute()` ships a single `Uint8Array` whose layout is
+ * defined by `crates/bindings/lora-binding-buffer/src/lib.rs`. This
+ * file is the sole reader; it must stay byte-compatible with the
+ * encoder there.
+ *
+ * Why this exists: each FFI syscall costs ~150 ns; for a 10 000-row
+ * scan, the per-cell loop takes thousands of crossings and dominates
+ * wall-clock time. Transferring the whole result as one buffer and
+ * decoding it in JIT'd JavaScript is materially faster — V8 walks
+ * contiguous bytes far more cheaply than the FFI layer can hand
+ * values across one at a time.
+ *
+ * Shared between the `lora-node` and `lora-wasm` bindings; the source
+ * of truth lives in `crates/bindings/shared-ts/decode.ts` and is
+ * synced into each binding's `ts/` by their `npm run sync:types`
+ * script (mirrors how `types.ts` is shared).
+ */
+/**
+ * Decode the wire format produced by `encode_rows` in the native crate
+ * into the public `{ columns, rows }` shape.
+ */
+export declare function decodeResult(buf: Uint8Array): {
+    columns: string[];
+    rows: Array<Record<string, any>>;
+};
+//# sourceMappingURL=decode.d.ts.map

package/dist/decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../ts/decode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAsTH;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,UAAU,GACd;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;CAAE,CA4BzD"}

package/dist/decode.js

@@ -0,0 +1,338 @@
+/**
+ * Decoder for the binary result format produced by the native side.
+ *
+ * The native `execute()` ships a single `Uint8Array` whose layout is
+ * defined by `crates/bindings/lora-binding-buffer/src/lib.rs`. This
+ * file is the sole reader; it must stay byte-compatible with the
+ * encoder there.
+ *
+ * Why this exists: each FFI syscall costs ~150 ns; for a 10 000-row
+ * scan, the per-cell loop takes thousands of crossings and dominates
+ * wall-clock time. Transferring the whole result as one buffer and
+ * decoding it in JIT'd JavaScript is materially faster — V8 walks
+ * contiguous bytes far more cheaply than the FFI layer can hand
+ * values across one at a time.
+ *
+ * Shared between the `lora-node` and `lora-wasm` bindings; the source
+ * of truth lives in `crates/bindings/shared-ts/decode.ts` and is
+ * synced into each binding's `ts/` by their `npm run sync:types`
+ * script (mirrors how `types.ts` is shared).
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const MAGIC_0 = 0x4c; // L
+const MAGIC_1 = 0x52; // R
+const MAGIC_2 = 0x31; // 1
+const MAGIC_3 = 0x00;
+// Cell tags — keep in sync with `tag::` constants in encode.rs.
+const TAG_NULL = 0x00;
+const TAG_FALSE = 0x01;
+const TAG_TRUE = 0x02;
+const TAG_I32 = 0x03;
+const TAG_I64 = 0x04;
+const TAG_F64 = 0x05;
+const TAG_STRING = 0x06;
+const TAG_LIST = 0x07;
+const TAG_MAP = 0x08;
+const TAG_NODE = 0x09;
+const TAG_RELATIONSHIP = 0x0a;
+const TAG_PATH = 0x0b;
+const TAG_DATE = 0x0c;
+const TAG_TIME = 0x0d;
+const TAG_LOCAL_TIME = 0x0e;
+const TAG_DATETIME = 0x0f;
+const TAG_LOCAL_DATETIME = 0x10;
+const TAG_DURATION = 0x11;
+const TAG_POINT = 0x12;
+const TAG_VECTOR = 0x13;
+const TAG_BINARY = 0x14;
+const VECTOR_FLOAT64 = 0;
+const VECTOR_FLOAT32 = 1;
+const VECTOR_INT64 = 2;
+const VECTOR_INT32 = 3;
+const VECTOR_INT16 = 4;
+const VECTOR_INT8 = 5;
+const SRID_CARTESIAN_2D = 7203;
+const SRID_CARTESIAN_3D = 9157;
+const SRID_WGS84_2D = 4326;
+const SRID_WGS84_3D = 4979;
+function sridToCrs(srid) {
+    switch (srid) {
+        case SRID_CARTESIAN_2D:
+            return "cartesian";
+        case SRID_CARTESIAN_3D:
+            return "cartesian-3D";
+        case SRID_WGS84_2D:
+            return "WGS-84-2D";
+        case SRID_WGS84_3D:
+            return "WGS-84-3D";
+        default:
+            return "cartesian";
+    }
+}
+const utf8 = new TextDecoder("utf-8");
+class Reader {
+    view;
+    bytes;
+    off = 0;
+    constructor(buf) {
+        this.bytes = buf;
+        this.view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    }
+    u8() {
+        // `noUncheckedIndexedAccess` says this might be undefined; we
+        // never read past the buffer because the encoder writes a
+        // bounded layout. The hot path can't afford a check.
+        return this.bytes[this.off++];
+    }
+    u32() {
+        const v = this.view.getUint32(this.off, true);
+        this.off += 4;
+        return v;
+    }
+    i32() {
+        const v = this.view.getInt32(this.off, true);
+        this.off += 4;
+        return v;
+    }
+    /**
+     * Reads an i64 LE and returns it as a JS Number. Values outside the
+     * `Number.MAX_SAFE_INTEGER` range silently lose precision — same
+     * behaviour the binding has always had on the read path. Callers that
+     * need exact representation of large ints should use a separate
+     * binding-side path; this is a hot loop.
+     */
+    i64AsNumber() {
+        // Two getInt32 calls beat getBigInt64 + Number(BigInt) by ~3× in V8.
+        // Manual reconstruction is exact for the |x| < 2^53 range.
+        const lo = this.view.getUint32(this.off, true);
+        const hi = this.view.getInt32(this.off + 4, true);
+        this.off += 8;
+        return hi * 0x1_0000_0000 + lo;
+    }
+    f64() {
+        const v = this.view.getFloat64(this.off, true);
+        this.off += 8;
+        return v;
+    }
+    str() {
+        const len = this.u32();
+        const start = this.off;
+        this.off += len;
+        if (len === 0)
+            return "";
+        // TextDecoder is a fused C++ path in V8; faster than Buffer.toString
+        // for short-to-medium strings and avoids hitting Buffer's own
+        // string-cache layer.
+        return utf8.decode(this.bytes.subarray(start, this.off));
+    }
+}
+function readValue(r) {
+    const tag = r.u8();
+    switch (tag) {
+        case TAG_NULL:
+            return null;
+        case TAG_FALSE:
+            return false;
+        case TAG_TRUE:
+            return true;
+        case TAG_I32:
+            return r.i32();
+        case TAG_I64:
+            return r.i64AsNumber();
+        case TAG_F64:
+            return r.f64();
+        case TAG_STRING:
+            return r.str();
+        case TAG_LIST: {
+            const n = r.u32();
+            const arr = new Array(n);
+            for (let i = 0; i < n; i++)
+                arr[i] = readValue(r);
+            return arr;
+        }
+        case TAG_MAP: {
+            const n = r.u32();
+            const obj = {};
+            for (let i = 0; i < n; i++) {
+                const k = r.str();
+                obj[k] = readValue(r);
+            }
+            return obj;
+        }
+        case TAG_NODE:
+            return {
+                kind: "node",
+                id: r.i64AsNumber(),
+                labels: [],
+                properties: {},
+            };
+        case TAG_RELATIONSHIP:
+            return { kind: "relationship", id: r.i64AsNumber() };
+        case TAG_PATH: {
+            const nN = r.u32();
+            const nodes = new Array(nN);
+            for (let i = 0; i < nN; i++)
+                nodes[i] = r.i64AsNumber();
+            const nR = r.u32();
+            const rels = new Array(nR);
+            for (let i = 0; i < nR; i++)
+                rels[i] = r.i64AsNumber();
+            return { kind: "path", nodes, rels };
+        }
+        case TAG_DATE:
+            return { kind: "date", iso: r.str() };
+        case TAG_TIME:
+            return { kind: "time", iso: r.str() };
+        case TAG_LOCAL_TIME:
+            return { kind: "localtime", iso: r.str() };
+        case TAG_DATETIME:
+            return { kind: "datetime", iso: r.str() };
+        case TAG_LOCAL_DATETIME:
+            return { kind: "localdatetime", iso: r.str() };
+        case TAG_DURATION:
+            return { kind: "duration", iso: r.str() };
+        case TAG_POINT: {
+            const hasZ = r.u8();
+            const srid = r.u32();
+            const x = r.f64();
+            const y = r.f64();
+            const point = {
+                kind: "point",
+                srid,
+                crs: sridToCrs(srid),
+                x,
+                y,
+            };
+            if (hasZ)
+                point.z = r.f64();
+            if (srid === SRID_WGS84_2D || srid === SRID_WGS84_3D) {
+                point.longitude = x;
+                point.latitude = y;
+                if (hasZ)
+                    point.height = point.z;
+            }
+            return point;
+        }
+        case TAG_VECTOR:
+            return readVector(r);
+        case TAG_BINARY:
+            return readBinary(r);
+        default:
+            throw new Error(`unknown LoraValue tag: 0x${tag.toString(16)}`);
+    }
+}
+function readVector(r) {
+    const coordTag = r.u8();
+    const dim = r.u32();
+    const values = new Array(dim);
+    let coordinateType;
+    switch (coordTag) {
+        case VECTOR_FLOAT64:
+            coordinateType = "FLOAT64";
+            for (let i = 0; i < dim; i++)
+                values[i] = r.f64();
+            break;
+        case VECTOR_FLOAT32:
+            coordinateType = "FLOAT32";
+            for (let i = 0; i < dim; i++) {
+                values[i] = r.view.getFloat32(r.off, true);
+                r.off += 4;
+            }
+            break;
+        case VECTOR_INT64:
+            coordinateType = "INTEGER";
+            for (let i = 0; i < dim; i++)
+                values[i] = r.i64AsNumber();
+            break;
+        case VECTOR_INT32:
+            coordinateType = "INTEGER32";
+            for (let i = 0; i < dim; i++)
+                values[i] = r.i32();
+            break;
+        case VECTOR_INT16:
+            coordinateType = "INTEGER16";
+            for (let i = 0; i < dim; i++) {
+                values[i] = r.view.getInt16(r.off, true);
+                r.off += 2;
+            }
+            break;
+        case VECTOR_INT8:
+            coordinateType = "INTEGER8";
+            for (let i = 0; i < dim; i++) {
+                values[i] = r.view.getInt8(r.off);
+                r.off += 1;
+            }
+            break;
+        default:
+            throw new Error(`unknown vector coord type: ${coordTag}`);
+    }
+    return { kind: "vector", dimension: dim, coordinateType, values };
+}
+function readBinary(r) {
+    const segCount = r.u32();
+    const segments = new Array(segCount);
+    let total = 0;
+    for (let i = 0; i < segCount; i++) {
+        const len = r.u32();
+        const seg = new Array(len);
+        for (let j = 0; j < len; j++)
+            seg[j] = r.bytes[r.off + j];
+        r.off += len;
+        segments[i] = seg;
+        total += len;
+    }
+    return { kind: "binary", length: total, segments };
+}
+const factoryCache = new Map();
+function rowFactory(columns) {
+    const key = columns.join("\x1f");
+    let factory = factoryCache.get(key);
+    if (factory)
+        return factory;
+    // Build:
+    //   function (read, r) {
+    //     const row = {};
+    //     row[colA] = read(r);
+    //     row[colB] = read(r);
+    //     return row;
+    //   }
+    const lines = ["const row = {};"];
+    for (const col of columns) {
+        lines.push(`row[${JSON.stringify(col)}] = read(r);`);
+    }
+    lines.push("return row;");
+    factory = new Function("read", "r", lines.join("\n"));
+    factoryCache.set(key, factory);
+    return factory;
+}
+/**
+ * Decode the wire format produced by `encode_rows` in the native crate
+ * into the public `{ columns, rows }` shape.
+ */
+export function decodeResult(buf) {
+    const r = new Reader(buf);
+    if (r.bytes[0] !== MAGIC_0 ||
+        r.bytes[1] !== MAGIC_1 ||
+        r.bytes[2] !== MAGIC_2 ||
+        r.bytes[3] !== MAGIC_3) {
+        throw new Error("lora-node: invalid result buffer magic");
+    }
+    r.off = 4;
+    const colCount = r.u32();
+    const columns = new Array(colCount);
+    for (let i = 0; i < colCount; i++)
+        columns[i] = r.str();
+    const rowCount = r.u32();
+    const rows = new Array(rowCount);
+    if (colCount === 0) {
+        for (let i = 0; i < rowCount; i++)
+            rows[i] = {};
+        return { columns, rows };
+    }
+    const factory = rowFactory(columns);
+    for (let i = 0; i < rowCount; i++) {
+        rows[i] = factory(readValue, r);
+    }
+    return { columns, rows };
+}
+//# sourceMappingURL=decode.js.map

package/dist/decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.js","sourceRoot":"","sources":["../ts/decode.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -18,15 +18,14 @@
 import type { LoraParams, LoraValue, QueryResult } from "./types.js";
 import { WasmDatabase } from "./loader-node.js";
 import type { WorkerDatabase } from "./worker-client.js";
-import type { WasmSnapshotSource } from "./snapshot.js";
+import type { WasmSnapshotByteOptions, WasmSnapshotLoadOptions, WasmSnapshotSource } from "./snapshot.js";
 export * from "./types.js";
 export { createWorkerDatabase, type WorkerDatabase, type WorkerLike, } from "./worker-client.js";
-export type { WasmSnapshotSaveFormat, WasmSnapshotSaveOptions, WasmSnapshotSource, } from "./snapshot.js";
+export type { WasmSnapshotByteOptions, WasmSnapshotCompression, WasmSnapshotEncryption, WasmSnapshotLoadOptions, WasmSnapshotPasswordParams, WasmSnapshotSaveFormat, WasmSnapshotSaveOptions, WasmSnapshotSource, } from "./snapshot.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.
+ * Metadata returned by `loadSnapshot`.
+ * Mirrors the Rust `SnapshotMeta` struct. WASM saves the database snapshot
+ * codec and accepts legacy store snapshots on load for compatibility.
  */
 export interface SnapshotMeta {
     formatVersion: number;
@@ -80,39 +79,30 @@ 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>;
     saveSnapshot(): Promise<Uint8Array>;
-    saveSnapshot(format: "binary"): Promise<Uint8Array>;
-    saveSnapshot(format: "base64"): Promise<string>;
-    saveSnapshot(format: "blob"): Promise<Blob>;
-    saveSnapshot(format: "download"): Promise<void>;
+    saveSnapshot(options: WasmSnapshotByteOptions): Promise<Uint8Array>;
     saveSnapshot(options: {
-        format: "binary";
-    }): Promise<Uint8Array>;
+        format?: "bytes";
+    } & WasmSnapshotByteOptions): Promise<Uint8Array>;
     saveSnapshot(options: {
-        format: "base64";
-    }): Promise<string>;
+        format: "arrayBuffer";
+    } & WasmSnapshotByteOptions): Promise<ArrayBuffer>;
     saveSnapshot(options: {
         format: "blob";
         mimeType?: string;
-    }): Promise<Blob>;
+    } & WasmSnapshotByteOptions): Promise<Blob>;
     saveSnapshot(options: {
-        format: "download";
-        filename?: string;
+        format: "response";
         mimeType?: string;
-    }): Promise<void>;
-    /**
-     * Replace the current graph state with a snapshot decoded from `bytes`.
-     * Returns metadata describing the restored snapshot.
-     */
-    loadSnapshotFromBytes(bytes: Uint8Array): Promise<SnapshotMeta>;
-    loadSnapshot(source: WasmSnapshotSource): Promise<SnapshotMeta>;
+    } & WasmSnapshotByteOptions): Promise<Response>;
+    saveSnapshot(options: {
+        format: "stream";
+    } & WasmSnapshotByteOptions): Promise<ReadableStream<Uint8Array>>;
+    saveSnapshot(options: {
+        format: "url";
+        mimeType?: string;
+    } & WasmSnapshotByteOptions): Promise<URL>;
+    loadSnapshot(source: WasmSnapshotSource, options?: WasmSnapshotLoadOptions): Promise<SnapshotMeta>;
     /** Release the underlying wasm handle. Subsequent calls will throw. */
     dispose(): void;
 }