@camstack/addon-provider-reolink 1.2.87 → 1.2.89

package/dist/addon.js

@@ -7592,7 +7592,8 @@ var CameraSwitchAuthoritySchema = discriminatedUnion("kind", [
 var CameraSwitchUnavailableReasonSchema = _enum([
 	"no-provider",
 	"source-unreachable",
-	"not-configured"
+	"not-configured",
+	"device-disabled"
 ]);
 /**
 * One switch, resolved for one camera.
@@ -13648,7 +13649,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(),
@@ -24320,12 +24326,20 @@ var BatteryStatusSchema = object({
 	* Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
 	* Reolink-specific for the Solar Panel 2 accessory (will become
 	* common on other battery cams). `'none'` means running on battery
-	* alone.
+	* alone — a NEGATIVE the firmware actually reported.
+	*
+	* `'unknown'` is the absence of an answer: the provider has not read the
+	* power fields yet, or the firmware reported neither. Before it existed,
+	* two unreadable fields produced `'none'`, and a camera nobody had reached
+	* was drawn "on battery alone" — the same D315 defect `percentage` closed
+	* by going nullable. Consumers SKIP it (no charger state published, no
+	* glyph, no HomeKit ChargingState) rather than coerce it either way.
 	*/
 	charging: _enum([
 		"dc",
 		"solar",
-		"none"
+		"none",
+		"unknown"
 	]),
 	/**
 	* True when the camera firmware has gone into low-power mode. Battery
@@ -24415,7 +24429,7 @@ onStatusChanged: { data: object({
 		kind: "push",
 		empty: {
 			percentage: 0,
-			charging: "none",
+			charging: "unknown",
 			sleeping: false,
 			lastUpdated: 0
 		}
@@ -34123,8 +34137,17 @@ var BaseDeviceProvider = class extends BaseAddon {
 	async onRestoreDevices(savedDevices) {
 		const restored = /* @__PURE__ */ new Set();
 		const failures = [];
+		const liveStableIds = new Set((await this.ctx.kernel.devices.getAll()).map((device) => device.stableId));
 		const attemptRestore = async (saved) => {
 			if (restored.has(saved.id)) return;
+			if (liveStableIds.has(saved.stableId)) {
+				this.ctx.logger.debug("Restore row already live — not dialled again", { tags: {
+					deviceId: saved.id,
+					stableId: saved.stableId
+				} });
+				restored.add(saved.id);
+				return;
+			}
 			const Class = this.deviceClasses[saved.type];
 			if (!Class) throw new Error(`no device class registered for type "${saved.type}"`);
 			if (saved.parentDeviceId !== null && !restored.has(saved.parentDeviceId)) throw new Error(`parent device ${saved.parentDeviceId} not restored`);
@@ -34222,6 +34245,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;
@@ -231785,13 +231819,15 @@ var reolinkDebugActions = defineCustomActions({ debugRawRead: customAction(RawRe
 * passato da `adapterStatus: 1` a `0`, con `chargeStatus: 0` da entrambe le
 * parti — cioè `chargeStatus` da solo NON distingue i due stati.
 *
-* ⚠️ Questa funzione non sa ancora dire "non lo so": `BatteryStatus['charging']`
-* non ha un valore `unknown`, quindi due campi illeggibili producono `'none'`,
-* che è un valore NEGATIVO al posto di un non-noto. È il difetto D315 che
-* `percentage` ha già chiuso (è `nullable`) e questo campo no; chiuderlo tocca
-* `battery.cap.ts`, cioè la closure del server, e vive nel proprio lavoro.
+* Due campi assenti NON sono `'none'`: `'none'` è un negativo che il firmware
+* ha detto ("nessun adattatore, cella ferma"), l'assenza di entrambi è
+* `'unknown'` — lo stesso confine che `percentage` ha chiuso diventando
+* `nullable` (D315). Il chiamante (`mapBatteryInfo`) non arriva qui con un
+* push che non parla di alimentazione: `reportsPowerSource` lo filtra prima e
+* conserva la convinzione precedente.
 */
 function deriveChargingSource(adapterStatus, chargeStatus) {
+	if (adapterStatus === void 0 && chargeStatus === void 0) return "unknown";
 	const adapter = (adapterStatus ?? "").toLowerCase();
 	const charge = (chargeStatus ?? "").toLowerCase();
 	if (adapter.includes("solar")) return "solar";
@@ -231810,6 +231846,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.
@@ -236921,7 +236966,7 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 	mapBatteryInfo(info) {
 		return {
 			percentage: typeof info.batteryPercent === "number" ? Math.max(0, Math.min(100, Math.round(info.batteryPercent))) : this.state.battery.percentage ?? null,
-			charging: reportsPowerSource(info) ? deriveChargingSource(info.adapterStatus, info.chargeStatus) : this.state.battery.charging ?? "none",
+			charging: reportsPowerSource(info) ? deriveChargingSource(info.adapterStatus, info.chargeStatus) : this.state.battery.charging ?? "unknown",
 			sleeping: info.sleeping === true || this.sleeping,
 			lastUpdated: Date.now()
 		};
@@ -240470,6 +240515,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 +240570,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. */
@@ -242930,6 +243023,69 @@ function asDebugSocketFlags(value) {
 	return Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
 }
 //#endregion
+//#region src/hub-battery-fields.ts
+/**
+* The hub boundary for the per-channel battery power fields.
+*
+* The Reolink hub/NVR reports `chargeStatus` and `adapterStatus` as NUMBERS
+* (0/1/2); the standalone camera path reports the same facts as strings, and
+* `deriveChargingSource` (`battery-charging.ts`) speaks only the string
+* vocabulary. This module is the translation, and — the part that was
+* missing — it NAMES a code it cannot translate instead of dropping the field
+* silently. A dropped field reads as "the push said nothing about power", so
+* a new firmware value would have kept the previous belief forever, with not
+* one log line. The ledger lets the hub warn once per (device, field, code).
+*/
+var CHARGE_STATUS_BY_CODE = {
+	0: "none",
+	1: "charging",
+	2: "chargeComplete"
+};
+var ADAPTER_STATUS_BY_CODE = {
+	0: "none",
+	1: "dc",
+	2: "solarPanel"
+};
+function mapOne(field, value, byCode) {
+	if (value === void 0 || value === null) return {};
+	if (typeof value === "string") return { mapped: value };
+	if (typeof value === "number") {
+		const mapped = byCode[value];
+		if (mapped !== void 0) return { mapped };
+	}
+	return { unmapped: {
+		field,
+		value
+	} };
+}
+/** Translate one channel's raw CGI power fields; never throws. */
+function mapHubBatteryPower(cgi) {
+	const charge = mapOne("chargeStatus", cgi?.["chargeStatus"], CHARGE_STATUS_BY_CODE);
+	const adapter = mapOne("adapterStatus", cgi?.["adapterStatus"], ADAPTER_STATUS_BY_CODE);
+	return {
+		fields: {
+			...charge.mapped !== void 0 ? { chargeStatus: charge.mapped } : {},
+			...adapter.mapped !== void 0 ? { adapterStatus: adapter.mapped } : {}
+		},
+		unmapped: [...charge.unmapped !== void 0 ? [charge.unmapped] : [], ...adapter.unmapped !== void 0 ? [adapter.unmapped] : []]
+	};
+}
+/**
+* Remembers which (device, field, code) triples were already reported, so a
+* polled read warns once per finding and not once per tick. Unbounded only in
+* theory: the key space is a few cameras times two fields times the handful of
+* codes a firmware can invent.
+*/
+var UnmappedCodeLedger = class {
+	seen = /* @__PURE__ */ new Set();
+	firstSeen(deviceId, field, value) {
+		const key = `${deviceId}:${field}:${String(value)}`;
+		if (this.seen.has(key)) return false;
+		this.seen.add(key);
+		return true;
+	}
+};
+//#endregion
 //#region src/reolink-hub.ts
 var HUB_DISCOVERY_REFRESH_TIMEOUT_MS = 8e3;
 /**
@@ -242991,6 +243147,8 @@ var ReolinkHub = class ReolinkHub extends BaseDevice {
 	/** One-shot: the raw per-channel battery payload is logged once per
 	*  process so the firmware's charge-field naming is on record. */
 	batteryShapeLogged = false;
+	/** Firmware power codes this hub could not translate — warned once each. */
+	unmappedBatteryCodes = new UnmappedCodeLedger();
 	/** Channels the last successful discovery refresh listed as present but
 	*  NOT adopted — their pushes are expected drops (debug), not faults. */
 	knownUnadoptedChannels = /* @__PURE__ */ new Set();
@@ -243471,10 +243629,21 @@ var ReolinkHub = class ReolinkHub extends BaseDevice {
 				const child = all.find((d) => d.id === deviceId);
 				if (!(child instanceof ReolinkCamera)) continue;
 				const cgi = info.entries[0];
+				const power = mapHubBatteryPower(cgi);
+				for (const { field, value } of power.unmapped) {
+					if (!this.unmappedBatteryCodes.firstSeen(deviceId, field, value)) continue;
+					this.ctx.logger.warn("Reolink Hub: unmapped battery power code — field dropped", {
+						tags: { deviceId },
+						meta: {
+							channel: Number(chKey),
+							field,
+							value
+						}
+					});
+				}
 				child.applyHubBatteryInfo({
 					batteryPercent: info.batteryLevel,
-					...mapHubChargeStatus(cgi?.["chargeStatus"]) !== void 0 ? { chargeStatus: mapHubChargeStatus(cgi?.["chargeStatus"]) } : {},
-					...mapHubAdapterStatus(cgi?.["adapterStatus"]) !== void 0 ? { adapterStatus: mapHubAdapterStatus(cgi?.["adapterStatus"]) } : {}
+					...power.fields
 				});
 			}
 		} catch (err) {
@@ -243915,18 +244084,6 @@ function discoveredStatusFor(d) {
 *   chargeStatus: 0 none · 1 charging · 2 charge complete
 *   adapterStatus: 0 none · 1 DC adapter · 2 solar panel
 */
-function mapHubChargeStatus(value) {
-	if (typeof value === "string") return value;
-	if (value === 0) return "none";
-	if (value === 1) return "charging";
-	if (value === 2) return "chargeComplete";
-}
-function mapHubAdapterStatus(value) {
-	if (typeof value === "string") return value;
-	if (value === 0) return "none";
-	if (value === 1) return "dc";
-	if (value === 2) return "solarPanel";
-}
 //#endregion
 //#region src/creation-schema.ts
 /**

package/dist/addon.mjs

@@ -7587,7 +7587,8 @@ var CameraSwitchAuthoritySchema = discriminatedUnion("kind", [
 var CameraSwitchUnavailableReasonSchema = _enum([
 	"no-provider",
 	"source-unreachable",
-	"not-configured"
+	"not-configured",
+	"device-disabled"
 ]);
 /**
 * One switch, resolved for one camera.
@@ -13643,7 +13644,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(),
@@ -24315,12 +24321,20 @@ var BatteryStatusSchema = object({
 	* Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
 	* Reolink-specific for the Solar Panel 2 accessory (will become
 	* common on other battery cams). `'none'` means running on battery
-	* alone.
+	* alone — a NEGATIVE the firmware actually reported.
+	*
+	* `'unknown'` is the absence of an answer: the provider has not read the
+	* power fields yet, or the firmware reported neither. Before it existed,
+	* two unreadable fields produced `'none'`, and a camera nobody had reached
+	* was drawn "on battery alone" — the same D315 defect `percentage` closed
+	* by going nullable. Consumers SKIP it (no charger state published, no
+	* glyph, no HomeKit ChargingState) rather than coerce it either way.
 	*/
 	charging: _enum([
 		"dc",
 		"solar",
-		"none"
+		"none",
+		"unknown"
 	]),
 	/**
 	* True when the camera firmware has gone into low-power mode. Battery
@@ -24410,7 +24424,7 @@ onStatusChanged: { data: object({
 		kind: "push",
 		empty: {
 			percentage: 0,
-			charging: "none",
+			charging: "unknown",
 			sleeping: false,
 			lastUpdated: 0
 		}
@@ -34118,8 +34132,17 @@ var BaseDeviceProvider = class extends BaseAddon {
 	async onRestoreDevices(savedDevices) {
 		const restored = /* @__PURE__ */ new Set();
 		const failures = [];
+		const liveStableIds = new Set((await this.ctx.kernel.devices.getAll()).map((device) => device.stableId));
 		const attemptRestore = async (saved) => {
 			if (restored.has(saved.id)) return;
+			if (liveStableIds.has(saved.stableId)) {
+				this.ctx.logger.debug("Restore row already live — not dialled again", { tags: {
+					deviceId: saved.id,
+					stableId: saved.stableId
+				} });
+				restored.add(saved.id);
+				return;
+			}
 			const Class = this.deviceClasses[saved.type];
 			if (!Class) throw new Error(`no device class registered for type "${saved.type}"`);
 			if (saved.parentDeviceId !== null && !restored.has(saved.parentDeviceId)) throw new Error(`parent device ${saved.parentDeviceId} not restored`);
@@ -34217,6 +34240,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;
@@ -231765,13 +231799,15 @@ var reolinkDebugActions = defineCustomActions({ debugRawRead: customAction(RawRe
 * passato da `adapterStatus: 1` a `0`, con `chargeStatus: 0` da entrambe le
 * parti — cioè `chargeStatus` da solo NON distingue i due stati.
 *
-* ⚠️ Questa funzione non sa ancora dire "non lo so": `BatteryStatus['charging']`
-* non ha un valore `unknown`, quindi due campi illeggibili producono `'none'`,
-* che è un valore NEGATIVO al posto di un non-noto. È il difetto D315 che
-* `percentage` ha già chiuso (è `nullable`) e questo campo no; chiuderlo tocca
-* `battery.cap.ts`, cioè la closure del server, e vive nel proprio lavoro.
+* Due campi assenti NON sono `'none'`: `'none'` è un negativo che il firmware
+* ha detto ("nessun adattatore, cella ferma"), l'assenza di entrambi è
+* `'unknown'` — lo stesso confine che `percentage` ha chiuso diventando
+* `nullable` (D315). Il chiamante (`mapBatteryInfo`) non arriva qui con un
+* push che non parla di alimentazione: `reportsPowerSource` lo filtra prima e
+* conserva la convinzione precedente.
 */
 function deriveChargingSource(adapterStatus, chargeStatus) {
+	if (adapterStatus === void 0 && chargeStatus === void 0) return "unknown";
 	const adapter = (adapterStatus ?? "").toLowerCase();
 	const charge = (chargeStatus ?? "").toLowerCase();
 	if (adapter.includes("solar")) return "solar";
@@ -231790,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.
@@ -236901,7 +236946,7 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 	mapBatteryInfo(info) {
 		return {
 			percentage: typeof info.batteryPercent === "number" ? Math.max(0, Math.min(100, Math.round(info.batteryPercent))) : this.state.battery.percentage ?? null,
-			charging: reportsPowerSource(info) ? deriveChargingSource(info.adapterStatus, info.chargeStatus) : this.state.battery.charging ?? "none",
+			charging: reportsPowerSource(info) ? deriveChargingSource(info.adapterStatus, info.chargeStatus) : this.state.battery.charging ?? "unknown",
 			sleeping: info.sleeping === true || this.sleeping,
 			lastUpdated: Date.now()
 		};
@@ -240450,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;
 				}
@@ -240494,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. */
@@ -242910,6 +243003,69 @@ function asDebugSocketFlags(value) {
 	return Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
 }
 //#endregion
+//#region src/hub-battery-fields.ts
+/**
+* The hub boundary for the per-channel battery power fields.
+*
+* The Reolink hub/NVR reports `chargeStatus` and `adapterStatus` as NUMBERS
+* (0/1/2); the standalone camera path reports the same facts as strings, and
+* `deriveChargingSource` (`battery-charging.ts`) speaks only the string
+* vocabulary. This module is the translation, and — the part that was
+* missing — it NAMES a code it cannot translate instead of dropping the field
+* silently. A dropped field reads as "the push said nothing about power", so
+* a new firmware value would have kept the previous belief forever, with not
+* one log line. The ledger lets the hub warn once per (device, field, code).
+*/
+var CHARGE_STATUS_BY_CODE = {
+	0: "none",
+	1: "charging",
+	2: "chargeComplete"
+};
+var ADAPTER_STATUS_BY_CODE = {
+	0: "none",
+	1: "dc",
+	2: "solarPanel"
+};
+function mapOne(field, value, byCode) {
+	if (value === void 0 || value === null) return {};
+	if (typeof value === "string") return { mapped: value };
+	if (typeof value === "number") {
+		const mapped = byCode[value];
+		if (mapped !== void 0) return { mapped };
+	}
+	return { unmapped: {
+		field,
+		value
+	} };
+}
+/** Translate one channel's raw CGI power fields; never throws. */
+function mapHubBatteryPower(cgi) {
+	const charge = mapOne("chargeStatus", cgi?.["chargeStatus"], CHARGE_STATUS_BY_CODE);
+	const adapter = mapOne("adapterStatus", cgi?.["adapterStatus"], ADAPTER_STATUS_BY_CODE);
+	return {
+		fields: {
+			...charge.mapped !== void 0 ? { chargeStatus: charge.mapped } : {},
+			...adapter.mapped !== void 0 ? { adapterStatus: adapter.mapped } : {}
+		},
+		unmapped: [...charge.unmapped !== void 0 ? [charge.unmapped] : [], ...adapter.unmapped !== void 0 ? [adapter.unmapped] : []]
+	};
+}
+/**
+* Remembers which (device, field, code) triples were already reported, so a
+* polled read warns once per finding and not once per tick. Unbounded only in
+* theory: the key space is a few cameras times two fields times the handful of
+* codes a firmware can invent.
+*/
+var UnmappedCodeLedger = class {
+	seen = /* @__PURE__ */ new Set();
+	firstSeen(deviceId, field, value) {
+		const key = `${deviceId}:${field}:${String(value)}`;
+		if (this.seen.has(key)) return false;
+		this.seen.add(key);
+		return true;
+	}
+};
+//#endregion
 //#region src/reolink-hub.ts
 var HUB_DISCOVERY_REFRESH_TIMEOUT_MS = 8e3;
 /**
@@ -242971,6 +243127,8 @@ var ReolinkHub = class ReolinkHub extends BaseDevice {
 	/** One-shot: the raw per-channel battery payload is logged once per
 	*  process so the firmware's charge-field naming is on record. */
 	batteryShapeLogged = false;
+	/** Firmware power codes this hub could not translate — warned once each. */
+	unmappedBatteryCodes = new UnmappedCodeLedger();
 	/** Channels the last successful discovery refresh listed as present but
 	*  NOT adopted — their pushes are expected drops (debug), not faults. */
 	knownUnadoptedChannels = /* @__PURE__ */ new Set();
@@ -243451,10 +243609,21 @@ var ReolinkHub = class ReolinkHub extends BaseDevice {
 				const child = all.find((d) => d.id === deviceId);
 				if (!(child instanceof ReolinkCamera)) continue;
 				const cgi = info.entries[0];
+				const power = mapHubBatteryPower(cgi);
+				for (const { field, value } of power.unmapped) {
+					if (!this.unmappedBatteryCodes.firstSeen(deviceId, field, value)) continue;
+					this.ctx.logger.warn("Reolink Hub: unmapped battery power code — field dropped", {
+						tags: { deviceId },
+						meta: {
+							channel: Number(chKey),
+							field,
+							value
+						}
+					});
+				}
 				child.applyHubBatteryInfo({
 					batteryPercent: info.batteryLevel,
-					...mapHubChargeStatus(cgi?.["chargeStatus"]) !== void 0 ? { chargeStatus: mapHubChargeStatus(cgi?.["chargeStatus"]) } : {},
-					...mapHubAdapterStatus(cgi?.["adapterStatus"]) !== void 0 ? { adapterStatus: mapHubAdapterStatus(cgi?.["adapterStatus"]) } : {}
+					...power.fields
 				});
 			}
 		} catch (err) {
@@ -243895,18 +244064,6 @@ function discoveredStatusFor(d) {
 *   chargeStatus: 0 none · 1 charging · 2 charge complete
 *   adapterStatus: 0 none · 1 DC adapter · 2 solar panel
 */
-function mapHubChargeStatus(value) {
-	if (typeof value === "string") return value;
-	if (value === 0) return "none";
-	if (value === 1) return "charging";
-	if (value === 2) return "chargeComplete";
-}
-function mapHubAdapterStatus(value) {
-	if (typeof value === "string") return value;
-	if (value === 0) return "none";
-	if (value === 1) return "dc";
-	if (value === 2) return "solarPanel";
-}
 //#endregion
 //#region src/creation-schema.ts
 /**

package/package.json

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