@mp-consulting/homebridge-daikin-cloud 1.5.1 → 1.6.0

package/README.md

@@ -27,6 +27,7 @@ A [Homebridge](https://homebridge.io) plugin that integrates Daikin air conditio
   - Oscillation switch (`showOscillationSwitch`)
   - Dry mode (`showDryMode`)
   - Fan only mode (`showFanOnlyMode`)
+  - Holiday (away) mode (`showHolidayMode`)
 - **Separate Fan Tile** (`showSeparateFanControl`): Expose fan speed and oscillation as a standalone Fan tile, so both stay visible even when the accessory is grouped into a single tile in the Home app
 - **Firmware Updates** (`showFirmwareUpdateSwitch`): Manage gateway firmware updates from HomeKit instead of the Onecta app. The plugin logs when Daikin stages an update for your unit and exposes a "Firmware Update" switch — turn it on to install; it stays on while the update runs and the plugin logs the outcome. Not part of `showExtraFeatures`: it must be enabled explicitly, so an "all switches on" scene can never trigger an install. The unit is unavailable (and rejects commands) while it updates. The current firmware version is also shown in each accessory's HomeKit details.
 
@@ -47,8 +48,8 @@ This plugin supports two authentication methods:
 
 ## Requirements
 
-- Node.js >= 18.15.0
-- Homebridge >= 1.5.0
+- Node.js 20.5+, 22.10+, 24 or 26
+- Homebridge >= 1.5.0 (including 2.x)
 - A Daikin account with devices registered in the Onecta app
 
 ## Installation
@@ -137,26 +138,30 @@ Add the platform to your Homebridge `config.json`:
 | `daikinPassword` | string | - | Daikin account password (Mobile App mode) |
 | `clientId` | string | - | Daikin Developer App Client ID (Developer Portal mode) |
 | `clientSecret` | string | - | Daikin Developer App Client Secret (Developer Portal mode) |
-| `callbackServerExternalAddress` | string | auto-detected | External IP/hostname for OAuth callback |
+| `callbackServerExternalAddress` | string | - | IP/hostname your browser uses to reach Homebridge for the OAuth callback (Developer Portal mode; the settings UI suggests this host's LAN IP) |
 | `callbackServerPort` | number | `8582` | Port for OAuth callback server (1-65535) |
-| `oidcCallbackServerBindAddr` | string | `0.0.0.0` | Address to bind callback server (valid IPv4) |
-| `updateIntervalInMinutes` | number | `15` | Polling interval (Developer Portal: 15+ min, Mobile App: 1-5 min) |
-| `forceUpdateDelay` | number | `60000` | Delay (ms) before refreshing after a change |
+| `oidcCallbackServerBindAddr` | string | `0.0.0.0` | Interface the temporary OAuth callback server listens on. Use `0.0.0.0` unless the browser you log in with runs on the Homebridge host itself; only then does a loopback address (`127.0.0.1`) work. The settings UI refuses to start authentication with a loopback bind address and a non-loopback callback address |
+| `updateIntervalInMinutes` | number | `15` | Polling interval, 1-60 (Developer Portal: 15+ min, Mobile App: 1-5 min). Stretched automatically, see [API Rate Limits](#api-rate-limits) |
+| `forceUpdateDelay` | number | `60000` | Delay (ms, 5000-300000) before refreshing after a change from HomeKit. Skipped while the WebSocket is connected |
 | `enableWebSocket` | boolean | `true` | Enable real-time updates (Mobile App mode only) |
 | `httpTransport` | string | `node` | `node` or `curl`. Use `curl` only if authentication times out on your network while curl works — some WAFs drop Node's TLS fingerprint ([#6](https://github.com/mp-consulting/homebridge-daikin-cloud/issues/6)). Requires the curl binary; WebSocket still uses Node TLS. Env override: `DAIKIN_HTTP_TRANSPORT` |
 | `excludedDevicesByDeviceId` | string[] | `[]` | Device IDs to exclude from HomeKit |
-| `showPowerfulMode` | boolean | `false` | Show Powerful mode switch |
-| `showEconoMode` | boolean | `false` | Show Econo mode switch |
-| `showStreamerMode` | boolean | `false` | Show Streamer mode switch |
-| `showOutdoorSilentMode` | boolean | `false` | Show Outdoor Silent mode switch |
-| `showIndoorSilentMode` | boolean | `false` | Show Indoor Silent mode switch |
-| `showAutoFanMode` | boolean | `false` | Show Auto fan mode switch (toggles fan speed between auto and manual) |
-| `showOscillationSwitch` | boolean | `false` | Show fan oscillation (swing) as a separate switch (stays visible when the accessory is grouped into a single tile) |
+| `showExtraFeatures` | boolean | `false` | Legacy catch-all: default for every per-feature switch below marked *follows `showExtraFeatures`* |
+| `showPowerfulMode` | boolean | follows `showExtraFeatures` | Show Powerful mode switch |
+| `showEconoMode` | boolean | follows `showExtraFeatures` | Show Econo mode switch |
+| `showStreamerMode` | boolean | follows `showExtraFeatures` | Show Streamer mode switch |
+| `showOutdoorSilentMode` | boolean | follows `showExtraFeatures` | Show Outdoor Silent mode switch |
+| `showIndoorSilentMode` | boolean | follows `showExtraFeatures` | Show Indoor Silent mode switch |
+| `showAutoFanMode` | boolean | follows `showExtraFeatures` | Show Auto fan mode switch (toggles fan speed between auto and manual) |
+| `showOscillationSwitch` | boolean | follows `showExtraFeatures` | Show fan oscillation (swing) as a separate switch (stays visible when the accessory is grouped into a single tile) |
+| `showDryMode` | boolean | follows `showExtraFeatures` | Show Dry mode switch |
+| `showFanOnlyMode` | boolean | follows `showExtraFeatures` | Show Fan Only mode switch |
+| `showHolidayMode` | boolean | follows `showExtraFeatures` | Show Holiday (away) mode switch: on puts the unit into holiday mode, off resumes normal operation |
 | `showSeparateFanControl` | boolean | `false` | Expose fan speed and oscillation as a standalone Fan tile (stays visible when the accessory is grouped into a single tile) |
-| `showDryMode` | boolean | `false` | Show Dry mode switch |
-| `showFanOnlyMode` | boolean | `false` | Show Fan Only mode switch |
 | `showFirmwareUpdateSwitch` | boolean | `false` | Show a Firmware Update switch that installs staged gateway firmware updates (never enabled implicitly by `showExtraFeatures`) |
 
+All feature switches only appear if the device supports the feature.
+
 ## API Rate Limits
 
 | Mode | Daily Limit | Recommended Polling |
@@ -165,10 +170,14 @@ Add the platform to your Homebridge `config.json`:
 | Mobile App | 3000 calls/day | 1-5 minutes |
 
 The plugin manages rate limits by:
-- Polling at configurable intervals
-- Triggering immediate updates after changes
-- Blocking requests when the rate limit is reached
-- Using WebSocket for real-time updates (Mobile App mode)
+- Polling at the configured interval (`updateIntervalInMinutes`)
+- **Stretching polling while the WebSocket is connected**: push updates already deliver changes, so polling drops to a safety-net interval of at least 60 minutes, and the forced refresh after a change from HomeKit is skipped. When the WebSocket disconnects, the configured interval applies again (and a reconnect triggers one catch-up poll)
+- **Backing off on failures**: each consecutive failed poll doubles the interval (up to 4x); polling GETs are not retried on 502/503/504, the next poll is the retry
+- Stretching polling to at least 60 minutes when fewer than 20 calls are left for the day
+- Debouncing refreshes after changes, and coalescing rapid writes to the same setting into one API call
+- Blocking requests when the rate limit is reached (until the `Retry-After` time)
+
+The settings UI is careful with the quota too: it caches the device list for 5 minutes, and the rate-limit display reads the status from the last API response the plugin received (saved to a file in the Homebridge storage directory) instead of making an API call.
 
 ## Fan Speed
 
@@ -200,7 +209,8 @@ rm ~/.homebridge/.daikin-controller-cloud-tokenset
 ### Authentication Flow Issues
 
 - Ensure your redirect URI in the Daikin Developer Portal matches exactly: `https://<callbackServerExternalAddress>:<callbackServerPort>`
-- Try setting `oidcCallbackServerBindAddr` to `0.0.0.0`
+- Set `oidcCallbackServerBindAddr` to `0.0.0.0`; a loopback bind address (`127.0.0.1`) only works when the browser runs on the Homebridge host itself
+- The temporary callback server stops automatically after 10 minutes: if you took longer, start authentication again
 - Check firewall rules for the callback port
 
 ### Device Not Appearing
@@ -218,7 +228,8 @@ rm ~/.homebridge/.daikin-controller-cloud-tokenset
 ### API Gateway Timeout Errors (502, 503, 504)
 
 These errors indicate temporary issues with the Daikin Cloud servers:
-- The plugin automatically retries failed requests up to 3 times with exponential backoff
+- Writes (and one-off reads) are retried up to 3 times with exponential backoff
+- Periodic polls are not retried; instead the poll interval backs off until the API recovers
 - If errors persist, the Daikin API may be experiencing extended downtime
 - Check [Daikin's status page](https://www.daikin.eu/) or try again later
 
@@ -245,9 +256,13 @@ npm run watch
 # Run tests
 npm test
 
+# Run tests with coverage (thresholds in vitest.config.mts, enforced in CI)
+npm run test:coverage
+
 # Check for Daikin API schema drift (fetches live devices, diffs raw vs Zod-parsed,
-# reports any silently-stripped fields). Add --dump-fixtures to also write per-device
-# fixtures to test/fixtures/live/ for offline debugging.
+# reports any silently-stripped fields). Needs real credentials in
+# test/hbConfig/config.json, so it is a manual check and not run in CI.
+# Add --dump-fixtures to also write per-device fixtures to test/fixtures/live/.
 npm run schema:check
 ```
 
@@ -257,16 +272,14 @@ This plugin uses:
 - **TypeScript strict mode** for enhanced type safety
 - **Zod validation** for runtime type checking
 - **ESLint** for code quality enforcement
-- **Jest** with 60%+ test coverage
+- **Vitest** with coverage thresholds enforced in CI (currently ~80% of statements), including the custom UI server
 
 ### Documentation
 
 Comprehensive developer documentation is available in the [`docs/`](docs/) folder:
 
 - **[ARCHITECTURE.md](docs/ARCHITECTURE.md)** - System architecture, component design, data flows, and extension guides
-- **[IMPLEMENTATION_GUIDE.md](docs/IMPLEMENTATION_GUIDE.md)** - Step-by-step implementation guide for improvements
-- **[IMPROVEMENTS_SUMMARY.md](docs/IMPROVEMENTS_SUMMARY.md)** - Summary of recent improvements and progress
-- **[NEXT_STEPS.md](docs/NEXT_STEPS.md)** - Quick-start guide for contributing
+- **[TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)** - Common problems and fixes
 
 For development workflows and coding conventions, see [CLAUDE.md](CLAUDE.md).
 

package/config.schema.json

@@ -22,7 +22,7 @@
         "default": "developer_portal",
         "oneOf": [
           {"title": "Developer Portal (200 API calls/day)", "enum": ["developer_portal"]},
-          {"title": "Mobile App (5000 API calls/day + WebSocket)", "enum": ["mobile_app"]}
+          {"title": "Mobile App (3000 API calls/day + WebSocket)", "enum": ["mobile_app"]}
         ]
       },
       "clientId": {
@@ -68,15 +68,15 @@
       },
       "oidcCallbackServerBindAddr": {
         "title": "Callback Server Bind Address",
-        "description": "Network interface to bind the callback server. Use 127.0.0.1 for local only, or 0.0.0.0 for all interfaces.",
+        "description": "Network interface the temporary OAuth callback server listens on during authentication. The browser you log in with must be able to reach it: use 0.0.0.0 unless that browser runs on the Homebridge host itself, in which case 127.0.0.1 keeps the server off the network.",
         "type": "string",
         "required": false,
-        "default": "127.0.0.1",
-        "enum": ["127.0.0.1", "0.0.0.0"],
+        "default": "0.0.0.0",
+        "enum": ["0.0.0.0", "127.0.0.1"],
         "x-schema-form": {
           "titleMap": {
-            "127.0.0.1": "127.0.0.1 (localhost only - recommended)",
-            "0.0.0.0": "0.0.0.0 (all network interfaces)"
+            "0.0.0.0": "0.0.0.0 (all network interfaces)",
+            "127.0.0.1": "127.0.0.1 (localhost only - browser on the Homebridge host)"
           },
           "condition": "model.authMode !== 'mobile_app'"
         }
@@ -107,12 +107,59 @@
         "default": false,
         "description": "Expose extra features like Streamer, Econo, and Powerful modes as HomeKit switches (only if supported by your device)"
       },
+      "showPowerfulMode": {
+        "title": "Powerful Mode Switch",
+        "type": "boolean",
+        "required": false,
+        "description": "Boost heating/cooling performance (only if supported by your device). When not set, follows 'Show Extra Features'."
+      },
+      "showEconoMode": {
+        "title": "Econo Mode Switch",
+        "type": "boolean",
+        "required": false,
+        "description": "Energy-saving operation (only if supported by your device). When not set, follows 'Show Extra Features'."
+      },
+      "showStreamerMode": {
+        "title": "Streamer Mode Switch",
+        "type": "boolean",
+        "required": false,
+        "description": "Air purification (Streamer) (only if supported by your device). When not set, follows 'Show Extra Features'."
+      },
+      "showOutdoorSilentMode": {
+        "title": "Outdoor Silent Mode Switch",
+        "type": "boolean",
+        "required": false,
+        "description": "Reduce outdoor unit noise (only if supported by your device). When not set, follows 'Show Extra Features'."
+      },
+      "showIndoorSilentMode": {
+        "title": "Indoor Silent Mode Switch",
+        "type": "boolean",
+        "required": false,
+        "description": "Quiet indoor fan operation (only if supported by your device). When not set, follows 'Show Extra Features'."
+      },
+      "showAutoFanMode": {
+        "title": "Auto Fan Mode Switch",
+        "type": "boolean",
+        "required": false,
+        "description": "Automatic fan speed as a switch (only if supported by your device). When not set, follows 'Show Extra Features'."
+      },
+      "showDryMode": {
+        "title": "Dry Mode Switch",
+        "type": "boolean",
+        "required": false,
+        "description": "Dehumidification mode as a switch (only if supported by your device). When not set, follows 'Show Extra Features'."
+      },
+      "showFanOnlyMode": {
+        "title": "Fan Only Mode Switch",
+        "type": "boolean",
+        "required": false,
+        "description": "Fan without heating/cooling as a switch (only if supported by your device). When not set, follows 'Show Extra Features'."
+      },
       "showOscillationSwitch": {
         "title": "Show Oscillation Switch",
         "type": "boolean",
         "required": false,
-        "default": false,
-        "description": "Expose fan oscillation (swing) as a separate HomeKit switch. Useful because the built-in swing control disappears when the accessory is grouped into a single tile in the Home app."
+        "description": "Expose fan oscillation (swing) as a separate HomeKit switch. Useful because the built-in swing control disappears when the accessory is grouped into a single tile in the Home app. When not set, follows 'Show Extra Features'."
       },
       "showSeparateFanControl": {
         "title": "Show Separate Fan Tile",
@@ -125,8 +172,7 @@
         "title": "Show Holiday Mode Switch",
         "type": "boolean",
         "required": false,
-        "default": false,
-        "description": "Expose holiday (away) mode as a separate HomeKit switch (only if supported by your device). Turn it on to put the unit into holiday mode and off to resume normal operation."
+        "description": "Expose holiday (away) mode as a separate HomeKit switch (only if supported by your device). Turn it on to put the unit into holiday mode and off to resume normal operation. When not set, follows 'Show Extra Features'."
       },
       "showFirmwareUpdateSwitch": {
         "title": "Show Firmware Update Switch",
@@ -164,7 +210,7 @@
         "default": 15,
         "minimum": 1,
         "maximum": 60,
-        "description": "How often to poll the Daikin API. Developer Portal: 15+ min recommended (200 calls/day limit). Mobile App: 1-5 min recommended (5000 calls/day)."
+        "description": "How often to poll the Daikin API. Developer Portal: 15+ min recommended (200 calls/day limit). Mobile App: 1-5 min recommended (3000 calls/day)."
       },
       "forceUpdateDelay": {
         "title": "Force Update Delay (ms)",
@@ -196,7 +242,7 @@
     {
       "type": "fieldset",
       "title": "Mobile App Authentication",
-      "description": "Use your Daikin Onecta account credentials (same as the mobile app). Benefits: 5000 API calls/day + real-time WebSocket updates.",
+      "description": "Use your Daikin Onecta account credentials (same as the mobile app). Benefits: 3000 API calls/day + real-time WebSocket updates.",
       "expandable": false,
       "condition": "model.authMode === 'mobile_app'",
       "items": [
@@ -236,6 +282,14 @@
       "expanded": false,
       "items": [
         "showExtraFeatures",
+        "showPowerfulMode",
+        "showEconoMode",
+        "showStreamerMode",
+        "showOutdoorSilentMode",
+        "showIndoorSilentMode",
+        "showAutoFanMode",
+        "showDryMode",
+        "showFanOnlyMode",
         "showOscillationSwitch",
         "showSeparateFanControl",
         "showHolidayMode",

package/dist/src/accessories/air-conditioning-accessory.js

@@ -12,7 +12,7 @@ class AirConditioningAccessory extends base_accessory_1.BaseAccessory {
             throw new Error('No climate control management point found');
         }
         this.service = new services_1.ClimateControlService(this.platform, this.accessory, climateControlEmbeddedId);
-        this.logCapabilities(climateControlEmbeddedId);
+        this.logCapabilities(this.service.featureManager.capabilities);
         // Push current device state into HomeKit immediately. At startup the device
         // is freshly built from getCloudDevices() which does not emit 'updated', so
         // without this the full refresh only runs on the first poll/WebSocket event -

package/dist/src/accessories/air-conditioning-accessory.js.map

@@ -1 +1 @@
-{"version":3,"file":"air-conditioning-accessory.js","sourceRoot":"","sources":["../../../src/accessories/air-conditioning-accessory.ts"],"names":[],"mappings":";;;AAEA,qDAAiD;AACjD,0CAAoD;AAEpD,MAAa,wBAAyB,SAAQ,8BAAa;IACzD,OAAO,CAAwB;IAE/B,YACE,QAA6B,EAC7B,SAAyD;QAEzD,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC3B,MAAM,wBAAwB,GAAG,IAAI,CAAC,kCAAkC,CAAC,gBAAgB,CAAC,CAAC;QAE3F,IAAI,wBAAwB,KAAK,IAAI,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,gCAAqB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;QAClG,IAAI,CAAC,eAAe,CAAC,wBAAwB,CAAC,CAAC;QAE/C,4EAA4E;QAC5E,4EAA4E;QAC5E,8EAA8E;QAC9E,wEAAwE;QACxE,2CAA2C;QAC3C,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAEkB,aAAa;QAC9B,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IAC/B,CAAC;CACF;AA5BD,4DA4BC"}
+{"version":3,"file":"air-conditioning-accessory.js","sourceRoot":"","sources":["../../../src/accessories/air-conditioning-accessory.ts"],"names":[],"mappings":";;;AAEA,qDAAiD;AACjD,0CAAoD;AAEpD,MAAa,wBAAyB,SAAQ,8BAAa;IACzD,OAAO,CAAwB;IAE/B,YACE,QAA6B,EAC7B,SAAyD;QAEzD,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC3B,MAAM,wBAAwB,GAAG,IAAI,CAAC,kCAAkC,CAAC,gBAAgB,CAAC,CAAC;QAE3F,IAAI,wBAAwB,KAAK,IAAI,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,gCAAqB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;QAClG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QAE/D,4EAA4E;QAC5E,4EAA4E;QAC5E,8EAA8E;QAC9E,wEAAwE;QACxE,2CAA2C;QAC3C,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAEkB,aAAa;QAC9B,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IAC/B,CAAC;CACF;AA5BD,4DA4BC"}

package/dist/src/accessories/altherma-accessory.js

@@ -14,7 +14,7 @@ class AlthermaAccessory extends base_accessory_1.BaseAccessory {
         const domesticHotWaterTankEmbeddedId = this.getEmbeddedIdByManagementPointType('domesticHotWaterTank');
         if (climateControlEmbeddedId !== null) {
             this.service = new services_1.ClimateControlService(this.platform, this.accessory, climateControlEmbeddedId);
-            this.logCapabilities(climateControlEmbeddedId);
+            this.logCapabilities(this.service.featureManager.capabilities);
         }
         else {
             this.platform.log.warn(`[${this.name}] No climate control management point found`);

package/dist/src/accessories/altherma-accessory.js.map

@@ -1 +1 @@
-{"version":3,"file":"altherma-accessory.js","sourceRoot":"","sources":["../../../src/accessories/altherma-accessory.ts"],"names":[],"mappings":";;;AAEA,qDAAiD;AACjD,0CAAyE;AAEzE,MAAa,iBAAkB,SAAQ,8BAAa;IACjC,IAAI,CAAS;IAC9B,OAAO,CAAyB;IAChC,mBAAmB,CAAuB;IAE1C,YACE,QAA6B,EAC7B,SAAyD;QAEzD,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAE3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;QAEvC,MAAM,wBAAwB,GAAG,IAAI,CAAC,kCAAkC,CAAC,gBAAgB,CAAC,CAAC;QAC3F,MAAM,8BAA8B,GAAG,IAAI,CAAC,kCAAkC,CAAC,sBAAsB,CAAC,CAAC;QAEvG,IAAI,wBAAwB,KAAK,IAAI,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO,GAAG,IAAI,gCAAqB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;YAClG,IAAI,CAAC,eAAe,CAAC,wBAAwB,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,6CAA6C,CAAC,CAAC;QACrF,CAAC;QAED,IAAI,8BAA8B,KAAK,IAAI,EAAE,CAAC;YAC5C,IAAI,CAAC,mBAAmB,GAAG,IAAI,8BAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,8BAA8B,CAAC,CAAC;QACpH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,qDAAqD,CAAC,CAAC;QAC7F,CAAC;QAED,4EAA4E;QAC5E,4EAA4E;QAC5E,8EAA8E;QAC9E,yEAAyE;QACzE,oCAAoC;QACpC,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAEkB,aAAa;QAC9B,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,CAAC;QAC9B,IAAI,CAAC,mBAAmB,EAAE,aAAa,EAAE,CAAC;IAC5C,CAAC;CACF;AAzCD,8CAyCC"}
+{"version":3,"file":"altherma-accessory.js","sourceRoot":"","sources":["../../../src/accessories/altherma-accessory.ts"],"names":[],"mappings":";;;AAEA,qDAAiD;AACjD,0CAAyE;AAEzE,MAAa,iBAAkB,SAAQ,8BAAa;IACjC,IAAI,CAAS;IAC9B,OAAO,CAAyB;IAChC,mBAAmB,CAAuB;IAE1C,YACE,QAA6B,EAC7B,SAAyD;QAEzD,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAE3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;QAEvC,MAAM,wBAAwB,GAAG,IAAI,CAAC,kCAAkC,CAAC,gBAAgB,CAAC,CAAC;QAC3F,MAAM,8BAA8B,GAAG,IAAI,CAAC,kCAAkC,CAAC,sBAAsB,CAAC,CAAC;QAEvG,IAAI,wBAAwB,KAAK,IAAI,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO,GAAG,IAAI,gCAAqB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;YAClG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,6CAA6C,CAAC,CAAC;QACrF,CAAC;QAED,IAAI,8BAA8B,KAAK,IAAI,EAAE,CAAC;YAC5C,IAAI,CAAC,mBAAmB,GAAG,IAAI,8BAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,8BAA8B,CAAC,CAAC;QACpH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,qDAAqD,CAAC,CAAC;QAC7F,CAAC;QAED,4EAA4E;QAC5E,4EAA4E;QAC5E,8EAA8E;QAC9E,yEAAyE;QACzE,oCAAoC;QACpC,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAEkB,aAAa;QAC9B,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,CAAC;QAC9B,IAAI,CAAC,mBAAmB,EAAE,aAAa,EAAE,CAAC;IAC5C,CAAC;CACF;AAzCD,8CAyCC"}

package/dist/src/accessories/base-accessory.d.ts

@@ -1,5 +1,6 @@
 import type { PlatformAccessory } from 'homebridge';
 import type { DaikinCloudAccessoryContext, DaikinCloudPlatform } from '../platform';
+import type { DeviceCapabilities } from '../types';
 export declare class BaseAccessory {
     readonly platform: DaikinCloudPlatform;
     readonly accessory: PlatformAccessory<DaikinCloudAccessoryContext>;
@@ -13,10 +14,10 @@ export declare class BaseAccessory {
     protected refreshValues(): void;
     private printDeviceInfo;
     /**
-       * Log device capabilities for the given management point.
-       * Call this from subclasses after determining the management point ID.
-       */
-    protected logCapabilities(managementPointId: string): void;
+     * Log the capabilities detected for a management point (the same detection
+     * result its FeatureManager uses to decide which feature switches to expose).
+     */
+    protected logCapabilities(capabilities: DeviceCapabilities): void;
     getEmbeddedIdByManagementPointType(managementPointType: string): string | null;
 }
 //# sourceMappingURL=base-accessory.d.ts.map

package/dist/src/accessories/base-accessory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-accessory.d.ts","sourceRoot":"","sources":["../../../src/accessories/base-accessory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGpF,qBAAa,aAAa;IACxB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC,2BAA2B,CAAC,CAAC;IACnE,SAAgB,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEtD,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAE,iBAAiB,CAAC,2BAA2B,CAAC;IAyC3D;;;;OAIG;IACH,SAAS,CAAC,aAAa,IAAI,IAAI;IAI/B,OAAO,CAAC,eAAe;IAcvB;;;SAGK;IACL,SAAS,CAAC,eAAe,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAY1D,kCAAkC,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAgB/E"}
+{"version":3,"file":"base-accessory.d.ts","sourceRoot":"","sources":["../../../src/accessories/base-accessory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGnD,qBAAa,aAAa;IACxB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC,2BAA2B,CAAC,CAAC;IACnE,SAAgB,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEtD,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAE,iBAAiB,CAAC,2BAA2B,CAAC;IA2C3D;;;;OAIG;IACH,SAAS,CAAC,aAAa,IAAI,IAAI;IAI/B,OAAO,CAAC,eAAe;IAcvB;;;OAGG;IACH,SAAS,CAAC,eAAe,CAAC,YAAY,EAAE,kBAAkB,GAAG,IAAI;IAKjE,kCAAkC,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAgB/E"}

package/dist/src/accessories/base-accessory.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseAccessory = void 0;
-const device_1 = require("../device");
+const capability_docs_1 = require("../device/capability-docs");
 class BaseAccessory {
     platform;
     accessory;
@@ -23,7 +23,9 @@ class BaseAccessory {
             : null;
         // Daikin reports versions like '4_0_3'; HomeKit expects dotted revisions
         const firmwareVersion = firmwareData?.value?.replace(/_/g, '.');
-        this.accessory.getService(this.platform.Service.AccessoryInformation)
+        const informationService = this.accessory.getService(this.platform.Service.AccessoryInformation)
+            ?? this.accessory.addService(this.platform.Service.AccessoryInformation);
+        informationService
             .setCharacteristic(this.platform.Characteristic.Manufacturer, 'Daikin')
             .setCharacteristic(this.platform.Characteristic.Model, modelInfo)
             .setCharacteristic(this.platform.Characteristic.SerialNumber, serialNumber)
@@ -60,14 +62,11 @@ class BaseAccessory {
         this.platform.log.debug('[Platform]     HAP UUID: ' + this.accessory.UUID);
     }
     /**
-       * Log device capabilities for the given management point.
-       * Call this from subclasses after determining the management point ID.
-       */
-    logCapabilities(managementPointId) {
-        const detector = new device_1.DeviceCapabilityDetector(this.accessory.context.device, managementPointId);
-        const capabilities = detector.getCapabilities();
-        const summary = (0, device_1.getCapabilitySummary)(capabilities);
-        this.platform.log.info(`[Platform]     capabilities: ${summary}`);
+     * Log the capabilities detected for a management point (the same detection
+     * result its FeatureManager uses to decide which feature switches to expose).
+     */
+    logCapabilities(capabilities) {
+        this.platform.log.info(`[Platform]     capabilities: ${(0, capability_docs_1.getCapabilitySummary)(capabilities)}`);
         this.platform.log.debug(`[Platform]     operation modes: ${capabilities.supportedOperationModes.join(', ')}`);
     }
     getEmbeddedIdByManagementPointType(managementPointType) {

package/dist/src/accessories/base-accessory.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-accessory.js","sourceRoot":"","sources":["../../../src/accessories/base-accessory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-accessory.js","sourceRoot":"","sources":["../../../src/accessories/base-accessory.ts"],"names":[],"mappings":"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"}

package/dist/src/api/daikin-api.d.ts

@@ -4,6 +4,15 @@
  * Handles REST API calls to the Daikin Cloud.
  */
 import type { RateLimitStatus, GatewayDevice, OAuthProvider } from './daikin-types';
+/** Options for a single API request */
+interface RequestOptions {
+    /**
+     * Retry on 502/503/504 with exponential backoff. Defaults to true for
+     * writes (a dropped write would otherwise be lost) and false for GETs
+     * (the next poll is the retry, so retrying only burns the daily quota).
+     */
+    retryGatewayErrors?: boolean;
+}
 export declare class RateLimitedError extends Error {
     readonly retryAfter: number;
     constructor(message: string, retryAfter: number);
@@ -19,6 +28,7 @@ export declare class DaikinApi {
     private blockedUntil;
     private refreshPromise;
     private writeQueues;
+    private pendingWrites;
     constructor(oauth: OAuthProvider, onRateLimitStatus?: ((status: RateLimitStatus) => void) | undefined);
     /**
        * Make a static GET request with access token (for UI)
@@ -31,9 +41,13 @@ export declare class DaikinApi {
     private static parseHeaderStatic;
     private static makeStaticRequest;
     /**
-       * Get all gateway devices with runtime validation
+       * Get all gateway devices with runtime validation.
+       *
+       * Gateway errors (5xx) are not retried by default: for periodic polling the
+       * next poll is the retry. Pass `retryGatewayErrors: true` for one-off reads
+       * (e.g. initial discovery) where a transient failure would be costly.
        */
-    getDevices(): Promise<GatewayDevice[]>;
+    getDevices(options?: RequestOptions): Promise<GatewayDevice[]>;
     /**
        * Update device data (PATCH request)
        *
@@ -74,6 +88,11 @@ export declare class DaikinApi {
        * @param firmwareId - The staged update's id from firmwareUpdate.value.id
        */
     triggerFirmwareUpdate(deviceId: string, embeddedId: string, firmwareId: string): Promise<void>;
+    /**
+     * Base path of a management point. IDs come from cloud responses and are
+     * encoded so a '/' or '?' in them cannot change which endpoint is hit.
+     */
+    private managementPointPath;
     /**
      * Serializes write requests per device through a queue with a fixed inter-request delay.
      * Each device has its own queue so writes for different devices run in parallel,
@@ -92,10 +111,6 @@ export declare class DaikinApi {
        * Calculate delay for exponential backoff with jitter
        */
     private getRetryDelay;
-    /**
-       * Sleep for a specified duration
-       */
-    private sleep;
     /**
        * Get human-readable name for gateway error status codes
        */
@@ -112,4 +127,5 @@ export declare class DaikinApi {
     private parseHeader;
     private makeRequest;
 }
+export {};
 //# sourceMappingURL=daikin-api.d.ts.map

package/dist/src/api/daikin-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daikin-api.d.ts","sourceRoot":"","sources":["../../../src/api/daikin-api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAepF,qBAAa,gBAAiB,SAAQ,KAAK;aAGnB,UAAU,EAAE,MAAM;gBADtC,OAAO,EAAE,MAAM,EACK,UAAU,EAAE,MAAM;CAKzC;AAED,qBAAa,eAAgB,SAAQ,KAAK;aAGlB,UAAU,EAAE,MAAM;aAClB,YAAY,EAAE,MAAM;gBAFxC,OAAO,EAAE,MAAM,EACK,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM;CAK3C;AAED,qBAAa,SAAS;IAQd,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IARzC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,cAAc,CAA8B;IAGpD,OAAO,CAAC,WAAW,CAA4C;gBAGxC,KAAK,EAAE,aAAa,EACpB,iBAAiB,CAAC,GAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,aAAA;IAO5E;;SAEK;WACQ,aAAa,CACxB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;QAAC,SAAS,EAAE,eAAe,CAAA;KAAE,CAAC;IA6BjH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAShC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAiBhC;;SAEK;IACC,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAK5C;;;;;;;;SAQK;IACC,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IAMhB;;;;;;;;;;;SAWK;IACC,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/D,OAAO,CAAC,IAAI,CAAC;IAKhB;;;;;;;;;;;SAWK;IACC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpG;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;SAEK;IACL,aAAa,IAAI,OAAO;IAIxB;;SAEK;IACL,sBAAsB,IAAI,MAAM;IAIhC;;SAEK;IACL,OAAO,CAAC,aAAa;IAMrB;;SAEK;IACL,OAAO,CAAC,KAAK;IAIb;;SAEK;IACL,OAAO,CAAC,mBAAmB;IAa3B;;SAEK;IACL,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,mBAAmB;IAQ3B;;SAEK;YACS,OAAO;IA8GrB,OAAO,CAAC,WAAW;YASL,WAAW;CAgB1B"}
+{"version":3,"file":"daikin-api.d.ts","sourceRoot":"","sources":["../../../src/api/daikin-api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAgBpF,uCAAuC;AACvC,UAAU,cAAc;IACtB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAQD,qBAAa,gBAAiB,SAAQ,KAAK;aAGnB,UAAU,EAAE,MAAM;gBADtC,OAAO,EAAE,MAAM,EACK,UAAU,EAAE,MAAM;CAKzC;AAED,qBAAa,eAAgB,SAAQ,KAAK;aAGlB,UAAU,EAAE,MAAM;aAClB,YAAY,EAAE,MAAM;gBAFxC,OAAO,EAAE,MAAM,EACK,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM;CAK3C;AAED,qBAAa,SAAS;IAWd,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAXzC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,cAAc,CAA8B;IAGpD,OAAO,CAAC,WAAW,CAA4C;IAG/D,OAAO,CAAC,aAAa,CAAwC;gBAGtC,KAAK,EAAE,aAAa,EACpB,iBAAiB,CAAC,GAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,aAAA;IAO5E;;SAEK;WACQ,aAAa,CACxB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;QAAC,SAAS,EAAE,eAAe,CAAA;KAAE,CAAC;IA6BjH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAShC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAiBhC;;;;;;SAMK;IACC,UAAU,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAKxE;;;;;;;;SAQK;IACC,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IAuBhB;;;;;;;;;;;SAWK;IACC,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/D,OAAO,CAAC,IAAI,CAAC;IAKhB;;;;;;;;;;;SAWK;IACC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpG;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;SAEK;IACL,aAAa,IAAI,OAAO;IAIxB;;SAEK;IACL,sBAAsB,IAAI,MAAM;IAIhC;;SAEK;IACL,OAAO,CAAC,aAAa;IAMrB;;SAEK;IACL,OAAO,CAAC,mBAAmB;IAa3B;;SAEK;IACL,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,mBAAmB;IAQ3B;;SAEK;YACS,OAAO;IAiHrB,OAAO,CAAC,WAAW;YASL,WAAW;CAgB1B"}