@harperfast/rocksdb-js 2.12.0 → 2.13.0

package/docs/performance/mutex-contention.md

@@ -171,11 +171,12 @@ A separate native reproduction confirmed [#860](https://github.com/HarperFast/ro
 `tryClose()` releases its written-position lock before latching admission closed.
 A transaction can bind, finish `writeBatch()` and reduce the pending count back to zero
 between those checks. A temporary scheduling hook before phase 3 reproduced
-`pending=0`, one real uncommitted position, and `tryClose() == true`. This is a
+`pending=0`, one real uncommitted position, and `tryClose() == true`. This was a
 pre-existing close-protocol defect, not fixed by the completion-lock change. Its
 production trigger is a concurrent destructive log purge; no customer incident or
-JavaScript-level data loss was reproduced. Keep the binding lock until a separately
-reviewed admission/drain fix resolves that handoff.
+JavaScript-level data loss was reproduced. It is now fixed without changing the binding
+lock: every bind advances a generation that `tryClose()` rechecks before latching (see
+"Conditional close" in `src/binding/transaction_log/DESIGN.md`).
 
 The investigation also found [#859](https://github.com/HarperFast/rocksdb-js/issues/859):
 the DB-instance stress test awaits an empty promise array in its worker-close phase.

package/docs/stats.md

@@ -189,6 +189,10 @@ which includes all of the stats above plus the following:
 | `rocksdb.blobdb.gc.num.new.files`                                  | Number of new blob files generated by garbage collection (legacy stacked BlobDB).                                                             | ticker    |
 | `rocksdb.blobdb.get.micros`                                        | Distribution of `Get()` latencies (microseconds) (legacy stacked BlobDB).                                                                     | histogram |
 | `rocksdb.blobdb.key.size`                                          | Distribution of key sizes for BlobDB operations.                                                                                              | histogram |
+| `rocksdb.blobdb.lazy.partial.bytes.saved`                          | Bytes not read from blob files thanks to partial (byte-range) lazy reads: the value size minus the bytes actually read.                       | ticker    |
+| `rocksdb.blobdb.lazy.partial.read.count`                           | Number of lazy blob reads that read only a byte range of an uncompressed blob value.                                                          | ticker    |
+| `rocksdb.blobdb.lazy.read.bytes`                                   | Bytes read from storage while resolving lazy wide-column results (`GetEntityLazy`/`MultiGetEntityLazy`).                                      | ticker    |
+| `rocksdb.blobdb.lazy.read.count`                                   | Number of storage reads issued while resolving lazy wide-column results (`GetEntityLazy`/`MultiGetEntityLazy`).                               | ticker    |
 | `rocksdb.blobdb.multiget.micros`                                   | Distribution of `MultiGet()` latencies (microseconds) (legacy stacked BlobDB).                                                                | histogram |
 | `rocksdb.blobdb.next.micros`                                       | Distribution of iterator `Next()` latencies (microseconds) (legacy stacked BlobDB).                                                           | histogram |
 | `rocksdb.blobdb.num.get`                                           | Number of `Get()` calls (legacy stacked BlobDB).                                                                                              | ticker    |

package/docs/steady-clock-design.md

@@ -87,7 +87,7 @@ separate properties. No promise is made that runtime timers use the same suspend
 ## Verification
 
 The end-to-end route is the real N-API export through `src/index.ts`, parent/worker bracketing on
-Node, Bun and Deno, staggered/restarted and concurrent workers (including `workerFirst >= parentBefore + stagger - tolerance`), elapsed
+Node and Bun (Deno: local `pnpm test:deno` only, #947), staggered/restarted and concurrent workers (including `workerFirst >= parentBefore + stagger - tolerance`), elapsed
 progression, and built ESM/CJS
 exports. Temporarily substituting a worker-local clock must make those brackets fail, proving
 they reject the motivating defect.

package/docs/transaction-log.md

@@ -58,7 +58,7 @@ The token is used to validate that the file is indeed a transaction log.
 
 #### `version`
 
-The transaction log file format version. Currently, version `1` is the latest.
+The transaction log file format version. Currently, version `1` is the latest. Opening a database whose newest transaction-log segments include one with a higher version (written by a newer release) fails with an error naming the segment, rather than skipping it, and this release never appends after such a segment. A malformed or unreadable segment is still skipped.
 
 #### `timestamp`
 
@@ -84,9 +84,10 @@ The size of the data entry directly following the transaction header.
 
 Transaction entry related flags.
 
-| Flag                              | Value  | Description                                |
-| --------------------------------- | ------ | ------------------------------------------ |
-| `TRANSACTION_LOG_ENTRY_LAST_FLAG` | `0x01` | Indicates the last entry for a transaction |
+| Flag                                 | Value  | Description                                                                                         |
+| ------------------------------------ | ------ | --------------------------------------------------------------------------------------------------- |
+| `TRANSACTION_LOG_ENTRY_LAST_FLAG`    | `0x01` | Indicates the last entry for a transaction                                                          |
+| `TRANSACTION_LOG_ENTRY_ABORTED_FLAG` | `0x02` | On a transaction's first entry: the transaction did not commit, and readers skip all of its entries |
 
 ## Encoding Details
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harperfast/rocksdb-js",
-  "version": "2.12.0",
+  "version": "2.13.0",
   "description": "RocksDB binding for Node.js",
   "homepage": "https://github.com/HarperFast/rocksdb-js",
   "bugs": [
@@ -41,36 +41,36 @@
     "@types/node": "26.6.5",
     "@vitest/coverage-v8": "4.1.11",
     "cross-env": "10.1.0",
-    "dotenv": "18.0.7",
-    "lefthook": "2.2.1",
-    "lmdb": "3.5.7",
+    "dotenv": "18.0.9",
+    "lefthook": "2.2.2",
+    "lmdb": "3.5.9",
     "node-gyp": "13.1.0",
-    "oxfmt": "0.72.0",
-    "oxlint": "1.87.0",
+    "oxfmt": "0.75.0",
+    "oxlint": "1.90.0",
     "prebuildify": "6.0.1",
     "semver": "7.8.5",
     "tar": "7.5.22",
-    "tsdown": "0.23.1",
+    "tsdown": "0.23.3",
     "tslib": "2.8.1",
     "typescript": "7.0.2",
     "vitest": "4.1.11"
   },
   "optionalDependencies": {
-    "@harperfast/rocksdb-js-darwin-arm64": "2.12.0",
-    "@harperfast/rocksdb-js-darwin-x64": "2.12.0",
-    "@harperfast/rocksdb-js-linux-arm64-glibc": "2.12.0",
-    "@harperfast/rocksdb-js-linux-arm64-musl": "2.12.0",
-    "@harperfast/rocksdb-js-linux-x64-glibc": "2.12.0",
-    "@harperfast/rocksdb-js-linux-x64-musl": "2.12.0",
-    "@harperfast/rocksdb-js-win32-arm64": "2.12.0",
-    "@harperfast/rocksdb-js-win32-x64": "2.12.0"
+    "@harperfast/rocksdb-js-darwin-arm64": "2.13.0",
+    "@harperfast/rocksdb-js-darwin-x64": "2.13.0",
+    "@harperfast/rocksdb-js-linux-arm64-glibc": "2.13.0",
+    "@harperfast/rocksdb-js-linux-arm64-musl": "2.13.0",
+    "@harperfast/rocksdb-js-linux-x64-glibc": "2.13.0",
+    "@harperfast/rocksdb-js-linux-x64-musl": "2.13.0",
+    "@harperfast/rocksdb-js-win32-arm64": "2.13.0",
+    "@harperfast/rocksdb-js-win32-x64": "2.13.0"
   },
   "engines": {
     "node": "^22.18.0 || >=24.0.0"
   },
   "gypfile": true,
   "rocksdb": {
-    "version": "11.8.1"
+    "version": "11.12.0"
   },
   "scripts": {
     "bench": "cross-env CI=1 node --expose-gc ./node_modules/vitest/vitest.mjs bench --passWithNoTests --outputJson benchmark-results.json",