@blamejs/core 0.7.91 → 0.7.92

package/CHANGELOG.md

@@ -8,6 +8,8 @@ upgrading across more than a few patches at a time.
 
 ## v0.7.x
 
+- **0.7.92** (2026-05-06) — Retention floors + observability semconv expansion. **`b.retention.complianceFloor(<posture>, candidateMs)`** now recognizes `nis2` (3 years — NIS2 Art. 23 incident reporting), `cra` (5 years — CRA Art. 14 vulnerability handling logs), `lgpd-br` (5 years — Brazil fiscal record minimum + LGPD Art. 16), `appi-jp` (3 years — Japan APPI handler-of-record), `pdpa-sg` (1 year — PDPA breach notification audit trail), and `uk-gdpr` (6 years — UK ICO guidance + statutory limit alignment). `gdpr` continues to have no fixed minimum (Art. 5(1)(e) is "no longer than necessary" — operator-driven). **`b.observability.SEMCONV`** gains RPC attributes (`RPC_SYSTEM` / `RPC_SERVICE` / `RPC_METHOD` / `RPC_GRPC_STATUS_CODE`), additional messaging keys (`MESSAGING_CLIENT_ID` / `MESSAGING_MESSAGE_ID` / `MESSAGING_DESTINATION_PARTITION_ID` / `MESSAGING_BATCH_MESSAGE_COUNT`), network transport (`NETWORK_TRANSPORT` / `NETWORK_CONNECTION_TYPE`), process / runtime identification (`PROCESS_PID` / `PROCESS_RUNTIME_NAME` / `PROCESS_RUNTIME_VERSION`), service identification (`SERVICE_NAME` / `SERVICE_VERSION` / `SERVICE_INSTANCE_ID`), and telemetry SDK self-id (`TELEMETRY_SDK_NAME` / `TELEMETRY_SDK_LANGUAGE` / `TELEMETRY_SDK_VERSION`). Operators wiring the framework's tap into a gRPC-fronted OTel collector or an outbox-fed Kafka topic now reference the canonical attribute names directly without an aliasing table on their side.
+
 - **0.7.91** (2026-05-06) — Compliance-posture vocabulary expanded + OpenTelemetry semantic-convention attribute table. **`b.compliance.set(<posture>)`** now accepts thirteen new posture names: `wmhmda` (Washington My Health My Data Act), `bipa` (Illinois Biometric Information Privacy Act), `ccpa` (California Consumer Privacy Act), `nis2` (EU NIS2 Directive), `cra` (EU Cyber Resilience Act), `ai-act` (EU AI Act), `lgpd-br` (Brazil LGPD), `pipl-cn` (China PIPL), `appi-jp` (Japan APPI), `pdpa-sg` (Singapore PDPA), `pipeda-ca` (Canada PIPEDA), `uk-gdpr` (UK GDPR). Existing `hipaa` / `pci-dss` / `gdpr` / `soc2` / `dora` / `sox` continue to work. Postures map to per-primitive defaults via the existing compliancePosture opt on guards, retention, dora, etc. — operators set the deployment-wide posture once and primitives that key off it pick up the right defaults. **`b.observability.SEMCONV`** — frozen attribute-name table tracking the OpenTelemetry semantic-convention stable namespace (1.27+). HTTP server attributes (`http.request.method`, `http.response.status_code`, `http.route`, `server.address`, `client.address`), URL (`url.full`, `url.path`, `url.scheme`), database (`db.system`, `db.namespace`, `db.operation.name`, `db.query.text`), messaging (`messaging.system`, `messaging.destination.name`), auth (`user.id`, `session.id`), errors (`error.type`, `exception.type`, `exception.message`). Operators wiring the framework's tap into an OTel SDK reference these constants instead of hand-rolling the names — no aliasing table on the operator side, and string typos throw at access time instead of producing mis-named span attributes that the OTel collector silently drops.
 
 - **0.7.90** (2026-05-06) — `b.outbox` — transactional outbox primitive for at-least-once event publication without distributed transactions. **`b.outbox.create({ externalDb, table, publisher, ... })`** returns an outbox instance with three core operations: `enqueue(event, txn)` writes the outbox row inside the operator's transaction (using the `txClient` returned by `b.externalDb.transaction`), `start()` spins a polling publisher worker that claims rows via `SELECT ... FOR UPDATE SKIP LOCKED` (Postgres) and dispatches to the operator-supplied async `publisher(event)` callback, `stop()` gracefully shuts the worker down. Failed publishes retry with exponential backoff (`retryBackoff: { initialMs, maxMs, factor }`); rows that exceed `maxAttempts` are marked `'dead'` for operator triage and an `system.outbox.deadletter` audit event fires. Schema is operator-managed: `outbox.declareSchema(externalDb)` runs an idempotent `CREATE TABLE IF NOT EXISTS ... (id, topic, payload, key, headers, enqueued_at, next_attempt_at, published_at, attempts, last_error, status)` + a partial index on `(next_attempt_at) WHERE status = 'pending'`. `pendingCount()` / `deadCount()` expose the queue depth + DLQ depth for operator dashboards. Observability events on every state transition (`outbox.enqueued` / `outbox.published` / `outbox.publish-failed` / `outbox.dead-letter`).

