@camstack/addon-provider-homeassistant 1.2.153 → 1.2.154

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dist = require("./dist-DMn4t1u_.js");
+const require_dist = require("./dist-DLQgcqQT.js");
 let node_crypto = require("node:crypto");
 let node_zlib = require("node:zlib");
 //#region src/ha-admin-link.ts
@@ -5130,6 +5130,7 @@ var HaIntegrationManager = class HaIntegrationManager {
 		if (target.deviceId) targetEnvelope["device_id"] = target.deviceId;
 		if (Object.keys(targetEnvelope).length > 0) message["target"] = targetEnvelope;
 		if (payload !== void 0 && payload !== null) message["service_data"] = payload;
+		if (target.returnResponse === true) message["return_response"] = true;
 		const result = await conn.sendMessagePromise(message);
 		if (result && typeof result === "object") return result;
 		return null;
@@ -7071,6 +7072,122 @@ function createHaNotificationOutputProvider(deps) {
 	};
 }
 //#endregion
+//#region src/ha-calendar-source.ts
+function isCalendarEntity(entityId) {
+	return entityId.startsWith("calendar.");
+}
+function calendarName(state) {
+	const friendly = state.attributes["friendly_name"];
+	if (typeof friendly === "string" && friendly.trim().length > 0) return friendly.trim();
+	return state.entity_id.replace(/^calendar\./, "").replace(/_/g, " ");
+}
+function parseHaDate(value) {
+	if (typeof value !== "string" || value.length === 0) return null;
+	const ms = Date.parse(value.length === 10 ? `${value}T00:00:00` : value);
+	return Number.isFinite(ms) ? ms : null;
+}
+function isRecord(x) {
+	return typeof x === "object" && x !== null && !Array.isArray(x);
+}
+function asEntityState(raw) {
+	const parsed = HaEntityStateSchema.safeParse(raw);
+	return parsed.success ? parsed.data : null;
+}
+/**
+* HA's `calendar.list_events` response shape (return_response):
+* `{ response: { [entity_id]: { events: [...] } } }` or a flat
+* `{ events: [...] }` depending on target width.
+*/
+function extractEvents(result, entityId) {
+	if (!isRecord(result)) return [];
+	const response = result["response"];
+	if (isRecord(response)) {
+		const forEntity = response[entityId];
+		if (isRecord(forEntity) && Array.isArray(forEntity["events"])) return forEntity["events"].filter(isRecord);
+		for (const value of Object.values(response)) if (isRecord(value) && Array.isArray(value["events"])) return value["events"].filter(isRecord);
+	}
+	if (Array.isArray(result["events"])) return result["events"].filter(isRecord);
+	return [];
+}
+function mapEvent(entityId, raw, index) {
+	const startRaw = raw["start"];
+	const endRaw = raw["end"];
+	const startMs = parseHaDate(isRecord(startRaw) ? startRaw["dateTime"] ?? startRaw["date"] : raw["start"] ?? raw["start_date_time"] ?? raw["dtstart"]);
+	const endMs = parseHaDate(isRecord(endRaw) ? endRaw["dateTime"] ?? endRaw["date"] : raw["end"] ?? raw["end_date_time"] ?? raw["dtend"]) ?? startMs;
+	if (startMs === null || endMs === null) return null;
+	const summary = raw["summary"] ?? raw["title"];
+	const title = typeof summary === "string" ? summary : "(no title)";
+	const uid = raw["uid"] ?? raw["id"];
+	const id = typeof uid === "string" && uid.length > 0 ? `${entityId}:${uid}` : `${entityId}:${String(startMs)}:${String(index)}`;
+	const description = raw["description"];
+	const location = raw["location"];
+	return {
+		id,
+		calendarId: entityId,
+		title,
+		startMs,
+		endMs,
+		...isRecord(startRaw) && typeof startRaw["date"] === "string" || typeof raw["start"] === "string" && raw["start"].length === 10 ? { allDay: true } : {},
+		...typeof description === "string" && description.length > 0 ? { description } : {},
+		...typeof location === "string" && location.length > 0 ? { location } : {}
+	};
+}
+function createHaCalendarSource(deps) {
+	return {
+		listCalendars: async () => {
+			const out = [];
+			for (const { manager } of deps.brokers.listManagers()) {
+				const states = manager.snapshotAllStates();
+				for (const [entityId, raw] of Object.entries(states)) {
+					if (!isCalendarEntity(entityId)) continue;
+					const state = asEntityState(raw);
+					if (state === null) continue;
+					out.push({
+						id: entityId,
+						name: calendarName(state),
+						source: "ha",
+						enabled: state.state !== "unavailable"
+					});
+				}
+			}
+			return out;
+		},
+		listEvents: async (input) => {
+			const startIso = new Date(input.startMs).toISOString();
+			const endIso = new Date(input.endMs).toISOString();
+			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 states = manager.snapshotAllStates();
+				const entityIds = Object.keys(states).filter((id) => isCalendarEntity(id) && (wanted === null || wanted.has(id)));
+				for (const entityId of entityIds) try {
+					const target = {
+						domain: "calendar",
+						service: "list_events",
+						entityId,
+						returnResponse: true
+					};
+					const rawEvents = extractEvents(await manager.publish(target, {
+						start_date_time: startIso,
+						end_date_time: endIso
+					}), entityId);
+					for (let i = 0; i < rawEvents.length; i += 1) {
+						const mapped = mapEvent(entityId, rawEvents[i], i);
+						if (mapped !== null) out.push(mapped);
+					}
+				} catch (err) {
+					deps.logger.warn("HA calendar.list_events failed", { meta: {
+						entityId,
+						brokerId,
+						error: err instanceof Error ? err.message : String(err)
+					} });
+				}
+			}
+			return out.toSorted((a, b) => a.startMs - b.startMs);
+		}
+	};
+}
+//#endregion
 //#region src/ha-reconcile-broker.ts
 /**
 * Run BOTH reconcilers for one broker off a SINGLE shared inventory fetch.
@@ -7596,6 +7713,13 @@ var HaProviderAddon = class HaProviderAddon extends require_dist.BaseDeviceProvi
 			{
 				capability: require_dist.addonRoutesCapability,
 				provider: createHaIconRouteProvider()
+			},
+			{
+				capability: require_dist.calendarSourceCapability,
+				provider: createHaCalendarSource({
+					brokers: this.requireRegistry(),
+					logger: this.ctx.logger.child("calendar-source")
+				})
 			}
 		];
 	}

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-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 DeviceType, 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, gt as DeviceRole, h as alarmPanelCapability, ht as DeviceFeature, 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 errMsg, w as buildDeviceAdminUrl, wt as discriminatedUnion, x as brightnessCapability, y as bestLocationMatch, z as floodCapability } from "./dist-evNLjXgk.mjs";
+import { A as connectivityCapability, At as string, B as floodCapability, C as buildAddonRouteProvider, Ct as _enum, D as carbonMonoxideCapability, Dt as number, E as calendarSourceCapability, Et as literal, F as deviceAdoptionCapability, G as lawnMowerControlCapability, H as humidifierCapability, J as motionCapability, K as lockControlCapability, L as enumSensorCapability, M as controlCapability, Mt as unknown, N as coverCapability, Nt as url, O as climateControlCapability, Ot as object, P as deviceAdminLinkCapability, Pt as EventCategory, Q as numericSensorCapability, R as eventEmitterCapability, S as brokerCapability, T as buttonCapability, Tt as discriminatedUnion, U as humiditySensorCapability, V as gasCapability, W as imageCapability, X as notificationOutputCapability, Y as normalizeUnit, Z as notifierCapability, _ as automationControlCapability, _t as DeviceRole, at as scriptRunnerCapability, b as binaryCapability, ct as tamperCapability, d as TargetSchema, dt as vacuumControlCapability, et as parseAdminBase, f as accessoriesCapability, ft as valveCapability, g as ambientLightSensorCapability, gt as DeviceFeature, h as alarmPanelCapability, ht as weatherCapability, it as pressureSensorCapability, j as contactCapability, jt as union, k as colorCapability, kt as record, lt as temperatureSensorCapability, m as airQualitySensorCapability, mt as waterHeaterCapability, n as BaseDevice, nt as prepareNotification, ot as smokeCapability, p as addonRoutesCapability, pt as vibrationCapability, q as mediaPlayerCapability, r as BaseDeviceProvider, rt as presenceCapability, s as EnumSensorDateTimeFormatSchema, st as switchCapability, tt as powerMeterCapability, ut as updateCapability, v as batteryCapability, vt as DeviceType, w as buildDeviceAdminUrl, wt as array, x as brightnessCapability, xt as createEvent, y as bestLocationMatch, yt as errMsg, z as fanControlCapability } from "./dist-CvzpCuzm.mjs";
 import { randomUUID } from "node:crypto";
 import { brotliCompressSync, deflateSync, gzipSync } from "node:zlib";
 //#region src/ha-admin-link.ts
@@ -5129,6 +5129,7 @@ var HaIntegrationManager = class HaIntegrationManager {
 		if (target.deviceId) targetEnvelope["device_id"] = target.deviceId;
 		if (Object.keys(targetEnvelope).length > 0) message["target"] = targetEnvelope;
 		if (payload !== void 0 && payload !== null) message["service_data"] = payload;
+		if (target.returnResponse === true) message["return_response"] = true;
 		const result = await conn.sendMessagePromise(message);
 		if (result && typeof result === "object") return result;
 		return null;
@@ -7070,6 +7071,122 @@ function createHaNotificationOutputProvider(deps) {
 	};
 }
 //#endregion
+//#region src/ha-calendar-source.ts
+function isCalendarEntity(entityId) {
+	return entityId.startsWith("calendar.");
+}
+function calendarName(state) {
+	const friendly = state.attributes["friendly_name"];
+	if (typeof friendly === "string" && friendly.trim().length > 0) return friendly.trim();
+	return state.entity_id.replace(/^calendar\./, "").replace(/_/g, " ");
+}
+function parseHaDate(value) {
+	if (typeof value !== "string" || value.length === 0) return null;
+	const ms = Date.parse(value.length === 10 ? `${value}T00:00:00` : value);
+	return Number.isFinite(ms) ? ms : null;
+}
+function isRecord(x) {
+	return typeof x === "object" && x !== null && !Array.isArray(x);
+}
+function asEntityState(raw) {
+	const parsed = HaEntityStateSchema.safeParse(raw);
+	return parsed.success ? parsed.data : null;
+}
+/**
+* HA's `calendar.list_events` response shape (return_response):
+* `{ response: { [entity_id]: { events: [...] } } }` or a flat
+* `{ events: [...] }` depending on target width.
+*/
+function extractEvents(result, entityId) {
+	if (!isRecord(result)) return [];
+	const response = result["response"];
+	if (isRecord(response)) {
+		const forEntity = response[entityId];
+		if (isRecord(forEntity) && Array.isArray(forEntity["events"])) return forEntity["events"].filter(isRecord);
+		for (const value of Object.values(response)) if (isRecord(value) && Array.isArray(value["events"])) return value["events"].filter(isRecord);
+	}
+	if (Array.isArray(result["events"])) return result["events"].filter(isRecord);
+	return [];
+}
+function mapEvent(entityId, raw, index) {
+	const startRaw = raw["start"];
+	const endRaw = raw["end"];
+	const startMs = parseHaDate(isRecord(startRaw) ? startRaw["dateTime"] ?? startRaw["date"] : raw["start"] ?? raw["start_date_time"] ?? raw["dtstart"]);
+	const endMs = parseHaDate(isRecord(endRaw) ? endRaw["dateTime"] ?? endRaw["date"] : raw["end"] ?? raw["end_date_time"] ?? raw["dtend"]) ?? startMs;
+	if (startMs === null || endMs === null) return null;
+	const summary = raw["summary"] ?? raw["title"];
+	const title = typeof summary === "string" ? summary : "(no title)";
+	const uid = raw["uid"] ?? raw["id"];
+	const id = typeof uid === "string" && uid.length > 0 ? `${entityId}:${uid}` : `${entityId}:${String(startMs)}:${String(index)}`;
+	const description = raw["description"];
+	const location = raw["location"];
+	return {
+		id,
+		calendarId: entityId,
+		title,
+		startMs,
+		endMs,
+		...isRecord(startRaw) && typeof startRaw["date"] === "string" || typeof raw["start"] === "string" && raw["start"].length === 10 ? { allDay: true } : {},
+		...typeof description === "string" && description.length > 0 ? { description } : {},
+		...typeof location === "string" && location.length > 0 ? { location } : {}
+	};
+}
+function createHaCalendarSource(deps) {
+	return {
+		listCalendars: async () => {
+			const out = [];
+			for (const { manager } of deps.brokers.listManagers()) {
+				const states = manager.snapshotAllStates();
+				for (const [entityId, raw] of Object.entries(states)) {
+					if (!isCalendarEntity(entityId)) continue;
+					const state = asEntityState(raw);
+					if (state === null) continue;
+					out.push({
+						id: entityId,
+						name: calendarName(state),
+						source: "ha",
+						enabled: state.state !== "unavailable"
+					});
+				}
+			}
+			return out;
+		},
+		listEvents: async (input) => {
+			const startIso = new Date(input.startMs).toISOString();
+			const endIso = new Date(input.endMs).toISOString();
+			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 states = manager.snapshotAllStates();
+				const entityIds = Object.keys(states).filter((id) => isCalendarEntity(id) && (wanted === null || wanted.has(id)));
+				for (const entityId of entityIds) try {
+					const target = {
+						domain: "calendar",
+						service: "list_events",
+						entityId,
+						returnResponse: true
+					};
+					const rawEvents = extractEvents(await manager.publish(target, {
+						start_date_time: startIso,
+						end_date_time: endIso
+					}), entityId);
+					for (let i = 0; i < rawEvents.length; i += 1) {
+						const mapped = mapEvent(entityId, rawEvents[i], i);
+						if (mapped !== null) out.push(mapped);
+					}
+				} catch (err) {
+					deps.logger.warn("HA calendar.list_events failed", { meta: {
+						entityId,
+						brokerId,
+						error: err instanceof Error ? err.message : String(err)
+					} });
+				}
+			}
+			return out.toSorted((a, b) => a.startMs - b.startMs);
+		}
+	};
+}
+//#endregion
 //#region src/ha-reconcile-broker.ts
 /**
 * Run BOTH reconcilers for one broker off a SINGLE shared inventory fetch.
@@ -7595,6 +7712,13 @@ var HaProviderAddon = class HaProviderAddon extends BaseDeviceProvider {
 			{
 				capability: addonRoutesCapability,
 				provider: createHaIconRouteProvider()
+			},
+			{
+				capability: calendarSourceCapability,
+				provider: createHaCalendarSource({
+					brokers: this.requireRegistry(),
+					logger: this.ctx.logger.child("calendar-source")
+				})
 			}
 		];
 	}

package/dist/{dist-evNLjXgk.mjs → dist-CvzpCuzm.mjs}

@@ -20687,14 +20687,52 @@ var NcAlarmNonBlockingEditSchema = object({
 	nonBlocking: boolean()
 });
 /**
+* Controllable openings: opt IN to blocking (default is do not block). Contacts
+* keep using {@link NcAlarmNonBlockingEditSchema}.
+*/
+var NcAlarmBlockingEditSchema = object({
+	mode: AlarmArmModeSchema,
+	deviceId: number().int().positive(),
+	/** true = on the list (blocks when open); false = off the list (default). */
+	blocking: boolean()
+});
+/**
+* Controllable openings: opt OUT of secure-on-arm (default is secure ON —
+* close / lock / turn off when this mode arms).
+*/
+var NcAlarmSecureOnArmEditSchema = object({
+	mode: AlarmArmModeSchema,
+	deviceId: number().int().positive(),
+	/** true = secure on arm (default); false = do not actuate on arm. */
+	secureOnArm: boolean()
+});
+/**
+* One arm mode's device-id list (non-blocking, blocking, or secure-on-arm-off).
+*/
+var NcAlarmModeDeviceListSchema = object({
+	mode: AlarmArmModeSchema,
+	deviceIds: array(number().int()).max(200)
+});
+/**
+* One arm mode's non-blocking list: devices that may be open when that mode
+* arms, without the arm being refused.
+*/
+var NcAlarmNonBlockingSchema = NcAlarmModeDeviceListSchema;
+/** Controllable devices that DO block when open (opt-in; default empty). */
+var NcAlarmBlockingSchema = NcAlarmModeDeviceListSchema;
+/**
+* Controllable devices that do NOT secure on arm (opt-out; default empty =
+* every controllable secures).
+*/
+var NcAlarmSecureOnArmOffSchema = NcAlarmModeDeviceListSchema;
+/**
 * The per-mode lists, at most one per mode. Two lists for one mode have no
 * meaning a reader could agree on (union? the last one?), so they are refused
 * at the boundary rather than interpreted.
 */
