@camstack/addon-provider-homeassistant 1.2.639 → 1.2.641

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { $ as lawnMowerControlCapability, $t as object, A as buttonCapability, At as valveCapability, B as coverCapability, Bt as baseUnitOf, C as batteryCapability, Ct as switchCapability, D as brokerCapability, Dt as tryConvertUnit, E as brightnessCapability, Et as tryConvertDelta, F as connectivityCapability, Ft as DeviceRole, G as eventEmitterCapability, H as deviceAdoptionCapability, Ht as defineEntryKind, It as DeviceType, J as gasCapability, Jt as array, K as fanControlCapability, Lt as errMsg, M as carbonMonoxideCapability, Mt as waterHeaterCapability, N as climateControlCapability, Nt as weatherCapability, O as buildAddonRouteProvider, Ot as updateCapability, P as colorCapability, Pt as DeviceFeature, Q as ingestReading, Qt as number, R as contactCapability, S as automationControlCapability, St as smokeCapability, T as binaryCapability, Tt as temperatureSensorCapability, Ut as defineRecordKinds, V as deviceAdminLinkCapability, Vt as createEvent, W as enumSensorCapability, Wt as entryBody, X as humiditySensorCapability, Xt as discriminatedUnion, Y as humidifierCapability, Yt as boolean, Z as imageCapability, Zt as literal, _ as accessoriesCapability, _t as runningFromMediaPlayer, an as EventCategory, at as notifierCapability, b as alarmPanelCapability, bt as scriptRunnerCapability, ct as parseAdminBase, dt as presenceCapability, en as record, et as lockControlCapability, ft as pressureSensorCapability, g as TargetSchema, gt as runningFromLawnMower, h as RUNNING_STATE_COLD, in as url, it as notificationOutputCapability, j as calendarSourceCapability, jt as vibrationCapability, k as buildDeviceAdminUrl, kt as vacuumControlCapability, lt as powerMeterCapability, mt as quantityFromUnit, n as BaseDevice, nn as union, nt as motionCapability, ot as numericSensorCapability, q as floodCapability, qt as _enum, r as BaseDeviceProvider, rn as unknown, rt as normalizeUnit, tn as string, tt as mediaPlayerCapability, u as EnumSensorDateTimeFormatSchema, ut as prepareNotification, v as addonRoutesCapability, vt as runningFromVacuumState, w as bestLocationMatch, wt as tamperCapability, x as ambientLightSensorCapability, y as airQualitySensorCapability, yt as runningStateCapability, z as controlCapability, zt as RecordSecretUnavailableError } from "./dist-Cvz76AD1.mjs";
+import { $ as humiditySensorCapability, $t as array, A as brokerCapability, At as temperatureSensorCapability, Bt as DeviceRole, C as alarmPanelCapability, Ct as runningFromVacuumState, D as bestLocationMatch, Dt as smokeCapability, E as batteryCapability, F as carbonMonoxideCapability, Ft as valveCapability, G as deviceAdoptionCapability, Gt as baseUnitOf, H as controlCapability, Ht as errMsg, I as climateControlCapability, It as vibrationCapability, J as eventEmitterCapability, Jt as defineRecordKinds, Kt as createEvent, L as colorCapability, Lt as waterHeaterCapability, M as buildDeviceAdminUrl, Mt as tryConvertUnit, N as buttonCapability, Nt as updateCapability, O as binaryCapability, Ot as switchCapability, P as calendarSourceCapability, Pt as vacuumControlCapability, Q as humidifierCapability, Qt as _enum, R as connectivityCapability, Rt as weatherCapability, S as airQualitySensorCapability, St as runningFromMediaPlayer, T as automationControlCapability, Tt as scriptRunnerCapability, U as coverCapability, V as contactCapability, Vt as DeviceType, W as deviceAdminLinkCapability, Wt as RecordSecretUnavailableError, X as floodCapability, Y as fanControlCapability, Yt as entryBody, Z as gasCapability, _t as publicEndpointReaderFrom, a as BaseDevice, an as record, at as motionCapability, b as accessoriesCapability, cn as unknown, ct as notifierCapability, dt as parseAdminBase, en as boolean, et as imageCapability, ft as powerMeterCapability, ht as pressureSensorCapability, in as object, it as mediaPlayerCapability, j as buildAddonRouteProvider, jt as tryConvertDelta, k as brightnessCapability, kt as tamperCapability, ln as url, lt as numericSensorCapability, mt as presenceCapability, nn as literal, nt as lawnMowerControlCapability, o as BaseDeviceProvider, on as string, ot as normalizeUnit, p as EnumSensorDateTimeFormatSchema, pt as prepareNotification, q as enumSensorCapability, qt as defineEntryKind, rn as number, rt as lockControlCapability, sn as union, st as notificationOutputCapability, t as HA_BROKER_KIND, tn as discriminatedUnion, tt as ingestReading, un as EventCategory, v as RUNNING_STATE_COLD, vt as quantityFromUnit, w as ambientLightSensorCapability, wt as runningStateCapability, x as addonRoutesCapability, xt as runningFromLawnMower, y as TargetSchema, yt as resolveAttachmentUrls, zt as DeviceFeature } from "./ha-broker-source-vytM8SXk.mjs";
 import { randomUUID } from "node:crypto";
 import { brotliCompressSync, deflateSync, gzipSync } from "node:zlib";
 //#region src/ha-admin-link.ts
