@camstack/addon-provider-reolink 1.2.36 → 1.2.38

package/dist/addon.js

@@ -19675,6 +19675,39 @@ var snapshotCapability = {
 			etag: string().nullable()
 		}))),
 		/**
+		* The full decision chain for ONE device, for the viewer's debug readout —
+		* the answer to "why does this tile show what it shows" in a single poll:
+		* the battery slice the state was derived from, the resolved state + its
+		* reason, the cached frame's identity/age, whether a wake window is open,
+		* and whether a fresh capture is in flight. Cache-only and capture-free:
+		* a debug read must never wake a battery camera.
+		*/
+		getDebugState: systemMethod(object({ deviceId: number() }), object({
+			/** The battery slice as read, or null when the device has none. */
+			battery: object({
+				sleeping: boolean(),
+				lastUpdated: number(),
+				lastContactAt: number().optional()
+			}).nullable(),
+			/** The resolved snapshot state (what the overlay decision used). */
+			state: object({
+				isBattery: boolean(),
+				reason: _enum([
+					"disabled",
+					"sleeping",
+					"unreachable",
+					"waking"
+				]).nullable()
+			}),
+			/** The cached frame behind the next paint. */
+			frame: object({
+				capturedAt: number().nullable(),
+				ageMs: number().nullable()
+			}),
+			/** A wake window is currently open (the Waking overlay's source). */
+			waking: boolean()
+		})),
+		/**
 		* Signed, expiring links to a CLIENT-SIZED frame — and the demand signal
 		* that makes those frames current.
 		*
@@ -34676,6 +34709,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"snapshot.getDebugState": {
+		capName: "snapshot",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"snapshot.getSnapshot": {
 		capName: "snapshot",
 		capScope: "device",
@@ -37273,6 +37312,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"snapshot.getDebugState": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"snapshot.getSnapshot": [{
 		name: "deviceId",
 		form: "single",
@@ -231012,6 +231056,7 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 							durationMs: Date.now() - startedAt
 						};
 					}
+					if (confirmed && !observedAwake && parent !== null) this.watchHubChildAwake(parent).catch(() => {});
 					return {
 						awoke: true,
 						durationMs: Date.now() - startedAt
@@ -231190,6 +231235,29 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 		this.lastProactiveWakeAt = Date.now();
 	}
 	/**
+	* Post-confirm watch for a hub child whose wake lands on the consumer's
+	* relay dial: re-read the parent's channel summary a few times over the
+	* dial's wake window and commit `sleeping: false` the moment the firmware
+	* reports it. Ends EARLY once committed; bounded hard so a dead link can't
+	* leak a timer. Costs the camera nothing — the summary is the hub's own
+	* mains-powered read.
+	*/
+	async watchHubChildAwake(parent) {
+		const deadline = Date.now() + 45e3;
+		while (Date.now() < deadline) {
+			await sleep$1(5e3);
+			try {
+				if ((await (await parent.getApi()).getNvrChannelsSummary({ channels: [this.getChannel()] })).devices.find((d) => d.channel === this.getChannel())?.sleeping === false) {
+					if (this.commitSleepState(false, "hub-summary")) {
+						this.ctx.logger.info("battery wakeForStream: hub child observed awake after the dial", { tags: { deviceId: this.id } });
+						this.onWakeTransition("hub-summary").catch(() => {});
+					}
+					return;
+				}
+			} catch {}
+		}
+	}
+	/**
 	* Close the transient "waking" window on a wake that did NOT produce a
 	* committed transition (ACK with no awake evidence, or a timeout).
 	* `BatteryOnWakeStarted` opens it; normally the `sleeping: false` commit
@@ -236651,6 +236719,14 @@ function computeHealthCheckBackoffMs(consecutive) {
 //#endregion
 //#region src/reolink-hub.ts
 var HUB_DISCOVERY_REFRESH_TIMEOUT_MS = 8e3;
+/**
+* How often the hub re-reads its own channels summary to reconcile the
+* adopted children's sleep slices. 60 s: a naturally-waking camera (PIR,
+* schedule) is caught within a minute, and the play path has its own
+* faster confirm + post-dial watch, so this only ever carries background
+* drift. Never wakes a child — the summary is answered by the hub itself.
+*/
+var HUB_CHILD_SLEEP_RECONCILE_MS = 6e4;
 var HUB_RECONNECT_BASE_MS = 2e3;
 var HUB_RECONNECT_MAX_MS = 3e4;
 /**
@@ -236684,6 +236760,8 @@ var ReolinkHub = class ReolinkHub extends BaseDevice {
 	connectInFlight = null;
 	reconnectAttempts = 0;
 	reconnectTimer = null;
+	/** Periodic child-sleep reconcile timer (armed in `onActivate`). */
+	sleepReconcileTimer = null;
 	shutdownRequested = false;
 	/** Diagnostic Sessions snapshot — same shape as the camera's. */
 	sessionsSnapshot = null;
