@blamejs/core 0.7.90 → 0.7.91

package/CHANGELOG.md

@@ -8,6 +8,8 @@ upgrading across more than a few patches at a time.
 
 ## v0.7.x
 
+- **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`).
 
 - **0.7.89** (2026-05-06) — Three additive primitives bundled: TUS resumable uploads, WebAuthn Signal API, DPoP server-issued nonce challenge. **`b.middleware.tusUpload({ mountPath, store, ... })`** implements the [tus.io](https://tus.io) v1.0.0 resumable-upload protocol — POST creates uploads, HEAD reports offsets, PATCH appends chunks, DELETE terminates. Supported extensions: `creation`, `creation-with-upload`, `expiration`, `checksum`, `termination`. The `checksum` extension defaults to PQC-first algorithms (`sha3-512`, `shake256`) — operators add classical algorithms explicitly via `checksumAlgorithms`. A built-in `b.middleware.tusUpload.memoryStore({ maxSize })` ships for development; production operators implement the `{ create, head, append, setLength, terminate, purgeExpired, getBuffer }` shape against their object-store backend. Bounded chunk collection routes through `safeBuffer.boundedChunkCollector` (cap-enforced at push time, no 10-GiB pre-collect). Concatenation extension (parallel-chunk assembly) deferred — operators that need it compose against their store layer; re-open if a store-layer-only solution proves insufficient. **`b.auth.passkey.signalUnknownCredential` / `signalAllAcceptedCredentials` / `signalCurrentUserDetails`** add the W3C WebAuthn Signal API descriptor builders — when the browser implements `PublicKeyCredential.signal*`, operators emit the matching JSON descriptor to clean up stale passkeys, refresh user details, and surface revocations without forcing a re-registration. All three validate `rpId` / `userId` / `credentialId` shape (base64url) and refuse `name`/`displayName` longer than 256 chars. **`b.middleware.dpop({ requireNonce: true, nonceRotateSec? })`** implements RFC 9449 §8 server-issued DPoP-Nonce challenge — the middleware emits `DPoP-Nonce: <fresh>` on every 401 response, refuses proofs whose `nonce` claim isn't in the rolling current+previous pair, and refreshes the nonce on every successful response. The rolling-pair manager rotates without timers (lazy maybe-rotate on access); no operator nonce store needed. The `getNonce` callback path stays intact for operator-managed nonce flows.

package/lib/compliance.js

@@ -38,7 +38,29 @@ var audit = lazyRequire(function () { return require("./audit"); });
 // passing an unknown name get a typo-surfacing throw at set-time, not
 // silent fall-through to no-op.
 var KNOWN_POSTURES = Object.freeze([
-  "hipaa", "pci-dss", "gdpr", "soc2", "dora", "sox",
+  // ---- US Federal / Sectoral ----
+  "hipaa",       // Health Insurance Portability and Accountability Act
+  "pci-dss",     // Payment Card Industry Data Security Standard
+  "soc2",        // System and Organization Controls 2
+  "sox",         // Sarbanes-Oxley
+  "wmhmda",      // Washington My Health My Data Act (added 2026)
+  "bipa",        // Illinois Biometric Information Privacy Act (added 2026)
+  // ---- US State Privacy ----
+  "ccpa",        // California Consumer Privacy Act / CPRA (added 2026)
+  // ---- EU / EEA ----
+  "gdpr",        // General Data Protection Regulation
+  "dora",        // EU Digital Operational Resilience Act
+  "nis2",        // EU Network and Information Security Directive 2 (added 2026)
+  "cra",         // EU Cyber Resilience Act (added 2026)
+  "ai-act",      // EU AI Act (added 2026)
+  // ---- Latin America / APAC ----
+  "lgpd-br",     // Brazil Lei Geral de Proteção de Dados (added 2026)
+  "pipl-cn",     // China Personal Information Protection Law (added 2026)
+  "appi-jp",     // Japan Act on Protection of Personal Information (added 2026)
+  "pdpa-sg",     // Singapore Personal Data Protection Act (added 2026)
+  // ---- Canada / UK ----
+  "pipeda-ca",   // Canada Personal Information Protection and Electronic Documents Act (added 2026)
+  "uk-gdpr",     // UK General Data Protection Regulation (added 2026)
 ]);
 
 var STATE = { posture: null, setAt: null };

package/lib/observability.js

@@ -143,9 +143,64 @@ function safeEvent(name, value, labels) {
   catch (_e) { /* hot-path observability sink — drops silent on internal throws */ }
 }
 
+// OpenTelemetry semantic-convention attribute names — the operator-
+// facing canonical vocabulary the framework's b.observability /
+// b.tracing / b.metrics emitters use when building span / metric
+// attributes. Tracking the OTel semconv stable namespace (1.27+)
+// directly here means operators wiring the framework's tap into an
+// OTel SDK don't need to maintain an aliasing table — the names are
+// already correct.
+//
+// When operators call b.observability.event() / safeEvent(), they
+// pass attribute keys that should match the keys below. The map is
+// frozen — adding a new attribute requires a release.
+//
+// Reference: https://opentelemetry.io/docs/specs/semconv/general/attributes/
+var SEMCONV = Object.freeze({
+  // HTTP server (stable per OTel semconv)
+  HTTP_REQUEST_METHOD:        "http.request.method",
+  HTTP_REQUEST_BODY_SIZE:     "http.request.body.size",
+  HTTP_RESPONSE_STATUS_CODE:  "http.response.status_code",
+  HTTP_RESPONSE_BODY_SIZE:    "http.response.body.size",
+  HTTP_ROUTE:                 "http.route",
+  // Server / network
+  SERVER_ADDRESS:             "server.address",
+  SERVER_PORT:                "server.port",
+  CLIENT_ADDRESS:             "client.address",
+  CLIENT_PORT:                "client.port",
+  NETWORK_PEER_ADDRESS:       "network.peer.address",
+  NETWORK_PROTOCOL_NAME:      "network.protocol.name",
+  NETWORK_PROTOCOL_VERSION:   "network.protocol.version",
+  // URL
+  URL_FULL:                   "url.full",
+  URL_PATH:                   "url.path",
+  URL_QUERY:                  "url.query",
+  URL_SCHEME:                 "url.scheme",
+  // User agent
+  USER_AGENT_ORIGINAL:        "user_agent.original",
+  // Database
+  DB_SYSTEM:                  "db.system",
+  DB_NAMESPACE:               "db.namespace",
+  DB_OPERATION_NAME:          "db.operation.name",
+  DB_QUERY_TEXT:              "db.query.text",
+  // Messaging
+  MESSAGING_SYSTEM:           "messaging.system",
+  MESSAGING_OPERATION:        "messaging.operation",
+  MESSAGING_DESTINATION_NAME: "messaging.destination.name",
+  // Auth / session
+  USER_ID:                    "user.id",
+  SESSION_ID:                 "session.id",
+  // Errors
+  ERROR_TYPE:                 "error.type",
+  EXCEPTION_TYPE:             "exception.type",
+  EXCEPTION_MESSAGE:          "exception.message",
+  EXCEPTION_STACKTRACE:       "exception.stacktrace",
+});
+
 module.exports = {
   tap:        tap,
   event:      event,
   safeEvent:  safeEvent,
   setTap:     setTap,
+  SEMCONV:    SEMCONV,
 };

package/package.json

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