@camstack/addon-provider-dreame 0.2.56 → 0.2.58

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
@@ -69705,7 +69705,20 @@ var RecentTracksQueryInput = object({
69705
69705
  projection: TrackProjectionSchema.optional(),
69706
69706
  /** Include stationary-promoted rows (parked objects). Default false: the
69707
69707
  * feed lists passages; parking records live on the stationary registry. */
69708
- includeStationary: boolean().optional()
69708
+ includeStationary: boolean().optional(),
69709
+ /**
69710
+ * Restrict to these track classes. ABSENT or EMPTY means no filter.
69711
+ *
69712
+ * The same filter `listTracks` takes, because the timeline's class chips must
69713
+ * mean the same thing whether the scope is one camera or twelve. Until this
69714
+ * existed the scoped feed downloaded a page and narrowed it on the phone
69715
+ * while the single-camera path narrowed the read — one filter, two costs.
69716
+ *
69717
+ * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
69718
+ * whose class list is unreadable are kept, and the client's rule stays the
69719
+ * exact one.
69720
+ */
69721
+ classes: array(string()).optional()
69709
69722
  });
69710
69723
  var RecentTracksPageSchema = object({
69711
69724
  /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -70092,7 +70105,21 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
70092
70105
  /** Include stationary-promoted rows (parked objects handed to the
70093
70106
  * stationary registry). Default false: the timeline lists passages,
70094
70107
  * not parking records (operator decision, 2026-08-15). */
70095
- includeStationary: boolean().optional()
70108
+ includeStationary: boolean().optional(),
70109
+ /**
70110
+ * Restrict to these track classes. ABSENT or EMPTY means no filter.
70111
+ *
70112
+ * Added 2026-09-03: the timeline's class chips filtered in the CLIENT,
70113
+ * on a day of rows already downloaded. The zone filter had been moved
70114
+ * here for exactly that reason — and it is also what lets the rows come
70115
+ * back `slim` — but the class filter was left behind, so a narrow
70116
+ * selection was still a wide read followed by a wide discard.
70117
+ *
70118
+ * Empty is "show all", not "nothing matches": a chip row with nothing
70119
+ * selected is an operator who has not narrowed anything, and an empty
70120
+ * timeline would read as a camera that saw nothing.
70121
+ */
70122
+ classes: array(string()).optional()
70096
70123
  }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(object({ deviceId: number() }), _void(), {
70097
70124
  kind: "mutation",
70098
70125
  auth: "admin"
@@ -73861,8 +73888,22 @@ var automationControlCapability = {
73861
73888
  * threshold.
73862
73889
  */
73863
73890
  var BatteryStatusSchema = object({
73864
- /** 0..100 inclusive. Firmware-reported. */
73865
- percentage: number().min(0).max(100),
73891
+ /**
73892
+ * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
73893
+ * provider has registered the capability but no reading has landed.
73894
+ *
73895
+ * It is nullable because it was not, and the only value a provider could
73896
+ * seed with was `0`. A battery camera behind an NVR therefore announced
73897
+ * itself at 0% on every start and corrected itself a moment later, which is
73898
+ * indistinguishable from a real flat battery: it fires the low-battery alert
73899
+ * every time the hub restarts. Unknown is not empty (D315), and on a battery
73900
+ * reading the difference is an alarm.
73901
+ *
73902
+ * `vacuum-control` and `lawn-mower-control` already model it this way.
73903
+ * Consumers must SKIP a null rather than coerce it — `battery-band` already
73904
+ * declines to band a non-finite reading, which is the correct shape.
73905
+ */
73906
+ percentage: number().min(0).max(100).nullable(),
73866
73907
  /**
73867
73908
  * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
73868
73909
  * Reolink-specific for the Solar Panel 2 accessory (will become
package/dist/addon.mjs CHANGED
@@ -69705,7 +69705,20 @@ var RecentTracksQueryInput = object({
69705
69705
  projection: TrackProjectionSchema.optional(),
69706
69706
  /** Include stationary-promoted rows (parked objects). Default false: the
69707
69707
  * feed lists passages; parking records live on the stationary registry. */
69708
- includeStationary: boolean().optional()
69708
+ includeStationary: boolean().optional(),
69709
+ /**
69710
+ * Restrict to these track classes. ABSENT or EMPTY means no filter.
69711
+ *
69712
+ * The same filter `listTracks` takes, because the timeline's class chips must
69713
+ * mean the same thing whether the scope is one camera or twelve. Until this
69714
+ * existed the scoped feed downloaded a page and narrowed it on the phone
69715
+ * while the single-camera path narrowed the read — one filter, two costs.
69716
+ *
69717
+ * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
69718
+ * whose class list is unreadable are kept, and the client's rule stays the
69719
+ * exact one.
69720
+ */
69721
+ classes: array(string()).optional()
69709
69722
  });
69710
69723
  var RecentTracksPageSchema = object({
69711
69724
  /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -70092,7 +70105,21 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
70092
70105
  /** Include stationary-promoted rows (parked objects handed to the
70093
70106
  * stationary registry). Default false: the timeline lists passages,
70094
70107
  * not parking records (operator decision, 2026-08-15). */
70095
- includeStationary: boolean().optional()
70108
+ includeStationary: boolean().optional(),
70109
+ /**
70110
+ * Restrict to these track classes. ABSENT or EMPTY means no filter.
70111
+ *
70112
+ * Added 2026-09-03: the timeline's class chips filtered in the CLIENT,
70113
+ * on a day of rows already downloaded. The zone filter had been moved
70114
+ * here for exactly that reason — and it is also what lets the rows come
70115
+ * back `slim` — but the class filter was left behind, so a narrow
70116
+ * selection was still a wide read followed by a wide discard.
70117
+ *
70118
+ * Empty is "show all", not "nothing matches": a chip row with nothing
70119
+ * selected is an operator who has not narrowed anything, and an empty
70120
+ * timeline would read as a camera that saw nothing.
70121
+ */
70122
+ classes: array(string()).optional()
70096
70123
  }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(object({ deviceId: number() }), _void(), {
70097
70124
  kind: "mutation",
70098
70125
  auth: "admin"
@@ -73861,8 +73888,22 @@ var automationControlCapability = {
73861
73888
  * threshold.
73862
73889
  */
73863
73890
  var BatteryStatusSchema = object({
73864
- /** 0..100 inclusive. Firmware-reported. */
73865
- percentage: number().min(0).max(100),
73891
+ /**
73892
+ * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
73893
+ * provider has registered the capability but no reading has landed.
73894
+ *
73895
+ * It is nullable because it was not, and the only value a provider could
73896
+ * seed with was `0`. A battery camera behind an NVR therefore announced
73897
+ * itself at 0% on every start and corrected itself a moment later, which is
73898
+ * indistinguishable from a real flat battery: it fires the low-battery alert
73899
+ * every time the hub restarts. Unknown is not empty (D315), and on a battery
73900
+ * reading the difference is an alarm.
73901
+ *
73902
+ * `vacuum-control` and `lawn-mower-control` already model it this way.
73903
+ * Consumers must SKIP a null rather than coerce it — `battery-band` already
73904
+ * declines to band a non-finite reading, which is the correct shape.
73905
+ */
73906
+ percentage: number().min(0).max(100).nullable(),
73866
73907
  /**
73867
73908
  * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
73868
73909
  * 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-dreame",
3
- "version": "0.2.56",
3
+ "version": "0.2.58",
4
4
  "description": "Dreame robot-vacuum / lawn-mower device-provider addon for CamStack — wraps the @apocaliss92/nodedreame Dreamehome cloud client",
5
5
  "keywords": [
6
6
  "camstack",