@camstack/addon-provider-homeassistant 1.2.650 → 1.2.651

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.651] - 2026-11-02
+
+### Changed
+
+- A Home Assistant restart no longer parks the link for 10 minutes: a 404 must persist for a minute before the component counts as missing, and a suspended link is now logged and reported on every reconcile
+
 ## [1.2.650] - 2026-11-02
 
 ### Changed

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_ha_broker_source = require("./ha-broker-source-DUj9pUWr.js");
+const require_ha_broker_source = require("./ha-broker-source-D4_TtF2V.js");
 let node_crypto = require("node:crypto");
 let node_zlib = require("node:zlib");
 //#region src/ha-admin-link.ts

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { $ as humiditySensorCapability, $t as discriminatedUnion, A as brokerCapability, At as tamperCapability, C as alarmPanelCapability, Ct as runningFromMediaPlayer, D as bestLocationMatch, E as batteryCapability, Et as scriptRunnerCapability, F as carbonMonoxideCapability, Ft as vacuumControlCapability, G as deviceAdoptionCapability, Gt as defineEntryKind, H as controlCapability, Ht as baseUnitOf, I as climateControlCapability, It as valveCapability, J as eventEmitterCapability, Kt as defineRecordKinds, L as colorCapability, Lt as vibrationCapability, M as buildDeviceAdminUrl, Mt as tryConvertDelta, N as buttonCapability, Nt as tryConvertUnit, O as binaryCapability, Ot as smokeCapability, P as calendarSourceCapability, Pt as updateCapability, Q as humidifierCapability, Qt as boolean, R as connectivityCapability, Rt as waterHeaterCapability, S as airQualitySensorCapability, St as runningFromLawnMower, T as automationControlCapability, Tt as runningStateCapability, U as coverCapability, Ut as createEvent, V as contactCapability, Vt as RecordSecretUnavailableError, W as deviceAdminLinkCapability, X as floodCapability, Xt as _enum, Y as fanControlCapability, Z as gasCapability, Zt as array, a as BaseDevice, an as union, at as motionCapability, b as accessoriesCapability, bt as resolveAttachmentUrls, cn as DeviceFeature, ct as notifierCapability, dn as errMsg, dt as parseAdminBase, en as literal, et as imageCapability, fn as EventCategory, ft as powerMeterCapability, gt as pressureSensorCapability, ht as presenceCapability, in as string, it as mediaPlayerCapability, j as buildAddonRouteProvider, jt as temperatureSensorCapability, k as brightnessCapability, kt as switchCapability, ln as DeviceRole, lt as numericSensorCapability, mt as prepareNotification, nn as object, nt as lawnMowerControlCapability, o as BaseDeviceProvider, on as unknown, ot as normalizeUnit, p as EnumSensorDateTimeFormatSchema, q as enumSensorCapability, qt as entryBody, rn as record, rt as lockControlCapability, sn as url, st as notificationOutputCapability, t as HA_BROKER_KIND, tn as number, tt as ingestReading, un as DeviceType, v as RUNNING_STATE_COLD, vt as publicEndpointReaderFrom, w as ambientLightSensorCapability, wt as runningFromVacuumState, x as addonRoutesCapability, y as TargetSchema, yt as quantityFromUnit, zt as weatherCapability } from "./ha-broker-source-B2v2dnPe.mjs";
+import { $ as humiditySensorCapability, $t as discriminatedUnion, A as brokerCapability, At as tamperCapability, C as alarmPanelCapability, Ct as runningFromMediaPlayer, D as bestLocationMatch, E as batteryCapability, Et as scriptRunnerCapability, F as carbonMonoxideCapability, Ft as vacuumControlCapability, G as deviceAdoptionCapability, Gt as defineEntryKind, H as controlCapability, Ht as baseUnitOf, I as climateControlCapability, It as valveCapability, J as eventEmitterCapability, Kt as defineRecordKinds, L as colorCapability, Lt as vibrationCapability, M as buildDeviceAdminUrl, Mt as tryConvertDelta, N as buttonCapability, Nt as tryConvertUnit, O as binaryCapability, Ot as smokeCapability, P as calendarSourceCapability, Pt as updateCapability, Q as humidifierCapability, Qt as boolean, R as connectivityCapability, Rt as waterHeaterCapability, S as airQualitySensorCapability, St as runningFromLawnMower, T as automationControlCapability, Tt as runningStateCapability, U as coverCapability, Ut as createEvent, V as contactCapability, Vt as RecordSecretUnavailableError, W as deviceAdminLinkCapability, X as floodCapability, Xt as _enum, Y as fanControlCapability, Z as gasCapability, Zt as array, a as BaseDevice, an as union, at as motionCapability, b as accessoriesCapability, bt as resolveAttachmentUrls, cn as DeviceFeature, ct as notifierCapability, dn as errMsg, dt as parseAdminBase, en as literal, et as imageCapability, fn as EventCategory, ft as powerMeterCapability, gt as pressureSensorCapability, ht as presenceCapability, in as string, it as mediaPlayerCapability, j as buildAddonRouteProvider, jt as temperatureSensorCapability, k as brightnessCapability, kt as switchCapability, ln as DeviceRole, lt as numericSensorCapability, mt as prepareNotification, nn as object, nt as lawnMowerControlCapability, o as BaseDeviceProvider, on as unknown, ot as normalizeUnit, p as EnumSensorDateTimeFormatSchema, q as enumSensorCapability, qt as entryBody, rn as record, rt as lockControlCapability, sn as url, st as notificationOutputCapability, t as HA_BROKER_KIND, tn as number, tt as ingestReading, un as DeviceType, v as RUNNING_STATE_COLD, vt as publicEndpointReaderFrom, w as ambientLightSensorCapability, wt as runningFromVacuumState, x as addonRoutesCapability, y as TargetSchema, yt as quantityFromUnit, zt as weatherCapability } from "./ha-broker-source-CCmZ9I6P.mjs";
 import { randomUUID } from "node:crypto";
 import { brotliCompressSync, deflateSync, gzipSync } from "node:zlib";
 //#region src/ha-admin-link.ts

