@blamejs/core 0.7.23 → 0.7.24

package/CHANGELOG.md

@@ -8,6 +8,8 @@ upgrading across more than a few patches at a time.
 
 ## v0.7.x
 
+- **0.7.24** (2026-05-05) — `b.retention.complianceFloor` accessor for regulatory minimum-retention windows. **Surface**: `b.retention.complianceFloor(posture, candidateTtlMs?)` returns the effective TTL that meets-or-exceeds the regulatory floor; throws `retention/unknown-posture` on unknown names. **`b.retention.COMPLIANCE_RETENTION_FLOOR_MS`** exposes the per-posture minimums for compliance audit visibility: `pci-dss` 365 days (PCI-DSS Req 10.7.1), `hipaa` 6 years (45 CFR §164.316(b)(2)), `sox` 7 years (Sarbanes-Oxley §802), `soc2` 1 year, `dora` 5 years (DORA Article 17). When `candidateTtlMs` exceeds the floor it wins; when it's below, the floor takes over. Smoke 8488 / wiki e2e 178 / Linux container smoke 8488 / Linux container wiki e2e 178 / eslint clean / api-snapshot baseline refreshed.
+
 - **0.7.23** (2026-05-05) — DNS-over-HTTPS default-on. **Default-on DoH for outbound DNS** — `lib/network-dns.js` now uses Cloudflare DoH (`https://cloudflare-dns.com/dns-query`) for hostname resolution by default when neither `useDnsOverHttps()` nor `useDnsOverTls()` has been called explicitly. Privacy-respecting (encrypted DNS over TLS to a non-ISP resolver), aligned with Core Rule §3 ("security defaults are not opt-in"). **Local-form hosts route through node:dns** — RFC 6761 / 6762 special-form names (`localhost`, `*.localhost`, `*.local`, `*.test`, `*.invalid`, `*.internal`, `*.intranet`, `*.lan`, `*.home`, `*.corp`) AND IP literals skip DoH and use node:dns directly so `/etc/hosts` lookups + dev workflows continue to resolve correctly. **Operator opt-out via `b.network.dns.useSystemResolver()`** — split-horizon / internal-DNS deployments call this once at boot and every lookup routes through the OS resolver thereafter. **Env override `BLAMEJS_DNS_TRANSPORT`** — operators set `system` (force OS resolver), `dot` (force Cloudflare DNS-over-TLS at 1.1.1.1:853), or leave unset (default DoH). Smoke 8478 / wiki e2e 178 / Linux container smoke 8478 / Linux container wiki e2e 178 / eslint clean / api-snapshot baseline refreshed.
 
 - **0.7.22** (2026-05-05) — DKIM dual-signer + soc2-cc7 → soc2 posture rename. **`b.mail.dkim.dualSigner`** — RFC 8463 §3 transition signer that produces messages with BOTH a legacy RSA-SHA-256 DKIM-Signature AND an Ed25519-SHA-256 DKIM-Signature header. Receivers without Ed25519 support validate the RSA signature; receivers that prefer Ed25519 validate the post-quantum-friendlier signature. Operators rolling off RSA-SHA-256 wire `b.mail.dkim.dualSigner({ domain, rsa: { selector, privateKey }, eddsa: { selector, privateKey } })` and pass the result anywhere a regular DKIM signer is accepted; `sign()` produces a wire with two `DKIM-Signature` headers. Both signers are constructed eagerly at create-time (configuration errors surface at boot, not at first send). **soc2-cc7 → soc2 posture rename** — every guard's compliance posture name changes from `"soc2-cc7"` to `"soc2"`. The CC7-specific scoping was misleading (SOC 2 controls span CC1–CC9; the existing posture wasn't CC7-specific). Operators with `compliancePosture: "soc2-cc7"` MUST update to `compliancePosture: "soc2"` — the old name now throws `unknown compliance posture`. Smoke 8478 / wiki e2e 178 / Linux container smoke 8478 / Linux container wiki e2e 178 / eslint clean / api-snapshot baseline refreshed.

package/lib/retention.js

@@ -55,6 +55,7 @@
  * write. This is the escape hatch; the table+ageField+ttlMs shape
  * covers the common case.
  */
+var C = require("./constants");
 var lazyRequire = require("./lazy-require");
 var validateOpts = require("./validate-opts");
 var { defineClass } = require("./framework-error");
