@camstack/addon-provider-homematic 1.2.131 → 1.2.132

package/dist/addon.js

@@ -26173,11 +26173,14 @@ var HardwareClassIdSchema = _enum([
 	"intel-n-series",
 	"apple-m-base",
 	"apple-m-pro",
+	"amd-phoenix",
 	"unknown"
 ]);
 var AcceleratorKindSchema = _enum([
 	"intel-npu",
 	"intel-igpu",
+	"amd-igpu",
+	"amd-npu",
 	"x86-cpu",
 	"arm-cpu",
 	"apple-ane",
@@ -36795,7 +36798,13 @@ var TopologyNodeSchema = object({
 	})).readonly(),
 	processes: array(TopologyProcessSchema).readonly(),
 	categories: array(TopologyCategorySchema).readonly(),
-	rootPackage: TopologyRootPackageSchema.nullable()
+	rootPackage: TopologyRootPackageSchema.nullable(),
+	/**
+	* How an online AGENT reaches the hub (mesh mTLS Release A): `tls` once it has
+	* completed a mutual-TLS handshake, `clear` otherwise. Absent for the hub,
+	* for offline rows and when the hub cannot tell.
+	*/
+	meshTransport: _enum(["tls", "clear"]).optional()
 });
 var CapUsageEdgeSchema = object({
 	callerAddonId: string(),
@@ -37765,7 +37774,15 @@ var GpuInfoSchema = object({
 	name: string(),
 	memoryMB: number().optional()
 });
-var NpuInfoSchema = object({ type: _enum(["apple-ane", "intel-npu"]) });
+var NpuInfoSchema = object({
+	type: _enum([
+		"apple-ane",
+		"intel-npu",
+		"amd-xdna"
+	]),
+	name: string().optional(),
+	generation: _enum(["xdna1", "xdna2"]).optional()
+});
 var CoralInfoSchema = object({
 	type: literal("coral-edgetpu"),
 	bus: string().optional()
@@ -56693,6 +56710,8 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
+	[...RULE_TEXT],
+	[...RULE_TEXT],
 	([...RULE_TEXT], [...UPDATES]),
 	([...RULE_TEXT], [...PACKAGE_UPDATES]),
 	([...RULE_TEXT], [...PACKAGE_UPDATES]),
@@ -80251,6 +80270,19 @@ function sameConnection(a, b) {
 	return a.host === b.host && a.enableHmipRf === b.enableHmipRf && a.enableBidcosRf === b.enableBidcosRf && a.enableGroups === b.enableGroups && a.enableBidcosWired === b.enableBidcosWired && a.callbackHost === b.callbackHost && a.callbackPort === b.callbackPort && a.username === b.username && a.password === b.password && a.tls === b.tls;
 }
 /**
+* Delays (ms) between background restore retries after a failed
+* `facade.start()` (e.g. CCU `ECONNREFUSED`). Six attempts ≈ 2+5+10+20+30+60 s.
+* Exported for specs that drive the schedule with fake timers.
+*/
+var RESTORE_RETRY_DELAYS_MS = [
+	2e3,
+	5e3,
+	1e4,
+	2e4,
+	3e4,
+	6e4
+];
+/**
 * Manages N live CCU connections ("brokers"), each backed by an
 * {@link HmIntegrationManager}. Replaces the old single-CCU
 * `homematic-gateway.ts` singleton.
@@ -80296,6 +80328,10 @@ var HmBrokerRegistry = class {
 	* typically in tests) facade creation is skipped.
 	*/
 	#useDefaultFactory;
+	/** Pending restore-retry timers — cleared on {@link shutdown}. */
+	#retryTimers = /* @__PURE__ */ new Map();
+	/** True after {@link shutdown} — blocks further restore retries. */
+	#shuttingDown = false;
 	constructor(logger, deps = {}) {
 		this.#logger = logger;
 		this.#onBrokerConnected = deps.onBrokerConnected ?? (() => void 0);
@@ -80320,10 +80356,13 @@ var HmBrokerRegistry = class {
 	* Restore previously-persisted broker entries on addon boot.
 	*
 	* Seeds the id counter from existing ids so future allocations never
-	* collide. Starts each manager best-effort: a failed start is logged as a
-	* warning and the manager is still tracked (it can be retried later).
+	* collide. Starts each manager best-effort: a failed start is rolled back
+	* out of `#managers` (so a later attempt can rebuild) and scheduled for a
+	* bounded background retry — a transient CCU `ECONNREFUSED` must not leave
+	* the broker dead until an operator restarts the addon.
 	*/
 	async restore(entries) {
+		this.#shuttingDown = false;
 		for (const entry of entries) this.#seedCounter(entry.id);
 		for (const entry of entries) try {
 			await this.#startManager(entry);
@@ -80333,6 +80372,7 @@ var HmBrokerRegistry = class {
 				tags: { brokerId: entry.id },
 				meta: { error: msg }
 			});
+			this.#scheduleRestoreRetry(entry, 0);
 		}
 	}
 	/**
@@ -80340,6 +80380,9 @@ var HmBrokerRegistry = class {
 	* shutdown.
 	*/
 	async shutdown() {
+		this.#shuttingDown = true;
+		for (const timer of this.#retryTimers.values()) clearTimeout(timer);
+		this.#retryTimers.clear();
 		const ids = Array.from(this.#managers.keys());
 		await Promise.all(ids.map(async (id) => {
 			const mgr = this.#managers.get(id);
@@ -80531,6 +80574,10 @@ var HmBrokerRegistry = class {
 	* Build (via the factory), register, and start the manager for one entry.
 	* If a manager for the same id already exists (e.g. a duplicate restore
 	* call), skip construction and only re-index the integration FK.
+	*
+	* On `start()` failure the half-built manager is abandoned so a retry can
+	* construct a fresh one — leaving it in `#managers` used to make every
+	* subsequent `#startManager` a no-op.
 	*/
 	async #startManager(entry) {
 		if (this.#managers.has(entry.id)) {
@@ -80547,13 +80594,92 @@ var HmBrokerRegistry = class {
 		});
 		this.#managers.set(entry.id, mgr);
 		if (entry.integrationId !== void 0) this.#integrationToBroker.set(entry.integrationId, entry.id);
-		await mgr.start();
+		try {
+			await mgr.start();
+		} catch (err) {
+			await this.#abandonFailedStart(entry.id, mgr);
+			throw err;
+		}
+		const pending = this.#retryTimers.get(entry.id);
+		if (pending !== void 0) {
+			clearTimeout(pending);
+			this.#retryTimers.delete(entry.id);
+		}
 		this.#logger.info("HmBrokerRegistry: manager started", {
 			tags: { brokerId: entry.id },
 			meta: { name: entry.name }
 		});
 	}
 	/**
+	* Drop a manager that never reached `connected` so a later attempt can
+	* rebuild it. Best-effort `stop()`; never throws.
+	*/
+	async #abandonFailedStart(id, mgr) {
+		this.#managers.delete(id);
+		this.#facades.delete(id);
+		homematicFacades.set(id, null);
+		try {
+			await mgr.stop();
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			this.#logger.debug("HmBrokerRegistry: abandon stop failed", {
+				tags: { brokerId: id },
+				meta: { error: msg }
+			});
+		}
+	}
+	/**
+	* Schedule attempt `attemptIndex` of {@link RESTORE_RETRY_DELAYS_MS} for
+	* `entry`. No-ops when the registry is shutting down or the schedule is
+	* exhausted (warns once at the end).
+	*/
+	#scheduleRestoreRetry(entry, attemptIndex) {
+		if (this.#shuttingDown) return;
+		const delay = RESTORE_RETRY_DELAYS_MS[attemptIndex];
+		if (delay === void 0) {
+			this.#logger.warn("HmBrokerRegistry: restore retries exhausted", {
+				tags: { brokerId: entry.id },
+				meta: { attempts: RESTORE_RETRY_DELAYS_MS.length }
+			});
+			return;
+		}
+		const existing = this.#retryTimers.get(entry.id);
+		if (existing !== void 0) clearTimeout(existing);
+		const timer = setTimeout(() => {
+			this.#retryTimers.delete(entry.id);
+			this.#runRestoreRetry(entry, attemptIndex);
+		}, delay);
+		this.#retryTimers.set(entry.id, timer);
+		this.#logger.info("HmBrokerRegistry: scheduling restore retry", {
+			tags: { brokerId: entry.id },
+			meta: {
+				attempt: attemptIndex + 1,
+				delayMs: delay
+			}
+		});
+	}
+	async #runRestoreRetry(entry, attemptIndex) {
+		if (this.#shuttingDown) return;
+		if (this.#managers.has(entry.id)) return;
+		try {
+			await this.#startManager(entry);
+			this.#logger.info("HmBrokerRegistry: restore retry succeeded", {
+				tags: { brokerId: entry.id },
+				meta: { attempt: attemptIndex + 1 }
+			});
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			this.#logger.warn("HmBrokerRegistry: restore retry failed", {
+				tags: { brokerId: entry.id },
+				meta: {
+					attempt: attemptIndex + 1,
+					error: msg
+				}
+			});
+			this.#scheduleRestoreRetry(entry, attemptIndex + 1);
+		}
+	}
+	/**
 	* Allocate the next monotonic id in the `hm_NNN` sequence and advance
 	* the counter.
 	*/