package/dist/{ha-broker-source-B2v2dnPe.mjs → ha-broker-source-CCmZ9I6P.mjs}

@@ -12974,6 +12974,73 @@ var NodeColorIdSchema = _enum([
 	"node-g",
 	"node-h"
 ]);
+//#endregion
+//#region ../types/dist/index.mjs
+var SMTP_INBOUND_DEFAULT_PORT = 2525;
+var SMTP_INBOUND_DEFAULT_DOMAIN = "camstack.local";
+var SMTP_INBOUND_DEFAULT_MAX_MESSAGE_BYTES = 25 * 1024 * 1024;
+/** The text excerpt a message carries on the bus. */
+var SMTP_INBOUND_TEXT_MAX_CHARS = 4096;
+var PortSchema = number().int().min(1).max(65535);
+/** A recipient local-part: what stands before the `@`. */
+var SmtpRecipientSchema = string().min(1).max(64).regex(/^[A-Za-z0-9._+-]+$/);
+object({
+	port: PortSchema.default(SMTP_INBOUND_DEFAULT_PORT),
+	bindHost: string().min(1).default("0.0.0.0"),
+	domain: string().min(1).default(SMTP_INBOUND_DEFAULT_DOMAIN),
+	requireAuth: boolean().default(true),
+	username: string().default(""),
+	password: string().default("").meta({ secret: true }),
+	starttls: boolean().default(false),
+	maxMessageBytes: number().int().positive().default(SMTP_INBOUND_DEFAULT_MAX_MESSAGE_BYTES)
+});
+object({
+	host: string().min(1).nullable(),
+	hostReason: string().nullable(),
+	port: PortSchema,
+	domain: string().min(1),
+	requireAuth: boolean(),
+	username: string(),
+	password: string(),
+	starttls: boolean()
+});
+object({
+	recipients: array(SmtpRecipientSchema).min(1),
+	/**
+	* Who is subscribing. A second `subscribe` with the same id REPLACES that subscriber's
+	* recipients (the way a consumer that restarted, or lost a device, declares its set again);
+	* a recipient held by another subscriber is refused with `smtp-inbound/recipient-claimed`.
+	* Absent, the subscriber is anonymous and unique.
+	*/
+	subscriberId: string().min(1).max(64).optional()
+});
+var SmtpInboundAttachmentSchema = object({
+	filename: string(),
+	contentType: string(),
+	bytes: number().int().nonnegative()
+});
+/** The payload of one `broker.message` (the key is the recipient local-part). */
+var SmtpInboundMessageSchema = object({
+	/** Monotonic per mailbox; a gap tells a consumer it missed an event. */
+	seq: number().int().positive(),
+	messageId: string(),
+	receivedAt: number().int().nonnegative(),
+	from: string(),
+	to: string(),
+	subject: string(),
+	text: string().max(SMTP_INBOUND_TEXT_MAX_CHARS),
+	attachments: array(SmtpInboundAttachmentSchema)
+});
+object({
+	/** The newest seq issued so far (0 before any mail). */
+	lastSeq: number().int().nonnegative(),
+	/** The oldest seq still retained; messages below it are gone. */
+	oldestSeq: number().int().nonnegative(),
+	messages: array(object({
+		key: string(),
+		message: SmtpInboundMessageSchema
+	}))
+});
 new Set([
 	"track",
 	"face",
@@ -55900,6 +55967,11 @@ var IntegrationInstanceSchema = object({
 	name: string(),
 	/** The addon's own rule (an URL is present, a client id is present...). */
 	configured: boolean(),
+	/**
+	* The instance's own on/off switch (D996): always present, derived from the record body
+	* (`enabled !== false`, so a row written before the field existed is on).
+	*/
+	enabled: boolean(),
 	/** Values for the instance form; a secret is a `SecretFieldView`, never text. */
 	formValues: record(string(), unknown()),
 	status: IntegrationInstanceStatusSchema.optional()
@@ -55919,6 +55991,12 @@ method(_void(), IntegrationInstanceDescriptionSchema, { auth: "admin" }), method
 }), method(IntegrationInstancePatchSchema, object({ ok: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({
+	id: IntegrationInstanceIdSchema,
+	enabled: boolean()
+}), object({ ok: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({ id: IntegrationInstanceIdSchema }), object({ ok: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
@@ -85446,6 +85524,13 @@ Object.freeze({
 		access: "view",
 		role: "admin"
 	},
+	"integrationInstances.setInstanceEnabled": {
+		capName: "integration-instances",
+		capScope: "system",
+		addonId: null,
+		access: "create",
+		role: "admin"
+	},
 	"integrationInstances.testInstance": {
 		capName: "integration-instances",
 		capScope: "system",

package/dist/{ha-broker-source-DUj9pUWr.js → ha-broker-source-D4_TtF2V.js}

@@ -12975,6 +12975,73 @@ var NodeColorIdSchema = _enum([
 	"node-g",
 	"node-h"
 ]);
+//#endregion
+//#region ../types/dist/index.mjs
+var SMTP_INBOUND_DEFAULT_PORT = 2525;
+var SMTP_INBOUND_DEFAULT_DOMAIN = "camstack.local";
+var SMTP_INBOUND_DEFAULT_MAX_MESSAGE_BYTES = 25 * 1024 * 1024;
+/** The text excerpt a message carries on the bus. */
+var SMTP_INBOUND_TEXT_MAX_CHARS = 4096;
+var PortSchema = number().int().min(1).max(65535);
+/** A recipient local-part: what stands before the `@`. */
+var SmtpRecipientSchema = string().min(1).max(64).regex(/^[A-Za-z0-9._+-]+$/);
+object({
+	port: PortSchema.default(SMTP_INBOUND_DEFAULT_PORT),
+	bindHost: string().min(1).default("0.0.0.0"),
+	domain: string().min(1).default(SMTP_INBOUND_DEFAULT_DOMAIN),
+	requireAuth: boolean().default(true),
+	username: string().default(""),
+	password: string().default("").meta({ secret: true }),
+	starttls: boolean().default(false),
+	maxMessageBytes: number().int().positive().default(SMTP_INBOUND_DEFAULT_MAX_MESSAGE_BYTES)
+});
+object({
+	host: string().min(1).nullable(),
+	hostReason: string().nullable(),
+	port: PortSchema,
+	domain: string().min(1),
+	requireAuth: boolean(),
+	username: string(),
+	password: string(),
+	starttls: boolean()
+});
+object({
+	recipients: array(SmtpRecipientSchema).min(1),
+	/**
+	* Who is subscribing. A second `subscribe` with the same id REPLACES that subscriber's
+	* recipients (the way a consumer that restarted, or lost a device, declares its set again);
+	* a recipient held by another subscriber is refused with `smtp-inbound/recipient-claimed`.
+	* Absent, the subscriber is anonymous and unique.
+	*/
+	subscriberId: string().min(1).max(64).optional()
+});
+var SmtpInboundAttachmentSchema = object({
+	filename: string(),
+	contentType: string(),
+	bytes: number().int().nonnegative()
+});
+/** The payload of one `broker.message` (the key is the recipient local-part). */
+var SmtpInboundMessageSchema = object({
+	/** Monotonic per mailbox; a gap tells a consumer it missed an event. */
+	seq: number().int().positive(),
+	messageId: string(),
+	receivedAt: number().int().nonnegative(),
+	from: string(),
+	to: string(),
+	subject: string(),
+	text: string().max(SMTP_INBOUND_TEXT_MAX_CHARS),
+	attachments: array(SmtpInboundAttachmentSchema)
+});
+object({
+	/** The newest seq issued so far (0 before any mail). */
+	lastSeq: number().int().nonnegative(),
+	/** The oldest seq still retained; messages below it are gone. */
+	oldestSeq: number().int().nonnegative(),
+	messages: array(object({
+		key: string(),
+		message: SmtpInboundMessageSchema
+	}))
+});
 new Set([
 	"track",
 	"face",
@@ -55901,6 +55968,11 @@ var IntegrationInstanceSchema = object({
 	name: string(),
 	/** The addon's own rule (an URL is present, a client id is present...). */
 	configured: boolean(),
+	/**
+	* The instance's own on/off switch (D996): always present, derived from the record body
+	* (`enabled !== false`, so a row written before the field existed is on).
+	*/
+	enabled: boolean(),
 	/** Values for the instance form; a secret is a `SecretFieldView`, never text. */
 	formValues: record(string(), unknown()),
 	status: IntegrationInstanceStatusSchema.optional()
@@ -55920,6 +55992,12 @@ method(_void(), IntegrationInstanceDescriptionSchema, { auth: "admin" }), method
 }), method(IntegrationInstancePatchSchema, object({ ok: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({
+	id: IntegrationInstanceIdSchema,
+	enabled: boolean()
+}), object({ ok: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({ id: IntegrationInstanceIdSchema }), object({ ok: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
@@ -85447,6 +85525,13 @@ Object.freeze({
 		access: "view",
 		role: "admin"
 	},
+	"integrationInstances.setInstanceEnabled": {
+		capName: "integration-instances",
+		capScope: "system",
+		addonId: null,
+		access: "create",
+		role: "admin"
+	},
 	"integrationInstances.testInstance": {
 		capName: "integration-instances",
 		capScope: "system",

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_ha_broker_source = require("../ha-broker-source-DUj9pUWr.js");
+const require_ha_broker_source = require("../ha-broker-source-D4_TtF2V.js");
 let node_crypto = require("node:crypto");
 require("node:zlib");
 let node_fs = require("node:fs");
@@ -5491,6 +5491,10 @@ var PushClient = class {
 	disposed = false;
 	lastFailure = null;
 	suspendedUntil = 0;
+	/** When the current unbroken streak of 404s began; 0 when there is none. */
+	first404At = 0;
+	/** A suspension was entered and not yet logged as left. */
+	suspensionLogged = false;
 	constructor(options) {
 		this.transport = options.transport;
 		this.logger = options.logger;
@@ -5509,9 +5513,20 @@ var PushClient = class {
 	get suspended() {
 		return this.suspendedUntil > Date.now();
 	}
+	/** Epoch ms of the next probe while suspended; 0 otherwise. */
+	get recheckAt() {
+		return this.suspended ? this.suspendedUntil : 0;
+	}
 	/** Probe again at once — the operator changed something. */
 	resetBackoff() {
 		this.suspendedUntil = 0;
+		this.first404At = 0;
+		this.logSuspensionEnded("reset by a settings change");
+	}
+	logSuspensionEnded(why) {
+		if (!this.suspensionLogged) return;
+		this.suspensionLogged = false;
+		this.logger.info(`ha-export: push link no longer suspended (${why}), probing again`, { meta: { brokerId: this.brokerId } });
 	}
 	/** Messages discarded because HA did not answer. Never silent. */
 	get droppedCount() {
@@ -5592,8 +5607,13 @@ var PushClient = class {
 			this.dropped += message.type === "batch" ? message.items.length : 1;
 			return false;
 		}
+		if (this.suspendedUntil !== 0 && !this.suspended) {
+			this.suspendedUntil = 0;
+			this.logSuspensionEnded("recheck time reached");
+		}
 		try {
 			await this.transport(message);
+			this.first404At = 0;
 			this.onReachable();
 			return true;
 		} catch (err) {
@@ -5620,6 +5640,7 @@ var PushClient = class {
 		this.available = true;
 		this.lastFailure = null;
 		this.suspendedUntil = 0;
+		this.logSuspensionEnded("Home Assistant answered");
 		/**
 		* The link came back. Drop the dedup cache so the reconcile that
 		* follows re-pushes every value: HA may have restarted and lost its
@@ -5657,11 +5678,29 @@ var PushClient = class {
 	*/
 	onUnreachable(message, err) {
 		this.available = false;
-		const failure = describePushFailure(err);
+		const now = Date.now();
+		const described = describePushFailure(err);
+		let failure = described;
+		if (described.kind === "component-missing") {
+			if (this.first404At === 0) this.first404At = now;
+			if (now - this.first404At < 6e4) failure = {
+				kind: "other",
+				permanent: false,
+				text: "HTTP 404 — Home Assistant has not registered the CamStack endpoint (yet); retrying"
+			};
+		} else this.first404At = 0;
 		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 (failure.permanent) {
+			this.suspendedUntil = now + COMPONENT_RECHECK_MS;
+			this.suspensionLogged = true;
+			this.logger.warn(`ha-export: push link SUSPENDED (${failure.text}); next probe at ${new Date(this.suspendedUntil).toISOString()}`, { meta: {
+				brokerId: this.brokerId,
+				failureKind: failure.kind,
+				recheckAt: this.suspendedUntil,
+				recheckInMs: COMPONENT_RECHECK_MS
+			} });
+		}
 		if (now - this.droppedLoggedAt < DROP_LOG_INTERVAL_MS) return;
 		this.droppedLoggedAt = now;
 		this.logger.warn(`ha-export: push to Home Assistant failed (${failure.text}), messages dropped`, { meta: {
@@ -5673,6 +5712,19 @@ var PushClient = class {
 		} });
 	}
 };
+//#endregion
+//#region src/ha-export/link-gaps.ts
+/** A parked link is reported, never silently excluded. */
+function summariseLinkGaps(links) {
+	return {
+		failing: links.filter((l) => !l.healthy && !l.suspended).map((l) => l.brokerId),
+		suspended: links.filter((l) => l.suspended).map((l) => ({
+			brokerId: l.brokerId,
+			recheckAt: l.recheckAt
+		})),
+		anyLive: links.some((l) => !l.suspended)
+	};
+}
 var ReachabilityReconciler = class {
 	options;
 	minIntervalMs;
@@ -8144,13 +8196,21 @@ var HaExportAddon = class extends require_ha_broker_source.BaseAddon {
 			const delivered = await this.announce(exported, fullResync);
 			await this.pushFullState(exported, snapshots);
 			if (synthetic !== null) await this.pushSynthetic(projectSynthetic(synthetic, Date.now()), [...enabled]);
-			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) {
+			const gaps = summariseLinkGaps([...this.links.entries()].map(([brokerId, link]) => ({
+				brokerId,
+				healthy: link.client.healthy,
+				suspended: link.client.suspended,
+				recheckAt: link.client.recheckAt
+			})));
+			if (gaps.failing.length > 0 || !delivered && gaps.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");
 			}
+			if (gaps.suspended.length > 0) this.ctx.logger.warn("ha-export: push links suspended, Home Assistant receives nothing", { meta: { suspended: gaps.suspended.map((s) => ({
+				brokerId: s.brokerId,
+				recheckAt: new Date(s.recheckAt).toISOString()
+			})) } });
 			this.ctx.logger.info("ha-export: reconciled", { meta: {
 				reason,
 				fullResync,
@@ -8158,6 +8218,7 @@ var HaExportAddon = class extends require_ha_broker_source.BaseAddon {
 				devices: exported.size,
 				entities: entityCount,
 				unclassifiedCaps: this.unclassified.length,
+				suspendedLinks: gaps.suspended.length,
 				durationMs: Date.now() - startedAt
 			} });
 			if (this.unclassified.length > 0) this.ctx.logger.warn("ha-export: capabilities in neither the map nor the exclusion list", { meta: { caps: this.unclassified } });

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

@@ -1,4 +1,4 @@
-import { B as consumableKindOf, Bt as BaseAddon, Dt as sendToExportedTarget, Ht as baseUnitOf, Jt as isReadingQuantity, K as deviceExportCapability, Wt as defineAddonMigrations, Yt as nodePin, Zt as array, _ as PLUG_APPLIANCE_TYPES, _t as pruneDeletedEntities, c as COCO_TO_MACRO, d as ConsumableItemSchema, f as ConsumableStatusSchema, fn as EventCategory, g as MediaPlayerRepeatSchema, h as HvacModeSchema, i as AlarmArmModeSchema, in as string, j as buildAddonRouteProvider, l as CameraSwitchIdSchema, m as FanDirectionSchema, nn as object, on as unknown, pt as preconditionOf, r as listHomeAssistantBrokers, s as CAMERA_SWITCH_ORDER, u as ConsumableFormSchema, ut as oauthIntegrationCapability, x as addonRoutesCapability, xt as runExportedAction, z as consumableFormOf } from "../ha-broker-source-B2v2dnPe.mjs";
+import { B as consumableKindOf, Bt as BaseAddon, Dt as sendToExportedTarget, Ht as baseUnitOf, Jt as isReadingQuantity, K as deviceExportCapability, Wt as defineAddonMigrations, Yt as nodePin, Zt as array, _ as PLUG_APPLIANCE_TYPES, _t as pruneDeletedEntities, c as COCO_TO_MACRO, d as ConsumableItemSchema, f as ConsumableStatusSchema, fn as EventCategory, g as MediaPlayerRepeatSchema, h as HvacModeSchema, i as AlarmArmModeSchema, in as string, j as buildAddonRouteProvider, l as CameraSwitchIdSchema, m as FanDirectionSchema, nn as object, on as unknown, pt as preconditionOf, r as listHomeAssistantBrokers, s as CAMERA_SWITCH_ORDER, u as ConsumableFormSchema, ut as oauthIntegrationCapability, x as addonRoutesCapability, xt as runExportedAction, z as consumableFormOf } from "../ha-broker-source-CCmZ9I6P.mjs";
 import { createHmac, timingSafeEqual } from "node:crypto";
 import "node:zlib";
 import "node:fs";
@@ -5456,6 +5456,10 @@ var PushClient = class {
 	disposed = false;
 	lastFailure = null;
 	suspendedUntil = 0;
+	/** When the current unbroken streak of 404s began; 0 when there is none. */
+	first404At = 0;
+	/** A suspension was entered and not yet logged as left. */
+	suspensionLogged = false;
 	constructor(options) {
 		this.transport = options.transport;
 		this.logger = options.logger;
@@ -5474,9 +5478,20 @@ var PushClient = class {
 	get suspended() {
 		return this.suspendedUntil > Date.now();
 	}
+	/** Epoch ms of the next probe while suspended; 0 otherwise. */
+	get recheckAt() {
+		return this.suspended ? this.suspendedUntil : 0;
+	}
 	/** Probe again at once — the operator changed something. */
 	resetBackoff() {
 		this.suspendedUntil = 0;
+		this.first404At = 0;
+		this.logSuspensionEnded("reset by a settings change");
+	}
+	logSuspensionEnded(why) {
+		if (!this.suspensionLogged) return;
+		this.suspensionLogged = false;
+		this.logger.info(`ha-export: push link no longer suspended (${why}), probing again`, { meta: { brokerId: this.brokerId } });
 	}
 	/** Messages discarded because HA did not answer. Never silent. */
 	get droppedCount() {
@@ -5557,8 +5572,13 @@ var PushClient = class {
 			this.dropped += message.type === "batch" ? message.items.length : 1;
 			return false;
 		}
+		if (this.suspendedUntil !== 0 && !this.suspended) {
+			this.suspendedUntil = 0;
+			this.logSuspensionEnded("recheck time reached");
+		}
 		try {
 			await this.transport(message);
+			this.first404At = 0;
 			this.onReachable();
 			return true;
 		} catch (err) {
@@ -5585,6 +5605,7 @@ var PushClient = class {
 		this.available = true;
 		this.lastFailure = null;
 		this.suspendedUntil = 0;
+		this.logSuspensionEnded("Home Assistant answered");
 		/**
 		* The link came back. Drop the dedup cache so the reconcile that
 		* follows re-pushes every value: HA may have restarted and lost its
@@ -5622,11 +5643,29 @@ var PushClient = class {
 	*/
 	onUnreachable(message, err) {
 		this.available = false;
-		const failure = describePushFailure(err);
+		const now = Date.now();
+		const described = describePushFailure(err);
+		let failure = described;
+		if (described.kind === "component-missing") {
+			if (this.first404At === 0) this.first404At = now;
+			if (now - this.first404At < 6e4) failure = {
+				kind: "other",
+				permanent: false,
+				text: "HTTP 404 — Home Assistant has not registered the CamStack endpoint (yet); retrying"
+			};
+		} else this.first404At = 0;
 		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 (failure.permanent) {
+			this.suspendedUntil = now + COMPONENT_RECHECK_MS;
+			this.suspensionLogged = true;
+			this.logger.warn(`ha-export: push link SUSPENDED (${failure.text}); next probe at ${new Date(this.suspendedUntil).toISOString()}`, { meta: {
+				brokerId: this.brokerId,
+				failureKind: failure.kind,
+				recheckAt: this.suspendedUntil,
+				recheckInMs: COMPONENT_RECHECK_MS
+			} });
+		}
 		if (now - this.droppedLoggedAt < DROP_LOG_INTERVAL_MS) return;
 		this.droppedLoggedAt = now;
 		this.logger.warn(`ha-export: push to Home Assistant failed (${failure.text}), messages dropped`, { meta: {
@@ -5638,6 +5677,19 @@ var PushClient = class {
 		} });
 	}
 };
+//#endregion
+//#region src/ha-export/link-gaps.ts
+/** A parked link is reported, never silently excluded. */
+function summariseLinkGaps(links) {
+	return {
+		failing: links.filter((l) => !l.healthy && !l.suspended).map((l) => l.brokerId),
+		suspended: links.filter((l) => l.suspended).map((l) => ({
+			brokerId: l.brokerId,
+			recheckAt: l.recheckAt
+		})),
+		anyLive: links.some((l) => !l.suspended)
+	};
+}
 var ReachabilityReconciler = class {
 	options;
 	minIntervalMs;
@@ -8109,13 +8161,21 @@ var HaExportAddon = class extends BaseAddon {
 			const delivered = await this.announce(exported, fullResync);
 			await this.pushFullState(exported, snapshots);
 			if (synthetic !== null) await this.pushSynthetic(projectSynthetic(synthetic, Date.now()), [...enabled]);
-			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) {
+			const gaps = summariseLinkGaps([...this.links.entries()].map(([brokerId, link]) => ({
+				brokerId,
+				healthy: link.client.healthy,
+				suspended: link.client.suspended,
+				recheckAt: link.client.recheckAt
+			})));
+			if (gaps.failing.length > 0 || !delivered && gaps.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");
 			}
+			if (gaps.suspended.length > 0) this.ctx.logger.warn("ha-export: push links suspended, Home Assistant receives nothing", { meta: { suspended: gaps.suspended.map((s) => ({
+				brokerId: s.brokerId,
+				recheckAt: new Date(s.recheckAt).toISOString()
+			})) } });
 			this.ctx.logger.info("ha-export: reconciled", { meta: {
 				reason,
 				fullResync,
@@ -8123,6 +8183,7 @@ var HaExportAddon = class extends BaseAddon {
 				devices: exported.size,
 				entities: entityCount,
 				unclassifiedCaps: this.unclassified.length,
+				suspendedLinks: gaps.suspended.length,
 				durationMs: Date.now() - startedAt
 			} });
 			if (this.unclassified.length > 0) this.ctx.logger.warn("ha-export: capabilities in neither the map nor the exclusion list", { meta: { caps: this.unclassified } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-homeassistant",
-  "version": "1.2.650",
+  "version": "1.2.651",
   "description": "Home Assistant device provider addon for CamStack",
   "keywords": [
     "camstack",
@@ -127,7 +127,7 @@
       "description": "Device provider (import) + native entity export (push). Two addons, one bundle, separate processes."
     },
     "requires": {
-      "server": ">=1.2.740"
+      "server": ">=1.2.741"
     }
   },
   "files": [