@camstack/addon-notifiers 1.2.61 → 1.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
@@ -19029,7 +19029,20 @@ var RecentTracksQueryInput = object({
19029
19029
  projection: TrackProjectionSchema.optional(),
19030
19030
  /** Include stationary-promoted rows (parked objects). Default false: the
19031
19031
  * feed lists passages; parking records live on the stationary registry. */
19032
- includeStationary: boolean().optional()
19032
+ includeStationary: boolean().optional(),
19033
+ /**
19034
+ * Restrict to these track classes. ABSENT or EMPTY means no filter.
19035
+ *
19036
+ * The same filter `listTracks` takes, because the timeline's class chips must
19037
+ * mean the same thing whether the scope is one camera or twelve. Until this
19038
+ * existed the scoped feed downloaded a page and narrowed it on the phone
19039
+ * while the single-camera path narrowed the read — one filter, two costs.
19040
+ *
19041
+ * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
19042
+ * whose class list is unreadable are kept, and the client's rule stays the
19043
+ * exact one.
19044
+ */
19045
+ classes: array(string()).optional()
19033
19046
  });
19034
19047
  var RecentTracksPageSchema = object({
19035
19048
  /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -23067,8 +23080,22 @@ DeviceType.Automation, method(object({ deviceId: number().int().nonnegative() })
23067
23080
  * threshold.
23068
23081
  */
23069
23082
  var BatteryStatusSchema = object({
23070
- /** 0..100 inclusive. Firmware-reported. */
23071
- percentage: number().min(0).max(100),
23083
+ /**
23084
+ * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
23085
+ * provider has registered the capability but no reading has landed.
23086
+ *
23087
+ * It is nullable because it was not, and the only value a provider could
23088
+ * seed with was `0`. A battery camera behind an NVR therefore announced
23089
+ * itself at 0% on every start and corrected itself a moment later, which is
23090
+ * indistinguishable from a real flat battery: it fires the low-battery alert
23091
+ * every time the hub restarts. Unknown is not empty (D315), and on a battery
23092
+ * reading the difference is an alarm.
23093
+ *
23094
+ * `vacuum-control` and `lawn-mower-control` already model it this way.
23095
+ * Consumers must SKIP a null rather than coerce it — `battery-band` already
23096
+ * declines to band a non-finite reading, which is the correct shape.
23097
+ */
23098
+ percentage: number().min(0).max(100).nullable(),
23072
23099
  /**
23073
23100
  * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
23074
23101
  * Reolink-specific for the Solar Panel 2 accessory (will become
package/dist/addon.mjs CHANGED
@@ -19002,7 +19002,20 @@ var RecentTracksQueryInput = object({
19002
19002
  projection: TrackProjectionSchema.optional(),
19003
19003
  /** Include stationary-promoted rows (parked objects). Default false: the
19004
19004
  * feed lists passages; parking records live on the stationary registry. */
19005
- includeStationary: boolean().optional()
19005
+ includeStationary: boolean().optional(),
19006
+ /**
19007
+ * Restrict to these track classes. ABSENT or EMPTY means no filter.
19008
+ *
19009
+ * The same filter `listTracks` takes, because the timeline's class chips must
19010
+ * mean the same thing whether the scope is one camera or twelve. Until this
19011
+ * existed the scoped feed downloaded a page and narrowed it on the phone
19012
+ * while the single-camera path narrowed the read — one filter, two costs.
19013
+ *
19014
+ * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
19015
+ * whose class list is unreadable are kept, and the client's rule stays the
19016
+ * exact one.
19017
+ */
19018
+ classes: array(string()).optional()
19006
19019
  });
19007
19020
  var RecentTracksPageSchema = object({
19008
19021
  /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -23040,8 +23053,22 @@ DeviceType.Automation, method(object({ deviceId: number().int().nonnegative() })
23040
23053
  * threshold.
23041
23054
  */
23042
23055
  var BatteryStatusSchema = object({
23043
- /** 0..100 inclusive. Firmware-reported. */
23044
- percentage: number().min(0).max(100),
23056
+ /**
23057
+ * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
23058
+ * provider has registered the capability but no reading has landed.
23059
+ *
23060
+ * It is nullable because it was not, and the only value a provider could
23061
+ * seed with was `0`. A battery camera behind an NVR therefore announced
23062
+ * itself at 0% on every start and corrected itself a moment later, which is
23063
+ * indistinguishable from a real flat battery: it fires the low-battery alert
23064
+ * every time the hub restarts. Unknown is not empty (D315), and on a battery
23065
+ * reading the difference is an alarm.
23066
+ *
23067
+ * `vacuum-control` and `lawn-mower-control` already model it this way.
23068
+ * Consumers must SKIP a null rather than coerce it — `battery-band` already
23069
+ * declines to band a non-finite reading, which is the correct shape.
23070
+ */
23071
+ percentage: number().min(0).max(100).nullable(),
23045
23072
  /**
23046
23073
  * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
23047
23074
  * 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-notifiers",
3
- "version": "1.2.61",
3
+ "version": "1.2.62",
4
4
  "description": "System notifiers addon for CamStack — a `notification-output` collection provider hosting per-kind notifier adapters (ntfy, pushover, gotify, telegram, discord, webhook, zentik).",
5
5
  "keywords": [
6
6
  "camstack",