homebridge-bluos 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -1,7 +1,22 @@
 # 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)
+
+
+### Bug Fixes
+
+* **deps:** hold @types/node at the Node 20 floor and ship the pending UI utils bump ([b2f4be3](https://github.com/tbaur/homebridge-bluos/commit/b2f4be3e9caa5d6fa8736c4ee2c5cd9a42cfeb1a))
+
 ## [1.0.0](https://github.com/tbaur/homebridge-bluos/compare/v0.1.1...v1.0.0) (2026-08-18)
 
+First stable release. Volume, mute, volume presets, and battery for each discovered BluOS player, keyed to the player's MAC address so a new DHCP lease keeps the accessory — and with it the room and automations you attached to it. See [README.md](README.md) for what each accessory does and [docs/FEATURES.md](docs/FEATURES.md) for what is planned next.
 
 ### Miscellaneous Chores
 
@@ -14,10 +29,6 @@
 
 * BluOS players in HomeKit, verified against real hardware ([643e029](https://github.com/tbaur/homebridge-bluos/commit/643e0298c127e9df92dc42841896c5844162f1ec))
 
-## Changelog
-
-All notable changes to this project are documented in this file. This file is maintained automatically by [release-please](https://github.com/googleapis/release-please) based on [Conventional Commits](https://www.conventionalcommits.org).
-
-## Unreleased
+## 0.1.0 (2026-08-18)
 
-* initial BluOS plugin
+Published by hand to create the package name so an npm trusted publisher could be attached to it; see [RELEASING.md](RELEASING.md). Functionally identical to 0.1.1, which is the first version the release workflow published.

package/DEVELOPMENT.md

@@ -33,7 +33,7 @@ A capability ships if HomeKit can express it as a tile, a scene, an automation o
 
 ## Commands
 
-Node 20+, matching `engines`. CI runs 20 / 22 / 24, a Homebridge 1.6 floor job, and a runtime `npm audit`.
+Node 20+, matching `engines`. CI runs 20 / 22 / 24, a Homebridge 1.6 floor job, and a runtime `npm audit`. `@types/node` stays on the 20 line for the same reason: newer types let the compiler accept API that the oldest supported runtime does not have. Dependabot is told not to raise it — the floor and the types move together, deliberately.
 
 ```bash
 npm install

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.0",
+  "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",
@@ -44,7 +44,7 @@
     "brace-expansion": "^5.0.9"
   },
   "dependencies": {
-    "@homebridge/plugin-ui-utils": "2.2.4",
+    "@homebridge/plugin-ui-utils": "2.2.5",
     "multicast-dns": "7.2.5"
   },
   "devDependencies": {