@camstack/addon-provider-homeassistant 1.2.625 → 1.2.627

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

@@ -24,7 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_dist = require("../dist-oNUlRdur.js");
+const require_dist = require("../dist-CRwUHjY7.js");
 let node_crypto = require("node:crypto");
 require("node:zlib");
 let node_fs = require("node:fs");
@@ -731,12 +731,6 @@ var STATUS_UNKNOWN = "unknown";
 function consumableEntity(key, facet) {
 	return `${CONSUMABLE_PREFIX}_${toSlug(key)}_${facet}`;
 }
-/** Home Assistant's own duration units; a cycle count is a plain count. */
-var REMAINING_UNIT = {
-	days: "d",
-	hours: "h",
-	cycles: "cycles"
-};
 /**
 * The item's form (the capability's own derivation, `consumableFormOf`): the one
 * the provider declared when it is a form the capability knows, else the one its
@@ -829,7 +823,7 @@ function consumableEntities(item) {
 		entityCategory: "diagnostic"
 	});
 	if (item.remaining !== void 0) {
-		const isDuration = item.remaining.unit !== "cycles";
+		const isDuration = item.remaining.kind === "duration";
 		out.push({
 			...base,
 			facet: "remaining",
@@ -837,7 +831,7 @@ function consumableEntities(item) {
 			uniqueSuffix: unique("remaining"),
 			platform: "sensor",
 			label: `${item.label} remaining`,
-			unit: REMAINING_UNIT[item.remaining.unit],
+			...isDuration ? { unit: "s" } : {},
 			stateClass: "measurement",
 			...isDuration ? { deviceClass: "duration" } : {},
 			icon: isDuration ? "mdi:timer-sand" : "mdi:counter",
@@ -3184,7 +3178,7 @@ mireds: {
 				platform: "sensor",
 				field: "desiccantLeftDays",
 				label: "Desiccant remaining",
-				unit: "d",
+				unit: "s",
 				entityCategory: "diagnostic",
 				enabledByDefault: false
 			},
@@ -3198,11 +3192,8 @@ mireds: {
 		}
 	},
 	/**
-	* The cap carries its OWN unit next to each measurement
-	* (`temperatureUnit`, `pressureUnit`, `windSpeedUnit`), so no static
-	* `unit_of_measurement` can be honest for a provider reporting °F.
-	* Declaring one anyway is how a dashboard comes to say 71 °C. Humidity
-	* is the exception: a percentage is a percentage.
+	* Weather numbers are stored in the quantity base (°C, hPa, m/s). The
+	* export advertises those symbols. A Fahrenheit dashboard converts at read.
 	*/
 	weather: {
 		platform: "sensor",
@@ -3213,6 +3204,8 @@ mireds: {
 				platform: "sensor",
 				field: "temperature",
 				label: "Temperature",
+				unit: "°C",
+				deviceClass: "temperature",
 				icon: "mdi:thermometer"
 			},
 			humidity: {
@@ -3226,6 +3219,8 @@ mireds: {
 				platform: "sensor",
 				field: "pressure",
 				label: "Pressure",
+				unit: "hPa",
+				deviceClass: "pressure",
 				icon: "mdi:gauge",
 				enabledByDefault: false
 			},
@@ -3233,6 +3228,8 @@ mireds: {
 				platform: "sensor",
 				field: "windSpeed",
 				label: "Wind speed",
+				unit: "m/s",
+				deviceClass: "wind_speed",
 				icon: "mdi:weather-windy",
 				enabledByDefault: false
 			},
@@ -3443,7 +3440,7 @@ function readFiniteNumber(slice, field) {
 * builds with nothing to choose from — so an empty list falls back to a
 * read-only sensor rather than a dead control.
 */
-function controlEntitySpecs(slice) {
+function controlEntitySpecs(slice, quantity) {
 	const kind = typeof slice?.["kind"] === "string" ? slice["kind"] : null;
 	const primary = derivedEntityId("control");
 	const kindExtra = {
@@ -3468,7 +3465,7 @@ function controlEntitySpecs(slice) {
 		const min = readFiniteNumber(slice, "min") ?? PERCENT_RANGE.min;
 		const max = readFiniteNumber(slice, "max") ?? PERCENT_RANGE.max;
 		const step = readFiniteNumber(slice, "step") ?? PERCENT_RANGE.step;
-		const unit = typeof slice?.["unit"] === "string" ? slice["unit"] : void 0;
+		const unit = quantity === void 0 ? void 0 : require_dist.baseUnitOf(quantity);
 		if (min < max && step > 0) return [{
 			entity: primary,
 			platform: "number",
@@ -3491,6 +3488,10 @@ function controlEntitySpecs(slice) {
 	}, kindExtra];
 }
 var CAPS_NOT_EXPORTED = [
+	{
+		cap: "group-status",
+		reason: "Bookkeeping for a helper group (D944): how many members were included, excluded, or named. The value an operator automates on is the output capability (the temperature, the motion, the watts). These counts are session-only, have no history, and would publish a second entity that never means the reading."
+	},
 	{
 		cap: "recording-onboard",
 		reason: "An EDITOR of the CAMERA’s own recorder: a weekly schedule of windows per trigger, plus the facts about the card it writes to. The schedule is a document an operator authors, not a reading — an entity would publish 168 slots as a state and nothing in Home Assistant could act on it. The storage side is a reading, but it belongs to the camera’s own health rather than to this cap’s editor surface, and publishing capacity here would put the same number in two places the day a health cap carries it. ONE thing here is arguably a real binary sensor: `recordingToNowhere` — scheduled to record with no usable card. It is deliberately NOT exported yet, because exporting half a cap needs the split decided first, and the two cameras it fires on today are already a danger banner and a WARN."
@@ -3738,7 +3739,15 @@ function buildDerivedPlan(device, options = UNNEGOTIATED_PLAN_OPTIONS) {
 		* row stays the projector + writable-route authority.
 		*/
 		if (cap === "control") {
-			specs.push(...controlEntitySpecs(device.capSlices?.["control"]).map((spec) => degradeUnsupported(spec, options)));
+			specs.push(...controlEntitySpecs(device.capSlices?.["control"], device.readingQuantity).map((spec) => degradeUnsupported(spec, options)));
+			continue;
+		}
+		if (cap === "numeric-sensor") {
+			const unit = device.readingQuantity === void 0 ? void 0 : require_dist.baseUnitOf(device.readingQuantity);
+			specs.push(...capEntitySpecs(cap).map((spec) => degradeUnsupported(unit === void 0 ? spec : {
+				...spec,
+				unit
+			}, options)));
 			continue;
 		}
 		const mapping = CAP_ENTITY_MAP[cap];
@@ -7963,6 +7972,7 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 		if (items.held) heldBack = true;
 		const manufacturer = readString(device.metadata ?? {}, "manufacturer");
 		const model = readString(device.metadata ?? {}, "model");
+		const readingQuantity = device.sourceInfo?.quantity;
 		return {
 			device: {
 				id: device.id,
@@ -7984,7 +7994,8 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 				* `CatalogDevice.capSlices`.
 				*/
 				capSlices: snapshot,
-				itemEntities: items.entities
+				itemEntities: items.entities,
+				...require_dist.isReadingQuantity(readingQuantity) ? { readingQuantity } : {}
 			},
 			heldBack
 		};

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

@@ -1,4 +1,4 @@
-import { At as BaseAddon, D as buildAddonRouteProvider, F as consumableFormOf, Gt as string, H as deviceExportCapability, I as consumableKindOf, It as nodePin, Rt as array, Ut as object, Yt as EventCategory, _ as addonRoutesCapability, a as COCO_TO_MACRO, at as oauthIntegrationCapability, c as ConsumableItemSchema, d as FanDirectionSchema, f as HvacModeSchema, i as CAMERA_SWITCH_ORDER, l as ConsumableStatusSchema, o as CameraSwitchIdSchema, p as MediaPlayerRepeatSchema, qt as unknown, s as ConsumableFormSchema, t as AlarmArmModeSchema } from "../dist-DvZEnx9C.mjs";
+import { $t as unknown, D as buildAddonRouteProvider, F as consumableFormOf, H as deviceExportCapability, Ht as nodePin, I as consumableKindOf, It as baseUnitOf, Pt as BaseAddon, Vt as isReadingQuantity, Wt as array, Yt as object, Zt as string, _ as addonRoutesCapability, a as COCO_TO_MACRO, c as ConsumableItemSchema, d as FanDirectionSchema, f as HvacModeSchema, i as CAMERA_SWITCH_ORDER, l as ConsumableStatusSchema, o as CameraSwitchIdSchema, ot as oauthIntegrationCapability, p as MediaPlayerRepeatSchema, s as ConsumableFormSchema, t as AlarmArmModeSchema, tn as EventCategory } from "../dist-BFnk4bwH.mjs";
 import { createHmac, timingSafeEqual } from "node:crypto";
 import "node:zlib";
 import "node:fs";
@@ -703,12 +703,6 @@ var STATUS_UNKNOWN = "unknown";
 function consumableEntity(key, facet) {
 	return `${CONSUMABLE_PREFIX}_${toSlug(key)}_${facet}`;
 }
-/** Home Assistant's own duration units; a cycle count is a plain count. */
-var REMAINING_UNIT = {
-	days: "d",
-	hours: "h",
-	cycles: "cycles"
-};
 /**
 * The item's form (the capability's own derivation, `consumableFormOf`): the one
 * the provider declared when it is a form the capability knows, else the one its
@@ -794,7 +788,7 @@ function consumableEntities(item) {
 		entityCategory: "diagnostic"
 	});
 	if (item.remaining !== void 0) {
-		const isDuration = item.remaining.unit !== "cycles";
+		const isDuration = item.remaining.kind === "duration";
 		out.push({
 			...base,
 			facet: "remaining",
@@ -802,7 +796,7 @@ function consumableEntities(item) {
 			uniqueSuffix: unique("remaining"),
 			platform: "sensor",
 			label: `${item.label} remaining`,
-			unit: REMAINING_UNIT[item.remaining.unit],
+			...isDuration ? { unit: "s" } : {},
 			stateClass: "measurement",
 			...isDuration ? { deviceClass: "duration" } : {},
 			icon: isDuration ? "mdi:timer-sand" : "mdi:counter",
@@ -3149,7 +3143,7 @@ mireds: {
 				platform: "sensor",
 				field: "desiccantLeftDays",
 				label: "Desiccant remaining",
-				unit: "d",
+				unit: "s",
 				entityCategory: "diagnostic",
 				enabledByDefault: false
 			},
@@ -3163,11 +3157,8 @@ mireds: {
 		}
 	},
 	/**
-	* The cap carries its OWN unit next to each measurement
-	* (`temperatureUnit`, `pressureUnit`, `windSpeedUnit`), so no static
-	* `unit_of_measurement` can be honest for a provider reporting °F.
-	* Declaring one anyway is how a dashboard comes to say 71 °C. Humidity
-	* is the exception: a percentage is a percentage.
+	* Weather numbers are stored in the quantity base (°C, hPa, m/s). The
+	* export advertises those symbols. A Fahrenheit dashboard converts at read.
 	*/
 	weather: {
 		platform: "sensor",
@@ -3178,6 +3169,8 @@ mireds: {
 				platform: "sensor",
 				field: "temperature",
 				label: "Temperature",
+				unit: "°C",
+				deviceClass: "temperature",
 				icon: "mdi:thermometer"
 			},
 			humidity: {
@@ -3191,6 +3184,8 @@ mireds: {
 				platform: "sensor",
 				field: "pressure",
 				label: "Pressure",
+				unit: "hPa",
+				deviceClass: "pressure",
 				icon: "mdi:gauge",
 				enabledByDefault: false
 			},
@@ -3198,6 +3193,8 @@ mireds: {
 				platform: "sensor",
 				field: "windSpeed",
 				label: "Wind speed",
+				unit: "m/s",
+				deviceClass: "wind_speed",
 				icon: "mdi:weather-windy",
 				enabledByDefault: false
 			},
@@ -3408,7 +3405,7 @@ function readFiniteNumber(slice, field) {
 * builds with nothing to choose from — so an empty list falls back to a
 * read-only sensor rather than a dead control.
 */
-function controlEntitySpecs(slice) {
+function controlEntitySpecs(slice, quantity) {
 	const kind = typeof slice?.["kind"] === "string" ? slice["kind"] : null;
 	const primary = derivedEntityId("control");
 	const kindExtra = {
@@ -3433,7 +3430,7 @@ function controlEntitySpecs(slice) {
 		const min = readFiniteNumber(slice, "min") ?? PERCENT_RANGE.min;
 		const max = readFiniteNumber(slice, "max") ?? PERCENT_RANGE.max;
 		const step = readFiniteNumber(slice, "step") ?? PERCENT_RANGE.step;
-		const unit = typeof slice?.["unit"] === "string" ? slice["unit"] : void 0;
+		const unit = quantity === void 0 ? void 0 : baseUnitOf(quantity);
 		if (min < max && step > 0) return [{
 			entity: primary,
 			platform: "number",
@@ -3456,6 +3453,10 @@ function controlEntitySpecs(slice) {
 	}, kindExtra];
 }
 var CAPS_NOT_EXPORTED = [
+	{
+		cap: "group-status",
+		reason: "Bookkeeping for a helper group (D944): how many members were included, excluded, or named. The value an operator automates on is the output capability (the temperature, the motion, the watts). These counts are session-only, have no history, and would publish a second entity that never means the reading."
+	},
 	{
 		cap: "recording-onboard",
 		reason: "An EDITOR of the CAMERA’s own recorder: a weekly schedule of windows per trigger, plus the facts about the card it writes to. The schedule is a document an operator authors, not a reading — an entity would publish 168 slots as a state and nothing in Home Assistant could act on it. The storage side is a reading, but it belongs to the camera’s own health rather than to this cap’s editor surface, and publishing capacity here would put the same number in two places the day a health cap carries it. ONE thing here is arguably a real binary sensor: `recordingToNowhere` — scheduled to record with no usable card. It is deliberately NOT exported yet, because exporting half a cap needs the split decided first, and the two cameras it fires on today are already a danger banner and a WARN."
@@ -3703,7 +3704,15 @@ function buildDerivedPlan(device, options = UNNEGOTIATED_PLAN_OPTIONS) {
 		* row stays the projector + writable-route authority.
 		*/
 		if (cap === "control") {
-			specs.push(...controlEntitySpecs(device.capSlices?.["control"]).map((spec) => degradeUnsupported(spec, options)));
+			specs.push(...controlEntitySpecs(device.capSlices?.["control"], device.readingQuantity).map((spec) => degradeUnsupported(spec, options)));
+			continue;
+		}
+		if (cap === "numeric-sensor") {
+			const unit = device.readingQuantity === void 0 ? void 0 : baseUnitOf(device.readingQuantity);
+			specs.push(...capEntitySpecs(cap).map((spec) => degradeUnsupported(unit === void 0 ? spec : {
+				...spec,
+				unit
+			}, options)));
 			continue;
 		}
 		const mapping = CAP_ENTITY_MAP[cap];
@@ -7928,6 +7937,7 @@ var HaExportAddon = class extends BaseAddon {
 		if (items.held) heldBack = true;
 		const manufacturer = readString(device.metadata ?? {}, "manufacturer");
 		const model = readString(device.metadata ?? {}, "model");
+		const readingQuantity = device.sourceInfo?.quantity;
 		return {
 			device: {
 				id: device.id,
@@ -7949,7 +7959,8 @@ var HaExportAddon = class extends BaseAddon {
 				* `CatalogDevice.capSlices`.
 				*/
 				capSlices: snapshot,
-				itemEntities: items.entities
+				itemEntities: items.entities,
+				...isReadingQuantity(readingQuantity) ? { readingQuantity } : {}
 			},
 			heldBack
 		};

package/package.json

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