@camstack/addon-import-alexa 0.2.171 → 0.2.172

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.172] - 2026-10-31
+
+### Changed
+
+- Alexa shows an error instead of 'connected' when polling Amazon keeps failing, with the HTTP status in the log.
+- Alexa: quiet vs announce is now decided per notification (a silent notification is spoken quietly, any other announces); the per-target Mode setting is gone and a stored one is ignored.
+
 ## [0.2.171] - 2026-10-30
 
 ### Changed

package/dist/addon.js

@@ -137148,7 +137148,21 @@ function isRateLimitError(message) {
 	const m = message.toLowerCase();
 	return m.includes("rate exceeded") || m.includes("throttl") || m.includes("too many requests") || m.includes("429");
 }
+/** HTTP statuses that mean Amazon rejected the session (a re-link is needed). */
+var SESSION_DEAD_STATUSES = new Set([401, 403]);
+/** The library logs `No body (code=NNN)` on a body-less non-2xx; it is the only place the status shows. */
+var NO_BODY_CODE = /No body \(code=(\d{3})\)/;
+/** A failed Amazon call whose HTTP status is known (null when the library did not say). */
+var AlexaHttpError = class extends Error {
+	statusCode;
+	constructor(message, statusCode) {
+		super(message);
+		this.name = "AlexaHttpError";
+		this.statusCode = statusCode;
+	}
+};
 var AlexaRemoteClient = class {
+	#lastHttpStatus = null;
 	#options;
 	#logger;
 	#dataDir;
@@ -137168,7 +137182,10 @@ var AlexaRemoteClient = class {
 	async connect() {
 		const remote = new import_alexa_remote.default();
 		this.#remote = remote;
-		const initOptions = await this.#buildInitOptions();
+		const initOptions = {
+			...await this.#buildInitOptions(),
+			logger: (...args) => this.#captureLibraryLine(args)
+		};
 		remote.on("cookie", () => {
 			this.#persistSession(remote);
 		});
@@ -137262,11 +137279,17 @@ var AlexaRemoteClient = class {
 	async #withBackoff(op, run) {
 		let lastError = null;
 		for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) try {
+			this.#lastHttpStatus = null;
 			return await run();
 		} catch (err) {
 			lastError = err;
 			const message = errMsg(err);
 			if (isAuthError(message)) throw new AlexaAuthError(message);
+			if (message.toLowerCase().includes("no body")) {
+				const status = this.#lastHttpStatus;
+				if (status !== null && SESSION_DEAD_STATUSES.has(status)) throw new AlexaAuthError(`${message} (HTTP ${status})`);
+				throw new AlexaHttpError(message, status);
+			}
 			if (!isRateLimitError(message) || attempt === MAX_ATTEMPTS - 1) throw err;
 			const delay = this.#backoffDelay(attempt);
 			this.#logger?.warn("AlexaRemoteClient: rate-limited — backing off", { meta: {
@@ -137279,6 +137302,10 @@ var AlexaRemoteClient = class {
 		}
 		throw lastError instanceof Error ? lastError : /* @__PURE__ */ new Error(`AlexaRemoteClient: ${op} failed`);
 	}
+	#captureLibraryLine(args) {
+		const match = NO_BODY_CODE.exec(args.map(String).join(" "));
+		if (match?.[1] !== void 0) this.#lastHttpStatus = Number(match[1]);
+	}
 	#backoffDelay(attempt) {
 		return Math.min(BACKOFF_BASE_MS * 2 ** attempt, BACKOFF_MAX_MS) + Math.floor(Math.random() * BACKOFF_BASE_MS);
 	}
@@ -137517,8 +137544,6 @@ var AlexaCommandSink = class {
 };
 /** The single in-process command sink shared across the addon. */
 var alexaCommands = new AlexaCommandSink();
-//#endregion
-//#region src/alexa-integration-manager.ts
 /**
 * Wraps exactly one {@link AlexaClient} (= one Amazon account). Authenticates on
 * `start()`, lists the appliance inventory, then runs a POLL loop (Alexa has no
@@ -137546,6 +137571,7 @@ var AlexaIntegrationManager = class {
 	#client = null;
 	#pollTimer = null;
 	#status = "disconnected";
+	#pollFailures = 0;
 	#applianceCount = 0;
 	#lastCheckedAt = null;
 	#error = null;
@@ -137650,14 +137676,37 @@ var AlexaIntegrationManager = class {
 			alexaAccounts.recordStates(this.#id, values);
 			this.#lastCheckedAt = Date.now();
 			this.#onStatesPolled(this.#id, values);
+			this.#pollFailures = 0;
+			this.#error = null;
+			if (this.#status === "error" || this.#status === "auth-failed") this.#transition("connected");
 		} catch (err) {
 			this.#error = errMsg(err);
+			this.#pollFailures += 1;
+			const httpStatus = err instanceof AlexaHttpError ? err.statusCode : null;
 			this.#logger.warn("AlexaIntegrationManager: poll failed", {
 				tags: { brokerId: this.#id },
-				meta: { error: errMsg(err) }
+				meta: {
+					error: errMsg(err),
+					consecutiveFailures: this.#pollFailures,
+					httpStatus
+				}
 			});
+			if (this.#pollFailures >= 3 && this.#status !== "disconnected") this.#transition(err instanceof AlexaAuthError ? "auth-failed" : "error");
 		}
 	}
+	#transition(next) {
+		if (this.#status === next) return;
+		const previous = this.#status;
+		this.#status = next;
+		this.#logger.info("AlexaIntegrationManager: status changed", {
+			tags: { brokerId: this.#id },
+			meta: {
+				from: previous,
+				to: next,
+				error: this.#error
+			}
+		});
+	}
 	/** Stop the poll loop, disconnect the client (FIRST), null it. */
 	async stop() {
 		if (this.#pollTimer !== null) {
@@ -139313,9 +139362,16 @@ function readString(config, key) {
 	const value = config[key];
 	return typeof value === "string" ? value : "";
 }
-/** The rule's value for this send wins; the target's saved config is the fallback. */
-function readMode(config, delivery) {
-	return (delivery?.["mode"] ?? config["mode"]) === "announce" ? "announce" : "speak";
+/** The level id an Echo notification uses for "quiet: no chime, no announcement". */
+var SILENT_LEVEL_ID = "silent";
+var SILENT_PRIORITY = 1;
+/**
+* Quiet or announce is decided PER NOTIFICATION, never per target: a silent
+* notification (the kind's silent level, or the lowest priority when no level
+* is named) is spoken quietly, hours-aware; every other one announces.
+*/
+function modeFor(notification) {
+	return (notification.level !== void 0 ? notification.level === SILENT_LEVEL_ID : notification.priority <= SILENT_PRIORITY) ? "speak" : "announce";
 }
 function readVolume(config, delivery) {
 	const ruled = delivery?.["volume"];
@@ -139326,21 +139382,9 @@ function readVolume(config, delivery) {
 /**
 * The delivery parameters a rule may set for an Echo target (D938). The
 * target's own config holds the default; these override it per notification.
+* Quiet vs announce is not one of them: it follows the notification's level.
 */
 var DELIVERY_PARAMS = [{
-	key: "mode",
-	label: "Mode",
-	labelKey: "import-alexa:echoTarget.s_echo.mode.label",
-	type: "enum",
-	options: [{
-		value: "speak",
-		label: "Speak (quiet hours apply)"
-	}, {
-		value: "announce",
-		label: "Announce (chime, then speech)"
-	}],
-	default: "speak"
-}, {
 	key: "volume",
 	label: "Volume",
 	labelKey: "import-alexa:echoTarget.s_echo.volume.label",
@@ -139391,20 +139435,6 @@ function configSchema() {
 					dependsOn: ["brokerId"]
 				}
 			}],
-			{
-				type: "select",
-				key: "mode",
-				label: "Mode",
-				labelKey: "import-alexa:echoTarget.s_echo.mode.label",
-				default: "speak",
-				options: [{
-					value: "speak",
-					label: "Speak (quiet hours apply)"
-				}, {
-					value: "announce",
-					label: "Announce (chime, then speech)"
-				}]
-			},
 			{
 				type: "number",
 				key: "volume",
@@ -139446,9 +139476,16 @@ function alexaTargetKind() {
 			actions: 0,
 			actionIcons: false,
 			levels: [{
+				id: SILENT_LEVEL_ID,
+				label: "Silent",
+				ordinal: SILENT_PRIORITY,
+				flags: { silent: true },
+				description: "Spoken quietly: no chime, quiet hours apply."
+			}, {
 				id: "default",
-				label: "Default",
-				ordinal: 3
+				label: "Announce",
+				ordinal: 3,
+				description: "Announced: chime, then speech."
 			}],
 			format: ["text"],
 			clickUrl: false,
@@ -139465,7 +139502,6 @@ function discoveredFrom(broker, device) {
 		config: {
 			brokerId: broker.id,
 			echoId: device.id,
-			mode: "speak",
 			volume: 40,
 			respectDnd: true,
 			family: device.family,
@@ -139478,6 +139514,7 @@ function createAlexaNotificationProvider(ports) {
 	let targets = ports.loadTargets();
 	let ledger = emptySpeechLedger();
 	let deliveries = [];
+	const warnedLegacyMode = /* @__PURE__ */ new Set();
 	function record(row) {
 		deliveries = [...deliveries, row];
 	}
@@ -139619,7 +139656,14 @@ function createAlexaNotificationProvider(ports) {
 				renderedAs: speech.renderedAs
 			};
 		}
-		const mode = readMode(target.config, notification.delivery);
+		const mode = modeFor(notification);
+		if (target.config["mode"] !== void 0 && !warnedLegacyMode.has(target.id)) {
+			warnedLegacyMode.add(target.id);
+			logger.warn("alexa target mode is ignored: quiet vs announce follows each notification", {
+				...tags,
+				meta: { targetId: target.id }
+			});
+		}
 		try {
 			const outcomes = await ports.speak({
 				brokerId: broker.id,
@@ -140049,7 +140093,6 @@ function targetsFrom(rows) {
 		config: {
 			...row.brokerId.length > 0 ? { brokerId: row.brokerId } : {},
 			echoId: row.echoId,
-			mode: row.mode,
 			volume: row.volume,
 			respectDnd: row.respectDnd
 		}
@@ -140062,7 +140105,7 @@ function rowsFrom(targets) {
 		enabled: target.enabled,
 		brokerId: typeof target.config["brokerId"] === "string" ? target.config["brokerId"] : "",
 		echoId: typeof target.config["echoId"] === "string" ? target.config["echoId"] : "",
-		mode: target.config["mode"] === "announce" ? "announce" : "speak",
+		mode: "speak",
 		volume: typeof target.config["volume"] === "number" ? target.config["volume"] : 40,
 		respectDnd: target.config["respectDnd"] !== false
 	}));

package/dist/addon.mjs

@@ -137146,7 +137146,21 @@ function isRateLimitError(message) {
 	const m = message.toLowerCase();
 	return m.includes("rate exceeded") || m.includes("throttl") || m.includes("too many requests") || m.includes("429");
 }
+/** HTTP statuses that mean Amazon rejected the session (a re-link is needed). */
+var SESSION_DEAD_STATUSES = new Set([401, 403]);
+/** The library logs `No body (code=NNN)` on a body-less non-2xx; it is the only place the status shows. */
+var NO_BODY_CODE = /No body \(code=(\d{3})\)/;
+/** A failed Amazon call whose HTTP status is known (null when the library did not say). */
+var AlexaHttpError = class extends Error {
+	statusCode;
+	constructor(message, statusCode) {
+		super(message);
+		this.name = "AlexaHttpError";
+		this.statusCode = statusCode;
+	}
+};
 var AlexaRemoteClient = class {
+	#lastHttpStatus = null;
 	#options;
 	#logger;
 	#dataDir;
@@ -137166,7 +137180,10 @@ var AlexaRemoteClient = class {
 	async connect() {
 		const remote = new import_alexa_remote.default();
 		this.#remote = remote;
-		const initOptions = await this.#buildInitOptions();
+		const initOptions = {
+			...await this.#buildInitOptions(),
+			logger: (...args) => this.#captureLibraryLine(args)
+		};
 		remote.on("cookie", () => {
 			this.#persistSession(remote);
 		});
@@ -137260,11 +137277,17 @@ var AlexaRemoteClient = class {
 	async #withBackoff(op, run) {
 		let lastError = null;
 		for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) try {
+			this.#lastHttpStatus = null;
 			return await run();
 		} catch (err) {
 			lastError = err;
 			const message = errMsg(err);
 			if (isAuthError(message)) throw new AlexaAuthError(message);
+			if (message.toLowerCase().includes("no body")) {
+				const status = this.#lastHttpStatus;
+				if (status !== null && SESSION_DEAD_STATUSES.has(status)) throw new AlexaAuthError(`${message} (HTTP ${status})`);
+				throw new AlexaHttpError(message, status);
+			}
 			if (!isRateLimitError(message) || attempt === MAX_ATTEMPTS - 1) throw err;
 			const delay = this.#backoffDelay(attempt);
 			this.#logger?.warn("AlexaRemoteClient: rate-limited — backing off", { meta: {
@@ -137277,6 +137300,10 @@ var AlexaRemoteClient = class {
 		}
 		throw lastError instanceof Error ? lastError : /* @__PURE__ */ new Error(`AlexaRemoteClient: ${op} failed`);
 	}
+	#captureLibraryLine(args) {
+		const match = NO_BODY_CODE.exec(args.map(String).join(" "));
+		if (match?.[1] !== void 0) this.#lastHttpStatus = Number(match[1]);
+	}
 	#backoffDelay(attempt) {
 		return Math.min(BACKOFF_BASE_MS * 2 ** attempt, BACKOFF_MAX_MS) + Math.floor(Math.random() * BACKOFF_BASE_MS);
 	}
@@ -137515,8 +137542,6 @@ var AlexaCommandSink = class {
 };
 /** The single in-process command sink shared across the addon. */
 var alexaCommands = new AlexaCommandSink();
-//#endregion
-//#region src/alexa-integration-manager.ts
 /**
 * Wraps exactly one {@link AlexaClient} (= one Amazon account). Authenticates on
 * `start()`, lists the appliance inventory, then runs a POLL loop (Alexa has no
@@ -137544,6 +137569,7 @@ var AlexaIntegrationManager = class {
 	#client = null;
 	#pollTimer = null;
 	#status = "disconnected";
+	#pollFailures = 0;
 	#applianceCount = 0;
 	#lastCheckedAt = null;
 	#error = null;
@@ -137648,14 +137674,37 @@ var AlexaIntegrationManager = class {
 			alexaAccounts.recordStates(this.#id, values);
 			this.#lastCheckedAt = Date.now();
 			this.#onStatesPolled(this.#id, values);
+			this.#pollFailures = 0;
+			this.#error = null;
+			if (this.#status === "error" || this.#status === "auth-failed") this.#transition("connected");
 		} catch (err) {
 			this.#error = errMsg(err);
+			this.#pollFailures += 1;
+			const httpStatus = err instanceof AlexaHttpError ? err.statusCode : null;
 			this.#logger.warn("AlexaIntegrationManager: poll failed", {
 				tags: { brokerId: this.#id },
-				meta: { error: errMsg(err) }
+				meta: {
+					error: errMsg(err),
+					consecutiveFailures: this.#pollFailures,
+					httpStatus
+				}
 			});
+			if (this.#pollFailures >= 3 && this.#status !== "disconnected") this.#transition(err instanceof AlexaAuthError ? "auth-failed" : "error");
 		}
 	}
+	#transition(next) {
+		if (this.#status === next) return;
+		const previous = this.#status;
+		this.#status = next;
+		this.#logger.info("AlexaIntegrationManager: status changed", {
+			tags: { brokerId: this.#id },
+			meta: {
+				from: previous,
+				to: next,
+				error: this.#error
+			}
+		});
+	}
 	/** Stop the poll loop, disconnect the client (FIRST), null it. */
 	async stop() {
 		if (this.#pollTimer !== null) {
@@ -139311,9 +139360,16 @@ function readString(config, key) {
 	const value = config[key];
 	return typeof value === "string" ? value : "";
 }
-/** The rule's value for this send wins; the target's saved config is the fallback. */
-function readMode(config, delivery) {
-	return (delivery?.["mode"] ?? config["mode"]) === "announce" ? "announce" : "speak";
+/** The level id an Echo notification uses for "quiet: no chime, no announcement". */
+var SILENT_LEVEL_ID = "silent";
+var SILENT_PRIORITY = 1;
+/**
+* Quiet or announce is decided PER NOTIFICATION, never per target: a silent
+* notification (the kind's silent level, or the lowest priority when no level
+* is named) is spoken quietly, hours-aware; every other one announces.
+*/
+function modeFor(notification) {
+	return (notification.level !== void 0 ? notification.level === SILENT_LEVEL_ID : notification.priority <= SILENT_PRIORITY) ? "speak" : "announce";
 }
 function readVolume(config, delivery) {
 	const ruled = delivery?.["volume"];
@@ -139324,21 +139380,9 @@ function readVolume(config, delivery) {
 /**
 * The delivery parameters a rule may set for an Echo target (D938). The
 * target's own config holds the default; these override it per notification.
+* Quiet vs announce is not one of them: it follows the notification's level.
 */
 var DELIVERY_PARAMS = [{
-	key: "mode",
-	label: "Mode",
-	labelKey: "import-alexa:echoTarget.s_echo.mode.label",
-	type: "enum",
-	options: [{
-		value: "speak",
-		label: "Speak (quiet hours apply)"
-	}, {
-		value: "announce",
-		label: "Announce (chime, then speech)"
-	}],
-	default: "speak"
-}, {
 	key: "volume",
 	label: "Volume",
 	labelKey: "import-alexa:echoTarget.s_echo.volume.label",
@@ -139389,20 +139433,6 @@ function configSchema() {
 					dependsOn: ["brokerId"]
 				}
 			}],
-			{
-				type: "select",
-				key: "mode",
-				label: "Mode",
-				labelKey: "import-alexa:echoTarget.s_echo.mode.label",
-				default: "speak",
-				options: [{
-					value: "speak",
-					label: "Speak (quiet hours apply)"
-				}, {
-					value: "announce",
-					label: "Announce (chime, then speech)"
-				}]
-			},
 			{
 				type: "number",
 				key: "volume",
@@ -139444,9 +139474,16 @@ function alexaTargetKind() {
 			actions: 0,
 			actionIcons: false,
 			levels: [{
+				id: SILENT_LEVEL_ID,
+				label: "Silent",
+				ordinal: SILENT_PRIORITY,
+				flags: { silent: true },
+				description: "Spoken quietly: no chime, quiet hours apply."
+			}, {
 				id: "default",
-				label: "Default",
-				ordinal: 3
+				label: "Announce",
+				ordinal: 3,
+				description: "Announced: chime, then speech."
 			}],
 			format: ["text"],
 			clickUrl: false,
@@ -139463,7 +139500,6 @@ function discoveredFrom(broker, device) {
 		config: {
 			brokerId: broker.id,
 			echoId: device.id,
-			mode: "speak",
 			volume: 40,
 			respectDnd: true,
 			family: device.family,
@@ -139476,6 +139512,7 @@ function createAlexaNotificationProvider(ports) {
 	let targets = ports.loadTargets();
 	let ledger = emptySpeechLedger();
 	let deliveries = [];
+	const warnedLegacyMode = /* @__PURE__ */ new Set();
 	function record(row) {
 		deliveries = [...deliveries, row];
 	}
@@ -139617,7 +139654,14 @@ function createAlexaNotificationProvider(ports) {
 				renderedAs: speech.renderedAs
 			};
 		}
-		const mode = readMode(target.config, notification.delivery);
+		const mode = modeFor(notification);
+		if (target.config["mode"] !== void 0 && !warnedLegacyMode.has(target.id)) {
+			warnedLegacyMode.add(target.id);
+			logger.warn("alexa target mode is ignored: quiet vs announce follows each notification", {
+				...tags,
+				meta: { targetId: target.id }
+			});
+		}
 		try {
 			const outcomes = await ports.speak({
 				brokerId: broker.id,
@@ -140047,7 +140091,6 @@ function targetsFrom(rows) {
 		config: {
 			...row.brokerId.length > 0 ? { brokerId: row.brokerId } : {},
 			echoId: row.echoId,
-			mode: row.mode,
 			volume: row.volume,
 			respectDnd: row.respectDnd
 		}
@@ -140060,7 +140103,7 @@ function rowsFrom(targets) {
 		enabled: target.enabled,
 		brokerId: typeof target.config["brokerId"] === "string" ? target.config["brokerId"] : "",
 		echoId: typeof target.config["echoId"] === "string" ? target.config["echoId"] : "",
-		mode: target.config["mode"] === "announce" ? "announce" : "speak",
+		mode: "speak",
 		volume: typeof target.config["volume"] === "number" ? target.config["volume"] : 40,
 		respectDnd: target.config["respectDnd"] !== false
 	}));

package/i18n/en.json

@@ -14,7 +14,6 @@
   "echoTarget.s_echo.title": "Echo",
   "echoTarget.s_echo.brokerId.label": "Amazon account",
   "echoTarget.s_echo.echoId.label": "Echo",
-  "echoTarget.s_echo.mode.label": "Mode",
   "echoTarget.s_echo.volume.label": "Volume",
   "echoTarget.s_echo.respectDnd.label": "Respect Do Not Disturb",
   "globalSettings": {

package/i18n/it.json

@@ -14,7 +14,6 @@
   "echoTarget.s_echo.title": "Echo",
   "echoTarget.s_echo.brokerId.label": "Account Amazon",
   "echoTarget.s_echo.echoId.label": "Echo",
-  "echoTarget.s_echo.mode.label": "Modalità",
   "echoTarget.s_echo.volume.label": "Volume",
   "echoTarget.s_echo.respectDnd.label": "Rispetta Non disturbare",
   "globalSettings": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-import-alexa",
-  "version": "0.2.171",
+  "version": "0.2.172",
   "description": "Alexa device-import provider for CamStack — imports the smart-home devices in a user's Alexa account via the unofficial alexa-remote2 cookie/token client (the inverse of the Alexa exporter)",
   "keywords": [
     "camstack",