@camstack/addon-provider-homeassistant 1.1.28 → 1.1.29

package/dist/addon.js

@@ -7356,6 +7356,24 @@ var RecordingRetentionSchema = object({
 	maxSizeGb: number().min(0).optional()
 });
 /**
+* Scrub-thumbnail fidelity preset — the single per-camera selector bundling the
+* sprite tile RESOLUTION + JPEG QUALITY the recorder packs timeline-scrub
+* previews at. Five graduated steps; absent on a config = `standard` (the
+* shipped default, matching `sheet-geometry`/`sheet-composer`).
+*
+* Existing sheets are IMMUTABLE — a changed preset applies to NEW windows only.
+* Each window's index sidecar carries its own tile dims, so a camera whose
+* preset changed over time renders every historical window at the dims it was
+* written with.
+*/
+var ScrubThumbnailPresetSchema = _enum([
+	"minimal",
+	"low",
+	"standard",
+	"high",
+	"max"
+]);
+/**
 * The full per-camera recording intent — the wire shape of a RecordingTarget.
 *
 * `mode` is the authoritative storage choice; `schedule`/`triggers`/`pre`/`post`
@@ -7392,7 +7410,14 @@ var RecordingConfigSchema = object({
 	* derived into bands once via `migrateConfigToBands`.
 	*/
 	bands: array(RecordingBandSchema).optional(),
-	retention: RecordingRetentionSchema.optional()
+	retention: RecordingRetentionSchema.optional(),
+	/**
+	* Per-camera scrub-thumbnail fidelity preset (resolution + JPEG quality for
+	* timeline-scrub sprite previews). Absent = `standard`. Applies to NEW
+	* windows only — existing sheets are immutable, and each window's index
+	* carries its own tile dims so mixed-preset history renders correctly.
+	*/
+	scrubThumbnails: ScrubThumbnailPresetSchema.optional()
 });
 /**
 * `StorageLocationType` — an addon-declared id that identifies the *kind* of
@@ -32801,7 +32826,7 @@ var BUS_EVENT_TYPES = [
 	"deconz_event",
 	"xiaomi_aqara.click"
 ];
-var HaIntegrationManager = class {
+var HaIntegrationManager = class HaIntegrationManager {
 	opts;
 	wsClient = null;
 	connection = null;
@@ -32815,6 +32840,15 @@ var HaIntegrationManager = class {
 	lastCheckedAt = null;
 	lastError = null;
 	haInfo = {};
+	/** Deadline timer for the INITIAL connect. `start()` no longer blocks on
+	*  the socket (see the comment there), so a broker whose host silently
+	*  drops packets would otherwise sit at `connecting` for the full OS TCP
+	*  timeout (tens of seconds) with no UI signal. This timer flips it to
+	*  `unreachable` promptly; a late successful connect still overrides it. */
+	connectDeadlineTimer = null;
+	/** Ceiling on the `connecting` state before the UI is shown `unreachable`.
+	*  Slightly above the throwaway `testSettings` probe timeout (8s). */
+	static CONNECT_DEADLINE_MS = 1e4;
 	constructor(opts) {
 		this.opts = opts;
 	}
@@ -32828,6 +32862,8 @@ var HaIntegrationManager = class {
 					await this.refreshHaConfigInfo(connection);
 					await this.ensureBaselineSubscription();
 					await this.ensureBusEventSubscriptions();
+					this.clearConnectDeadline();
+					this.lastError = null;
 					this.setStatus("connected");
 					try {
 						this.opts.onConnected?.(this.opts.id);
@@ -32863,14 +32899,32 @@ var HaIntegrationManager = class {
 				}
 			}
 		});
