@camstack/system 1.2.231 → 1.2.233

package/dist/builtins/snapshot/index.js

@@ -3,7 +3,8 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-DUSfUAgz.js");
+const require_dist = require("../../dist-D3lJV9M7.js");
+const require_snapshot_courtesy = require("../../snapshot-courtesy-oeTWCXPv.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
 let _camstack_types_node = require("@camstack/types/node");
@@ -322,142 +323,6 @@ function raceForResult(promise, timeoutMs) {
 		if (timer) clearTimeout(timer);
 	});
 }
-//#endregion
-//#region src/builtins/snapshot/snapshot-courtesy.ts
-/**
-* State treatment for a camera that cannot produce a current frame.
-*
-* ── Why this exists ───────────────────────────────────────────────────────
-* A disabled, offline or sleeping camera has no frame, and until 2026-08-11 the
-* snapshot service simply had nothing to say about it: the media route answered
-* **404** and the client painted "Unavailable". Measured on the live grid that
-* day, 10 of 26 tiles were 404s — one genuinely disabled camera plus nine dead
-* legacy rows. A 404 is indistinguishable from a broken camera, so an operator
-* who deliberately switched a camera off saw the same thing as a fault ([D62]:
-* "an off switch is REPORTED off; disabled must never look like broken").
-*
-* So the service answers with an image that SAYS what is going on, carrying
-* the camera's own name. When a real cached frame exists it remains visible
-* under the treatment; otherwise the generated courtesy background is used.
-*
-* ── Why sharp and not ffmpeg ──────────────────────────────────────────────
-* The first draft of this file shelled out to `ffmpeg` with a `drawtext`
-* filter. That was written before the resize path was measured, and it was the
-* wrong call for the same reason: this runs in the snapshot wrapper, a system
-* builtin loaded in the hub's ROOT process, so every render was a fork + exec
-* on the loop that serves the API — 52 ms against sharp's 4.8 ms in that
-* container, to draw two lines of text.
-*
-* `terminal-frame-renderer.ts` already renders text this way (SVG → sharp), so
-* this is the house pattern rather than a new one. It also drops the font-PATH
-* probing the ffmpeg version needed: an SVG names a font FAMILY and fontconfig
-* resolves it — verified in the hub image, where `fc-match "DejaVu Sans Mono"`
-* answers with the real file.
-*
-* Rendering is pure input → bytes with no I/O of its own, and the geometry and
-* escaping are separated out so they stay testable without rasterizing.
-*/
-/**
-* Font stack for the rendered text. Family names, not paths — librsvg resolves
-* them through fontconfig, and the trailing generics keep a host without DejaVu
-* rendering something legible instead of nothing.
-*/
-var COURTESY_FONT_STACK = "DejaVu Sans,DejaVu Sans Mono,Helvetica,Arial,sans-serif";
-/** The word the frame carries. Deliberately the operator's vocabulary. */
-function courtesyLabel(reason) {
-	switch (reason) {
-		case "disabled": return "Disabled";
-		case "offline": return "Offline";
-		case "sleeping": return "Sleeping";
-		case "unreachable": return "Unreachable";
-		case "waking": return "Waking";
-	}
-}
-/**
-* Background per reason. A disabled camera is a DELIBERATE state and must not
-* read as an alarm, so it is neutral grey; offline is a fault and is warmer.
-*/
-function courtesyBackground(reason) {
-	switch (reason) {
-		case "disabled": return "#2b2b31";
-		case "offline": return "#3a2b2b";
-		case "sleeping": return "#232b3a";
-		case "waking": return "#243247";
-		case "unreachable": return "#3a2b2b";
-	}
-}
-/** XML escaping for text placed inside an SVG `<text>` node. */
-function escapeCourtesyText(value) {
-	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
-}
-/**
-* The SVG the frame is rasterized from: the state large and centred, the
-* camera's name under it, smaller and dimmer.
-*
-* Sizes derive from the width so a 240 px grid tile and a 1920 px full-bleed
-* frame read the same, with a floor so a thumbnail stays legible.
-*/
-function buildCourtesySvg(spec) {
-	return buildStateSvg(spec, false);
-}
-/**
-* The same state treatment as a courtesy frame, but translucent so the last
-* real camera frame remains visible underneath it.
-*/
-function buildCourtesyOverlaySvg(spec) {
-	return buildStateSvg(spec, true);
-}
-function buildStateSvg(spec, overlay) {
-	const stateSize = Math.max(12, Math.round(spec.width / 12));
-	const nameSize = Math.max(9, Math.round(spec.width / 26));
-	const state = escapeCourtesyText(courtesyLabel(spec.reason));
-	const name = escapeCourtesyText(spec.deviceName);
-	const midY = spec.height / 2;
-	const washOpacity = overlay ? "0.62" : "1";
-	const textStroke = Math.max(1, Math.round(spec.width / 320));
-	return [
-		`<svg xmlns="http://www.w3.org/2000/svg" width="${String(spec.width)}" height="${String(spec.height)}">`,
-		`<rect width="100%" height="100%" fill="${courtesyBackground(spec.reason)}" fill-opacity="${washOpacity}"/>`,
-		`<g font-family="${COURTESY_FONT_STACK}" text-anchor="middle" paint-order="stroke" stroke="#111118" stroke-width="${String(textStroke)}">`,
-		`<text x="50%" y="${String(Math.round(midY))}" font-size="${String(stateSize)}" fill="#e8e8ee">${state}</text>`,
-		`<text x="50%" y="${String(Math.round(midY + stateSize))}" font-size="${String(nameSize)}" fill="#9a9aa8">${name}</text>`,
-		`</g></svg>`
-	].join("");
-}
-/** Cache key — a courtesy frame is a pure function of these four. */
-function courtesyCacheKey(spec) {
-	return `${spec.reason}:${String(spec.width)}x${String(spec.height)}:${spec.deviceName}`;
-}
-/**
-* Render the frame.
-*
-* Rejects on failure — the caller decides what to do, exactly as `resizeJpeg`
-* does, so a broken courtesy path is never mistaken for a broken camera.
-*/
-function renderCourtesyJpeg(spec) {
-	return (0, sharp.default)(Buffer.from(buildCourtesySvg(spec))).jpeg({ quality: 82 }).toBuffer().then((bytes) => {
-		if (bytes.length === 0) throw new Error("courtesy frame produced no bytes");
-		return bytes;
-	});
-}
-/**
-* Paint the state treatment over a real cached frame.
-*
-* The source dimensions are authoritative: overlays preserve the original
-* frame rather than resizing it to the generated courtesy-frame default.
-*/
-async function renderCourtesyOverlayJpeg(background, spec) {
-	const metadata = await (0, sharp.default)(background).metadata();
-	if (!metadata.width || !metadata.height) throw new Error("cached snapshot has no renderable dimensions");
-	const overlay = Buffer.from(buildCourtesyOverlaySvg({
-		...spec,
-		width: metadata.width,
-		height: metadata.height
-	}));
-	const bytes = await (0, sharp.default)(background).composite([{ input: overlay }]).jpeg({ quality: 82 }).toBuffer();
-	if (bytes.length === 0) throw new Error("courtesy overlay produced no bytes");
-	return bytes;
-}
 var NativeSnapshotFatigue = class {
 	baseMs;
 	maxMs;
@@ -2346,7 +2211,7 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 	async courtesyFrame(deviceId, reason, deviceName) {
 		const width = 640;
 		const height = Math.round(width * 9 / 16);
-		const key = courtesyCacheKey({
+		const key = require_snapshot_courtesy.courtesyCacheKey({
 			deviceName,
 			reason,
 			width,
@@ -2355,7 +2220,7 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 		const cached = this.courtesyFrames.get(key);
 		if (cached !== void 0) return cached;
 		try {
-			const bytes = await renderCourtesyJpeg({
+			const bytes = await require_snapshot_courtesy.renderCourtesyJpeg({
 				deviceName,
 				reason,
 				width,
@@ -2425,7 +2290,7 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 			contentType: "image/jpeg"
 		};
 		try {
-			const bytes = await renderCourtesyOverlayJpeg(Buffer.from(hit.data.base64, "base64"), {
+			const bytes = await require_snapshot_courtesy.renderCourtesyOverlayJpeg(Buffer.from(hit.data.base64, "base64"), {
 				deviceName: resolvedName,
 				reason
 			});

package/dist/builtins/snapshot/index.mjs

@@ -1,4 +1,5 @@
-import { $t as DeviceFeature, F as bareAddonId, I as batteryCapability, Jt as errMsg, Rt as snapshotCapability, Ut as streamQualityLabel, W as deriveBatteryPresence, Yt as BaseAddon, i as BatteryStatusSchema, mn as nodePin, tn as DeviceType, xn as EventCategory } from "../../dist-Zhe9cTnK.mjs";
+import { $t as DeviceFeature, F as bareAddonId, I as batteryCapability, Jt as errMsg, Rt as snapshotCapability, Ut as streamQualityLabel, W as deriveBatteryPresence, Yt as BaseAddon, i as BatteryStatusSchema, mn as nodePin, tn as DeviceType, xn as EventCategory } from "../../dist-BIvXRexm.mjs";
+import { i as renderCourtesyOverlayJpeg, n as courtesyCacheKey, r as renderCourtesyJpeg } from "../../snapshot-courtesy-LoJNgHHZ.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
 import { signExpiringUrl, verifyExpiringUrl } from "@camstack/types/node";
@@ -316,142 +317,6 @@ function raceForResult(promise, timeoutMs) {
 		if (timer) clearTimeout(timer);
 	});
 }
-//#endregion
-//#region src/builtins/snapshot/snapshot-courtesy.ts
-/**
-* State treatment for a camera that cannot produce a current frame.
-*
-* ── Why this exists ───────────────────────────────────────────────────────
-* A disabled, offline or sleeping camera has no frame, and until 2026-08-11 the
-* snapshot service simply had nothing to say about it: the media route answered
-* **404** and the client painted "Unavailable". Measured on the live grid that
-* day, 10 of 26 tiles were 404s — one genuinely disabled camera plus nine dead
-* legacy rows. A 404 is indistinguishable from a broken camera, so an operator
-* who deliberately switched a camera off saw the same thing as a fault ([D62]:
-* "an off switch is REPORTED off; disabled must never look like broken").
-*
-* So the service answers with an image that SAYS what is going on, carrying
-* the camera's own name. When a real cached frame exists it remains visible
-* under the treatment; otherwise the generated courtesy background is used.
-*
-* ── Why sharp and not ffmpeg ──────────────────────────────────────────────
-* The first draft of this file shelled out to `ffmpeg` with a `drawtext`
-* filter. That was written before the resize path was measured, and it was the
-* wrong call for the same reason: this runs in the snapshot wrapper, a system
-* builtin loaded in the hub's ROOT process, so every render was a fork + exec
-* on the loop that serves the API — 52 ms against sharp's 4.8 ms in that
-* container, to draw two lines of text.
-*
-* `terminal-frame-renderer.ts` already renders text this way (SVG → sharp), so
-* this is the house pattern rather than a new one. It also drops the font-PATH
-* probing the ffmpeg version needed: an SVG names a font FAMILY and fontconfig
-* resolves it — verified in the hub image, where `fc-match "DejaVu Sans Mono"`
-* answers with the real file.
-*
-* Rendering is pure input → bytes with no I/O of its own, and the geometry and
-* escaping are separated out so they stay testable without rasterizing.
-*/
-/**
-* Font stack for the rendered text. Family names, not paths — librsvg resolves
-* them through fontconfig, and the trailing generics keep a host without DejaVu
-* rendering something legible instead of nothing.
-*/
-var COURTESY_FONT_STACK = "DejaVu Sans,DejaVu Sans Mono,Helvetica,Arial,sans-serif";
-/** The word the frame carries. Deliberately the operator's vocabulary. */
-function courtesyLabel(reason) {
-	switch (reason) {
-		case "disabled": return "Disabled";
-		case "offline": return "Offline";
-		case "sleeping": return "Sleeping";
-		case "unreachable": return "Unreachable";
-		case "waking": return "Waking";
-	}
-}
-/**
-* Background per reason. A disabled camera is a DELIBERATE state and must not
-* read as an alarm, so it is neutral grey; offline is a fault and is warmer.
-*/
-function courtesyBackground(reason) {
-	switch (reason) {
-		case "disabled": return "#2b2b31";
-		case "offline": return "#3a2b2b";
-		case "sleeping": return "#232b3a";
-		case "waking": return "#243247";
-		case "unreachable": return "#3a2b2b";
-	}
-}
-/** XML escaping for text placed inside an SVG `<text>` node. */
-function escapeCourtesyText(value) {
-	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
-}
-/**
-* The SVG the frame is rasterized from: the state large and centred, the
-* camera's name under it, smaller and dimmer.
-*
-* Sizes derive from the width so a 240 px grid tile and a 1920 px full-bleed
-* frame read the same, with a floor so a thumbnail stays legible.
-*/
-function buildCourtesySvg(spec) {
-	return buildStateSvg(spec, false);
-}
-/**
-* The same state treatment as a courtesy frame, but translucent so the last
-* real camera frame remains visible underneath it.
-*/
-function buildCourtesyOverlaySvg(spec) {
-	return buildStateSvg(spec, true);
-}
-function buildStateSvg(spec, overlay) {
-	const stateSize = Math.max(12, Math.round(spec.width / 12));
-	const nameSize = Math.max(9, Math.round(spec.width / 26));
-	const state = escapeCourtesyText(courtesyLabel(spec.reason));
-	const name = escapeCourtesyText(spec.deviceName);
-	const midY = spec.height / 2;
-	const washOpacity = overlay ? "0.62" : "1";
-	const textStroke = Math.max(1, Math.round(spec.width / 320));
-	return [
-		`<svg xmlns="http://www.w3.org/2000/svg" width="${String(spec.width)}" height="${String(spec.height)}">`,
-		`<rect width="100%" height="100%" fill="${courtesyBackground(spec.reason)}" fill-opacity="${washOpacity}"/>`,
-		`<g font-family="${COURTESY_FONT_STACK}" text-anchor="middle" paint-order="stroke" stroke="#111118" stroke-width="${String(textStroke)}">`,
-		`<text x="50%" y="${String(Math.round(midY))}" font-size="${String(stateSize)}" fill="#e8e8ee">${state}</text>`,
-		`<text x="50%" y="${String(Math.round(midY + stateSize))}" font-size="${String(nameSize)}" fill="#9a9aa8">${name}</text>`,
-		`</g></svg>`
-	].join("");
-}
-/** Cache key — a courtesy frame is a pure function of these four. */
-function courtesyCacheKey(spec) {
-	return `${spec.reason}:${String(spec.width)}x${String(spec.height)}:${spec.deviceName}`;
-}
-/**
-* Render the frame.
-*
-* Rejects on failure — the caller decides what to do, exactly as `resizeJpeg`
-* does, so a broken courtesy path is never mistaken for a broken camera.
-*/
-function renderCourtesyJpeg(spec) {
-	return sharp(Buffer.from(buildCourtesySvg(spec))).jpeg({ quality: 82 }).toBuffer().then((bytes) => {
-		if (bytes.length === 0) throw new Error("courtesy frame produced no bytes");
-		return bytes;
-	});
-}
-/**
-* Paint the state treatment over a real cached frame.
-*
-* The source dimensions are authoritative: overlays preserve the original
-* frame rather than resizing it to the generated courtesy-frame default.
-*/
-async function renderCourtesyOverlayJpeg(background, spec) {
-	const metadata = await sharp(background).metadata();
-	if (!metadata.width || !metadata.height) throw new Error("cached snapshot has no renderable dimensions");
-	const overlay = Buffer.from(buildCourtesyOverlaySvg({
-		...spec,
-		width: metadata.width,
-		height: metadata.height
-	}));
-	const bytes = await sharp(background).composite([{ input: overlay }]).jpeg({ quality: 82 }).toBuffer();
-	if (bytes.length === 0) throw new Error("courtesy overlay produced no bytes");
-	return bytes;
-}
 var NativeSnapshotFatigue = class {
 	baseMs;
 	maxMs;

package/dist/builtins/sqlite-storage/filesystem-storage.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-DUSfUAgz.js");
+const require_dist = require("../../dist-D3lJV9M7.js");
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");

package/dist/builtins/sqlite-storage/filesystem-storage.addon.mjs

@@ -1,4 +1,4 @@
-import { Ht as storageProviderCapability, Yt as BaseAddon, nt as filesystemBrowseCapability } from "../../dist-Zhe9cTnK.mjs";
+import { Ht as storageProviderCapability, Yt as BaseAddon, nt as filesystemBrowseCapability } from "../../dist-BIvXRexm.mjs";
 import { randomUUID } from "node:crypto";
 import { mkdir, readdir, realpath, statfs } from "node:fs/promises";
 import * as path$1 from "node:path";

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-DUSfUAgz.js");
+const require_dist = require("../../dist-D3lJV9M7.js");
 const require_hub_cap_forward = require("../../hub-cap-forward-DmHNjbB0.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { Bt as storageMigrationCapability, D as StorageMigrationJobSchema, E as StorageLocationTypeSchema, Lt as settingsStoreCapability, R as collectSecretConfigKeys, St as modeMayWrite, T as StorageLocationModeSchema, Yt as BaseAddon, bt as mayWriteToLocation, et as evictionPolicyOfLocation, g as REDACTED_SECRET, hn as parseJsonObject, it as gbToBytes, jt as resolveLocationMode, m as LegacyStorageLocationDefaultSchema, pt as legacyModeOf, qt as withLocationMode, st as isLocationEnabled, w as StorageCleanupJobSchema, xn as EventCategory, yt as mayReadLocation, zt as storageCapability } from "../../dist-Zhe9cTnK.mjs";
+import { Bt as storageMigrationCapability, D as StorageMigrationJobSchema, E as StorageLocationTypeSchema, Lt as settingsStoreCapability, R as collectSecretConfigKeys, St as modeMayWrite, T as StorageLocationModeSchema, Yt as BaseAddon, bt as mayWriteToLocation, et as evictionPolicyOfLocation, g as REDACTED_SECRET, hn as parseJsonObject, it as gbToBytes, jt as resolveLocationMode, m as LegacyStorageLocationDefaultSchema, pt as legacyModeOf, qt as withLocationMode, st as isLocationEnabled, w as StorageCleanupJobSchema, xn as EventCategory, yt as mayReadLocation, zt as storageCapability } from "../../dist-BIvXRexm.mjs";
 import { t as HUB_CAP_FWD_ACTION } from "../../hub-cap-forward-BdT320dq.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";

package/dist/builtins/system-config/system-config.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-DUSfUAgz.js");
+const require_dist = require("../../dist-D3lJV9M7.js");
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

package/dist/builtins/system-config/system-config.addon.mjs

@@ -1,4 +1,4 @@
-import { Jt as errMsg, Yt as BaseAddon, fn as hydrateSchema } from "../../dist-Zhe9cTnK.mjs";
+import { Jt as errMsg, Yt as BaseAddon, fn as hydrateSchema } from "../../dist-BIvXRexm.mjs";
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

package/dist/builtins/winston-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-DUSfUAgz.js");
+const require_dist = require("../../dist-D3lJV9M7.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);

package/dist/builtins/winston-logging/index.mjs

@@ -1,4 +1,4 @@
-import { Yt as BaseAddon, gt as logDestinationCapability } from "../../dist-Zhe9cTnK.mjs";
+import { Yt as BaseAddon, gt as logDestinationCapability } from "../../dist-BIvXRexm.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import * as path$1 from "node:path";
 import path from "node:path";

package/dist/{custom-action-registry-CM03Xda0.mjs → custom-action-registry-CFHYDHAu.mjs}

@@ -1,4 +1,4 @@
-import { G as describeCustomActions } from "./dist-Zhe9cTnK.mjs";
+import { G as describeCustomActions } from "./dist-BIvXRexm.mjs";
 //#region src/kernel/custom-action-registry.ts
 /**
 * CustomActionRegistry — per-process registry of addon custom actions.

package/dist/{custom-action-registry-DAFhWd0h.js → custom-action-registry-CWFK5UDj.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-DUSfUAgz.js");
+const require_dist = require("./dist-D3lJV9M7.js");
 //#region src/kernel/custom-action-registry.ts
 /**
 * CustomActionRegistry — per-process registry of addon custom actions.