@camstack/addon-provider-ecowitt 0.1.6 → 0.1.7

package/dist/addon.js

@@ -13396,9 +13396,29 @@ var BaseDevice = class {
 	* is open (Reolink writes `hasPtz/hasIntercom`, Hikvision writes
 	* `hasSupplementalLight/hasAlarmIo`, etc).
 	*
-	* Default: no-op (driver had no probe to run).
-	*/
-	async onProbe() {}
+	* Default: nothing to probe → mark the device PROBED (set `lastProbedAt`) so
+	* the kernel treats it as ready immediately. A device that derives its shape
+	* from a spec (a container, or an accessory sensor) rather than from a
+	* hardware probe has no probe to "complete"; without stamping `lastProbedAt`
+	* it would look perpetually un-probed — logging "Initial probe did not
+	* complete" on every boot and spinning a pointless retry chain. Drivers that
+	* DO probe override this and write their own `feature-probe` slice (including
+	* `lastProbedAt`) once their probe actually succeeds.
+	*/
+	async onProbe() {
+		const base = this.runtimeState.getCapState("feature-probe") ?? {
+			flags: {},
+			deviceType: null,
+			model: null,
+			channelCount: null,
+			lastProbedAt: 0,
+			lastFetchedAt: 0
+		};
+		this.runtimeState.setCapState("feature-probe", {
+			...base,
+			lastProbedAt: Date.now()
+		});
+	}
 	/**
 	* Phase 5 — fired after the device + its accessories are registered.
 	* Drivers publish streams to the broker, kick off background tasks,
@@ -14860,17 +14880,32 @@ var ReleaseInputSchema = object({
 	*  the parent cascades into every accessory. */
 	camDeviceId: number().int().nonnegative()
 });
