homebridge-bluos 1.0.1 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.0.2](https://github.com/tbaur/homebridge-bluos/compare/v1.0.1...v1.0.2) (2026-08-18)
+
+
+### Bug Fixes
+
+* log when a player answers again after an outage ([7e26d9d](https://github.com/tbaur/homebridge-bluos/commit/7e26d9d449d36282d2aeb829cb436380520e3882))
+
 ## [1.0.1](https://github.com/tbaur/homebridge-bluos/compare/v1.0.0...v1.0.1) (2026-08-18)
 
 

package/README.md

@@ -26,7 +26,7 @@ What stays in the BluOS app is the part HomeKit has no vocabulary for: browsing,
 - **Long-polling, not polling** — `/SyncStatus?timeout=100` with an `etag`, so a change made on the front panel, the remote or the BluOS app reaches HomeKit in about a second, without hammering the player
 - **Follows the API's rate rules** — One second minimum between two requests for the same resource, per the BluOS specification; writes to one chassis are serialised, and separate chassis stay parallel
 - **Survives a DHCP lease change** — Accessory identity is the player's MAC and zone port, never its address. If a player moves, the plugin re-resolves it and remembers the new address
-- **Backs off when a player is off** — Exponential delay to a one-minute ceiling instead of dialling an absent player every second; the first failure warns, the rest go to debug
+- **Backs off when a player is off** — Exponential delay to a one-minute ceiling instead of dialling an absent player every second. A single failure is a debug line; the warning comes when the player has missed three polls and HomeKit is told No Response, then at most hourly while it stays away, with one line when it answers again
 - **Answers HomeKit promptly** — A write returns inside HAP's patience window and finishes anything slower in the background, where the result still reaches HomeKit through the next poll
 - **No volume jumps** — The pair of writes HomeKit sends when a slider leaves zero is coalesced into one command
 - **Honest state** — An accessory reports No Response until the player has actually been read, and again once it stops answering, rather than showing a value it cannot confirm

package/dist/devices/base-accessory.js

@@ -53,6 +53,12 @@ class BaseAccessory {
     }
     /** Apply a fresh observation, and remember that state is now known. */
     applyObservation(observation, reason) {
+        if (this.offline) {
+            // Every outage warns on its way in, so it gets a matching line on its way
+            // out: without one, a log shows a player failing and never recovering, and
+            // an outage that healed reads exactly like one still in progress.
+            this.host.log.info(`${(0, utils_1.forLog)(this.displayName)} [${(0, utils_1.forLog)(this.deviceId)}] is responding again`);
+        }
         this.offline = false;
         this.observed = true;
         this.lastWarningAt = 0;

package/docs/FEATURES.md

@@ -29,7 +29,7 @@ A checklist of what is built. The plugin aims to cover everything about a BluOS
 - ✅ The pair of writes HomeKit sends when a slider leaves zero is coalesced into one command
 - ✅ Set/poll race protection with a generation counter, so a slider never springs back
 - ✅ A deliberately cancelled poll is not counted as a failure
-- ✅ Exponential backoff to a one-minute ceiling for an unreachable player; the first failure warns, the rest go to debug
+- ✅ Exponential backoff to a one-minute ceiling for an unreachable player; a lone failure logs at debug, the warning waits for the third missed poll that turns the tile to No Response, repeats hourly at most, and is answered by a recovery line
 - ✅ Automatic address re-resolution after repeated failures, rate-limited, so a DHCP lease change needs no user action
 - ✅ New addresses persisted into the accessory cache so they survive a restart
 - ✅ Accessory identity is `MAC:port:kind` (plus the preset level), never the address, so an IP change keeps your accessories

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-bluos",
   "displayName": "Homebridge BluOS",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Homebridge plugin for BluOS players — per-zone volume, mute, volume-preset and battery accessories over the LAN Custom Integration API. Verified on NAD and Bluesound hardware",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",