@camstack/addon-provider-homeassistant 1.2.639 → 1.2.641

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

@@ -24,7 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_dist = require("../dist-C_XoeULr.js");
+const require_ha_broker_source = require("../ha-broker-source-D3_ZXq6l.js");
 let node_crypto = require("node:crypto");
 require("node:zlib");
 let node_fs = require("node:fs");
@@ -32,20 +32,6 @@ node_fs = __toESM(node_fs, 1);
 let node_path = require("node:path");
 node_path = __toESM(node_path, 1);
 require("node:child_process");
-/** The `BrokerInfo.kind` tag the Home Assistant provider stamps. */
-var HA_BROKER_KIND = "home-assistant";
-/**
-* Every Home Assistant broker currently registered, cluster-wide.
-*
-* Unpinned by design (see the module docblock) and filtered by `kind`, which is
-* the contract check that matters: whatever mix of providers answered the
-* union, only `home-assistant` brokers are ever exported to over Home
-* Assistant's transport.
-*/
-async function listHomeAssistantBrokers(query) {
-	return (await query({})).filter((broker) => broker.kind === HA_BROKER_KIND);
-}
-//#endregion
 //#region src/ha-export/camera-function-writes.ts
 /**
 * Performs the WRITE of a camera function on the authority that owns it.
@@ -105,7 +91,7 @@ async function applyCameraFunctionWrite(api, deviceId, write, sourceNodeId) {
 			await api.streamBroker.setDeviceAudioMute.mutate({
 				deviceId,
 				muted: write.muted
-			}, require_dist.nodePin(sourceNodeId));
+			}, require_ha_broker_source.nodePin(sourceNodeId));
 			return;
 	}
 }
@@ -739,8 +725,8 @@ function consumableEntity(key, facet) {
 * rather than to an icon for nothing.
 */
 function consumableForm(item) {
-	const declared = require_dist.ConsumableFormSchema.safeParse(item.form);
-	return require_dist.consumableFormOf({
+	const declared = require_ha_broker_source.ConsumableFormSchema.safeParse(item.form);
+	return require_ha_broker_source.consumableFormOf({
 		...item.kind !== void 0 ? { kind: item.kind } : {},
 		...declared.success ? { form: declared.data } : {}
 	});
@@ -753,7 +739,7 @@ function partIcon(key, label) {
 function formIcon(item, form) {
 	switch (form) {
 		case "part": return partIcon(item.key, item.label);
-		case "tank": return require_dist.consumableKindOf(item) === "waste" ? "mdi:water-off" : "mdi:water";
+		case "tank": return require_ha_broker_source.consumableKindOf(item) === "waste" ? "mdi:water-off" : "mdi:water";
 		case "product": return "mdi:shaker-outline";
 		case "bin": return "mdi:delete";
 	}
@@ -764,8 +750,8 @@ function formIcon(item, form) {
 * form this export does not know degrades one icon instead of refusing the
 * whole slice.
 */
-var ExportConsumableItemSchema = require_dist.ConsumableItemSchema.extend({ form: require_dist.unknown().optional() });
-var ExportConsumablesSchema = require_dist.object({ items: require_dist.array(ExportConsumableItemSchema) });
+var ExportConsumableItemSchema = require_ha_broker_source.ConsumableItemSchema.extend({ form: require_ha_broker_source.unknown().optional() });
+var ExportConsumablesSchema = require_ha_broker_source.object({ items: require_ha_broker_source.array(ExportConsumableItemSchema) });
 /**
 * A worn part's life is a diagnostic; a tank's fill is what the device page
 * is for (a vacuum's clean water, a dishwasher's salt), so it is not hidden.
@@ -778,7 +764,7 @@ function consumableEntities(item) {
 		capName: "consumables",
 		itemKey: item.key
 	};
-	const kind = require_dist.consumableKindOf(item);
+	const kind = require_ha_broker_source.consumableKindOf(item);
 	const form = consumableForm(item);
 	const icon = formIcon(item, form);
 	/** What the item IS, on the sensors that describe it (not on a counter or a button). */
@@ -818,7 +804,7 @@ function consumableEntities(item) {
 		platform: "sensor",
 		label: `${item.label} status`,
 		deviceClass: "enum",
-		options: require_dist.ConsumableStatusSchema.options,
+		options: require_ha_broker_source.ConsumableStatusSchema.options,
 		icon,
 		attributes,
 		entityCategory: "diagnostic"
@@ -2395,7 +2381,7 @@ var CAP_ENTITY_MAP = {
 		* failure. `fanMode` and `preset` get no such list at all: they are
 		* free-form strings, so they stay sensors.
 		*/
-		options: require_dist.HvacModeSchema.options,
+		options: require_ha_broker_source.HvacModeSchema.options,
 		extras: {
 			"current-temp": {
 				platform: "sensor",
@@ -2545,7 +2531,7 @@ var CAP_ENTITY_MAP = {
 				field: "direction",
 				label: "Direction",
 				writable: true,
-				options: require_dist.FanDirectionSchema.options,
+				options: require_ha_broker_source.FanDirectionSchema.options,
 				enabledByDefault: false
 			}
 		}
@@ -2975,7 +2961,7 @@ var CAP_ENTITY_MAP = {
 				field: "repeat",
 				label: "Repeat",
 				writable: true,
-				options: require_dist.MediaPlayerRepeatSchema.options,
+				options: require_ha_broker_source.MediaPlayerRepeatSchema.options,
 				enabledByDefault: false
 			},
 			shuffle: {
@@ -3466,7 +3452,7 @@ function controlEntitySpecs(slice, quantity) {
 		const min = readFiniteNumber(slice, "min") ?? PERCENT_RANGE.min;
 		const max = readFiniteNumber(slice, "max") ?? PERCENT_RANGE.max;
 		const step = readFiniteNumber(slice, "step") ?? PERCENT_RANGE.step;
-		const unit = quantity === void 0 ? void 0 : require_dist.baseUnitOf(quantity);
+		const unit = quantity === void 0 ? void 0 : require_ha_broker_source.baseUnitOf(quantity);
 		if (min < max && step > 0) return [{
 			entity: primary,
 			platform: "number",
@@ -3768,7 +3754,7 @@ function buildDerivedPlan(device, options = UNNEGOTIATED_PLAN_OPTIONS) {
 			continue;
 		}
 		if (cap === "numeric-sensor") {
-			const unit = device.readingQuantity === void 0 ? void 0 : require_dist.baseUnitOf(device.readingQuantity);
+			const unit = device.readingQuantity === void 0 ? void 0 : require_ha_broker_source.baseUnitOf(device.readingQuantity);
 			specs.push(...capEntitySpecs(cap).map((spec) => degradeUnsupported(unit === void 0 ? spec : {
 				...spec,
 				unit
@@ -3842,7 +3828,7 @@ function buildDevicePlan(device, options = UNNEGOTIATED_PLAN_OPTIONS) {
 * was.
 */
 /** The camera function ids, keyed by the entity slug the catalog emits. */
-var CAMERA_SWITCH_BY_SLUG = Object.fromEntries(require_dist.CAMERA_SWITCH_ORDER.map((id) => [toSlug(id), id]));
+var CAMERA_SWITCH_BY_SLUG = Object.fromEntries(require_ha_broker_source.CAMERA_SWITCH_ORDER.map((id) => [toSlug(id), id]));
 var PTZ_DIRECTION_BY_ENTITY = Object.fromEntries(PTZ_BUTTONS.map((entity) => [entity, entity.slice(4)]));
 function parseBool(value) {
 	const lower = value.trim().toLowerCase();
@@ -3905,7 +3891,7 @@ function parseAlarmAction(value) {
 	if (lower === "disarm" || lower === "disarmed") return { kind: "disarm" };
 	if (lower === "trigger" || lower === "triggered") return { kind: "trigger" };
 	const withoutPrefix = lower.startsWith("armed_") ? lower.slice(6) : lower.startsWith("arm_") ? lower.slice(4) : lower;
-	const mode = require_dist.AlarmArmModeSchema.safeParse(withoutPrefix);
+	const mode = require_ha_broker_source.AlarmArmModeSchema.safeParse(withoutPrefix);
 	return mode.success ? {
 		kind: "arm",
 		mode: mode.data
@@ -4054,7 +4040,7 @@ var CAP_COMMAND_ROUTES = {
 	},
 	"climate-control": {
 		primary: (deviceId, value) => {
-			const mode = parseEnum(require_dist.HvacModeSchema, value);
+			const mode = parseEnum(require_ha_broker_source.HvacModeSchema, value);
 			return mode === null ? null : {
 				kind: "climate-mode",
 				deviceId,
@@ -4169,7 +4155,7 @@ var CAP_COMMAND_ROUTES = {
 				};
 			},
 			direction: (deviceId, value) => {
-				const direction = parseEnum(require_dist.FanDirectionSchema, value);
+				const direction = parseEnum(require_ha_broker_source.FanDirectionSchema, value);
 				return direction === null ? null : {
 					kind: "fan-direction",
 					deviceId,
@@ -4373,7 +4359,7 @@ var CAP_COMMAND_ROUTES = {
 				};
 			},
 			repeat: (deviceId, value) => {
-				const repeat = parseEnum(require_dist.MediaPlayerRepeatSchema, value);
+				const repeat = parseEnum(require_ha_broker_source.MediaPlayerRepeatSchema, value);
 				return repeat === null ? null : {
 					kind: "media-repeat",
 					deviceId,
@@ -5248,12 +5234,125 @@ var HOME_ASSISTANT_OAUTH_INTEGRATION = {
 	refreshTokenTtlSec: 365 * 24 * 60 * 60
 };
 //#endregion
+//#region src/ha-export/push-failure.ts
+/**
+* Why a push to Home Assistant failed, in words an operator can act on.
+*
+* The reason used to live only in the log line's `meta.error`, which a log
+* viewer that shows the message alone never displays: an operator saw
+* "push failed, messages dropped" every 30 s for hours with nothing to act on.
+*/
+/** Where the custom component registers its push view inside HA. */
+var PUSH_PATH = "/api/camstack/push";
+var MAX_BODY_CHARS = 200;
+/** A non-2xx answer from Home Assistant's push view. */
+var PushHttpError = class extends Error {
+	status;
+	body;
+	constructor(status, body) {
+		super(`Home Assistant answered ${String(status)}`);
+		this.status = status;
+		this.body = body;
+		this.name = "PushHttpError";
+	}
+};
+/** First 200 chars of a response body, with any bearer token removed. */
+function scrubBody(body) {
+	return body.replace(/Bearer\s+[A-Za-z0-9._~+/=-]+/gi, "Bearer [redacted]").slice(0, MAX_BODY_CHARS);
+}
+var NETWORK_CODES = new Set([
+	"ECONNREFUSED",
+	"ENOTFOUND",
+	"ETIMEDOUT",
+	"ECONNRESET",
+	"EHOSTUNREACH",
+	"ENETUNREACH",
+	"EAI_AGAIN",
+	"UND_ERR_CONNECT_TIMEOUT"
+]);
+function networkCode(err) {
+	for (let current = err, depth = 0; current instanceof Error && depth < 4; depth += 1) {
+		const code = Reflect.get(current, "code");
+		if (typeof code === "string" && NETWORK_CODES.has(code)) return code;
+		current = current.cause;
+	}
+}
+function describePushFailure(err) {
+	if (err instanceof PushHttpError) {
+		const http = `HTTP ${String(err.status)}`;
+		if (err.status === 404) return {
+			kind: "component-missing",
+			permanent: true,
+			text: `${http} — Home Assistant has no CamStack integration installed (the ${PUSH_PATH} endpoint is missing). Install it from HACS, or turn off Home Assistant export`
+		};
+		if (err.status === 401 || err.status === 403) return {
+			kind: "token-rejected",
+			permanent: false,
+			text: `${http} — Home Assistant rejected the access token (revoked, or the user lacks rights); create a new long-lived token`
+		};
+		if (err.status === 413) return {
+			kind: "too-large",
+			permanent: false,
+			text: `${http} — the batch is too large for Home Assistant or a proxy in front of it`
+		};
+		const body = scrubBody(err.body);
+		return {
+			kind: "other",
+			permanent: false,
+			text: body.length > 0 ? `${http} — ${body}` : http
+		};
+	}
+	const timedOut = err instanceof Error && (err.name === "TimeoutError" || err.name === "AbortError");
+	const code = networkCode(err);
+	const fetchFailed = err instanceof TypeError && err.message === "fetch failed";
+	if (timedOut || code !== void 0 || fetchFailed) return {
+		kind: "unreachable",
+		permanent: false,
+		text: `Home Assistant is unreachable (${timedOut ? "timed out" : code ?? "network error"}) — check the address and that it is running`
+	};
+	return {
+		kind: "other",
+		permanent: false,
+		text: err instanceof Error ? err.message : String(err)
+	};
+}
+/**
+* POST one message to Home Assistant's push view.
+*
+* Authenticated with the broker's OWN long-lived token: the component
+* registers its view behind HA auth, so there is no second shared secret
+* to configure or rotate. A non-2xx throws `PushHttpError` carrying the first
+* 200 chars of the body (never the request headers), which is how the push
+* client learns why the instance is not taking the push.
+*/
+async function postToHomeAssistant(baseUrl, token, message) {
+	const response = await fetch(`${baseUrl.replace(/\/+$/, "")}${PUSH_PATH}`, {
+		method: "POST",
+		headers: {
+			authorization: `Bearer ${token}`,
+			"content-type": "application/json"
+		},
+		body: JSON.stringify(message),
+		signal: AbortSignal.timeout(1e4)
+	});
+	if (!response.ok) {
+		const body = await response.text().catch(() => "");
+		throw new PushHttpError(response.status, scrubBody(body));
+	}
+}
+//#endregion
 //#region src/ha-export/push-client.ts
 /** How long state updates accumulate before one POST carries them all. */
 var BATCH_FLUSH_MS = 1e3;
 /** Availability cadence. The component's timeout is a multiple of this. */
 var HEARTBEAT_INTERVAL_MS = 3e4;
 var IMAGE_SIGNAL_PREFIX = "__image_updated__:";
+/**
+* How long a permanent failure (a missing component) is left alone before the
+* next probe. A 404 does not heal by retrying; it heals when the operator
+* installs the component, which the settings-change reset picks up at once.
+*/
+var COMPONENT_RECHECK_MS = 10 * 6e4;
 /** Rate limit for the "HA is not answering" warning. */
 var DROP_LOG_INTERVAL_MS = 3e4;
 var PushClient = class {
@@ -5270,6 +5369,8 @@ var PushClient = class {
 	dropped = 0;
 	droppedLoggedAt = 0;
 	disposed = false;
+	lastFailure = null;
+	suspendedUntil = 0;
 	constructor(options) {
 		this.transport = options.transport;
 		this.logger = options.logger;
@@ -5280,6 +5381,18 @@ var PushClient = class {
 	get healthy() {
 		return this.available;
 	}
+	/** Why the last push failed; `null` while the link is healthy. */
+	get failure() {
+		return this.lastFailure;
+	}
+	/** A permanent failure is being left alone until the next probe. */
+	get suspended() {
+		return this.suspendedUntil > Date.now();
+	}
+	/** Probe again at once — the operator changed something. */
+	resetBackoff() {
+		this.suspendedUntil = 0;
+	}
 	/** Messages discarded because HA did not answer. Never silent. */
 	get droppedCount() {
 		return this.dropped;
@@ -5355,11 +5468,29 @@ var PushClient = class {
 	}
 	/** `true` when Home Assistant took the message. */
 	async send(message) {
+		if (this.suspended) {
+			this.dropped += message.type === "batch" ? message.items.length : 1;
+			return false;
+		}
 		try {
 			await this.transport(message);
 			this.onReachable();
 			return true;
 		} catch (err) {
+			if (err instanceof PushHttpError && err.status === 413 && message.type === "batch") {
+				const half = Math.ceil(message.items.length / 2);
+				if (message.items.length > 1) {
+					const first = await this.send({
+						type: "batch",
+						items: message.items.slice(0, half)
+					});
+					const second = await this.send({
+						type: "batch",
+						items: message.items.slice(half)
+					});
+					return first && second;
+				}
+			}
 			this.onUnreachable(message, err);
 			return false;
 		}
@@ -5367,6 +5498,8 @@ var PushClient = class {
 	onReachable() {
 		if (this.available) return;
 		this.available = true;
+		this.lastFailure = null;
+		this.suspendedUntil = 0;
 		/**
 		* The link came back. Drop the dedup cache so the reconcile that
 		* follows re-pushes every value: HA may have restarted and lost its
@@ -5404,14 +5537,18 @@ var PushClient = class {
 	*/
 	onUnreachable(message, err) {
 		this.available = false;
+		const failure = describePushFailure(err);
+		this.lastFailure = failure;
+		if (failure.permanent) this.suspendedUntil = Date.now() + COMPONENT_RECHECK_MS;
 		this.dropped += message.type === "batch" ? message.items.length : 1;
 		const now = Date.now();
 		if (now - this.droppedLoggedAt < DROP_LOG_INTERVAL_MS) return;
 		this.droppedLoggedAt = now;
-		this.logger.warn("ha-export: push to Home Assistant failed, messages dropped", { meta: {
+		this.logger.warn(`ha-export: push to Home Assistant failed (${failure.text}), messages dropped`, { meta: {
 			brokerId: this.brokerId,
 			dropped: this.dropped,
 			messageType: message.type,
+			failureKind: failure.kind,
 			error: err instanceof Error ? err.message : String(err)
 		} });
 	}
@@ -5657,7 +5794,7 @@ function reduceLastTriggers(rows) {
 function macroOf(className) {
 	const lower = className.toLowerCase();
 	if (EXPORTED_MACROS.includes(lower)) return lower;
-	const mapped = require_dist.COCO_TO_MACRO.mapping[lower];
+	const mapped = require_ha_broker_source.COCO_TO_MACRO.mapping[lower];
 	return typeof mapped === "string" ? mapped : null;
 }
 function iso(timestamp) {
@@ -6806,7 +6943,7 @@ var ExportedEntities = class {
 			this.ports.logger.warn("homeassistant-export: exported entities not reconciled — a list was unanswered", { meta: { error: errMsg$1(err) } });
 			return;
 		}
-		const { dropped } = require_dist.pruneDeletedEntities([...this.state.actions.map((e) => ({
+		const { dropped } = require_ha_broker_source.pruneDeletedEntities([...this.state.actions.map((e) => ({
 			kind: "action",
 			actionId: e.actionId
 		})), ...this.state.targets.map((e) => ({
@@ -6878,7 +7015,7 @@ var ExportedEntities = class {
 		const action = this.state.actions.find((e) => actionEntity(e.actionId) === entity);
 		if (action !== void 0) return {
 			handled: true,
-			applied: (await require_dist.runExportedAction(this.ports.api, this.ports.logger, {
+			applied: (await require_ha_broker_source.runExportedAction(this.ports.api, this.ports.logger, {
 				exporter: EXPORTER,
 				actionId: action.actionId
 			})).status === "started"
@@ -6886,7 +7023,7 @@ var ExportedEntities = class {
 		const target = this.state.targets.find((e) => targetEntity(e.targetId) === entity);
 		if (target !== void 0) return {
 			handled: true,
-			applied: (await require_dist.sendToExportedTarget(this.ports.api, this.ports.logger, {
+			applied: (await require_ha_broker_source.sendToExportedTarget(this.ports.api, this.ports.logger, {
 				exporter: EXPORTER,
 				targetId: target.targetId,
 				notification: { body: value }
@@ -6937,7 +7074,7 @@ var SUPPORTED_DEVICE_KINDS = [
 	"image",
 	"pet-feeder",
 	"hub",
-	...require_dist.PLUG_APPLIANCE_TYPES
+	...require_ha_broker_source.PLUG_APPLIANCE_TYPES
 ];
 //#endregion
 //#region src/ha-export/ha-export.addon.ts
@@ -6977,8 +7114,6 @@ var SUPPORTED_DEVICE_KINDS = [
 *     one switch per broker over the single membership store.
 */
 var ADDON_ID = "homeassistant-export";
-/** Where the custom component registers its push view inside HA. */
-var PUSH_PATH = "/api/camstack/push";
 var MEDIA_ROUTE_PREFIX = `/addon/${ADDON_ID}/ha-media`;
 /** How long `doorbell_pressed` stays on before its OFF edge is published. */
 var DOORBELL_PULSE_MS = 5e3;
@@ -7010,7 +7145,7 @@ var DEFAULT_CONFIG = {
 	},
 	publicBaseUrl: ""
 };
-var HaExportAddon = class extends require_dist.BaseAddon {
+var HaExportAddon = class extends require_ha_broker_source.BaseAddon {
 	links = /* @__PURE__ */ new Map();
 	/** deviceKey → the device it addresses. Rebuilt on every reconcile. */
 	exported = /* @__PURE__ */ new Map();
@@ -7117,7 +7252,7 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 		super({ ...DEFAULT_CONFIG });
 	}
 	async onInitialize() {
-		const secret = this.state("haExportMediaSecret", require_dist.string(), "");
+		const secret = this.state("haExportMediaSecret", require_ha_broker_source.string(), "");
 		const existing = await secret.get();
 		if (existing.length === 0) {
 			const minted = randomSecret();
@@ -7150,7 +7285,7 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 		this.exportedEntities = exportedEntities;
 		return [
 			{
-				capability: require_dist.deviceExportCapability,
+				capability: require_ha_broker_source.deviceExportCapability,
 				provider: {
 					getStatus: async () => this.buildStatus(),
 					listSupportedDeviceKinds: async () => [...SUPPORTED_DEVICE_KINDS],
@@ -7183,8 +7318,8 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 				}
 			},
 			{
-				capability: require_dist.addonRoutesCapability,
-				provider: require_dist.buildAddonRouteProvider(ADDON_ID, [{
+				capability: require_ha_broker_source.addonRoutesCapability,
+				provider: require_ha_broker_source.buildAddonRouteProvider(ADDON_ID, [{
 					method: "POST",
 					path: "/command",
 					access: "authenticated",
@@ -7195,26 +7330,27 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 				}])
 			},
 			{
-				capability: require_dist.oauthIntegrationCapability,
+				capability: require_ha_broker_source.oauthIntegrationCapability,
 				provider: { getDescriptor: async () => HOME_ASSISTANT_OAUTH_INTEGRATION }
 			}
 		];
 	}
 	async onConfigChanged() {
+		for (const link of this.links.values()) link.client.resetBackoff();
 		await this.reconcile("config-changed");
 		this.startTimer();
 	}
 	wireListeners() {
-		this.subscribe({ category: require_dist.EventCategory.DeviceStateChanged }, (event) => {
+		this.subscribe({ category: require_ha_broker_source.EventCategory.DeviceStateChanged }, (event) => {
 			this.onSliceChanged(event.data);
 		});
-		this.subscribe({ category: require_dist.EventCategory.DeviceOnline }, (event) => {
+		this.subscribe({ category: require_ha_broker_source.EventCategory.DeviceOnline }, (event) => {
 			this.onOnlineChanged(event.data, true);
 		});
-		this.subscribe({ category: require_dist.EventCategory.DeviceOffline }, (event) => {
+		this.subscribe({ category: require_ha_broker_source.EventCategory.DeviceOffline }, (event) => {
 			this.onOnlineChanged(event.data, false);
 		});
-		this.subscribe({ category: require_dist.EventCategory.MotionOnMotionChanged }, (event) => {
+		this.subscribe({ category: require_ha_broker_source.EventCategory.MotionOnMotionChanged }, (event) => {
 			this.onMotion(event.data);
 		});
 		/**
@@ -7223,13 +7359,13 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 		* the entity existed and effectively never moved. It also carries the
 		* window LEVEL, which nothing else on the export path does.
 		*/
-		this.subscribe({ category: require_dist.EventCategory.PipelineAudioInferenceResult }, (event) => {
+		this.subscribe({ category: require_ha_broker_source.EventCategory.PipelineAudioInferenceResult }, (event) => {
 			this.onAudioWindow(event.data);
 		});
-		this.subscribe({ category: require_dist.EventCategory.PipelineAnalyticsTrackLifecycle }, (event) => {
+		this.subscribe({ category: require_ha_broker_source.EventCategory.PipelineAnalyticsTrackLifecycle }, (event) => {
 			this.onTrackLifecycle(event.data);
 		});
-		this.subscribe({ category: require_dist.EventCategory.ZoneAnalyticsOccupancyChanged }, (event) => {
+		this.subscribe({ category: require_ha_broker_source.EventCategory.ZoneAnalyticsOccupancyChanged }, (event) => {
 			this.onZoneOccupancy(event.data);
 		});
 		/**
@@ -7238,11 +7374,11 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 		* rather than a state push.
 		*/
 		for (const category of [
-			require_dist.EventCategory.DeviceRegistered,
-			require_dist.EventCategory.DeviceUnregistered,
-			require_dist.EventCategory.DeviceBindingsChanged,
-			require_dist.EventCategory.DeviceMetaChanged,
-			require_dist.EventCategory.BrokerStatusChanged
+			require_ha_broker_source.EventCategory.DeviceRegistered,
+			require_ha_broker_source.EventCategory.DeviceUnregistered,
+			require_ha_broker_source.EventCategory.DeviceBindingsChanged,
+			require_ha_broker_source.EventCategory.DeviceMetaChanged,
+			require_ha_broker_source.EventCategory.BrokerStatusChanged
 		]) this.subscribe({ category }, () => {
 			this.reconcileSoon();
 		});
@@ -7883,7 +8019,9 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 			const delivered = await this.announce(exported, fullResync);
 			await this.pushFullState(exported, snapshots);
 			if (synthetic !== null) await this.pushSynthetic(projectSynthetic(synthetic, Date.now()), [...enabled]);
-			if (!delivered || [...this.links.values()].some((link) => !link.client.healthy)) {
+			const failing = [...this.links.values()].filter((link) => !link.client.healthy && !link.client.suspended);
+			const anyLive = [...this.links.values()].some((link) => !link.client.suspended);
+			if (failing.length > 0 || !delivered && anyLive) {
 				this.resync.markGap("push-not-delivered");
 				this.lastStructureFingerprint = void 0;
 				this.ctx.logger.warn("ha-export: a push was not delivered, the next pass is a full resync");
@@ -8337,7 +8475,7 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 				*/
 				capSlices: snapshot,
 				itemEntities: items.entities,
-				...require_dist.isReadingQuantity(readingQuantity) ? { readingQuantity } : {}
+				...require_ha_broker_source.isReadingQuantity(readingQuantity) ? { readingQuantity } : {}
 			},
 			heldBack
 		};
@@ -8571,7 +8709,7 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 			maskEnabled: privacySlice["enabled"] === true,
 			audioEnabled: typeof privacySlice["audioEnabled"] === "boolean" ? privacySlice["audioEnabled"] : null
 		};
-		const brokerAudioMuted = sourceNodeId === null ? null : await this.ctx.api.streamBroker.getDeviceAudioMute.query({ deviceId }, require_dist.nodePin(sourceNodeId)).then((r) => r.muted).catch((err) => {
+		const brokerAudioMuted = sourceNodeId === null ? null : await this.ctx.api.streamBroker.getDeviceAudioMute.query({ deviceId }, require_ha_broker_source.nodePin(sourceNodeId)).then((r) => r.muted).catch((err) => {
 			this.ctx.logger.warn("ha-export: could not read broker audio mute, the broker-audio function degrades", {
 				tags: { deviceId },
 				meta: {
@@ -8622,7 +8760,7 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 	* reasoning.
 	*/
 	async refreshBrokers() {
-		const haBrokers = await listHomeAssistantBrokers((input) => this.ctx.api.broker.list.query(input));
+		const haBrokers = await require_ha_broker_source.listHomeAssistantBrokers((input) => this.ctx.api.broker.list.query(input));
 		const known = haBrokers.map((broker) => ({
 			id: broker.id,
 			name: broker.name
@@ -8964,7 +9102,7 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 			}
 			switch (command.kind) {
 				case "camera-function": {
-					const parsed = require_dist.CameraSwitchIdSchema.safeParse(command.switchId);
+					const parsed = require_ha_broker_source.CameraSwitchIdSchema.safeParse(command.switchId);
 					if (!parsed.success) {
 						this.ctx.logger.warn("ha-export: dropping a command for an unknown camera function", {
 							tags: { deviceId: command.deviceId },
@@ -9225,7 +9363,7 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 				id: "ha-export-brokers",
 				title: "Home Assistant instances",
 				titleKey: "provider-homeassistant:globalSettings.s_ha-export-brokers.title",
-				description: brokerFields.length > 0 ? "An instance that is off receives nothing; its exported devices resume when it is turned back on." : "No Home Assistant broker is registered yet.",
+				description: brokerFields.length > 0 ? "An instance that is off receives nothing; its exported devices resume when it is turned back on. Export needs the CamStack custom component installed in Home Assistant (HACS)." : "No Home Assistant broker is registered yet.",
 				columns: 1,
 				fields: brokerFields.length > 0 ? brokerFields : [{
 					type: "info",
@@ -9359,16 +9497,21 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 	buildStatus() {
 		const enabled = this.enabledBrokerIds();
 		const healthy = [...this.links.values()].filter((link) => link.client.healthy).length;
+		const linkFailure = [...this.links.values()].map((link) => link.client.failure).filter((failure) => failure !== null)[0]?.text;
 		return {
 			linkState: enabled.length === 0 ? "unlinked" : healthy === this.links.size ? "linked" : "error",
 			exposedDeviceCount: exposedDeviceIds(this.config.membership, enabled).length,
-			...this.lastError !== void 0 ? { error: this.lastError } : {},
+			...linkFailure !== void 0 ? { error: linkFailure } : this.lastError !== void 0 ? { error: this.lastError } : {},
 			setup: {
 				fields: [
 					{
 						label: "Home Assistant instances",
 						value: `${healthy} / ${this.links.size} reachable`
 					},
+					{
+						label: "Last push failure",
+						value: linkFailure ?? "none"
+					},
 					{
 						label: "Entities pushed",
 						value: String(this.entityCount)
@@ -9403,26 +9546,6 @@ var HaExportAddon = class extends require_dist.BaseAddon {
 * CAPABILITIES, not its type, and restricting the picker by type is what
 * confined the previous exporter to cameras.
 */
-/**
-* POST one message to Home Assistant's push view.
-*
-* Authenticated with the broker's OWN long-lived token: the component
-* registers its view behind HA auth, so there is no second shared secret
-* to configure or rotate. A non-2xx throws, which is how the push client
-* learns the instance is unreachable.
-*/
-async function postToHomeAssistant(baseUrl, token, message) {
-	const response = await fetch(`${baseUrl.replace(/\/+$/, "")}${PUSH_PATH}`, {
-		method: "POST",
-		headers: {
-			authorization: `Bearer ${token}`,
-			"content-type": "application/json"
-		},
-		body: JSON.stringify(message),
-		signal: AbortSignal.timeout(1e4)
-	});
-	if (!response.ok) throw new Error(`Home Assistant answered ${response.status}`);
-}
 function randomSecret() {
 	const bytes = new Uint8Array(32);
 	crypto.getRandomValues(bytes);