homebridge-tsvesync 1.4.7 → 1.4.9

package/AGENTS.md

@@ -0,0 +1,31 @@
+# Homebridge TSVeSync Agent Guide
+
+## Overview
+- `homebridge-tsvesync` is the Homebridge/HomeKit layer on top of `tsvesync`.
+- Source of truth is `src/`; `dist/` is generated output and should not be edited directly.
+- Device capability changes should usually be validated in `tsvesync` first, then surfaced here through accessory/service mapping.
+
+## Where To Look
+- `package.json`: plugin metadata, version, scripts
+- `src/platform.ts`: platform lifecycle and accessory registration
+- `src/accessories/*.ts`: HomeKit service/characteristic mappings
+- `src/utils/device-factory.ts`: model-to-accessory routing
+- `src/types/*.ts`: device and library typing glue
+- `src/settings.ts`: plugin configuration
+- `src/__tests__/**`: Jest coverage for platform, accessories, and device behaviors
+
+## Working Rules
+- Never edit `dist/` by hand.
+- Keep package version aligned with `tsvesync`.
+- If a feature does not exist correctly in `tsvesync`, fix or model it there before papering over it in Homebridge.
+- HomeKit responsiveness matters: characteristic updates, service choice, and accessory categories should match Home app behavior, not just compile.
+- When adding a new feature or device, update the accessory mapping, device factory, types, and tests together.
+
+## Validation
+- Run `npm run build`.
+- Run `npm test` for behavior changes.
+- For HomeKit-specific issues, inspect the exact accessory/service mapping and use targeted tests rather than broad guesswork.
+
+## Release Notes
+- This repo normally ships with `tsvesync` on the same version.
+- Coordinate changelog and release prep across both repos.

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 1.4.9 (2026-03-30)
+
+### Fixed
+- **💧 Dual 200S Mode, Mist, and Humidity Control**: Corrected HomeKit target-state mapping for Dual 200S / LUH-D301S humidifiers, constrained mist control to the two supported levels, and switches to manual mode before applying mist-speed changes so Home commands match actual device behavior.
+- **🎯 Humidity Slider Stability**: Prevented target-humidity snap-back by keeping the commanded humidity in memory, updating the humidity field the getter actually reads, and syncing `Active` immediately when humidity changes power the unit on.
+- **🕒 Stale Mode Override Expiry**: Expires the temporary commanded-mode override after 30 seconds so HomeKit stays stable during eventual consistency without masking later mode changes from the VeSync app.
+
+### Changed
+- **🧱 Build Scope**: Excluded test files from the production TypeScript build to avoid type-check failures caused by local/Homebridge test-only type differences.
+
+### Tests
+- **🧪 Dual 200S Regression Coverage**: Expanded humidifier write-consistency coverage around target humidity and stale-response behavior so the plugin-side Dual 200S fixes stay locked in.
+
+### Dependencies
+- **📦 tsvesync**: Updated to 1.4.9 for the Dual 200S humidifier bypass write-method fix.
+
+## 1.4.8 (2026-03-27)
+
+### Fixed
+- **💧 Dual 200S Write Consistency**: Humidifier writes now follow the same optimistic HomeKit update pattern as the air purifier accessory, so successful power and auto-mode commands no longer log false "did not change to desired state/mode" warnings or bounce the Home app back to stale values while VeSync catches up.
+
+### Tests
+- **🧪 Humidifier Regression Coverage**: Added targeted stale-refresh tests for Dual 200S power and auto-mode writes to lock in the eventual-consistency behavior reported in issue #31.
+
+### Dependencies
+- **📦 tsvesync**: Updated to 1.4.8 for version sync (no functional changes).
+
 ## 1.4.7 (2026-02-02)
 
 ### Fixed

package/dist/accessories/humidifier.accessory.d.ts

