nedb-engine 2.8.5 → 3.0.0

package/LICENSE

@@ -1,65 +1,21 @@
-Business Source License 1.1
-
-Licensor: Interchained LLC, VibeCode 101, and/or the applicable copyright holders of NEDB
-
-Licensed Work: NEDB, including all source code, documentation, examples, tests, build scripts, specifications, APIs, SDKs, packages, binaries, and derivative works distributed from or based on the NEDB repository.
-
-Copyright: Copyright (c) 2026 Interchained LLC, VibeCode 101, and contributors. All rights reserved.
-
-Change Date: Four years after the first publicly available distribution of each specific version of the Licensed Work under this License.
-
-Change License: GNU Affero General Public License v3.0 or later.
-
-Additional Use Grant:
-
-You may use the Licensed Work only for non-production purposes, including evaluation, development, testing, research, local experimentation, security review, benchmarking, and personal learning.
-
-No production use is granted automatically.
-
-For clarity, the following uses are not permitted unless you have prior written permission from the Licensor:
-
-1. Using the Licensed Work in production.
-2. Using the Licensed Work to store, process, serve, index, replicate, query, or manage production data.
-3. Offering the Licensed Work, or any derivative work, as a hosted, managed, embedded, bundled, white-labeled, commercial, paid, revenue-generating, or customer-facing product or service.
-4. Offering database-as-a-service, storage-as-a-service, cache-as-a-service, search-as-a-service, analytics-as-a-service, AI-memory-as-a-service, agent-memory-as-a-service, blockchain-indexing-as-a-service, or any substantially similar service using the Licensed Work.
-5. Using the Licensed Work to compete with NEDB, Interchained LLC, VibeCode 101, AiAssist Secure, or any affiliated product, service, infrastructure platform, database engine, AI runtime, agent platform, or hosted developer infrastructure.
-6. Embedding the Licensed Work into commercial software, SaaS products, internal business systems, enterprise systems, hosted infrastructure, blockchain infrastructure, AI-agent infrastructure, or customer deliverables.
-7. Removing, hiding, modifying, or misrepresenting this License, copyright notices, attribution notices, authorship notices, repository references, or licensing notices.
-8. Circumventing license checks, access controls, paid licensing requirements, commercial-use restrictions, attribution requirements, or technical protections included with the Licensed Work.
-9. Using the Licensed Work in a way that implies endorsement, partnership, sponsorship, certification, or approval by the Licensor without written permission.
-10. Reselling, relicensing, sublicensing, renting, leasing, or otherwise commercially exploiting the Licensed Work except as expressly authorized in writing.
-
-Additional production, commercial, hosted, enterprise, embedded, OEM, resale, white-label, managed-service, competitive, or otherwise restricted use grants are available only by separate written permission from the Licensor.
-
-Written permission must be obtained from at least one of the following authorized licensing contacts:
-
-[founders@vibecode-101.com](mailto:founders@vibecode-101.com)
-[dev@interchained.org](mailto:dev@interchained.org)
-
-Permission is valid only if it is expressly granted in writing by an authorized representative of the Licensor and specifically identifies the permitted use, scope, duration, parties, and any applicable commercial terms.
-
-A general email conversation, informal message, pull request, issue comment, social media message, verbal discussion, repository access, package download, or contribution acceptance does not create a production, commercial, hosted, enterprise, resale, or competitive use license.
-
-Terms:
-
-The Licensor hereby grants you the right to copy, modify, create derivative works, redistribute, and make non-production use of the Licensed Work. The Licensor may make an Additional Use Grant, above, permitting limited production use.
-
-Effective on the Change Date, or the fourth anniversary of the first publicly available distribution of a specific version of the Licensed Work under this License, whichever comes first, the Licensor hereby grants you rights under the terms of the Change License, and the rights granted in the paragraph above terminate.
-
-If your use of the Licensed Work does not comply with the requirements currently in effect as described in this License, you must purchase or obtain a separate commercial license from the Licensor, its affiliated entities, or authorized resellers, or you must refrain from using the Licensed Work.
-
-All copies of the original and modified Licensed Work, and derivative works of the Licensed Work, are subject to this License. This License applies separately for each version of the Licensed Work, and the Change Date may vary for each version of the Licensed Work released by Licensor.
-
-You must conspicuously display this License on each original or modified copy of the Licensed Work. If you receive the Licensed Work in original or modified form from a third party, the terms and conditions set forth in this License apply to your use of that work.
-
-Any use of the Licensed Work in violation of this License will automatically terminate your rights under this License for the current and all other versions of the Licensed Work.
-
-This License does not grant you any right in any trademark, service mark, trade name, logo, domain name, brand identity, product name, project name, or other identifier of Licensor or its affiliates, except as expressly required to preserve legally required notices.
-
-TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN “AS IS” BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, TITLE, SECURITY, ACCURACY, AVAILABILITY, DATA INTEGRITY, PERFORMANCE, AND FITNESS FOR PRODUCTION USE.
-
-TO THE EXTENT PERMITTED BY APPLICABLE LAW, LICENSOR SHALL NOT BE LIABLE FOR ANY CLAIM, DAMAGES, LOSSES, COSTS, EXPENSES, BUSINESS INTERRUPTION, LOST PROFITS, LOST REVENUE, LOST DATA, SECURITY INCIDENTS, SERVICE OUTAGES, OR OTHER LIABILITY ARISING FROM OR RELATED TO THE LICENSED WORK OR YOUR USE OF THE LICENSED WORK.
-
-Notice:
-
-The Business Source License is not an Open Source license. However, each version of the Licensed Work will become available under the Change License on the applicable Change Date, or on the fourth anniversary of the first publicly available distribution of that version under this License, whichever comes first.
+MIT License
+
+Copyright (c) 2026 Interchained LLC and VibeCode 101
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -13,13 +13,96 @@ One Rust core → ships to **PyPI** and **npm** from a single source.
 [![CI](https://img.shields.io/github/actions/workflow/status/Eth-Interchained/nedb/release.yml?label=CI&color=34d399)](https://github.com/Eth-Interchained/nedb/actions)
 [![nedb-engine-client PyPI](https://img.shields.io/pypi/v/nedb-engine-client?label=nedb-engine-client&color=34d399)](https://pypi.org/project/nedb-engine-client/)
 [![nedb-engine-client npm](https://img.shields.io/npm/v/nedb-engine-client?label=nedb-engine-client&color=34d399)](https://www.npmjs.com/package/nedb-engine-client)
+[![License: MIT](https://img.shields.io/badge/license-MIT-22c55e?logo=opensourceinitiative&logoColor=white)](https://github.com/Eth-Interchained/nedb/blob/master/LICENSE)
 
 **[Studio → studio.interchained.org](https://studio.interchained.org)**  ·  **[nedb.aiassist.net](https://nedb.aiassist.net)**
 
+> ## 🟢 MIT Licensed — free for any use, including commercial & production
+> NEDB is licensed under the **MIT License** — use it in production, embed it in commercial
+> products, ship it in closed-source software, fork it, sell it. No restrictions, no royalties,
+> no copyleft. See [`LICENSE`](LICENSE). The database is free; the moat is what you build on it.
+
 </div>
 
 ---
 
+## ⚠️ New in 2.8.6 — Durability & Recovery (read this if you store anything you care about)
+
+Three defects found by killing a real engine at every persistence boundary and by filling a real
+filesystem to zero free blocks. All three are fixed. **If you are on 2.8.5 or earlier, upgrade.**
+
+### 1. A failed flush silently discarded acknowledged writes
+
+`IdIndex::flush_write_buf` cleared every buffered entry regardless of whether its disk write
+succeeded. So a flush that hit `ENOSPC` threw the entry away, and no later flush retried it.
+
+Reproduced on a full 22 MiB filesystem: **30 rows acknowledged by `put() -> Ok`, then `list()`
+returned 0 after reopen — while `verify()` reported all 30 objects healthy.** The content-addressed
+objects were durable; the id-index entries that make them findable were gone.
+
+```
+before:  try_flush_all() -> (no return value)      reopen -> 0 rows, verify() = 30 ok
+after:   try_flush_all() -> Err("id-index leaf rows/buf_25: No space left on device (os error 28)")
+         ...free space, retry -> Ok                reopen -> 30 rows
+```
+
+**Fixed:** an entry leaves the WAL only when its write actually landed. Failures stay buffered and
+retry on the next flush.
+
+### 2. Flush errors were unobservable — new `try_flush_all()`
+
+`flush_all()` returns `()` and logged fsync failures to stderr, so a caller could not tell a durable
+flush from a failed one. Anything that takes a destructive or externally-visible action on the
+strength of a persisted record needs to know.
+
+```rust
+// Use this when the outcome matters:
+db.try_flush_all()?;      // Result<()> — id-index WAL + segment sync + MANIFEST
+
+// Still available, still logs, nowhere to propagate (ticker / Drop):
+db.flush_all();
+```
+
+Also new: `Db::try_flush_manifest()` and `IdIndex::try_flush_write_buf()`.
+
+### 3. `repair` could not repair, and `since()` claimed "caught up" while behind
+
+The cold scan rebuilt `seq_index`, per-collection tips, the Merkle head and `MANIFEST` — but **never
+the id index**. A database whose WAL never reached disk came back with every object verifying and
+`list()` empty, and `nedb-cli repair` printed success without fixing it, because
+`start_cold_scan()` is a deliberate no-op on a warm store.
+
+```bash
+nedb-cli repair ./data
+# repaired: 203 id-index entr(ies) rebuilt, 203 node(s) verified, flushed
+```
+
+```rust
+let restored = db.repair()?;   // rebuild id index from objects; highest seq wins
+```
+
+Every object carries its own `coll`, `id` and `seq`, so the id index is fully derivable — a lost WAL
+is recoverable and nothing is invented. `repair()` also recomputes head and tips, so a repaired
+database reopens **warm** instead of coming back up cold with an empty head.
+
+Separately, `since()` set `has_more = hit_limit` alone. On a warm boot the seq index is empty **by
+design** (that is why warm start is O(1)), so every lookup missed and `since()` returned zero nodes
+with `has_more = false` — indistinguishable from genuinely up to date. A consumer following the
+documented drain loop stopped one call in, with every record unread.
+
+**Fixed:** `has_more` is true whenever the cursor is behind the log head. `ScanStatus` gains
+**`seq_index_ready`** — replication consumers should gate on that, not on `scan_complete`, which is
+true on a warm boot precisely because the scan was skipped.
+
+### Known sharp edge (documented, not changed)
+
+`since()`'s cursor is **exclusive** and seqs start at 0, so `since(0, _)` returns `(0, head]` and the
+very first write in a database (seq 0) is unreachable through any cursor value. Ten writes drain as
+nine records. Changing the convention would break existing consumers; a replica seeded from
+`since()` alone starts one record short.
+
+---
+
 ## NEDB v2.8.0 — Production Stable
 
 **Current stable: 2.8.0** — NEDB ships as **three version-aligned distributions** on one tag — `nedb-engine` (flagship), `crypto-database` (verifiable v2/v3 DAG), and `aof-db` (fast append-only) — across npm / PyPI / crates.io with full mac + linux + windows native addons (see [**Releasing**](#releasing) below). All native wheels (Linux + Windows on GitHub Actions; macOS arm64 + x86_64 on Codemagic M2 Mac Minis) **plus** the universal pure-Python wheel ship from a single `v*` tag, with the `nedbd-v2` binary bundled inside `pip install nedb-engine`.
@@ -822,7 +905,8 @@ Requires `GITHUB_TOKEN` (`repo` + `workflow` scope) in the environment. It never
 
 ## License
 
-See `LICENSE` file. · © INTERCHAINED, LLC — [interchained.org](https://interchained.org)
+**MIT License** — free for any use, including commercial and production. See [`LICENSE`](LICENSE).
+© 2026 INTERCHAINED LLC — [interchained.org](https://interchained.org)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nedb-engine",
-  "version": "2.8.5",
+  "version": "3.0.0",
   "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",
@@ -23,7 +23,7 @@
     "README.md",
     "LICENSE"
   ],
-  "license": "GPL-3.0-or-later",
+  "license": "MIT",
   "homepage": "https://github.com/aiassistsecure/nedb#readme",
   "repository": {
     "type": "git",