@@ -83010,6 +83136,19 @@ var HmContainerDevice = class HmContainerDevice extends BaseDevice {
 		}
 	}
 	/**
+	* Stamp `feature-probe.lastProbedAt` only when the CCU device is on the
+	* facade. An empty accessory-spec list + a stamped probe is how the kernel
+	* orphan-prunes linked children (`device-cap-proxy` safety gate): a restore
+	* that races a CCU `ECONNREFUSED` used to delete every accessory and fence
+	* their identities for 5 minutes. Leaving `lastProbedAt === 0` until the
+	* device is present keeps the gate closed; `reprobe()` on broker connect
+	* completes the probe and spawns/reconciles children for real.
+	*/
+	async onProbe() {
+		if (this.resolveHmDevice() === null) return;
+		await super.onProbe();
+	}
+	/**
 	* Derive the accessory children LIVE from the facade descriptor. Each child
 	* is a {@link HmEntitySpec} (the shared per-entity decomposition) wrapped into
 	* an `AccessoryChildSpec`: the `stableIdSuffix` IS the spec `key`, the broker
@@ -83149,6 +83288,7 @@ var HomematicProviderAddon = class extends BaseDeviceProvider {
 		this.registry.setOnBrokerConnected((brokerId) => {
 			this.ctx.logger.info("Homematic: broker connected", { meta: { brokerId } });
 			this.setBrokerDevicesOnline(brokerId, true);
+			this.reprobeBrokerContainers(brokerId);
 		});
 		this.registry.setOnBrokerDisconnected((brokerId) => {
 			this.setBrokerDevicesOnline(brokerId, false);
@@ -83543,6 +83683,28 @@ var HomematicProviderAddon = class extends BaseDeviceProvider {
 			count: n
 		} });
 	}
+	/**
+	* Reprobe every adopted {@link HmContainerDevice} for `brokerId` so the
+	* kernel re-runs accessory reconcile against the live facade. Best-effort:
+	* one container's failure must not block the rest (same discipline as HA's
+	* post-connect reconcile).
+	*/
+	async reprobeBrokerContainers(brokerId) {
+		const reg = this.ctx.kernel.deviceRegistry;
+		if (!reg) return;
+		const containers = reg.getAllForAddon(this.addonId).filter((d) => d instanceof HmContainerDevice && d.config.get("brokerId") === brokerId);
+		for (const container of containers) try {
+			await container.reprobe();
+		} catch (err) {
+			this.ctx.logger.warn("Homematic: container reprobe failed", {
+				tags: { deviceId: container.id },
+				meta: {
+					brokerId,
+					error: errMsg(err)
+				}
+			});
+		}
+	}
 	/** Return the live registry or throw if the addon is not initialised. */
 	requireRegistry() {
 		if (!this.registry) throw new Error("Homematic provider not initialised");

package/dist/addon.mjs

@@ -26174,11 +26174,14 @@ var HardwareClassIdSchema = _enum([
 	"intel-n-series",
 	"apple-m-base",
 	"apple-m-pro",
+	"amd-phoenix",
 	"unknown"
 ]);
 var AcceleratorKindSchema = _enum([
 	"intel-npu",
 	"intel-igpu",
+	"amd-igpu",
+	"amd-npu",
 	"x86-cpu",
 	"arm-cpu",
 	"apple-ane",
@@ -36796,7 +36799,13 @@ var TopologyNodeSchema = object({
 	})).readonly(),
 	processes: array(TopologyProcessSchema).readonly(),
 	categories: array(TopologyCategorySchema).readonly(),
-	rootPackage: TopologyRootPackageSchema.nullable()
+	rootPackage: TopologyRootPackageSchema.nullable(),
+	/**
+	* How an online AGENT reaches the hub (mesh mTLS Release A): `tls` once it has
+	* completed a mutual-TLS handshake, `clear` otherwise. Absent for the hub,
+	* for offline rows and when the hub cannot tell.
+	*/
+	meshTransport: _enum(["tls", "clear"]).optional()
 });
 var CapUsageEdgeSchema = object({
 	callerAddonId: string(),
@@ -37766,7 +37775,15 @@ var GpuInfoSchema = object({
 	name: string(),
 	memoryMB: number().optional()
 });
-var NpuInfoSchema = object({ type: _enum(["apple-ane", "intel-npu"]) });
+var NpuInfoSchema = object({
+	type: _enum([
+		"apple-ane",
+		"intel-npu",
+		"amd-xdna"
+	]),
+	name: string().optional(),
+	generation: _enum(["xdna1", "xdna2"]).optional()
+});
 var CoralInfoSchema = object({
 	type: literal("coral-edgetpu"),
 	bus: string().optional()
@@ -56694,6 +56711,8 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
+	[...RULE_TEXT],
+	[...RULE_TEXT],
 	([...RULE_TEXT], [...UPDATES]),
 	([...RULE_TEXT], [...PACKAGE_UPDATES]),
 	([...RULE_TEXT], [...PACKAGE_UPDATES]),
@@ -80252,6 +80271,19 @@ function sameConnection(a, b) {
 	return a.host === b.host && a.enableHmipRf === b.enableHmipRf && a.enableBidcosRf === b.enableBidcosRf && a.enableGroups === b.enableGroups && a.enableBidcosWired === b.enableBidcosWired && a.callbackHost === b.callbackHost && a.callbackPort === b.callbackPort && a.username === b.username && a.password === b.password && a.tls === b.tls;
 }
 /**
+* Delays (ms) between background restore retries after a failed
+* `facade.start()` (e.g. CCU `ECONNREFUSED`). Six attempts ≈ 2+5+10+20+30+60 s.
+* Exported for specs that drive the schedule with fake timers.
+*/
+var RESTORE_RETRY_DELAYS_MS = [
+	2e3,
+	5e3,
+	1e4,
+	2e4,
+	3e4,
+	6e4
+];
+/**
 * Manages N live CCU connections ("brokers"), each backed by an
 * {@link HmIntegrationManager}. Replaces the old single-CCU
 * `homematic-gateway.ts` singleton.
@@ -80297,6 +80329,10 @@ var HmBrokerRegistry = class {
 	* typically in tests) facade creation is skipped.
 	*/
 	#useDefaultFactory;
+	/** Pending restore-retry timers — cleared on {@link shutdown}. */
+	#retryTimers = /* @__PURE__ */ new Map();
+	/** True after {@link shutdown} — blocks further restore retries. */
+	#shuttingDown = false;
 	constructor(logger, deps = {}) {
 		this.#logger = logger;
 		this.#onBrokerConnected = deps.onBrokerConnected ?? (() => void 0);
@@ -80321,10 +80357,13 @@ var HmBrokerRegistry = class {
 	* Restore previously-persisted broker entries on addon boot.
 	*
 	* Seeds the id counter from existing ids so future allocations never
-	* collide. Starts each manager best-effort: a failed start is logged as a
-	* warning and the manager is still tracked (it can be retried later).
+	* collide. Starts each manager best-effort: a failed start is rolled back
+	* out of `#managers` (so a later attempt can rebuild) and scheduled for a
+	* bounded background retry — a transient CCU `ECONNREFUSED` must not leave
+	* the broker dead until an operator restarts the addon.
 	*/
 	async restore(entries) {
+		this.#shuttingDown = false;
 		for (const entry of entries) this.#seedCounter(entry.id);
 		for (const entry of entries) try {
 			await this.#startManager(entry);
@@ -80334,6 +80373,7 @@ var HmBrokerRegistry = class {
 				tags: { brokerId: entry.id },
 				meta: { error: msg }
 			});
+			this.#scheduleRestoreRetry(entry, 0);
 		}
 	}
 	/**
@@ -80341,6 +80381,9 @@ var HmBrokerRegistry = class {
 	* shutdown.
 	*/
 	async shutdown() {
+		this.#shuttingDown = true;
+		for (const timer of this.#retryTimers.values()) clearTimeout(timer);
+		this.#retryTimers.clear();
 		const ids = Array.from(this.#managers.keys());
 		await Promise.all(ids.map(async (id) => {
 			const mgr = this.#managers.get(id);
@@ -80532,6 +80575,10 @@ var HmBrokerRegistry = class {
 	* Build (via the factory), register, and start the manager for one entry.
 	* If a manager for the same id already exists (e.g. a duplicate restore
 	* call), skip construction and only re-index the integration FK.
+	*
+	* On `start()` failure the half-built manager is abandoned so a retry can
+	* construct a fresh one — leaving it in `#managers` used to make every
+	* subsequent `#startManager` a no-op.
 	*/
 	async #startManager(entry) {
 		if (this.#managers.has(entry.id)) {
@@ -80548,13 +80595,92 @@ var HmBrokerRegistry = class {
 		});
 		this.#managers.set(entry.id, mgr);
 		if (entry.integrationId !== void 0) this.#integrationToBroker.set(entry.integrationId, entry.id);
-		await mgr.start();
+		try {
+			await mgr.start();
+		} catch (err) {
+			await this.#abandonFailedStart(entry.id, mgr);
+			throw err;
+		}
+		const pending = this.#retryTimers.get(entry.id);
+		if (pending !== void 0) {
+			clearTimeout(pending);
+			this.#retryTimers.delete(entry.id);
+		}
 		this.#logger.info("HmBrokerRegistry: manager started", {
 			tags: { brokerId: entry.id },
 			meta: { name: entry.name }
 		});
 	}
 	/**
+	* Drop a manager that never reached `connected` so a later attempt can
+	* rebuild it. Best-effort `stop()`; never throws.
+	*/
+	async #abandonFailedStart(id, mgr) {
+		this.#managers.delete(id);
+		this.#facades.delete(id);
+		homematicFacades.set(id, null);
+		try {
+			await mgr.stop();
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			this.#logger.debug("HmBrokerRegistry: abandon stop failed", {
+				tags: { brokerId: id },
+				meta: { error: msg }
+			});
+		}
+	}
+	/**
+	* Schedule attempt `attemptIndex` of {@link RESTORE_RETRY_DELAYS_MS} for
+	* `entry`. No-ops when the registry is shutting down or the schedule is
+	* exhausted (warns once at the end).
+	*/
+	#scheduleRestoreRetry(entry, attemptIndex) {
+		if (this.#shuttingDown) return;
+		const delay = RESTORE_RETRY_DELAYS_MS[attemptIndex];
+		if (delay === void 0) {
+			this.#logger.warn("HmBrokerRegistry: restore retries exhausted", {
+				tags: { brokerId: entry.id },
+				meta: { attempts: RESTORE_RETRY_DELAYS_MS.length }
+			});
+			return;
+		}
+		const existing = this.#retryTimers.get(entry.id);
+		if (existing !== void 0) clearTimeout(existing);
+		const timer = setTimeout(() => {
+			this.#retryTimers.delete(entry.id);
+			this.#runRestoreRetry(entry, attemptIndex);
+		}, delay);
+		this.#retryTimers.set(entry.id, timer);
+		this.#logger.info("HmBrokerRegistry: scheduling restore retry", {
+			tags: { brokerId: entry.id },
+			meta: {
+				attempt: attemptIndex + 1,
+				delayMs: delay
+			}
+		});
+	}
+	async #runRestoreRetry(entry, attemptIndex) {
+		if (this.#shuttingDown) return;
+		if (this.#managers.has(entry.id)) return;
+		try {
+			await this.#startManager(entry);
+			this.#logger.info("HmBrokerRegistry: restore retry succeeded", {
+				tags: { brokerId: entry.id },
+				meta: { attempt: attemptIndex + 1 }
+			});
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			this.#logger.warn("HmBrokerRegistry: restore retry failed", {
+				tags: { brokerId: entry.id },
+				meta: {
+					attempt: attemptIndex + 1,
+					error: msg
+				}
+			});
+			this.#scheduleRestoreRetry(entry, attemptIndex + 1);
+		}
+	}
+	/**
 	* Allocate the next monotonic id in the `hm_NNN` sequence and advance
 	* the counter.
 	*/
