@camstack/addon-export-alexa 1.2.63 → 1.2.64

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.
@@ -19152,7 +19152,20 @@ var RecentTracksQueryInput = object({
19152
19152
  projection: TrackProjectionSchema.optional(),
19153
19153
  /** Include stationary-promoted rows (parked objects). Default false: the
19154
19154
  * feed lists passages; parking records live on the stationary registry. */
19155
- includeStationary: boolean().optional()
19155
+ includeStationary: boolean().optional(),
19156
+ /**
19157
+ * Restrict to these track classes. ABSENT or EMPTY means no filter.
19158
+ *
19159
+ * The same filter `listTracks` takes, because the timeline's class chips must
19160
+ * mean the same thing whether the scope is one camera or twelve. Until this
19161
+ * existed the scoped feed downloaded a page and narrowed it on the phone
19162
+ * while the single-camera path narrowed the read — one filter, two costs.
19163
+ *
19164
+ * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
19165
+ * whose class list is unreadable are kept, and the client's rule stays the
19166
+ * exact one.
19167
+ */
19168
+ classes: array(string()).optional()
19156
19169
  });
19157
19170
  var RecentTracksPageSchema = object({
19158
19171
  /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -23190,8 +23203,22 @@ DeviceType.Automation, method(object({ deviceId: number().int().nonnegative() })
23190
23203
  * threshold.
23191
23204
  */
23192
23205
  var BatteryStatusSchema = object({
23193
- /** 0..100 inclusive. Firmware-reported. */
23194
- percentage: number().min(0).max(100),
23206
+ /**
23207
+ * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
23208
+ * provider has registered the capability but no reading has landed.
23209
+ *
23210
+ * It is nullable because it was not, and the only value a provider could
23211
+ * seed with was `0`. A battery camera behind an NVR therefore announced
23212
+ * itself at 0% on every start and corrected itself a moment later, which is
23213
+ * indistinguishable from a real flat battery: it fires the low-battery alert
23214
+ * every time the hub restarts. Unknown is not empty (D315), and on a battery
23215
+ * reading the difference is an alarm.
23216
+ *
23217
+ * `vacuum-control` and `lawn-mower-control` already model it this way.
23218
+ * Consumers must SKIP a null rather than coerce it — `battery-band` already
23219
+ * declines to band a non-finite reading, which is the correct shape.
23220
+ */
23221
+ percentage: number().min(0).max(100).nullable(),
23195
23222
  /**
23196
23223
  * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
23197
23224
  * Reolink-specific for the Solar Panel 2 accessory (will become
@@ -19125,7 +19125,20 @@ var RecentTracksQueryInput = object({
19125
19125
  projection: TrackProjectionSchema.optional(),
19126
19126
  /** Include stationary-promoted rows (parked objects). Default false: the
19127
19127
  * feed lists passages; parking records live on the stationary registry. */
19128
- includeStationary: boolean().optional()
19128
+ includeStationary: boolean().optional(),
19129
+ /**
19130
+ * Restrict to these track classes. ABSENT or EMPTY means no filter.
19131
+ *
19132
+ * The same filter `listTracks` takes, because the timeline's class chips must
19133
+ * mean the same thing whether the scope is one camera or twelve. Until this
19134
+ * existed the scoped feed downloaded a page and narrowed it on the phone
19135
+ * while the single-camera path narrowed the read — one filter, two costs.
19136
+ *
19137
+ * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
19138
+ * whose class list is unreadable are kept, and the client's rule stays the
19139
+ * exact one.
19140
+ */
19141
+ classes: array(string()).optional()
19129
19142
  });
19130
19143
  var RecentTracksPageSchema = object({
19131
19144
  /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -23163,8 +23176,22 @@ DeviceType.Automation, method(object({ deviceId: number().int().nonnegative() })
23163
23176
  * threshold.
23164
23177
  */
23165
23178
  var BatteryStatusSchema = object({
23166
- /** 0..100 inclusive. Firmware-reported. */
23167
- percentage: number().min(0).max(100),
23179
+ /**
23180
+ * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
23181
+ * provider has registered the capability but no reading has landed.
23182
+ *
23183
+ * It is nullable because it was not, and the only value a provider could
23184
+ * seed with was `0`. A battery camera behind an NVR therefore announced
23185
+ * itself at 0% on every start and corrected itself a moment later, which is
23186
+ * indistinguishable from a real flat battery: it fires the low-battery alert
23187
+ * every time the hub restarts. Unknown is not empty (D315), and on a battery
23188
+ * reading the difference is an alarm.
23189
+ *
23190
+ * `vacuum-control` and `lawn-mower-control` already model it this way.
23191
+ * Consumers must SKIP a null rather than coerce it — `battery-band` already
23192
+ * declines to band a non-finite reading, which is the correct shape.
23193
+ */
23194
+ percentage: number().min(0).max(100).nullable(),
23168
23195
  /**
23169
23196
  * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
23170
23197
  * 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-export-alexa",
3
- "version": "1.2.63",
3
+ "version": "1.2.64",
4
4
  "description": "Alexa Smart Home Skill export — hub-side OAuth provider + directive handler. The companion AWS Lambda forwards Alexa directives to this addon's /addon/export-alexa/directive endpoint.",
5
5
  "keywords": [
6
6
  "camstack",