-var NcAlarmNonBlockingListSchema = array(object({
-	mode: AlarmArmModeSchema,
-	deviceIds: array(number().int()).max(200)
-})).max(8).refine(uniqueModes, { message: "nonBlocking: at most one list per arm mode" });
+var NcAlarmNonBlockingListSchema = array(NcAlarmNonBlockingSchema).max(8).refine(uniqueModes, { message: "nonBlocking: at most one list per arm mode" });
+var NcAlarmBlockingListSchema = array(NcAlarmBlockingSchema).max(8).refine(uniqueModes, { message: "blocking: at most one list per arm mode" });
+var NcAlarmSecureOnArmOffListSchema = array(NcAlarmSecureOnArmOffSchema).max(8).refine(uniqueModes, { message: "secureOnArmOff: at most one list per arm mode" });
 /**
 * The three durations — global, and per mode since D697 — the panel's state
 * machine runs on, who hears about its transitions, and which openings each mode tolerates.
@@ -20737,9 +20775,23 @@ var NcAlarmSettingsSchema = object({
 	* arm (a window left ajar for the cat under `home`, say). At most one entry
 	* per mode is meaningful. Defaulted to `[]` so a blob stored before D630
 	* parses as "every opening blocks" — the behaviour it was written under.
+	* Contacts use this list; controllable openings use {@link blocking} instead
+	* (default: do not block).
 	*/
 	nonBlocking: NcAlarmNonBlockingListSchema.default([]),
 	/**
+	* Per arm mode, controllable openings that DO refuse the arm when open.
+	* Default `[]` = none block (secure-on-arm closes them instead). Absent on a
+	* blob older than this field — read as empty.
+	*/
+	blocking: NcAlarmBlockingListSchema.default([]),
+	/**
+	* Per arm mode, controllable openings that must NOT be actuated on arm.
+	* Default `[]` = every controllable secures (close / lock / off). Absent on
+	* an older blob — read as empty (secure ON).
+	*/
+	secureOnArmOff: NcAlarmSecureOnArmOffListSchema.default([]),
+	/**
 	* Per arm mode, the delays that mode OVERRIDES (D697). A mode with no entry, or an entry
 	* without a field, uses the global value above — so `[]`, the default, is exactly the
 	* behaviour of a blob stored before this field existed. Read through `resolveModeDelays`.
@@ -20749,7 +20801,7 @@ var NcAlarmSettingsSchema = object({
 /**
 * Every field optional — a tab edits one control at a time.
 *
-* `nonBlocking` and `modeDelays` are re-declared WITHOUT their defaults:
+* List fields and `modeDelays` are re-declared WITHOUT their defaults:
 * `.partial()` does not remove an inner `.default()`, so a patch that never
 * named the field would parse to `[]` and wipe every mode's list on an
 * unrelated edit (the same trap {@link NcRulePatchSchema} documents). Here
@@ -20757,11 +20809,15 @@ var NcAlarmSettingsSchema = object({
 */
 var NcAlarmSettingsPatchSchema = NcAlarmSettingsSchema.extend({
 	nonBlocking: NcAlarmNonBlockingListSchema,
+	blocking: NcAlarmBlockingListSchema,
+	secureOnArmOff: NcAlarmSecureOnArmOffListSchema,
 	/** Per-mode, per-field edits — NOT the whole list (see NcAlarmModeDelaysEditSchema). */
 	modeDelays: NcAlarmModeDelaysEditListSchema,
 	/** ONE membership change; the panel applies it to the list it holds at its turn. */
-	nonBlockingEdit: NcAlarmNonBlockingEditSchema
-}).partial().refine((p) => p.nonBlocking === void 0 || p.nonBlockingEdit === void 0, { message: "nonBlocking and nonBlockingEdit are exclusive — send the whole lists or one edit" });
+	nonBlockingEdit: NcAlarmNonBlockingEditSchema,
+	blockingEdit: NcAlarmBlockingEditSchema,
+	secureOnArmEdit: NcAlarmSecureOnArmEditSchema
+}).partial().refine((p) => p.nonBlocking === void 0 || p.nonBlockingEdit === void 0, { message: "nonBlocking and nonBlockingEdit are exclusive — send the whole lists or one edit" }).refine((p) => p.blocking === void 0 || p.blockingEdit === void 0, { message: "blocking and blockingEdit are exclusive — send the whole lists or one edit" }).refine((p) => p.secureOnArmOff === void 0 || p.secureOnArmEdit === void 0, { message: "secureOnArmOff and secureOnArmEdit are exclusive — send the whole lists or one edit" });
 /**
 * What one arm mode actually arms, DERIVED from the enabled rules gated on it.
 * Never authored, never stored — see `alarm-mode-coverage.ts` for why a stored
@@ -20876,7 +20932,13 @@ var NcAlarmSensorStateSchema = object({
 	/** Why `unknown`: the read failed, or the slice holds no word its cap defines (a placeholder included). */
 	unknownWhy: _enum(["read-failed", "unknown-word"]).nullable(),
 	/** The device manager's liveness as the centre mirrors it; null = not known. */