@@ -5,6 +5,7 @@ import { DeviceCapabilities, VeSyncHumidifier } from '../types/device.types';
 export declare class HumidifierAccessory extends BaseAccessory {
     protected readonly device: VeSyncHumidifier;
     private capabilities;
+    private isHumidDual200S;
     private isHumid200S;
     private isHumid200300S;
     private isHumid1000S;
@@ -12,7 +13,13 @@ export declare class HumidifierAccessory extends BaseAccessory {
     private lightService?;
     private temperatureService?;
     private filterService?;
+    private _lastCommandedMode;
+    private _lastCommandedModeTime;
     constructor(platform: TSVESyncPlatform, accessory: PlatformAccessory, device: VeSyncHumidifier);
+    /**
+     * Detect if the device is a HumidDual200S (or regional variant LUH-D301S)
+     */
+    private detectHumidDual200S;
     /**
      * Detect if the device is a Humid200S
      */
@@ -29,6 +36,20 @@ export declare class HumidifierAccessory extends BaseAccessory {
      * Detect if the device is a Superior6000S
      */
     private detectSuperior6000S;
+    /**
+     * Convert a VeSync mode string to a HomeKit TargetHumidifierDehumidifierState value.
+     *
+     * For Dual200S the mapping is swapped so that VeSync "auto" (which needs a
+     * humidity target) lands on HomeKit state 1 (HUMIDIFIER / "Humidity" in the
+     * Home app) where Apple shows the humidity slider, and VeSync "manual"
+     * (fixed mist, no target) lands on state 0 ("Auto", no slider).
+     */
+    private modeToTargetState;
+    /**
+     * Convert a HomeKit TargetHumidifierDehumidifierState value to a VeSync mode.
+     * Inverse of modeToTargetState.
+     */
+    private targetStateToMode;
     protected setupService(): void;
     /**
      * Set up night light service for devices that support it
@@ -74,6 +95,7 @@ export declare class HumidifierAccessory extends BaseAccessory {
      * Update device states based on the latest details
      */
     protected updateDeviceSpecificStates(details: any): Promise<void>;
+    private applyDeviceStatesToHomeKit;
     protected getDeviceCapabilities(): DeviceCapabilities;
     private getActive;
     private setActive;

package/dist/accessories/humidifier.accessory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"humidifier.accessory.d.ts","sourceRoot":"","sources":["../../src/accessories/humidifier.accessory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,iBAAiB,EAAW,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AA6E7E,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAC5C,OAAO,CAAC,YAAY,CAAqB;IAGzC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,eAAe,CAAU;IAGjC,OAAO,CAAC,YAAY,CAAC,CAAU;IAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAU;IACrC,OAAO,CAAC,aAAa,CAAC,CAAU;gBAG9B,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,gBAAgB;IAsC1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwB3B,SAAS,CAAC,YAAY,IAAI,IAAI;IA2H9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA0B9B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA8B/B;;OAEG;YACW,cAAc;IAW5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmC1B;;OAEG;YACW,yBAAyB;IAYvC;;OAEG;YACW,kBAAkB;IAYhC;;OAEG;YACW,eAAe;IAO7B;;OAEG;YACW,eAAe;IAoB7B;;OAEG;YACW,uBAAuB;IAMrC;;OAEG;YACW,uBAAuB;IAmBrC;;OAEG;cACa,0BAA0B,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IA2PvE,SAAS,CAAC,qBAAqB,IAAI,kBAAkB;YAcvC,SAAS;YA4BT,SAAS;YAuJT,gBAAgB;YAqBhB,cAAc;YA4Jd,sBAAsB;IAmFpC;;OAEG;IACH;;OAEG;YACW,iBAAiB;IAsB/B;;OAEG;YACW,iBAAiB;IAkE/B,OAAO,CAAC,gCAAgC;CAWzC"}
+{"version":3,"file":"humidifier.accessory.d.ts","sourceRoot":"","sources":["../../src/accessories/humidifier.accessory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,iBAAiB,EAAW,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AA8E7E,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAC5C,OAAO,CAAC,YAAY,CAAqB;IAGzC,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,eAAe,CAAU;IAGjC,OAAO,CAAC,YAAY,CAAC,CAAU;IAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAU;IACrC,OAAO,CAAC,aAAa,CAAC,CAAU;IAIhC,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,sBAAsB,CAAa;gBAGzC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,gBAAgB;IAyC1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAOzB,SAAS,CAAC,YAAY,IAAI,IAAI;IAkH9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA0B9B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA8B/B;;OAEG;YACW,cAAc;IAW5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmC1B;;OAEG;YACW,yBAAyB;IAYvC;;OAEG;YACW,kBAAkB;IAYhC;;OAEG;YACW,eAAe;IAO7B;;OAEG;YACW,eAAe;IAoB7B;;OAEG;YACW,uBAAuB;IAMrC;;OAEG;YACW,uBAAuB;IAmBrC;;OAEG;cACa,0BAA0B,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCvE,OAAO,CAAC,0BAA0B;IAgLlC,SAAS,CAAC,qBAAqB,IAAI,kBAAkB;YAcvC,SAAS;YA4BT,SAAS;YAwFT,gBAAgB;YA+BhB,cAAc;YAyFd,sBAAsB;IAkGpC;;OAEG;IACH;;OAEG;YACW,iBAAiB;IAsB/B;;OAEG;YACW,iBAAiB;IA8D/B,OAAO,CAAC,gCAAgC;CAWzC"}