@camstack/addon-provider-reolink 1.2.80 → 1.2.81

package/dist/addon.js

@@ -19806,7 +19806,20 @@ var RecentTracksQueryInput = object({
 	projection: TrackProjectionSchema.optional(),
 	/** Include stationary-promoted rows (parked objects). Default false: the
 	*  feed lists passages; parking records live on the stationary registry. */
-	includeStationary: boolean().optional()
+	includeStationary: boolean().optional(),
+	/**
+	* Restrict to these track classes. ABSENT or EMPTY means no filter.
+	*
+	* The same filter `listTracks` takes, because the timeline's class chips must
+	* mean the same thing whether the scope is one camera or twelve. Until this
+	* existed the scoped feed downloaded a page and narrowed it on the phone
+	* while the single-camera path narrowed the read — one filter, two costs.
+	*
+	* A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
+	* whose class list is unreadable are kept, and the client's rule stays the
+	* exact one.
+	*/
+	classes: array(string()).optional()
 });
 var RecentTracksPageSchema = object({
 	/** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -24080,8 +24093,22 @@ var automationControlCapability = {
 * threshold.
 */
 var BatteryStatusSchema = object({
-	/** 0..100 inclusive. Firmware-reported. */
-	percentage: number().min(0).max(100),
+	/**
+	* 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
+	* provider has registered the capability but no reading has landed.
+	*
+	* It is nullable because it was not, and the only value a provider could
+	* seed with was `0`. A battery camera behind an NVR therefore announced
+	* itself at 0% on every start and corrected itself a moment later, which is
+	* indistinguishable from a real flat battery: it fires the low-battery alert
+	* every time the hub restarts. Unknown is not empty (D315), and on a battery
+	* reading the difference is an alarm.
+	*
+	* `vacuum-control` and `lawn-mower-control` already model it this way.
+	* Consumers must SKIP a null rather than coerce it — `battery-band` already
+	* declines to band a non-finite reading, which is the correct shape.
+	*/
+	percentage: number().min(0).max(100).nullable(),
 	/**
 	* Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
 	* Reolink-specific for the Solar Panel 2 accessory (will become
@@ -235466,7 +235493,7 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 	* tracker is more reliable.
 	*/
 	mapBatteryInfo(info) {
-		const percentage = typeof info.batteryPercent === "number" ? Math.max(0, Math.min(100, Math.round(info.batteryPercent))) : this.state.battery.percentage ?? 0;
+		const percentage = typeof info.batteryPercent === "number" ? Math.max(0, Math.min(100, Math.round(info.batteryPercent))) : this.state.battery.percentage ?? null;
 		const adapter = (info.adapterStatus ?? "").toLowerCase();
 		const charge = (info.chargeStatus ?? "").toLowerCase();
 		const isCharging = charge === "charging" || charge === "chargecomplete";
@@ -235597,7 +235624,7 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 			}
 		});
 		if (this.getCapSlice(batteryCapability) === null) this.setCapSlice(batteryCapability, {
-			percentage: 0,
+			percentage: null,
 			charging: "none",
 			sleeping: false,
 			lastUpdated: Date.now()

package/dist/addon.mjs

@@ -19801,7 +19801,20 @@ var RecentTracksQueryInput = object({
 	projection: TrackProjectionSchema.optional(),
 	/** Include stationary-promoted rows (parked objects). Default false: the
 	*  feed lists passages; parking records live on the stationary registry. */
-	includeStationary: boolean().optional()
+	includeStationary: boolean().optional(),
+	/**
+	* Restrict to these track classes. ABSENT or EMPTY means no filter.
+	*
+	* The same filter `listTracks` takes, because the timeline's class chips must
+	* mean the same thing whether the scope is one camera or twelve. Until this
+	* existed the scoped feed downloaded a page and narrowed it on the phone
+	* while the single-camera path narrowed the read — one filter, two costs.
+	*
+	* A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
+	* whose class list is unreadable are kept, and the client's rule stays the
+	* exact one.
+	*/
+	classes: array(string()).optional()
 });
 var RecentTracksPageSchema = object({
 	/** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -24075,8 +24088,22 @@ var automationControlCapability = {
 * threshold.
 */
 var BatteryStatusSchema = object({
-	/** 0..100 inclusive. Firmware-reported. */
-	percentage: number().min(0).max(100),
+	/**
+	* 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
+	* provider has registered the capability but no reading has landed.
+	*
+	* It is nullable because it was not, and the only value a provider could
+	* seed with was `0`. A battery camera behind an NVR therefore announced
+	* itself at 0% on every start and corrected itself a moment later, which is
+	* indistinguishable from a real flat battery: it fires the low-battery alert
+	* every time the hub restarts. Unknown is not empty (D315), and on a battery
+	* reading the difference is an alarm.
+	*
+	* `vacuum-control` and `lawn-mower-control` already model it this way.
+	* Consumers must SKIP a null rather than coerce it — `battery-band` already
+	* declines to band a non-finite reading, which is the correct shape.
+	*/
+	percentage: number().min(0).max(100).nullable(),
 	/**
 	* Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
 	* Reolink-specific for the Solar Panel 2 accessory (will become
@@ -235446,7 +235473,7 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 	* tracker is more reliable.
 	*/
 	mapBatteryInfo(info) {
-		const percentage = typeof info.batteryPercent === "number" ? Math.max(0, Math.min(100, Math.round(info.batteryPercent))) : this.state.battery.percentage ?? 0;
+		const percentage = typeof info.batteryPercent === "number" ? Math.max(0, Math.min(100, Math.round(info.batteryPercent))) : this.state.battery.percentage ?? null;
 		const adapter = (info.adapterStatus ?? "").toLowerCase();
 		const charge = (info.chargeStatus ?? "").toLowerCase();
 		const isCharging = charge === "charging" || charge === "chargecomplete";
@@ -235577,7 +235604,7 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 			}
 		});
 		if (this.getCapSlice(batteryCapability) === null) this.setCapSlice(batteryCapability, {
-			percentage: 0,
+			percentage: null,
 			charging: "none",
 			sleeping: false,
 			lastUpdated: Date.now()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-reolink",
-  "version": "1.2.80",
+  "version": "1.2.81",
   "description": "Reolink camera device provider addon for CamStack — native Baichuan protocol",
   "keywords": [
     "camstack",