camstack 1.2.101 → 1.2.102

package/dist/{chunk-7N7KEXGL.js → chunk-TPJZXJTF.js}

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-Db7MvrdS.mjs
+// ../types/dist/sleep-BRy4r7RG.mjs
 var WELL_KNOWN_TABS = [
   {
     id: "overview",
@@ -32150,6 +32150,85 @@ var batteryCapability = {
   *  whether persisting is worth a SQLite commit. */
   volatileStateFields: ["lastUpdated"]
 };
+var NETWORK_LINK_TYPES = [
+  "wifi",
+  "ethernet",
+  "cellular",
+  "unknown"
+];
+var NetworkLinkStatusSchema = external_exports.object({
+  /** The link the device is on. `'unknown'` = not read yet, not "no link". */
+  type: external_exports.enum(NETWORK_LINK_TYPES),
+  /**
+  * Link quality, 0..100 inclusive, normalised by the provider from whatever
+  * the firmware reports (bars, RSSI, a vendor scale). **`null` means NOT
+  * KNOWN or NOT APPLICABLE** — a wired link has no signal, and a wireless
+  * one whose reading has not landed must not be drawn at 0 %. Consumers
+  * SKIP a null rather than coerce it.
+  */
+  signalPercent: external_exports.number().min(0).max(100).nullable(),
+  /** Raw received signal strength in dBm, when the firmware reports one. */
+  rssiDbm: external_exports.number().optional(),
+  /** Network name of a wireless link, when the firmware reports it. */
+  ssid: external_exports.string().optional(),
+  /** Ms epoch of the last observation. Lets consumers reason about freshness. */
+  lastUpdated: external_exports.number()
+});
+var NETWORK_LINK_UNKNOWN = {
+  type: "unknown",
+  signalPercent: null,
+  lastUpdated: 0
+};
+var networkLinkCapability = {
+  name: "network-link",
+  scope: "device",
+  deviceNative: true,
+  mode: "singleton",
+  deviceTypes: [
+    DeviceType.Camera,
+    DeviceType.Sensor,
+    DeviceType.Button,
+    DeviceType.Switch,
+    DeviceType.Light,
+    DeviceType.Lock,
+    DeviceType.Siren
+  ],
+  methods: {},
+  events: {
+    /**
+    * Emitted whenever the cached status changes (a link switch, a signal
+    * reading that moved). Mirrored on the parent chain by the
+    * DeviceEventPropagator like `battery.onStatusChanged`.
+    */
+    onStatusChanged: { data: external_exports.object({
+      deviceId: external_exports.number(),
+      status: NetworkLinkStatusSchema
+    }) }
+  },
+  status: {
+    schema: NetworkLinkStatusSchema,
+    kind: "push",
+    empty: NETWORK_LINK_UNKNOWN
+  },
+  /**
+  * Runtime-state slice — every provider stores the same shape under
+  * `device.runtimeState['network-link']`, read once by the badge and the
+  * Home Assistant projector regardless of the driver.
+  */
+  runtimeState: NetworkLinkStatusSchema,
+  /**
+  * Runtime-state durability: **restored** — a link reading is slow to
+  * change and a sleeping battery camera may not report for hours; the
+  * restored slice is what the badge shows until the next read.
+  *
+  * See `RuntimeStateDurability`. Enforced by
+  * `scripts/check-runtime-state-durability.ts`.
+  */
+  durability: "restored",
+  /** Clock fields: written, but excluded from the compare that decides
+  *  whether persisting is worth a SQLite commit. */
+  volatileStateFields: ["lastUpdated"]
+};
 var BinaryStatusSchema = external_exports.object({
   on: external_exports.boolean(),
   /** Ms epoch of the last transition. 0 if never observed. */

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-7N7KEXGL.js";
+} from "./chunk-TPJZXJTF.js";
 import "./chunk-LMMQX4CK.js";
 
 // src/cli.ts
@@ -38,7 +38,7 @@ async function runServe(args) {
     ...typeof values.data === "string" ? { data: values.data } : {}
   };
   Object.assign(process.env, buildServeEnv(opts));
-  await import("./launcher-Q6SAJY4R.js");
+  await import("./launcher-DTWKSRVF.js");
 }
 
 // src/commands/agent.ts
@@ -83,7 +83,7 @@ async function runAgent(args) {
     ...typeof values.port === "string" ? { port: values.port } : {}
   };
   Object.assign(process.env, buildAgentEnv(opts));
-  await import("./launcher-Q6SAJY4R.js");
+  await import("./launcher-DTWKSRVF.js");
 }
 
 // src/commands/setup.ts
@@ -1130,7 +1130,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-3TATRQOW.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-33RHXYBU.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-3TATRQOW.js → discover-33RHXYBU.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-7N7KEXGL.js";
+} from "./chunk-TPJZXJTF.js";
 import "./chunk-LMMQX4CK.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,

