@camstack/addon-terminal 0.1.62 → 0.1.63

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/addon.js CHANGED
@@ -19227,7 +19227,20 @@ var RecentTracksQueryInput = object({
19227
19227
  projection: TrackProjectionSchema.optional(),
19228
19228
  /** Include stationary-promoted rows (parked objects). Default false: the
19229
19229
  * feed lists passages; parking records live on the stationary registry. */
19230
- includeStationary: boolean().optional()
19230
+ includeStationary: boolean().optional(),
19231
+ /**
19232
+ * Restrict to these track classes. ABSENT or EMPTY means no filter.
19233
+ *
19234
+ * The same filter `listTracks` takes, because the timeline's class chips must
19235
+ * mean the same thing whether the scope is one camera or twelve. Until this
19236
+ * existed the scoped feed downloaded a page and narrowed it on the phone
19237
+ * while the single-camera path narrowed the read — one filter, two costs.
19238
+ *
19239
+ * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
19240
+ * whose class list is unreadable are kept, and the client's rule stays the
19241
+ * exact one.
19242
+ */
19243
+ classes: array(string()).optional()
19231
19244
  });
19232
19245
  var RecentTracksPageSchema = object({
19233
19246
  /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -23545,8 +23558,22 @@ var automationControlCapability = {
23545
23558
  * threshold.
23546
23559
  */
23547
23560
  var BatteryStatusSchema = object({
23548
- /** 0..100 inclusive. Firmware-reported. */
23549
- percentage: number().min(0).max(100),
23561
+ /**
23562
+ * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
23563
+ * provider has registered the capability but no reading has landed.
23564
+ *
23565
+ * It is nullable because it was not, and the only value a provider could
23566
+ * seed with was `0`. A battery camera behind an NVR therefore announced
23567
+ * itself at 0% on every start and corrected itself a moment later, which is
23568
+ * indistinguishable from a real flat battery: it fires the low-battery alert
23569
+ * every time the hub restarts. Unknown is not empty (D315), and on a battery
23570
+ * reading the difference is an alarm.
23571
+ *
23572
+ * `vacuum-control` and `lawn-mower-control` already model it this way.
23573
+ * Consumers must SKIP a null rather than coerce it — `battery-band` already
23574
+ * declines to band a non-finite reading, which is the correct shape.
23575
+ */
23576
+ percentage: number().min(0).max(100).nullable(),
23550
23577
  /**
23551
23578
  * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
23552
23579
  * Reolink-specific for the Solar Panel 2 accessory (will become
package/dist/addon.mjs CHANGED
@@ -19204,7 +19204,20 @@ var RecentTracksQueryInput = object({
19204
19204
  projection: TrackProjectionSchema.optional(),
19205
19205
  /** Include stationary-promoted rows (parked objects). Default false: the
19206
19206
  * feed lists passages; parking records live on the stationary registry. */
19207
- includeStationary: boolean().optional()
19207
+ includeStationary: boolean().optional(),
19208
+ /**
19209
+ * Restrict to these track classes. ABSENT or EMPTY means no filter.
19210
+ *
19211
+ * The same filter `listTracks` takes, because the timeline's class chips must
19212
+ * mean the same thing whether the scope is one camera or twelve. Until this
19213
+ * existed the scoped feed downloaded a page and narrowed it on the phone
19214
+ * while the single-camera path narrowed the read — one filter, two costs.
19215
+ *
19216
+ * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
19217
+ * whose class list is unreadable are kept, and the client's rule stays the
19218
+ * exact one.
19219
+ */
19220
+ classes: array(string()).optional()
19208
19221
  });
19209
19222
  var RecentTracksPageSchema = object({
19210
19223
  /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -23522,8 +23535,22 @@ var automationControlCapability = {
23522
23535
  * threshold.
23523
23536
  */
23524
23537
  var BatteryStatusSchema = object({
23525
- /** 0..100 inclusive. Firmware-reported. */
23526
- percentage: number().min(0).max(100),
23538
+ /**
23539
+ * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
23540
+ * provider has registered the capability but no reading has landed.
23541
+ *
23542
+ * It is nullable because it was not, and the only value a provider could
23543
+ * seed with was `0`. A battery camera behind an NVR therefore announced
23544
+ * itself at 0% on every start and corrected itself a moment later, which is
23545
+ * indistinguishable from a real flat battery: it fires the low-battery alert
23546
+ * every time the hub restarts. Unknown is not empty (D315), and on a battery
23547
+ * reading the difference is an alarm.
23548
+ *
23549
+ * `vacuum-control` and `lawn-mower-control` already model it this way.
23550
+ * Consumers must SKIP a null rather than coerce it — `battery-band` already
23551
+ * declines to band a non-finite reading, which is the correct shape.
23552
+ */
23553
+ percentage: number().min(0).max(100).nullable(),
23527
23554
  /**
23528
23555
  * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
23529
23556
  * Reolink-specific for the Solar Panel 2 accessory (will become
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-terminal",
3
- "version": "0.1.62",
3
+ "version": "0.1.63",
4
4
  "description": "Interactive terminal sessions (pty + xterm) as a CamStack addon",
5
5
  "keywords": [
6
6
  "camstack",