@camstack/addon-provider-wyze 0.2.61 → 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). */
@@ -23506,8 +23519,22 @@ var automationControlCapability = {
23506
23519
  * threshold.
23507
23520
  */
23508
23521
  var BatteryStatusSchema = object({
23509
- /** 0..100 inclusive. Firmware-reported. */
23510
- 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(),
23511
23538
  /**
23512
23539
  * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
23513
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). */
@@ -23485,8 +23498,22 @@ var automationControlCapability = {
23485
23498
  * threshold.
23486
23499
  */
23487
23500
  var BatteryStatusSchema = object({
23488
- /** 0..100 inclusive. Firmware-reported. */
23489
- 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(),
23490
23517
  /**
23491
23518
  * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
23492
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.61",
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",