@camstack/addon-provider-homematic 1.2.115 → 1.2.117

package/dist/index.js

@@ -193,6 +193,7 @@ var HomematicDevice = class extends require_addon.BaseDevice {
 		super(ctx, homematicDeviceSchema, { type: ctx.deviceMeta.type });
 		this.address = address;
 		this.brokerId = typeof persisted.brokerId === "string" ? persisted.brokerId : void 0;
+		this.registerAdminLinkCap();
 		this.registerCapabilities();
 		this.attachValueChangedListener();
 		this.updateSourceInfo({
@@ -210,6 +211,56 @@ var HomematicDevice = class extends require_addon.BaseDevice {
 		if (!facade) return null;
 		return facade.devices().find((d) => d.address === this.address) ?? null;
 	}
+	/**
+	* device-admin-link — a Homematic device has no web server; the CCU3 /
+	* RaspberryMatic WebUI is where it is configured. The CCU has no stable
+	* per-device deep link (the WebUI addresses devices through a session-bound
+	* frameset), so every device on a CCU gets that CCU's root, labelled for
+	* what it is. A device persisted before multi-CCU support carries no
+	* `brokerId` and cannot be attributed to a CCU at all — it answers null.
+	*
+	* Registered OUTSIDE `registerCapabilities`, which returns early when the
+	* facade has not yet seen the device: whether the CCU has a WebUI does not
+	* depend on that, and an early return there used to be how a device ended up
+	* with no caps at all.
+	*/
+	registerAdminLinkCap() {
+		const brokerId = this.brokerId;
+		this.ctx.registerNativeCap(require_addon.deviceAdminLinkCapability, { getAdminLink: async ({ deviceId }) => {
+			if (deviceId !== this.id) throw new Error(`HomematicDevice: deviceId mismatch, expected ${this.id}, got ${deviceId}`);
+			if (brokerId === void 0) {
+				this.ctx.logger.debug("homematic admin link unavailable: no brokerId on device", {
+					tags: { deviceId: this.id },
+					meta: { address: this.address }
+				});
+				return null;
+			}
+			const cfg = await this.ctx.api.broker.getBrokerConfig.query({ id: brokerId });
+			const host = typeof cfg?.["host"] === "string" ? cfg["host"] : "";
+			const built = require_addon.buildDeviceAdminUrl({
+				host,
+				port: null,
+				scheme: cfg?.["tls"] === true ? "https" : "http",
+				path: "/"
+			});
+			if (!built.ok) {
+				this.ctx.logger.debug("homematic admin link unavailable", {
+					tags: { deviceId: this.id },
+					meta: {
+						reason: built.reason,
+						brokerId
+					}
+				});
+				return null;
+			}
+			return {
+				url: built.url,
+				label: "CCU WebUI",
+				target: "integration",
+				host
+			};
+		} });
+	}
 	registerCapabilities() {
 		const hmDevice = this.resolveHmDevice();
 		if (!hmDevice) {

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { C as motionCapability, D as object, E as createEvent, HomematicProviderAddon, O as string, S as lockControlCapability, T as DeviceType, _ as toHomematicOptions, a as decodeClimate, b as coverCapability, c as toHmClimateMode, d as mapHmChannel, f as mapHmDeviceChannels, g as homematicConfigSchema, h as homematicAddonConfigSchema, i as registerTemperatureCap, k as EventCategory, l as deriveHmEntitySpecs, m as buildConnectionFormSchema, n as registerHumidityCap, o as decodeCover, p as homematicFacades, r as registerPowerMeterCap, s as decodeLock, t as registerAmbientLightCap, u as inferHmDeviceType, v as BaseDevice, w as switchCapability, x as eventEmitterCapability, y as climateControlCapability } from "./addon.mjs";
+import { A as string, C as eventEmitterCapability, D as DeviceType, E as switchCapability, HomematicProviderAddon, O as createEvent, S as deviceAdminLinkCapability, T as motionCapability, _ as toHomematicOptions, a as decodeClimate, b as climateControlCapability, c as toHmClimateMode, d as mapHmChannel, f as mapHmDeviceChannels, g as homematicConfigSchema, h as homematicAddonConfigSchema, i as registerTemperatureCap, j as EventCategory, k as object, l as deriveHmEntitySpecs, m as buildConnectionFormSchema, n as registerHumidityCap, o as decodeCover, p as homematicFacades, r as registerPowerMeterCap, s as decodeLock, t as registerAmbientLightCap, u as inferHmDeviceType, v as BaseDevice, w as lockControlCapability, x as coverCapability, y as buildDeviceAdminUrl } from "./addon.mjs";
 //#region src/homematic-device.ts
 /**
 * Persisted config every Homematic-backed device carries. `address` is
@@ -192,6 +192,7 @@ var HomematicDevice = class extends BaseDevice {
 		super(ctx, homematicDeviceSchema, { type: ctx.deviceMeta.type });
 		this.address = address;
 		this.brokerId = typeof persisted.brokerId === "string" ? persisted.brokerId : void 0;
+		this.registerAdminLinkCap();
 		this.registerCapabilities();
 		this.attachValueChangedListener();
 		this.updateSourceInfo({
@@ -209,6 +210,56 @@ var HomematicDevice = class extends BaseDevice {
 		if (!facade) return null;
 		return facade.devices().find((d) => d.address === this.address) ?? null;
 	}
+	/**
+	* device-admin-link — a Homematic device has no web server; the CCU3 /
+	* RaspberryMatic WebUI is where it is configured. The CCU has no stable
+	* per-device deep link (the WebUI addresses devices through a session-bound
+	* frameset), so every device on a CCU gets that CCU's root, labelled for
+	* what it is. A device persisted before multi-CCU support carries no
+	* `brokerId` and cannot be attributed to a CCU at all — it answers null.
+	*
+	* Registered OUTSIDE `registerCapabilities`, which returns early when the
+	* facade has not yet seen the device: whether the CCU has a WebUI does not
+	* depend on that, and an early return there used to be how a device ended up
+	* with no caps at all.
+	*/
+	registerAdminLinkCap() {
+		const brokerId = this.brokerId;
+		this.ctx.registerNativeCap(deviceAdminLinkCapability, { getAdminLink: async ({ deviceId }) => {
+			if (deviceId !== this.id) throw new Error(`HomematicDevice: deviceId mismatch, expected ${this.id}, got ${deviceId}`);
+			if (brokerId === void 0) {
+				this.ctx.logger.debug("homematic admin link unavailable: no brokerId on device", {
+					tags: { deviceId: this.id },
+					meta: { address: this.address }
+				});
+				return null;
+			}
+			const cfg = await this.ctx.api.broker.getBrokerConfig.query({ id: brokerId });
+			const host = typeof cfg?.["host"] === "string" ? cfg["host"] : "";
+			const built = buildDeviceAdminUrl({
+				host,
+				port: null,
+				scheme: cfg?.["tls"] === true ? "https" : "http",
+				path: "/"
+			});
+			if (!built.ok) {
+				this.ctx.logger.debug("homematic admin link unavailable", {
+					tags: { deviceId: this.id },
+					meta: {
+						reason: built.reason,
+						brokerId
+					}
+				});
+				return null;
+			}
+			return {
+				url: built.url,
+				label: "CCU WebUI",
+				target: "integration",
+				host
+			};
+		} });
+	}
 	registerCapabilities() {
 		const hmDevice = this.resolveHmDevice();
 		if (!hmDevice) {

package/package.json

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