@camstack/addon-provider-homeassistant 1.2.653 → 1.2.654

package/dist/ha-export/ha-export.addon.mjs

@@ -1,4 +1,4 @@
-import { B as consumableFormOf, Gt as defineAddonMigrations, M as buildAddonRouteProvider, Ot as sendToExportedTarget, Qt as array, St as runExportedAction, Ut as baseUnitOf, V as consumableKindOf, Vt as BaseAddon, Xt as nodePin, Yt as isReadingQuantity, _ as PLUG_APPLIANCE_TYPES, an as string, c as COCO_TO_MACRO, d as ConsumableItemSchema, dt as oauthIntegrationCapability, f as ConsumableStatusSchema, g as MediaPlayerRepeatSchema, h as HvacModeSchema, i as AlarmArmModeSchema, l as CameraSwitchIdSchema, m as FanDirectionSchema, mt as preconditionOf, pn as EventCategory, q as deviceExportCapability, r as listHomeAssistantBrokers, rn as object, s as CAMERA_SWITCH_ORDER, sn as unknown, u as ConsumableFormSchema, vt as pruneDeletedEntities, x as addonRoutesCapability } from "../ha-broker-source-CKdH9XHn.mjs";
+import { $t as nodePin, F as buildAddonRouteProvider, Jt as defineAddonMigrations, Kt as baseUnitOf, Qt as isReadingQuantity, Tt as runExportedAction, U as consumableFormOf, W as consumableKindOf, Wt as BaseAddon, X as deviceExportCapability, _ as FanDirectionSchema, _t as preconditionOf, b as PLUG_APPLIANCE_TYPES, cn as string, d as COCO_TO_MACRO, f as CameraSwitchIdSchema, gn as EventCategory, h as ConsumableStatusSchema, jt as sendToExportedTarget, m as ConsumableItemSchema, mt as oauthIntegrationCapability, n as listInstancesOrNothing, o as listHomeAssistantBrokers, on as object, p as ConsumableFormSchema, r as settingsByBroker, s as AlarmArmModeSchema, t as haInstanceSettingsPortsOver, tn as array, u as CAMERA_SWITCH_ORDER, un as unknown, v as HvacModeSchema, w as addonRoutesCapability, xt as pruneDeletedEntities, y as MediaPlayerRepeatSchema } from "../ha-instance-settings-g5pwb3Fi.mjs";
 import { createHmac, timingSafeEqual } from "node:crypto";
 import "node:zlib";
 import "node:fs";
@@ -4973,25 +4973,6 @@ async function planDropPublicBaseUrl(ports) {
 		}])))
 	}] };
 }