@@ -433,7 +434,47 @@ function create(opts) {
   return { declare: declare, run: run, runAll: runAll, preview: preview, list: list };
 }
 
+// Audit-log retention floors per regulatory posture. These are the
+// MINIMUMS — operators may declare longer windows but cannot declare
+// shorter ones. Operator-facing helper for compliance audit.
+//
+//   PCI-DSS Requirement 10.7.1   — 12 months online (active accessible)
+//   HIPAA 45 CFR §164.316(b)(2)  — 6 years from creation
+//   SOX (Sarbanes-Oxley) §802     — 7 years for audit-relevant records
+//   GDPR Art. 5(1)(e)             — no fixed minimum; operator declares
+//   SOC 2 (CC1–CC9)              — 1 year typical; auditor-driven
+//   DORA Art. 17 (incident logs) — 5 years
+var COMPLIANCE_RETENTION_FLOOR_MS = Object.freeze({
+  "pci-dss":  C.TIME.days(365),       // 12 months
+  "hipaa":    C.TIME.days(365 * 6),   // 6 years
+  "sox":      C.TIME.days(365 * 7),   // 7 years
+  "soc2":     C.TIME.days(365),       // 1 year
+  "dora":     C.TIME.days(365 * 5),   // 5 years (Article 17 incident logs)
+});
+
+// Operator passes a posture name + a candidate ttlMs; returns the
+// effective ttl that meets-or-exceeds the floor. Throws if posture is
+// unknown so typos surface at config time.
+function complianceFloor(posture, candidateTtlMs) {
+  if (typeof posture !== "string") {
+    throw new RetentionError("retention/bad-posture",
+      "complianceFloor: posture must be a string, got " + JSON.stringify(posture));
+  }
+  var floor = COMPLIANCE_RETENTION_FLOOR_MS[posture];
+  if (floor === undefined) {
+    throw new RetentionError("retention/unknown-posture",
+      "complianceFloor: unknown posture '" + posture + "'; expected one of " +
+      Object.keys(COMPLIANCE_RETENTION_FLOOR_MS).join(", "));
+  }
+  if (typeof candidateTtlMs !== "number" || !isFinite(candidateTtlMs) || candidateTtlMs <= 0) {
+    return floor;
+  }
+  return candidateTtlMs > floor ? candidateTtlMs : floor;
+}
+
 module.exports = {
-  create:         create,
-  RetentionError: RetentionError,
+  create:                         create,
+  complianceFloor:                complianceFloor,
+  COMPLIANCE_RETENTION_FLOOR_MS:  COMPLIANCE_RETENTION_FLOOR_MS,
+  RetentionError:                 RetentionError,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blamejs/core",
-  "version": "0.7.23",
+  "version": "0.7.24",
   "description": "The Node framework that owns its stack.",
   "license": "Apache-2.0",
   "author": "blamejs contributors",

package/sbom.cyclonedx.json

@@ -2,10 +2,10 @@
   "$schema": "http://cyclonedx.org/schema/bom-1.5.schema.json",
   "bomFormat": "CycloneDX",
   "specVersion": "1.5",
-  "serialNumber": "urn:uuid:2ed35351-9ec7-4e19-9471-f35604ba988a",
+  "serialNumber": "urn:uuid:942606f7-1484-4ac3-9332-63f73e25256f",
   "version": 1,
   "metadata": {
-    "timestamp": "2026-05-05T06:39:17.238Z",
+    "timestamp": "2026-05-05T06:51:47.053Z",
     "lifecycles": [
       {
         "phase": "build"
@@ -19,14 +19,14 @@
       }
     ],
     "component": {
-      "bom-ref": "@blamejs/core@0.7.23",
+      "bom-ref": "@blamejs/core@0.7.24",
       "type": "library",
       "name": "blamejs",
-      "version": "0.7.23",
+      "version": "0.7.24",
       "scope": "required",
       "author": "blamejs contributors",
       "description": "The Node framework that owns its stack.",
-      "purl": "pkg:npm/%40blamejs/core@0.7.23",
+      "purl": "pkg:npm/%40blamejs/core@0.7.24",
       "properties": [],
       "externalReferences": [
         {
@@ -54,7 +54,7 @@
   "components": [],
   "dependencies": [
     {
-      "ref": "@blamejs/core@0.7.23",
+      "ref": "@blamejs/core@0.7.24",
       "dependsOn": []
     }
   ]