-var ResyncInputSchema = object({ 
-/** Parent CamStack device id of an adopted device. The provider resolves its
-*  source (integration/broker + native id) and re-aligns the device's
-*  structural spec (type/role/capabilities/units) with the live mapping,
-*  rebuilding any child whose class changed while preserving operator edits. */
-camDeviceId: number().int().nonnegative() });
+var ResyncInputSchema = object({
+	/** Parent CamStack device id of an adopted device. The provider resolves its
+	*  source (integration/broker + native id) and re-aligns the device's
+	*  structural spec (type/role/capabilities/units) with the live mapping,
+	*  rebuilding any child whose class changed while preserving operator edits. */
+	camDeviceId: number().int().nonnegative(),
+	/** "Resync from zero" (#19). When true, the kernel PURGES every accessory
+	*  child of `camDeviceId` BEFORE the provider re-derives the device, so the
+	*  children are rebuilt fresh from source — correct names, coords, and units —
+	*  instead of being preserved by the incremental reconcile. Use to recover from
+	*  legacy generic/placeholder names that the normal name-precedence keeps frozen
+	*  (the operator's explicit reset). Push-driven integrations (no-op resync)
+	*  rebuild on their next snapshot; pull/command integrations rebuild in `resync`.
+	*  Operator edits on the PARENT (its name, layout, primary-child pick) survive —
+	*  only the children are torn down. Omitted/false ⇒ the normal incremental
+	*  re-sync that preserves children. */
+	resetToSource: boolean().optional()
+});
 var ResyncResultSchema = object({
 	/** True when the persisted spec actually changed (children may have been rebuilt). */
 	changed: boolean(),
 	/** Number of child devices rebuilt into a new class by this re-sync. */
-	rebuiltChildren: number().int().nonnegative()
+	rebuiltChildren: number().int().nonnegative(),
+	/** Number of accessory children torn down by a `resetToSource` purge before the
+	*  provider re-derived the device. 0/absent for a normal incremental re-sync. */
+	removedChildren: number().int().nonnegative().optional()
 });
 var deviceAdoptionCapability = {
 	name: "device-adoption",
@@ -16635,6 +16670,11 @@ var DeviceMetaSchema = object({
 	addonId: string(),
 	type: string(),
 	name: string(),
+	/** True once an operator explicitly renamed the device via `setName`. Drives
+	*  reconcile name-precedence (preserve operator name vs adopt fresh provider
+	*  name). Absent ⇒ treated as user-named (PRESERVE) for legacy rows. See
+	*  `DeviceMeta.userNamed`. */
+	userNamed: boolean().optional(),
 	location: string().nullable(),
 	disabled: boolean(),
 	parentDeviceId: number().nullable(),
@@ -45721,20 +45761,84 @@ function valueFieldForCap(cap) {
 	}
 }
 /**
-* 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`).
+* Build a human label for a sensor. The label is resolved in priority order so
+* SAME-QUANTITY sensors are always distinguishable:
+*
+*   1. The SPECIFIC measurement `name` the library resolved from its hex-id
+*      table (e.g. "Outdoor Temperature", "Wind Gust") — present for the poll /
+*      hex-id path.
+*   2. A specific name derived from the raw gateway FIELD KEY (e.g. `dailyrainin`
+*      → "Daily Rain", `tempinf` → "Indoor Temperature") — covers the push /
+*      named-and-pattern-key path where the library leaves `name` absent and
+*      every same-quantity reading would otherwise collapse to one generic
+*      label (five rain readings all "Precipitation", indoor+outdoor temp both
+*      "Temperature", etc.). See {@link FIELD_KEY_LABEL}.
+*   3. The generic quantity label as a last resort.
 *
-* 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.
+* A channel suffix is appended when present (`temperature` + channel 2 →
+* `Temperature CH2`).
+*
+* `quantity`/`name` accept 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. `sensorId` is the nodewitt `Sensor.id`
+* (`<owner>:<key>` or `<owner>:ch<n>:<key>`); the field key is its final
+* colon-segment.
 */
-function sensorLabel(quantity, channel, name) {
-	const base = name !== void 0 && name.length > 0 ? name : isKnownQuantity(quantity) ? QUANTITY_LABEL[quantity] : quantity;
+function sensorLabel(quantity, channel, name, sensorId) {
+	const base = labelFromFieldKey(sensorId) ?? (name !== void 0 && name.length > 0 ? name : isKnownQuantity(quantity) ? QUANTITY_LABEL[quantity] : quantity);
 	return channel !== void 0 ? `${base} CH${channel}` : base;
 }
+/**
+* Resolve a specific human label from a nodewitt sensor id by extracting its raw
+* gateway field key (the final colon-segment of `<owner>[:ch<n>]:<key>`) and
+* looking it up in {@link FIELD_KEY_LABEL}. Returns `undefined` when no id is
+* given or the key is unrecognised, so the caller falls through to the generic
+* quantity label.
+*/
+function labelFromFieldKey(sensorId) {
+	if (sensorId === void 0) return void 0;
+	const key = sensorId.slice(sensorId.lastIndexOf(":") + 1);
+	return Object.prototype.hasOwnProperty.call(FIELD_KEY_LABEL, key) ? FIELD_KEY_LABEL[key] : void 0;
+}
+/**
+* Specific human labels for the raw Ecowitt gateway field keys that the library
+* classifies via its named / pattern tables (the push path) and therefore leaves
+* WITHOUT a `name`. Mirrors the vocabulary the library's hex-id table already
+* uses for the poll path, so a station reached over either transport reads the
+* same. Channel-suffixed keys (`temp3f`, `humidity2`, …) are handled by the
+* `channel` argument and intentionally omitted here.
+*/
+var FIELD_KEY_LABEL = {
+	tempinf: "Indoor Temperature",
+	tempf: "Outdoor Temperature",
+	humidityin: "Indoor Humidity",
+	humidity: "Outdoor Humidity",
+	baromrelin: "Relative Pressure",
+	baromabsin: "Absolute Pressure",
+	windspeedmph: "Wind Speed",
+	windgustmph: "Wind Gust",
+	maxdailygust: "Max Daily Gust",
+	winddir: "Wind Direction",
+	solarradiation: "Solar Radiation",
+	uv: "UV Index",
+	lightning: "Lightning Distance",
+	lightning_num: "Lightning Count",
+	rainratein: "Rain Rate",
+	eventrainin: "Rain Event",
+	hourlyrainin: "Hourly Rain",
+	dailyrainin: "Daily Rain",
+	weeklyrainin: "Weekly Rain",
+	monthlyrainin: "Monthly Rain",
+	yearlyrainin: "Yearly Rain",
+	totalrainin: "Total Rain",
+	rrain_piezo: "Rain Rate",
+	erain_piezo: "Rain Event",
+	hrain_piezo: "Hourly Rain",
+	drain_piezo: "Daily Rain",
+	wrain_piezo: "Weekly Rain",
+	mrain_piezo: "Monthly Rain",
+	yrain_piezo: "Yearly Rain"
+};
 /** Type guard: is `q` one of the known {@link Quantity} union members? */
 function isKnownQuantity(q) {
 	return Object.prototype.hasOwnProperty.call(QUANTITY_LABEL, q);
@@ -45766,7 +45870,7 @@ var QUANTITY_LABEL = {
 function buildEcowittGatewayCandidate(input) {
 	const children = input.sensors.map((sensor) => ({
 		childNativeId: sensor.id,
-		name: sensorLabel(sensor.quantity, sensor.channel, sensor.name),
+		name: sensorLabel(sensor.quantity, sensor.channel, sensor.name, sensor.id),
 		type: DeviceType.Sensor,
 		status: "online",
 		metadata: sensor.model !== void 0 ? { model: sensor.model } : {},
@@ -46285,7 +46389,7 @@ var EcowittContainerDevice = class extends BaseDevice {
 			const meta = {
 				type: DeviceType.Sensor,
 				role: roleForQuantity(sensor.quantity),
-				name: sensorLabel(sensor.quantity, sensor.channel, sensor.name),
+				name: sensorLabel(sensor.quantity, sensor.channel, sensor.name, sensor.sensorId),
 				linkDeviceId: this.id,
 				...this.integrationId !== void 0 ? { integrationId: this.integrationId } : {}
 			};

package/dist/addon.mjs

@@ -13397,9 +13397,29 @@ var BaseDevice = class {
 	* is open (Reolink writes `hasPtz/hasIntercom`, Hikvision writes
 	* `hasSupplementalLight/hasAlarmIo`, etc).
 	*
-	* Default: no-op (driver had no probe to run).
-	*/
-	async onProbe() {}
+	* Default: nothing to probe → mark the device PROBED (set `lastProbedAt`) so
+	* the kernel treats it as ready immediately. A device that derives its shape
+	* from a spec (a container, or an accessory sensor) rather than from a
+	* hardware probe has no probe to "complete"; without stamping `lastProbedAt`
+	* it would look perpetually un-probed — logging "Initial probe did not
+	* complete" on every boot and spinning a pointless retry chain. Drivers that
+	* DO probe override this and write their own `feature-probe` slice (including
+	* `lastProbedAt`) once their probe actually succeeds.
+	*/
+	async onProbe() {
+		const base = this.runtimeState.getCapState("feature-probe") ?? {
+			flags: {},
+			deviceType: null,
+			model: null,
+			channelCount: null,
+			lastProbedAt: 0,
+			lastFetchedAt: 0
+		};
+		this.runtimeState.setCapState("feature-probe", {
+			...base,
+			lastProbedAt: Date.now()
+		});
+	}
 	/**
 	* Phase 5 — fired after the device + its accessories are registered.
 	* Drivers publish streams to the broker, kick off background tasks,
@@ -14861,17 +14881,32 @@ var ReleaseInputSchema = object({
 	*  the parent cascades into every accessory. */
 	camDeviceId: number().int().nonnegative()
 });
-var ResyncInputSchema = object({ 
-/** Parent CamStack device id of an adopted device. The provider resolves its
-*  source (integration/broker + native id) and re-aligns the device's
-*  structural spec (type/role/capabilities/units) with the live mapping,
-*  rebuilding any child whose class changed while preserving operator edits. */
-camDeviceId: number().int().nonnegative() });
+var ResyncInputSchema = object({
+	/** Parent CamStack device id of an adopted device. The provider resolves its
+	*  source (integration/broker + native id) and re-aligns the device's
+	*  structural spec (type/role/capabilities/units) with the live mapping,
+	*  rebuilding any child whose class changed while preserving operator edits. */
+	camDeviceId: number().int().nonnegative(),
+	/** "Resync from zero" (#19). When true, the kernel PURGES every accessory
+	*  child of `camDeviceId` BEFORE the provider re-derives the device, so the
+	*  children are rebuilt fresh from source — correct names, coords, and units —
+	*  instead of being preserved by the incremental reconcile. Use to recover from
+	*  legacy generic/placeholder names that the normal name-precedence keeps frozen
+	*  (the operator's explicit reset). Push-driven integrations (no-op resync)
+	*  rebuild on their next snapshot; pull/command integrations rebuild in `resync`.
+	*  Operator edits on the PARENT (its name, layout, primary-child pick) survive —
+	*  only the children are torn down. Omitted/false ⇒ the normal incremental
+	*  re-sync that preserves children. */
+	resetToSource: boolean().optional()
+});
 var ResyncResultSchema = object({
 	/** True when the persisted spec actually changed (children may have been rebuilt). */
 	changed: boolean(),
 	/** Number of child devices rebuilt into a new class by this re-sync. */
-	rebuiltChildren: number().int().nonnegative()
+	rebuiltChildren: number().int().nonnegative(),
+	/** Number of accessory children torn down by a `resetToSource` purge before the
+	*  provider re-derived the device. 0/absent for a normal incremental re-sync. */
+	removedChildren: number().int().nonnegative().optional()
 });
 var deviceAdoptionCapability = {
 	name: "device-adoption",
@@ -16636,6 +16671,11 @@ var DeviceMetaSchema = object({
 	addonId: string(),
 	type: string(),
 	name: string(),
+	/** True once an operator explicitly renamed the device via `setName`. Drives
+	*  reconcile name-precedence (preserve operator name vs adopt fresh provider
+	*  name). Absent ⇒ treated as user-named (PRESERVE) for legacy rows. See
+	*  `DeviceMeta.userNamed`. */
+	userNamed: boolean().optional(),
 	location: string().nullable(),
 	disabled: boolean(),
 	parentDeviceId: number().nullable(),
@@ -45722,20 +45762,84 @@ function valueFieldForCap(cap) {
 	}
 }
 /**
-* 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`).
+* Build a human label for a sensor. The label is resolved in priority order so
+* SAME-QUANTITY sensors are always distinguishable:
+*
+*   1. The SPECIFIC measurement `name` the library resolved from its hex-id
+*      table (e.g. "Outdoor Temperature", "Wind Gust") — present for the poll /
+*      hex-id path.
+*   2. A specific name derived from the raw gateway FIELD KEY (e.g. `dailyrainin`
+*      → "Daily Rain", `tempinf` → "Indoor Temperature") — covers the push /
+*      named-and-pattern-key path where the library leaves `name` absent and
+*      every same-quantity reading would otherwise collapse to one generic
+*      label (five rain readings all "Precipitation", indoor+outdoor temp both
+*      "Temperature", etc.). See {@link FIELD_KEY_LABEL}.
+*   3. The generic quantity label as a last resort.
 *
-* 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.
+* A channel suffix is appended when present (`temperature` + channel 2 →
+* `Temperature CH2`).
+*
+* `quantity`/`name` accept 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. `sensorId` is the nodewitt `Sensor.id`
+* (`<owner>:<key>` or `<owner>:ch<n>:<key>`); the field key is its final
+* colon-segment.
 */
-function sensorLabel(quantity, channel, name) {
-	const base = name !== void 0 && name.length > 0 ? name : isKnownQuantity(quantity) ? QUANTITY_LABEL[quantity] : quantity;
+function sensorLabel(quantity, channel, name, sensorId) {
+	const base = labelFromFieldKey(sensorId) ?? (name !== void 0 && name.length > 0 ? name : isKnownQuantity(quantity) ? QUANTITY_LABEL[quantity] : quantity);
 	return channel !== void 0 ? `${base} CH${channel}` : base;
 }
+/**
+* Resolve a specific human label from a nodewitt sensor id by extracting its raw
+* gateway field key (the final colon-segment of `<owner>[:ch<n>]:<key>`) and
+* looking it up in {@link FIELD_KEY_LABEL}. Returns `undefined` when no id is
+* given or the key is unrecognised, so the caller falls through to the generic
+* quantity label.
+*/
+function labelFromFieldKey(sensorId) {
+	if (sensorId === void 0) return void 0;
+	const key = sensorId.slice(sensorId.lastIndexOf(":") + 1);
+	return Object.prototype.hasOwnProperty.call(FIELD_KEY_LABEL, key) ? FIELD_KEY_LABEL[key] : void 0;
+}
+/**
+* Specific human labels for the raw Ecowitt gateway field keys that the library
+* classifies via its named / pattern tables (the push path) and therefore leaves
+* WITHOUT a `name`. Mirrors the vocabulary the library's hex-id table already
+* uses for the poll path, so a station reached over either transport reads the
+* same. Channel-suffixed keys (`temp3f`, `humidity2`, …) are handled by the
+* `channel` argument and intentionally omitted here.
+*/
+var FIELD_KEY_LABEL = {
+	tempinf: "Indoor Temperature",
+	tempf: "Outdoor Temperature",
+	humidityin: "Indoor Humidity",
+	humidity: "Outdoor Humidity",
+	baromrelin: "Relative Pressure",
+	baromabsin: "Absolute Pressure",
+	windspeedmph: "Wind Speed",
+	windgustmph: "Wind Gust",
+	maxdailygust: "Max Daily Gust",
+	winddir: "Wind Direction",
+	solarradiation: "Solar Radiation",
+	uv: "UV Index",
+	lightning: "Lightning Distance",
+	lightning_num: "Lightning Count",
+	rainratein: "Rain Rate",
+	eventrainin: "Rain Event",
+	hourlyrainin: "Hourly Rain",
+	dailyrainin: "Daily Rain",
+	weeklyrainin: "Weekly Rain",
+	monthlyrainin: "Monthly Rain",
+	yearlyrainin: "Yearly Rain",
+	totalrainin: "Total Rain",
+	rrain_piezo: "Rain Rate",
+	erain_piezo: "Rain Event",
+	hrain_piezo: "Hourly Rain",
+	drain_piezo: "Daily Rain",
+	wrain_piezo: "Weekly Rain",
+	mrain_piezo: "Monthly Rain",
+	yrain_piezo: "Yearly Rain"
+};
 /** Type guard: is `q` one of the known {@link Quantity} union members? */
 function isKnownQuantity(q) {
 	return Object.prototype.hasOwnProperty.call(QUANTITY_LABEL, q);
@@ -45767,7 +45871,7 @@ var QUANTITY_LABEL = {
 function buildEcowittGatewayCandidate(input) {
 	const children = input.sensors.map((sensor) => ({
 		childNativeId: sensor.id,
-		name: sensorLabel(sensor.quantity, sensor.channel, sensor.name),
+		name: sensorLabel(sensor.quantity, sensor.channel, sensor.name, sensor.id),
 		type: DeviceType.Sensor,
 		status: "online",
 		metadata: sensor.model !== void 0 ? { model: sensor.model } : {},
@@ -46286,7 +46390,7 @@ var EcowittContainerDevice = class extends BaseDevice {
 			const meta = {
 				type: DeviceType.Sensor,
 				role: roleForQuantity(sensor.quantity),
-				name: sensorLabel(sensor.quantity, sensor.channel, sensor.name),
+				name: sensorLabel(sensor.quantity, sensor.channel, sensor.name, sensor.sensorId),
 				linkDeviceId: this.id,
 				...this.integrationId !== void 0 ? { integrationId: this.integrationId } : {}
 			};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-ecowitt",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Ecowitt weather-station device-provider addon for CamStack — wraps the @apocaliss92/nodewitt local-poll / push client",
   "keywords": [
     "camstack",