codenotary / immudb / 29855643936

85%

master: 85%

Build Type

Pull #2112

gh-ci

Committed by vchaindz

Commit Message

feat(contrib): add immudb-wasm — embed immudb in Node via WASM/WASI

Compile the immudb engine to a single portable wasip1 .wasm and run it
in-process under Node's node:wasi — an append-only, cryptographically
verifiable KV + SQL store with no server, no container, and no native
prebuilds. This lets immudb-backed tools ship as pure JS + one .wasm.

Engine change (the only core diff): add a wasip1 variant of
embedded/appendable/fileutils (syncDir no-op, fdatasync -> f.Sync), the
sole package blocking GOOS=wasip1 builds of embedded/store & embedded/sql.

contrib/immudb-wasm (nested module, replace => ../../):
- wasm/: //go:wasmexport reactor over a small JSON byte-ABI, built on
  embedded/store + embedded/sql directly (no protobuf/grpc). verified_get
  reproduces the client-side inclusion + dual proof using store-native
  primitives.
- node/: node:wasi host with a single /data preopen, a synchronous
  better-sqlite3-style API, a single-writer lockfile, TS types, and a
  node:test suite.
- Makefile/scripts build the reactor; README documents the durability
  (no WASI dir-sync), single-writer, and performance trade-offs.

Verified: GOOS=wasip1 builds embedded/store & embedded/sql; core
go build ./... unaffected; make test builds immudb.wasm and passes 7
Node tests (KV, binary, scan, verifiedGet=true, SQL, reopen persistence,
lock); npm pack ships 5 files with zero native build on install. The
built .wasm is a gitignored artifact.

Licensed BUSL-1.1 (packages the immudb engine).

Pull Request Pull Request #2112: feat: embed immudb in-process — Go examples, immuledger plugin, and immudb-wasm (Node/WASM)

Coverage Stats

0 of 76 new or added lines in 1 file covered. (0.0%)

7 existing lines in 3 files now uncovered.

45228 of 53301 relevant lines covered (84.85%)

126265.54 hits per line