nedb-engine 2.0.36 → 2.2.3

package/README.md

@@ -19,9 +19,11 @@ One Rust core → ships to **PyPI** and **npm** from a single source.
 
 ---
 
-## v2 — The DAG Engine (current stable: 2.0.27)
+## NEDB v2.0.36 — Production Stable
 
-NEDB v2 replaces the append-only log (AOF) with a **content-addressed Merkle DAG**. Every document version is an immutable, BLAKE2b-verified object. Nothing is ever overwritten. As of **v2.0.27**, restarts after the first open are **O(1) warm starts** (driven by a `MANIFEST` of `seq` + Merkle head), the **cold scan is deferred** so the daemon accepts connections immediately, and a new **`GET /events` SSE endpoint** streams scan progress + per-write events live.
+**Current stable: 2.0.36** — Cross-platform native wheels shipping `nedbd-v2` binary inside `pip install nedb-engine`. Linux + Windows wheels built on GitHub Actions; macOS arm64 + x86_64 wheels built on Codemagic (M2 Mac Minis). All four platforms publish from one `v*` tag.
+
+NEDB v2 replaces the append-only log (AOF) with a **content-addressed Merkle DAG**. Every document version is an immutable, BLAKE2b-verified object. Nothing is ever overwritten. As of **v2.0.36**, restarts after the first open are **O(1) warm starts** (driven by a `MANIFEST` of `seq` + Merkle head), the **cold scan is deferred** so the daemon accepts connections immediately, and a new **`GET /events` SSE endpoint** streams scan progress + per-write events live.
 
 ```bash
 # Run the v2 DAG engine — ships inside pip install nedb-engine
@@ -30,9 +32,9 @@ nedbd --dag --data ./data
 NEDBD_DAG=1 NEDB_TMK=<32-byte-hex> nedbd --data ./data
 
 curl http://127.0.0.1:7070/health
-# {"ok":true,"version":"2.0.27","service":"nedbd","engine":"dag","startup_ready":true,"encrypted":true}
+# {"ok":true,"version":"2.0.36","service":"nedbd","engine":"dag","startup_ready":true,"encrypted":true}
 
-# Tail the live event stream (new in v2.0.27)
+# Tail the live event stream (new in v2.0.36)
 curl http://127.0.0.1:7070/events
 # event: scan   data: {"objects":730000,"of":1310703,"rate":21043,"eta_s":28}
 # event: ready  data: {"seq":1310703,"head":"b2:9c14e07a…"}
@@ -56,7 +58,7 @@ curl http://127.0.0.1:7070/events
 
 **v1 AOF engine is still shipped and unchanged** — `nedbd` (no flag) runs v1.
 
-**Production status:** [vision.interchained.org](https://vision.interchained.org) is live on v2.0.27 — **1,310,703 sequences** indexed in the Vision database, AES-256-GCM encrypted at rest, at block height **620,989**.
+**Production status:** [vision.interchained.org](https://vision.interchained.org) is live on v2.0.36 — **1,310,703 sequences** indexed in the Vision database, AES-256-GCM encrypted at rest, at block height **620,989**.
 
 ---
 
@@ -221,11 +223,11 @@ nedbd --dag --data ./data                 # v2 DAG engine (or NEDBD_DAG=1)
 NEDBD_RESP2_PORT=6380 nedbd               # also speak RESP2 (redis-cli compatible)
 nedbd --log-level 2                       # 0=errors 1=requests 2=deploy 3=verbose
 
-# Live event stream (new in v2.0.27) — SSE: scan progress, ready, per-write head
+# Live event stream (new in v2.0.36) — SSE: scan progress, ready, per-write head
 curl http://127.0.0.1:7070/events
 ```
 
-### Startup modes (v2.0.27)
+### Startup modes (v2.0.36)
 
 - **Warm start** — every restart after the first open reads the `MANIFEST` file and restores `seq` + Merkle `head` in **O(1)**. No scan, no replay, independent of dataset size. Boots in milliseconds.
 - **Cold start** — first open of an existing dataset spawns the integrity scan in a background thread *and accepts connections immediately*. Reads serve instantly from the content-addressed DAG; writes return `HTTP 503 startup in progress` until the `startup_ready` gate flips. Progress (objects, rate, ETA) streams over `GET /events`.
@@ -235,7 +237,7 @@ curl http://127.0.0.1:7070/events
 | Variable | Default | Description |
 |---|---|---|
 | `NEDBD_DAG` | `0` | Set `1` to launch the v2 DAG engine (`nedbd-v2`). Same as `--dag`. |
