@camstack/addon-provider-wyze 0.2.60 → 0.2.62

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
@@ -19232,7 +19232,20 @@ var RecentTracksQueryInput = object({
19232
19232
  projection: TrackProjectionSchema.optional(),
19233
19233
  /** Include stationary-promoted rows (parked objects). Default false: the
19234
19234
  * feed lists passages; parking records live on the stationary registry. */
19235
- includeStationary: boolean().optional()
19235
+ includeStationary: boolean().optional(),
19236
+ /**
19237
+ * Restrict to these track classes. ABSENT or EMPTY means no filter.
19238
+ *
19239
+ * The same filter `listTracks` takes, because the timeline's class chips must
19240
+ * mean the same thing whether the scope is one camera or twelve. Until this
19241
+ * existed the scoped feed downloaded a page and narrowed it on the phone
19242
+ * while the single-camera path narrowed the read — one filter, two costs.
19243
+ *
19244
+ * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
19245
+ * whose class list is unreadable are kept, and the client's rule stays the
19246
+ * exact one.
19247
+ */
19248
+ classes: array(string()).optional()
19236
19249
  });
19237
19250
  var RecentTracksPageSchema = object({
19238
19251
  /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -19619,7 +19632,21 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
19619
19632
  /** Include stationary-promoted rows (parked objects handed to the
19620
19633
  * stationary registry). Default false: the timeline lists passages,
19621
19634
  * not parking records (operator decision, 2026-08-15). */
19622
- includeStationary: boolean().optional()
19635
+ includeStationary: boolean().optional(),
19636
+ /**
19637
+ * Restrict to these track classes. ABSENT or EMPTY means no filter.
19638
+ *
19639
+ * Added 2026-09-03: the timeline's class chips filtered in the CLIENT,
19640
+ * on a day of rows already downloaded. The zone filter had been moved
19641
+ * here for exactly that reason — and it is also what lets the rows come
19642
+ * back `slim` — but the class filter was left behind, so a narrow
19643
+ * selection was still a wide read followed by a wide discard.
19644
+ *
19645
+ * Empty is "show all", not "nothing matches": a chip row with nothing
19646
+ * selected is an operator who has not narrowed anything, and an empty
19647
+ * timeline would read as a camera that saw nothing.
19648
+ */
19649
+ classes: array(string()).optional()
19623
19650
  }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(object({ deviceId: number() }), _void(), {
19624
19651
  kind: "mutation",
19625
19652
  auth: "admin"
@@ -23492,8 +23519,22 @@ var automationControlCapability = {
23492
23519
  * threshold.
23493
23520
  */
23494
23521
  var BatteryStatusSchema = object({
23495
- /** 0..100 inclusive. Firmware-reported. */
23496
- percentage: number().min(0).max(100),
23522
+ /**
23523
+ * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
23524
+ * provider has registered the capability but no reading has landed.
23525
+ *
23526
+ * It is nullable because it was not, and the only value a provider could
23527
+ * seed with was `0`. A battery camera behind an NVR therefore announced
23528
+ * itself at 0% on every start and corrected itself a moment later, which is
23529
+ * indistinguishable from a real flat battery: it fires the low-battery alert
23530
+ * every time the hub restarts. Unknown is not empty (D315), and on a battery
23531
+ * reading the difference is an alarm.
23532
+ *
23533
+ * `vacuum-control` and `lawn-mower-control` already model it this way.
23534
+ * Consumers must SKIP a null rather than coerce it — `battery-band` already
23535
+ * declines to band a non-finite reading, which is the correct shape.
23536
+ */
23537
+ percentage: number().min(0).max(100).nullable(),
23497
23538
  /**
23498
23539
  * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
23499
23540
  * Reolink-specific for the Solar Panel 2 accessory (will become
package/dist/addon.mjs CHANGED
@@ -19211,7 +19211,20 @@ var RecentTracksQueryInput = object({
19211
19211
  projection: TrackProjectionSchema.optional(),
19212
19212
  /** Include stationary-promoted rows (parked objects). Default false: the
19213
19213
  * feed lists passages; parking records live on the stationary registry. */
19214
- includeStationary: boolean().optional()
19214
+ includeStationary: boolean().optional(),
19215
+ /**
19216
+ * Restrict to these track classes. ABSENT or EMPTY means no filter.
19217
+ *
19218
+ * The same filter `listTracks` takes, because the timeline's class chips must
19219
+ * mean the same thing whether the scope is one camera or twelve. Until this
19220
+ * existed the scoped feed downloaded a page and narrowed it on the phone
19221
+ * while the single-camera path narrowed the read — one filter, two costs.
19222
+ *
19223
+ * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
19224
+ * whose class list is unreadable are kept, and the client's rule stays the
19225
+ * exact one.
19226
+ */
19227
+ classes: array(string()).optional()
19215
19228
  });
19216
19229
  var RecentTracksPageSchema = object({
19217
19230
  /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -19598,7 +19611,21 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
19598
19611
  /** Include stationary-promoted rows (parked objects handed to the
19599
19612
  * stationary registry). Default false: the timeline lists passages,
19600
19613
  * not parking records (operator decision, 2026-08-15). */
19601
- includeStationary: boolean().optional()
19614
+ includeStationary: boolean().optional(),
19615
+ /**
19616
+ * Restrict to these track classes. ABSENT or EMPTY means no filter.
19617
+ *
19618
+ * Added 2026-09-03: the timeline's class chips filtered in the CLIENT,
19619
+ * on a day of rows already downloaded. The zone filter had been moved
19620
+ * here for exactly that reason — and it is also what lets the rows come
19621
+ * back `slim` — but the class filter was left behind, so a narrow
19622
+ * selection was still a wide read followed by a wide discard.
19623
+ *
19624
+ * Empty is "show all", not "nothing matches": a chip row with nothing
19625
+ * selected is an operator who has not narrowed anything, and an empty
19626
+ * timeline would read as a camera that saw nothing.
19627
+ */
19628
+ classes: array(string()).optional()
19602
19629
  }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(object({ deviceId: number() }), _void(), {
19603
19630
  kind: "mutation",
19604
19631
  auth: "admin"
@@ -23471,8 +23498,22 @@ var automationControlCapability = {
23471
23498
  * threshold.
23472
23499
  */
23473
23500
  var BatteryStatusSchema = object({
23474
- /** 0..100 inclusive. Firmware-reported. */
23475
- percentage: number().min(0).max(100),
23501
+ /**
23502
+ * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
23503
+ * provider has registered the capability but no reading has landed.
23504
+ *
23505
+ * It is nullable because it was not, and the only value a provider could
23506
+ * seed with was `0`. A battery camera behind an NVR therefore announced
23507
+ * itself at 0% on every start and corrected itself a moment later, which is
23508
+ * indistinguishable from a real flat battery: it fires the low-battery alert
23509
+ * every time the hub restarts. Unknown is not empty (D315), and on a battery
23510
+ * reading the difference is an alarm.
23511
+ *
23512
+ * `vacuum-control` and `lawn-mower-control` already model it this way.
23513
+ * Consumers must SKIP a null rather than coerce it — `battery-band` already
23514
+ * declines to band a non-finite reading, which is the correct shape.
23515
+ */
23516
+ percentage: number().min(0).max(100).nullable(),
23476
23517
  /**
23477
23518
  * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
23478
23519
  * 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-provider-wyze",
3
- "version": "0.2.60",
3
+ "version": "0.2.62",
4
4
  "description": "Wyze camera device-provider addon for CamStack — wraps the @apocaliss92/wyze-bridge-js P2P/DTLS client, feeding the stream-broker via the pull-rfc4571 lazy-publish path (a structural twin of addon-provider-reolink)",
5
5
  "keywords": [
6
6
  "camstack",