@camstack/addon-provider-homeassistant 1.2.85 → 1.2.86

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dist = require("./dist-DAyddjpR.js");
+const require_dist = require("./dist-lHF9qIyU.js");
 let node_crypto = require("node:crypto");
 let node_zlib = require("node:zlib");
 //#region src/ha-device-source.ts

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { $ as presenceCapability, A as controlCapability, At as EventCategory, B as humiditySensorCapability, C as buildAddonRouteProvider, Ct as number, D as colorCapability, Dt as union, E as climateControlCapability, Et as string, F as eventEmitterCapability, G as motionCapability, H as lawnMowerControlCapability, I as fanControlCapability, J as notifierCapability, K as normalizeUnit, L as floodCapability, M as deviceAdoptionCapability, O as connectivityCapability, Ot as unknown, P as enumSensorCapability, Q as prepareNotification, R as gasCapability, S as brokerCapability, St as literal, T as carbonMonoxideCapability, Tt as record, U as lockControlCapability, V as imageCapability, W as mediaPlayerCapability, Y as numericSensorCapability, Z as powerMeterCapability, _ as automationControlCapability, _t as createEvent, at as temperatureSensorCapability, b as binaryCapability, bt as array, ct as valveCapability, d as TargetSchema, dt as weatherCapability, et as pressureSensorCapability, f as accessoriesCapability, ft as errMsg, g as ambientLightSensorCapability, gt as DeviceType, h as alarmPanelCapability, ht as DeviceRole, it as tamperCapability, j as coverCapability, k as contactCapability, kt as url, lt as vibrationCapability, m as airQualitySensorCapability, mt as DeviceFeature, n as BaseDevice, nt as smokeCapability, ot as updateCapability, p as addonRoutesCapability, q as notificationOutputCapability, r as BaseDeviceProvider, rt as switchCapability, s as EnumSensorDateTimeFormatSchema, st as vacuumControlCapability, tt as scriptRunnerCapability, ut as waterHeaterCapability, v as batteryCapability, w as buttonCapability, wt as object, x as brightnessCapability, xt as discriminatedUnion, y as bestLocationMatch, yt as _enum, z as humidifierCapability } from "./dist-D8MM0d_3.mjs";
+import { $ as presenceCapability, A as controlCapability, At as EventCategory, B as humiditySensorCapability, C as buildAddonRouteProvider, Ct as number, D as colorCapability, Dt as union, E as climateControlCapability, Et as string, F as eventEmitterCapability, G as motionCapability, H as lawnMowerControlCapability, I as fanControlCapability, J as notifierCapability, K as normalizeUnit, L as floodCapability, M as deviceAdoptionCapability, O as connectivityCapability, Ot as unknown, P as enumSensorCapability, Q as prepareNotification, R as gasCapability, S as brokerCapability, St as literal, T as carbonMonoxideCapability, Tt as record, U as lockControlCapability, V as imageCapability, W as mediaPlayerCapability, Y as numericSensorCapability, Z as powerMeterCapability, _ as automationControlCapability, _t as createEvent, at as temperatureSensorCapability, b as binaryCapability, bt as array, ct as valveCapability, d as TargetSchema, dt as weatherCapability, et as pressureSensorCapability, f as accessoriesCapability, ft as errMsg, g as ambientLightSensorCapability, gt as DeviceType, h as alarmPanelCapability, ht as DeviceRole, it as tamperCapability, j as coverCapability, k as contactCapability, kt as url, lt as vibrationCapability, m as airQualitySensorCapability, mt as DeviceFeature, n as BaseDevice, nt as smokeCapability, ot as updateCapability, p as addonRoutesCapability, q as notificationOutputCapability, r as BaseDeviceProvider, rt as switchCapability, s as EnumSensorDateTimeFormatSchema, st as vacuumControlCapability, tt as scriptRunnerCapability, ut as waterHeaterCapability, v as batteryCapability, w as buttonCapability, wt as object, x as brightnessCapability, xt as discriminatedUnion, y as bestLocationMatch, yt as _enum, z as humidifierCapability } from "./dist-l3fKSOoz.mjs";
 import { randomUUID } from "node:crypto";
 import { brotliCompressSync, deflateSync, gzipSync } from "node:zlib";
 //#region src/ha-device-source.ts