@@ -236768,6 +236846,10 @@ var ReolinkHub = class ReolinkHub extends BaseDevice {
 			this.ctx.logger.info("Reolink Hub: child unregistered externally — refreshing discovery", cid !== null ? { tags: { deviceId: cid } } : {});
 			this.refreshDiscoveryFromCamera().catch(() => {});
 		}));
+		this.sleepReconcileTimer = setInterval(() => {
+			this.refreshDiscoveryFromCamera().catch(() => {});
+		}, HUB_CHILD_SLEEP_RECONCILE_MS);
+		if (typeof this.sleepReconcileTimer.unref === "function") this.sleepReconcileTimer.unref();
 	}
 	eventUnsubscribers = [];
 	/** Per-channel throttle for the unrouted-event warning (see
@@ -236779,6 +236861,10 @@ var ReolinkHub = class ReolinkHub extends BaseDevice {
 			clearTimeout(this.reconnectTimer);
 			this.reconnectTimer = null;
 		}
+		if (this.sleepReconcileTimer) {
+			clearInterval(this.sleepReconcileTimer);
+			this.sleepReconcileTimer = null;
+		}
 		for (const unsub of this.eventUnsubscribers) try {
 			unsub();
 		} catch {}

package/dist/addon.mjs

@@ -19670,6 +19670,39 @@ var snapshotCapability = {
 			etag: string().nullable()
 		}))),
 		/**
+		* The full decision chain for ONE device, for the viewer's debug readout —
+		* the answer to "why does this tile show what it shows" in a single poll:
+		* the battery slice the state was derived from, the resolved state + its
+		* reason, the cached frame's identity/age, whether a wake window is open,
+		* and whether a fresh capture is in flight. Cache-only and capture-free:
+		* a debug read must never wake a battery camera.
+		*/
+		getDebugState: systemMethod(object({ deviceId: number() }), object({
+			/** The battery slice as read, or null when the device has none. */
+			battery: object({
+				sleeping: boolean(),
+				lastUpdated: number(),
+				lastContactAt: number().optional()
+			}).nullable(),
+			/** The resolved snapshot state (what the overlay decision used). */
+			state: object({
+				isBattery: boolean(),
+				reason: _enum([
+					"disabled",
+					"sleeping",
+					"unreachable",
+					"waking"
+				]).nullable()
+			}),
+			/** The cached frame behind the next paint. */
+			frame: object({
+				capturedAt: number().nullable(),
+				ageMs: number().nullable()
+			}),
+			/** A wake window is currently open (the Waking overlay's source). */
+			waking: boolean()
+		})),
+		/**
 		* Signed, expiring links to a CLIENT-SIZED frame — and the demand signal
 		* that makes those frames current.
 		*
@@ -34671,6 +34704,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"snapshot.getDebugState": {
+		capName: "snapshot",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"snapshot.getSnapshot": {
 		capName: "snapshot",
 		capScope: "device",
@@ -37268,6 +37307,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"snapshot.getDebugState": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"snapshot.getSnapshot": [{
 		name: "deviceId",
 		form: "single",
@@ -230992,6 +231036,7 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 							durationMs: Date.now() - startedAt
 						};
 					}
+					if (confirmed && !observedAwake && parent !== null) this.watchHubChildAwake(parent).catch(() => {});
 					return {
 						awoke: true,
 						durationMs: Date.now() - startedAt
@@ -231170,6 +231215,29 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 		this.lastProactiveWakeAt = Date.now();
 	}
 	/**
+	* Post-confirm watch for a hub child whose wake lands on the consumer's
+	* relay dial: re-read the parent's channel summary a few times over the
+	* dial's wake window and commit `sleeping: false` the moment the firmware
+	* reports it. Ends EARLY once committed; bounded hard so a dead link can't
+	* leak a timer. Costs the camera nothing — the summary is the hub's own
+	* mains-powered read.
+	*/
+	async watchHubChildAwake(parent) {
+		const deadline = Date.now() + 45e3;
+		while (Date.now() < deadline) {
+			await sleep$1(5e3);
+			try {
+				if ((await (await parent.getApi()).getNvrChannelsSummary({ channels: [this.getChannel()] })).devices.find((d) => d.channel === this.getChannel())?.sleeping === false) {
+					if (this.commitSleepState(false, "hub-summary")) {
+						this.ctx.logger.info("battery wakeForStream: hub child observed awake after the dial", { tags: { deviceId: this.id } });
+						this.onWakeTransition("hub-summary").catch(() => {});
+					}
+					return;
+				}
+			} catch {}
+		}
+	}
+	/**
 	* Close the transient "waking" window on a wake that did NOT produce a
 	* committed transition (ACK with no awake evidence, or a timeout).
 	* `BatteryOnWakeStarted` opens it; normally the `sleeping: false` commit
@@ -236631,6 +236699,14 @@ function computeHealthCheckBackoffMs(consecutive) {
 //#endregion
 //#region src/reolink-hub.ts
 var HUB_DISCOVERY_REFRESH_TIMEOUT_MS = 8e3;
+/**
+* How often the hub re-reads its own channels summary to reconcile the
+* adopted children's sleep slices. 60 s: a naturally-waking camera (PIR,
+* schedule) is caught within a minute, and the play path has its own
+* faster confirm + post-dial watch, so this only ever carries background
+* drift. Never wakes a child — the summary is answered by the hub itself.
+*/
+var HUB_CHILD_SLEEP_RECONCILE_MS = 6e4;
 var HUB_RECONNECT_BASE_MS = 2e3;
 var HUB_RECONNECT_MAX_MS = 3e4;
 /**
@@ -236664,6 +236740,8 @@ var ReolinkHub = class ReolinkHub extends BaseDevice {
 	connectInFlight = null;
 	reconnectAttempts = 0;
 	reconnectTimer = null;
+	/** Periodic child-sleep reconcile timer (armed in `onActivate`). */
+	sleepReconcileTimer = null;
 	shutdownRequested = false;
 	/** Diagnostic Sessions snapshot — same shape as the camera's. */
 	sessionsSnapshot = null;
@@ -236748,6 +236826,10 @@ var ReolinkHub = class ReolinkHub extends BaseDevice {
 			this.ctx.logger.info("Reolink Hub: child unregistered externally — refreshing discovery", cid !== null ? { tags: { deviceId: cid } } : {});
 			this.refreshDiscoveryFromCamera().catch(() => {});
 		}));
+		this.sleepReconcileTimer = setInterval(() => {
+			this.refreshDiscoveryFromCamera().catch(() => {});
+		}, HUB_CHILD_SLEEP_RECONCILE_MS);
+		if (typeof this.sleepReconcileTimer.unref === "function") this.sleepReconcileTimer.unref();
 	}
 	eventUnsubscribers = [];
 	/** Per-channel throttle for the unrouted-event warning (see
@@ -236759,6 +236841,10 @@ var ReolinkHub = class ReolinkHub extends BaseDevice {
 			clearTimeout(this.reconnectTimer);
 			this.reconnectTimer = null;
 		}
+		if (this.sleepReconcileTimer) {
+			clearInterval(this.sleepReconcileTimer);
+			this.sleepReconcileTimer = null;
+		}
 		for (const unsub of this.eventUnsubscribers) try {
 			unsub();
 		} catch {}

package/package.json

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