@camstack/addon-provider-homeassistant 1.2.141 → 1.2.143

package/dist/addon.js

@@ -1,7 +1,108 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dist = require("./dist-DdU8yrnj.js");
+const require_dist = require("./dist-BQE3XuD4.js");
 let node_crypto = require("node:crypto");
 let node_zlib = require("node:zlib");
+//#region src/ha-admin-link.ts
+/**
+* `device-admin-link` for Home-Assistant-backed devices.
+*
+* The interesting case of this capability, and the one that covers 779 of the
+* 1 012 devices on this hub. An HA-backed device has **no web server of its
+* own** — a Zigbee contact sensor has no IP at all — so its "configuration
+* page" is a page inside Home Assistant, built from the broker's base URL plus
+* the HA identifier the device already carries.
+*
+* Two subjects, because HA has two identifiers and they address different pages:
+*
+*  - **A container** is an HA *device* (registry id, `ha:<broker>:dev:<id>`).
+*    Its page is `/config/devices/device/<haDeviceId>` — the actual device
+*    configuration page, with its entities, its area and its integration.
+*  - **A child or standalone device** is an HA *entity*. HA has no stable
+*    per-entity configuration URL (`/config/entities` is a list with a modal;
+*    there is no deep link into it), so the honest address for one entity is
+*    `/history?entity_id=<entityId>`. That is a real page about exactly that
+*    entity. Inventing a `/config/entities/<id>` route that HA does not serve
+*    would be a button that opens a 404, which is worse than no button.
+*
+* **What this cannot answer, and does not pretend to.** A broker authenticated
+* by SUPERVISOR TOKEN carries no `baseUrl` at all — the supervisor proxy serves
+* HA on a relative path and the instance's address is never exposed to the
+* addon. Those devices get `null`, with a log line naming the reason. The cap
+* is still registered for them: this provider CAN answer the question for HA
+* devices in general, and for these particular ones the answer is "no page I
+* can address", which is a different statement from a Petkit feeder's, whose
+* provider never registers at all.
+*
+* **No credentials.** The broker config that holds `baseUrl` holds the
+* long-lived `accessToken` next to it. The token is never read here and never
+* travels; `parseAdminBase` REFUSES a base URL that carries userinfo rather
+* than silently stripping it, so an operator who typed his HA login into the
+* base-URL field loses the button instead of publishing the login.
+*/
+function pageFor(subject, basePath) {
+	if (subject.kind === "device") {
+		if (subject.haDeviceId.length === 0) return null;
+		return { path: `${basePath}/config/devices/device/${encodeURIComponent(subject.haDeviceId)}` };
+	}
+	if (subject.entityId.length === 0) return null;
+	return {
+		path: `${basePath}/history`,
+		query: { entity_id: subject.entityId }
+	};
+}
+/**
+* Register `device-admin-link` for one HA-backed device.
+*
+* The base URL is fetched from the broker on first ask and memoised, the same
+* read-through `ha-image-device.ts` uses — a device never keeps a second copy
+* of a broker fact (D224), and the memo is dropped on refusal so a broker that
+* gains a `baseUrl` later starts answering without a restart.
+*/
+function registerHaAdminLink(ctx, deviceId, brokerId, subject) {
+	let cachedBaseUrl = null;
+	const refuse = (reason, meta = {}) => {
+		ctx.logger.debug("home-assistant admin link unavailable", {
+			tags: { deviceId },
+			meta: {
+				reason,
+				brokerId,
+				subject: subject.kind,
+				...meta
+			}
+		});
+		return null;
+	};
+	ctx.registerNativeCap(require_dist.deviceAdminLinkCapability, { getAdminLink: async (input) => {
+		if (input.deviceId !== deviceId) throw new Error(`HaAdminLink: deviceId mismatch, expected ${deviceId}, got ${input.deviceId}`);
+		if (cachedBaseUrl === null) {
+			const raw = (await ctx.api.broker.getBrokerConfig.query({ id: brokerId }))?.["baseUrl"];
+			if (typeof raw !== "string" || raw.length === 0) return refuse("no-base-url");
+			cachedBaseUrl = raw;
+		}
+		const base = require_dist.parseAdminBase(cachedBaseUrl);
+		if (!base.ok) {
+			cachedBaseUrl = null;
+			return refuse("base-unusable", { baseReason: base.reason });
+		}
+		const page = pageFor(subject, base.basePath);
+		if (page === null) return refuse("empty-subject");
+		const built = require_dist.buildDeviceAdminUrl({
+			host: base.host,
+			port: base.port,
+			scheme: base.scheme,
+			path: page.path,
+			...page.query !== void 0 ? { query: page.query } : {}
+		});
+		if (!built.ok) return refuse("build-refused", { buildReason: built.reason });
+		return {
+			url: built.url,
+			label: "Home Assistant",
+			target: "integration",
+			host: base.host
+		};
+	} });
+}
+//#endregion
 //#region src/ha-device-source.ts
 /**
 * Shared zod fields merged into the placeholder + child device schemas.
@@ -308,6 +409,10 @@ var HaBaseChildDevice = class HaBaseChildDevice extends require_dist.BaseDevice
 	*/
 	async onActivate() {
 		await super.onActivate();
+		registerHaAdminLink(this.ctx, this.id, this.brokerId, {
+			kind: "entity",
+			entityId: this.entityId
+		});
 		await this.refreshFeatures();
 		if (await this.subscribeBrokerEntity()) {
 			this.deviceLogger.info("HA entity ready", { meta: {
@@ -3695,6 +3800,10 @@ var HaContainerDevice = class HaContainerDevice extends require_dist.BaseDevice
 	}
 	async onActivate() {
 		await super.onActivate();
+		registerHaAdminLink(this.ctx, this.id, this.brokerId, {
+			kind: "device",
+			haDeviceId: this.config.values.haDeviceId
+		});
 		if (this.entityIds.size > 0) {
 			this.attachAvailabilityListener();
 			try {

package/dist/addon.mjs

@@ -1,6 +1,107 @@
-import { $ as presenceCapability, A as controlCapability, At as EventCategory, B as humiditySensorCapability, C as buildAddonRouteProvider, Ct as number, D as colorCapability, Dt as union, E as climateControlCapability, Et as string, F as eventEmitterCapability, G as motionCapability, H as lawnMowerControlCapability, I as fanControlCapability, J as notifierCapability, K as normalizeUnit, L as floodCapability, M as deviceAdoptionCapability, O as connectivityCapability, Ot as unknown, P as enumSensorCapability, Q as prepareNotification, R as gasCapability, S as brokerCapability, St as literal, T as carbonMonoxideCapability, Tt as record, U as lockControlCapability, V as imageCapability, W as mediaPlayerCapability, Y as numericSensorCapability, Z as powerMeterCapability, _ as automationControlCapability, _t as createEvent, at as temperatureSensorCapability, b as binaryCapability, bt as array, ct as valveCapability, d as TargetSchema, dt as weatherCapability, et as pressureSensorCapability, f as accessoriesCapability, ft as errMsg, g as ambientLightSensorCapability, gt as DeviceType, h as alarmPanelCapability, ht as DeviceRole, it as tamperCapability, j as coverCapability, k as contactCapability, kt as url, lt as vibrationCapability, m as airQualitySensorCapability, mt as DeviceFeature, n as BaseDevice, nt as smokeCapability, ot as updateCapability, p as addonRoutesCapability, q as notificationOutputCapability, r as BaseDeviceProvider, rt as switchCapability, s as EnumSensorDateTimeFormatSchema, st as vacuumControlCapability, tt as scriptRunnerCapability, ut as waterHeaterCapability, v as batteryCapability, w as buttonCapability, wt as object, x as brightnessCapability, xt as discriminatedUnion, y as bestLocationMatch, yt as _enum, z as humidifierCapability } from "./dist-R2qhuV_9.mjs";
+import { $ as parseAdminBase, A as contactCapability, At as union, B as gasCapability, C as buildAddonRouteProvider, Ct as array, D as climateControlCapability, Dt as object, E as carbonMonoxideCapability, Et as number, G as lockControlCapability, H as humiditySensorCapability, I as enumSensorCapability, J as normalizeUnit, K as mediaPlayerCapability, L as eventEmitterCapability, M as coverCapability, Mt as url, N as deviceAdminLinkCapability, Nt as EventCategory, O as colorCapability, Ot as record, P as deviceAdoptionCapability, R as fanControlCapability, S as brokerCapability, St as _enum, T as buttonCapability, Tt as literal, U as imageCapability, V as humidifierCapability, W as lawnMowerControlCapability, X as notifierCapability, Y as notificationOutputCapability, Z as numericSensorCapability, _ as automationControlCapability, _t as DeviceFeature, at as smokeCapability, b as binaryCapability, bt as createEvent, ct as temperatureSensorCapability, d as TargetSchema, dt as valveCapability, et as powerMeterCapability, f as accessoriesCapability, ft as vibrationCapability, g as ambientLightSensorCapability, h as alarmPanelCapability, ht as errMsg, it as scriptRunnerCapability, j as controlCapability, jt as unknown, k as connectivityCapability, kt as string, lt as updateCapability, m as airQualitySensorCapability, mt as weatherCapability, n as BaseDevice, nt as presenceCapability, ot as switchCapability, p as addonRoutesCapability, pt as waterHeaterCapability, q as motionCapability, r as BaseDeviceProvider, rt as pressureSensorCapability, s as EnumSensorDateTimeFormatSchema, st as tamperCapability, tt as prepareNotification, ut as vacuumControlCapability, v as batteryCapability, vt as DeviceRole, w as buildDeviceAdminUrl, wt as discriminatedUnion, x as brightnessCapability, y as bestLocationMatch, yt as DeviceType, z as floodCapability } from "./dist-CcnfBSQ5.mjs";
 import { randomUUID } from "node:crypto";
 import { brotliCompressSync, deflateSync, gzipSync } from "node:zlib";
+//#region src/ha-admin-link.ts
+/**
+* `device-admin-link` for Home-Assistant-backed devices.
+*
+* The interesting case of this capability, and the one that covers 779 of the
+* 1 012 devices on this hub. An HA-backed device has **no web server of its
+* own** — a Zigbee contact sensor has no IP at all — so its "configuration
+* page" is a page inside Home Assistant, built from the broker's base URL plus
+* the HA identifier the device already carries.
+*
+* Two subjects, because HA has two identifiers and they address different pages:
+*
+*  - **A container** is an HA *device* (registry id, `ha:<broker>:dev:<id>`).
+*    Its page is `/config/devices/device/<haDeviceId>` — the actual device
+*    configuration page, with its entities, its area and its integration.
+*  - **A child or standalone device** is an HA *entity*. HA has no stable
+*    per-entity configuration URL (`/config/entities` is a list with a modal;
+*    there is no deep link into it), so the honest address for one entity is
+*    `/history?entity_id=<entityId>`. That is a real page about exactly that
+*    entity. Inventing a `/config/entities/<id>` route that HA does not serve
+*    would be a button that opens a 404, which is worse than no button.
+*
+* **What this cannot answer, and does not pretend to.** A broker authenticated
+* by SUPERVISOR TOKEN carries no `baseUrl` at all — the supervisor proxy serves
+* HA on a relative path and the instance's address is never exposed to the
+* addon. Those devices get `null`, with a log line naming the reason. The cap
+* is still registered for them: this provider CAN answer the question for HA
+* devices in general, and for these particular ones the answer is "no page I
+* can address", which is a different statement from a Petkit feeder's, whose
+* provider never registers at all.
+*
+* **No credentials.** The broker config that holds `baseUrl` holds the
+* long-lived `accessToken` next to it. The token is never read here and never
+* travels; `parseAdminBase` REFUSES a base URL that carries userinfo rather
+* than silently stripping it, so an operator who typed his HA login into the
+* base-URL field loses the button instead of publishing the login.
+*/
+function pageFor(subject, basePath) {
+	if (subject.kind === "device") {
+		if (subject.haDeviceId.length === 0) return null;
+		return { path: `${basePath}/config/devices/device/${encodeURIComponent(subject.haDeviceId)}` };
+	}
+	if (subject.entityId.length === 0) return null;
+	return {
+		path: `${basePath}/history`,
+		query: { entity_id: subject.entityId }
+	};
+}
+/**
+* Register `device-admin-link` for one HA-backed device.
+*
+* The base URL is fetched from the broker on first ask and memoised, the same
+* read-through `ha-image-device.ts` uses — a device never keeps a second copy
+* of a broker fact (D224), and the memo is dropped on refusal so a broker that
+* gains a `baseUrl` later starts answering without a restart.
+*/
+function registerHaAdminLink(ctx, deviceId, brokerId, subject) {
+	let cachedBaseUrl = null;
+	const refuse = (reason, meta = {}) => {
+		ctx.logger.debug("home-assistant admin link unavailable", {
+			tags: { deviceId },
+			meta: {
+				reason,
+				brokerId,
+				subject: subject.kind,
+				...meta
+			}
+		});
+		return null;
+	};
+	ctx.registerNativeCap(deviceAdminLinkCapability, { getAdminLink: async (input) => {
+		if (input.deviceId !== deviceId) throw new Error(`HaAdminLink: deviceId mismatch, expected ${deviceId}, got ${input.deviceId}`);
+		if (cachedBaseUrl === null) {
+			const raw = (await ctx.api.broker.getBrokerConfig.query({ id: brokerId }))?.["baseUrl"];
+			if (typeof raw !== "string" || raw.length === 0) return refuse("no-base-url");
+			cachedBaseUrl = raw;
+		}
+		const base = parseAdminBase(cachedBaseUrl);
+		if (!base.ok) {
+			cachedBaseUrl = null;
+			return refuse("base-unusable", { baseReason: base.reason });
+		}
+		const page = pageFor(subject, base.basePath);
+		if (page === null) return refuse("empty-subject");
+		const built = buildDeviceAdminUrl({
+			host: base.host,
+			port: base.port,
+			scheme: base.scheme,
+			path: page.path,
+			...page.query !== void 0 ? { query: page.query } : {}
+		});
+		if (!built.ok) return refuse("build-refused", { buildReason: built.reason });
+		return {
+			url: built.url,
+			label: "Home Assistant",
+			target: "integration",
+			host: base.host
+		};
+	} });
+}
+//#endregion
 //#region src/ha-device-source.ts
 /**
 * Shared zod fields merged into the placeholder + child device schemas.
@@ -307,6 +408,10 @@ var HaBaseChildDevice = class HaBaseChildDevice extends BaseDevice {
 	*/
 	async onActivate() {
 		await super.onActivate();
+		registerHaAdminLink(this.ctx, this.id, this.brokerId, {
+			kind: "entity",
+			entityId: this.entityId
+		});
 		await this.refreshFeatures();
 		if (await this.subscribeBrokerEntity()) {
 			this.deviceLogger.info("HA entity ready", { meta: {
@@ -3694,6 +3799,10 @@ var HaContainerDevice = class HaContainerDevice extends BaseDevice {
 	}
 	async onActivate() {
 		await super.onActivate();
+		registerHaAdminLink(this.ctx, this.id, this.brokerId, {
+			kind: "device",
+			haDeviceId: this.config.values.haDeviceId
+		});
 		if (this.entityIds.size > 0) {
 			this.attachAvailabilityListener();
 			try {