package/dist/{dist-D8MM0d_3.mjs → dist-l3fKSOoz.mjs}

@@ -1,4 +1,4 @@
-//#region ../types/dist/event-category-BZL-fdNj.mjs
+//#region ../types/dist/event-category-zAv7pMUz.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -370,6 +370,13 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	*/
 	EventCategory["BatteryOnStatusChanged"] = "battery.onStatusChanged";
 	/**
+	* Cap event fired by every device that registers the `network-link`
+	* capability. Mirrors the cap definition's `onStatusChanged`. Carries
+	* `{ deviceId, status: NetworkLinkStatus }` — a link switch or a signal
+	* reading that moved.
+	*/
+	EventCategory["NetworkLinkOnStatusChanged"] = "network-link.onStatusChanged";
+	/**
 	* Emitted by the battery cap provider WHEN `wakeForStream` enters the
 	* "wake in progress" window — between the Baichuan wake-up issue and
 	* the camera's first dialed-back RTP packet. The stream-broker
@@ -24209,6 +24216,88 @@ onStatusChanged: { data: object({
 	volatileStateFields: ["lastUpdated"]
 };
 /**
+* Network-link snapshot. Same shape for every provider (a Reolink wifi
+* camera, a Home Assistant device with a signal-strength sensor, a Tapo
+* plug): one slice under `device.runtimeState['network-link']`, one badge,
+* one Home Assistant projection.
+*/
+var NetworkLinkStatusSchema = object({
+	/** The link the device is on. `'unknown'` = not read yet, not "no link". */
+	type: _enum([
+		"wifi",
+		"ethernet",
+		"cellular",
+		"unknown"
+	]),
+	/**
+	* Link quality, 0..100 inclusive, normalised by the provider from whatever
+	* the firmware reports (bars, RSSI, a vendor scale). **`null` means NOT
+	* KNOWN or NOT APPLICABLE** — a wired link has no signal, and a wireless
+	* one whose reading has not landed must not be drawn at 0 %. Consumers
+	* SKIP a null rather than coerce it.
+	*/
+	signalPercent: number().min(0).max(100).nullable(),
+	/** Raw received signal strength in dBm, when the firmware reports one. */
+	rssiDbm: number().optional(),
+	/** Network name of a wireless link, when the firmware reports it. */
+	ssid: string().optional(),
+	/** Ms epoch of the last observation. Lets consumers reason about freshness. */
+	lastUpdated: number()
+});
+var networkLinkCapability = {
+	name: "network-link",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [
+		DeviceType.Camera,
+		DeviceType.Sensor,
+		DeviceType.Button,
+		DeviceType.Switch,
+		DeviceType.Light,
+		DeviceType.Lock,
+		DeviceType.Siren
+	],
+	methods: {},
+	events: { 
+	/**
+	* Emitted whenever the cached status changes (a link switch, a signal
+	* reading that moved). Mirrored on the parent chain by the
+	* DeviceEventPropagator like `battery.onStatusChanged`.
+	*/
+onStatusChanged: { data: object({
+		deviceId: number(),
+		status: NetworkLinkStatusSchema
+	}) } },
+	status: {
+		schema: NetworkLinkStatusSchema,
+		kind: "push",
+		empty: {
+			type: "unknown",
+			signalPercent: null,
+			lastUpdated: 0
+		}
+	},
+	/**
+	* Runtime-state slice — every provider stores the same shape under
+	* `device.runtimeState['network-link']`, read once by the badge and the
+	* Home Assistant projector regardless of the driver.
+	*/
+	runtimeState: NetworkLinkStatusSchema,
+	/**
+	* Runtime-state durability: **restored** — a link reading is slow to
+	* change and a sleeping battery camera may not report for hours; the
+	* restored slice is what the badge shows until the next read.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "restored",
+	/** Clock fields: written, but excluded from the compare that decides
+	*  whether persisting is worth a SQLite commit. */
+	volatileStateFields: ["lastUpdated"]
+};
+/**
 * Generic boolean sensor — last-resort fallback when no domain-
 * specific binary cap fits (Home Assistant `binary_sensor` without a
 * known `device_class`, or a domain we haven't typed yet). Pure
@@ -32610,6 +32699,7 @@ var DEVICE_LOCAL_STATE_CAPS = {
 	motionTrigger: motionTriggerCapability,
 	motionZones: motionZonesCapability,
 	nativeObjectDetection: nativeObjectDetectionCapability,
+	networkLink: networkLinkCapability,
 	notifier: notifierCapability,
 	numericSensor: numericSensorCapability,
 	petFeeder: petFeederCapability,

package/dist/{dist-DAyddjpR.js → dist-lHF9qIyU.js}

@@ -1,4 +1,4 @@
-//#region ../types/dist/event-category-BZL-fdNj.mjs
+//#region ../types/dist/event-category-zAv7pMUz.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -370,6 +370,13 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	*/
 	EventCategory["BatteryOnStatusChanged"] = "battery.onStatusChanged";
 	/**
+	* Cap event fired by every device that registers the `network-link`
+	* capability. Mirrors the cap definition's `onStatusChanged`. Carries
+	* `{ deviceId, status: NetworkLinkStatus }` — a link switch or a signal
+	* reading that moved.
+	*/
+	EventCategory["NetworkLinkOnStatusChanged"] = "network-link.onStatusChanged";
+	/**
 	* Emitted by the battery cap provider WHEN `wakeForStream` enters the
 	* "wake in progress" window — between the Baichuan wake-up issue and
 	* the camera's first dialed-back RTP packet. The stream-broker
@@ -24209,6 +24216,88 @@ onStatusChanged: { data: object({
 	volatileStateFields: ["lastUpdated"]
 };
 /**
+* Network-link snapshot. Same shape for every provider (a Reolink wifi
+* camera, a Home Assistant device with a signal-strength sensor, a Tapo
+* plug): one slice under `device.runtimeState['network-link']`, one badge,
+* one Home Assistant projection.
+*/
+var NetworkLinkStatusSchema = object({
+	/** The link the device is on. `'unknown'` = not read yet, not "no link". */
+	type: _enum([
+		"wifi",
+		"ethernet",
+		"cellular",
+		"unknown"
+	]),
+	/**
+	* Link quality, 0..100 inclusive, normalised by the provider from whatever
+	* the firmware reports (bars, RSSI, a vendor scale). **`null` means NOT
+	* KNOWN or NOT APPLICABLE** — a wired link has no signal, and a wireless
+	* one whose reading has not landed must not be drawn at 0 %. Consumers
+	* SKIP a null rather than coerce it.
+	*/
+	signalPercent: number().min(0).max(100).nullable(),
+	/** Raw received signal strength in dBm, when the firmware reports one. */
+	rssiDbm: number().optional(),
+	/** Network name of a wireless link, when the firmware reports it. */
+	ssid: string().optional(),
+	/** Ms epoch of the last observation. Lets consumers reason about freshness. */
+	lastUpdated: number()
+});
+var networkLinkCapability = {
+	name: "network-link",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [
+		DeviceType.Camera,
+		DeviceType.Sensor,
+		DeviceType.Button,
+		DeviceType.Switch,
+		DeviceType.Light,
+		DeviceType.Lock,
+		DeviceType.Siren
+	],
+	methods: {},
+	events: { 
+	/**
+	* Emitted whenever the cached status changes (a link switch, a signal
+	* reading that moved). Mirrored on the parent chain by the
+	* DeviceEventPropagator like `battery.onStatusChanged`.
+	*/
+onStatusChanged: { data: object({
+		deviceId: number(),
+		status: NetworkLinkStatusSchema
+	}) } },
+	status: {
+		schema: NetworkLinkStatusSchema,
+		kind: "push",
+		empty: {
+			type: "unknown",
+			signalPercent: null,
+			lastUpdated: 0
+		}
+	},
+	/**
+	* Runtime-state slice — every provider stores the same shape under
+	* `device.runtimeState['network-link']`, read once by the badge and the
+	* Home Assistant projector regardless of the driver.
+	*/
+	runtimeState: NetworkLinkStatusSchema,
+	/**
+	* Runtime-state durability: **restored** — a link reading is slow to
+	* change and a sleeping battery camera may not report for hours; the
+	* restored slice is what the badge shows until the next read.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "restored",
+	/** Clock fields: written, but excluded from the compare that decides
+	*  whether persisting is worth a SQLite commit. */
+	volatileStateFields: ["lastUpdated"]
+};
+/**
 * Generic boolean sensor — last-resort fallback when no domain-
 * specific binary cap fits (Home Assistant `binary_sensor` without a
 * known `device_class`, or a domain we haven't typed yet). Pure
@@ -32610,6 +32699,7 @@ var DEVICE_LOCAL_STATE_CAPS = {
 	motionTrigger: motionTriggerCapability,
 	motionZones: motionZonesCapability,
 	nativeObjectDetection: nativeObjectDetectionCapability,
+	networkLink: networkLinkCapability,
 	notifier: notifierCapability,
 	numericSensor: numericSensorCapability,
 	petFeeder: petFeederCapability,

package/dist/ha-export/ha-export.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 //#endregion
-const require_dist = require("../dist-DAyddjpR.js");
+const require_dist = require("../dist-lHF9qIyU.js");
 let node_crypto = require("node:crypto");
 //#region src/ha-export/topics.ts
 /**
@@ -1333,6 +1333,22 @@ function cameraSpecs(device) {
 			enabledByDefault: true
 		}
 	];
+	if (device.slices.includes("network-link")) specs.push({
+		entity: "link",
+		platform: "sensor",
+		label: "Network link",
+		icon: "mdi:lan-connect",
+		entityCategory: "diagnostic",
+		enabledByDefault: true
+	}, {
+		entity: "signal",
+		platform: "sensor",
+		label: "Signal",
+		icon: "mdi:wifi",
+		unit: "%",
+		entityCategory: "diagnostic",
+		enabledByDefault: true
+	});
 	if (device.slices.includes("battery")) specs.push({
 		entity: "battery",
 		platform: "sensor",
@@ -4982,6 +4998,25 @@ function projectBatterySlice(deviceKey, slice) {
 	return values;
 }
 /**
+* The device's own link: which medium it is on and, for a wireless one, how
+* strong. An `unknown` type publishes nothing — it is the absence of a read,
+* and a wire drawn from it would be a lie the same way a 0 % battery was. A
+* `null` signal publishes no signal entity value: wired links have none, and
+* a wireless one not yet read must not sit at 0 %.
+*/
+function projectNetworkLinkSlice(deviceKey, slice) {
+	if (slice.type === "unknown") return [];
+	const values = [{
+		topic: stateTopic(deviceKey, "link"),
+		value: slice.type
+	}];
+	if (slice.signalPercent !== null) values.push({
+		topic: stateTopic(deviceKey, "signal"),
+		value: String(Math.round(slice.signalPercent))
+	});
+	return values;
+}
+/**
 * The per-camera function switches, mirrored 1:1 from
 * `deriveCameraFunctions` (`camera-functions.ts`) — the pure derivation over
 * the AUTHORITIES that own each function, replacing the deprecated
@@ -6037,6 +6072,16 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 			if (typeof online === "boolean") this.push(deviceId, projectDeviceStatus(deviceKey, online));
 			return;
 		}
+		if (capName === "network-link") {
+			const type = readString(slice, "type");
+			if (type === null) return;
+			const signalPercent = readNumber(slice, "signalPercent");
+			this.push(deviceId, projectNetworkLinkSlice(deviceKey, {
+				type,
+				signalPercent
+			}));
+			return;
+		}
 		if (capName === "battery") {
 			const percentage = readNumber(slice, "percentage");
 			const charging = readString(slice, "charging");
@@ -6800,6 +6845,14 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 		const snapshot = toSnapshot(snapshotRaw);
 		const online = snapshot["device-status"]?.["online"];
 		if (typeof online === "boolean") values.push(...projectDeviceStatus(key, online));
+		const link = snapshot["network-link"];
+		if (link !== void 0) {
+			const type = readString(link, "type");
+			if (type !== null) values.push(...projectNetworkLinkSlice(key, {
+				type,
+				signalPercent: readNumber(link, "signalPercent")
+			}));
+		}
 		const battery = snapshot["battery"];
 		if (battery !== void 0) {
 			const percentage = readNumber(battery, "percentage");

package/dist/ha-export/ha-export.addon.mjs

@@ -1,4 +1,4 @@
-import { At as EventCategory, C as buildAddonRouteProvider, Et as string, N as deviceExportCapability, X as oauthIntegrationCapability, a as COCO_TO_MACRO, c as FanDirectionSchema, i as CAMERA_SWITCH_ORDER, l as HvacModeSchema, o as CameraSwitchIdSchema, p as addonRoutesCapability, pt as BaseAddon, t as AlarmArmModeSchema, u as MediaPlayerRepeatSchema, vt as nodePin } from "../dist-D8MM0d_3.mjs";
+import { At as EventCategory, C as buildAddonRouteProvider, Et as string, N as deviceExportCapability, X as oauthIntegrationCapability, a as COCO_TO_MACRO, c as FanDirectionSchema, i as CAMERA_SWITCH_ORDER, l as HvacModeSchema, o as CameraSwitchIdSchema, p as addonRoutesCapability, pt as BaseAddon, t as AlarmArmModeSchema, u as MediaPlayerRepeatSchema, vt as nodePin } from "../dist-l3fKSOoz.mjs";
 import { createHmac, timingSafeEqual } from "node:crypto";
 //#region src/ha-export/topics.ts
 /**
@@ -1328,6 +1328,22 @@ function cameraSpecs(device) {
 			enabledByDefault: true
 		}
 	];
+	if (device.slices.includes("network-link")) specs.push({
+		entity: "link",
+		platform: "sensor",
+		label: "Network link",
+		icon: "mdi:lan-connect",
+		entityCategory: "diagnostic",
+		enabledByDefault: true
+	}, {
+		entity: "signal",
+		platform: "sensor",
+		label: "Signal",
+		icon: "mdi:wifi",
+		unit: "%",
+		entityCategory: "diagnostic",
+		enabledByDefault: true
+	});
 	if (device.slices.includes("battery")) specs.push({
 		entity: "battery",
 		platform: "sensor",
@@ -4977,6 +4993,25 @@ function projectBatterySlice(deviceKey, slice) {
 	return values;
 }
 /**
+* The device's own link: which medium it is on and, for a wireless one, how
+* strong. An `unknown` type publishes nothing — it is the absence of a read,
+* and a wire drawn from it would be a lie the same way a 0 % battery was. A
+* `null` signal publishes no signal entity value: wired links have none, and
+* a wireless one not yet read must not sit at 0 %.
+*/
+function projectNetworkLinkSlice(deviceKey, slice) {
+	if (slice.type === "unknown") return [];
+	const values = [{
+		topic: stateTopic(deviceKey, "link"),
+		value: slice.type
+	}];
+	if (slice.signalPercent !== null) values.push({
+		topic: stateTopic(deviceKey, "signal"),
+		value: String(Math.round(slice.signalPercent))
+	});
+	return values;
+}
+/**
 * The per-camera function switches, mirrored 1:1 from
 * `deriveCameraFunctions` (`camera-functions.ts`) — the pure derivation over
 * the AUTHORITIES that own each function, replacing the deprecated
@@ -6032,6 +6067,16 @@ var HaExportAddon = class extends BaseAddon {
 			if (typeof online === "boolean") this.push(deviceId, projectDeviceStatus(deviceKey, online));
 			return;
 		}
+		if (capName === "network-link") {
+			const type = readString(slice, "type");
+			if (type === null) return;
+			const signalPercent = readNumber(slice, "signalPercent");
+			this.push(deviceId, projectNetworkLinkSlice(deviceKey, {
+				type,
+				signalPercent
+			}));
+			return;
+		}
 		if (capName === "battery") {
 			const percentage = readNumber(slice, "percentage");
 			const charging = readString(slice, "charging");
@@ -6795,6 +6840,14 @@ var HaExportAddon = class extends BaseAddon {
 		const snapshot = toSnapshot(snapshotRaw);
 		const online = snapshot["device-status"]?.["online"];
 		if (typeof online === "boolean") values.push(...projectDeviceStatus(key, online));
+		const link = snapshot["network-link"];
+		if (link !== void 0) {
+			const type = readString(link, "type");
+			if (type !== null) values.push(...projectNetworkLinkSlice(key, {
+				type,
+				signalPercent: readNumber(link, "signalPercent")
+			}));
+		}
 		const battery = snapshot["battery"];
 		if (battery !== void 0) {
 			const percentage = readNumber(battery, "percentage");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-homeassistant",
-  "version": "1.2.85",
+  "version": "1.2.86",
   "description": "Home Assistant device provider addon for CamStack",
   "keywords": [
     "camstack",