-	online: boolean().nullable()
+	online: boolean().nullable(),
+	/**
+	* True when the opening is a cover / lock / switch — the table shows the
+	* Secure-on-arm switch and uses the controllable defaults. False for contacts
+	* and for non-openings. Defaulted so an older hub answer still parses.
+	*/
+	controllable: boolean().default(false)
 });
 var NcAlarmSensorsInputSchema = object({ deviceIds: array(number().int().positive()).max(500) });
 var NcAlarmSensorsSchema = object({
@@ -29395,6 +29457,74 @@ var buttonCapability = {
 	}) }
 };
 /**
+* `calendar-source` — collection cap exposing per-provider calendars and
+* their events. Every addon that contributes calendars (Home Assistant,
+* a future Google Calendar addon, …) registers a provider here. The hub
+* singleton `calendars` walks the collection and merges the answers.
+*
+* Mirrors `addon-pages-source`: the public listing is a different shape
+* (source-stamped ids) and lives on the aggregator.
+*/
+var CalendarSourceKindSchema = _enum(["ha", "addon"]);
+var CalendarInfoSchema = object({
+	/** Provider-local id (e.g. HA `calendar.family`). The aggregator prefixes. */
+	id: string().min(1),
+	name: string().min(1),
+	source: CalendarSourceKindSchema,
+	enabled: boolean()
+});
+var CalendarEventSchema = object({
+	id: string().min(1),
+	calendarId: string().min(1),
+	title: string(),
+	startMs: number().int(),
+	endMs: number().int(),
+	allDay: boolean().optional(),
+	description: string().optional(),
+	location: string().optional()
+});
+var CalendarListEventsInputSchema = object({
+	calendarIds: array(string().min(1)).max(64).optional(),
+	startMs: number().int(),
+	endMs: number().int()
+});
+var calendarSourceCapability = {
+	name: "calendar-source",
+	scope: "system",
+	mode: "collection",
+	internal: true,
+	methods: {
+		listCalendars: method(_void(), array(CalendarInfoSchema).readonly(), { auth: "admin" }),
+		listEvents: method(CalendarListEventsInputSchema, array(CalendarEventSchema).readonly(), { auth: "admin" })
+	}
+};
+/**
+* `calendars` — system-scoped singleton. Public surface admin-ui and the
+* notification-center calendar-events producer consume.
+*
+* Walks every `calendar-source` provider, stamps each calendar with a
+* cluster-stable id (`<sourceAddonId>:<localId>`) and the providing
+* addon's id, and fans `listEvents` out the same way. Home Assistant
+* import is a built-in refresh of the HA source rather than a second
+* registry — `importFromHomeAssistant` asks that source to re-discover.
+*/
+var CalendarEntrySchema = CalendarInfoSchema.extend({
+	/** Cluster-stable id: `<providerAddonId>:<localId>`. */
+	id: string().min(1),
+	/** The addon that registered the calendar-source provider. */
+	providerAddonId: string().min(1).optional()
+});
+var CalendarImportResultSchema = object({
+	imported: number().int().nonnegative(),
+	/** Absent when no HA calendar-source provider was reachable. */
+	providerAddonId: string().min(1).optional(),
+	error: string().optional()
+});
+method(_void(), array(CalendarEntrySchema).readonly(), { auth: "admin" }), method(CalendarListEventsInputSchema, array(CalendarEventSchema).readonly(), { auth: "admin" }), method(_void(), CalendarImportResultSchema, {
+	auth: "admin",
+	kind: "mutation"
+});
+/**
 * camera-credentials — device-scoped cap exposing the camera's network
 * + auth surface in a vendor-neutral shape.
 *
@@ -33943,38 +34073,52 @@ DeviceType.Camera, method(object({
 	deviceId: number(),
 	status: OsdStatusSchema
 });
+_enum([
+	"value",
+	"unit",
+	"full"
+]);
+_enum([
+	"value+unit",
+	"value",
+	"unit"
+]);
+/**
+* How the operator reached the leaf device. `deviceId` is ALWAYS the
+* OSD-supported leaf that is read; `containerId` is set when the pick
+* went through a container (gateway) first.
+*/
+var OsdTemplatePickSchema = object({
+	containerId: number().int().optional(),
+	deviceId: number().int()
+});
 /**
-* `osd-manager` — the ORCHESTRATOR over the device-scope `osd` cap.
-*
-* The `osd` cap is the firmware contract: it probes a camera's overlay
-* SLOTS and writes literal text into one. It has no idea WHERE that text
-* comes from, and it must not — a driver that grew a "show the temperature
-* here" feature would grow it once per vendor.
-*
-* This cap owns the other half: a per-(camera, slot) BINDING that says
-* which value feeds the slot, how it is formatted, and under which
-* conditions it is shown at all. One addon renders every binding on every
-* camera, so a new source costs zero driver code.
-*
-* Three deliberate choices, each with a rejected alternative:
-*
-*  1. A source is `(capName, valuePath)` over the kernel's device
-*     runtime-state mirror — NOT a closed enum of source kinds. Every
-*     cap-keyed slice a device publishes is bindable the day the cap
-*     ships. The rejected alternative (one enum member per source, with
-*     a resolver branch each) is what makes "add the humidity too" a
-*     code change.
-*  2. The display gate reuses `NcConditionsSchema` verbatim — the
-*     notification centre's condition vocabulary — rather than a parallel
-*     model. An operator who has learned one condition editor has learned
-*     both.
-*  3. Because the renderer's facts are device STATE and not a detection
-*     record, only a SUBSET of that vocabulary can be answered here.
-*     `setSlotBinding` REJECTS the rest at write time (see
-*     `getConditionSupport`). It does not accept-then-fail-closed: a
-*     condition that can never be true renders a permanently blank
-*     overlay, and a blank overlay looks exactly like a broken camera.
+* One named binding inside a multi-device template: device path + unit
+* selection + precision. The parser expands `{alias}`, `{alias.value}`,
+* `{alias.unit}`, or `{alias.full}` from the same binding — there is no
+* per-binding format lock.
 */