-		try {
-			await this.wsClient.start();
-		} catch (err) {
+		this.startConnectDeadline();
+		this.wsClient.start().catch((err) => {
 			this.classifyAuthError(err);
-			throw err;
+		});
+	}
+	/** Arm the initial-connect deadline. Idempotent — clears any prior timer. */
+	startConnectDeadline() {
+		this.clearConnectDeadline();
+		const timer = setTimeout(() => {
+			this.connectDeadlineTimer = null;
+			if (this.status === "connecting") {
+				if (this.lastError === null) this.lastError = "Connection timed out";
+				this.setStatus("unreachable");
+			}
+		}, HaIntegrationManager.CONNECT_DEADLINE_MS);
+		if (typeof timer.unref === "function") timer.unref();
+		this.connectDeadlineTimer = timer;
+	}
+	clearConnectDeadline() {
+		if (this.connectDeadlineTimer) {
+			clearTimeout(this.connectDeadlineTimer);
+			this.connectDeadlineTimer = null;
 		}
 	}
 	async stop() {
+		this.clearConnectDeadline();
 		if (this.upstreamSubscriptionUnsub) {
 			try {
 				await this.upstreamSubscriptionUnsub();
@@ -33085,15 +33139,19 @@ var HaIntegrationManager = class {
 		}));
 	}
 	classifyAuthError(err) {
+		this.clearConnectDeadline();
 		if (err === 2) {
+			this.lastError = "Authentication failed — check the access token";
 			this.setStatus("auth-failed");
-			this.lastError = "invalid_auth";
-		} else if (err === 1 || err === 4) {
+		} else if (err === 1) {
+			this.lastError = "Cannot connect — host unreachable or Home Assistant not responding";
+			this.setStatus("unreachable");
+		} else if (err === 4) {
+			this.lastError = "Home Assistant host / URL is required";
 			this.setStatus("unreachable");
-			this.lastError = errMsg(err);
 		} else {
-			this.setStatus("error");
 			this.lastError = errMsg(err);
+			this.setStatus("error");
 		}
 	}
 	requireConnection() {

package/dist/addon.mjs

@@ -7355,6 +7355,24 @@ var RecordingRetentionSchema = object({
 	maxSizeGb: number().min(0).optional()
 });
 /**
+* Scrub-thumbnail fidelity preset — the single per-camera selector bundling the
+* sprite tile RESOLUTION + JPEG QUALITY the recorder packs timeline-scrub
+* previews at. Five graduated steps; absent on a config = `standard` (the
+* shipped default, matching `sheet-geometry`/`sheet-composer`).
+*
+* Existing sheets are IMMUTABLE — a changed preset applies to NEW windows only.
+* Each window's index sidecar carries its own tile dims, so a camera whose
+* preset changed over time renders every historical window at the dims it was
+* written with.
+*/
+var ScrubThumbnailPresetSchema = _enum([
+	"minimal",
+	"low",
+	"standard",
+	"high",
+	"max"
+]);
+/**
 * The full per-camera recording intent — the wire shape of a RecordingTarget.
 *
 * `mode` is the authoritative storage choice; `schedule`/`triggers`/`pre`/`post`
@@ -7391,7 +7409,14 @@ var RecordingConfigSchema = object({
 	* derived into bands once via `migrateConfigToBands`.
 	*/
 	bands: array(RecordingBandSchema).optional(),
-	retention: RecordingRetentionSchema.optional()
+	retention: RecordingRetentionSchema.optional(),
+	/**
+	* Per-camera scrub-thumbnail fidelity preset (resolution + JPEG quality for
+	* timeline-scrub sprite previews). Absent = `standard`. Applies to NEW
+	* windows only — existing sheets are immutable, and each window's index
+	* carries its own tile dims so mixed-preset history renders correctly.
+	*/
+	scrubThumbnails: ScrubThumbnailPresetSchema.optional()
 });
 /**
 * `StorageLocationType` — an addon-declared id that identifies the *kind* of
@@ -32800,7 +32825,7 @@ var BUS_EVENT_TYPES = [
 	"deconz_event",
 	"xiaomi_aqara.click"
 ];
-var HaIntegrationManager = class {
+var HaIntegrationManager = class HaIntegrationManager {
 	opts;
 	wsClient = null;
 	connection = null;
@@ -32814,6 +32839,15 @@ var HaIntegrationManager = class {
 	lastCheckedAt = null;
 	lastError = null;
 	haInfo = {};
+	/** Deadline timer for the INITIAL connect. `start()` no longer blocks on
+	*  the socket (see the comment there), so a broker whose host silently
+	*  drops packets would otherwise sit at `connecting` for the full OS TCP
+	*  timeout (tens of seconds) with no UI signal. This timer flips it to
+	*  `unreachable` promptly; a late successful connect still overrides it. */
+	connectDeadlineTimer = null;
+	/** Ceiling on the `connecting` state before the UI is shown `unreachable`.
+	*  Slightly above the throwaway `testSettings` probe timeout (8s). */
+	static CONNECT_DEADLINE_MS = 1e4;
 	constructor(opts) {
 		this.opts = opts;
 	}
@@ -32827,6 +32861,8 @@ var HaIntegrationManager = class {
 					await this.refreshHaConfigInfo(connection);
 					await this.ensureBaselineSubscription();
 					await this.ensureBusEventSubscriptions();
+					this.clearConnectDeadline();
+					this.lastError = null;
 					this.setStatus("connected");
 					try {
 						this.opts.onConnected?.(this.opts.id);
@@ -32862,14 +32898,32 @@ var HaIntegrationManager = class {
 				}
 			}
 		});
-		try {
-			await this.wsClient.start();
-		} catch (err) {
+		this.startConnectDeadline();
+		this.wsClient.start().catch((err) => {
 			this.classifyAuthError(err);
-			throw err;
+		});
+	}
+	/** Arm the initial-connect deadline. Idempotent — clears any prior timer. */
+	startConnectDeadline() {
+		this.clearConnectDeadline();
+		const timer = setTimeout(() => {
+			this.connectDeadlineTimer = null;
+			if (this.status === "connecting") {
+				if (this.lastError === null) this.lastError = "Connection timed out";
+				this.setStatus("unreachable");
+			}
+		}, HaIntegrationManager.CONNECT_DEADLINE_MS);
+		if (typeof timer.unref === "function") timer.unref();
+		this.connectDeadlineTimer = timer;
+	}
+	clearConnectDeadline() {
+		if (this.connectDeadlineTimer) {
+			clearTimeout(this.connectDeadlineTimer);
+			this.connectDeadlineTimer = null;
 		}
 	}
 	async stop() {
+		this.clearConnectDeadline();
 		if (this.upstreamSubscriptionUnsub) {
 			try {
 				await this.upstreamSubscriptionUnsub();
@@ -33084,15 +33138,19 @@ var HaIntegrationManager = class {
 		}));
 	}
 	classifyAuthError(err) {
+		this.clearConnectDeadline();
 		if (err === 2) {
+			this.lastError = "Authentication failed — check the access token";
 			this.setStatus("auth-failed");
-			this.lastError = "invalid_auth";
-		} else if (err === 1 || err === 4) {
+		} else if (err === 1) {
+			this.lastError = "Cannot connect — host unreachable or Home Assistant not responding";
+			this.setStatus("unreachable");
+		} else if (err === 4) {
+			this.lastError = "Home Assistant host / URL is required";
 			this.setStatus("unreachable");
-			this.lastError = errMsg(err);
 		} else {
-			this.setStatus("error");
 			this.lastError = errMsg(err);
+			this.setStatus("error");
 		}
 	}
 	requireConnection() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-homeassistant",
-  "version": "1.1.28",
+  "version": "1.1.29",
   "description": "Home Assistant device provider addon for CamStack",
   "keywords": [
     "camstack",