@@ -7230,21 +7230,27 @@ function haConfigSchema() {
 		title: "Home Assistant notify",
 		titleKey: "provider-homeassistant:haConfig.s_connection.title",
 		fields: [{
-			type: "text",
+			type: "broker-select",
+			key: "brokerId",
+			label: "Broker",
+			labelKey: "provider-homeassistant:haConfig.s_connection.brokerId.label",
+			description: "The Home Assistant connection the notification goes through.",
+			descriptionKey: "provider-homeassistant:haConfig.s_connection.brokerId.description",
+			brokerKind: HA_BROKER_KIND
+		}, {
+			type: "select",
 			key: "service",
 			label: "Notify service",
 			labelKey: "provider-homeassistant:haConfig.s_connection.service.label",
 			required: true,
+			options: [],
 			placeholder: "mobile_app_pixel_7",
-			description: "The part after `notify.` (e.g. `mobile_app_pixel_7`); use Discover to list them.",
-			descriptionKey: "provider-homeassistant:haConfig.s_connection.service.description"
-		}, {
-			type: "text",
-			key: "brokerId",
-			label: "Broker",
-			labelKey: "provider-homeassistant:haConfig.s_connection.brokerId.label",
-			description: "Optional; blank uses the only configured broker.",
-			descriptionKey: "provider-homeassistant:haConfig.s_connection.brokerId.description"
+			description: "Loaded from the broker once it is picked. If the list does not load, type the part after `notify.`.",
+			descriptionKey: "provider-homeassistant:haConfig.s_connection.service.description",
+			discoverOptions: {
+				kind: HA_NOTIFICATION_KIND,
+				dependsOn: ["brokerId"]
+			}
 		}]
 	}] };
 }
