@blamejs/core 0.15.8 → 0.15.9

package/CHANGELOG.md

@@ -8,6 +8,8 @@ upgrading across more than a few patches at a time.
 
 ## v0.15.x
 
+- v0.15.9 (2026-06-13) — **Raises the Node floor to 24.16, adds SQLite parse-time resource caps, retries Windows rename locks on every atomic write and download, and ships a one-call secure logout that wipes client-side state.** This release moves the engines floor to the current Node 24 LTS patch level and adds three hardening primitives. node:sqlite handles now construct with SQLITE_LIMIT_* caps: a statement over 1 MiB is rejected at parse time (a DoS floor on the raw-SQL surface, complementary to the existing row-count gate) and ATTACH DATABASE is denied. Every final temp-to-destination rename — the file written by an atomic write, a downloaded file, a sealed vault key, a rotated log, an extracted archive entry — now routes through a single retry that rides out a transient Windows lock (antivirus, the search indexer, or a file-sync client briefly holding the destination), instead of surfacing the lock as a hard failure; the retry, previously hand-rolled and unreachable, is now the reusable b.atomicFile.renameWithRetry. And b.session.logout destroys a session and tells the browser to wipe its client-side state in one call: it emits an RFC 9527 Clear-Site-Data header and expires the session cookie before destroying the row, the secure-default logout that previously had to be assembled by hand. **Added:** *b.session.logout — one-call secure logout* — `b.session.logout(res, token, opts?)` destroys the server-side session AND tells the browser to wipe its client-side state in one call: it emits an RFC 9527 Clear-Site-Data response header (cookies + storage + cache + execution contexts by default) and expires the session cookie, then destroys the session row. `b.session.destroy` alone is a store operation with no response object, so it could not wipe the browser's cached pages, storage, or a stale tab still holding the now-revoked cookie — that wiring previously had to be mounted by hand. Pass `cookieName` to match a non-default cookie and `types` to choose the Clear-Site-Data directives. **Changed:** *Node engines floor raised to >=24.16.0* — The minimum supported Node is now 24.16.0 (the current Node 24 LTS patch level), up from 24.14.1. This is an LTS-currency bump — there are no Node CVE fixes between 24.14.1 and 24.16.0 (24.14.1 already carried the CVE-2026-21713 HMAC fix); it keeps the framework on the latest patched LTS and makes the node:sqlite resource-cap hardening below available everywhere. Pre-1.0, operators upgrade across the floor; Node 26 continues to satisfy it. **Fixed:** *b.watcher canonicalizes its root on Windows* — `b.watcher.create` now resolves its `root` to the real long path before watching. On Windows a root with an 8.3 short-name component (the system temp directory commonly resolves to one) made the native recursive backend deliver long-name event paths that no longer prefix-matched the watched root, which could abort the process under a strict libuv fs-event assertion. The watcher now canonicalizes the root (expanding short names and resolving symlinks), so events match the watched directory on Windows. **Security:** *SQLite parse-time statement-size cap* — Every node:sqlite database the framework opens — the main db handle and the CLI's handle — now constructs with a SQLITE_LIMIT_LENGTH cap: a SQL statement over 1 MiB is rejected at parse time. Because the query builder parameterizes every value, the size cap guards the raw-SQL surface (`b.db.runSql`) against an attacker-influenced megaquery the parser would otherwise process (SQLite's default is 1 GB); it is a parse-time DoS floor complementary to the existing row-count gate. Legitimate framework and operator statements are far under the cap. · *Windows rename-lock retry on every atomic rename and download* — On Windows a freshly-written file's destination is briefly held by antivirus, the search indexer, or a file-sync client (Dropbox, OneDrive), surfacing as a transient EPERM / EACCES / EBUSY on rename even though the temp file is fine. `b.atomicFile.writeSync` already retried this, but `b.httpClient.downloadStream` did not — a download into a cloud-synced or AV-scanned directory could fail hard on the lock. The retry is now the reusable `b.atomicFile.renameWithRetry`, and every final temp-to-destination rename in the framework routes through it: downloads, sealed vault keys, CA key/cert writes, log rotation, archive extraction, config-drift sidecars, the self-update binary swap, and restore/rollback moves. A non-transient error still throws immediately; POSIX renames are unaffected. **Detectors:** *Rename-retry, SQLite-limits, and Clear-Site-Data guards* — Three recurrence detectors ship with the fixes: a bare `nodeFs.renameSync` final rename that doesn't route through `atomicFile.renameWithRetry`; a main `DatabaseSync` handle constructed without the SQLITE_LIMIT_LENGTH `limits`; and a hand-rolled Clear-Site-Data header value that skips the shared RFC 9527 builder.
+
 - v0.15.8 (2026-06-13) — **Redacts OTLP log-sink attributes to close a secret/PII egress the span fix missed, adds EU DSA and China PIPL cross-border compliance record-builders, ships an SSDF producer self-attestation with every release, and makes the published tarball reproducible.** This release closes a telemetry egress hole, adds two compliance record-builder namespaces, and hardens the release supply chain. The OTLP log sinks (HTTP-JSON and gRPC) shipped a log record's meta attributes and the resource attributes to the collector unredacted — a log line carrying a bearer token, password, or API key reached the wire verbatim (CWE-532). The 0.15.4 fix wired the telemetry redactor into the span and metric exporters but the log sinks were missed; both now run record and resource attributes through the same redactor before serialization. New b.dsa builds the EU Digital Services Act (Reg 2022/2065) records an intermediary or platform must keep — Art. 16 notice-and-action, Art. 17 statement of reasons, and the Art. 15 / 24(3) transparency report. New b.pipl builds the China PIPL cross-border transfer records — an Art. 38/40 assessment that determines whether a CAC security assessment is mandatory (CIIO, important data, or the volume / sensitive-PI thresholds), and an Art. 40 security-assessment certificate. On the supply-chain side, every release now ships ssdf-attestation.json, a machine-readable NIST SP 800-218 / OMB M-22-18 producer self-attestation mapping each secure-development practice to its implementing control, and the published tarball is now packed with SOURCE_DATE_EPOCH so an operator can rebuild it byte-for-byte from the release commit. **Added:** *b.dsa — EU Digital Services Act compliance record-builders* — `b.dsa` builds the dated, frozen records the EU Digital Services Act (Regulation (EU) 2022/2065) requires an online intermediary or platform to keep: `b.dsa.noticeAndAction` (Art. 16) records a notice against a piece of content and computes the action-due window; `b.dsa.statementOfReasons` (Art. 17) records a moderation decision with its legal or contractual ground (exactly one is required), the facts, whether it was automated, and the redress routes offered; `b.dsa.transparencyReport` (Art. 15 / 24(3)) aggregates the period counts into a report with the next-due date. The builders perform no network I/O and emit a best-effort audit event; they map to the `dsa` compliance posture. · *b.pipl — China PIPL cross-border transfer record-builders* — `b.pipl.sccFilingAssessment` builds a PIPL Art. 38/40/55 cross-border transfer assessment and determines the lawful mechanism: it forces a CAC security assessment (over a self-selected standard contract or certification) when the exporter is a critical-information-infrastructure operator, exports important data, handles personal information of more than 1,000,000 individuals, or crosses the cumulative volume / sensitive-PI thresholds. `b.pipl.securityAssessmentCertificate` records an Art. 40 security-assessment self-declaration with a 3-year validity clock. Both return frozen dated records and map to the `pipl-cn` posture. · *SSDF producer self-attestation shipped with every release* — Every release now attaches `ssdf-attestation.json` — a machine-readable NIST SP 800-218 (SSDF v1.1) / OMB M-22-18 producer self-attestation. It maps each secure-software-development practice to its implementing control in the tree (SLSA L3 provenance, SSH-signed tags, vendored zero-runtime-dep supply chain, OSV-Scanner gating, coordinated disclosure) and is deterministic from the release commit. Its sha256 is a subject of the SLSA L3 provenance, so verifying the provenance verifies the attestation has not been tampered with. Downstream consumers who require SSDF supplier-compliance evidence can download it from the release page. **Security:** *OTLP log sinks redact record and resource attributes before export* — `b.logStream`'s OTLP log sinks (HTTP-JSON and gRPC) shipped a log record's `meta` attributes and the sink's resource attributes to the collector UNREDACTED, so a log line whose meta carried a bearer token, password, or API key — or a credential placed in a resource attribute — reached the OTLP wire verbatim (CWE-532). The 0.15.4 change baked the telemetry redactor into the span and metric exporters but its detector was anchored on the span/metric encoder function names, leaving the log sinks uncovered. Both log sinks now run record and resource attributes through `b.observability.redactAttrs` before serialization, the same egress contract the span and metric exporters already hold. · *Reproducible published tarball (SOURCE_DATE_EPOCH)* — The release workflow now exports `SOURCE_DATE_EPOCH` (derived from the tagged commit's author date) before `npm pack`, so the mtime stamped into every tar header is deterministic. An operator can re-pack the package from the same commit and match the published tarball's sha256 byte-for-byte, strengthening the source-to-artifact verification path alongside the existing SLSA L3 provenance and PQC signatures. **Detectors:** *otlp-log-sink-encodes-attrs-without-redactor* — Fires when an OTLP log-sink encoder hands a raw `record.meta` or resource-attribute map to serialization without routing it through `observability.redactAttrs` — the class the span/metric detector could not see because the log sinks carry the OTLP-logs schema function names.
 
 - v0.15.7 (2026-06-13) — **Hardens the new URL canonicalizer against an IPv4-mapped allowlist bypass, enforces the OIDC azp authorized-party check, and closes a set of audited correctness gaps in retention, credential rehashing, the scheduler, and SD-JWT key binding.** This release deepens the URL/host canonicalizer shipped in 0.15.6 and clears a batch of audited correctness gaps. The canonicalizer now folds an IPv4-mapped IPv6 address (::ffff:1.2.3.4) to its embedded IPv4 and strips every trailing dot from a host, so a dual-stack peer can no longer slip past an operator's dotted-IPv4 allowlist and host./host.. no longer evade a host comparison. (NAT64 and 6to4 hosts are deliberately kept as IPv6 so canonicalizing then classifying agrees with the SSRF classifier, which treats them as reserved.) On the OIDC side, verifyIdToken now enforces OIDC Core 3.1.3.7: a multi-audience ID token must carry an azp (authorized party) and a present azp must equal the client_id, closing a confused-deputy hole where a token minted for a different client but listing this RP in its audience array verified clean. The rest are audited fixes: retention.complianceFloor now honors the active posture set via applyPosture (the documented inheritance was unimplemented); credentialHash.needsRehash now drives the advertised SHAKE256 length-rotation (raising the output length now triggers a rehash, upgrade-only); the task scheduler no longer lets a run abandoned by its watchdog clobber the next run's state or emit a stale success when its slow promise settles late; and the SD-JWT key-binding JWT compares its audience and nonce in constant time. **Fixed:** *retention.complianceFloor honors the active compliance posture* — `b.retention.complianceFloor` required an explicit posture and never read the active posture set by `applyPosture` (the `b.compliance.set` cascade), so the documented inheritance was unimplemented dead state. It now inherits the active posture when none is passed — `complianceFloor(candidateTtlMs)` uses the active posture, an explicit posture still overrides it — and `applyPosture(null)` now clears the active posture (it was a silent no-op, so `b.compliance.clear` could not reset it). · *credentialHash.needsRehash drives the SHAKE256 length-rotation* — `b.credentialHash.needsRehash` never compared the stored SHAKE256 digest length against the configured length, so raising the output length never triggered a rehash and the advertised length-rotation was a silent no-op. It now flags a digest shorter than the configured/default length for rehash (upgrade-only — a longer-than-target digest is never shortened, matching the Argon2 convention). · *The scheduler no longer lets a watchdog-abandoned run corrupt the next run* — `b.scheduler`'s watchdog force-clears a task's running flag after `maxJobMs` so a hung handler can't lock out future fires, and the next tick re-fires. The original slow promise then settled late and unconditionally overwrote the task's running / lastFinish / lastError state and emitted a `system.scheduler.task.success`|`failure` for a run the watchdog had already given up on — clobbering the new run and double-counting. Each run is now tagged with a generation that the watchdog and every fire bump; a settle whose tag is stale is ignored. **Security:** *The URL canonicalizer folds IPv4-mapped IPv6 addresses to IPv4* — `b.safeUrl.canonicalize` / `b.ssrfGuard.canonicalizeHost` now fold an IPv4-mapped IPv6 address (`::ffff:1.2.3.4`, the `::ffff:0:0/96` block) to its embedded IPv4 dotted form. Previously it canonicalized to an IPv6 string, so a dual-stack peer never unified with an operator's `1.2.3.4` allow/deny entry — an allowlist bypass. Only the IPv4-mapped block folds, because the SSRF classifier maps it to the embedded v4 verdict directly; NAT64 (`64:ff9b::/96`) and 6to4 (`2002::/16`) are deliberately kept as IPv6, since the classifier treats a NAT64 literal as reserved and folding it would turn a blocked verdict into an allowed public IPv4. The host canonicalizer also now strips every trailing dot, so `host`, `host.`, and `host..` collapse to one form. · *verifyIdToken enforces the OIDC azp (authorized party) check* — `b.auth.oauth`'s `verifyIdToken` validated only that its `client_id` was present in the token's `aud`, ignoring `azp`. Per OIDC Core 3.1.3.7, a multi-audience ID token must carry an `azp` and a present `azp` must equal the RP's `client_id`. Without it, a token whose authorized party is a different client — but whose `aud` array also lists this RP — verified clean (a confused-deputy / token-substitution hole). The verifier now rejects a multi-audience token with no `azp` (`auth-oauth/azp-required`) and any token whose `azp` is not the `client_id` (`auth-oauth/azp-mismatch`). A single-audience token with no `azp` (the common case) is unaffected. · *SD-JWT key-binding audience and nonce compare in constant time* — `b.auth.sdJwtVc.verify` compared the key-binding JWT's `aud` and `nonce` with a short-circuiting `!==`, while the adjacent `sd_hash` check already used a constant-time compare. The `nonce` is a verifier-issued replay-defense value, so a non-constant-time compare leaks a matching-prefix timing oracle; both checks now use the constant-time helper.

package/README.md

@@ -52,7 +52,7 @@ var b = require("@blamejs/core");
 })();
 ```
 
-**Requirements:** Node.js 24.14+ (current active LTS, fixes CVE-2026-21713 non-constant-time HMAC compare). Node 26 satisfies the floor and the framework test suite runs cleanly on it today; the floor itself will bump to `>=26.x` when Node 26 promotes to Active LTS. Two Node 26 platform changes operators integrating with blamejs should know about: the new `localStorage` global (the framework's storage backend is `b.backup.diskStorage`; the legacy `b.backup.localStorage` alias was removed in v0.11.20 — update call sites accordingly), and the seed-only ML-KEM / ML-DSA PKCS8 export shape (sealed material from Node 24 re-imports cleanly on Node 26; new material from Node 26 in the seed-only shape). See [SECURITY.md](SECURITY.md#node-26-compatibility) for the details.
+**Requirements:** Node.js 24.16+ (current active LTS line; 24.14.1 fixed CVE-2026-21713 non-constant-time HMAC compare, 24.16 is the current patch level). Node 26 satisfies the floor and the framework test suite runs cleanly on it today; the floor itself will bump to `>=26.x` when Node 26 promotes to Active LTS. Two Node 26 platform changes operators integrating with blamejs should know about: the new `localStorage` global (the framework's storage backend is `b.backup.diskStorage`; the legacy `b.backup.localStorage` alias was removed in v0.11.20 — update call sites accordingly), and the seed-only ML-KEM / ML-DSA PKCS8 export shape (sealed material from Node 24 re-imports cleanly on Node 26; new material from Node 26 in the seed-only shape). See [SECURITY.md](SECURITY.md#node-26-compatibility) for the details.
 
 ## What ships in the box
 
@@ -60,7 +60,7 @@ The framework bundles the surface a typical Node app reaches for. Every primitiv
 
 ### Data layer
 
-- **SQLite with sealed-by-default columns** — `b.db`, migrations, seeders, atomic-file writes
+- **SQLite with sealed-by-default columns** — `b.db`, migrations, seeders, atomic-file writes; the db handle constructs with a SQLITE_LIMIT_LENGTH parse-time cap (a >1 MiB statement is rejected) as a DoS floor on the raw-SQL surface
 - **Chainable query builder** — atomic `.increment(col, delta)`, closure-form `.whereGroup` / top-level `.orWhere` OR composition, `.search(fields, term)` LIKE-OR with safe `%`/`_` ESCAPE handling, `.paginate(opts)` returning `{ items, total, page, totalPages }`; a column-membership gate (`db.init({ columnGate })`, default reject) fails a query closed when it names a column the table never declared, and `whereRaw` refuses an embedded string literal so values bind through placeholders
 - **Mongo-style document-store facade** — `b.db.collection(name, opts?)` with `$set` / `$inc` / `$unset` / `$eq` / `$ne` / `$gt` / `$gte` / `$lt` / `$lte` / `$in` / `$like`; schemaless-document opts via `overflow: "<col>"` (folds unknown fields into a JSON-text column; rewrites `WHERE` on virtual fields to `JSON_EXTRACT`), `jsonColumns: [...]` (auto-stringify on write + parse via `b.safeJson` on read), `sealedFields: { email: "emailHash" }` (co-locates a `b.cryptoField` sealed-column / derived-hash declaration so plaintext lookups auto-rewrite to hash-column lookups)
 - **DB lifecycle** — in-memory encrypted snapshot via `b.db.snapshot()`; standalone encrypted-DB-file lifecycle (`b.db.fileLifecycle({ dataDir, vault })` — decrypt-to-tmpfs, periodic re-encrypt flush, graceful shutdown — same envelope as `b.db`, no schema/audit-chain coupling); `db.init` opt-outs `frameworkTables: false` / `auditSigning: false` and path overrides `encryptedDbPath` / `encryptedDbName` / `dbKeyPath`
@@ -86,6 +86,7 @@ The framework bundles the surface a typical Node app reaches for. Every primitiv
   - Opaque-userId anonymous sessions via `create({ anonymous: true })`
   - Idle / absolute timeouts, fingerprint drift detection + anomaly scoring, brute-force lockout
   - Session-fixation rotation (`b.session.rotate`) re-keys the sid-bound device fingerprint to the new id — pass the same `{ req, fingerprintFields }` used at `create` (a fingerprint-bound session rotated without `req` is refused, so the binding can never silently break or false-drift)
+  - One-call secure logout (`b.session.logout(res, token)`) destroys the session AND wipes client-side state — emits an RFC 9527 Clear-Site-Data header (cookies + storage + cache) and expires the session cookie before deleting the row
 - **Authorization** — RBAC + per-role DB binding + role-spec `requireMfa` + per-route MFA freshness window + ABAC predicate registry (`b.permissions`); API keys with rotation (`b.apiKey`)
 - **Workflow gates** — break-glass column gates with second-factor + audit (`b.breakGlass`); two-person-rule m-of-n approval with cooling-off lock + cancellation (`b.dualControl`)
 - **Financial / Open Banking** — FAPI 2.0 Final composite posture (PAR + PKCE-S256 + DPoP-or-mTLS + RFC 9207); runtime enforcement helpers `b.fapi2.assertCallback` (refuses missing iss + bare-param under message-signing) and `b.fapi2.assertAuthzRequest` (refuses non-JAR); CFPB §1033 / FDX 6.0 consumer-financial-data-sharing wrapper (`b.fdx`)

package/lib/archive-read.js

@@ -42,6 +42,7 @@ var nodeFs = require("node:fs");
 var C = require("./constants");
 var lazyRequire = require("./lazy-require");
 var { defineClass } = require("./framework-error");
+var atomicFile = require("./atomic-file");
 
 var ArchiveReadError = defineClass("ArchiveReadError", { alwaysPermanent: true });
 
@@ -925,7 +926,7 @@ function zip(adapter, opts) {
         // the rename targets a non-existent path.
         var tmpPath = resolvedPath + ".__blamejs-archive-read-tmp__";
         nodeFs.writeFileSync(tmpPath, body);
-        nodeFs.renameSync(tmpPath, resolvedPath);
+        atomicFile.renameWithRetry(tmpPath, resolvedPath);
         written.push({ name: entry.name, bytesWritten: body.length, path: resolvedPath });
         bytesExtracted += body.length;
       }

package/lib/archive-tar-read.js

@@ -14,6 +14,7 @@ var C = require("./constants");
 var lazyRequire = require("./lazy-require");
 var safeBuffer = require("./safe-buffer");
 var archiveTar = require("./archive-tar");
+var atomicFile = require("./atomic-file");
 
 var TarError = archiveTar.TarError;
 var _parseHeader = archiveTar._parseHeader;
@@ -428,7 +429,7 @@ function tar(adapter, opts) {
         }
         var tmpPath = resolvedPath + ".__blamejs-archive-tar-tmp__";
         nodeFs.writeFileSync(tmpPath, body);
-        nodeFs.renameSync(tmpPath, resolvedPath);
+        atomicFile.renameWithRetry(tmpPath, resolvedPath);
         written.push({ name: entry.name, bytesWritten: body.length, path: resolvedPath });
         bytesExtracted += body.length;
       }

package/lib/atomic-file.js

@@ -1077,6 +1077,11 @@ module.exports = {
   fsync:             fsync,
   fsyncDir:          fsyncDir,
   ensureDir:         ensureDir,
+  // Atomic rename with a bounded retry on Windows-transient lock errors
+  // (EPERM/EACCES/EBUSY from AV / search indexer / Dropbox / OneDrive briefly
+  // holding the destination). Exposed so any final temp->dest rename routes
+  // through the same retry instead of hand-rolling it (or, worse, omitting it).
+  renameWithRetry:   _renameWithRetry,
   copyDirRecursive:  copyDirRecursive,
   pathTimestamp:     pathTimestamp,
   conflictPath:      conflictPath,

package/lib/cli.js

@@ -94,7 +94,14 @@ function _openSqlite(dbPath) {
   // Lazy-required so the CLI doesn't crash on `blamejs version` or
   // `blamejs help` if node:sqlite isn't usable for some reason.
   var { DatabaseSync } = require("node:sqlite");
-  return new DatabaseSync(dbPath);
+  // Same SQLITE_LIMIT_ sqlLength cap as db.init's main handle — the CLI opens
+  // the operator's real database for migrate / inspect, so the parse-time DoS
+  // floor applies here too.
+  return new DatabaseSync(dbPath, {
+    limits: {
+      sqlLength: C.BYTES.mib(1),
+    },
+  });
 }
 
 // ---- Subcommand: migrate ----

package/lib/config-drift.js

@@ -44,6 +44,7 @@ var lazyRequire = require("./lazy-require");
 var safeJson = require("./safe-json");
 var validateOpts = require("./validate-opts");
 var { defineClass } = require("./framework-error");
+var atomicFile = require("./atomic-file");
 
 var audit = lazyRequire(function () { return require("./audit"); });
 
@@ -201,7 +202,7 @@ function create(opts) {
     };
     var tmp = sidecarPath + ".tmp";
     nodeFs.writeFileSync(tmp, JSON.stringify(payload, null, 2));
-    nodeFs.renameSync(tmp, sidecarPath);
+    atomicFile.renameWithRetry(tmp, sidecarPath);
   }
 
   function _verifySidecar(parsed) {

package/lib/db.js

@@ -1156,8 +1156,21 @@ async function init(opts) {
     encKey = null;
   }
 
-  // Open the database
-  database = new DatabaseSync(dbPath);
+  // Open the database. The node:sqlite `limits` option sets SQLITE_LIMIT_*
+  // caps at construction — a parse-time DoS floor complementary to the
+  // streamLimit row-count gate (one bounds statement size, the other bounds
+  // result cardinality). sqlLength rejects a megaquery (>1 MiB) before the
+  // parser chews CPU/memory on it; the framework never legitimately emits a
+  // statement anywhere near 1 MiB, and a 1 GB attacker-influenced statement
+  // would otherwise be parsed. The limits option is part of node:sqlite from
+  // Node 24.10+, comfortably under the engines floor. (SQLITE_LIMIT_ATTACHED is
+  // left at the SQLite default — the snapshot / backup path relies on the
+  // attach mechanism.)
+  database = new DatabaseSync(dbPath, {
+    limits: {
+      sqlLength: C.BYTES.mib(1),
+    },
+  });
 
   // Performance pragmas
   runSql(database, "PRAGMA journal_mode=WAL");

package/lib/http-client.js

@@ -2000,9 +2000,12 @@ async function downloadStream(opts) {
     }
   }
 
-  // Atomic rename + dir fsync.
+  // Atomic rename + dir fsync. Route the final rename through
+  // atomicFile.renameWithRetry so a Windows-transient lock on the destination
+  // (AV / search indexer / Dropbox / OneDrive) is retried rather than surfaced
+  // as a hard download failure — the same retry b.atomicFile.writeSync applies.
   try {
-    nodeFs.renameSync(tmpPath, dest);
+    atomicFile.renameWithRetry(tmpPath, dest);
     atomicFile.fsyncDir(dir);
   } catch (e) {
     try { nodeFs.unlinkSync(tmpPath); } catch (_u) { /* best-effort cleanup */ }

package/lib/local-db-thin.js

@@ -59,6 +59,7 @@ var lazyRequire = require("./lazy-require");
 var validateOpts = require("./validate-opts");
 var safeSql = require("./safe-sql");
 var { LocalDbThinError } = require("./framework-error");
+var atomicFile = require("./atomic-file");
 
 var audit = lazyRequire(function () { return require("./audit"); });
 
@@ -203,7 +204,7 @@ function thin(opts) {
       var lastRenameErr = null;
       for (var attempt = 0; attempt < 20 && !renamed; attempt += 1) {
         try {
-          if (nodeFs.existsSync(file)) nodeFs.renameSync(file, renamedTo);
+          if (nodeFs.existsSync(file)) atomicFile.renameWithRetry(file, renamedTo);
           renamed = true;
         } catch (re) {
           lastRenameErr = re;
@@ -228,7 +229,7 @@ function thin(opts) {
       ["-wal", "-shm"].forEach(function (suffix) {
         var sibling = file + suffix;
         if (nodeFs.existsSync(sibling)) {
-          try { nodeFs.renameSync(sibling, sibling + ".corrupt-" + stamp); }
+          try { atomicFile.renameWithRetry(sibling, sibling + ".corrupt-" + stamp); }
           catch (_se) { /* best-effort */ }
         }
       });

package/lib/log-stream-local.js

@@ -85,7 +85,7 @@ function create(config) {
       var stamp = time.toIso8601NoMs(new Date()).replace(/[-:]/g, "");
       var rotated = nodePath.join(dir, cfg.fileNamePrefix + "-" + stamp + ".log");
       if (nodeFs.existsSync(activePath)) {
-        nodeFs.renameSync(activePath, rotated);
+        atomicFile.renameWithRetry(activePath, rotated);
         if (cfg.compressRotations) {
           var data = nodeFs.readFileSync(rotated);
           var gz = zlib.gzipSync(data);

package/lib/middleware/clear-site-data.js

@@ -87,29 +87,51 @@ var DEFAULT_TYPES = ["cookies", "storage", "cache", "executionContexts"];
  *     },
  *   ]);
  */
-function create(opts) {
-  opts = opts || {};
-  validateOpts(opts, ["types"], "middleware.clearSiteData");
-  var types = opts.types === undefined ? DEFAULT_TYPES : opts.types;
+/**
+ * @primitive b.middleware.clearSiteData.headerValue
+ * @signature b.middleware.clearSiteData.headerValue(types, label?)
+ * @since      0.15.9
+ * @status     stable
+ * @related    b.middleware.clearSiteData, b.session.logout
+ *
+ * Build the RFC 9527 §3 Clear-Site-Data header value from a list of directive
+ * types — a comma-separated list of double-quoted tokens — validating each
+ * against the known set (`cookies`, `storage`, `cache`, `executionContexts`).
+ * The middleware factory and `b.session.logout` both compose it so every
+ * emitter produces the same validated header instead of hand-rolling the
+ * quoting. Throws a `TypeError` on an unknown directive or a non-array input
+ * (config-time / entry-point tier).
+ *
+ * @example
+ *   b.middleware.clearSiteData.headerValue(["cookies", "storage"]);
+ *   // → '"cookies", "storage"'
+ */
+function headerValue(types, label) {
+  label = label || "middleware.clearSiteData";
   if (!Array.isArray(types) || types.length === 0) {
-    throw new TypeError("middleware.clearSiteData: opts.types must be a non-empty array");
+    throw new TypeError(label + ": types must be a non-empty array");
   }
   for (var i = 0; i < types.length; i += 1) {
     var t = types[i];
     if (typeof t !== "string" || !KNOWN_TYPES[t]) {
       throw new TypeError(
-        "middleware.clearSiteData: unknown type '" + t +
+        label + ": unknown type '" + t +
         "' (expected one of: " + Object.keys(KNOWN_TYPES).join(", ") + ")");
     }
   }
-  // Header value is a comma-separated list of double-quoted tokens
-  // per RFC 9527 §3 (Structured Field Value List of Strings). Build
-  // once at construction time — runtime cost is one setHeader call.
-  var headerValue = types.map(function (t) { return '"' + t + '"'; }).join(", ");
+  return types.map(function (t) { return '"' + t + '"'; }).join(", ");
+}
+
+function create(opts) {
+  opts = opts || {};
+  validateOpts(opts, ["types"], "middleware.clearSiteData");
+  var types = opts.types === undefined ? DEFAULT_TYPES : opts.types;
+  // Header value built once at construction; runtime cost is one setHeader.
+  var headerVal = headerValue(types, "middleware.clearSiteData");
 
   return function clearSiteData(req, res, next) {
     if (typeof res.setHeader === "function") {
-      res.setHeader("Clear-Site-Data", headerValue);
+      res.setHeader("Clear-Site-Data", headerVal);
     }
     next();
   };
@@ -117,6 +139,9 @@ function create(opts) {
 
 module.exports = {
   create:        create,
+  // The shared RFC 9527 header-value builder — b.session.logout composes it so
+  // the logout path emits the same validated Clear-Site-Data header.
+  headerValue:   headerValue,
   KNOWN_TYPES:   Object.keys(KNOWN_TYPES),
   DEFAULT_TYPES: DEFAULT_TYPES,
 };

package/lib/mtls-ca.js

@@ -336,8 +336,8 @@ function create(opts) {
         _writeExclusive(keyTmp, opts2.caKeyPem, 0o600);
       }
       _writeExclusive(certTmp, opts2.caCertPem, 0o644);
-      nodeFs.renameSync(keyTmp, keyDest);
-      nodeFs.renameSync(certTmp, paths.caCert);
+      atomicFile.renameWithRetry(keyTmp, keyDest);
+      atomicFile.renameWithRetry(certTmp, paths.caCert);
     } catch (e) {
       // Best-effort cleanup of half-written tmp files; the original
       // commit error is what we re-raise. Log cleanup failures at debug

package/lib/restore-rollback.js

@@ -119,7 +119,7 @@ function swap(opts) {
   // Step 1: rename current dataDir → rollback nodePath. Skipped on first
   // restore (no existing dataDir).
   if (hadDataDir) {
-    try { nodeFs.renameSync(opts.dataDir, rollbackPath); }
+    try { atomicFile.renameWithRetry(opts.dataDir, rollbackPath); }
     catch (e) {
       throw new RestoreRollbackError("restore-rollback/rename-existing-failed",
         "swap: could not move existing dataDir to rollback: " + ((e && e.message) || String(e)));
@@ -127,11 +127,11 @@ function swap(opts) {
   }
 
   // Step 2: rename staging → dataDir
-  try { nodeFs.renameSync(opts.stagingDir, opts.dataDir); }
+  try { atomicFile.renameWithRetry(opts.stagingDir, opts.dataDir); }
   catch (e) {
     // Step 2 failed — try to undo step 1 so the operator's dataDir is back
     if (hadDataDir) {
-      try { nodeFs.renameSync(rollbackPath, opts.dataDir); }
+      try { atomicFile.renameWithRetry(rollbackPath, opts.dataDir); }
       catch (_e) { /* dataDir is now in rollbackPath; operator must recover manually */ }
     }
     throw new RestoreRollbackError("restore-rollback/rename-staging-failed",
@@ -220,7 +220,7 @@ async function rollback(opts) {
     atomicFile.ensureDir(rollbackRoot);
     discardedAt = atomicFile.pathTimestamp();
     var discardedPath = nodePath.join(rollbackRoot, "discarded-" + discardedAt);
-    try { nodeFs.renameSync(opts.dataDir, discardedPath); }
+    try { atomicFile.renameWithRetry(opts.dataDir, discardedPath); }
     catch (e) {
       throw new RestoreRollbackError("restore-rollback/rename-existing-failed",
         "rollback: could not move current dataDir aside: " + ((e && e.message) || String(e)));
@@ -229,7 +229,7 @@ async function rollback(opts) {
   }
 
   // Rename the rollback dir back into dataDir's place
-  try { nodeFs.renameSync(opts.rollbackPath, opts.dataDir); }
+  try { atomicFile.renameWithRetry(opts.rollbackPath, opts.dataDir); }
   catch (e) {
     throw new RestoreRollbackError("restore-rollback/rollback-rename-failed",
       "rollback: could not move rollback into dataDir: " + ((e && e.message) || String(e)) +

package/lib/self-update.js

@@ -676,7 +676,7 @@ async function swap(opts) {
   // don't silently lose both binaries (the prior best-effort comment
   // swallowed the rollback exception — SSDF RV.1 violation).
   try {
-    nodeFs.renameSync(from, to);
+    atomicFile.renameWithRetry(from, to);
   } catch (e) {
     if (e && e.code === "EXDEV") {
       // Cross-device — copy + unlink. Use atomicFile.copy for the safety

package/lib/session.js

@@ -65,6 +65,9 @@ var { SessionError } = require("./framework-error");
 // the cookie-side sid so the wire token is ciphertext rather than
 // plaintext (sealed-cookie default since v0.8.61).
 var vault = lazyRequire(function () { return require("./vault"); });
+// Lazy — b.session.logout composes the Clear-Site-Data header builder; keep it
+// out of the boot require graph (no cycle, but session is a low-level primitive).
+var clearSiteData = lazyRequire(function () { return require("./middleware/clear-site-data"); });
 
 // Pluggable session-storage backend. Default uses cluster-storage (which
 // in turn dispatches to the framework's main DB or external DB). An
@@ -705,6 +708,66 @@ async function destroy(token) {
   return await _deleteBySidHash(_hashSid(sid));
 }
 
+/**
+ * @primitive b.session.logout
+ * @signature b.session.logout(res, token, opts?)
+ * @since     0.15.9
+ * @status    stable
+ * @related   b.session.destroy, b.middleware.clearSiteData
+ *
+ * Secure logout in one call: destroy the server-side session AND tell the
+ * browser to wipe its client-side state. It emits an RFC 9527 Clear-Site-Data
+ * response header (cookies + storage + cache + executionContexts by default)
+ * and expires the session cookie, then destroys the session row. `destroy()`
+ * alone is a store operation with no `res`, so it cannot wipe the browser's
+ * cached pages / storage / any stale tab still holding the now-revoked cookie;
+ * this composes the secure-default logout the middleware otherwise had to be
+ * mounted by hand. Returns whether a session was destroyed. Leader-only.
+ *
+ * @opts
+ *   cookieName: string,    // default: "sid" — the session cookie to expire
+ *   types:      string[],  // default: the RFC 9527 Clear-Site-Data directive set
+ *
+ * @example
+ *   app.post("/logout", async function (req, res) {
+ *     await b.session.logout(res, req.cookies.sid);
+ *     res.end("logged out");
+ *   });
+ *   // → emits Clear-Site-Data + expires the sid cookie + destroys the session
+ */
+async function logout(res, token, opts) {
+  if (!res || typeof res.setHeader !== "function") {
+    throw new SessionError("session/bad-res",
+      "b.session.logout: res must be an HTTP response with setHeader()");
+  }
+  opts = opts || {};
+  var cookieName = opts.cookieName === undefined ? "sid" : opts.cookieName;
+  if (typeof cookieName !== "string" || cookieName.length === 0) {
+    throw new SessionError("session/bad-cookie-name",
+      "b.session.logout: opts.cookieName must be a non-empty string");
+  }
+  var csd = clearSiteData();
+  var types = opts.types === undefined ? csd.DEFAULT_TYPES : opts.types;
+  // Build (and validate) the RFC 9527 header BEFORE any side effect — an
+  // unknown directive throws here, queuing nothing.
+  var clearSiteDataValue = csd.headerValue(types, "b.session.logout");
+
+  // Revoke the server-side session FIRST. If destroy() throws (a follower
+  // failing cluster.requireLeader(), or a store/DB error), no client-wipe
+  // headers have been queued — an error response can't then expire the
+  // browser cookie + Clear-Site-Data while the session row is still live,
+  // which would leave a copied token usable server-side.
+  var destroyed = await destroy(token);
+
+  // Now wipe the client-side state: RFC 9527 Clear-Site-Data (cookies /
+  // storage / cache) + expire the session cookie (belt-and-suspenders with the
+  // "cookies" directive, and effective even if the client ignores the header).
+  res.setHeader("Clear-Site-Data", clearSiteDataValue);
+  res.setHeader("Set-Cookie",
+    cookieName + "=; Path=/; HttpOnly; Secure; SameSite=Strict; Max-Age=0");
+  return destroyed;
+}
+
 async function _deleteBySidHash(sidHash) {
   var built = sql.delete(_sessionSqlTable(), _sessionSqlOpts())
     .where("sidHash", sidHash)
@@ -1245,6 +1308,7 @@ module.exports = {
   create:               create,
   verify:               verify,
   destroy:              destroy,
+  logout:               logout,
   destroyAllForUser:    destroyAllForUser,
   touch:                touch,
   rotate:               rotate,

package/lib/vault/passphrase-ops.js

@@ -169,7 +169,7 @@ async function seal(opts) {
   }
 
   // Step 3: atomic rename sealed.tmp → sealed
-  nodeFs.renameSync(p.sealedTmp, p.sealed);
+  atomicFile.renameWithRetry(p.sealedTmp, p.sealed);
   atomicFile.fsyncDir(opts.dataDir);
 
   // Step 4: delete plaintext (unless keepPlaintext)
@@ -220,7 +220,7 @@ async function unseal(opts) {
   }
 
   // Step 3: atomic rename plaintext.tmp → plaintext
-  nodeFs.renameSync(p.plaintextTmp, p.plaintext);
+  atomicFile.renameWithRetry(p.plaintextTmp, p.plaintext);
   atomicFile.fsyncDir(opts.dataDir);
 
   // Step 4: delete sealed file
@@ -293,7 +293,7 @@ async function rotate(opts) {
   }
 
   // Step 3: atomic rename — swap in the new sealed file
-  nodeFs.renameSync(p.sealedTmp, p.sealed);
+  atomicFile.renameWithRetry(p.sealedTmp, p.sealed);
   atomicFile.fsyncDir(opts.dataDir);
 
   return { sealedPath: p.sealed };

package/lib/watcher.js

@@ -316,6 +316,14 @@ function create(opts) {
   _validateOpts(opts);
 
   var root        = nodePath.resolve(opts.root);
+  // Canonicalize to the real long path. On Windows a path with an 8.3
+  // short-name component (os.tmpdir() commonly resolves to C:\Users\RUNNER~1\…)
+  // makes the native recursive backend (ReadDirectoryChangesW) deliver
+  // long-name event paths that no longer prefix-match the watched root, which
+  // trips a libuv fs-event assertion and aborts the process on some Node builds.
+  // realpathSync.native expands short names and resolves symlinks; guarded so a
+  // non-existent root still falls through to the watcher's own not-found error.
+  try { root = nodeFs.realpathSync.native(root); } catch (_e) { /* keep resolved path */ }
   var debounceMs  = (opts.debounceMs !== undefined) ? opts.debounceMs : DEFAULT_DEBOUNCE_MS;
   var maxPending  = (opts.maxPending !== undefined) ? opts.maxPending : DEFAULT_MAX_PENDING;
   var requestedMode = opts.mode || "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blamejs/core",
-  "version": "0.15.8",
+  "version": "0.15.9",
   "description": "The Node framework that owns its stack.",
   "license": "Apache-2.0",
   "author": "blamejs contributors",
@@ -54,7 +54,7 @@
     "owns-its-stack"
   ],
   "engines": {
-    "node": ">=24.14.1"
+    "node": ">=24.16.0"
   },
   "files": [
     "index.js",

package/sbom.cdx.json

@@ -2,10 +2,10 @@
   "$schema": "http://cyclonedx.org/schema/bom-1.5.schema.json",
   "bomFormat": "CycloneDX",
   "specVersion": "1.5",
-  "serialNumber": "urn:uuid:d7b8bc62-0d13-40fc-86ee-e6263eb44d87",
+  "serialNumber": "urn:uuid:19fb1b2e-d7b6-4169-b9c6-f60726097293",
   "version": 1,
   "metadata": {
-    "timestamp": "2026-06-13T19:33:49.247Z",
+    "timestamp": "2026-06-14T00:18:26.195Z",
     "lifecycles": [
       {
         "phase": "build"
@@ -15,18 +15,18 @@
       {
         "vendor": "npm",
         "name": "cli",
-        "version": "11.11.0"
+        "version": "11.13.0"
       }
     ],
     "component": {
-      "bom-ref": "@blamejs/core@0.15.8",
+      "bom-ref": "@blamejs/core@0.15.9",
       "type": "application",
       "name": "blamejs",
-      "version": "0.15.8",
+      "version": "0.15.9",
       "scope": "required",
       "author": "blamejs contributors",
       "description": "The Node framework that owns its stack.",
-      "purl": "pkg:npm/%40blamejs/core@0.15.8",
+      "purl": "pkg:npm/%40blamejs/core@0.15.9",
       "properties": [],
       "externalReferences": [
         {
@@ -54,7 +54,7 @@
   "components": [],
   "dependencies": [
     {
-      "ref": "@blamejs/core@0.15.8",
+      "ref": "@blamejs/core@0.15.9",
       "dependsOn": []
     }
   ]