camstack 1.2.82 → 1.2.83

package/dist/{chunk-GLXEXFJW.js → chunk-U3YITXU5.js}

@@ -26454,7 +26454,20 @@ var RecentTracksQueryInput = external_exports.object({
   projection: TrackProjectionSchema.optional(),
   /** Include stationary-promoted rows (parked objects). Default false: the
   *  feed lists passages; parking records live on the stationary registry. */
-  includeStationary: external_exports.boolean().optional()
+  includeStationary: external_exports.boolean().optional(),
+  /**
+  * Restrict to these track classes. ABSENT or EMPTY means no filter.
+  *
+  * The same filter `listTracks` takes, because the timeline's class chips must
+  * mean the same thing whether the scope is one camera or twelve. Until this
+  * existed the scoped feed downloaded a page and narrowed it on the phone
+  * while the single-camera path narrowed the read — one filter, two costs.
+  *
+  * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
+  * whose class list is unreadable are kept, and the client's rule stays the
+  * exact one.
+  */
+  classes: external_exports.array(external_exports.string()).optional()
 });
 var RecentTracksPageSchema = external_exports.object({
   /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -31730,8 +31743,22 @@ var automationControlCapability = {
   durability: "session"
 };
 var BatteryStatusSchema = external_exports.object({
-  /** 0..100 inclusive. Firmware-reported. */
-  percentage: external_exports.number().min(0).max(100),
+  /**
+  * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
+  * provider has registered the capability but no reading has landed.
+  *
+  * It is nullable because it was not, and the only value a provider could
+  * seed with was `0`. A battery camera behind an NVR therefore announced
+  * itself at 0% on every start and corrected itself a moment later, which is
+  * indistinguishable from a real flat battery: it fires the low-battery alert
+  * every time the hub restarts. Unknown is not empty (D315), and on a battery
+  * reading the difference is an alarm.
+  *
+  * `vacuum-control` and `lawn-mower-control` already model it this way.
+  * Consumers must SKIP a null rather than coerce it — `battery-band` already
+  * declines to band a non-finite reading, which is the correct shape.
+  */
+  percentage: external_exports.number().min(0).max(100).nullable(),
   /**
   * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
   * Reolink-specific for the Solar Panel 2 accessory (will become

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-GLXEXFJW.js";
+} from "./chunk-U3YITXU5.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-DD66RRLG.js");
+  await import("./launcher-FITGLHP4.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-DD66RRLG.js");
+  await import("./launcher-FITGLHP4.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-JZRN6RUI.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-F573GVRC.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-JZRN6RUI.js → discover-F573GVRC.js}

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

package/dist/{launcher-DD66RRLG.js → launcher-FITGLHP4.js}

@@ -23633,9 +23633,9 @@ var require_zod = __commonJS({
   }
 });
 
-// ../system/dist/dist-C0IXtI_E.js
-var require_dist_C0IXtI_E = __commonJS({
-  "../system/dist/dist-C0IXtI_E.js"(exports) {
+// ../system/dist/dist-C7qWwrK1.js
+var require_dist_C7qWwrK1 = __commonJS({
+  "../system/dist/dist-C7qWwrK1.js"(exports) {
     "use strict";
     var zod = require_zod();
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
@@ -37159,7 +37159,20 @@ var require_dist_C0IXtI_E = __commonJS({
       projection: TrackProjectionSchema.optional(),
       /** Include stationary-promoted rows (parked objects). Default false: the
       *  feed lists passages; parking records live on the stationary registry. */
-      includeStationary: zod.z.boolean().optional()
+      includeStationary: zod.z.boolean().optional(),
+      /**
+      * Restrict to these track classes. ABSENT or EMPTY means no filter.
+      *
+      * The same filter `listTracks` takes, because the timeline's class chips must
+      * mean the same thing whether the scope is one camera or twelve. Until this
+      * existed the scoped feed downloaded a page and narrowed it on the phone
+      * while the single-camera path narrowed the read — one filter, two costs.
+      *
+      * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
+      * whose class list is unreadable are kept, and the client's rule stays the
+      * exact one.
+      */
+      classes: zod.z.array(zod.z.string()).optional()
     });
     var RecentTracksPageSchema = zod.z.object({
       /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -42290,8 +42303,22 @@ var require_dist_C0IXtI_E = __commonJS({
       durability: "session"
     };
     var BatteryStatusSchema = zod.z.object({
-      /** 0..100 inclusive. Firmware-reported. */
-      percentage: zod.z.number().min(0).max(100),
+      /**
+      * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
+      * provider has registered the capability but no reading has landed.
+      *
+      * It is nullable because it was not, and the only value a provider could
+      * seed with was `0`. A battery camera behind an NVR therefore announced
+      * itself at 0% on every start and corrected itself a moment later, which is
+      * indistinguishable from a real flat battery: it fires the low-battery alert
+      * every time the hub restarts. Unknown is not empty (D315), and on a battery
+      * reading the difference is an alarm.
+      *
+      * `vacuum-control` and `lawn-mower-control` already model it this way.
+      * Consumers must SKIP a null rather than coerce it — `battery-band` already
+      * declines to band a non-finite reading, which is the correct shape.
+      */
+      percentage: zod.z.number().min(0).max(100).nullable(),
       /**
       * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
       * Reolink-specific for the Solar Panel 2 accessory (will become
@@ -50087,7 +50114,7 @@ var require_dist_C0IXtI_E = __commonJS({
     }
     function resolveContainerPrimaryChild(children, overrideEntityId) {
       if (overrideEntityId !== void 0 && overrideEntityId !== null) {
-        const picked = children.find((c) => c.entityId === overrideEntityId);
+        const picked = children.find((c) => c.stableId === overrideEntityId) ?? children.find((c) => c.entityId !== void 0 && c.entityId === overrideEntityId);
         if (picked !== void 0) return picked;
       }
       return [...children].toSorted((a, b) => rank(a.type) - rank(b.type))[0] ?? null;
@@ -59827,7 +59854,7 @@ var require_alerts_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C0IXtI_E();
+    var require_dist10 = require_dist_C7qWwrK1();
     function selectExpired(alerts, cutoffMs) {
       return alerts.filter((a) => a.createdAt < cutoffMs).sort((a, b) => a.createdAt - b.createdAt).map((a) => a.id);
     }
@@ -60646,7 +60673,7 @@ var require_console_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C0IXtI_E();
+    var require_dist10 = require_dist_C7qWwrK1();
     var require_formatter = require_formatter_DqAKDlvN();
     var LEVEL_RANK = {
       debug: 0,
@@ -60740,7 +60767,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_C0IXtI_E();
+    var require_dist10 = require_dist_C7qWwrK1();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -61637,11 +61664,11 @@ var require_core_blocks = __commonJS({
   }
 });
 
-// ../system/dist/retired-settings-keys-eLv_RCfp.js
-var require_retired_settings_keys_eLv_RCfp = __commonJS({
-  "../system/dist/retired-settings-keys-eLv_RCfp.js"(exports) {
+// ../system/dist/retired-settings-keys-3soU9pfP.js
+var require_retired_settings_keys_3soU9pfP = __commonJS({
+  "../system/dist/retired-settings-keys-3soU9pfP.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_C0IXtI_E();
+    var require_dist10 = require_dist_C7qWwrK1();
     function settingsStoreIsAuthoritativeHere(env) {
       const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
       return raw === "" || raw === "hub";
@@ -63855,8 +63882,8 @@ var require_device_manager_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C0IXtI_E();
-    var require_retired_settings_keys = require_retired_settings_keys_eLv_RCfp();
+    var require_dist10 = require_dist_C7qWwrK1();
+    var require_retired_settings_keys = require_retired_settings_keys_3soU9pfP();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
     var JOB_HISTORY = 20;
@@ -65498,9 +65525,9 @@ var require_device_manager_addon = __commonJS({
       nextVisited.add(id);
       const primary = require_dist10.resolveContainerPrimaryChild((byParent.get(id) ?? []).map((c) => ({
         id: c.id,
-        entityId: String(c.id),
+        stableId: c.stableId,
         type: c.type
-      })), void 0);
+      })), byId.get(id)?.primaryChildEntityId);
       if (primary !== null) expandContainer(primary.id, byId, byParent, nextVisited, out);
     }
     function resolveLinkedDeviceIds(params) {
@@ -68896,7 +68923,7 @@ var require_hub_forwarder = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C0IXtI_E();
+    var require_dist10 = require_dist_C7qWwrK1();
     var require_formatter = require_formatter_DqAKDlvN();
     var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
     var HubForwarderDestination = class {
@@ -69033,7 +69060,7 @@ var require_liveness_monitor_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C0IXtI_E();
+    var require_dist10 = require_dist_C7qWwrK1();
     var NO_DEVICES = "liveness:no-devices";
     var ALL_OFFLINE = "liveness:all-devices-offline";
     var NO_FOOTAGE_PREFIX = "liveness:no-footage:";
@@ -69223,7 +69250,7 @@ var require_local_auth_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C0IXtI_E();
+    var require_dist10 = require_dist_C7qWwrK1();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
     var crypto$1 = __require("crypto");
@@ -77036,7 +77063,7 @@ var require_loki_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C0IXtI_E();
+    var require_dist10 = require_dist_C7qWwrK1();
     function sanitizeLabelName(raw) {
       const replaced = raw.replaceAll(/[^a-zA-Z0-9_]/g, "_");
       return /^[a-zA-Z_]/.test(replaced) ? replaced : `_${replaced}`;
@@ -77601,7 +77628,7 @@ var require_native_metrics_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C0IXtI_E();
+    var require_dist10 = require_dist_C7qWwrK1();
     var node_fs_promises = __require("fs/promises");
     var node_child_process = __require("child_process");
     var node_util = __require("util");
@@ -80185,7 +80212,7 @@ var require_filesystem_storage_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C0IXtI_E();
+    var require_dist10 = require_dist_C7qWwrK1();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     var node_path = __require("path");
@@ -81301,8 +81328,8 @@ var require_sqlite_settings_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C0IXtI_E();
-    var require_retired_settings_keys = require_retired_settings_keys_eLv_RCfp();
+    var require_dist10 = require_dist_C7qWwrK1();
+    var require_retired_settings_keys = require_retired_settings_keys_3soU9pfP();
     var node_crypto = __require("crypto");
     var node_fs = __require("fs");
     var node_module = __require("module");
@@ -83792,7 +83819,7 @@ var require_storage_orchestrator_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C0IXtI_E();
+    var require_dist10 = require_dist_C7qWwrK1();
     var require_hub_cap_forward = require_hub_cap_forward_DmHNjbB0();
     var zod = require_zod();
     var node_crypto = __require("crypto");
@@ -86743,7 +86770,7 @@ var require_system_config_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C0IXtI_E();
+    var require_dist10 = require_dist_C7qWwrK1();
     var SECTION_TITLES = {
       server: "Server",
       auth: "Authentication"
@@ -104804,7 +104831,7 @@ var require_winston_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C0IXtI_E();
+    var require_dist10 = require_dist_C7qWwrK1();
     var require_formatter = require_formatter_DqAKDlvN();
     var node_path = __require("path");
     node_path = require_chunk.__toESM(node_path);
@@ -117304,12 +117331,12 @@ var require_dist2 = __commonJS({
   }
 });
 
-// ../system/dist/manifest-system-deps-D6ncx0jA.js
-var require_manifest_system_deps_D6ncx0jA = __commonJS({
-  "../system/dist/manifest-system-deps-D6ncx0jA.js"(exports) {
+// ../system/dist/manifest-system-deps-PAIfmNun.js
+var require_manifest_system_deps_PAIfmNun = __commonJS({
+  "../system/dist/manifest-system-deps-PAIfmNun.js"(exports) {
     "use strict";
     var require_chunk = require_chunk_Cek0wNdY();
-    require_dist_C0IXtI_E();
+    require_dist_C7qWwrK1();
     require_hub_cap_forward_DmHNjbB0();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
@@ -129376,7 +129403,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_C0IXtI_E();
+    var require_dist10 = require_dist_C7qWwrK1();
     var require_builtins_alerts_alerts_addon = require_alerts_addon();
     require_alerts();
     var require_formatter = require_formatter_DqAKDlvN();
@@ -129403,7 +129430,7 @@ var require_dist3 = __commonJS({
     var require_builtins_winston_logging_index = require_winston_logging();
     var require_file_data_plane = require_file_data_plane_DO8KbxCe();
     var require_tls$1 = require_tls_BxQlomxd();
-    var require_manifest_system_deps = require_manifest_system_deps_D6ncx0jA();
+    var require_manifest_system_deps = require_manifest_system_deps_PAIfmNun();
     var require_resource_monitor = require_resource_monitor_CdnzxBLP();
     var require_custom_action_registry = require_custom_action_registry_jY0NOZK8();
     var zod = require_zod();
@@ -224265,7 +224292,20 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       projection: TrackProjectionSchema.optional(),
       /** Include stationary-promoted rows (parked objects). Default false: the
       *  feed lists passages; parking records live on the stationary registry. */
-      includeStationary: zod.z.boolean().optional()
+      includeStationary: zod.z.boolean().optional(),
+      /**
+      * Restrict to these track classes. ABSENT or EMPTY means no filter.
+      *
+      * The same filter `listTracks` takes, because the timeline's class chips must
+      * mean the same thing whether the scope is one camera or twelve. Until this
+      * existed the scoped feed downloaded a page and narrowed it on the phone
+      * while the single-camera path narrowed the read — one filter, two costs.
+      *
+      * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
+      * whose class list is unreadable are kept, and the client's rule stays the
+      * exact one.
+      */
+      classes: zod.z.array(zod.z.string()).optional()
     });
     var RecentTracksPageSchema = zod.z.object({
       /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -229563,8 +229603,22 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       durability: "session"
     };
     var BatteryStatusSchema = zod.z.object({
-      /** 0..100 inclusive. Firmware-reported. */
-      percentage: zod.z.number().min(0).max(100),
+      /**
+      * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
+      * provider has registered the capability but no reading has landed.
+      *
+      * It is nullable because it was not, and the only value a provider could
+      * seed with was `0`. A battery camera behind an NVR therefore announced
+      * itself at 0% on every start and corrected itself a moment later, which is
+      * indistinguishable from a real flat battery: it fires the low-battery alert
+      * every time the hub restarts. Unknown is not empty (D315), and on a battery
+      * reading the difference is an alarm.
+      *
+      * `vacuum-control` and `lawn-mower-control` already model it this way.
+      * Consumers must SKIP a null rather than coerce it — `battery-band` already
+      * declines to band a non-finite reading, which is the correct shape.
+      */
+      percentage: zod.z.number().min(0).max(100).nullable(),
       /**
       * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
       * Reolink-specific for the Solar Panel 2 accessory (will become
@@ -237456,7 +237510,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     }
     function resolveContainerPrimaryChild(children, overrideEntityId) {
       if (overrideEntityId !== void 0 && overrideEntityId !== null) {
-        const picked = children.find((c) => c.entityId === overrideEntityId);
+        const picked = children.find((c) => c.stableId === overrideEntityId) ?? children.find((c) => c.entityId !== void 0 && c.entityId === overrideEntityId);
         if (picked !== void 0) return picked;
       }
       return [...children].toSorted((a, b) => rank(a.type) - rank(b.type))[0] ?? null;

package/package.json

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