-| `NEDBD_HOST` | `127.0.0.1` | Bind address. **v2.0.27** defaults to loopback (was `0.0.0.0`) — security hardening fix. Set explicitly to `0.0.0.0` to expose. |
+| `NEDBD_HOST` | `127.0.0.1` | Bind address. **v2.0.36** defaults to loopback (was `0.0.0.0`) — security hardening fix. Set explicitly to `0.0.0.0` to expose. |
 | `NEDBD_PORT` | `7070` | HTTP bind port. |
 | `NEDBD_TOKEN` | unset | Optional bearer token; required on every `/v1/*` request when set. |
 | `NEDB_TMK` | unset | 32-byte hex AES-256-GCM at-rest encryption key. |
@@ -298,7 +300,7 @@ db.query('FROM policy AS OF 200 VALID AS OF "2024-02-15"')
 
 ## Performance
 
-**v2 DAG Rust server (v2.0.27, Intel iMac — 10k writes / 100k reads / 30k objects, AES-256-GCM on):**
+**v2 DAG Rust server (v2.0.36, Intel iMac — 10k writes / 100k reads / 30k objects, AES-256-GCM on):**
 
 | Operation | Throughput | p50 | p99 |
 |---|---|---|---|

package/index.d.ts

@@ -4,28 +4,26 @@
 /* auto-generated by NAPI-RS */
 
 export declare class NedbCore {
-  /** Create an in-memory database. */
+  /** Create an in-memory v2 DAG database — zero disk I/O. */
   constructor()
-  /** Open a durable database at `path` (AOF persistence). */
+  /**
+   * Open a durable v2 DAG database at `path`.
+   * Automatically migrates v1 AOF → v2 DAG on first open.
+   */
   static open(path: string): NedbCore
   createIndex(coll: string, field: string, kind: string): void
-  /** Auto-nonce put. `doc_json` is a JSON object string. Returns the stored doc. */
+  /** Put a document. Returns the stored doc as a JSON string. */
   put(coll: string, id: string, docJson: string): string
-  /** Full put with optional client / nonce / idempotency key. */
+  /** Full put with optional client / nonce — API compat, v2 ignores these. */
   putEx(coll: string, id: string, docJson: string, client?: string | undefined | null, nonce?: bigint | undefined | null, idem?: string | undefined | null): string
   delete(coll: string, id: string): void
   deleteEx(coll: string, id: string, client?: string | undefined | null, nonce?: bigint | undefined | null, idem?: string | undefined | null): void
+  /** Link: stored as a doc in __links__ collection for NQL traversal. */
   link(frm: string, rel: string, to: string): void
   unlink(frm: string, rel: string, to: string): void
   get(coll: string, id: string): string | null
-  /** Time-travel: return the document as it was at sequence `as_of`. */
   getAsOf(coll: string, id: string, asOf: bigint): string | null
-  /**
-   * Execute an NQL query string. Returns an array of JSON document strings.
-   * Full grammar supported: WHERE, ORDER BY, LIMIT, GROUP BY, TRAVERSE,
-   * SEARCH, AS OF, VALID AS OF, TRACE caused_by.
-   */
-  query(nql: string): Array<string>
+  query(nqlStr: string): Array<string>
   neighbors(frm: string, rel: string): Array<string>
   neighborsAsOf(frm: string, rel: string, asOf: bigint): Array<string>
   inbound(to: string, rel: string): Array<string>
@@ -33,5 +31,6 @@ export declare class NedbCore {
   verify(): boolean
   head(): string
   seq(): bigint
+  /** Flush WAL and MANIFEST — v2 equivalent of v1 flush(). */
   flush(): void
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nedb-engine",
-  "version": "2.0.36",
+  "version": "2.2.3",
   "description": "NEDB — hash-chained, time-traveling, bi-temporal embedded database with Rust native core. SQL, Redis, MongoDB adapters. Causal Write Provenance. RESP2 wire protocol.",
   "main": "index.js",
   "types": "index.d.ts",
@@ -12,10 +12,10 @@
     "LICENSE"
   ],
   "license": "GPL-3.0-or-later",
-  "homepage": "https://github.com/Eth-Interchained/nedb#readme",
+  "homepage": "https://github.com/aiassistsecure/nedb#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Eth-Interchained/nedb.git"
+    "url": "git+https://github.com/aiassistsecure/nedb.git"
   },
   "keywords": [
     "database",