@camstack/addon-provider-homeassistant 1.2.653 → 1.2.654

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { $ as humidifierCapability, $t as boolean, A as brightnessCapability, At as switchCapability, Bt as weatherCapability, C as alarmPanelCapability, Ct as runningFromLawnMower, D as bestLocationMatch, Dt as scriptRunnerCapability, E as batteryCapability, Et as runningStateCapability, F as calendarSourceCapability, Ft as updateCapability, G as deviceAdminLinkCapability, H as contactCapability, Ht as RecordSecretUnavailableError, I as carbonMonoxideCapability, It as vacuumControlCapability, J as enumSensorCapability, Jt as entryBody, K as deviceAdoptionCapability, Kt as defineEntryKind, L as climateControlCapability, Lt as valveCapability, M as buildAddonRouteProvider, Mt as temperatureSensorCapability, N as buildDeviceAdminUrl, Nt as tryConvertDelta, O as binaryCapability, P as buttonCapability, Pt as tryConvertUnit, Q as gasCapability, Qt as array, R as colorCapability, Rt as vibrationCapability, S as airQualitySensorCapability, T as automationControlCapability, Tt as runningFromVacuumState, U as controlCapability, Ut as baseUnitOf, W as coverCapability, Wt as createEvent, X as fanControlCapability, Y as eventEmitterCapability, Z as floodCapability, Zt as _enum, _t as pressureSensorCapability, a as BaseDevice, an as string, at as mediaPlayerCapability, b as accessoriesCapability, bt as quantityFromUnit, cn as url, ct as notificationOutputCapability, dn as DeviceType, en as discriminatedUnion, et as humiditySensorCapability, fn as errMsg, ft as parseAdminBase, gt as presenceCapability, ht as prepareNotification, in as record, it as lockControlCapability, j as brokerCapability, jt as tamperCapability, k as boardKeySourceCapability, kt as smokeCapability, ln as DeviceFeature, lt as notifierCapability, nn as number, nt as ingestReading, o as BaseDeviceProvider, on as union, ot as motionCapability, p as EnumSensorDateTimeFormatSchema, pn as EventCategory, pt as powerMeterCapability, qt as defineRecordKinds, rn as object, rt as lawnMowerControlCapability, sn as unknown, st as normalizeUnit, t as HA_BROKER_KIND, tn as literal, tt as imageCapability, un as DeviceRole, ut as numericSensorCapability, v as RUNNING_STATE_COLD, w as ambientLightSensorCapability, wt as runningFromMediaPlayer, x as addonRoutesCapability, xt as resolveAttachmentUrls, y as TargetSchema, yt as publicEndpointReaderFrom, z as connectivityCapability, zt as waterHeaterCapability } from "./ha-broker-source-CKdH9XHn.mjs";
+import { $ as fanControlCapability, A as bestLocationMatch, At as scriptRunnerCapability, B as climateControlCapability, Bt as valveCapability, C as accessoriesCapability, Ct as quantityFromUnit, D as ambientLightSensorCapability, Dt as runningFromMediaPlayer, E as alarmPanelCapability, Et as runningFromLawnMower, F as buildAddonRouteProvider, Ft as temperatureSensorCapability, G as contactCapability, Gt as RecordSecretUnavailableError, H as connectivityCapability, Ht as waterHeaterCapability, I as buildDeviceAdminUrl, It as tryConvertDelta, J as deviceAdminLinkCapability, Jt as defineAddonMigrations, K as controlCapability, Kt as baseUnitOf, L as buttonCapability, Lt as tryConvertUnit, M as boardKeySourceCapability, Mt as smokeCapability, N as brightnessCapability, Nt as switchCapability, O as automationControlCapability, Ot as runningFromVacuumState, P as brokerCapability, Pt as tamperCapability, Q as eventEmitterCapability, R as calendarSourceCapability, Rt as updateCapability, S as TargetSchema, St as publicEndpointReaderFrom, T as airQualitySensorCapability, Ut as weatherCapability, V as colorCapability, Vt as vibrationCapability, Xt as defineRecordKinds, Y as deviceAdoptionCapability, Yt as defineEntryKind, Z as enumSensorCapability, Zt as entryBody, _t as preconditionOf, an as number, at as ingestReading, bt as pressureSensorCapability, c as BaseDevice, cn as string, ct as mediaPlayerCapability, dn as url, dt as notificationOutputCapability, en as _enum, et as floodCapability, fn as DeviceFeature, ft as notifierCapability, g as EnumSensorDateTimeFormatSchema, gn as EventCategory, gt as powerMeterCapability, hn as errMsg, ht as parseAdminBase, i as HA_BROKER_KIND, in as literal, it as imageCapability, j as binaryCapability, k as batteryCapability, kt as runningStateCapability, l as BaseDeviceProvider, ln as union, lt as motionCapability, mn as DeviceType, nn as boolean, nt as humidifierCapability, on as object, ot as lawnMowerControlCapability, pn as DeviceRole, pt as numericSensorCapability, q as coverCapability, qt as createEvent, rn as discriminatedUnion, rt as humiditySensorCapability, sn as record, st as lockControlCapability, t as haInstanceSettingsPortsOver, tn as array, tt as gasCapability, un as unknown, ut as normalizeUnit, vt as prepareNotification, w as addonRoutesCapability, wt as resolveAttachmentUrls, x as RUNNING_STATE_COLD, yt as presenceCapability, z as carbonMonoxideCapability, zt as vacuumControlCapability } from "./ha-instance-settings-g5pwb3Fi.mjs";
 import { randomUUID } from "node:crypto";
 import { brotliCompressSync, deflateSync, gzipSync } from "node:zlib";
 //#region src/ha-admin-link.ts
