@camstack/addon-provider-ecowitt 0.1.4 → 0.1.6

package/dist/addon.js

@@ -4647,7 +4647,7 @@ function preprocess(fn, schema) {
 	});
 }
 //#endregion
-//#region ../types/dist/sleep-NOH4yRwj.mjs
+//#region ../types/dist/sleep-DVmKHFGi.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -6447,6 +6447,17 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
 	DeviceRole["HumiditySensor"] = "humidity-sensor";
 	DeviceRole["AmbientLightSensor"] = "ambient-light-sensor";
 	DeviceRole["PressureSensor"] = "pressure-sensor";
+	/** Wind speed or direction (weather-station `wind-sensor` cap). */
+	DeviceRole["WindSensor"] = "wind-sensor";
+	/** Rain accumulation or rate (weather-station `rain-sensor` cap). */
+	DeviceRole["RainSensor"] = "rain-sensor";
+	/** UV index (weather-station `uv-sensor` cap). */
+	DeviceRole["UvSensor"] = "uv-sensor";
+	/** Solar irradiance W/m² (weather-station `solar-radiation-sensor` cap).
+	*  Distinct from AmbientLightSensor (lux). */
+	DeviceRole["SolarRadiationSensor"] = "solar-radiation-sensor";
+	/** Soil moisture % (garden/weather `soil-moisture-sensor` cap). */
+	DeviceRole["SoilMoistureSensor"] = "soil-moisture-sensor";
 	DeviceRole["PowerSensor"] = "power-sensor";
 	DeviceRole["EnergySensor"] = "energy-sensor";
 	DeviceRole["VoltageSensor"] = "voltage-sensor";