@@ -83011,6 +83137,19 @@ var HmContainerDevice = class HmContainerDevice extends BaseDevice {
 		}
 	}
 	/**
+	* Stamp `feature-probe.lastProbedAt` only when the CCU device is on the
+	* facade. An empty accessory-spec list + a stamped probe is how the kernel
+	* orphan-prunes linked children (`device-cap-proxy` safety gate): a restore
+	* that races a CCU `ECONNREFUSED` used to delete every accessory and fence
+	* their identities for 5 minutes. Leaving `lastProbedAt === 0` until the
+	* device is present keeps the gate closed; `reprobe()` on broker connect
+	* completes the probe and spawns/reconciles children for real.
+	*/
+	async onProbe() {
+		if (this.resolveHmDevice() === null) return;
+		await super.onProbe();
+	}
+	/**
 	* Derive the accessory children LIVE from the facade descriptor. Each child
 	* is a {@link HmEntitySpec} (the shared per-entity decomposition) wrapped into
 	* an `AccessoryChildSpec`: the `stableIdSuffix` IS the spec `key`, the broker
@@ -83150,6 +83289,7 @@ var HomematicProviderAddon = class extends BaseDeviceProvider {
 		this.registry.setOnBrokerConnected((brokerId) => {
 			this.ctx.logger.info("Homematic: broker connected", { meta: { brokerId } });
 			this.setBrokerDevicesOnline(brokerId, true);
+			this.reprobeBrokerContainers(brokerId);
 		});
 		this.registry.setOnBrokerDisconnected((brokerId) => {
 			this.setBrokerDevicesOnline(brokerId, false);
@@ -83544,6 +83684,28 @@ var HomematicProviderAddon = class extends BaseDeviceProvider {
 			count: n
 		} });
 	}
+	/**
+	* Reprobe every adopted {@link HmContainerDevice} for `brokerId` so the
+	* kernel re-runs accessory reconcile against the live facade. Best-effort:
+	* one container's failure must not block the rest (same discipline as HA's
+	* post-connect reconcile).
+	*/
+	async reprobeBrokerContainers(brokerId) {
+		const reg = this.ctx.kernel.deviceRegistry;
+		if (!reg) return;
+		const containers = reg.getAllForAddon(this.addonId).filter((d) => d instanceof HmContainerDevice && d.config.get("brokerId") === brokerId);
+		for (const container of containers) try {
+			await container.reprobe();
+		} catch (err) {
+			this.ctx.logger.warn("Homematic: container reprobe failed", {
+				tags: { deviceId: container.id },
+				meta: {
+					brokerId,
+					error: errMsg(err)
+				}
+			});
+		}
+	}
 	/** Return the live registry or throw if the addon is not initialised. */
 	requireRegistry() {
 		if (!this.registry) throw new Error("Homematic provider not initialised");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-homematic",
-  "version": "1.2.131",
+  "version": "1.2.132",
   "description": "Homematic / HomematicIP (CCU3 / RaspberryMatic) device-provider addon for CamStack — wraps the nodehomematic library",
   "keywords": [
     "camstack",