+var OsdTemplateBindingSchema = object({
+	/** Token stem in the parser, e.g. `t` → `{t}` / `{t.value}`. Unique within the template. */
+	alias: string().min(1).max(32).regex(/^[A-Za-z][A-Za-z0-9_-]*$/, "alias must start with a letter"),
+	pick: OsdTemplatePickSchema,
+	capName: string().min(1).max(64),
+	valuePath: string().min(1).max(64),
+	/** Convert TO this unit at render (`tryConvertUnit`). Absent = source unit. */
+	displayUnit: string().max(16).optional(),
+	maxDecimals: number().int().min(0).max(4).default(1)
+});
+/**
+* A named template: bindings (alias → leaf field) + a parser that
+* references `{alias}` / `{alias.value}` / `{alias.unit}` / `{alias.full}`.
+*/
+var OsdNamedTemplateSchema = object({
+	id: string().min(1).max(64),
+	name: string().min(1).max(64),
+	bindings: array(OsdTemplateBindingSchema).max(32).default([]),
+	/** Parser with alias placeholders, e.g. `{t.value} {t.unit} / {h}`. */
+	parser: string().max(256).default("")
+});
 /** Where a slot's value comes from. */
 var OsdSourceSchema = discriminatedUnion("kind", [
 	object({
@@ -33993,11 +34137,17 @@ var OsdSourceSchema = discriminatedUnion("kind", [
 		deviceId: number().int().optional(),
 		capName: string().min(1).max(64),
 		/** Dot path inside the slice, e.g. `detected`, `value`, `mode`. */
-		valuePath: string().min(1).max(64)
+		valuePath: string().min(1).max(64),
+		/** Convert TO this unit at render. Absent = no conversion. */
+		displayUnit: string().max(16).optional()
 	}),
 	object({
 		kind: literal("latest-recognition"),
 		recognition: _enum(["person", "plate"])
+	}),
+	object({
+		kind: literal("template"),
+		templateId: string().min(1).max(64)
 	})
 ]);
 var OsdSlotBindingSchema = object({
@@ -34013,7 +34163,10 @@ var OsdSlotBindingSchema = object({
 	* documented workaround for firmwares that reject `.` in overlay text.
 	*/
 	maxDecimals: number().int().min(0).max(4).default(1),
-	/** Appended via `${unit}`. The state mirror does not carry units. */
+	/**
+	* Appended via `${unit}` when no unit conversion produces a label.
+	* Prefer `source.displayUnit` for converted device-state values.
+	*/
 	unitLabel: string().max(8).optional(),
 	/** Raw value → display text, e.g. `{"true":"MOTION","false":""}`. */
 	valueMap: record(string(), string()).optional(),
@@ -34122,6 +34275,12 @@ method(object({ deviceId: number().int() }), object({
 }), method(object({ deviceId: number().int() }), object({ results: array(OsdRenderResultSchema) }), {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({}), object({ templates: array(OsdNamedTemplateSchema) }), { auth: "admin" }), method(object({ template: OsdNamedTemplateSchema }), object({ template: OsdNamedTemplateSchema }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({ templateId: string().min(1).max(64) }), object({ success: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
 });
 /**
 * Feeder connectivity / power status — mirrors the HA petkit device-status
@@ -42916,6 +43075,36 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"calendars.importFromHomeAssistant": {
+		capName: "calendars",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"calendars.listCalendars": {
+		capName: "calendars",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"calendars.listEvents": {
+		capName: "calendars",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"calendarSource.listCalendars": {
+		capName: "calendar-source",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"calendarSource.listEvents": {
+		capName: "calendar-source",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"cameraCredentials.getCredentials": {
 		capName: "camera-credentials",
 		capScope: "device",
@@ -45910,6 +46099,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"osdManager.deleteTemplate": {
+		capName: "osd-manager",
+		capScope: "system",
+		addonId: null,
+		access: "delete"
+	},
 	"osdManager.getConditionSupport": {
 		capName: "osd-manager",
 		capScope: "system",
@@ -45928,6 +46123,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"osdManager.listTemplates": {
+		capName: "osd-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"osdManager.previewSlot": {
 		capName: "osd-manager",
 		capScope: "system",
@@ -45946,6 +46147,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"osdManager.upsertTemplate": {
+		capName: "osd-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"petFeeder.callPet": {
 		capName: "pet-feeder",
 		capScope: "device",
@@ -53120,4 +53327,4 @@ function bestLocationMatch(externalName, existing, threshold = .8) {
 var MB = 1024 * 1024;
 1024 * MB, 3072 * MB;
 //#endregion
-export { parseAdminBase as $, contactCapability as A, union as At, gasCapability as B, buildAddonRouteProvider as C, array as Ct, climateControlCapability as D, object as Dt, carbonMonoxideCapability as E, number as Et, deviceExportCapability as F, lockControlCapability as G, humiditySensorCapability as H, enumSensorCapability as I, normalizeUnit as J, mediaPlayerCapability as K, eventEmitterCapability as L, coverCapability as M, url as Mt, deviceAdminLinkCapability as N, EventCategory as Nt, colorCapability as O, record as Ot, deviceAdoptionCapability as P, oauthIntegrationCapability as Q, fanControlCapability as R, brokerCapability as S, _enum as St, buttonCapability as T, literal as Tt, imageCapability as U, humidifierCapability as V, lawnMowerControlCapability as W, notifierCapability as X, notificationOutputCapability as Y, numericSensorCapability as Z, automationControlCapability as _, DeviceType as _t, COCO_TO_MACRO as a, smokeCapability as at, binaryCapability as b, createEvent as bt, FanDirectionSchema as c, temperatureSensorCapability as ct, TargetSchema as d, valveCapability as dt, powerMeterCapability as et, accessoriesCapability as f, vibrationCapability as ft, ambientLightSensorCapability as g, DeviceRole as gt, alarmPanelCapability as h, DeviceFeature as ht, CAMERA_SWITCH_ORDER as i, scriptRunnerCapability as it, controlCapability as j, unknown as jt, connectivityCapability as k, string as kt, HvacModeSchema as l, updateCapability as lt, airQualitySensorCapability as m, weatherCapability as mt, BaseDevice as n, presenceCapability as nt, CameraSwitchIdSchema as o, switchCapability as ot, addonRoutesCapability as p, waterHeaterCapability as pt, motionCapability as q, BaseDeviceProvider as r, pressureSensorCapability as rt, EnumSensorDateTimeFormatSchema as s, tamperCapability as st, AlarmArmModeSchema as t, prepareNotification as tt, MediaPlayerRepeatSchema as u, vacuumControlCapability as ut, batteryCapability as v, errMsg as vt, buildDeviceAdminUrl as w, discriminatedUnion as wt, brightnessCapability as x, nodePin as xt, bestLocationMatch as y, BaseAddon as yt, floodCapability as z };
+export { oauthIntegrationCapability as $, connectivityCapability as A, string as At, floodCapability as B, buildAddonRouteProvider as C, _enum as Ct, carbonMonoxideCapability as D, number as Dt, calendarSourceCapability as E, literal as Et, deviceAdoptionCapability as F, lawnMowerControlCapability as G, humidifierCapability as H, deviceExportCapability as I, motionCapability as J, lockControlCapability as K, enumSensorCapability as L, controlCapability as M, unknown as Mt, coverCapability as N, url as Nt, climateControlCapability as O, object as Ot, deviceAdminLinkCapability as P, EventCategory as Pt, numericSensorCapability as Q, eventEmitterCapability as R, brokerCapability as S, nodePin as St, buttonCapability as T, discriminatedUnion as Tt, humiditySensorCapability as U, gasCapability as V, imageCapability as W, notificationOutputCapability as X, normalizeUnit as Y, notifierCapability as Z, automationControlCapability as _, DeviceRole as _t, COCO_TO_MACRO as a, scriptRunnerCapability as at, binaryCapability as b, BaseAddon as bt, FanDirectionSchema as c, tamperCapability as ct, TargetSchema as d, vacuumControlCapability as dt, parseAdminBase as et, accessoriesCapability as f, valveCapability as ft, ambientLightSensorCapability as g, DeviceFeature as gt, alarmPanelCapability as h, weatherCapability as ht, CAMERA_SWITCH_ORDER as i, pressureSensorCapability as it, contactCapability as j, union as jt, colorCapability as k, record as kt, HvacModeSchema as l, temperatureSensorCapability as lt, airQualitySensorCapability as m, waterHeaterCapability as mt, BaseDevice as n, prepareNotification as nt, CameraSwitchIdSchema as o, smokeCapability as ot, addonRoutesCapability as p, vibrationCapability as pt, mediaPlayerCapability as q, BaseDeviceProvider as r, presenceCapability as rt, EnumSensorDateTimeFormatSchema as s, switchCapability as st, AlarmArmModeSchema as t, powerMeterCapability as tt, MediaPlayerRepeatSchema as u, updateCapability as ut, batteryCapability as v, DeviceType as vt, buildDeviceAdminUrl as w, array as wt, brightnessCapability as x, createEvent as xt, bestLocationMatch as y, errMsg as yt, fanControlCapability as z };

package/dist/{dist-DMn4t1u_.js → dist-DLQgcqQT.js}

@@ -20688,14 +20688,52 @@ var NcAlarmNonBlockingEditSchema = object({
 	nonBlocking: boolean()
 });
 /**
+* Controllable openings: opt IN to blocking (default is do not block). Contacts
+* keep using {@link NcAlarmNonBlockingEditSchema}.
+*/
+var NcAlarmBlockingEditSchema = object({
+	mode: AlarmArmModeSchema,
+	deviceId: number().int().positive(),
+	/** true = on the list (blocks when open); false = off the list (default). */
+	blocking: boolean()
+});
+/**
+* Controllable openings: opt OUT of secure-on-arm (default is secure ON —
+* close / lock / turn off when this mode arms).
+*/
+var NcAlarmSecureOnArmEditSchema = object({
+	mode: AlarmArmModeSchema,
+	deviceId: number().int().positive(),
+	/** true = secure on arm (default); false = do not actuate on arm. */
+	secureOnArm: boolean()
+});
+/**
+* One arm mode's device-id list (non-blocking, blocking, or secure-on-arm-off).
+*/
+var NcAlarmModeDeviceListSchema = object({
+	mode: AlarmArmModeSchema,
+	deviceIds: array(number().int()).max(200)
+});
+/**
+* One arm mode's non-blocking list: devices that may be open when that mode
+* arms, without the arm being refused.
+*/
+var NcAlarmNonBlockingSchema = NcAlarmModeDeviceListSchema;
+/** Controllable devices that DO block when open (opt-in; default empty). */
+var NcAlarmBlockingSchema = NcAlarmModeDeviceListSchema;
+/**
+* Controllable devices that do NOT secure on arm (opt-out; default empty =
+* every controllable secures).
+*/
+var NcAlarmSecureOnArmOffSchema = NcAlarmModeDeviceListSchema;
+/**
 * The per-mode lists, at most one per mode. Two lists for one mode have no
 * meaning a reader could agree on (union? the last one?), so they are refused
 * at the boundary rather than interpreted.
 */
-var NcAlarmNonBlockingListSchema = array(object({
-	mode: AlarmArmModeSchema,
-	deviceIds: array(number().int()).max(200)
-})).max(8).refine(uniqueModes, { message: "nonBlocking: at most one list per arm mode" });
+var NcAlarmNonBlockingListSchema = array(NcAlarmNonBlockingSchema).max(8).refine(uniqueModes, { message: "nonBlocking: at most one list per arm mode" });
+var NcAlarmBlockingListSchema = array(NcAlarmBlockingSchema).max(8).refine(uniqueModes, { message: "blocking: at most one list per arm mode" });
+var NcAlarmSecureOnArmOffListSchema = array(NcAlarmSecureOnArmOffSchema).max(8).refine(uniqueModes, { message: "secureOnArmOff: at most one list per arm mode" });
 /**
 * The three durations — global, and per mode since D697 — the panel's state
 * machine runs on, who hears about its transitions, and which openings each mode tolerates.
@@ -20738,9 +20776,23 @@ var NcAlarmSettingsSchema = object({
 	* arm (a window left ajar for the cat under `home`, say). At most one entry
 	* per mode is meaningful. Defaulted to `[]` so a blob stored before D630
 	* parses as "every opening blocks" — the behaviour it was written under.
+	* Contacts use this list; controllable openings use {@link blocking} instead
+	* (default: do not block).
 	*/
 	nonBlocking: NcAlarmNonBlockingListSchema.default([]),
 	/**
+	* Per arm mode, controllable openings that DO refuse the arm when open.
+	* Default `[]` = none block (secure-on-arm closes them instead). Absent on a
+	* blob older than this field — read as empty.
+	*/
+	blocking: NcAlarmBlockingListSchema.default([]),
+	/**
+	* Per arm mode, controllable openings that must NOT be actuated on arm.
+	* Default `[]` = every controllable secures (close / lock / off). Absent on
+	* an older blob — read as empty (secure ON).
+	*/
+	secureOnArmOff: NcAlarmSecureOnArmOffListSchema.default([]),
+	/**
 	* Per arm mode, the delays that mode OVERRIDES (D697). A mode with no entry, or an entry
 	* without a field, uses the global value above — so `[]`, the default, is exactly the
 	* behaviour of a blob stored before this field existed. Read through `resolveModeDelays`.
@@ -20750,7 +20802,7 @@ var NcAlarmSettingsSchema = object({
 /**
 * Every field optional — a tab edits one control at a time.
 *
-* `nonBlocking` and `modeDelays` are re-declared WITHOUT their defaults:
+* List fields and `modeDelays` are re-declared WITHOUT their defaults:
 * `.partial()` does not remove an inner `.default()`, so a patch that never
 * named the field would parse to `[]` and wipe every mode's list on an
 * unrelated edit (the same trap {@link NcRulePatchSchema} documents). Here
@@ -20758,11 +20810,15 @@ var NcAlarmSettingsSchema = object({
 */
 var NcAlarmSettingsPatchSchema = NcAlarmSettingsSchema.extend({
 	nonBlocking: NcAlarmNonBlockingListSchema,
+	blocking: NcAlarmBlockingListSchema,
+	secureOnArmOff: NcAlarmSecureOnArmOffListSchema,
 	/** Per-mode, per-field edits — NOT the whole list (see NcAlarmModeDelaysEditSchema). */
 	modeDelays: NcAlarmModeDelaysEditListSchema,
 	/** ONE membership change; the panel applies it to the list it holds at its turn. */
-	nonBlockingEdit: NcAlarmNonBlockingEditSchema
-}).partial().refine((p) => p.nonBlocking === void 0 || p.nonBlockingEdit === void 0, { message: "nonBlocking and nonBlockingEdit are exclusive — send the whole lists or one edit" });
+	nonBlockingEdit: NcAlarmNonBlockingEditSchema,
+	blockingEdit: NcAlarmBlockingEditSchema,
+	secureOnArmEdit: NcAlarmSecureOnArmEditSchema
+}).partial().refine((p) => p.nonBlocking === void 0 || p.nonBlockingEdit === void 0, { message: "nonBlocking and nonBlockingEdit are exclusive — send the whole lists or one edit" }).refine((p) => p.blocking === void 0 || p.blockingEdit === void 0, { message: "blocking and blockingEdit are exclusive — send the whole lists or one edit" }).refine((p) => p.secureOnArmOff === void 0 || p.secureOnArmEdit === void 0, { message: "secureOnArmOff and secureOnArmEdit are exclusive — send the whole lists or one edit" });
 /**
 * What one arm mode actually arms, DERIVED from the enabled rules gated on it.
 * Never authored, never stored — see `alarm-mode-coverage.ts` for why a stored
@@ -20877,7 +20933,13 @@ var NcAlarmSensorStateSchema = object({
 	/** Why `unknown`: the read failed, or the slice holds no word its cap defines (a placeholder included). */
 	unknownWhy: _enum(["read-failed", "unknown-word"]).nullable(),
 	/** The device manager's liveness as the centre mirrors it; null = not known. */
-	online: boolean().nullable()
+	online: boolean().nullable(),
+	/**
+	* True when the opening is a cover / lock / switch — the table shows the
+	* Secure-on-arm switch and uses the controllable defaults. False for contacts
+	* and for non-openings. Defaulted so an older hub answer still parses.
+	*/
+	controllable: boolean().default(false)
 });
 var NcAlarmSensorsInputSchema = object({ deviceIds: array(number().int().positive()).max(500) });
 var NcAlarmSensorsSchema = object({
@@ -29396,6 +29458,74 @@ var buttonCapability = {
 	}) }
 };
 /**
+* `calendar-source` — collection cap exposing per-provider calendars and
+* their events. Every addon that contributes calendars (Home Assistant,
+* a future Google Calendar addon, …) registers a provider here. The hub
+* singleton `calendars` walks the collection and merges the answers.
+*
+* Mirrors `addon-pages-source`: the public listing is a different shape
+* (source-stamped ids) and lives on the aggregator.
+*/
+var CalendarSourceKindSchema = _enum(["ha", "addon"]);
+var CalendarInfoSchema = object({
+	/** Provider-local id (e.g. HA `calendar.family`). The aggregator prefixes. */
+	id: string().min(1),
+	name: string().min(1),
+	source: CalendarSourceKindSchema,
+	enabled: boolean()
+});
+var CalendarEventSchema = object({
+	id: string().min(1),
+	calendarId: string().min(1),
+	title: string(),
+	startMs: number().int(),
+	endMs: number().int(),
+	allDay: boolean().optional(),
+	description: string().optional(),
+	location: string().optional()
+});
+var CalendarListEventsInputSchema = object({
+	calendarIds: array(string().min(1)).max(64).optional(),
+	startMs: number().int(),
+	endMs: number().int()
+});
+var calendarSourceCapability = {
+	name: "calendar-source",
+	scope: "system",
+	mode: "collection",
+	internal: true,
+	methods: {
+		listCalendars: method(_void(), array(CalendarInfoSchema).readonly(), { auth: "admin" }),
+		listEvents: method(CalendarListEventsInputSchema, array(CalendarEventSchema).readonly(), { auth: "admin" })
+	}
+};
+/**
+* `calendars` — system-scoped singleton. Public surface admin-ui and the
+* notification-center calendar-events producer consume.
+*
+* Walks every `calendar-source` provider, stamps each calendar with a
+* cluster-stable id (`<sourceAddonId>:<localId>`) and the providing
+* addon's id, and fans `listEvents` out the same way. Home Assistant
+* import is a built-in refresh of the HA source rather than a second
+* registry — `importFromHomeAssistant` asks that source to re-discover.
+*/
+var CalendarEntrySchema = CalendarInfoSchema.extend({
+	/** Cluster-stable id: `<providerAddonId>:<localId>`. */
+	id: string().min(1),
+	/** The addon that registered the calendar-source provider. */
+	providerAddonId: string().min(1).optional()
+});
+var CalendarImportResultSchema = object({
+	imported: number().int().nonnegative(),
+	/** Absent when no HA calendar-source provider was reachable. */
+	providerAddonId: string().min(1).optional(),
+	error: string().optional()
+});
+method(_void(), array(CalendarEntrySchema).readonly(), { auth: "admin" }), method(CalendarListEventsInputSchema, array(CalendarEventSchema).readonly(), { auth: "admin" }), method(_void(), CalendarImportResultSchema, {
+	auth: "admin",
+	kind: "mutation"
+});
+/**
 * camera-credentials — device-scoped cap exposing the camera's network
 * + auth surface in a vendor-neutral shape.
 *
@@ -33944,38 +34074,52 @@ DeviceType.Camera, method(object({
 	deviceId: number(),
 	status: OsdStatusSchema
 });
+_enum([
+	"value",
+	"unit",
+	"full"
+]);
+_enum([
+	"value+unit",
+	"value",
+	"unit"
+]);
+/**
+* How the operator reached the leaf device. `deviceId` is ALWAYS the
+* OSD-supported leaf that is read; `containerId` is set when the pick
+* went through a container (gateway) first.
+*/
+var OsdTemplatePickSchema = object({
+	containerId: number().int().optional(),
+	deviceId: number().int()
+});
+/**
+* One named binding inside a multi-device template: device path + unit
+* selection + precision. The parser expands `{alias}`, `{alias.value}`,
+* `{alias.unit}`, or `{alias.full}` from the same binding — there is no
+* per-binding format lock.
+*/
+var OsdTemplateBindingSchema = object({
+	/** Token stem in the parser, e.g. `t` → `{t}` / `{t.value}`. Unique within the template. */
+	alias: string().min(1).max(32).regex(/^[A-Za-z][A-Za-z0-9_-]*$/, "alias must start with a letter"),
+	pick: OsdTemplatePickSchema,
+	capName: string().min(1).max(64),
+	valuePath: string().min(1).max(64),
+	/** Convert TO this unit at render (`tryConvertUnit`). Absent = source unit. */
+	displayUnit: string().max(16).optional(),
+	maxDecimals: number().int().min(0).max(4).default(1)
+});
 /**
-* `osd-manager` — the ORCHESTRATOR over the device-scope `osd` cap.
-*
-* The `osd` cap is the firmware contract: it probes a camera's overlay
-* SLOTS and writes literal text into one. It has no idea WHERE that text
-* comes from, and it must not — a driver that grew a "show the temperature
-* here" feature would grow it once per vendor.
-*
-* This cap owns the other half: a per-(camera, slot) BINDING that says
-* which value feeds the slot, how it is formatted, and under which
-* conditions it is shown at all. One addon renders every binding on every
-* camera, so a new source costs zero driver code.
-*
-* Three deliberate choices, each with a rejected alternative:
-*
-*  1. A source is `(capName, valuePath)` over the kernel's device
-*     runtime-state mirror — NOT a closed enum of source kinds. Every
-*     cap-keyed slice a device publishes is bindable the day the cap
-*     ships. The rejected alternative (one enum member per source, with
-*     a resolver branch each) is what makes "add the humidity too" a
-*     code change.
-*  2. The display gate reuses `NcConditionsSchema` verbatim — the
-*     notification centre's condition vocabulary — rather than a parallel
-*     model. An operator who has learned one condition editor has learned
-*     both.
-*  3. Because the renderer's facts are device STATE and not a detection
-*     record, only a SUBSET of that vocabulary can be answered here.
-*     `setSlotBinding` REJECTS the rest at write time (see
-*     `getConditionSupport`). It does not accept-then-fail-closed: a
-*     condition that can never be true renders a permanently blank
-*     overlay, and a blank overlay looks exactly like a broken camera.
+* A named template: bindings (alias → leaf field) + a parser that
+* references `{alias}` / `{alias.value}` / `{alias.unit}` / `{alias.full}`.
 */
+var OsdNamedTemplateSchema = object({
+	id: string().min(1).max(64),
+	name: string().min(1).max(64),
+	bindings: array(OsdTemplateBindingSchema).max(32).default([]),
+	/** Parser with alias placeholders, e.g. `{t.value} {t.unit} / {h}`. */
+	parser: string().max(256).default("")
+});
 /** Where a slot's value comes from. */
 var OsdSourceSchema = discriminatedUnion("kind", [
 	object({
@@ -33994,11 +34138,17 @@ var OsdSourceSchema = discriminatedUnion("kind", [
 		deviceId: number().int().optional(),
 		capName: string().min(1).max(64),
 		/** Dot path inside the slice, e.g. `detected`, `value`, `mode`. */
-		valuePath: string().min(1).max(64)
+		valuePath: string().min(1).max(64),
+		/** Convert TO this unit at render. Absent = no conversion. */
+		displayUnit: string().max(16).optional()
 	}),
 	object({
 		kind: literal("latest-recognition"),
 		recognition: _enum(["person", "plate"])
+	}),
+	object({
+		kind: literal("template"),
+		templateId: string().min(1).max(64)
 	})
 ]);
 var OsdSlotBindingSchema = object({
@@ -34014,7 +34164,10 @@ var OsdSlotBindingSchema = object({
 	* documented workaround for firmwares that reject `.` in overlay text.
 	*/
 	maxDecimals: number().int().min(0).max(4).default(1),
-	/** Appended via `${unit}`. The state mirror does not carry units. */
+	/**
+	* Appended via `${unit}` when no unit conversion produces a label.
+	* Prefer `source.displayUnit` for converted device-state values.
+	*/
 	unitLabel: string().max(8).optional(),
 	/** Raw value → display text, e.g. `{"true":"MOTION","false":""}`. */
 	valueMap: record(string(), string()).optional(),
@@ -34123,6 +34276,12 @@ method(object({ deviceId: number().int() }), object({
 }), method(object({ deviceId: number().int() }), object({ results: array(OsdRenderResultSchema) }), {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({}), object({ templates: array(OsdNamedTemplateSchema) }), { auth: "admin" }), method(object({ template: OsdNamedTemplateSchema }), object({ template: OsdNamedTemplateSchema }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({ templateId: string().min(1).max(64) }), object({ success: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
 });
 /**
 * Feeder connectivity / power status — mirrors the HA petkit device-status
@@ -42917,6 +43076,36 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"calendars.importFromHomeAssistant": {
+		capName: "calendars",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"calendars.listCalendars": {
+		capName: "calendars",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"calendars.listEvents": {
+		capName: "calendars",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"calendarSource.listCalendars": {
+		capName: "calendar-source",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"calendarSource.listEvents": {
+		capName: "calendar-source",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"cameraCredentials.getCredentials": {
 		capName: "camera-credentials",
 		capScope: "device",
@@ -45911,6 +46100,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"osdManager.deleteTemplate": {
+		capName: "osd-manager",
+		capScope: "system",
+		addonId: null,
+		access: "delete"
+	},
 	"osdManager.getConditionSupport": {
 		capName: "osd-manager",
 		capScope: "system",
@@ -45929,6 +46124,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"osdManager.listTemplates": {
+		capName: "osd-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"osdManager.previewSlot": {
 		capName: "osd-manager",
 		capScope: "system",
@@ -45947,6 +46148,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"osdManager.upsertTemplate": {
+		capName: "osd-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"petFeeder.callPet": {
 		capName: "pet-feeder",
 		capScope: "device",
@@ -53313,6 +53520,12 @@ Object.defineProperty(exports, "buttonCapability", {
 		return buttonCapability;
 	}
 });
+Object.defineProperty(exports, "calendarSourceCapability", {
+	enumerable: true,
+	get: function() {
+		return calendarSourceCapability;
+	}
+});
 Object.defineProperty(exports, "carbonMonoxideCapability", {
 	enumerable: true,
 	get: function() {

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

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 //#endregion
-const require_dist = require("../dist-DMn4t1u_.js");
+const require_dist = require("../dist-DLQgcqQT.js");
 let node_crypto = require("node:crypto");
 //#region src/ha-export/topics.ts
 /**

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

@@ -1,4 +1,4 @@
-import { C as buildAddonRouteProvider, F as deviceExportCapability, Nt as EventCategory, Q as oauthIntegrationCapability, a as COCO_TO_MACRO, c as FanDirectionSchema, i as CAMERA_SWITCH_ORDER, kt as string, l as HvacModeSchema, o as CameraSwitchIdSchema, p as addonRoutesCapability, t as AlarmArmModeSchema, u as MediaPlayerRepeatSchema, xt as nodePin, yt as BaseAddon } from "../dist-evNLjXgk.mjs";
+import { $ as oauthIntegrationCapability, At as string, C as buildAddonRouteProvider, I as deviceExportCapability, Pt as EventCategory, St as nodePin, a as COCO_TO_MACRO, bt as BaseAddon, c as FanDirectionSchema, i as CAMERA_SWITCH_ORDER, l as HvacModeSchema, o as CameraSwitchIdSchema, p as addonRoutesCapability, t as AlarmArmModeSchema, u as MediaPlayerRepeatSchema } from "../dist-CvzpCuzm.mjs";
 import { createHmac, timingSafeEqual } from "node:crypto";
 //#region src/ha-export/topics.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-homeassistant",
-  "version": "1.2.153",
+  "version": "1.2.154",
   "description": "Home Assistant device provider addon for CamStack",
   "keywords": [
     "camstack",
@@ -82,6 +82,9 @@
           },
           {
             "name": "addon-routes"
+          },
+          {
+            "name": "calendar-source"
           }
         ]
       },