@@ -2496,11 +2496,33 @@ var HaMediaPlayerDevice = class extends HaBaseChildDevice {
 	registerRunningCap() {
 		this.ctx.registerNativeCap(runningStateCapability, { getStatus: async () => this.runtimeState.getCapState("running-state") ?? RUNNING_STATE_COLD });
 	}
+	/** One service call per step, in order: HA has no "N steps" form. */
+	async repeatHaService(service, steps) {
+		for (let step = 0; step < steps; step += 1) await this.callHaService("media_player", service);
+	}
 	registerMediaPlayerCap() {
 		this.ctx.registerNativeCap(mediaPlayerCapability, {
 			getStatus: async () => {
 				return this.runtimeState.getCapState("media-player") ?? COLD_START$10;
 			},
+			turnOn: async () => {
+				await this.callHaService("media_player", "turn_on");
+			},
+			turnOff: async () => {
+				await this.callHaService("media_player", "turn_off");
+			},
+			volumeUp: async ({ steps }) => {
+				await this.repeatHaService("volume_up", steps);
+			},
+			volumeDown: async ({ steps }) => {
+				await this.repeatHaService("volume_down", steps);
+			},
+			channelUp: async ({ steps }) => {
+				await this.repeatHaService("media_next_track", steps);
+			},
+			channelDown: async ({ steps }) => {
+				await this.repeatHaService("media_previous_track", steps);
+			},
 			play: async () => {
 				await this.callHaService("media_player", "media_play");
 			},
@@ -6439,6 +6461,8 @@ function mapMediaPlayer(attributes) {
 		if ((sf & 8) !== 0) features.push(DeviceFeature.MediaPlayerMute);
 		if ((sf & 16) !== 0) features.push(DeviceFeature.MediaPlayerPrevious);
 		if ((sf & 32) !== 0) features.push(DeviceFeature.MediaPlayerNext);
+		if ((sf & 384) === 384) features.push(DeviceFeature.MediaPlayerPower);
+		if ((sf & 1024) !== 0) features.push(DeviceFeature.MediaPlayerVolumeStep);
 		if ((sf & 512) !== 0) features.push(DeviceFeature.MediaPlayerPlayMedia);
 		if ((sf & 2048) !== 0) features.push(DeviceFeature.MediaPlayerSelectSource);
 		if ((sf & 4096) !== 0) features.push(DeviceFeature.MediaPlayerStop);
@@ -7932,6 +7956,127 @@ function createHaBoardKeyProvider(source) {
 	};
 }
 //#endregion
+//#region src/migrations/calendar-ids-to-integration.ts
+/**
+* The HA calendars an instance imports are a fact of THAT instance (D985): each Home Assistant
+* integration carries its own `calendarIds` in its settings, and the addon-level `calendarIds`
+* setting (one set of `calendar.*` entity ids for every broker) goes away.
+*
+* Two migrations, in this order:
+*
+* 1. `calendar-ids-to-integration` (procedure) copies the shared set to EVERY integration that
+*    has no `calendarIds` yet. An integration that already has one is never overwritten; one
+*    deleted meanwhile is skipped, never recreated; a stored value that is not a list of strings
+*    is an ambiguity and throws (nothing is guessed).
+* 2. `drop-shared-calendar-ids` (plan) deletes the shared setting after a read-back: every
+*    integration must show its own set. When one holds a set that differs from the shared one,
+*    the shared value is the loser and stays PARKED in place, never deleted.
+*
+* Both are idempotent.
+*/
+var HA_PROVIDER_ID = "provider-homeassistant";
+/** The canonical settings table: one row per key, id `<addonId>.<key>`. */
+var ADDON_SETTINGS_TABLE = "addon-settings";
+var SHARED_CALENDAR_IDS_KEY = "calendarIds";
+async function readSharedSet(ports) {
+	const answer = await ports.readStored(SHARED_CALENDAR_IDS_KEY);
+	if (answer.kind === "unreadable") throw new Error(`provider-homeassistant: the shared calendarIds cannot be read (${answer.reason})`);
+	if (answer.kind === "absent") return null;
+	const value = answer.value;
+	if (!Array.isArray(value) || !value.every((item) => typeof item === "string")) throw new Error("provider-homeassistant: the shared calendarIds is not a list of entity ids — nothing copied");
+	return value;
+}
+async function copyCalendarIdsToIntegrations(ports) {
+	const shared = await readSharedSet(ports);
+	if (shared === null) return {
+		outcome: "already-done",
+		summary: { reason: "no-shared-set" }
+	};
+	let copied = 0;
+	let kept = 0;
+	let gone = 0;
+	for (const instance of await ports.listInstances()) {
+		if ("calendarIds" in instance.settings) {
+			kept += 1;
+			continue;
+		}
+		if (await ports.patchInstanceSettings(instance.integrationId, { calendarIds: [...shared] })) copied += 1;
+		else gone += 1;
+	}
+	return {
+		outcome: copied === 0 ? "already-done" : "done",
+		summary: {
+			copied,
+			kept,
+			gone
+		}
+	};
+}
+var asIds = (value) => Array.isArray(value) && value.every((item) => typeof item === "string") ? value : null;
+var sameSet = (a, b) => {
+	const left = new Set(a);
+	const right = new Set(b);
+	return left.size === right.size && [...left].every((id) => right.has(id));
+};
+async function planDropSharedCalendarIds(ports) {
+	const shared = await readSharedSet(ports);
+	if (shared === null) return { edits: [] };
+	const instances = await ports.listInstances();
+	if (instances.length === 0) return { edits: [] };
+	const own = instances.map((instance) => ({
+		integrationId: instance.integrationId,
+		ids: asIds(instance.settings[SHARED_CALENDAR_IDS_KEY])
+	}));
+	const missing = own.filter((entry) => entry.ids === null);
+	if (missing.length > 0) throw new Error(`provider-homeassistant: the shared calendarIds is not dropped, ${missing.map((m) => m.integrationId).join(", ")} has no set of its own`);
+	if (!own.every((entry) => sameSet(entry.ids ?? [], shared))) return { edits: [] };
+	const rowId = `${HA_PROVIDER_ID}.${SHARED_CALENDAR_IDS_KEY}`;
+	return { edits: [{
+		op: "deleteKeys",
+		scope: ADDON_SETTINGS_TABLE,
+		keys: [rowId],
+		precondition: preconditionOf({ [rowId]: {
+			addonId: HA_PROVIDER_ID,
+			key: SHARED_CALENDAR_IDS_KEY,
+			value: shared
+		} })
+	}] };
+}
+//#endregion
+//#region src/migrations/index.ts
+/** The `provider-homeassistant` catalogue (D987): offered to the engine when the addon initialises. */
+var ADDON_MIGRATIONS = [{
+	meta: {
+		id: "provider-homeassistant/2026-11-03-calendar-ids-to-integration",
+		owner: "provider-homeassistant",
+		level: "addon-state",
+		seq: 1,
+		dependsOn: [],
+		store: "settings",
+		scope: "cluster",
+		onFailure: "tolerate",
+		bodyKind: "procedure",
+		description: "Copy the shared calendar set to the settings of every Home Assistant integration that has none",
+		fixtureMark: "the broker link stored beside the calendars of an integration"
+	},
+	procedure: copyCalendarIdsToIntegrations
+}, {
+	meta: {
+		id: "provider-homeassistant/2026-11-03-drop-shared-calendar-ids",
+		owner: "provider-homeassistant",
+		level: "addon-state",
+		seq: 2,
+		dependsOn: ["provider-homeassistant/2026-11-03-calendar-ids-to-integration"],
+		store: "settings",
+		scope: "cluster",
+		onFailure: "tolerate",
+		bodyKind: "plan",
+		description: "Delete the shared calendar set once every integration shows its own",
+		fixtureMark: "the shared set parked when an integration holds a different one"
+	},
+	plan: planDropSharedCalendarIds
+}];
+//#endregion
 //#region src/ha-calendar-source.ts
 function isCalendarEntity(entityId) {
 	return entityId.startsWith("calendar.");
@@ -8042,9 +8187,9 @@ function isSelected(entityId, selected) {
 function createHaCalendarSource(deps) {
 	return {
 		listCalendars: async () => {
-			const selected = deps.selectedCalendarIds();
 			const out = [];
-			for (const { manager } of deps.brokers.listManagers()) {
+			for (const { brokerId, manager } of deps.brokers.listManagers()) {
+				const selected = deps.selectedCalendarIds(brokerId);
 				const states = manager.snapshotAllStates();
 				for (const [entityId, raw] of Object.entries(states)) {
 					if (!isCalendarEntity(entityId)) continue;
@@ -8064,10 +8209,10 @@ function createHaCalendarSource(deps) {
 		listEvents: async (input) => {
 			const startIso = new Date(input.startMs).toISOString();
 			const endIso = new Date(input.endMs).toISOString();
-			const selected = deps.selectedCalendarIds();
 			const wanted = input.calendarIds !== void 0 && input.calendarIds.length > 0 ? new Set(input.calendarIds) : null;
 			const out = [];
 			for (const { brokerId, manager } of deps.brokers.listManagers()) {
+				const selected = deps.selectedCalendarIds(brokerId);
 				const states = manager.snapshotAllStates();
 				const entityIds = Object.keys(states).filter((id) => {
 					if (!isCalendarEntity(id)) return false;
@@ -8091,10 +8236,11 @@ function createHaCalendarSource(deps) {
 	};
 }
 /** Discover every HA calendar entity (ignores the import filter) — for settings catalog. */
-function listHaCalendarCatalog(brokers) {
+function listHaCalendarCatalog(brokers, onlyBrokerId) {
 	const out = [];
 	const seen = /* @__PURE__ */ new Set();
-	for (const { manager } of brokers.listManagers()) {
+	for (const { brokerId, manager } of brokers.listManagers()) {
+		if (onlyBrokerId !== void 0 && brokerId !== onlyBrokerId) continue;
 		const states = manager.snapshotAllStates();
 		for (const [entityId, raw] of Object.entries(states)) {
 			if (!isCalendarEntity(entityId) || seen.has(entityId)) continue;
@@ -8628,6 +8774,10 @@ var HaProviderAddon = class HaProviderAddon extends BaseDeviceProvider {
 			this.reconcileAllConnectedBrokers();
 		}, HaProviderAddon.RESYNC_INTERVAL_MS);
 		this.ctx.logger.info("ha provider initialised", { meta: { brokerCount: this.activeBrokers.length } });
+		await this.runMigrations(defineAddonMigrations(ADDON_MIGRATIONS, {
+			readStored: (key) => this.readStoredGlobalKey(key),
+			...haInstanceSettingsPortsOver(this.ctx.api.integrations)
+		}));
 		await this.reconcileIntegrationsToBrokers();
 		this.subscribeIntegrationLifecycle();
 		return [
@@ -8656,7 +8806,7 @@ var HaProviderAddon = class HaProviderAddon extends BaseDeviceProvider {
 				provider: createHaCalendarSource({
 					brokers: this.requireRegistry(),
 					logger: this.ctx.logger.child("calendar-source"),
-					selectedCalendarIds: () => new Set(this.config.calendarIds ?? [])
+					selectedCalendarIds: (brokerId) => this.calendarIdsOf(brokerId)
 				})
 			}
 		];
@@ -8754,6 +8904,20 @@ var HaProviderAddon = class HaProviderAddon extends BaseDeviceProvider {
 	*
 	* Idempotent — runs on boot + on every integration.* event.
 	*/
+	/**
+	* Calendars to import, per broker (D985): the integration's own selection, filled by the
+	* reconcile that already reads each integration's settings. A broker whose integration has no
+	* selection yet (the move has not run) uses the legacy shared set, so a boot mid-move never
+	* changes what is imported.
+	*/
+	calendarIdsByBroker = /* @__PURE__ */ new Map();
+	noteInstanceCalendars(brokerId, raw) {
+		if (Array.isArray(raw) && raw.every((id) => typeof id === "string")) this.calendarIdsByBroker.set(brokerId, new Set(raw));
+		else this.calendarIdsByBroker.delete(brokerId);
+	}
+	calendarIdsOf(brokerId) {
+		return this.calendarIdsByBroker.get(brokerId) ?? new Set(this.config.calendarIds ?? []);
+	}
 	async reconcileIntegrationsToBrokers() {
 		const api = this.ctx.api;
 		if (!api.integrations?.list?.query || !api.integrations.getSettings?.query) return;
@@ -8765,6 +8929,7 @@ var HaProviderAddon = class HaProviderAddon extends BaseDeviceProvider {
 				const settings = await api.integrations.getSettings.query({ id: integration.id });
 				const brokerId = typeof settings["brokerId"] === "string" ? settings["brokerId"] : null;
 				if (!brokerId) continue;
+				this.noteInstanceCalendars(brokerId, settings["calendarIds"]);
 				if (!this.activeBrokers.find((b) => b.id === brokerId)) {
 					this.ctx.logger.warn("integration→broker: linked broker not found", { meta: {
 						integrationId: integration.id,
@@ -8804,23 +8969,7 @@ var HaProviderAddon = class HaProviderAddon extends BaseDeviceProvider {
 		eb.subscribe({ category: "integration.disabled" }, handler);
 		eb.subscribe({ category: "integration.deleted" }, handler);
 	}
-	globalSettingsSchema(cap) {
-		if (cap === "calendar-source") return this.schema({ sections: [{
-			id: "ha-calendars-import",
-			title: "Calendars to import",
-			titleKey: "provider-homeassistant:globalSettings.s_ha-calendars-import.title",
-			columns: 1,
-			fields: [{
-				type: "multiselect",
-				key: "calendarIds",
-				label: "Calendars",
-				labelKey: "provider-homeassistant:globalSettings.s_ha-calendars-import.calendarIds.label",
-				options: [],
-				optionsFrom: "_calendarCatalog",
-				description: "Discovered from connected HA brokers. Select at least one to import; leave empty to import none.",
-				descriptionKey: "provider-homeassistant:globalSettings.s_ha-calendars-import.calendarIds.description"
-			}]
-		}] });
+	globalSettingsSchema(_cap) {
 		return this.schema({ sections: [{
 			id: "ha-broker",
 			title: "Home Assistant broker",
@@ -8835,14 +8984,39 @@ var HaProviderAddon = class HaProviderAddon extends BaseDeviceProvider {
 			}]
 		}] });
 	}
-	async getGlobalSettings(overlay, cap, nodeId) {
-		if (cap !== "calendar-source") return super.getGlobalSettings(overlay, cap, nodeId);
-		const catalog = this.registry ? listHaCalendarCatalog(this.registry) : [];
-		return super.getGlobalSettings({
-			...overlay,
-			calendarIds: this.config.calendarIds ?? [],
-			...catalog.length > 0 ? { _calendarCatalog: catalog } : {}
-		}, cap, nodeId);
+	/**
+	* The calendars of ONE Home Assistant instance (D985): picked on its integration, offered from
+	* that broker's own `calendar.*` entities.
+	*/
+	async integrationSettingsSchema(instance) {
+		if (instance.integrationId === null || !this.registry) return null;
+		let brokerId;
+		try {
+			brokerId = (await this.ctx.api.integrations.getSettings.query({ id: instance.integrationId }))["brokerId"];
+		} catch (err) {
+			this.ctx.logger.warn("HA integration form: instance lookup failed — broker form shown", { meta: {
+				integrationId: instance.integrationId,
+				error: errMsg(err)
+			} });
+			return null;
+		}
+		if (typeof brokerId !== "string") return null;
+		const options = listHaCalendarCatalog(this.registry, brokerId);
+		return this.schema({ sections: [{
+			id: "ha-calendars-import",
+			title: "Calendars to import",
+			titleKey: "provider-homeassistant:globalSettings.s_ha-calendars-import.title",
+			columns: 1,
+			fields: [{
+				type: "multiselect",
+				key: "calendarIds",
+				label: "Calendars",
+				labelKey: "provider-homeassistant:globalSettings.s_ha-calendars-import.calendarIds.label",
+				options,
+				description: "Discovered from this Home Assistant instance. Select at least one to import; leave empty to import none.",
+				descriptionKey: "provider-homeassistant:globalSettings.s_ha-calendars-import.calendarIds.description"
+			}]
+		}] });
 	}
 	async onShutdown() {
 		if (this.resyncTimer) {