@camstack/system 1.2.93 → 1.2.94

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

@@ -40,9 +40,14 @@ export declare class SnapshotAddon extends BaseAddon<SnapshotAddonConfig> {
      * A courtesy frame is a pure function of those three, so it is rendered once
      * and reused for as long as the process lives — a disabled camera must not
      * cost an ffmpeg run per poll. Unbounded on purpose: the key space is
-     * (3 reasons × this node's own cameras), not user input.
+     * (state reasons × this node's own cameras), not user input.
      */
     private readonly courtesyFrames;
+    /** State overlays over real cached frames, grouped by device so invalidation
+     *  can discard every generation in O(1). */
+    private readonly stateFrames;
+    /** Devices inside the explicit battery wake-in-progress window. */
+    private readonly wakingDevices;
     /**
      * De-dupes concurrent captures per `${deviceId}:${streamId}` and holds a
      * settled SUCCESS for COALESCE_MS so a grid-mount burst (and a row of refresh
@@ -201,9 +206,7 @@ export declare class SnapshotAddon extends BaseAddon<SnapshotAddonConfig> {
      * the Viewer's 15-second currency contract and the link-mint wait bound.
      */
     private awaitFreshEnough;
-    /** True only for a BATTERY device that is currently asleep. Kept as one
-     *  question so the link path cannot accidentally treat "battery" as "asleep"
-     *  and stop refreshing a camera that is awake and streaming. */
+    /** True only for a battery device that must not be snapshot-refreshed. */
     private isSleepingBatteryDevice;
     /**
      * Resolve a device (+ optional stream, + force) to renderable JPEG bytes for
@@ -225,8 +228,8 @@ export declare class SnapshotAddon extends BaseAddon<SnapshotAddonConfig> {
      */
     private peekFreshFrame;
     /**
-     * The frame at a card-sized width, derived once per (device, stream, width)
-     * per capture.
+     * The frame at a card-sized width, derived once per
+     * (device, stream, width, state treatment) per capture.
      *
      * A failed resize falls back to the FULL frame — a visible card beats a
      * broken one — but never silently: the card would otherwise keep costing a
@@ -355,36 +358,26 @@ export declare class SnapshotAddon extends BaseAddon<SnapshotAddonConfig> {
      */
     private deviceStillExists;
     /**
-     * Sleep state from the device-state MIRROR, not from a cap round-trip.
+     * Resolve the state that must be visible on a snapshot.
      *
-     * `fetchDevice(id).state.battery` is a `SliceHandle` over the hub's
-     * runtime-state mirror: a local read, no RPC, no failure branch to get
-     * wrong. It is the same mirror that feeds the battery badge elsewhere
-     * in the UI, so if the operator can see "sleeping" on screen, this
-     * sees it too. (Both spec harnesses already model exactly this wiring
-     * — like the orphaned doc comment above, it outlived the gate it was
-     * built for.)
+     * Uses the same two canonical sources as wake-on-play:
+     *  1. `deviceManager.getDevice` for the registry's BatteryOperated feature;
+     *  2. `deviceState.getCapSlice('battery')` for the durable runtime mirror.
      *
-     * `undefined` slice → the device has no battery state we know of →
-     * treated as awake. The caller has already established the device is
-     * battery-operated from its feature flags, so this only decides
-     * WHETHER IT IS ASLEEP, never whether it has a battery.
+     * A valid battery slice is itself positive evidence that the device is
+     * battery-operated. That closes the field failure where "Baby monitor" had a
+     * sleeping battery slice but a stale persisted feature projection, so the
+     * snapshot wrapper classified it as mains and a Viewer thumbnail logged in
+     * to the sleeping camera. The reverse is deliberately not guessed: no
+     * feature + no valid slice remains a mains/unknown camera and follows the
+     * ordinary capture path.
      *
-     * Only consulted on the path that would otherwise CAPTURE — a fresh
-     * cache hit returns before we get here.
+     * Once battery-operated is established, a missing slice fails safe toward
+     * `sleeping` through the shared `deriveBatteryPresence` function. This avoids
+     * a background wake without inventing an `unreachable` fault.
      */
-    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;
+    private resolveSnapshotState;
+    private isDeviceWaking;
     /**
      * True when at least one of the device's brokers is actively
      * streaming (status === 'streaming'). Used by the battery-cam guard
@@ -432,13 +425,18 @@ export declare class SnapshotAddon extends BaseAddon<SnapshotAddonConfig> {
     private courtesyFrame;
     /** A courtesy frame shaped as the cap's response, or null when unrenderable. */
     private courtesyImage;
+    /**
+     * Render a state-labelled answer. A cached real frame is the background, not
+     * the answer by itself; if it cannot be decoded, fall back to the generated
+     * courtesy background rather than leaking an unlabelled stale frame.
+     */
+    private stateImage;
     /**
      * Single-trip device lookup against device-manager. Returns the
-     * fields the wrapper actually consults — name (logging) + battery
-     * flag (cache window + broker-fallback gate). Sourced from the
-     * device-manager registry rather than the battery cap so the answer
-     * survives a momentarily-unreachable provider (the very condition
-     * we're trying to be resilient to).
+     * stable registry fields the wrapper consults. Battery classification is
+     * completed by `resolveSnapshotState` from this feature flag PLUS the
+     * canonical runtime-state mirror, so a stale persisted feature projection
+     * cannot authorize a snapshot dial against a known sleeping battery camera.
      *
      * Logged at debug + null return on failure: every call site already
      * has a sensible fallback path (cache hit, conservative default, …),

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-BMus2E5R.js");
+const require_dist = require("../../dist-BspfS8Q7.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 { B as filesystemBrowseCapability, ft as storageProviderCapability, vt as BaseAddon } from "../../dist-F1XDQDE1.mjs";
+import { V as filesystemBrowseCapability, pt as storageProviderCapability, yt as BaseAddon } from "../../dist-COd223t-.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-BMus2E5R.js");
+const require_dist = require("../../dist-BspfS8Q7.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, 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 { A as dataStoreProviderCapability, Bt as parseJsonUnknown, _t as vectorStoreCapability, f as RUNTIME_DEFAULTS, gt as vectorDimFromBase64, j as decodeVectorBase64, kt as asJsonObject, vt as errMsg, w as bareAddonId, yt as BaseAddon } from "../../dist-COd223t-.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-BMus2E5R.js");
+const require_dist = require("../../dist-BspfS8Q7.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 { 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 { dt as storageCapability, ft as storageMigrationCapability, g as StorageMigrationJobSchema, h as StorageLocationTypeSchema, lt as settingsStoreCapability, yt as BaseAddon, zt as parseJsonObject } from "../../dist-COd223t-.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-BMus2E5R.js");
+const require_dist = require("../../dist-BspfS8Q7.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 { Ft as hydrateSchema, _t as errMsg, vt as BaseAddon } from "../../dist-F1XDQDE1.mjs";
+import { It as hydrateSchema, vt as errMsg, yt as BaseAddon } from "../../dist-COd223t-.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-BMus2E5R.js");
+const require_dist = require("../../dist-BspfS8Q7.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 { Y as logDestinationCapability, vt as BaseAddon } from "../../dist-F1XDQDE1.mjs";
+import { X as logDestinationCapability, yt as BaseAddon } from "../../dist-COd223t-.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import * as path$1 from "node:path";
 import path from "node:path";

package/dist/{dist-BMus2E5R.js → dist-BspfS8Q7.js}

@@ -38253,6 +38253,12 @@ Object.defineProperty(exports, "bareAddonId", {
 		return bareAddonId;
 	}
 });
+Object.defineProperty(exports, "batteryCapability", {
+	enumerable: true,
+	get: function() {
+		return batteryCapability;
+	}
+});
 Object.defineProperty(exports, "buildStreamParamsConfigSchema", {
 	enumerable: true,
 	get: function() {

package/dist/{dist-F1XDQDE1.mjs → dist-COd223t-.mjs}

@@ -38025,4 +38025,4 @@ function enumerateInferenceDevices(hw) {
 	return out;
 }
 //#endregion
-export { normalizeUnit as $, decodeVectorBase64 as A, asString as At, filesystemBrowseCapability as B, readinessKey as Bt, backupCapability as C, DeviceRole as Ct, coreBlockIdFromAddonId as D, WELL_KNOWN_TAB_MAP as Dt, coreBlockAddonId as E, ReadinessTimeoutError as Et, doorbellCapability as F, hydrateSchema as Ft, isVoidInput as G, isCollectionArrayMethod as H, scopeKey as Ht, enumerateInferenceDevices as I, isDeviceConfigCap as It, localNetworkCapability as J, kebabToCamel as K, enumerateItemArrayFields as L, nodePin as Lt, deviceManagerCapability as M, emitDownForOwnedCaps as Mt, deviceStateCapability as N, emitReadiness as Nt, coreBlocksCapability as O, asJsonObject as Ot, deviceStatusCapability as P, expandCapMethods as Pt, metricsProviderCapability as Q, enumerateSchemaFields as R, parseJsonObject as Rt, authProviderCapability as S, DeviceFeature as St, buildStreamParamsConfigSchema as T, ReadinessRegistry as Tt, isObjectInput as U, sleep as Ut, isArrayOutputSchema as V, resolveCapMount as Vt, isSameAddonId as W, EventCategory as Wt, logLevelAtMost as X, logDestinationCapability as Y, looseSchema as Z, UserRecordSchema as _, errMsg as _t, CAP_NAMES_WITH_STATUS as a, scopesAllowAddon as at, addonWidgetsCapability as b, DEVICE_SETTINGS_CONTRIBUTION_METHODS as bt, CoreBlockSchema as c, settingsStoreCapability as ct, METHOD_ACCESS_MAP as d, storageMigrationCapability as dt, objectInputDeclaresAddonId as et, RUNTIME_DEFAULTS as f, storageProviderCapability as ft, StorageMigrationJobSchema as g, vectorStoreCapability as gt, StorageLocationTypeSchema as h, vectorDimFromBase64 as ht, BatteryStatusSchema as i, runtimeStatePolicyFor as it, deriveBatteryPresence as j, createEvent as jt, dataStoreProviderCapability as k, asNumber as kt, DeclaredDevices as l, snapshotCapability as lt, ScopedTokenSchema as m, userManagementCapability as mt, AlertSchema as n, platformProbeCapability as nt, CORE_BLOCKS_ADDON_ID as o, scopesAllowDeviceCap as ot, STREAM_PROFILE_META as p, streamQualityLabel as pt, lifecycleJobSchema as q, ApiKeyRecordSchema as r, procedureAuthKey as rt, CORE_BLOCK_ADDON_PREFIX as s, scoreRuntimes as st, ALL_CAPABILITY_DEFINITIONS as t, parseStreamParamsFormPatch as tt, DeviceStatusSchema as u, storageCapability as ut, addonPagesCapability as v, BaseAddon as vt, bareAddonId as w, DeviceType as wt, alertsCapability as x, DEVICE_STATUS_METHOD as xt, addonSettingsCapability as y, DATAPLANE_SECRET_HEADER as yt, extractNestedAddonId as z, parseJsonUnknown as zt };
+export { metricsProviderCapability as $, dataStoreProviderCapability as A, asNumber as At, extractNestedAddonId as B, parseJsonUnknown as Bt, backupCapability as C, DeviceFeature as Ct, coreBlockAddonId as D, ReadinessTimeoutError as Dt, buildStreamParamsConfigSchema as E, ReadinessRegistry as Et, deviceStatusCapability as F, expandCapMethods as Ft, isSameAddonId as G, EventCategory as Gt, isArrayOutputSchema as H, resolveCapMount as Ht, doorbellCapability as I, hydrateSchema as It, lifecycleJobSchema as J, isVoidInput as K, enumerateInferenceDevices as L, isDeviceConfigCap as Lt, deriveBatteryPresence as M, createEvent as Mt, deviceManagerCapability as N, emitDownForOwnedCaps as Nt, coreBlockIdFromAddonId as O, WELL_KNOWN_TAB_MAP as Ot, deviceStateCapability as P, emitReadiness as Pt, looseSchema as Q, enumerateItemArrayFields as R, nodePin as Rt, authProviderCapability as S, DEVICE_STATUS_METHOD as St, batteryCapability as T, DeviceType as Tt, isCollectionArrayMethod as U, scopeKey as Ut, filesystemBrowseCapability as V, readinessKey as Vt, isObjectInput as W, sleep as Wt, logDestinationCapability as X, localNetworkCapability as Y, logLevelAtMost as Z, UserRecordSchema as _, vectorStoreCapability as _t, CAP_NAMES_WITH_STATUS as a, runtimeStatePolicyFor as at, addonWidgetsCapability as b, DATAPLANE_SECRET_HEADER as bt, CoreBlockSchema as c, scoreRuntimes as ct, METHOD_ACCESS_MAP as d, storageCapability as dt, normalizeUnit as et, RUNTIME_DEFAULTS as f, storageMigrationCapability as ft, StorageMigrationJobSchema as g, vectorDimFromBase64 as gt, StorageLocationTypeSchema as h, userManagementCapability as ht, BatteryStatusSchema as i, procedureAuthKey as it, decodeVectorBase64 as j, asString as jt, coreBlocksCapability as k, asJsonObject as kt, DeclaredDevices as l, settingsStoreCapability as lt, ScopedTokenSchema as m, streamQualityLabel as mt, AlertSchema as n, parseStreamParamsFormPatch as nt, CORE_BLOCKS_ADDON_ID as o, scopesAllowAddon as ot, STREAM_PROFILE_META as p, storageProviderCapability as pt, kebabToCamel as q, ApiKeyRecordSchema as r, platformProbeCapability as rt, CORE_BLOCK_ADDON_PREFIX as s, scopesAllowDeviceCap as st, ALL_CAPABILITY_DEFINITIONS as t, objectInputDeclaresAddonId as tt, DeviceStatusSchema as u, snapshotCapability as ut, addonPagesCapability as v, errMsg as vt, bareAddonId as w, DeviceRole as wt, alertsCapability as x, DEVICE_SETTINGS_CONTRIBUTION_METHODS as xt, addonSettingsCapability as y, BaseAddon as yt, enumerateSchemaFields as z, parseJsonObject as zt };

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-BMus2E5R.js");
+const require_dist = require("./dist-BspfS8Q7.js");
 const require_builtins_alerts_alerts_addon = require("./builtins/alerts/alerts.addon.js");
 require("./builtins/alerts/index.js");
 const require_formatter = require("./formatter-DqAKDlvN.js");

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { a as __toCommonJS, i as __require, n as __esmMin, o as __toESM$1, r as __exportAll, t as __commonJSMin$1 } from "./chunk-CNf5ZN-e.mjs";
-import { At as asString$1, Bt as readinessKey, Et as ReadinessTimeoutError, G as isVoidInput, H as isCollectionArrayMethod, Ht as scopeKey, K as kebabToCamel, Mt as emitDownForOwnedCaps, Ot as asJsonObject$1, Pt as expandCapMethods, Rt as parseJsonObject, Tt as ReadinessRegistry, U as isObjectInput, V as isArrayOutputSchema, Vt as resolveCapMount, Wt as EventCategory$1, X as logLevelAtMost, Z as looseSchema, _t as errMsg$1, at as scopesAllowAddon, bt as DEVICE_SETTINGS_CONTRIBUTION_METHODS, d as METHOD_ACCESS_MAP, et as objectInputDeclaresAddonId, f as RUNTIME_DEFAULTS, jt as createEvent, kt as asNumber, ot as scopesAllowDeviceCap, q as lifecycleJobSchema, rt as procedureAuthKey, t as ALL_CAPABILITY_DEFINITIONS, xt as DEVICE_STATUS_METHOD, y as addonSettingsCapability, yt as DATAPLANE_SECRET_HEADER$1, z as extractNestedAddonId, zt as parseJsonUnknown$1 } from "./dist-F1XDQDE1.mjs";
+import { At as asNumber, B as extractNestedAddonId, Bt as parseJsonUnknown$1, Dt as ReadinessTimeoutError, Et as ReadinessRegistry, Ft as expandCapMethods, Gt as EventCategory$1, H as isArrayOutputSchema, Ht as resolveCapMount, J as lifecycleJobSchema, K as isVoidInput, Mt as createEvent, Nt as emitDownForOwnedCaps, Q as looseSchema, St as DEVICE_STATUS_METHOD, U as isCollectionArrayMethod, Ut as scopeKey, Vt as readinessKey, W as isObjectInput, Z as logLevelAtMost, bt as DATAPLANE_SECRET_HEADER$1, d as METHOD_ACCESS_MAP, f as RUNTIME_DEFAULTS, it as procedureAuthKey, jt as asString$1, kt as asJsonObject$1, ot as scopesAllowAddon, q as kebabToCamel, st as scopesAllowDeviceCap, t as ALL_CAPABILITY_DEFINITIONS, tt as objectInputDeclaresAddonId, vt as errMsg$1, xt as DEVICE_SETTINGS_CONTRIBUTION_METHODS, y as addonSettingsCapability, zt as parseJsonObject } from "./dist-COd223t-.mjs";
 import { AlertCenterAddon } from "./builtins/alerts/alerts.addon.mjs";
 import "./builtins/alerts/index.mjs";
 import { t as formatLogLine } from "./formatter-B7qW8bPJ.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.93",
+  "version": "1.2.94",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",