package/dist/{launcher-Q6SAJY4R.js → launcher-DTWKSRVF.js}

@@ -23633,9 +23633,9 @@ var require_zod = __commonJS({
   }
 });
 
-// ../system/dist/dist-DyO7xSEt.js
-var require_dist_DyO7xSEt = __commonJS({
-  "../system/dist/dist-DyO7xSEt.js"(exports) {
+// ../system/dist/dist-B0Cf6q_P.js
+var require_dist_B0Cf6q_P = __commonJS({
+  "../system/dist/dist-B0Cf6q_P.js"(exports) {
     "use strict";
     var zod = require_zod();
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
@@ -23719,6 +23719,7 @@ var require_dist_DyO7xSEt = __commonJS({
       EventCategory2["DeviceStateChanged"] = "device.state-changed";
       EventCategory2["ZoneAnalyticsOccupancyChanged"] = "zone-analytics.occupancy-changed";
       EventCategory2["BatteryOnStatusChanged"] = "battery.onStatusChanged";
+      EventCategory2["NetworkLinkOnStatusChanged"] = "network-link.onStatusChanged";
       EventCategory2["BatteryOnWakeStarted"] = "battery.onWakeStarted";
       EventCategory2["DoorbellOnPressed"] = "doorbell.onPressed";
       EventCategory2["EventEmitted"] = "event-emitter.event";
@@ -42710,6 +42711,83 @@ var require_dist_DyO7xSEt = __commonJS({
       *  whether persisting is worth a SQLite commit. */
       volatileStateFields: ["lastUpdated"]
     };
+    var NetworkLinkStatusSchema = zod.z.object({
+      /** The link the device is on. `'unknown'` = not read yet, not "no link". */
+      type: zod.z.enum([
+        "wifi",
+        "ethernet",
+        "cellular",
+        "unknown"
+      ]),
+      /**
+      * Link quality, 0..100 inclusive, normalised by the provider from whatever
+      * the firmware reports (bars, RSSI, a vendor scale). **`null` means NOT
+      * KNOWN or NOT APPLICABLE** — a wired link has no signal, and a wireless
+      * one whose reading has not landed must not be drawn at 0 %. Consumers
+      * SKIP a null rather than coerce it.
+      */
+      signalPercent: zod.z.number().min(0).max(100).nullable(),
+      /** Raw received signal strength in dBm, when the firmware reports one. */
+      rssiDbm: zod.z.number().optional(),
+      /** Network name of a wireless link, when the firmware reports it. */
+      ssid: zod.z.string().optional(),
+      /** Ms epoch of the last observation. Lets consumers reason about freshness. */
+      lastUpdated: zod.z.number()
+    });
+    var networkLinkCapability = {
+      name: "network-link",
+      scope: "device",
+      deviceNative: true,
+      mode: "singleton",
+      deviceTypes: [
+        DeviceType.Camera,
+        DeviceType.Sensor,
+        DeviceType.Button,
+        DeviceType.Switch,
+        DeviceType.Light,
+        DeviceType.Lock,
+        DeviceType.Siren
+      ],
+      methods: {},
+      events: {
+        /**
+        * Emitted whenever the cached status changes (a link switch, a signal
+        * reading that moved). Mirrored on the parent chain by the
+        * DeviceEventPropagator like `battery.onStatusChanged`.
+        */
+        onStatusChanged: { data: zod.z.object({
+          deviceId: zod.z.number(),
+          status: NetworkLinkStatusSchema
+        }) }
+      },
+      status: {
+        schema: NetworkLinkStatusSchema,
+        kind: "push",
+        empty: {
+          type: "unknown",
+          signalPercent: null,
+          lastUpdated: 0
+        }
+      },
+      /**
+      * Runtime-state slice — every provider stores the same shape under
+      * `device.runtimeState['network-link']`, read once by the badge and the
+      * Home Assistant projector regardless of the driver.
+      */
+      runtimeState: NetworkLinkStatusSchema,
+      /**
+      * Runtime-state durability: **restored** — a link reading is slow to
+      * change and a sleeping battery camera may not report for hours; the
+      * restored slice is what the badge shows until the next read.
+      *
+      * See `RuntimeStateDurability`. Enforced by
+      * `scripts/check-runtime-state-durability.ts`.
+      */
+      durability: "restored",
+      /** Clock fields: written, but excluded from the compare that decides
+      *  whether persisting is worth a SQLite commit. */
+      volatileStateFields: ["lastUpdated"]
+    };
     var BinaryStatusSchema = zod.z.object({
       on: zod.z.boolean(),
       /** Ms epoch of the last transition. 0 if never observed. */
@@ -50735,6 +50813,7 @@ var require_dist_DyO7xSEt = __commonJS({
       "motion-zones",
       "mqtt-broker",
       "native-object-detection",
+      "network-link",
       "notifier",
       "numeric-sensor",
       "osd",
@@ -50852,6 +50931,7 @@ var require_dist_DyO7xSEt = __commonJS({
       mqttBrokerCapability,
       nativeObjectDetectionCapability,
       networkAccessCapability,
+      networkLinkCapability,
       networkQualityCapability,
       nodesCapability,
       notificationOutputCapability,
@@ -58944,6 +59024,10 @@ var require_dist_DyO7xSEt = __commonJS({
         durability: "restored",
         volatileFields: ["lastFetchedAt"]
       },
+      "network-link": {
+        durability: "restored",
+        volatileFields: ["lastUpdated"]
+      },
       "notifier": {
         durability: "session",
         volatileFields: []
@@ -60194,7 +60278,7 @@ var require_alerts_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DyO7xSEt();
+    var require_dist10 = require_dist_B0Cf6q_P();
     function selectExpired(alerts, cutoffMs) {
       return alerts.filter((a) => a.createdAt < cutoffMs).sort((a, b) => a.createdAt - b.createdAt).map((a) => a.id);
     }
@@ -61013,7 +61097,7 @@ var require_console_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DyO7xSEt();
+    var require_dist10 = require_dist_B0Cf6q_P();
     var require_formatter = require_formatter_DqAKDlvN();
     var LEVEL_RANK = {
       debug: 0,
@@ -61107,7 +61191,7 @@ var require_core_blocks_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DyO7xSEt();
+    var require_dist10 = require_dist_B0Cf6q_P();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -62004,11 +62088,11 @@ var require_core_blocks = __commonJS({
   }
 });
 
-// ../system/dist/retired-settings-keys-BD6-AoDL.js
-var require_retired_settings_keys_BD6_AoDL = __commonJS({
-  "../system/dist/retired-settings-keys-BD6-AoDL.js"(exports) {
+// ../system/dist/retired-settings-keys-mP95OCUi.js
+var require_retired_settings_keys_mP95OCUi = __commonJS({
+  "../system/dist/retired-settings-keys-mP95OCUi.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_DyO7xSEt();
+    var require_dist10 = require_dist_B0Cf6q_P();
     function settingsStoreIsAuthoritativeHere(env) {
       const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
       return raw === "" || raw === "hub";
@@ -64222,8 +64306,8 @@ var require_device_manager_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DyO7xSEt();
-    var require_retired_settings_keys = require_retired_settings_keys_BD6_AoDL();
+    var require_dist10 = require_dist_B0Cf6q_P();
+    var require_retired_settings_keys = require_retired_settings_keys_mP95OCUi();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
     var JOB_HISTORY = 20;
@@ -69738,7 +69822,7 @@ var require_hub_forwarder = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DyO7xSEt();
+    var require_dist10 = require_dist_B0Cf6q_P();
     var require_formatter = require_formatter_DqAKDlvN();
     var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
     var HubForwarderDestination = class {
@@ -69875,7 +69959,7 @@ var require_liveness_monitor_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DyO7xSEt();
+    var require_dist10 = require_dist_B0Cf6q_P();
     var NO_DEVICES = "liveness:no-devices";
     var ALL_OFFLINE = "liveness:all-devices-offline";
     var NO_FOOTAGE_PREFIX = "liveness:no-footage:";
@@ -70071,7 +70155,7 @@ var require_local_auth_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DyO7xSEt();
+    var require_dist10 = require_dist_B0Cf6q_P();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
     var crypto$1 = __require("crypto");
@@ -77884,7 +77968,7 @@ var require_loki_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DyO7xSEt();
+    var require_dist10 = require_dist_B0Cf6q_P();
     function sanitizeLabelName(raw) {
       const replaced = raw.replaceAll(/[^a-zA-Z0-9_]/g, "_");
       return /^[a-zA-Z_]/.test(replaced) ? replaced : `_${replaced}`;
@@ -78449,7 +78533,7 @@ var require_native_metrics_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DyO7xSEt();
+    var require_dist10 = require_dist_B0Cf6q_P();
     var node_fs_promises = __require("fs/promises");
     var node_child_process = __require("child_process");
     var node_util = __require("util");
@@ -81033,7 +81117,7 @@ var require_filesystem_storage_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DyO7xSEt();
+    var require_dist10 = require_dist_B0Cf6q_P();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     var node_path = __require("path");
@@ -82149,8 +82233,8 @@ var require_sqlite_settings_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DyO7xSEt();
-    var require_retired_settings_keys = require_retired_settings_keys_BD6_AoDL();
+    var require_dist10 = require_dist_B0Cf6q_P();
+    var require_retired_settings_keys = require_retired_settings_keys_mP95OCUi();
     var node_crypto = __require("crypto");
     var node_fs = __require("fs");
     var node_module = __require("module");
@@ -84640,7 +84724,7 @@ var require_storage_orchestrator_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DyO7xSEt();
+    var require_dist10 = require_dist_B0Cf6q_P();
     var require_hub_cap_forward = require_hub_cap_forward_DmHNjbB0();
     var zod = require_zod();
     var node_crypto = __require("crypto");
@@ -87591,7 +87675,7 @@ var require_system_config_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DyO7xSEt();
+    var require_dist10 = require_dist_B0Cf6q_P();
     var SECTION_TITLES = {
       server: "Server",
       auth: "Authentication"
@@ -105652,7 +105736,7 @@ var require_winston_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DyO7xSEt();
+    var require_dist10 = require_dist_B0Cf6q_P();
     var require_formatter = require_formatter_DqAKDlvN();
     var node_path = __require("path");
     node_path = require_chunk.__toESM(node_path);
@@ -107428,9 +107512,9 @@ ${(0, node_fs.readFileSync)(ca.caCertPath, "utf-8").trimEnd()}
   }
 });
 
-// ../types/dist/event-category-BaEgqJNv.js
-var require_event_category_BaEgqJNv = __commonJS({
-  "../types/dist/event-category-BaEgqJNv.js"(exports) {
+// ../types/dist/event-category-b8kBSOTT.js
+var require_event_category_b8kBSOTT = __commonJS({
+  "../types/dist/event-category-b8kBSOTT.js"(exports) {
     "use strict";
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
       EventCategory2["SystemBoot"] = "system.boot";
@@ -107513,6 +107597,7 @@ var require_event_category_BaEgqJNv = __commonJS({
       EventCategory2["DeviceStateChanged"] = "device.state-changed";
       EventCategory2["ZoneAnalyticsOccupancyChanged"] = "zone-analytics.occupancy-changed";
       EventCategory2["BatteryOnStatusChanged"] = "battery.onStatusChanged";
+      EventCategory2["NetworkLinkOnStatusChanged"] = "network-link.onStatusChanged";
       EventCategory2["BatteryOnWakeStarted"] = "battery.onWakeStarted";
       EventCategory2["DoorbellOnPressed"] = "doorbell.onPressed";
       EventCategory2["EventEmitted"] = "event-emitter.event";
@@ -107595,11 +107680,11 @@ var require_event_category_BaEgqJNv = __commonJS({
   }
 });
 
-// ../types/dist/sleep-DVTaZZHP.js
-var require_sleep_DVTaZZHP = __commonJS({
-  "../types/dist/sleep-DVTaZZHP.js"(exports) {
+// ../types/dist/sleep-TVipGseU.js
+var require_sleep_TVipGseU = __commonJS({
+  "../types/dist/sleep-TVipGseU.js"(exports) {
     "use strict";
-    var require_event_category = require_event_category_BaEgqJNv();
+    var require_event_category = require_event_category_b8kBSOTT();
     var zod = require_zod();
     var WELL_KNOWN_TABS = [
       {
@@ -109992,6 +110077,7 @@ var require_sleep_DVTaZZHP = __commonJS({
           motionTrigger: createSliceHandle(stateSource, binding.deviceId, "motion-trigger"),
           motionZones: createSliceHandle(stateSource, binding.deviceId, "motion-zones"),
           nativeObjectDetection: createSliceHandle(stateSource, binding.deviceId, "native-object-detection"),
+          networkLink: createSliceHandle(stateSource, binding.deviceId, "network-link"),
           notifier: createSliceHandle(stateSource, binding.deviceId, "notifier"),
           numericSensor: createSliceHandle(stateSource, binding.deviceId, "numeric-sensor"),
           petFeeder: createSliceHandle(stateSource, binding.deviceId, "pet-feeder"),
@@ -110225,6 +110311,7 @@ var require_sleep_DVTaZZHP = __commonJS({
           setEnabled: (input) => dispatch("native-object-detection", "nativeObjectDetection", "setEnabled", "mutation", input),
           getStatus: (input) => dispatch("native-object-detection", "nativeObjectDetection", "getStatus", "query", input)
         },
+        networkLink: { getStatus: (input) => dispatch("network-link", "networkLink", "getStatus", "query", input) },
         notificationRules: {
           listRules: (input) => dispatch("notification-rules", "notificationRules", "listRules", "query", input),
           getRule: (input) => dispatch("notification-rules", "notificationRules", "getRule", "query", input),
@@ -111286,8 +111373,8 @@ var require_addon = __commonJS({
   "../types/dist/addon.js"(exports) {
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-    var require_event_category = require_event_category_BaEgqJNv();
-    var require_sleep = require_sleep_DVTaZZHP();
+    var require_event_category = require_event_category_b8kBSOTT();
+    var require_sleep = require_sleep_TVipGseU();
     var require_err_msg = require_err_msg_COpsHMw2();
     var CAP_INPUT_DEFAULTS = Object.freeze({
       "addons": { "getLogs": { "limit": 100 } },
@@ -130247,7 +130334,7 @@ var require_dist3 = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DyO7xSEt();
+    var require_dist10 = require_dist_B0Cf6q_P();
     var require_builtins_alerts_alerts_addon = require_alerts_addon();
     require_alerts();
     var require_formatter = require_formatter_DqAKDlvN();
@@ -211343,7 +211430,7 @@ var require_enums = __commonJS({
   "../types/dist/enums.js"(exports) {
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-    var require_event_category = require_event_category_BaEgqJNv();
+    var require_event_category = require_event_category_b8kBSOTT();
     var EventSourceType = /* @__PURE__ */ (function(EventSourceType2) {
       EventSourceType2["Addon"] = "addon";
       EventSourceType2["Core"] = "core";
@@ -211363,8 +211450,8 @@ var require_dist4 = __commonJS({
   "../types/dist/index.js"(exports) {
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-    var require_event_category = require_event_category_BaEgqJNv();
-    var require_sleep = require_sleep_DVTaZZHP();
+    var require_event_category = require_event_category_b8kBSOTT();
+    var require_sleep = require_sleep_TVipGseU();
     var require_canonical_hash = require_canonical_hash_DNV8S5ET();
     var require_enums2 = require_enums();
     var require_err_msg = require_err_msg_COpsHMw2();
@@ -231288,6 +231375,94 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       *  whether persisting is worth a SQLite commit. */
       volatileStateFields: ["lastUpdated"]
     };
+    var NETWORK_LINK_TYPES = [
+      "wifi",
+      "ethernet",
+      "cellular",
+      "unknown"
+    ];
+    var NetworkLinkStatusSchema = zod.z.object({
+      /** The link the device is on. `'unknown'` = not read yet, not "no link". */
+      type: zod.z.enum(NETWORK_LINK_TYPES),
+      /**
+      * Link quality, 0..100 inclusive, normalised by the provider from whatever
+      * the firmware reports (bars, RSSI, a vendor scale). **`null` means NOT
+      * KNOWN or NOT APPLICABLE** — a wired link has no signal, and a wireless
+      * one whose reading has not landed must not be drawn at 0 %. Consumers
+      * SKIP a null rather than coerce it.
+      */
+      signalPercent: zod.z.number().min(0).max(100).nullable(),
+      /** Raw received signal strength in dBm, when the firmware reports one. */
+      rssiDbm: zod.z.number().optional(),
+      /** Network name of a wireless link, when the firmware reports it. */
+      ssid: zod.z.string().optional(),
+      /** Ms epoch of the last observation. Lets consumers reason about freshness. */
+      lastUpdated: zod.z.number()
+    });
+    var NETWORK_LINK_UNKNOWN = {
+      type: "unknown",
+      signalPercent: null,
+      lastUpdated: 0
+    };
+    function signalPercentFromBars(bars, maxBars) {
+      if (bars === void 0 || !Number.isFinite(bars) || maxBars <= 0) return null;
+      if (bars < 0 || bars > maxBars) return null;
+      return Math.round(bars / maxBars * 100);
+    }
+    function signalPercentFromRssi(rssiDbm) {
+      if (rssiDbm === void 0 || !Number.isFinite(rssiDbm) || rssiDbm > 0) return null;
+      return Math.round((Math.min(-50, Math.max(-100, rssiDbm)) + 100) * 2);
+    }
+    var networkLinkCapability = {
+      name: "network-link",
+      scope: "device",
+      deviceNative: true,
+      mode: "singleton",
+      deviceTypes: [
+        require_sleep.DeviceType.Camera,
+        require_sleep.DeviceType.Sensor,
+        require_sleep.DeviceType.Button,
+        require_sleep.DeviceType.Switch,
+        require_sleep.DeviceType.Light,
+        require_sleep.DeviceType.Lock,
+        require_sleep.DeviceType.Siren
+      ],
+      methods: {},
+      events: {
+        /**
+        * Emitted whenever the cached status changes (a link switch, a signal
+        * reading that moved). Mirrored on the parent chain by the
+        * DeviceEventPropagator like `battery.onStatusChanged`.
+        */
+        onStatusChanged: { data: zod.z.object({
+          deviceId: zod.z.number(),
+          status: NetworkLinkStatusSchema
+        }) }
+      },
+      status: {
+        schema: NetworkLinkStatusSchema,
+        kind: "push",
+        empty: NETWORK_LINK_UNKNOWN
+      },
+      /**
+      * Runtime-state slice — every provider stores the same shape under
+      * `device.runtimeState['network-link']`, read once by the badge and the
+      * Home Assistant projector regardless of the driver.
+      */
+      runtimeState: NetworkLinkStatusSchema,
+      /**
+      * Runtime-state durability: **restored** — a link reading is slow to
+      * change and a sleeping battery camera may not report for hours; the
+      * restored slice is what the badge shows until the next read.
+      *
+      * See `RuntimeStateDurability`. Enforced by
+      * `scripts/check-runtime-state-durability.ts`.
+      */
+      durability: "restored",
+      /** Clock fields: written, but excluded from the compare that decides
+      *  whether persisting is worth a SQLite commit. */
+      volatileStateFields: ["lastUpdated"]
+    };
     var BinaryStatusSchema = zod.z.object({
       on: zod.z.boolean(),
       /** Ms epoch of the last transition. 0 if never observed. */
@@ -239371,6 +239546,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       motionTrigger: motionTriggerCapability,
       motionZones: motionZonesCapability,
       nativeObjectDetection: nativeObjectDetectionCapability,
+      networkLink: networkLinkCapability,
       notifier: notifierCapability,
       numericSensor: numericSensorCapability,
       petFeeder: petFeederCapability,
@@ -241850,6 +242026,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       "motion-zones",
       "mqtt-broker",
       "native-object-detection",
+      "network-link",
       "notifier",
       "numeric-sensor",
       "osd",
@@ -241967,6 +242144,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       mqttBroker: "mqtt-broker",
       nativeObjectDetection: "native-object-detection",
       networkAccess: "network-access",
+      networkLink: "network-link",
       networkQuality: "network-quality",
       nodes: "nodes",
       notificationOutput: "notification-output",
@@ -242391,6 +242569,10 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         key: "networkAccess",
         name: "network-access"
       },
+      {
+        key: "networkLink",
+        name: "network-link"
+      },
       {
         key: "networkQuality",
         name: "network-quality"
@@ -242731,6 +242913,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       mqttBrokerCapability,
       nativeObjectDetectionCapability,
       networkAccessCapability,
+      networkLinkCapability,
       networkQualityCapability,
       nodesCapability,
       notificationOutputCapability,
@@ -251231,6 +251414,10 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         durability: "restored",
         volatileFields: ["lastFetchedAt"]
       },
+      "network-link": {
+        durability: "restored",
+        volatileFields: ["lastUpdated"]
+      },
       "notifier": {
         durability: "session",
         volatileFields: []
@@ -251363,6 +251550,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       "lock-control",
       "motion-zones",
       "native-object-detection",
+      "network-link",
       "numeric-sensor",
       "power-meter",
       "presence",
@@ -255324,6 +255512,8 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.NC_SYSTEM_DELIVERY = NC_SYSTEM_DELIVERY;
     exports.NC_SYSTEM_EVENT_FILTER_KEYS = NC_SYSTEM_EVENT_FILTER_KEYS;
     exports.NC_TAXONOMY = NC_TAXONOMY;
+    exports.NETWORK_LINK_TYPES = NETWORK_LINK_TYPES;
+    exports.NETWORK_LINK_UNKNOWN = NETWORK_LINK_UNKNOWN;
     exports.NativeCropBboxSchema = NativeCropBboxSchema;
     exports.NativeCropRefSchema = NativeCropRefSchema;
     exports.NativeCropResultSchema = NativeCropResultSchema;
@@ -255382,6 +255572,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.NetworkAccessStatusSchema = NetworkAccessStatusSchema;
     exports.NetworkAddressSchema = NetworkAddressSchema;
     exports.NetworkEndpointSchema = NetworkEndpointSchema;
+    exports.NetworkLinkStatusSchema = NetworkLinkStatusSchema;
     exports.NotificationActionIconSchema = NotificationActionIconSchema;
     exports.NotificationActionSchema = NotificationActionSchema;
     exports.NotificationFormatSchema = NotificationFormatSchema;
@@ -256041,6 +256232,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.mqttBrokerCapability = mqttBrokerCapability;
     exports.nativeObjectDetectionCapability = nativeObjectDetectionCapability;
     exports.networkAccessCapability = networkAccessCapability;
+    exports.networkLinkCapability = networkLinkCapability;
     exports.networkQualityCapability = networkQualityCapability;
     exports.nodePin = require_sleep.nodePin;
     exports.nodesCapability = nodesCapability;
@@ -256154,6 +256346,8 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.serverManagementCapability = serverManagementCapability;
     exports.setByPath = setByPath;
     exports.settingsStoreCapability = settingsStoreCapability;
+    exports.signalPercentFromBars = signalPercentFromBars;
+    exports.signalPercentFromRssi = signalPercentFromRssi;
     exports.sleep = require_sleep.sleep;
     exports.sleepCancellable = require_sleep.sleepCancellable;
     exports.sliceActiveValue = sliceActiveValue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "camstack",
-  "version": "1.2.101",
+  "version": "1.2.102",
   "description": "CLI tool for managing and running CamStack server",
   "keywords": [
     "camstack",