-//#endregion
-//#region src/ha-export/migrations/index.ts
-/** The `homeassistant-export` catalogue (D987): offered to the engine when the addon initialises. */
-var ADDON_MIGRATIONS = [{
-	meta: {
-		id: "homeassistant-export/2026-11-02-drop-public-base-url",
-		owner: "homeassistant-export",
-		level: "addon-state",
-		seq: 1,
-		dependsOn: [],
-		store: "settings",
-		scope: "cluster",
-		onFailure: "tolerate",
-		bodyKind: "plan",
-		description: "Delete the retired publicBaseUrl setting; each instance now chooses a hub address role",
-		fixtureMark: "the reconcile interval the migration does not know"
-	},
-	plan: planDropPublicBaseUrl
-}];
 process.platform, process.env["SystemRoot"];
 /**
 * The ONE derivation of "a signed, expiring URL".
@@ -5047,65 +5028,6 @@ function verifyExpiringUrl(input) {
 	return timingSafeEqual(a, b);
 }
 //#endregion
-//#region src/ha-export/media-url.ts
-/**
-* Signed, expiring media links.
-*
-* Images never cross the push transport. Home Assistant is handed a URL
-* and fetches the bytes itself, on demand, which is what keeps a camera
-* with a `last_image` entity from turning every detection into a
-* multi-megabyte POST.
-*
-* The link is signed rather than protected by a session, because the
-* fetcher is HA's own frontend or a phone — neither of which holds a
-* camstack token.
-*
-* The HMAC itself is NOT restated here. It used to be — this module and the
-* notification artifact plane each carried their own copy, because addons never
-* import each other and neither could reach the other's. That reasoning was
-* right and the conclusion was wrong: both now delegate to the single
-* derivation in `@camstack/types/node`, which every addon may depend on. What
-* stays local is policy — the TTL below, and the id this plane signs.
-*
-* Expiry is checked BEFORE the constant-time compare (in the shared verifier):
-* an expired link is refused whether or not its signature is valid, so a leaked
-* URL stops working on its own.
-*/
-/** The settings key that carries one broker's media role (per-instance, like `exportTo:`). */
-function mediaRoleKey(brokerId) {
-	return `mediaRole:${brokerId}`;
-}
-/** A broker's chosen role; anything stored that is not a known role is `internal`. */
-function haMediaRoleOf(store, brokerId) {
-	return store[mediaRoleKey(brokerId)] === "publicEndpoint" ? "publicEndpoint" : "internal";
-}
-/**
-* The base a media link is minted on: the hub's role (D734) — `internal` unless the
-* broker chose `publicEndpoint`. Ranked by `local-network`, never loopback (`null`
-* when the role resolves to nothing): a link Home Assistant cannot open is worse
-* than no image.
-*/
-function haMediaBaseUrl(book, role = "internal") {
-	return book.roles[role].resolved;
-}
-/** brokerId → media base, each broker on ITS role. Pure: the caller reads the palette per use. */
-function mediaBasesByBroker(store, brokerIds, book) {
-	return new Map(brokerIds.map((brokerId) => [brokerId, haMediaBaseUrl(book, haMediaRoleOf(store, brokerId))]));
-}
-/** How long a minted link stays valid. Long enough for HA to render it. */
-var MEDIA_URL_TTL_MS = 360 * 60 * 1e3;
-function signMedia(secret, id, expMs) {
-	return signExpiringUrl(secret, id, expMs);
-}
-function buildMediaUrl(input) {
-	const base = input.baseUrl.replace(/\/+$/, "");
-	const sig = signMedia(input.secret, input.id, input.expMs);
-	return `${base}${input.routePrefix}/${encodeURIComponent(input.id)}?exp=${input.expMs}&sig=${sig}`;
-}
-function verifyMediaSignature(input) {
-	return verifyExpiringUrl(input);
-}
-//#endregion
 //#region src/ha-export/membership.ts
 function devicesForBroker(membership, brokerId) {
 	return membership[brokerId] ?? [];
@@ -5167,10 +5089,19 @@ function pruneBrokers(membership, knownBrokerIds) {
 *
 * A broker that is no longer known is not enabled, whatever the store says:
 * a stale `exportTo:` key for a deleted instance must not resurrect it.
+*
+* The switch is a setting of the INSTANCE (D985): `perBroker` carries each broker's integration
+* settings, and a broker whose integration has an `exportTo` answers from it. A broker whose
+* integration has none yet — the migration has not copied it — falls back to the legacy
+* `exportTo:<brokerId>` key, so the move never flips a switch mid-way.
 */
-function enabledBrokerIds(store, knownBrokerIds) {
-	return knownBrokerIds.filter((brokerId) => store[`exportTo:${brokerId}`] === true);
+function enabledBrokerIds(store, knownBrokerIds, perBroker = NO_INSTANCE_SETTINGS) {
+	return knownBrokerIds.filter((brokerId) => {
+		const own = perBroker.get(brokerId)?.["exportTo"];
+		return typeof own === "boolean" ? own : store[`exportTo:${brokerId}`] === true;
+	});
 }
+var NO_INSTANCE_SETTINGS = /* @__PURE__ */ new Map();
 /** Same brokers, same order, same names — nothing for the form to re-render. */
 function sameBrokers(a, b) {
 	if (a.length !== b.length) return false;
@@ -5224,6 +5155,282 @@ function brokerRefreshPatch(current, next) {
 	};
 }
 //#endregion
+//#region src/ha-export/media-url.ts
+/**
+* Signed, expiring media links.
+*
+* Images never cross the push transport. Home Assistant is handed a URL
+* and fetches the bytes itself, on demand, which is what keeps a camera
+* with a `last_image` entity from turning every detection into a
+* multi-megabyte POST.
+*
+* The link is signed rather than protected by a session, because the
+* fetcher is HA's own frontend or a phone — neither of which holds a
+* camstack token.
+*
+* The HMAC itself is NOT restated here. It used to be — this module and the
+* notification artifact plane each carried their own copy, because addons never
+* import each other and neither could reach the other's. That reasoning was
+* right and the conclusion was wrong: both now delegate to the single
+* derivation in `@camstack/types/node`, which every addon may depend on. What
+* stays local is policy — the TTL below, and the id this plane signs.
+*
+* Expiry is checked BEFORE the constant-time compare (in the shared verifier):
+* an expired link is refused whether or not its signature is valid, so a leaked
+* URL stops working on its own.
+*/
+/** The hub address roles a Home Assistant media link may be minted on. */
+var HA_MEDIA_ROLES = ["internal", "publicEndpoint"];
+/** The settings key that carries one broker's media role (per-instance, like `exportTo:`). */
+function mediaRoleKey(brokerId) {
+	return `mediaRole:${brokerId}`;
+}
+/**
+* A broker's chosen role; anything stored that is not a known role is `internal`. The role is a
+* setting of the INSTANCE (D985): the integration's `mediaRole` answers when it has one, and a
+* broker the migration has not reached falls back to the legacy `mediaRole:<brokerId>` key.
+*/
+function haMediaRoleOf(store, brokerId, perBroker = NO_INSTANCE_SETTINGS) {
+	const own = perBroker.get(brokerId)?.["mediaRole"];
+	return (own !== void 0 ? own : store[mediaRoleKey(brokerId)]) === "publicEndpoint" ? "publicEndpoint" : "internal";
+}
+/**
+* The base a media link is minted on: the hub's role (D734) — `internal` unless the
+* broker chose `publicEndpoint`. Ranked by `local-network`, never loopback (`null`
+* when the role resolves to nothing): a link Home Assistant cannot open is worse
+* than no image.
+*/
+function haMediaBaseUrl(book, role = "internal") {
+	return book.roles[role].resolved;
+}
+/** brokerId → media base, each broker on ITS role. Pure: the caller reads the palette per use. */
+function mediaBasesByBroker(store, brokerIds, book, perBroker = NO_INSTANCE_SETTINGS) {
+	return new Map(brokerIds.map((brokerId) => [brokerId, haMediaBaseUrl(book, haMediaRoleOf(store, brokerId, perBroker))]));
+}
+/** How long a minted link stays valid. Long enough for HA to render it. */
+var MEDIA_URL_TTL_MS = 360 * 60 * 1e3;
+function signMedia(secret, id, expMs) {
+	return signExpiringUrl(secret, id, expMs);
+}
+function buildMediaUrl(input) {
+	const base = input.baseUrl.replace(/\/+$/, "");
+	const sig = signMedia(input.secret, input.id, input.expMs);
+	return `${base}${input.routePrefix}/${encodeURIComponent(input.id)}?exp=${input.expMs}&sig=${sig}`;
+}
+function verifyMediaSignature(input) {
+	return verifyExpiringUrl(input);
+}
+//#endregion
+//#region src/ha-export/migrations/per-broker-flags.ts
+/**
+* Whether the export reaches a Home Assistant instance, and which hub address role its image
+* links use, are facts of THAT instance (D985): they live in the instance's integration settings
+* as `exportTo` and `mediaRole`, not in the addon store as one dynamic key per broker
+* (`exportTo:<brokerId>`, `mediaRole:<brokerId>`).
+*
+* Two migrations:
+*
+* 1. `per-broker-flags-to-integration` (procedure) copies each legacy key to the integration that
+*    links its broker. A flag the integration already has is never overwritten; a key whose
+*    broker has no integration any more (a deleted instance) is skipped, never recreated; two
+*    integrations linking one broker are an ambiguity and throw; a value that is not a boolean /
+*    a known role is skipped (the reader already treats it as off / `internal`).
+* 2. `drop-per-broker-flags` (plan) deletes a legacy key only after a read-back: the integration
+*    must show the same flag. A key the integration disagrees with (its own value was there
+*    first) or whose broker has no integration stays PARKED in place, never deleted.
+*
+* Both are idempotent.
+*/
+var PREFIX = {
+	exportTo: "exportTo:",
+	mediaRole: "mediaRole:"
+};
+var validValue = (flag, value) => flag === "exportTo" ? typeof value === "boolean" : typeof value === "string" && HA_MEDIA_ROLES.some((role) => role === value);
+/** Every legacy key with a value the reader understands, per broker. */
+function legacyFlags(stored) {
+	const out = [];
+	for (const [storeKey, value] of Object.entries(stored)) for (const flag of ["exportTo", "mediaRole"]) {
+		const prefix = PREFIX[flag];
+		if (!storeKey.startsWith(prefix) || storeKey.length === prefix.length) continue;
+		if (validValue(flag, value)) out.push({
+			storeKey,
+			brokerId: storeKey.slice(prefix.length),
+			flag,
+			value
+		});
+	}
+	return out;
+}
+/** The one integration per broker; two integrations linking one broker are an ambiguity. */
+function instanceByBroker(rows) {
+	const out = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		if (row.brokerId === null) continue;
+		const other = out.get(row.brokerId);
+		if (other !== void 0) throw new Error(`homeassistant-export: integrations ${other.integrationId} and ${row.integrationId} both link broker ${row.brokerId} — nothing copied`);
+		out.set(row.brokerId, row);
+	}
+	return out;
+}
+async function copyFlagsToIntegrations(ports) {
+	const legacy = legacyFlags(await ports.readStored());
+	if (legacy.length === 0) return {
+		outcome: "already-done",
+		summary: { reason: "no-legacy-flags" }
+	};
+	const byBroker = instanceByBroker(await ports.listInstances());
+	const pending = /* @__PURE__ */ new Map();
+	let kept = 0;
+	let skipped = 0;
+	for (const entry of legacy) {
+		const instance = byBroker.get(entry.brokerId);
+		if (instance === void 0) {
+			skipped += 1;
+			continue;
+		}
+		if (entry.flag in instance.settings) {
+			kept += 1;
+			continue;
+		}
+		pending.set(instance.integrationId, {
+			...pending.get(instance.integrationId),
+			[entry.flag]: entry.value
+		});
+	}
+	let copied = 0;
+	let gone = 0;
+	for (const [integrationId, patch] of pending) if (await ports.patchInstanceSettings(integrationId, patch)) copied += Object.keys(patch).length;
+	else gone += 1;
+	return {
+		outcome: copied === 0 ? "already-done" : "done",
+		summary: {
+			copied,
+			kept,
+			skipped,
+			gone
+		}
+	};
+}
+async function planDropPerBrokerFlags(ports) {
+	const legacy = legacyFlags(await ports.readStored());
+	if (legacy.length === 0) return { edits: [] };
+	const byBroker = instanceByBroker(await ports.listInstances());
+	const rowId = (key) => `${HA_EXPORT_ADDON_ID}.${key}`;
+	const drop = [];
+	for (const entry of legacy) {
+		const instance = byBroker.get(entry.brokerId);
+		if (instance === void 0) continue;
+		if (!(entry.flag in instance.settings)) throw new Error(`homeassistant-export: ${entry.storeKey} is not dropped, integration ${instance.integrationId} does not show ${entry.flag}`);
+		if (instance.settings[entry.flag] === entry.value) drop.push(entry);
+	}
+	if (drop.length === 0) return { edits: [] };
+	return { edits: [{
+		op: "deleteKeys",
+		scope: ADDON_SETTINGS_TABLE,
+		keys: drop.map((entry) => rowId(entry.storeKey)),
+		precondition: preconditionOf(Object.fromEntries(drop.map((entry) => [rowId(entry.storeKey), {
+			addonId: HA_EXPORT_ADDON_ID,
+			key: entry.storeKey,
+			value: entry.value
+		}])))
+	}] };
+}
+//#endregion
+//#region src/ha-export/migrations/index.ts
+/** The `homeassistant-export` catalogue (D987): offered to the engine when the addon initialises. */
+var ADDON_MIGRATIONS = [
+	{
+		meta: {
+			id: "homeassistant-export/2026-11-02-drop-public-base-url",
+			owner: "homeassistant-export",
+			level: "addon-state",
+			seq: 1,
+			dependsOn: [],
+			store: "settings",
+			scope: "cluster",
+			onFailure: "tolerate",
+			bodyKind: "plan",
+			description: "Delete the retired publicBaseUrl setting; each instance now chooses a hub address role",
+			fixtureMark: "the reconcile interval the migration does not know"
+		},
+		plan: planDropPublicBaseUrl
+	},
+	{
+		meta: {
+			id: "homeassistant-export/2026-11-03-per-broker-flags-to-integration",
+			owner: "homeassistant-export",
+			level: "addon-state",
+			seq: 2,
+			dependsOn: [],
+			store: "settings",
+			scope: "cluster",
+			onFailure: "tolerate",
+			bodyKind: "procedure",
+			description: "Copy each exportTo:<broker> and mediaRole:<broker> key to the settings of the integration that links the broker",
+			fixtureMark: "the broker link stored beside the flags of an integration"
+		},
+		procedure: copyFlagsToIntegrations
+	},
+	{
+		meta: {
+			id: "homeassistant-export/2026-11-03-drop-per-broker-flags",
+			owner: "homeassistant-export",
+			level: "addon-state",
+			seq: 3,
+			dependsOn: ["homeassistant-export/2026-11-03-per-broker-flags-to-integration"],
+			store: "settings",
+			scope: "cluster",
+			onFailure: "tolerate",
+			bodyKind: "plan",
+			description: "Delete the per-broker keys once the integration shows the same flag",
+			fixtureMark: "a legacy flag parked when the integration holds a different one"
+		},
+		plan: planDropPerBrokerFlags
+	}
+];
+//#endregion
+//#region src/ha-export/instance-flags.ts
+var exportKey = (brokerId) => `exportTo:${brokerId}`;
+var KEYS = [{
+	flag: "exportTo",
+	keyOf: exportKey
+}, {
+	flag: "mediaRole",
+	keyOf: mediaRoleKey
+}];
+function splitInstanceKeys(patch, instances) {
+	const claimed = /* @__PURE__ */ new Set();
+	const toInstances = /* @__PURE__ */ new Map();
+	for (const row of instances) {
+		if (row.brokerId === null) continue;
+		for (const { flag, keyOf } of KEYS) {
+			const key = keyOf(row.brokerId);
+			if (!(key in patch)) continue;
+			claimed.add(key);
+			toInstances.set(row.integrationId, {
+				...toInstances.get(row.integrationId),
+				[flag]: patch[key]
+			});
+		}
+	}
+	return {
+		toInstances,
+		rest: Object.fromEntries(Object.entries(patch).filter(([key]) => !claimed.has(key)))
+	};
+}
+/** The form's dynamic keys carrying each instance's own value. */
+function instanceOverlay(instances) {
+	const overlay = {};
+	for (const row of instances) {
+		if (row.brokerId === null) continue;
+		for (const { flag, keyOf } of KEYS) {
+			const value = row.settings[flag];
+			if (value !== void 0) overlay[keyOf(row.brokerId)] = value;
+		}
+	}
+	return overlay;
+}
+//#endregion
 //#region src/ha-export/node-reads.ts
 var UNREAD = {
 	footageUsedBytes: null,
@@ -7391,7 +7598,10 @@ var HaExportAddon = class extends BaseAddon {
 		super({ ...DEFAULT_CONFIG });
 	}
 	async onInitialize() {
-		await this.runMigrations(defineAddonMigrations(ADDON_MIGRATIONS, { readStored: async () => this.resolveGlobalStore() }));
+		await this.runMigrations(defineAddonMigrations(ADDON_MIGRATIONS, {
+			readStored: async () => this.resolveGlobalStore(),
+			...this.instancePorts()
+		}));
 		const secret = this.state("haExportMediaSecret", string(), "");
 		const existing = await secret.get();
 		if (existing.length === 0) {
@@ -7475,6 +7685,35 @@ var HaExportAddon = class extends BaseAddon {
 			}
 		];
 	}
+	/**
+	* The form of the addon shows each instance's own switch and media role: the values sit on its
+	* integration (D985), overlaid on the legacy keys the store may still hold.
+	*/
+	async getGlobalSettings(overlay, cap, nodeId) {
+		const rows = await listInstancesOrNothing(this.instancePorts(), (error) => this.ctx.logger.warn("ha-export: the instance settings could not be read for the form", { meta: { error } }));
+		return super.getGlobalSettings({
+			...overlay,
+			...instanceOverlay(rows)
+		}, cap, nodeId);
+	}
+	/**
+	* An operator write: the `exportTo:` / `mediaRole:` keys go to the integration of their broker
+	* (D985), everything else to the addon store as before. A key whose broker has no integration
+	* stays in the store.
+	*/
+	async updateGlobalSettingsAsOperator(patch, nodeId) {
+		const ports = this.instancePorts();
+		const { toInstances, rest } = splitInstanceKeys(patch, await ports.listInstances());
+		for (const [integrationId, flags] of toInstances) {
+			if (await ports.patchInstanceSettings(integrationId, flags)) continue;
+			throw new Error(`ha-export: integration ${integrationId} is gone — the setting was not saved`);
+		}
+		if (Object.keys(rest).length > 0 || toInstances.size === 0) {
+			await super.updateGlobalSettingsAsOperator(rest, nodeId);
+			return;
+		}
+		await this.onConfigChanged();
+	}
 	async onConfigChanged() {
 		for (const link of this.links.values()) link.client.resetBackoff();
 		await this.reconcile("config-changed");
@@ -9114,7 +9353,20 @@ var HaExportAddon = class extends BaseAddon {
 	enabled = [];
 	async refreshEnabledBrokers(known) {
 		const store = await this.resolveGlobalStore();
-		this.enabled = enabledBrokerIds(store, known.map((broker) => broker.id));
+		this.enabled = enabledBrokerIds(store, known.map((broker) => broker.id), await this.readInstanceSettings());
+	}
+	/** The hub's `integrations` capability, as the one reader and writer of an instance's settings. */
+	instancePorts() {
+		return haInstanceSettingsPortsOver(this.ctx.api.integrations);
+	}
+	/**
+	* Each broker's integration settings (D985): the switch and the media role of an instance.
+	* A read that fails answers nothing, so every broker falls back to its legacy key and the
+	* failure is logged — never read as "everything off".
+	*/
+	async readInstanceSettings() {
+		const rows = await listInstancesOrNothing(this.instancePorts(), (error) => this.ctx.logger.warn("ha-export: the instance settings could not be read — the legacy per-broker keys answer", { meta: { error } }));
+		return rows.length === 0 ? NO_INSTANCE_SETTINGS : settingsByBroker(rows);
 	}
 	enabledBrokerIds() {
 		return this.enabled;
@@ -9515,7 +9767,7 @@ var HaExportAddon = class extends BaseAddon {
 	async mediaBasesFor(brokerIds, deviceId) {
 		let bases;
 		try {
-			bases = mediaBasesByBroker(await this.resolveGlobalStore(), brokerIds, await this.ctx.api.localNetwork.getAddresses.query());
+			bases = mediaBasesByBroker(await this.resolveGlobalStore(), brokerIds, await this.ctx.api.localNetwork.getAddresses.query(), await this.readInstanceSettings());
 		} catch (err) {
 			this.ctx.logger.debug("ha-export: could not resolve the media base URLs", {
 				tags: { deviceId },