@harperfast/rocksdb-js 2.4.1 → 2.6.0

package/docs/backups.md

@@ -73,6 +73,13 @@ await backups.delete('/path/to/backups', id); // remove one backup
 await backups.purge('/path/to/backups', 3); // keep the newest 3
 ```
 
+`backups.verify` also validates the backup's transaction log snapshot when one was captured
+(`transactionLogs: true`): every log file's header and entry framing must be intact, in strict mode
+(snapshots are copied on committed entry boundaries, so even a recoverable torn tail fails
+verification). Pass `verifyTransactionLogs: false` to check only the RocksDB files. Standalone
+stores (e.g. the `transaction_logs` directory of a closed database) can be validated directly with
+`validateTransactionLogStore()`.
+
 ### Restoring
 
 ```typescript
@@ -96,6 +103,14 @@ Restore modes:
 - **`verifyChecksum`**: reuse existing destination files whose checksums match the backup, replacing
   only mismatched/corrupt files.
 
+Restore reads the backup directory and holds its lock in shared mode, so multiple restores run
+concurrently but a writer (`db.backup()` / `delete` / `purge`) and a restore exclude each other.
+Because the restore only reads, the source may be a **read-only backup directory** — an
+immutable/WORM store or a read-only-mounted volume — even though writers require a writable one. The
+lock is taken read-only on the existing lock file; if the media is read-only for every process it
+degrades to a no-op (no writer can be racing), but a plain permission denial fails loudly rather than
+skip coordination, since a more-privileged writer could still be active.
+
 ### Caveats
 
 - **The data is duplicated onto local disk.** A backup is a real, separate copy in the backup

package/docs/stats.md

@@ -34,6 +34,8 @@ By default, `db.getStats()` returns properties only.
 
 | Name                                        | Description                                                                                                                                                                                                                   | Type   |
 | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
+| `commitPipeline.commitQueueDepth`           | Number of async commits queued on the database's commit lane but not yet started (in the default single-lane mode this covers the whole commit: log write + RocksDB commit).                                                  | gauge  |
+| `commitPipeline.logQueueDepth`              | Number of async commits queued on the database's transaction-log lane but not yet started (always `0` in the default single-lane mode; see `ROCKSDB_JS_COMMIT_THREAD=2`).                                                     | gauge  |
 | `rocksdb.block-cache-capacity`              | Capacity in bytes of the block cache.                                                                                                                                                                                         | gauge  |
 | `rocksdb.block-cache-pinned-usage`          | Bytes occupied by pinned block cache entries.                                                                                                                                                                                 | gauge  |
 | `rocksdb.block-cache-usage`                 | Bytes currently used by block cache entries.                                                                                                                                                                                  | gauge  |

package/docs/transaction-log.md

@@ -206,6 +206,16 @@ await db.transaction((txn) => {
 - Commit with unknown transaction ID throws an error
 - Invalid data is detected during read operations
 
+### Validation
+
+A store directory can be validated offline with `validateTransactionLogStore(path, options?)`: it
+checks every log file's header (token, version) and entry framing using the same scan as open-time
+crash recovery, plus file-name/sequence continuity and the `txn.state` side file. A torn tail,
+sequence gap, or implausible `txn.state` position is a warning by default (a torn tail is
+recoverable — open-time recovery truncates it losslessly) and an error with `{ strict: true }`,
+which `backups.verify()` uses for backup snapshots since an intact snapshot can have none of them.
+The CLI exposes the same check as `verify-logs [name]`.
+
 ## Reading The Transaction Log
 
 Log entries are not guaranteed to be in order, but are guaranteed to have a monotonic timestamp.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harperfast/rocksdb-js",
-  "version": "2.4.1",
+  "version": "2.6.0",
   "description": "RocksDB binding for Node.js",
   "homepage": "https://github.com/HarperFast/rocksdb-js",
   "bugs": [
@@ -38,33 +38,33 @@
   },
   "devDependencies": {
     "@rollup/plugin-replace": "6.0.3",
-    "@types/node": "26.1.0",
+    "@types/node": "26.1.2",
     "@vitest/coverage-v8": "4.1.10",
     "cross-env": "10.1.0",
     "dotenv": "17.4.2",
-    "lefthook": "2.1.9",
+    "lefthook": "2.1.10",
     "lmdb": "3.5.6",
     "node-gyp": "13.0.1",
-    "oxfmt": "0.58.0",
-    "oxlint": "1.73.0",
+    "oxfmt": "0.60.0",
+    "oxlint": "1.75.0",
     "prebuildify": "6.0.1",
     "semver": "7.8.5",
-    "tar": "7.5.19",
-    "tsdown": "0.22.3",
+    "tar": "7.5.22",
+    "tsdown": "0.22.14",
     "tslib": "2.8.1",
-    "tsx": "4.23.0",
-    "typescript": "6.0.3",
+    "tsx": "4.23.1",
+    "typescript": "7.0.2",
     "vitest": "4.1.10"
   },
   "optionalDependencies": {
-    "@harperfast/rocksdb-js-darwin-arm64": "2.4.1",
-    "@harperfast/rocksdb-js-darwin-x64": "2.4.1",
-    "@harperfast/rocksdb-js-linux-arm64-glibc": "2.4.1",
-    "@harperfast/rocksdb-js-linux-arm64-musl": "2.4.1",
-    "@harperfast/rocksdb-js-linux-x64-glibc": "2.4.1",
-    "@harperfast/rocksdb-js-linux-x64-musl": "2.4.1",
-    "@harperfast/rocksdb-js-win32-arm64": "2.4.1",
-    "@harperfast/rocksdb-js-win32-x64": "2.4.1"
+    "@harperfast/rocksdb-js-darwin-arm64": "2.6.0",
+    "@harperfast/rocksdb-js-darwin-x64": "2.6.0",
+    "@harperfast/rocksdb-js-linux-arm64-glibc": "2.6.0",
+    "@harperfast/rocksdb-js-linux-arm64-musl": "2.6.0",
+    "@harperfast/rocksdb-js-linux-x64-glibc": "2.6.0",
+    "@harperfast/rocksdb-js-linux-x64-musl": "2.6.0",
+    "@harperfast/rocksdb-js-win32-arm64": "2.6.0",
+    "@harperfast/rocksdb-js-win32-x64": "2.6.0"
   },
   "engines": {
     "node": "^22.18.0 || >=24.0.0"