@camstack/addon-provider-reolink 1.2.200 → 1.2.202

package/dist/addon.js

@@ -36,7 +36,7 @@ let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os, 1);
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs, 1);
-//#region ../types/dist/event-category-DOl51-Ij.mjs
+//#region ../types/dist/event-category-7pZEBmVg.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -724,6 +724,14 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["BackupRestored"] = "backup.restored";
 	EventCategory["NotificationDispatched"] = "notification.dispatched";
 	EventCategory["NotificationFailed"] = "notification.failed";
+	/**
+	* A notification rule that cannot work (D905): its stored row does not load,
+	* or it still names a device / delivery target the prune CONFIRMED deleted.
+	* One edge per rule per distinct set of reasons; never on an unanswered read.
+	*/
+	EventCategory["NotificationRuleBroken"] = "notification.rule-broken";
+	/** The clear of {@link NotificationRuleBroken}: the rule loads and names nothing deleted. */
+	EventCategory["NotificationRuleRepaired"] = "notification.rule-repaired";
 	EventCategory["DeviceUpdated"] = "device.updated";
 	/**
 	* Transport-level connectivity. Emitted by the device driver when
@@ -5451,7 +5459,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-_sV1BE2f.mjs
+//#region ../types/dist/sleep-CueztlR1.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -7735,7 +7743,7 @@ function stringProp(value, key) {
 	return typeof found === "string" ? found : void 0;
 }
 /** The code an error carries: its own, its cause's, or a tRPC `data.code`. */
