@camstack/system 1.2.91 → 1.2.93

package/dist/builtins/snapshot/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-9Gfk4KOk.js");
+const require_dist = require("../../dist-BMus2E5R.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
 let _camstack_types_node = require("@camstack/types/node");
@@ -299,6 +299,7 @@ function courtesyLabel(reason) {
 		case "disabled": return "Disabled";
 		case "offline": return "Offline";
 		case "sleeping": return "Sleeping";
+		case "unreachable": return "Unreachable";
 	}
 }
 /**
@@ -310,6 +311,7 @@ function courtesyBackground(reason) {
 		case "disabled": return "#2b2b31";
 		case "offline": return "#3a2b2b";
 		case "sleeping": return "#232b3a";
+		case "unreachable": return "#3a2b2b";
 	}
 }
 /** XML escaping for text placed inside an SVG `<text>` node. */
@@ -1355,16 +1357,18 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 			});
 			return hit ? hit.data : null;
 		}
-		if (!force && isBatteryDevice && await this.isDeviceSleeping(deviceId)) {
-			log.debug("snapshot: sleeping battery cam and no force — serving cache, not capturing", {
+		const presence = isBatteryDevice ? await this.readBatteryPresence(deviceId) : "awake";
+		if (!force && presence !== "awake") {
+			log.debug("snapshot: battery cam not awake and no force — serving cache, not capturing", {
 				tags: { deviceId },
 				meta: {
+					presence,
 					hasCache: hit !== void 0,
 					ageMs: hit ? now - hit.ts : null
 				}
 			});
 			if (hit) return hit.data;
-			return await this.courtesyImage(deviceId, "sleeping", deviceName);
+			return await this.courtesyImage(deviceId, presence, deviceName);
 		}
 		const flightKey = `${deviceId}:${effectiveStreamId ?? "auto"}`;
 		const flight = this.captureFlight.run(flightKey, () => this.captureFresh({
@@ -1727,18 +1731,35 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 	* cache hit returns before we get here.
 	*/
 	async isDeviceSleeping(deviceId) {
+		return await this.readBatteryPresence(deviceId) !== "awake";
+	}
+	/**
+	* The device's three-valued battery presence (D173) — `awake`, `sleeping`,
+	* or `unreachable`. Same mirror read as the sleep gate, one derivation
+	* (`deriveBatteryPresence`) so this layer cannot disagree with the badge or
+	* the stream error about what a camera is doing.
+	*
+	* A failed read answers `awake`: unknown must never become a fault badge,
+	* and "assume awake" is the pre-existing, deliberately conservative failure
+	* direction of the gate this replaces.
+	*/
+	async readBatteryPresence(deviceId) {
 		try {
 			const handle = (await this.ctx.fetchDevice(deviceId)).state.battery;
 			await handle.refresh();
 			const raw = handle.value;
 			const parsed = require_dist.BatteryStatusSchema.safeParse(raw);
-			return parsed.success && parsed.data.sleeping;
+			if (!parsed.success) return "awake";
+			return require_dist.deriveBatteryPresence({
+				status: parsed.data,
+				nowMs: Date.now()
+			});
 		} catch (err) {
 			this.ctx.logger.warn("snapshot: battery mirror read failed — assuming awake", {
 				tags: { deviceId },
 				meta: { error: require_dist.errMsg(err) }
 			});
-			return false;
+			return "awake";
 		}
 	}
 	/**

package/dist/builtins/snapshot/index.mjs

@@ -1,4 +1,4 @@
-import { Ct as DeviceType, It as nodePin, Ut as EventCategory, _t as BaseAddon, ct as snapshotCapability, ft as streamQualityLabel, gt as errMsg, i as BatteryStatusSchema, w as bareAddonId, xt as DeviceFeature } from "../../dist-DhrTd8LL.mjs";
+import { Lt as nodePin, St as DeviceFeature, Wt as EventCategory, _t as errMsg, i as BatteryStatusSchema, j as deriveBatteryPresence, lt as snapshotCapability, pt as streamQualityLabel, vt as BaseAddon, w as bareAddonId, wt as DeviceType } from "../../dist-F1XDQDE1.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
 import { signExpiringUrl, verifyExpiringUrl } from "@camstack/types/node";
@@ -293,6 +293,7 @@ function courtesyLabel(reason) {
 		case "disabled": return "Disabled";
 		case "offline": return "Offline";
 		case "sleeping": return "Sleeping";
+		case "unreachable": return "Unreachable";
 	}
 }
 /**
@@ -304,6 +305,7 @@ function courtesyBackground(reason) {
 		case "disabled": return "#2b2b31";
 		case "offline": return "#3a2b2b";
 		case "sleeping": return "#232b3a";
+		case "unreachable": return "#3a2b2b";
 	}
 }
 /** XML escaping for text placed inside an SVG `<text>` node. */
@@ -1349,16 +1351,18 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 			});
 			return hit ? hit.data : null;
 		}
-		if (!force && isBatteryDevice && await this.isDeviceSleeping(deviceId)) {
-			log.debug("snapshot: sleeping battery cam and no force — serving cache, not capturing", {
+		const presence = isBatteryDevice ? await this.readBatteryPresence(deviceId) : "awake";
+		if (!force && presence !== "awake") {
+			log.debug("snapshot: battery cam not awake and no force — serving cache, not capturing", {
 				tags: { deviceId },
 				meta: {
+					presence,
 					hasCache: hit !== void 0,
 					ageMs: hit ? now - hit.ts : null
 				}
 			});
 			if (hit) return hit.data;
-			return await this.courtesyImage(deviceId, "sleeping", deviceName);
+			return await this.courtesyImage(deviceId, presence, deviceName);
 		}
 		const flightKey = `${deviceId}:${effectiveStreamId ?? "auto"}`;
 		const flight = this.captureFlight.run(flightKey, () => this.captureFresh({
@@ -1721,18 +1725,35 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 	* cache hit returns before we get here.
 	*/
 	async isDeviceSleeping(deviceId) {
+		return await this.readBatteryPresence(deviceId) !== "awake";
+	}
+	/**
+	* The device's three-valued battery presence (D173) — `awake`, `sleeping`,
+	* or `unreachable`. Same mirror read as the sleep gate, one derivation
+	* (`deriveBatteryPresence`) so this layer cannot disagree with the badge or
+	* the stream error about what a camera is doing.
+	*
+	* A failed read answers `awake`: unknown must never become a fault badge,
+	* and "assume awake" is the pre-existing, deliberately conservative failure
+	* direction of the gate this replaces.
+	*/
+	async readBatteryPresence(deviceId) {
 		try {
 			const handle = (await this.ctx.fetchDevice(deviceId)).state.battery;
 			await handle.refresh();
 			const raw = handle.value;
 			const parsed = BatteryStatusSchema.safeParse(raw);
-			return parsed.success && parsed.data.sleeping;
+			if (!parsed.success) return "awake";
+			return deriveBatteryPresence({
+				status: parsed.data,
+				nowMs: Date.now()
+			});
 		} catch (err) {
 			this.ctx.logger.warn("snapshot: battery mirror read failed — assuming awake", {
 				tags: { deviceId },
 				meta: { error: errMsg(err) }
 			});
-			return false;
+			return "awake";
 		}
 	}
 	/**

package/dist/builtins/snapshot/snapshot-courtesy.d.ts

@@ -1,5 +1,15 @@
-/** Why a camera cannot produce a frame right now. */
-export type CourtesyReason = 'disabled' | 'offline' | 'sleeping';
+/**
+ * Why a camera cannot produce a frame right now.
+ *
+ * `sleeping` and `unreachable` are deliberately two reasons and not one. A
+ * battery camera in low-power mode is WORKING — that tile must not read as a
+ * fault, which is D62's rule in the third state — while a battery camera
+ * nothing has been heard from for hours is a genuine fault the operator has to
+ * see (a flat battery, or a camera off the LAN). Painting the second as the
+ * first is how a dead camera stayed green for 30 hours. The two are separated
+ * by `deriveBatteryPresence`, never by a caller's own guess.
+ */
+export type CourtesyReason = 'disabled' | 'offline' | 'sleeping' | 'unreachable';
 /** Default tile size when the caller asks for no particular width. */
 export declare const COURTESY_DEFAULT_WIDTH = 640;
 /** The word the frame carries. Deliberately the operator's vocabulary. */

package/dist/builtins/snapshot/snapshot.addon.d.ts

@@ -374,6 +374,17 @@ export declare class SnapshotAddon extends BaseAddon<SnapshotAddonConfig> {
      * cache hit returns before we get here.
      */
     private isDeviceSleeping;
+    /**
+     * The device's three-valued battery presence (D173) — `awake`, `sleeping`,
+     * or `unreachable`. Same mirror read as the sleep gate, one derivation
+     * (`deriveBatteryPresence`) so this layer cannot disagree with the badge or
+     * the stream error about what a camera is doing.
+     *
+     * A failed read answers `awake`: unknown must never become a fault badge,
+     * and "assume awake" is the pre-existing, deliberately conservative failure
+     * direction of the gate this replaces.
+     */
+    private readBatteryPresence;
     /**
      * True when at least one of the device's brokers is actively
      * streaming (status === 'streaming'). Used by the battery-cam guard

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-9Gfk4KOk.js");
+const require_dist = require("../../dist-BMus2E5R.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 { _t as BaseAddon, dt as storageProviderCapability, z as filesystemBrowseCapability } from "../../dist-DhrTd8LL.mjs";
+import { B as filesystemBrowseCapability, ft as storageProviderCapability, vt as BaseAddon } from "../../dist-F1XDQDE1.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/sqlite-storage/sqlite-settings.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-9Gfk4KOk.js");
+const require_dist = require("../../dist-BMus2E5R.js");
 let node_crypto = require("node:crypto");
 let node_fs = require("node:fs");
 let node_module = require("node:module");

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

@@ -1,4 +1,4 @@
-import { A as decodeVectorBase64, Dt as asJsonObject, Rt as parseJsonUnknown, _t as BaseAddon, f as RUNTIME_DEFAULTS, gt as errMsg, ht as vectorStoreCapability, k as dataStoreProviderCapability, mt as vectorDimFromBase64, w as bareAddonId } from "../../dist-DhrTd8LL.mjs";
+import { A as decodeVectorBase64, Ot as asJsonObject, _t as errMsg, f as RUNTIME_DEFAULTS, gt as vectorStoreCapability, ht as vectorDimFromBase64, k as dataStoreProviderCapability, vt as BaseAddon, w as bareAddonId, zt as parseJsonUnknown } from "../../dist-F1XDQDE1.mjs";
 import { createRequire } from "node:module";
 import { randomUUID } from "node:crypto";
 import { statSync } from "node:fs";

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-9Gfk4KOk.js");
+const require_dist = require("../../dist-BMus2E5R.js");
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = require_chunk.__toESM(node_fs_promises);

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

@@ -1,4 +1,4 @@
-import { Lt as parseJsonObject, _t as BaseAddon, g as StorageMigrationJobSchema, h as StorageLocationTypeSchema, lt as storageCapability, st as settingsStoreCapability, ut as storageMigrationCapability } from "../../dist-DhrTd8LL.mjs";
+import { Rt as parseJsonObject, ct as settingsStoreCapability, dt as storageMigrationCapability, g as StorageMigrationJobSchema, h as StorageLocationTypeSchema, ut as storageCapability, vt as BaseAddon } from "../../dist-F1XDQDE1.mjs";
 import { randomUUID } from "node:crypto";
 import * as fs from "node:fs/promises";
 import * as path$1 from "node:path";

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-9Gfk4KOk.js");
+const require_dist = require("../../dist-BMus2E5R.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 { Pt as hydrateSchema, _t as BaseAddon, gt as errMsg } from "../../dist-DhrTd8LL.mjs";
+import { Ft as hydrateSchema, _t as errMsg, vt as BaseAddon } from "../../dist-F1XDQDE1.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-9Gfk4KOk.js");
+const require_dist = require("../../dist-BMus2E5R.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 { J as logDestinationCapability, _t as BaseAddon } from "../../dist-DhrTd8LL.mjs";
+import { Y as logDestinationCapability, vt as BaseAddon } from "../../dist-F1XDQDE1.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import * as path$1 from "node:path";
 import path from "node:path";