@@ -10071,15 +10082,18 @@ var humiditySensorCapability = {
 	runtimeState: HumiditySensorStatusSchema
 };
 /**
-* Image display cap. Models HA `image.*` entities — a single still image
-* exposed by an integration (a snapshot, a chart, a generated picture).
+* Image display cap. Models a single still image exposed by an integration —
+* a snapshot, a chart, a generated picture, or a robot's cleaning-map render.
 *
-* Read-only: there are no setters. The provider resolves the HA
-* `entity_picture` (a relative, signed-token path) into an ABSOLUTE URL
-* the browser loads directly — the token stays in the query string so no
-* auth header is required. The slice carries that URL plus the upstream
-* last-updated timestamp; the image changes when the entity state (a
-* timestamp) changes.
+* Read-only: there are no setters. The provider resolves whatever upstream
+* source it has into an ABSOLUTE URL the browser loads directly:
+*   - HA `image.*` entities → the `entity_picture` signed-token path
+*     (token stays in the query string, so no auth header is needed);
+*   - a Dreame/robot map → the cloud/OSS map-image URL (or an addon
+*     data-plane URL serving the rendered map bytes), exposed as its own
+*     Image child device grouped under the robot's container.
+* The slice carries that URL plus the upstream last-updated timestamp; the
+* image changes when the source's last-updated marker changes.
 */
 var ImageStatusSchema = object({
 	/** Absolute signed URL the browser loads directly. Null when the
@@ -10105,18 +10119,47 @@ var imageCapability = {
 	*/
 	runtimeState: ImageStatusSchema
 };
+/**
+* Robotic lawn-mower cap. Models HA `lawn_mower.*` entities — anything
+* with a mowing lifecycle plus a dock action.
+*
+* Activity follows HA's canonical lawn-mower lifecycle: `idle` /
+* `mowing` / `paused` / `docked` / `error`. `batteryLevel` (0..100) is
+* nullable — some mowers don't report a battery percentage.
+*
+* `startMowing` begins a mowing run, `pause` halts it in place, and
+* `dock` sends the mower back to its charging station.
+*/
+var LawnMowerActivitySchema = _enum([
+	"idle",
+	"mowing",
+	"paused",
+	"docked",
+	"error"
+]);
+/** Severity of the current device/error code — info (status), warning, error. */
+var DeviceCodeSeveritySchema = _enum([
+	"info",
+	"warning",
+	"error"
+]);
 var LawnMowerControlStatusSchema = object({
 	/** Lifecycle activity of the mower. */
-	activity: _enum([
-		"idle",
-		"mowing",
-		"paused",
-		"docked",
-		"error"
-	]),
+	activity: LawnMowerActivitySchema,
 	/** 0..100 battery percentage. Null when the device has no battery
 	*  reading. */
 	batteryLevel: number().min(0).max(100).nullable(),
+	/** 0..100 mowing-completion percentage of the current task, or null when no
+	*  task is active / progress is unavailable. */
+	progressPercent: number().min(0).max(100).nullable(),
+	/** Current device/event code (dynamic — mostly status, sometimes an error),
+	*  or null when unknown. */
+	currentCode: number().nullable(),
+	/** Human label for {@link currentCode}, or null when undecodable. */
+	currentCodeLabel: string().nullable(),
+	/** Severity of {@link currentCode}. `error` (and often `warning`) warrants UI
+	*  attention; `info` is normal status. */
+	severity: DeviceCodeSeveritySchema,
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -12342,6 +12385,7 @@ var VacuumStateSchema = _enum([
 	"paused",
 	"returning",
 	"docked",
+	"drying",
 	"error"
 ]);
 /**
@@ -12380,6 +12424,12 @@ var VacuumControlStatusSchema = object({
 	detergent: TankStatusSchema.nullable(),
 	/** Dust bin. Null when the hardware has no dust bin. */
 	dustBin: TankStatusSchema.nullable(),
+	/** 0..100 cleaning-completion percentage of the current task, or null. */
+	progressPercent: number().min(0).max(100).nullable(),
+	/** Current error code (0 / null = no error). */
+	errorCode: number().nullable(),
+	/** Human label for {@link errorCode}, or null when none / undecodable. */
+	errorLabel: string().nullable(),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -16895,6 +16945,9 @@ method(object({
 }), method(ReleaseInputSchema.extend({ addonId: string() }), _void(), {
 	kind: "mutation",
 	auth: "admin"
+}), method(ResyncInputSchema, ResyncResultSchema, {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	deviceId: number(),
 	key: string(),
@@ -20657,6 +20710,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.adoptionResync": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.allocateDeviceId": {
 		capName: "device-manager",
 		capScope: "system",
@@ -44565,7 +44624,8 @@ function classifyKey(key) {
 	const hex = lookupHexId(key);
 	if (hex !== void 0) return {
 		kind: "measurement",
-		quantity: hex.quantity
+		quantity: hex.quantity,
+		name: hex.name
 	};
 	const named = Object.prototype.hasOwnProperty.call(NAMED_QUANTITY, key) ? NAMED_QUANTITY[key] : void 0;
 	if (named !== void 0) return {
@@ -44601,6 +44661,7 @@ var Station = class {
 				...owner !== void 0 ? { hardwareId: owner } : {},
 				...info?.model ? { model: info.model } : {},
 				...info?.channel !== void 0 ? { channel: info.channel } : {},
+				...cls.name !== void 0 ? { name: cls.name } : {},
 				quantity: cls.quantity,
 				value: r.value,
 				unit: r.unit,
@@ -44634,6 +44695,7 @@ var Station = class {
 			this.upsert(id, {
 				id,
 				...r.channel !== void 0 ? { channel: r.channel } : {},
+				...cls.name !== void 0 ? { name: cls.name } : {},
 				quantity: cls.quantity,
 				value: r.value,
 				unit: r.unit,
@@ -45597,27 +45659,46 @@ function buildEcowittBrokerProvider(deps) {
 //#endregion
 //#region src/ecowitt-mapping.ts
 /**
-* Map an Ecowitt quantity to its camstack typed sensor cap. Pure, total.
+* Map an Ecowitt quantity to its camstack sensor cap. Pure, total.
 *
-* Accepts a plain `string` (not just the {@link Quantity} union) so a persisted
-* config value flows through without a cast — any unrecognised string falls to
-* `numeric-sensor`, which is the same safe default the union's tail uses.
+* Only temperature/humidity/pressure get a dedicated typed cap (the thermostat
+* surface consumes them); every other quantity rides `numeric-sensor` and is
+* typed by its {@link roleForQuantity} role instead. Accepts a plain `string`
+* so a persisted config value flows through without a cast — any unrecognised
+* string falls to `numeric-sensor`, the same safe default the tail uses.
 */
 function capForQuantity(quantity) {
 	switch (quantity) {
 		case "temperature": return "temperature-sensor";
 		case "humidity": return "humidity-sensor";
 		case "pressure": return "pressure-sensor";
-		case "irradiance": return "ambient-light-sensor";
-		case "uv":
+		default: return "numeric-sensor";
+	}
+}
+/**
+* Map an Ecowitt quantity to the semantic {@link DeviceRole} that drives the
+* child's icon/label (and, in future, its canonical unit). Pure, total — an
+* unrecognised quantity falls to {@link DeviceRole.NumericSensor}.
+*
+* This is where weather metrics get their typing: wind/rain/uv/irradiance ride
+* the generic `numeric-sensor` cap but carry a typed role, so the UI renders a
+* wind / rain / UV / solar glyph instead of a bare hash.
+*/
+function roleForQuantity(quantity) {
+	switch (quantity) {
+		case "temperature": return DeviceRole.TemperatureSensor;
+		case "humidity": return DeviceRole.HumiditySensor;
+		case "pressure": return DeviceRole.PressureSensor;
 		case "wind_speed":
-		case "wind_direction":
+		case "wind_direction": return DeviceRole.WindSensor;
 		case "precipitation":
-		case "precipitation_rate":
+		case "precipitation_rate": return DeviceRole.RainSensor;
+		case "uv": return DeviceRole.UvSensor;
+		case "irradiance": return DeviceRole.SolarRadiationSensor;
 		case "lightning_distance":
 		case "lightning_count":
-		case "vpd": return "numeric-sensor";
-		default: return "numeric-sensor";
+		case "vpd": return DeviceRole.NumericSensor;
+		default: return DeviceRole.NumericSensor;
 	}
 }
 /**
@@ -45640,15 +45721,18 @@ function valueFieldForCap(cap) {
 	}
 }
 /**
-* Build a human label for a sensor from its quantity + optional channel.
-* `temperature` + channel 2 → `Temperature CH2`; channel-less → `Temperature`.
+* Build a human label for a sensor. Prefers the SPECIFIC measurement `name` when
+* the library resolved one (e.g. "Outdoor Temperature", "Dewpoint Temperature",
+* "Wind Gust") so same-quantity sensors are distinguishable; otherwise falls back
+* to the quantity label. A channel suffix is appended when present
+* (`temperature` + channel 2 → `Temperature CH2`).
 *
 * Accepts a plain `string` (not just {@link Quantity}) so a persisted config
 * value flows through without a cast; an unknown quantity falls back to its raw
 * string label.
 */
-function sensorLabel(quantity, channel) {
-	const base = isKnownQuantity(quantity) ? QUANTITY_LABEL[quantity] : quantity;
+function sensorLabel(quantity, channel, name) {
+	const base = name !== void 0 && name.length > 0 ? name : isKnownQuantity(quantity) ? QUANTITY_LABEL[quantity] : quantity;
 	return channel !== void 0 ? `${base} CH${channel}` : base;
 }
 /** Type guard: is `q` one of the known {@link Quantity} union members? */
@@ -45682,7 +45766,7 @@ var QUANTITY_LABEL = {
 function buildEcowittGatewayCandidate(input) {
 	const children = input.sensors.map((sensor) => ({
 		childNativeId: sensor.id,
-		name: sensorLabel(sensor.quantity, sensor.channel),
+		name: sensorLabel(sensor.quantity, sensor.channel, sensor.name),
 		type: DeviceType.Sensor,
 		status: "online",
 		metadata: sensor.model !== void 0 ? { model: sensor.model } : {},
@@ -46157,7 +46241,8 @@ function clampForCap(cap, value) {
 var ecowittSensorEntrySchema = object({
 	sensorId: string(),
 	quantity: string(),
-	channel: number().optional()
+	channel: number().optional(),
+	name: string().optional()
 });
 /**
 * Persisted config for an Ecowitt gateway Container. `brokerId` selects the
@@ -46199,7 +46284,8 @@ var EcowittContainerDevice = class extends BaseDevice {
 		return this.config.values.sensors.map((sensor) => {
 			const meta = {
 				type: DeviceType.Sensor,
-				name: sensorLabel(sensor.quantity, sensor.channel),
+				role: roleForQuantity(sensor.quantity),
+				name: sensorLabel(sensor.quantity, sensor.channel, sensor.name),
 				linkDeviceId: this.id,
 				...this.integrationId !== void 0 ? { integrationId: this.integrationId } : {}
 			};
@@ -46354,7 +46440,8 @@ var EcowittProviderAddon = class extends BaseDeviceProvider {
 			const nextSensors = sensors.map((s) => ({
 				sensorId: s.id,
 				quantity: s.quantity,
-				...s.channel !== void 0 ? { channel: s.channel } : {}
+				...s.channel !== void 0 ? { channel: s.channel } : {},
+				...s.name !== void 0 ? { name: s.name } : {}
 			}));
 			const cfg = await devices.loadConfig(containerId).catch(() => ({}));
 			if (sensorsEqual(Array.isArray(cfg["sensors"]) ? cfg["sensors"] : [], nextSensors)) return;
@@ -46475,7 +46562,8 @@ var EcowittProviderAddon = class extends BaseDeviceProvider {
 					sensors: ecowittFacades.getSensors(brokerId).map((s) => ({
 						sensorId: s.id,
 						quantity: s.quantity,
-						...s.channel !== void 0 ? { channel: s.channel } : {}
+						...s.channel !== void 0 ? { channel: s.channel } : {},
+						...s.name !== void 0 ? { name: s.name } : {}
 					})),
 					system: "ecowitt",
 					integrationId,
@@ -46543,12 +46631,18 @@ var EcowittProviderAddon = class extends BaseDeviceProvider {
 /** Structural equality of two persisted sensor lists (order-independent by id). */
 function sensorsEqual(a, b) {
 	if (a.length !== b.length) return false;
-	const aIds = /* @__PURE__ */ new Set();
+	const aById = /* @__PURE__ */ new Map();
 	for (const entry of a) if (typeof entry === "object" && entry !== null && "sensorId" in entry) {
 		const id = entry.sensorId;
-		if (typeof id === "string") aIds.add(id);
+		if (typeof id === "string") {
+			const name = "name" in entry && typeof entry.name === "string" ? entry.name : void 0;
+			aById.set(id, name);
+		}
+	}
+	for (const entry of b) {
+		if (!aById.has(entry.sensorId)) return false;
+		if (aById.get(entry.sensorId) !== entry.name) return false;
 	}
-	for (const entry of b) if (!aIds.has(entry.sensorId)) return false;
 	return true;
 }
 //#endregion

package/dist/addon.mjs

@@ -4648,7 +4648,7 @@ function preprocess(fn, schema) {
 	});
 }
 //#endregion
-//#region ../types/dist/sleep-NOH4yRwj.mjs
+//#region ../types/dist/sleep-DVmKHFGi.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -6448,6 +6448,17 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
 	DeviceRole["HumiditySensor"] = "humidity-sensor";
 	DeviceRole["AmbientLightSensor"] = "ambient-light-sensor";
 	DeviceRole["PressureSensor"] = "pressure-sensor";
+	/** Wind speed or direction (weather-station `wind-sensor` cap). */
+	DeviceRole["WindSensor"] = "wind-sensor";
+	/** Rain accumulation or rate (weather-station `rain-sensor` cap). */
+	DeviceRole["RainSensor"] = "rain-sensor";
+	/** UV index (weather-station `uv-sensor` cap). */
+	DeviceRole["UvSensor"] = "uv-sensor";
+	/** Solar irradiance W/m² (weather-station `solar-radiation-sensor` cap).
+	*  Distinct from AmbientLightSensor (lux). */
+	DeviceRole["SolarRadiationSensor"] = "solar-radiation-sensor";
+	/** Soil moisture % (garden/weather `soil-moisture-sensor` cap). */
+	DeviceRole["SoilMoistureSensor"] = "soil-moisture-sensor";
 	DeviceRole["PowerSensor"] = "power-sensor";
 	DeviceRole["EnergySensor"] = "energy-sensor";
 	DeviceRole["VoltageSensor"] = "voltage-sensor";
@@ -10072,15 +10083,18 @@ var humiditySensorCapability = {
 	runtimeState: HumiditySensorStatusSchema
 };
 /**
-* Image display cap. Models HA `image.*` entities — a single still image
-* exposed by an integration (a snapshot, a chart, a generated picture).
+* Image display cap. Models a single still image exposed by an integration —
+* a snapshot, a chart, a generated picture, or a robot's cleaning-map render.
 *
-* Read-only: there are no setters. The provider resolves the HA
-* `entity_picture` (a relative, signed-token path) into an ABSOLUTE URL
-* the browser loads directly — the token stays in the query string so no
-* auth header is required. The slice carries that URL plus the upstream
-* last-updated timestamp; the image changes when the entity state (a
-* timestamp) changes.
+* Read-only: there are no setters. The provider resolves whatever upstream
+* source it has into an ABSOLUTE URL the browser loads directly:
+*   - HA `image.*` entities → the `entity_picture` signed-token path
+*     (token stays in the query string, so no auth header is needed);
+*   - a Dreame/robot map → the cloud/OSS map-image URL (or an addon
+*     data-plane URL serving the rendered map bytes), exposed as its own
+*     Image child device grouped under the robot's container.
+* The slice carries that URL plus the upstream last-updated timestamp; the
+* image changes when the source's last-updated marker changes.
 */
 var ImageStatusSchema = object({
 	/** Absolute signed URL the browser loads directly. Null when the
@@ -10106,18 +10120,47 @@ var imageCapability = {
 	*/
 	runtimeState: ImageStatusSchema
 };
+/**
+* Robotic lawn-mower cap. Models HA `lawn_mower.*` entities — anything
+* with a mowing lifecycle plus a dock action.
+*
+* Activity follows HA's canonical lawn-mower lifecycle: `idle` /
+* `mowing` / `paused` / `docked` / `error`. `batteryLevel` (0..100) is
+* nullable — some mowers don't report a battery percentage.
+*
+* `startMowing` begins a mowing run, `pause` halts it in place, and
+* `dock` sends the mower back to its charging station.
+*/
+var LawnMowerActivitySchema = _enum([
+	"idle",
+	"mowing",
+	"paused",
+	"docked",
+	"error"
+]);
+/** Severity of the current device/error code — info (status), warning, error. */
+var DeviceCodeSeveritySchema = _enum([
+	"info",
+	"warning",
+	"error"
+]);
 var LawnMowerControlStatusSchema = object({
 	/** Lifecycle activity of the mower. */
-	activity: _enum([
-		"idle",
-		"mowing",
-		"paused",
-		"docked",
-		"error"
-	]),
+	activity: LawnMowerActivitySchema,
 	/** 0..100 battery percentage. Null when the device has no battery
 	*  reading. */
 	batteryLevel: number().min(0).max(100).nullable(),
+	/** 0..100 mowing-completion percentage of the current task, or null when no
+	*  task is active / progress is unavailable. */
+	progressPercent: number().min(0).max(100).nullable(),
+	/** Current device/event code (dynamic — mostly status, sometimes an error),
+	*  or null when unknown. */
+	currentCode: number().nullable(),
+	/** Human label for {@link currentCode}, or null when undecodable. */
+	currentCodeLabel: string().nullable(),
+	/** Severity of {@link currentCode}. `error` (and often `warning`) warrants UI
+	*  attention; `info` is normal status. */
+	severity: DeviceCodeSeveritySchema,
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -12343,6 +12386,7 @@ var VacuumStateSchema = _enum([
 	"paused",
 	"returning",
 	"docked",
+	"drying",
 	"error"
 ]);
 /**
@@ -12381,6 +12425,12 @@ var VacuumControlStatusSchema = object({
 	detergent: TankStatusSchema.nullable(),
 	/** Dust bin. Null when the hardware has no dust bin. */
 	dustBin: TankStatusSchema.nullable(),
+	/** 0..100 cleaning-completion percentage of the current task, or null. */
+	progressPercent: number().min(0).max(100).nullable(),
+	/** Current error code (0 / null = no error). */
+	errorCode: number().nullable(),
+	/** Human label for {@link errorCode}, or null when none / undecodable. */
+	errorLabel: string().nullable(),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -16896,6 +16946,9 @@ method(object({
 }), method(ReleaseInputSchema.extend({ addonId: string() }), _void(), {
 	kind: "mutation",
 	auth: "admin"
+}), method(ResyncInputSchema, ResyncResultSchema, {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	deviceId: number(),
 	key: string(),
@@ -20658,6 +20711,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.adoptionResync": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.allocateDeviceId": {
 		capName: "device-manager",
 		capScope: "system",
@@ -44566,7 +44625,8 @@ function classifyKey(key) {
 	const hex = lookupHexId(key);
 	if (hex !== void 0) return {
 		kind: "measurement",
-		quantity: hex.quantity
+		quantity: hex.quantity,
+		name: hex.name
 	};
 	const named = Object.prototype.hasOwnProperty.call(NAMED_QUANTITY, key) ? NAMED_QUANTITY[key] : void 0;
 	if (named !== void 0) return {
@@ -44602,6 +44662,7 @@ var Station = class {
 				...owner !== void 0 ? { hardwareId: owner } : {},
 				...info?.model ? { model: info.model } : {},
 				...info?.channel !== void 0 ? { channel: info.channel } : {},
+				...cls.name !== void 0 ? { name: cls.name } : {},
 				quantity: cls.quantity,
 				value: r.value,
 				unit: r.unit,
@@ -44635,6 +44696,7 @@ var Station = class {
 			this.upsert(id, {
 				id,
 				...r.channel !== void 0 ? { channel: r.channel } : {},
+				...cls.name !== void 0 ? { name: cls.name } : {},
 				quantity: cls.quantity,
 				value: r.value,
 				unit: r.unit,
@@ -45598,27 +45660,46 @@ function buildEcowittBrokerProvider(deps) {
 //#endregion
 //#region src/ecowitt-mapping.ts
 /**
-* Map an Ecowitt quantity to its camstack typed sensor cap. Pure, total.
+* Map an Ecowitt quantity to its camstack sensor cap. Pure, total.
 *
-* Accepts a plain `string` (not just the {@link Quantity} union) so a persisted
-* config value flows through without a cast — any unrecognised string falls to
-* `numeric-sensor`, which is the same safe default the union's tail uses.
+* Only temperature/humidity/pressure get a dedicated typed cap (the thermostat
+* surface consumes them); every other quantity rides `numeric-sensor` and is
+* typed by its {@link roleForQuantity} role instead. Accepts a plain `string`
+* so a persisted config value flows through without a cast — any unrecognised
+* string falls to `numeric-sensor`, the same safe default the tail uses.
 */
 function capForQuantity(quantity) {
 	switch (quantity) {
 		case "temperature": return "temperature-sensor";
 		case "humidity": return "humidity-sensor";
 		case "pressure": return "pressure-sensor";
-		case "irradiance": return "ambient-light-sensor";
-		case "uv":
+		default: return "numeric-sensor";
+	}
+}
+/**
+* Map an Ecowitt quantity to the semantic {@link DeviceRole} that drives the
+* child's icon/label (and, in future, its canonical unit). Pure, total — an
+* unrecognised quantity falls to {@link DeviceRole.NumericSensor}.
+*
+* This is where weather metrics get their typing: wind/rain/uv/irradiance ride
+* the generic `numeric-sensor` cap but carry a typed role, so the UI renders a
+* wind / rain / UV / solar glyph instead of a bare hash.
+*/
+function roleForQuantity(quantity) {
+	switch (quantity) {
+		case "temperature": return DeviceRole.TemperatureSensor;
+		case "humidity": return DeviceRole.HumiditySensor;
+		case "pressure": return DeviceRole.PressureSensor;
 		case "wind_speed":
-		case "wind_direction":
+		case "wind_direction": return DeviceRole.WindSensor;
 		case "precipitation":
-		case "precipitation_rate":
+		case "precipitation_rate": return DeviceRole.RainSensor;
+		case "uv": return DeviceRole.UvSensor;
+		case "irradiance": return DeviceRole.SolarRadiationSensor;
 		case "lightning_distance":
 		case "lightning_count":
-		case "vpd": return "numeric-sensor";
-		default: return "numeric-sensor";
+		case "vpd": return DeviceRole.NumericSensor;
+		default: return DeviceRole.NumericSensor;
 	}
 }
 /**
@@ -45641,15 +45722,18 @@ function valueFieldForCap(cap) {
 	}
 }
 /**
-* Build a human label for a sensor from its quantity + optional channel.
-* `temperature` + channel 2 → `Temperature CH2`; channel-less → `Temperature`.
+* Build a human label for a sensor. Prefers the SPECIFIC measurement `name` when
+* the library resolved one (e.g. "Outdoor Temperature", "Dewpoint Temperature",
+* "Wind Gust") so same-quantity sensors are distinguishable; otherwise falls back
+* to the quantity label. A channel suffix is appended when present
+* (`temperature` + channel 2 → `Temperature CH2`).
 *
 * Accepts a plain `string` (not just {@link Quantity}) so a persisted config
 * value flows through without a cast; an unknown quantity falls back to its raw
 * string label.
 */
-function sensorLabel(quantity, channel) {
-	const base = isKnownQuantity(quantity) ? QUANTITY_LABEL[quantity] : quantity;
+function sensorLabel(quantity, channel, name) {
+	const base = name !== void 0 && name.length > 0 ? name : isKnownQuantity(quantity) ? QUANTITY_LABEL[quantity] : quantity;
 	return channel !== void 0 ? `${base} CH${channel}` : base;
 }
 /** Type guard: is `q` one of the known {@link Quantity} union members? */
@@ -45683,7 +45767,7 @@ var QUANTITY_LABEL = {
 function buildEcowittGatewayCandidate(input) {
 	const children = input.sensors.map((sensor) => ({
 		childNativeId: sensor.id,
-		name: sensorLabel(sensor.quantity, sensor.channel),
+		name: sensorLabel(sensor.quantity, sensor.channel, sensor.name),
 		type: DeviceType.Sensor,
 		status: "online",
 		metadata: sensor.model !== void 0 ? { model: sensor.model } : {},
@@ -46158,7 +46242,8 @@ function clampForCap(cap, value) {
 var ecowittSensorEntrySchema = object({
 	sensorId: string(),
 	quantity: string(),
-	channel: number().optional()
+	channel: number().optional(),
+	name: string().optional()
 });
 /**
 * Persisted config for an Ecowitt gateway Container. `brokerId` selects the
@@ -46200,7 +46285,8 @@ var EcowittContainerDevice = class extends BaseDevice {
 		return this.config.values.sensors.map((sensor) => {
 			const meta = {
 				type: DeviceType.Sensor,
-				name: sensorLabel(sensor.quantity, sensor.channel),
+				role: roleForQuantity(sensor.quantity),
+				name: sensorLabel(sensor.quantity, sensor.channel, sensor.name),
 				linkDeviceId: this.id,
 				...this.integrationId !== void 0 ? { integrationId: this.integrationId } : {}
 			};
@@ -46355,7 +46441,8 @@ var EcowittProviderAddon = class extends BaseDeviceProvider {
 			const nextSensors = sensors.map((s) => ({
 				sensorId: s.id,
 				quantity: s.quantity,
-				...s.channel !== void 0 ? { channel: s.channel } : {}
+				...s.channel !== void 0 ? { channel: s.channel } : {},
+				...s.name !== void 0 ? { name: s.name } : {}
 			}));
 			const cfg = await devices.loadConfig(containerId).catch(() => ({}));
 			if (sensorsEqual(Array.isArray(cfg["sensors"]) ? cfg["sensors"] : [], nextSensors)) return;
@@ -46476,7 +46563,8 @@ var EcowittProviderAddon = class extends BaseDeviceProvider {
 					sensors: ecowittFacades.getSensors(brokerId).map((s) => ({
 						sensorId: s.id,
 						quantity: s.quantity,
-						...s.channel !== void 0 ? { channel: s.channel } : {}
+						...s.channel !== void 0 ? { channel: s.channel } : {},
+						...s.name !== void 0 ? { name: s.name } : {}
 					})),
 					system: "ecowitt",
 					integrationId,
@@ -46544,12 +46632,18 @@ var EcowittProviderAddon = class extends BaseDeviceProvider {
 /** Structural equality of two persisted sensor lists (order-independent by id). */
 function sensorsEqual(a, b) {
 	if (a.length !== b.length) return false;
-	const aIds = /* @__PURE__ */ new Set();
+	const aById = /* @__PURE__ */ new Map();
 	for (const entry of a) if (typeof entry === "object" && entry !== null && "sensorId" in entry) {
 		const id = entry.sensorId;
-		if (typeof id === "string") aIds.add(id);
+		if (typeof id === "string") {
+			const name = "name" in entry && typeof entry.name === "string" ? entry.name : void 0;
+			aById.set(id, name);
+		}
+	}
+	for (const entry of b) {
+		if (!aById.has(entry.sensorId)) return false;
+		if (aById.get(entry.sensorId) !== entry.name) return false;
 	}
-	for (const entry of b) if (!aIds.has(entry.sensorId)) return false;
 	return true;
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-ecowitt",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Ecowitt weather-station device-provider addon for CamStack — wraps the @apocaliss92/nodewitt local-poll / push client",
   "keywords": [
     "camstack",
@@ -71,7 +71,7 @@
     "publish": "npm publish --access public"
   },
   "devDependencies": {
-    "@apocaliss92/nodewitt": "^1.1.1",
+    "@apocaliss92/nodewitt": "^1.2.0",
     "@camstack/types": "*",
     "typescript": "~6.0.3",
     "vite": "^8.0.11",