-function errorCode(err) {
+function errorCode$1(err) {
 	const out = {};
 	const cause = typeof err === "object" && err !== null ? Reflect.get(err, "cause") : void 0;
 	const data = typeof err === "object" && err !== null ? Reflect.get(err, "data") : void 0;
@@ -7755,7 +7763,7 @@ function errorCode(err) {
 function classifyStoreError(err) {
 	const message = err instanceof Error ? err.message : String(err);
 	if (RESTART_FINGERPRINTS.some((f) => message.includes(f))) return "restart";
-	const code = errorCode(err);
+	const code = errorCode$1(err);
 	if (code.node !== void 0 && TRANSPORT_CODES.has(code.node)) return "transport";
 	if (code.trpc !== void 0 && UNAVAILABLE_TRPC_CODES.has(code.trpc)) return "transport";
 	if (typeof err === "object" && err !== null) {
@@ -43183,6 +43191,8 @@ var NcSystemEventKindSchema = _enum([
 	"alert-critical",
 	"alert-error",
 	"alert-critical-resolved",
+	"rule-broken",
+	"rule-repaired",
 	"camera-online",
 	"camera-offline",
 	"camera-disabled",
@@ -80718,6 +80728,8 @@ new Map(Object.entries({
 	"alert-critical": "system",
 	"alert-error": "system",
 	"alert-critical-resolved": "system",
+	"rule-broken": "system",
+	"rule-repaired": "system",
 	"storage-location-low": "system",
 	"storage-location-critical": "system",
 	"storage-location-ok": "system",
@@ -80852,6 +80864,12 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 			"alert-critical-resolved"
 		]
 	},
+	{
+		id: "rule-health",
+		family: "system",
+		label: "Notification rules",
+		kinds: ["rule-broken", "rule-repaired"]
+	},
 	{
 		id: "alarm",
 		family: "alarm",
@@ -81129,6 +81147,10 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
+	[...RULE_TEXT],
+	[...RULE_TEXT],
+	[...RULE_TEXT],
+	[...RULE_TEXT],
 	([...RULE_TEXT], [...UPDATES]),
 	([...RULE_TEXT], [...PACKAGE_UPDATES]),
 	([...RULE_TEXT], [...PACKAGE_UPDATES]),
@@ -81167,6 +81189,107 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_TEXT],
 	...STATE_SUMMARY_VARS
 ];
+new Map([
+	{
+		id: "device-connectivity",
+		family: "device-events",
+		label: "Device connectivity (offline / back online)",
+		bad: ["device-offline"],
+		recovery: ["device-online"],
+		snapshotLabel: "Devices offline now",
+		snapshotSection: "device-state"
+	},
+	{
+		id: "device-switch",
+		family: "device-events",
+		label: "Device switched off / back on",
+		bad: ["device-disabled"],
+		recovery: ["device-enabled"],
+		snapshotLabel: "Devices switched off now",
+		snapshotSection: "device-state"
+	},
+	{
+		id: "stream-connectivity",
+		family: "device-events",
+		label: "Stream connectivity (offline / back online)",
+		bad: ["stream-offline"],
+		recovery: ["stream-online"],
+		snapshotLabel: "Streams offline now",
+		snapshotSection: "streams"
+	},
+	{
+		id: "battery",
+		family: "device-events",
+		label: "Battery (low / back to normal)",
+		bad: ["device-battery-low"],
+		recovery: ["device-battery-normal"],
+		snapshotLabel: "Batteries low now",
+		snapshotSection: "battery"
+	},
+	{
+		id: "consumables",
+		family: "device-events",
+		label: "Consumables (low / replaced)",
+		bad: ["device-consumable-low"],
+		recovery: ["device-consumable-normal"],
+		snapshotLabel: "Consumables low now",
+		snapshotSection: "consumables"
+	},
+	{
+		id: "tanks",
+		family: "device-events",
+		label: "Tanks (low or full / back to normal)",
+		bad: ["device-tank-low", "device-tank-full"],
+		recovery: ["device-tank-normal"],
+		snapshotLabel: "Tanks low or full now",
+		snapshotSection: "tanks"
+	},
+	{
+		id: "recording-health",
+		family: "device-events",
+		label: "Recording health (stalled or degraded / recording again)",
+		bad: ["recording-stalled", "recording-degraded"],
+		recovery: ["recording-healthy"],
+		snapshotLabel: "Recordings stalled now",
+		snapshotSection: null
+	},
+	{
+		id: "node-connectivity",
+		family: "system",
+		label: "Node connectivity (offline / back online)",
+		bad: ["node-offline"],
+		recovery: ["node-online"],
+		snapshotLabel: "Nodes offline now",
+		snapshotSection: "nodes"
+	},
+	{
+		id: "storage-space",
+		family: "system",
+		label: "Storage space (low or critical / ok again)",
+		bad: ["storage-location-low", "storage-location-critical"],
+		recovery: ["storage-location-ok"],
+		snapshotLabel: "Storage locations low now",
+		snapshotSection: null
+	},
+	{
+		id: "critical-alerts",
+		family: "system",
+		label: "Critical alerts (raised / resolved)",
+		bad: ["alert-critical"],
+		recovery: ["alert-critical-resolved"],
+		snapshotLabel: "Critical alerts open now",
+		snapshotSection: null
+	},
+	{
+		id: "rule-health",
+		family: "system",
+		label: "Rule health (broken / repaired)",
+		bad: ["rule-broken"],
+		recovery: ["rule-repaired"],
+		snapshotLabel: "Notification rules broken now",
+		snapshotSection: null
+	}
+].flatMap((spec) => [...spec.bad, ...spec.recovery].map((kind) => [kind, spec])));
 new Set([
 	"disarmed",
 	"armed_home",
@@ -193472,6 +193595,137 @@ function motionSensorOnSimpleEvent(event) {
 	if (typeof motion !== "object" || motion === null || !("source" in motion)) return null;
 	return isMotionSensor(motion.source) ? motion.source : null;
 }
+var CONNECTIVITY_CODES = new Set([
+	"EHOSTUNREACH",
+	"EHOSTDOWN",
+	"ENETUNREACH",
+	"ENETDOWN",
+	"ECONNREFUSED",
+	"ECONNRESET",
+	"ETIMEDOUT",
+	"EADDRNOTAVAIL",
+	"EPIPE"
+]);
+var CONNECTIVITY_TEXT = /EHOSTUNREACH|EHOSTDOWN|ENETUNREACH|ENETDOWN|ECONNREFUSED|ECONNRESET|ETIMEDOUT|EADDRNOTAVAIL|EPIPE|timed? ?out|socket hang up|socket closed|not connected/i;
+function errorCode(err) {
+	if (typeof err !== "object" || err === null || !("code" in err)) return null;
+	const code = err.code;
+	return typeof code === "string" ? code : null;
+}
+/**
+* Did this failure say the camera could not be REACHED? An answer that came
+* back (wrong password, a rejected command) proves the camera is there, and is
+* not a reason to call it offline.
+*/
+function isConnectivityFailure(err) {
+	const code = errorCode(err);
+	if (code !== null && CONNECTIVITY_CODES.has(code)) return true;
+	const text = err instanceof Error ? err.message : String(err);
+	return CONNECTIVITY_TEXT.test(text);
+}
+var ReachabilityOfflineTracker = class {
+	deps;
+	stateValue = "reachable";
+	since = 0;
+	failures = 0;
+	lastReason = "";
+	offlineAt = 0;
+	timer = null;
+	probing = false;
+	disposed = false;
+	windowMs;
+	recoveryProbeMs;
+	constructor(deps) {
+		this.deps = deps;
+		this.windowMs = deps.windowMs ?? 12e4;
+		this.recoveryProbeMs = deps.recoveryProbeMs ?? 3e4;
+	}
+	get state() {
+		return this.stateValue;
+	}
+	/** The camera could not be reached (socket lost, a login refused at the network level). */
+	noteFailure(reason) {
+		if (this.disposed) return;
+		this.failures += 1;
+		this.lastReason = reason;
+		if (this.stateValue !== "reachable") return;
+		this.stateValue = "failing";
+		this.since = Date.now();
+		this.arm(this.windowMs, () => this.confirm());
+	}
+	/** The camera answered (a login, a stream). Closes a window; ends an outage once. */
+	noteReachable() {
+		if (this.disposed) return;
+		const wasOffline = this.stateValue === "offline";
+		const offlineForMs = Date.now() - this.offlineAt;
+		this.clear();
+		if (wasOffline) this.deps.onOnline({ offlineForMs });
+	}
+	/** The firmware said what the camera is (a push): forget our own verdict, emit nothing. */
+	reset() {
+		this.clear();
+	}
+	dispose() {
+		this.disposed = true;
+		this.clear();
+	}
+	clear() {
+		if (this.timer !== null) clearTimeout(this.timer);
+		this.timer = null;
+		this.stateValue = "reachable";
+		this.failures = 0;
+		this.lastReason = "";
+	}
+	arm(ms, fire) {
+		if (this.timer !== null) clearTimeout(this.timer);
+		this.timer = setTimeout(() => {
+			this.timer = null;
+			fire();
+		}, ms);
+		if (typeof this.timer.unref === "function") this.timer.unref();
+	}
+	/** End of the window: one fresh probe must agree before the camera is called offline. */
+	confirm() {
+		this.runProbe((result) => {
+			if (this.stateValue !== "failing") return;
+			if (result === "reachable") {
+				this.noteReachable();
+				return;
+			}
+			this.stateValue = "offline";
+			this.offlineAt = Date.now();
+			this.deps.onOffline({
+				since: this.since,
+				failures: this.failures,
+				lastReason: this.lastReason
+			});
+			this.arm(this.recoveryProbeMs, () => this.recover());
+		});
+	}
+	recover() {
+		this.runProbe((result) => {
+			if (this.stateValue !== "offline") return;
+			if (result === "reachable") {
+				this.noteReachable();
+				return;
+			}
+			this.arm(this.recoveryProbeMs, () => this.recover());
+		});
+	}
+	async runProbe(then) {
+		if (this.probing || this.disposed) return;
+		this.probing = true;
+		let result;
+		try {
+			result = await this.deps.probe();
+		} catch {
+			result = "unreachable";
+		} finally {
+			this.probing = false;
+		}
+		if (!this.disposed) then(result);
+	}
+};
 //#endregion
 //#region src/reolink-camera.ts
 /**
@@ -193862,6 +194116,17 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 	/** Pending reconnect timer; cleared on successful reconnect or removeDevice. */
 	reconnectTimer = null;
 	/**
+	* D904: offline from SUSTAINED unreachability on a mains camera that owns its
+	* socket. Fed by socket loss and network-level login failures; its verdicts
+	* are the normal DeviceOffline / DeviceOnline. Never fed for a battery camera
+	* (asleep is not gone, D173) nor for a hub child (the Hub owns that socket).
+	*/
+	reachability = new ReachabilityOfflineTracker({
+		probe: () => this.probeReachability(),
+		onOffline: (info) => this.onReachabilityOffline(info),
+		onOnline: (info) => this.onReachabilityOnline(info)
+	});
+	/**
 	* Read-through to the `battery.sleeping` runtime-state slice with
 	* a `false` default for non-battery cams (no slice). Internal
 	* shorthand — driver code uses `this.state.battery.sleeping = b` to write
@@ -198617,6 +198882,7 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 			clearTimeout(this.reconnectTimer);
 			this.reconnectTimer = null;
 		}
+		this.reachability.dispose();
 		this.ctx.logger.info("Removing Reolink camera", { meta: { stableId: this.stableId } });
 		const ids = [...this.publishedStreamIds];
 		await Promise.all(ids.map((id) => this.ctx.api.streamBroker.retractCameraStream.mutate({
@@ -201036,11 +201302,14 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 				await api.login();
 			} catch (err) {
 				this.loginPromise = null;
+				if (isConnectivityFailure(err)) this.noteUnreachable(err instanceof Error ? err.message : String(err));
+				else if (this.ownsReachability()) this.reachability.noteReachable();
 				throw err;
 			}
 			this.api = api;
 			this.loginPromise = null;
 			this.reconnectAttempts = 0;
+			if (this.ownsReachability()) this.reachability.noteReachable();
 			const persistedDeviceType = this.config.get("deviceCache")?.deviceType;
 			if (persistedDeviceType === "battery-cam") {
 				this.isBattery = true;
@@ -201103,8 +201372,10 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 	* - 'awake' / 'sleeping': emit DeviceAwake / DeviceSleeping. Battery
 	*   power-state only — does NOT touch online state.
 	* - 'online' / 'offline': emit DeviceOnline / DeviceOffline + flip
-	*   `this.online`. The ONLY emit site for these — socket close,
-	*   reconnect, RFC4571 idle teardown all leave online state alone.
+	*   `this.online`, and reset the reachability verdict. The only OTHER
+	*   source is sustained unreachability on a mains camera (D904,
+	*   `onReachabilityOffline`): a single socket close, a reconnect or an
+	*   RFC4571 idle teardown still leaves online state alone.
 	* - 'battery': refresh cache, emit cap event.
 	* - 'doorbell', 'daynight', 'other': informational debug log only.
 	*/
@@ -201215,6 +201486,7 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 		}
 		if (event.type === "online" || event.type === "offline") {
 			const next = event.type === "online";
+			this.reachability.reset();
 			if (next !== this.online) {
 				this.markOnline(next);
 				this.ctx.eventBus.emit(createEvent(next ? EventCategory.DeviceOnline : EventCategory.DeviceOffline, eventSource, next ? {
@@ -201425,6 +201697,67 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 			await current.close({ reason });
 		} catch {}
 	}
+	/** D904 applies to a mains camera that dials its own socket — not a battery cam, not a hub child. */
+	ownsReachability() {
+		return !this.isBattery && !this.isHubChild();
+	}
+	/** The camera could not be reached: open (or extend) the reachability window. */
+	noteUnreachable(reason) {
+		if (!this.ownsReachability()) return;
+		this.reachability.noteFailure(reason);
+	}
+	/**
+	* One fresh login, for the tracker's confirmation and recovery probes. A
+	* battery cam or hub child is never probed (D173) and answers `reachable`,
+	* which closes the window instead of calling it offline.
+	*/
+	async probeReachability() {
+		if (!this.ownsReachability()) return "reachable";
+		try {
+			await this.ensureApi();
+			return "reachable";
+		} catch (err) {
+			return isConnectivityFailure(err) ? "unreachable" : "reachable";
+		}
+	}
+	/** Sustained unreachability, confirmed: the normal DeviceOffline, once. */
+	onReachabilityOffline(info) {
+		if (!this.online) {
+			this.ctx.logger.info("Reolink camera unreachable, already offline — nothing to emit", {
+				tags: { deviceId: this.id },
+				meta: { ...info }
+			});
+			return;
+		}
+		this.ctx.logger.warn("Reolink camera unreachable for the whole window — marked offline", {
+			tags: { deviceId: this.id },
+			meta: {
+				...info,
+				unreachableForMs: Date.now() - info.since
+			}
+		});
+		this.markOnline(false);
+		this.ctx.eventBus.emit(createEvent(EventCategory.DeviceOffline, this.eventSource(), {
+			deviceId: this.id,
+			providerId: REOLINK_ADDON_ID,
+			reason: "unreachable"
+		}));
+	}
+	/** The first success after a reachability outage: the normal DeviceOnline, once. */
+	onReachabilityOnline(info) {
+		if (this.online) return;
+		this.ctx.logger.info("Reolink camera reachable again — marked online", {
+			tags: { deviceId: this.id },
+			meta: { ...info }
+		});
+		this.markOnline(true);
+		this.ctx.eventBus.emit(createEvent(EventCategory.DeviceOnline, this.eventSource(), {
+			deviceId: this.id,
+			providerId: REOLINK_ADDON_ID,
+			profileCount: 0,
+			reason: "reachable-again"
+		}));
+	}
 	scheduleReconnect(reason) {
 		if (this.reconnectTimer) return;
 		if (this.isBattery) {
@@ -201438,6 +201771,7 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 			});
 			return;
 		}
+		this.noteUnreachable(reason);
 		const attempt = ++this.reconnectAttempts;
 		const backoffMs = Math.min(3e4, 1e3 * 2 ** Math.min(attempt - 1, 5));
 		this.ctx.logger.info("Baichuan reconnect scheduled", {

package/dist/addon.mjs

@@ -28,7 +28,7 @@ import { URL as URL$1 } from "url";
 import { spawn as spawn$1 } from "node:child_process";
 import os, { tmpdir } from "node:os";
 import { createReadStream } from "node:fs";
-//#region ../types/dist/event-category-DOl51-Ij.mjs
+//#region ../types/dist/event-category-7pZEBmVg.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -716,6 +716,14 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["BackupRestored"] = "backup.restored";
 	EventCategory["NotificationDispatched"] = "notification.dispatched";
 	EventCategory["NotificationFailed"] = "notification.failed";
+	/**
+	* A notification rule that cannot work (D905): its stored row does not load,
+	* or it still names a device / delivery target the prune CONFIRMED deleted.
+	* One edge per rule per distinct set of reasons; never on an unanswered read.
+	*/
+	EventCategory["NotificationRuleBroken"] = "notification.rule-broken";
+	/** The clear of {@link NotificationRuleBroken}: the rule loads and names nothing deleted. */
+	EventCategory["NotificationRuleRepaired"] = "notification.rule-repaired";
 	EventCategory["DeviceUpdated"] = "device.updated";
 	/**
 	* Transport-level connectivity. Emitted by the device driver when
@@ -5443,7 +5451,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-_sV1BE2f.mjs
+//#region ../types/dist/sleep-CueztlR1.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -7727,7 +7735,7 @@ function stringProp(value, key) {
 	return typeof found === "string" ? found : void 0;
 }
 /** The code an error carries: its own, its cause's, or a tRPC `data.code`. */
-function errorCode(err) {
+function errorCode$1(err) {
 	const out = {};
 	const cause = typeof err === "object" && err !== null ? Reflect.get(err, "cause") : void 0;
 	const data = typeof err === "object" && err !== null ? Reflect.get(err, "data") : void 0;
@@ -7747,7 +7755,7 @@ function errorCode(err) {
 function classifyStoreError(err) {
 	const message = err instanceof Error ? err.message : String(err);
 	if (RESTART_FINGERPRINTS.some((f) => message.includes(f))) return "restart";
-	const code = errorCode(err);
+	const code = errorCode$1(err);
 	if (code.node !== void 0 && TRANSPORT_CODES.has(code.node)) return "transport";
 	if (code.trpc !== void 0 && UNAVAILABLE_TRPC_CODES.has(code.trpc)) return "transport";
 	if (typeof err === "object" && err !== null) {
@@ -43175,6 +43183,8 @@ var NcSystemEventKindSchema = _enum([
 	"alert-critical",
 	"alert-error",
 	"alert-critical-resolved",
+	"rule-broken",
+	"rule-repaired",
 	"camera-online",
 	"camera-offline",
 	"camera-disabled",
@@ -80710,6 +80720,8 @@ new Map(Object.entries({
 	"alert-critical": "system",
 	"alert-error": "system",
 	"alert-critical-resolved": "system",
+	"rule-broken": "system",
+	"rule-repaired": "system",
 	"storage-location-low": "system",
 	"storage-location-critical": "system",
 	"storage-location-ok": "system",
@@ -80844,6 +80856,12 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 			"alert-critical-resolved"
 		]
 	},
+	{
+		id: "rule-health",
+		family: "system",
+		label: "Notification rules",
+		kinds: ["rule-broken", "rule-repaired"]
+	},
 	{
 		id: "alarm",
 		family: "alarm",
@@ -81121,6 +81139,10 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
+	[...RULE_TEXT],
+	[...RULE_TEXT],
+	[...RULE_TEXT],
+	[...RULE_TEXT],
 	([...RULE_TEXT], [...UPDATES]),
 	([...RULE_TEXT], [...PACKAGE_UPDATES]),
 	([...RULE_TEXT], [...PACKAGE_UPDATES]),
@@ -81159,6 +81181,107 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_TEXT],
 	...STATE_SUMMARY_VARS
 ];
+new Map([
+	{
+		id: "device-connectivity",
+		family: "device-events",
+		label: "Device connectivity (offline / back online)",
+		bad: ["device-offline"],
+		recovery: ["device-online"],
+		snapshotLabel: "Devices offline now",
+		snapshotSection: "device-state"
+	},
+	{
+		id: "device-switch",
+		family: "device-events",
+		label: "Device switched off / back on",
+		bad: ["device-disabled"],
+		recovery: ["device-enabled"],
+		snapshotLabel: "Devices switched off now",
+		snapshotSection: "device-state"
+	},
+	{
+		id: "stream-connectivity",
+		family: "device-events",
+		label: "Stream connectivity (offline / back online)",
+		bad: ["stream-offline"],
+		recovery: ["stream-online"],
+		snapshotLabel: "Streams offline now",
+		snapshotSection: "streams"
+	},
+	{
+		id: "battery",
+		family: "device-events",
+		label: "Battery (low / back to normal)",
+		bad: ["device-battery-low"],
+		recovery: ["device-battery-normal"],
+		snapshotLabel: "Batteries low now",
+		snapshotSection: "battery"
+	},
+	{
+		id: "consumables",
+		family: "device-events",
+		label: "Consumables (low / replaced)",
+		bad: ["device-consumable-low"],
+		recovery: ["device-consumable-normal"],
+		snapshotLabel: "Consumables low now",
+		snapshotSection: "consumables"
+	},
+	{
+		id: "tanks",
+		family: "device-events",
+		label: "Tanks (low or full / back to normal)",
+		bad: ["device-tank-low", "device-tank-full"],
+		recovery: ["device-tank-normal"],
+		snapshotLabel: "Tanks low or full now",
+		snapshotSection: "tanks"
+	},
+	{
+		id: "recording-health",
+		family: "device-events",
+		label: "Recording health (stalled or degraded / recording again)",
+		bad: ["recording-stalled", "recording-degraded"],
+		recovery: ["recording-healthy"],
+		snapshotLabel: "Recordings stalled now",
+		snapshotSection: null
+	},
+	{
+		id: "node-connectivity",
+		family: "system",
+		label: "Node connectivity (offline / back online)",
+		bad: ["node-offline"],
+		recovery: ["node-online"],
+		snapshotLabel: "Nodes offline now",
+		snapshotSection: "nodes"
+	},
+	{
+		id: "storage-space",
+		family: "system",
+		label: "Storage space (low or critical / ok again)",
+		bad: ["storage-location-low", "storage-location-critical"],
+		recovery: ["storage-location-ok"],
+		snapshotLabel: "Storage locations low now",
+		snapshotSection: null
+	},
+	{
+		id: "critical-alerts",
+		family: "system",
+		label: "Critical alerts (raised / resolved)",
+		bad: ["alert-critical"],
+		recovery: ["alert-critical-resolved"],
+		snapshotLabel: "Critical alerts open now",
+		snapshotSection: null
+	},
+	{
+		id: "rule-health",
+		family: "system",
+		label: "Rule health (broken / repaired)",
+		bad: ["rule-broken"],
+		recovery: ["rule-repaired"],
+		snapshotLabel: "Notification rules broken now",
+		snapshotSection: null
+	}
+].flatMap((spec) => [...spec.bad, ...spec.recovery].map((kind) => [kind, spec])));
 new Set([
 	"disarmed",
 	"armed_home",
@@ -193464,6 +193587,137 @@ function motionSensorOnSimpleEvent(event) {
 	if (typeof motion !== "object" || motion === null || !("source" in motion)) return null;
 	return isMotionSensor(motion.source) ? motion.source : null;
 }
+var CONNECTIVITY_CODES = new Set([
+	"EHOSTUNREACH",
+	"EHOSTDOWN",
+	"ENETUNREACH",
+	"ENETDOWN",
+	"ECONNREFUSED",
+	"ECONNRESET",
+	"ETIMEDOUT",
+	"EADDRNOTAVAIL",
+	"EPIPE"
+]);
+var CONNECTIVITY_TEXT = /EHOSTUNREACH|EHOSTDOWN|ENETUNREACH|ENETDOWN|ECONNREFUSED|ECONNRESET|ETIMEDOUT|EADDRNOTAVAIL|EPIPE|timed? ?out|socket hang up|socket closed|not connected/i;
+function errorCode(err) {
+	if (typeof err !== "object" || err === null || !("code" in err)) return null;
+	const code = err.code;
+	return typeof code === "string" ? code : null;
+}
+/**
+* Did this failure say the camera could not be REACHED? An answer that came
+* back (wrong password, a rejected command) proves the camera is there, and is
+* not a reason to call it offline.
+*/
+function isConnectivityFailure(err) {
+	const code = errorCode(err);
+	if (code !== null && CONNECTIVITY_CODES.has(code)) return true;
+	const text = err instanceof Error ? err.message : String(err);
+	return CONNECTIVITY_TEXT.test(text);
+}
+var ReachabilityOfflineTracker = class {
+	deps;
+	stateValue = "reachable";
+	since = 0;
+	failures = 0;
+	lastReason = "";
+	offlineAt = 0;
+	timer = null;
+	probing = false;
+	disposed = false;
+	windowMs;
+	recoveryProbeMs;
+	constructor(deps) {
+		this.deps = deps;
+		this.windowMs = deps.windowMs ?? 12e4;
+		this.recoveryProbeMs = deps.recoveryProbeMs ?? 3e4;
+	}
+	get state() {
+		return this.stateValue;
+	}
+	/** The camera could not be reached (socket lost, a login refused at the network level). */
+	noteFailure(reason) {
+		if (this.disposed) return;
+		this.failures += 1;
+		this.lastReason = reason;
+		if (this.stateValue !== "reachable") return;
+		this.stateValue = "failing";
+		this.since = Date.now();
+		this.arm(this.windowMs, () => this.confirm());
+	}
+	/** The camera answered (a login, a stream). Closes a window; ends an outage once. */
+	noteReachable() {
+		if (this.disposed) return;
+		const wasOffline = this.stateValue === "offline";
+		const offlineForMs = Date.now() - this.offlineAt;
+		this.clear();
+		if (wasOffline) this.deps.onOnline({ offlineForMs });
+	}
+	/** The firmware said what the camera is (a push): forget our own verdict, emit nothing. */
+	reset() {
+		this.clear();
+	}
+	dispose() {
+		this.disposed = true;
+		this.clear();
+	}
+	clear() {
+		if (this.timer !== null) clearTimeout(this.timer);
+		this.timer = null;
+		this.stateValue = "reachable";
+		this.failures = 0;
+		this.lastReason = "";
+	}
+	arm(ms, fire) {
+		if (this.timer !== null) clearTimeout(this.timer);
+		this.timer = setTimeout(() => {
+			this.timer = null;
+			fire();
+		}, ms);
+		if (typeof this.timer.unref === "function") this.timer.unref();
+	}
+	/** End of the window: one fresh probe must agree before the camera is called offline. */
+	confirm() {
+		this.runProbe((result) => {
+			if (this.stateValue !== "failing") return;
+			if (result === "reachable") {
+				this.noteReachable();
+				return;
+			}
+			this.stateValue = "offline";
+			this.offlineAt = Date.now();
+			this.deps.onOffline({
+				since: this.since,
+				failures: this.failures,
+				lastReason: this.lastReason
+			});
+			this.arm(this.recoveryProbeMs, () => this.recover());
+		});
+	}
+	recover() {
+		this.runProbe((result) => {
+			if (this.stateValue !== "offline") return;
+			if (result === "reachable") {
+				this.noteReachable();
+				return;
+			}
+			this.arm(this.recoveryProbeMs, () => this.recover());
+		});
+	}
+	async runProbe(then) {
+		if (this.probing || this.disposed) return;
+		this.probing = true;
+		let result;
+		try {
+			result = await this.deps.probe();
+		} catch {
+			result = "unreachable";
+		} finally {
+			this.probing = false;
+		}
+		if (!this.disposed) then(result);
+	}
+};
 //#endregion
 //#region src/reolink-camera.ts
 /**
@@ -193854,6 +194108,17 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 	/** Pending reconnect timer; cleared on successful reconnect or removeDevice. */
 	reconnectTimer = null;
 	/**
+	* D904: offline from SUSTAINED unreachability on a mains camera that owns its
+	* socket. Fed by socket loss and network-level login failures; its verdicts
+	* are the normal DeviceOffline / DeviceOnline. Never fed for a battery camera
+	* (asleep is not gone, D173) nor for a hub child (the Hub owns that socket).
+	*/
+	reachability = new ReachabilityOfflineTracker({
+		probe: () => this.probeReachability(),
+		onOffline: (info) => this.onReachabilityOffline(info),
+		onOnline: (info) => this.onReachabilityOnline(info)
+	});
+	/**
 	* Read-through to the `battery.sleeping` runtime-state slice with
 	* a `false` default for non-battery cams (no slice). Internal
 	* shorthand — driver code uses `this.state.battery.sleeping = b` to write
@@ -198609,6 +198874,7 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 			clearTimeout(this.reconnectTimer);
 			this.reconnectTimer = null;
 		}
+		this.reachability.dispose();
 		this.ctx.logger.info("Removing Reolink camera", { meta: { stableId: this.stableId } });
 		const ids = [...this.publishedStreamIds];
 		await Promise.all(ids.map((id) => this.ctx.api.streamBroker.retractCameraStream.mutate({
@@ -201028,11 +201294,14 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 				await api.login();
 			} catch (err) {
 				this.loginPromise = null;
+				if (isConnectivityFailure(err)) this.noteUnreachable(err instanceof Error ? err.message : String(err));
+				else if (this.ownsReachability()) this.reachability.noteReachable();
 				throw err;
 			}
 			this.api = api;
 			this.loginPromise = null;
 			this.reconnectAttempts = 0;
+			if (this.ownsReachability()) this.reachability.noteReachable();
 			const persistedDeviceType = this.config.get("deviceCache")?.deviceType;
 			if (persistedDeviceType === "battery-cam") {
 				this.isBattery = true;
@@ -201095,8 +201364,10 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 	* - 'awake' / 'sleeping': emit DeviceAwake / DeviceSleeping. Battery
 	*   power-state only — does NOT touch online state.
 	* - 'online' / 'offline': emit DeviceOnline / DeviceOffline + flip
-	*   `this.online`. The ONLY emit site for these — socket close,
-	*   reconnect, RFC4571 idle teardown all leave online state alone.
+	*   `this.online`, and reset the reachability verdict. The only OTHER
+	*   source is sustained unreachability on a mains camera (D904,
+	*   `onReachabilityOffline`): a single socket close, a reconnect or an
+	*   RFC4571 idle teardown still leaves online state alone.
 	* - 'battery': refresh cache, emit cap event.
 	* - 'doorbell', 'daynight', 'other': informational debug log only.
 	*/
@@ -201207,6 +201478,7 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 		}
 		if (event.type === "online" || event.type === "offline") {
 			const next = event.type === "online";
+			this.reachability.reset();
 			if (next !== this.online) {
 				this.markOnline(next);
 				this.ctx.eventBus.emit(createEvent(next ? EventCategory.DeviceOnline : EventCategory.DeviceOffline, eventSource, next ? {
@@ -201417,6 +201689,67 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 			await current.close({ reason });
 		} catch {}
 	}
+	/** D904 applies to a mains camera that dials its own socket — not a battery cam, not a hub child. */
+	ownsReachability() {
+		return !this.isBattery && !this.isHubChild();
+	}
+	/** The camera could not be reached: open (or extend) the reachability window. */
+	noteUnreachable(reason) {
+		if (!this.ownsReachability()) return;
+		this.reachability.noteFailure(reason);
+	}
+	/**
+	* One fresh login, for the tracker's confirmation and recovery probes. A
+	* battery cam or hub child is never probed (D173) and answers `reachable`,
+	* which closes the window instead of calling it offline.
+	*/
+	async probeReachability() {
+		if (!this.ownsReachability()) return "reachable";
+		try {
+			await this.ensureApi();
+			return "reachable";
+		} catch (err) {
+			return isConnectivityFailure(err) ? "unreachable" : "reachable";
+		}
+	}
+	/** Sustained unreachability, confirmed: the normal DeviceOffline, once. */
+	onReachabilityOffline(info) {
+		if (!this.online) {
+			this.ctx.logger.info("Reolink camera unreachable, already offline — nothing to emit", {
+				tags: { deviceId: this.id },
+				meta: { ...info }
+			});
+			return;
+		}
+		this.ctx.logger.warn("Reolink camera unreachable for the whole window — marked offline", {
+			tags: { deviceId: this.id },
+			meta: {
+				...info,
+				unreachableForMs: Date.now() - info.since
+			}
+		});
+		this.markOnline(false);
+		this.ctx.eventBus.emit(createEvent(EventCategory.DeviceOffline, this.eventSource(), {
+			deviceId: this.id,
+			providerId: REOLINK_ADDON_ID,
+			reason: "unreachable"
+		}));
+	}
+	/** The first success after a reachability outage: the normal DeviceOnline, once. */
+	onReachabilityOnline(info) {
+		if (this.online) return;
+		this.ctx.logger.info("Reolink camera reachable again — marked online", {
+			tags: { deviceId: this.id },
+			meta: { ...info }
+		});
+		this.markOnline(true);
+		this.ctx.eventBus.emit(createEvent(EventCategory.DeviceOnline, this.eventSource(), {
+			deviceId: this.id,
+			providerId: REOLINK_ADDON_ID,
+			profileCount: 0,
+			reason: "reachable-again"
+		}));
+	}
 	scheduleReconnect(reason) {
 		if (this.reconnectTimer) return;
 		if (this.isBattery) {
@@ -201430,6 +201763,7 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 			});
 			return;
 		}
+		this.noteUnreachable(reason);
 		const attempt = ++this.reconnectAttempts;
 		const backoffMs = Math.min(3e4, 1e3 * 2 ** Math.min(attempt - 1, 5));
 		this.ctx.logger.info("Baichuan reconnect scheduled", {

package/package.json

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