@@ -7385,24 +7391,70 @@ function buildNotifyServiceData(prepared) {
 * `get_services` returns `{ [domain]: { [service]: {...} } }`; we read the
 * `notify` domain. mobile_app_* services (rich push features) sort first.
 */
-function parseNotifyServices(result, brokerId) {
+function parseNotifyServices(result, brokerId, deviceNames) {
 	if (typeof result !== "object" || result === null) return [];
 	const notify = result["notify"];
 	if (typeof notify !== "object" || notify === null) return [];
-	return [...Object.keys(notify)].sort((a, b) => {
+	return [...Object.entries(notify)].sort(([a], [b]) => {
 		const am = a.startsWith("mobile_app_") ? 0 : 1;
 		const bm = b.startsWith("mobile_app_") ? 0 : 1;
 		if (am !== bm) return am - bm;
 		return a.localeCompare(b);
-	}).map((service) => ({
+	}).map(([service, definition]) => ({
 		kind: HA_NOTIFICATION_KIND,
-		suggestedName: `notify.${service}`,
+		suggestedName: friendlyServiceName(service, definition, deviceNames),
 		config: {
 			service,
 			...brokerId !== void 0 ? { brokerId } : {}
 		}
 	}));
 }
+function nonEmptyText(value) {
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+/** `alexa_media_echo` -> `Alexa Media Echo`. */
+function prettifyServiceId(service) {
+	return service.split("_").filter((word) => word.length > 0).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+}
+/**
+* The name an operator recognises: the device name for a mobile app, else the
+* service's own `name`, else its `description`, else the prettified id.
+*/
+function friendlyServiceName(service, definition, deviceNames) {
+	const device = deviceNames?.get(service);
+	if (device !== void 0) return device;
+	if (typeof definition === "object" && definition !== null) {
+		const fields = { ...definition };
+		const name = nonEmptyText(fields["name"]);
+		if (name !== void 0) return name;
+		const description = nonEmptyText(fields["description"]);
+		if (description !== void 0) return description;
+	}
+	return prettifyServiceId(service);
+}
+/** HA's slug of a device name, as it appears in `mobile_app_<slug>`. */
+function slugifyDeviceName(name) {
+	return name.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+}
+/**
+* `mobile_app_<slug>` -> device name, read from a `config/device_registry/list`
+* reply. Only devices of the mobile_app integration count; the name the user
+* gave wins over the one the app reported.
+*/
+function mobileAppDeviceNames(registry) {
+	const names = /* @__PURE__ */ new Map();
+	if (!Array.isArray(registry)) return names;
+	for (const entry of registry) {
+		if (typeof entry !== "object" || entry === null) continue;
+		const device = { ...entry };
+		const identifiers = device["identifiers"];
+		if (!(Array.isArray(identifiers) && identifiers.some((pair) => Array.isArray(pair) && pair[0] === "mobile_app"))) continue;
+		const name = nonEmptyText(device["name_by_user"]) ?? nonEmptyText(device["name"]);
+		if (name === void 0) continue;
+		names.set(`mobile_app_${slugifyDeviceName(name)}`, name);
+	}
+	return names;
+}
 /**
 * CRUD over the `ha-notification-targets` record kind.
 *
@@ -7495,7 +7547,12 @@ function createHaNotificationOutputProvider(deps) {
 		return deps.listBrokerIds()[0] ?? null;
 	}
 	/** Degrade → build → publish. NEVER throws through the cap. */
-	async function dispatch(target, notification) {
+	async function dispatch(target, raw) {
+		const notification = deps.readPublicEndpoint === void 0 ? raw : await resolveAttachmentUrls({
+			notification: raw,
+			readPublicEndpoint: deps.readPublicEndpoint,
+			...logger !== void 0 ? { logger } : {}
+		});
 		const prepared = prepareNotification(descriptor.caps, notification);
 		const service = readService(target.config);
 		if (!service) return {
@@ -7556,12 +7613,24 @@ function createHaNotificationOutputProvider(deps) {
 		},
 		discoverTargets: async ({ kind, config }) => {
 			if (kind !== "homeassistant") return [];
+			const deviceNamesOf = async (brokerId) => {
+				if (deps.listDevices === void 0) return /* @__PURE__ */ new Map();
+				try {
+					return mobileAppDeviceNames(await deps.listDevices(brokerId));
+				} catch (err) {
+					logger?.warn("ha device registry read failed; naming services from their ids", { meta: {
+						brokerId,
+						error: errMsg(err)
+					} });
+					return /* @__PURE__ */ new Map();
+				}
+			};
 			const explicit = config ? readBrokerId(config) : void 0;
 			const brokerIds = explicit ? [explicit] : [...deps.listBrokerIds()];
 			const out = [];
 			for (const brokerId of brokerIds) try {
 				const result = await deps.getServices(brokerId);
-				out.push(...parseNotifyServices(result, brokerId));
+				out.push(...parseNotifyServices(result, brokerId, await deviceNamesOf(brokerId)));
 			} catch (err) {
 				logger?.warn("ha get_services discovery failed", { meta: {
 					brokerId,
@@ -8430,7 +8499,13 @@ var HaProviderAddon = class HaProviderAddon extends BaseDeviceProvider {
 				if (!manager) throw new Error(`ha-broker '${brokerId}' not found`);
 				return manager.sendMessage({ type: "get_services" });
 			},
+			listDevices: async (brokerId) => {
+				const manager = this.requireRegistry().getManager(brokerId);
+				if (!manager) throw new Error(`ha-broker '${brokerId}' not found`);
+				return manager.sendMessage({ type: "config/device_registry/list" });
+			},
 			listBrokerIds: () => this.activeBrokers.map((b) => b.id),
+			readPublicEndpoint: publicEndpointReaderFrom(this.ctx.api.localNetwork),
 			logger: this.ctx.logger.child("notification-output")
 		});
 	}