package/lib/observability.js

@@ -195,6 +195,31 @@ var SEMCONV = Object.freeze({
   EXCEPTION_TYPE:             "exception.type",
   EXCEPTION_MESSAGE:          "exception.message",
   EXCEPTION_STACKTRACE:       "exception.stacktrace",
+  // RPC
+  RPC_SYSTEM:                 "rpc.system",
+  RPC_SERVICE:                "rpc.service",
+  RPC_METHOD:                 "rpc.method",
+  RPC_GRPC_STATUS_CODE:       "rpc.grpc.status_code",
+  // Messaging — additional client/server attrs
+  MESSAGING_CLIENT_ID:                "messaging.client.id",
+  MESSAGING_MESSAGE_ID:               "messaging.message.id",
+  MESSAGING_DESTINATION_PARTITION_ID: "messaging.destination.partition.id",
+  MESSAGING_BATCH_MESSAGE_COUNT:      "messaging.batch.message_count",
+  // Network — transport / connection state
+  NETWORK_TRANSPORT:          "network.transport",
+  NETWORK_CONNECTION_TYPE:    "network.connection.type",
+  // Process / runtime
+  PROCESS_PID:                "process.pid",
+  PROCESS_RUNTIME_NAME:       "process.runtime.name",
+  PROCESS_RUNTIME_VERSION:    "process.runtime.version",
+  // Service identification
+  SERVICE_NAME:               "service.name",
+  SERVICE_VERSION:             "service.version",
+  SERVICE_INSTANCE_ID:        "service.instance.id",
+  // Telemetry SDK self-identification
+  TELEMETRY_SDK_NAME:         "telemetry.sdk.name",
+  TELEMETRY_SDK_LANGUAGE:     "telemetry.sdk.language",
+  TELEMETRY_SDK_VERSION:      "telemetry.sdk.version",
 });
 
 module.exports = {

package/lib/retention.js

@@ -445,11 +445,17 @@ function create(opts) {
 //   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)
+  "pci-dss":  C.TIME.days(365),        // 12 months — PCI-DSS §10.7.1
+  "hipaa":    C.TIME.days(365 * 6),    // 6 years — 45 CFR §164.316(b)(2)(i)
+  "sox":      C.TIME.days(365 * 7),    // 7 years — Sarbanes-Oxley §802
+  "soc2":     C.TIME.days(365),        // 1 year — typical SOC 2 audit window
+  "dora":     C.TIME.days(365 * 5),    // 5 years — DORA Article 17 incident logs
+  "nis2":     C.TIME.days(365 * 3),    // 3 years — NIS2 Art. 23 incident reporting
+  "cra":      C.TIME.days(365 * 5),    // 5 years — CRA Art. 14 vulnerability handling logs
+  "lgpd-br":  C.TIME.days(365 * 5),    // 5 years — Brazil LGPD Art. 16 + fiscal-record minimum
+  "appi-jp":  C.TIME.days(365 * 3),    // 3 years — Japan APPI handler-of-record requirement
+  "pdpa-sg":  C.TIME.days(365 * 1),    // 1 year — PDPA breach-notification audit trail
+  "uk-gdpr":  C.TIME.days(365 * 6),    // 6 years — UK ICO guidance, statutory limit alignment
 });
 
 // Operator passes a posture name + a candidate ttlMs; returns the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blamejs/core",
-  "version": "0.7.91",
+  "version": "0.7.92",
   "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:6f73b142-9c72-4abc-84d6-2ae27582baa7",
+  "serialNumber": "urn:uuid:3879cfe5-c335-4b6c-9133-99b33bbd5666",
   "version": 1,
   "metadata": {
-    "timestamp": "2026-05-06T07:57:14.212Z",
+    "timestamp": "2026-05-06T08:05:33.048Z",
     "lifecycles": [
       {
         "phase": "build"
@@ -19,14 +19,14 @@
       }
     ],
     "component": {
-      "bom-ref": "@blamejs/core@0.7.91",
+      "bom-ref": "@blamejs/core@0.7.92",
       "type": "library",
       "name": "blamejs",
-      "version": "0.7.91",
+      "version": "0.7.92",
       "scope": "required",
       "author": "blamejs contributors",
       "description": "The Node framework that owns its stack.",
-      "purl": "pkg:npm/%40blamejs/core@0.7.91",
+      "purl": "pkg:npm/%40blamejs/core@0.7.92",
       "properties": [],
       "externalReferences": [
         {
@@ -54,7 +54,7 @@
   "components": [],
   "dependencies": [
     {
-      "ref": "@blamejs/core@0.7.91",
+      "ref": "@blamejs/core@0.7.92",
       "dependsOn": []
     }
   ]