@camstack/addon-provider-reolink 1.2.87 → 1.2.88

package/dist/addon.js

@@ -13648,7 +13648,12 @@ var ConfigEntrySchema = object({
 	value: unknown(),
 	description: string().optional()
 });
-var LinkedDevicesModeSchema = _enum(["auto", "manual"]);
+/**
+* Only `manual` since D356: the operator picks, nothing links itself. The
+* field survives on the wire because a viewer already OTA'd parses it —
+* drop it once no shipped client reads `mode`.
+*/
+var LinkedDevicesModeSchema = _enum(["manual"]);
 /** One resolved linked device — the compact projection consumers need. */
 var LinkedDeviceSchema = object({
 	deviceId: number(),
@@ -34222,6 +34227,17 @@ var BaseDeviceProvider = class extends BaseAddon {
 		return toDeviceSummary(device, this.addonId);
 	}
 };
+/**
+* Default silence budget before a sleeping battery camera is called gone.
+*
+* Sized off the mechanism that produces contact, not off taste: a battery cam
+* on this deployment surfaces a firmware push (battery level, sleep/wake, or a
+* motion email) on the order of hours even with no visitors, and the snapshot
+* wrapper's own battery window is 1 hour. Six hours is therefore several
+* missed opportunities, not one — so a single quiet night does not raise a
+* fault, and a genuinely flat camera is named well inside a day.
+*/
+var BATTERY_UNREACHABLE_AFTER_MS = 360 * 6e4;
 DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Camera, DeviceType.Hub, DeviceType.Switch, DeviceType.Siren, DeviceType.Light, DeviceType.Fan, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder;
 new Set(Object.values(DeviceType));
 DeviceFeature.BatteryOperated;
@@ -231810,6 +231826,15 @@ function reportsPowerSource(info) {
 	return info.adapterStatus !== void 0 || info.chargeStatus !== void 0;
 }
 //#endregion
+//#region src/battery-contact-expiry.ts
+function shouldWakeForContact(input) {
+	if (input.hubChild) return false;
+	if (!input.sleeping) return false;
+	const last = input.lastContactAt;
+	if (typeof last !== "number" || last <= 0) return false;
+	return input.nowMs - last + input.tickMs >= input.unreachableAfterMs;
+}
+//#endregion
 //#region src/log-channels.ts
 /**
 * The diagnostic log CHANNELS `provider-reolink` declares.
@@ -240470,6 +240495,17 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 		const cycle = (async () => {
 			try {
 				if (this.isBattery && this.sleeping) {
+					if (shouldWakeForContact({
+						nowMs: Date.now(),
+						lastContactAt: this.state.battery.lastContactAt,
+						sleeping: true,
+						hubChild: this.isHubChild(),
+						unreachableAfterMs: 216e5,
+						tickMs: ReolinkCamera.BATTERY_UPDATE_INTERVAL_MS
+					})) {
+						await this.wakeForContactRefresh();
+						return;
+					}
 					this.ctx.logger.debug("battery-update: cam sleeping — skipping cycle without connecting", { tags: { deviceId: this.id } });
 					return;
 				}
@@ -240514,6 +240550,43 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 		this.batteryUpdateInFlight = cycle;
 		return cycle;
 	}
+	/**
+	* D355: wake a standalone battery camera ONCE because its last passive
+	* contact is about to expire, and refresh every slice while it is up.
+	* Bounded by `canProactivelyWake` (the shared cooldown) and by the fact
+	* that a wake that answers resets the silence. A wake that fails is left
+	* alone: the silence then reaches the budget and `deriveBatteryPresence`
+	* says `unreachable` — for the first time on evidence.
+	*/
+	async wakeForContactRefresh() {
+		if (!this.canProactivelyWake("contact-expiry")) return;
+		this.markWakeIssued();
+		const lastContactAt = this.state.battery.lastContactAt ?? 0;
+		const silenceMs = Date.now() - lastContactAt;
+		this.ctx.logger.info("battery contact expiring — waking once to refresh every slice (D355)", {
+			tags: { deviceId: this.id },
+			meta: {
+				silenceMs,
+				budgetMs: BATTERY_UNREACHABLE_AFTER_MS
+			}
+		});
+		try {
+			await this.ensureApi();
+		} catch (err) {
+			this.ctx.logger.warn("battery contact wake FAILED — silence continues and the camera will read unreachable at the budget", {
+				tags: { deviceId: this.id },
+				meta: {
+					silenceMs,
+					error: err instanceof Error ? err.message : String(err)
+				}
+			});
+			return;
+		}
+		await this.refreshBatteryFromApi("demand").catch(() => {});
+		await this.warmCapSlicesOnWake().catch(() => {});
+		await this.alignAuxDevicesState("wake").catch(() => {});
+		await this.warmSnapshotOnWake().catch(() => {});
+	}
 	/** Arm the periodic battery-cam refresh timer. No-op for wired cams
 	*  (their state is kept fresh by the 10 s aux-align poll and push
 	*  events). Idempotent. */

package/dist/addon.mjs

@@ -13643,7 +13643,12 @@ var ConfigEntrySchema = object({
 	value: unknown(),
 	description: string().optional()
 });
-var LinkedDevicesModeSchema = _enum(["auto", "manual"]);
+/**
+* Only `manual` since D356: the operator picks, nothing links itself. The
+* field survives on the wire because a viewer already OTA'd parses it —
+* drop it once no shipped client reads `mode`.
+*/
+var LinkedDevicesModeSchema = _enum(["manual"]);
 /** One resolved linked device — the compact projection consumers need. */
 var LinkedDeviceSchema = object({
 	deviceId: number(),
@@ -34217,6 +34222,17 @@ var BaseDeviceProvider = class extends BaseAddon {
 		return toDeviceSummary(device, this.addonId);
 	}
 };
+/**
+* Default silence budget before a sleeping battery camera is called gone.
+*
+* Sized off the mechanism that produces contact, not off taste: a battery cam
+* on this deployment surfaces a firmware push (battery level, sleep/wake, or a
+* motion email) on the order of hours even with no visitors, and the snapshot
+* wrapper's own battery window is 1 hour. Six hours is therefore several
+* missed opportunities, not one — so a single quiet night does not raise a
+* fault, and a genuinely flat camera is named well inside a day.
+*/
+var BATTERY_UNREACHABLE_AFTER_MS = 360 * 6e4;
 DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Camera, DeviceType.Hub, DeviceType.Switch, DeviceType.Siren, DeviceType.Light, DeviceType.Fan, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder;
 new Set(Object.values(DeviceType));
 DeviceFeature.BatteryOperated;
@@ -231790,6 +231806,15 @@ function reportsPowerSource(info) {
 	return info.adapterStatus !== void 0 || info.chargeStatus !== void 0;
 }
 //#endregion
+//#region src/battery-contact-expiry.ts
+function shouldWakeForContact(input) {
+	if (input.hubChild) return false;
+	if (!input.sleeping) return false;
+	const last = input.lastContactAt;
+	if (typeof last !== "number" || last <= 0) return false;
+	return input.nowMs - last + input.tickMs >= input.unreachableAfterMs;
+}
+//#endregion
 //#region src/log-channels.ts
 /**
 * The diagnostic log CHANNELS `provider-reolink` declares.
@@ -240450,6 +240475,17 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 		const cycle = (async () => {
 			try {
 				if (this.isBattery && this.sleeping) {
+					if (shouldWakeForContact({
+						nowMs: Date.now(),
+						lastContactAt: this.state.battery.lastContactAt,
+						sleeping: true,
+						hubChild: this.isHubChild(),
+						unreachableAfterMs: 216e5,
+						tickMs: ReolinkCamera.BATTERY_UPDATE_INTERVAL_MS
+					})) {
+						await this.wakeForContactRefresh();
+						return;
+					}
 					this.ctx.logger.debug("battery-update: cam sleeping — skipping cycle without connecting", { tags: { deviceId: this.id } });
 					return;
 				}
@@ -240494,6 +240530,43 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 		this.batteryUpdateInFlight = cycle;
 		return cycle;
 	}
+	/**
+	* D355: wake a standalone battery camera ONCE because its last passive
+	* contact is about to expire, and refresh every slice while it is up.
+	* Bounded by `canProactivelyWake` (the shared cooldown) and by the fact
+	* that a wake that answers resets the silence. A wake that fails is left
+	* alone: the silence then reaches the budget and `deriveBatteryPresence`
+	* says `unreachable` — for the first time on evidence.
+	*/
+	async wakeForContactRefresh() {
+		if (!this.canProactivelyWake("contact-expiry")) return;
+		this.markWakeIssued();
+		const lastContactAt = this.state.battery.lastContactAt ?? 0;
+		const silenceMs = Date.now() - lastContactAt;
+		this.ctx.logger.info("battery contact expiring — waking once to refresh every slice (D355)", {
+			tags: { deviceId: this.id },
+			meta: {
+				silenceMs,
+				budgetMs: BATTERY_UNREACHABLE_AFTER_MS
+			}
+		});
+		try {
+			await this.ensureApi();
+		} catch (err) {
+			this.ctx.logger.warn("battery contact wake FAILED — silence continues and the camera will read unreachable at the budget", {
+				tags: { deviceId: this.id },
+				meta: {
+					silenceMs,
+					error: err instanceof Error ? err.message : String(err)
+				}
+			});
+			return;
+		}
+		await this.refreshBatteryFromApi("demand").catch(() => {});
+		await this.warmCapSlicesOnWake().catch(() => {});
+		await this.alignAuxDevicesState("wake").catch(() => {});
+		await this.warmSnapshotOnWake().catch(() => {});
+	}
 	/** Arm the periodic battery-cam refresh timer. No-op for wired cams
 	*  (their state is kept fresh by the 10 s aux-align poll and push
 	*  events). Idempotent. */

package/package.json

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