@blamejs/core 0.8.39 → 0.8.41

package/lib/resource-access-lock.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * b.resourceAccessLock — three-mode access-lock for arbitrary
+ * resources (data exports, scheduled jobs, file paths, queue
+ * partitions). Different from b.auth.accessLock — that one gates
+ * HTTP request flow; this one gates non-HTTP-shaped operator
+ * actions. Both share the open / read-only / locked vocabulary.
+ *
+ *   var exportLock = b.resourceAccessLock.create({
+ *     resource:     "data-export-jobs",
+ *     startMode:    "open",
+ *     audit:        b.audit,
+ *   });
+ *
+ *   if (!exportLock.permits("write")) {
+ *     throw new b.resourceAccessLock.ResourceAccessLockError(
+ *       "resource-access-lock/refused",
+ *       "data export refused: lock mode is " + exportLock.mode());
+ *   }
+ *   await runExportJob();
+ *
+ *   exportLock.set("locked", { actor: "alice", reason: "incident-42 freeze" });
+ *
+ * Mode semantics:
+ *   open       — every action permitted
+ *   read-only  — actions tagged "read" permitted; "write" refused
+ *   locked     — every action refused
+ *
+ * Audit shape:
+ *   resourceaccesslock.mode_changed — {resource, from, to, actor, reason}
+ *   resourceaccesslock.refused      — {resource, action, mode, actor}
+ */
+
+var lazyRequire = require("./lazy-require");
+var validateOpts = require("./validate-opts");
+var { defineClass } = require("./framework-error");
+
+var audit = lazyRequire(function () { return require("./audit"); });
+
+var ResourceAccessLockError = defineClass("ResourceAccessLockError",
+  { alwaysPermanent: true });
+
+var VALID_MODES = Object.freeze({ open: 1, "read-only": 1, locked: 1 });
+var READ_ACTIONS = Object.freeze({ read: 1, list: 1, get: 1, query: 1, "read-only": 1 });
+
+function create(opts) {
+  opts = opts || {};
+  validateOpts(opts, ["resource", "startMode", "audit"], "resourceAccessLock.create");
+  validateOpts.requireNonEmptyString(opts.resource, "resource",
+    ResourceAccessLockError, "resource-access-lock/no-resource");
+  var startMode = opts.startMode || "open";
+  if (!VALID_MODES[startMode]) {
+    throw new ResourceAccessLockError(
+      "resource-access-lock/bad-start-mode",
+      "startMode must be one of: " + Object.keys(VALID_MODES).join(" / "));
+  }
+  var auditOn = opts.audit !== false;
+  var resource = opts.resource;
+  var mode = startMode;
+
+  function _emit(action, outcome, meta) {
+    if (!auditOn) return;
+    try {
+      audit().safeEmit({
+        action: action, outcome: outcome,
+        metadata: Object.assign({ resource: resource }, meta || {}),
+      });
+    } catch (_e) { /* audit best-effort */ }
+  }
+
+  function permits(action) {
+    if (mode === "open") return true;
+    if (mode === "locked") return false;
+    return !!READ_ACTIONS[action];
+  }
+
+  function set(newMode, ctx) {
+    ctx = ctx || {};
+    if (!VALID_MODES[newMode]) {
+      throw new ResourceAccessLockError(
+        "resource-access-lock/bad-mode",
+        "set: mode must be one of: " + Object.keys(VALID_MODES).join(" / "));
+    }
+    var prev = mode;
+    mode = newMode;
+    _emit("resourceaccesslock.mode_changed", "success", {
+      from: prev, to: newMode,
+      actor: ctx.actor || null, reason: ctx.reason || null,
+    });
+  }
+
+  function assertPermits(action, ctx) {
+    if (permits(action)) return;
+    _emit("resourceaccesslock.refused", "failure", {
+      action: action, mode: mode,
+      actor: (ctx && ctx.actor) || null,
+    });
+    throw new ResourceAccessLockError(
+      "resource-access-lock/refused",
+      resource + " refuses '" + action + "': lock mode is '" + mode + "'");
+  }
+
+  return {
+    resource:      resource,
+    mode:          function () { return mode; },
+    set:           set,
+    permits:       permits,
+    assertPermits: assertPermits,
+  };
+}
+
+module.exports = {
+  create:                   create,
+  VALID_MODES:              Object.freeze(Object.keys(VALID_MODES)),
+  ResourceAccessLockError:  ResourceAccessLockError,
+};

package/lib/vault/index.js

@@ -294,10 +294,33 @@ var vaultAad = require("../vault-aad");
 
 var sealPemFileModule = require("./seal-pem-file");
 
+// _zeroizeAndReplace — best-effort secureZero of prior in-memory keys
+// before a swap. V8 strings can't be reliably overwritten (string
+// interning + GC managed), so the pre-swap pass converts each PEM
+// string to a Buffer, secureZeros the Buffer, and rebinds the
+// property to "ZEROED" before the new keys land. The string copy
+// inside V8 may still linger until GC; this just removes the
+// largest-window heap copy (the ones held by `keys`).
+function _zeroizeAndReplace(replacement) {
+  if (!keys) { keys = replacement; return; }
+  Object.keys(keys).forEach(function (k) {
+    var v = keys[k];
+    if (typeof v === "string" && v.length > 0) {
+      try {
+        var buf = Buffer.from(v, "utf8");
+        safeBuffer.secureZero(buf);
+      } catch (_e) { /* best-effort */ }
+      keys[k] = "ZEROED";
+    }
+  });
+  keys = replacement;
+}
+
 module.exports = {
   init:                  init,
   seal:                  seal,
   unseal:                unseal,
+  _zeroizeAndReplace:    _zeroizeAndReplace,
   aad:                   vaultAad,
   getKeysJson:           getKeysJson,
   getCurrentPassphrase:  getCurrentPassphrase,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blamejs/core",
-  "version": "0.8.39",
+  "version": "0.8.41",
   "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:319bfdfd-c9b3-4f86-a42e-c3441466295e",
+  "serialNumber": "urn:uuid:a6849ba0-e669-440c-8a01-b08d37e28a1e",
   "version": 1,
   "metadata": {
-    "timestamp": "2026-05-07T16:17:54.954Z",
+    "timestamp": "2026-05-07T17:22:17.744Z",
     "lifecycles": [
       {
         "phase": "build"
@@ -19,14 +19,14 @@
       }
     ],
     "component": {
-      "bom-ref": "@blamejs/core@0.8.39",
+      "bom-ref": "@blamejs/core@0.8.41",
       "type": "library",
       "name": "blamejs",
-      "version": "0.8.39",
+      "version": "0.8.41",
       "scope": "required",
       "author": "blamejs contributors",
       "description": "The Node framework that owns its stack.",
-      "purl": "pkg:npm/%40blamejs/core@0.8.39",
+      "purl": "pkg:npm/%40blamejs/core@0.8.41",
       "properties": [],
       "externalReferences": [
         {
@@ -54,7 +54,7 @@
   "components": [],
   "dependencies": [
     {
-      "ref": "@blamejs/core@0.8.39",
+      "ref": "@blamejs/core@0.8.41",
       "dependsOn": []
     }
   ]