homebridge-tsvesync 1.1.2 → 1.3.4

package/CHANGELOG.md

@@ -1,5 +1,317 @@
 # Changelog
 
+## 1.3.4 (2025-09-18)
+
+### Added
+- **🕹️ ESWD16 Dimming in HomeKit**: ESWD16 dimmer switches now register as HomeKit `Lightbulb` accessories with native On/Off and Brightness control.
+- **🌈 Indicator Ring Control**: Introduced a dedicated "Indicator" light service for the ESWD16 locator ring, including Hue/Saturation control powered by automatic HSV→RGB conversion.
+
+### Improved
+- **🔄 State Synchronization**: On/Off and brightness updates now refresh ESWD16 cloud state immediately, keeping HomeKit characteristics accurate even when VeSync lags.
+- **🛡️ Polling Guardrails**: Background discovery is now serialized and paired with UUID-stable Air Quality accessories, preventing duplicate registrations and overlapping sync loops.
+
+### Dependencies
+- **📦 tsvesync**: Upgraded to 1.3.4 to stay aligned with the latest ESWD16 API surfaces.
+
+## 1.3.3 (2025-01-05)
+
+### Fixed
+- **⏰ Extended Timeout Chain Fix**: Enhanced proactive token refresh system to handle very long-duration tokens
+  - **🔧 Timeout Chaining**: Implemented timeout chaining for refresh delays exceeding Node.js setTimeout maximum (~24.8 days)
+  - **🛡️ Robust Scheduling**: Prevents timer overflow errors with automatic timer chaining for extended token lifetimes
+  - **⚡ Seamless Operation**: Long-duration token refresh scheduling now works reliably without timing limitations
+  - **🎯 Precision Handling**: Maintains accurate refresh timing even for tokens with extended lifetimes
+  - **📊 Enhanced Logging**: Improved logging for chained timer operations and extended refresh scheduling
+
+- **🔄 Session Hydration Compatibility**: Enhanced session recovery with backward compatibility
+  - **🛡️ Fallback Support**: Added backward-compatible session hydration for older tsvesync versions
+  - **⚡ Direct Field Setting**: Automatic fallback to direct field setting when hydrateSession method unavailable
+  - **🔧 Improved Reliability**: Enhanced session recovery across different tsvesync library versions
+  - **📊 Better Error Handling**: Graceful handling of version compatibility during session restoration
+
+### Enhanced
+- **🎯 Timer Management**: Advanced timer management system for extended timeout scenarios
+  - **🔧 MAX_DELAY Handling**: Proper handling of Node.js setTimeout maximum delay limitations (2,147,483,647 ms)
+  - **⚡ Chain Calculation**: Intelligent timer chaining with accurate remaining time calculations
+  - **🛡️ Error Prevention**: Prevents timer overflow errors and ensures reliable long-duration scheduling
+  - **📈 Performance**: Optimized timer chaining with minimal overhead for standard use cases
+
+### Technical Details
+- **🏗️ Timeout Architecture**: Enhanced proactive refresh system with timeout chaining support
+- **📊 Timer Chain Logic**: Automatic detection and handling of timeouts exceeding Node.js limitations
+- **🔧 Compatibility Layer**: Backward-compatible session hydration for various tsvesync versions
+- **⚡ Precision Timing**: Maintains accurate refresh timing regardless of token lifetime duration
+
+### Dependencies
+- **📦 tsvesync**: Updated to 1.3.3 for enhanced cross-project version synchronization
+
+### Summary of All Enhancements from v1.2.0 onwards
+
+#### Session Management & Authentication System (v1.2.0-1.3.3)
+- **💾 Complete Session Persistence**: Sessions survive across Homebridge restarts with enhanced validation
+- **⏰ Advanced Proactive Token Refresh**: Intelligent refresh scheduling with extended timeout support (v1.3.0-1.3.3)
+- **🔐 Enhanced Security**: Username validation and account isolation for multi-user environments
+- **📊 JWT Token Mastery**: Complete lifecycle management with normalized timestamp handling
+- **🛡️ Secure Storage**: Protected session storage with comprehensive validation and recovery
+- **🚀 Performance Optimization**: Reduced authentication overhead with intelligent session reuse
+- **🔄 Cross-Region Support**: Enhanced compatibility with different VeSync regional endpoints
+- **🎯 Extended Timeout Handling**: Reliable scheduling for very long-duration token refresh scenarios (NEW in 1.3.3)
+
+#### Speed Control & HomeKit Integration (v1.2.0-1.3.1)
+- **🎛️ Advanced Speed Control**: Dynamic support for 3-4+ speed air purifiers with model-specific logic
+- **🌙 Intelligent Sleep Mode**: Sleep mode integration as first notch on HomeKit slider
+- **🎯 Precision Mapping**: Accurate percentage-to-speed conversions for different device capabilities
+- **📱 Enhanced UX**: Improved slider positions, speed transitions, and HomeKit responsiveness
+- **🔄 Smart Notch System**: Automatic adjustment based on device capabilities and speed ranges
+
+Full changelog: https://github.com/mickgiles/homebridge-tsvesync/blob/main/CHANGELOG.md
+
+## 1.3.2 (2025-01-05)
+
+### Enhanced
+- **🔐 Advanced Session Management**: Comprehensive improvements to session persistence and authentication reliability
+  - **👤 Enhanced Username Validation**: Session reuse now validates username to prevent cross-account authentication conflicts
+  - **🔒 Improved Account Isolation**: Persisted sessions are properly isolated and validated against configured accounts
+  - **💾 Optimized Session Persistence**: Best-effort session saving immediately after successful authentication
+  - **📝 Detailed Session Logging**: Comprehensive debug logging for session save/load operations with expiration tracking
+  - **🛡️ Robust Error Handling**: Enhanced error messages and recovery flows for session hydration failures
+
+- **🔧 JWT Timestamp Precision Handling**: Enhanced token timestamp processing for consistent authentication
+  - **📊 Timestamp Normalization**: Automatic detection and conversion of millisecond timestamps to seconds
+  - **⚡ Improved Token Validation**: Ensures accurate token expiration calculations across different token formats
+  - **🔄 Cross-Region Compatibility**: Better handling of JWT tokens from different VeSync regional endpoints
+  - **🛡️ Edge Case Prevention**: Fixes authentication issues with tokens using inconsistent timestamp precision
+
+### Fixed
+- **🎛️ Session Hydration Reliability**: Improved session recovery and validation processes
+  - **🔍 Better Error Detection**: Enhanced detection of invalid or corrupted session data
+  - **📈 Startup Performance**: Optimized authentication flow to reduce unnecessary login attempts
+  - **⚡ Token Lifecycle Management**: Better coordination with tsvesync library's token refresh mechanisms
+  - **🛡️ Authentication Stability**: Reduced authentication interruptions during long-running sessions
+
+### Technical Details
+- **🏗️ Session Architecture**: Enhanced session store with improved persistence and validation logic
+- **📊 Token Management**: Advanced JWT token handling with normalized timestamp precision
+- **🔧 Error Handling**: Comprehensive error recovery flows with detailed logging and debugging
+- **⚡ Performance**: Optimized session operations for better startup performance and reliability
+
+### Dependencies
+- **📦 tsvesync**: Updated to 1.3.2 for enhanced JWT timestamp handling and session management improvements
+
+### Summary of All Enhancements from v1.2.0 onwards
+
+#### Session Management & Authentication System (v1.2.0-1.3.2)
+- **💾 Complete Session Persistence**: Sessions survive across Homebridge restarts with enhanced validation
+- **⏰ Advanced Proactive Token Refresh**: Intelligent refresh scheduling prevents JWT expiration (v1.3.0)
+- **🔐 Enhanced Security**: Username validation and account isolation for multi-user environments
+- **📊 JWT Token Mastery**: Complete lifecycle management with normalized timestamp handling
+- **🛡️ Secure Storage**: Protected session storage with comprehensive validation and recovery
+- **🚀 Performance Optimization**: Reduced authentication overhead with intelligent session reuse
+- **🔄 Cross-Region Support**: Enhanced compatibility with different VeSync regional endpoints
+
+#### Speed Control & HomeKit Integration (v1.2.0-1.3.1)
+- **🎛️ Advanced Speed Control**: Dynamic support for 3-4+ speed air purifiers with model-specific logic
+- **🌙 Intelligent Sleep Mode**: Sleep mode integration as first notch on HomeKit slider
+- **🎯 Precision Mapping**: Accurate percentage-to-speed conversions for different device capabilities
+- **📱 Enhanced UX**: Improved slider positions, speed transitions, and HomeKit responsiveness
+- **🔄 Smart Notch System**: Automatic adjustment based on device capabilities and speed ranges
+
+Full changelog: https://github.com/mickgiles/homebridge-tsvesync/blob/main/CHANGELOG.md
+
+## 1.3.1 (2025-09-04)
+
+### Fixed
+- **🔐 Enhanced Session Management**: Improved session persistence and authentication flow
+  - **👤 Username Validation**: Session reuse now validates username to prevent cross-account conflicts
+  - **🔒 Account Isolation**: Persisted sessions are ignored if they belong to a different configured account
+  - **⚡ Optimized Login Flow**: Authentication only occurs when necessary, relying on persisted tokens and library re-login
+  - **🛡️ Session Security**: Enhanced session storage with username tracking for better account management
+
+- **🎛️ Core 200S Speed Control Improvements**: Enhanced air purifier speed control for Core 200S devices
+  - **🎯 Model-Specific Logic**: Core 200S now uses dedicated speed calculation method with proper 25% steps
+  - **📊 Accurate Mapping**: Improved speed-to-percentage conversion for devices with 3 manual speeds
+  - **🌙 Sleep Mode Integration**: Better sleep mode handling with model-specific speed ranges
+  - **🔄 Precise Notch Calculation**: Enhanced notch-to-speed mapping for more accurate HomeKit control
+
+### Enhanced
+- **📝 Improved Logging**: Better debugging information for mode changes and device operations
+  - **🔍 Mode Change Tracking**: Enhanced logging for manual, auto, and sleep mode transitions
+  - **🎛️ Speed Control Logging**: More detailed logging for speed changes and slider operations
+  - **📱 HomeKit Integration**: Better visibility into device state changes and characteristic updates
+
+### Changed
+- **🔄 Authentication Strategy**: Optimized authentication flow to reduce unnecessary login attempts
+  - **💾 Token Persistence**: Improved reliance on persisted tokens with library-managed re-authentication
+  - **⚡ Startup Performance**: Faster platform initialization by avoiding redundant login checks
+  - **🎯 Smart Re-login**: Authentication only triggered when API returns 401/419 status codes
+
+### Technical Details
+- **🏗️ Session Architecture**: Enhanced session store with username tracking and validation
+- **🎛️ Speed Control Algorithm**: Model-specific speed calculation methods for different device types
+- **🔧 Authentication Flow**: Streamlined login logic with better token lifecycle management
+- **📊 Core 200S Support**: Dedicated isCore200S() method for model-specific functionality
+
+### Dependencies
+- **📦 tsvesync**: Updated to 1.3.1 for enhanced token expiration detection and authentication improvements
+
+## 1.3.0 (2025-09-04)
+
+### Added
+- **⏰ Enhanced Proactive Token Refresh**: Advanced JWT token refresh system with intelligent scheduling
+  - **🎯 Smart Scheduling Policy**: Dynamic refresh timing based on token lifetime:
+    - >7 days remaining: refresh 5 days before expiry
+    - 1-7 days remaining: refresh 12 hours before expiry
+    - 1-24 hours remaining: refresh 1 hour before expiry
+    - <1 hour remaining: rely on 401-triggered re-login to prevent thrashing
+  - **📊 Accurate Lifetime Tracking**: Uses actual token issuance time (iat) for precise calculations
+  - **🛡️ Duplicate Prevention**: Guards against multiple timers for same token expiration
+  - **🔄 State Management**: Concurrent refresh protection with in-progress tracking
+  - **🧹 Clean Shutdown**: Proper timer cleanup on platform shutdown
+  - **⚡ Background Operation**: Seamless token refresh without service interruption
+
+- **🔧 Advanced Session Management**: Enhanced integration with tsvesync v1.3.0
+  - **🔔 Token Change Integration**: Full utilization of tsvesync's onTokenChange callback system
+  - **📈 Reliability**: Eliminates VeSync connectivity interruptions from expired tokens
+  - **🎯 Optimal Timing**: Intelligent buffer calculation prevents both premature and late refreshes
+  - **⏰ Safety Floor**: Never schedules refresh less than 30 minutes from current time
+
+### Enhanced
+- **🔐 Session Persistence**: Improved session management with proactive refresh integration
+  - **💾 Complete Session Recovery**: Sessions survive across Homebridge restarts with enhanced refresh
+  - **📊 JWT Integration**: Advanced token lifecycle management with expiration tracking
+  - **🛡️ Secure Storage**: Protected session storage in tsvesync subdirectory
+  - **🚀 Faster Startup**: Reduced authentication overhead via intelligent session reuse
+  - **🔄 Seamless Recovery**: Automatic fallback when persisted sessions are invalid
+
+### Changed
+- **📚 Dependency Update**: Updated tsvesync dependency to 1.3.0 for enhanced session management
+- **📝 Documentation**: Comprehensive release notes including all enhancements from 1.2.0 onwards
+- **⚡ Performance**: Optimized token refresh logic for better performance and reliability
+
+### Technical Details
+- **🔧 Advanced Token Lifecycle**: Proactive refresh ensures tokens never expire during operation
+- **🎯 Progressive Buffer Strategy**: Smart refresh timing based on token lifetime for optimal reliability
+- **📈 Enhanced Error Handling**: Comprehensive try/finally blocks for robust operation
+- **🔄 State Coordination**: Prevents concurrent refresh operations with proper synchronization
+- **🛡️ Authentication Stability**: Eliminates authentication interruptions during long-running sessions
+
+### Summary of All Features from v1.2.0 onwards
+
+#### Session Management & Authentication (v1.2.0-1.3.0)
+- **💾 Complete Session Persistence**: Sessions survive across Homebridge restarts
+- **⏰ Enhanced Proactive Token Refresh**: Advanced refresh before JWT expiration (NEW in 1.3.0)
+- **🔐 Automatic Recovery**: Seamless fallback when persisted sessions are invalid
+- **📊 JWT Integration**: Full token lifecycle management with expiration tracking
+- **🛡️ Secure Storage**: Protected session storage in tsvesync subdirectory
+- **🚀 Faster Startup**: Reduced authentication overhead via session reuse
+
+#### Speed Control & HomeKit Integration (v1.2.0)
+- **🎛️ Advanced Speed Control**: Dynamic support for 3-4+ speed air purifiers
+- **🌙 Sleep Mode Integration**: Sleep mode as first notch on HomeKit slider
+- **🎯 Precision Mapping**: Accurate percentage-to-speed conversions
+- **📱 Enhanced UX**: Improved slider positions and speed transitions
+- **🔄 Smart Notch System**: Automatic adjustment based on device capabilities
+
+Full changelog: https://github.com/mickgiles/homebridge-tsvesync/blob/main/CHANGELOG.md
+
+## 1.2.2 (2025-09-04)
+
+### Added
+- **⏰ Proactive Token Refresh**: Intelligent JWT token refresh before expiration
+  - **🔄 Smart Scheduling**: Automatically schedules token refresh before JWT expiry
+  - **📊 Accurate Lifetime Tracking**: Uses actual token issuance time (iat) for precise calculations
+  - **🎯 Dynamic Buffer Calculation**: Refresh buffer is earlier of 5 days or 10% of token lifetime
+  - **🔔 Token Change Integration**: Leverages tsvesync's onTokenChange callback system
+  - **🧹 Clean Shutdown**: Properly clears refresh timer on platform shutdown
+  - **🛡️ Uninterrupted Service**: Prevents authentication failures during long-running sessions
+
+### Changed
+- **📚 Dependency Update**: Updated tsvesync dependency to 1.2.2
+- **📝 Documentation**: Comprehensive release notes including all changes from 1.2.0 onwards
+
+### Technical Details
+- **🔧 Token Lifecycle**: Proactive refresh ensures tokens never expire during operation
+- **📈 Reliability**: Eliminates VeSync connectivity interruptions from expired tokens
+- **🎯 Buffer Strategy**: Minimum 1 day, maximum 5 days refresh buffer for optimal timing
+- **⚡ Background Operation**: Token refresh happens seamlessly without service interruption
+
+### Summary of All Features from v1.2.0 onwards
+
+#### Session Management & Authentication (v1.2.0-1.2.2)
+- **💾 Complete Session Persistence**: Sessions survive across Homebridge restarts
+- **⏰ Proactive Token Refresh**: Automatic refresh before JWT expiration (NEW in 1.2.2)
+- **🔐 Automatic Recovery**: Seamless fallback when persisted sessions are invalid
+- **📊 JWT Integration**: Full token lifecycle management with expiration tracking
+- **🛡️ Secure Storage**: Protected session storage in tsvesync subdirectory
+- **🚀 Faster Startup**: Reduced authentication overhead via session reuse
+
+#### Speed Control & HomeKit Integration (v1.2.0)
+- **🎛️ Advanced Speed Control**: Dynamic support for 3-4+ speed air purifiers
+- **🌙 Sleep Mode Integration**: Sleep mode as first notch on HomeKit slider
+- **🎯 Precision Mapping**: Accurate percentage-to-speed conversions
+- **📱 Enhanced UX**: Improved slider positions and speed transitions
+- **🔄 Smart Notch System**: Automatic adjustment based on device capabilities
+
+Full changelog: https://github.com/mickgiles/homebridge-tsvesync/blob/main/CHANGELOG.md
+
+## 1.2.1 (2025-09-04)
+
+### Changed
+- **📦 Re-release**: Version 1.2.1 re-release with comprehensive release notes from 1.2.0
+- **📝 Documentation**: Enhanced release documentation and changelog formatting
+- **🔄 Version Alignment**: Synchronized version numbers across tsvesync and homebridge-tsvesync
+- **📚 Dependency Update**: Updated tsvesync dependency to 1.2.1
+
+## 1.2.0 (2025-09-04)
+
+### Added
+- **💾 Session Persistence**: Comprehensive session management for improved reliability
+  - **🔐 Automatic Session Recovery**: VeSync sessions now persist across Homebridge restarts
+  - **📊 Token Lifecycle Management**: JWT token expiration tracking and automatic refresh
+  - **🛡️ Secure Storage**: Sessions stored with appropriate file permissions in tsvesync subdirectory
+  - **🚀 Faster Startup**: Reduced authentication overhead on Homebridge startup via session reuse
+  - **🔄 Seamless Recovery**: Automatic fallback to fresh login when persisted sessions are invalid
+
+- **🎛️ Advanced Speed Control**: Enhanced speed control for air purifiers with 4+ manual speeds
+  - **🌟 Multi-Speed Support**: Dynamic step calculation for devices with 4+ manual speed levels
+  - **🎯 Precision Mapping**: Better percentage-to-speed conversion for devices with varying speed counts
+  - **🔄 Smart Notch System**: Automatic adjustment of speed notches based on device capabilities
+  - **📱 Improved HomeKit UX**: More accurate slider positions and speed transitions
+
+### Enhanced
+- **🔧 API Integration**: Enhanced tsvesync library integration with session management
+  - **📦 Library Update**: Updated to tsvesync 1.2.0 with session persistence capabilities
+  - **🔗 Session Callbacks**: Integration with tsvesync session store for automatic persistence
+  - **⚡ Performance**: Reduced API calls through intelligent session reuse
+  - **🛡️ Reliability**: Better handling of authentication failures with automatic recovery
+
+- **🌙 Sleep Mode Control**: Refined sleep mode speed control logic
+  - **🎛️ Dynamic Step Calculation**: Speed steps now adjust based on maximum device speeds (20% vs 25%)
+  - **🎯 Better Speed Mapping**: More accurate conversion between HomeKit percentages and device speeds
+  - **🔄 Consistent Behavior**: Unified speed control logic across all sleep-capable devices
+  - **📱 UI Responsiveness**: Improved HomeKit characteristic updates during sleep mode transitions
+
+### Fixed
+- **🔧 Speed Control Accuracy**: Enhanced speed control precision for various device configurations
+  - **📊 Speed Calculation**: Fixed percentage calculation for devices with 4+ manual speeds
+  - **🎛️ Notch Mapping**: Improved notch-to-speed conversion with proper boundary checking
+  - **🔄 State Synchronization**: Better synchronization between device state and HomeKit display
+  - **🛡️ Edge Case Handling**: Enhanced handling of speed edge cases and boundary conditions
+
+### Technical Details
+- **🏗️ Session Architecture**: Complete integration with tsvesync 1.2.0 session management system
+- **🔧 FileSessionStore**: Dedicated session storage in ~/.homebridge/tsvesync/session.json
+- **📊 JWT Integration**: Automatic JWT token expiration tracking and session validation
+- **🎛️ Speed Algorithm**: Enhanced speed calculation algorithms for multi-speed device support
+- **🔄 Promise Coordination**: Better coordination with tsvesync library's promise-based login system
+
+### Migration Notes
+- **🚀 Automatic Enhancement**: Session persistence activates automatically after Homebridge restart
+- **📁 New Storage**: Session files stored in new tsvesync subdirectory under Homebridge storage path
+- **🔄 Backward Compatible**: All existing functionality preserved with enhanced capabilities
+- **✅ No Configuration**: No configuration changes required - enhancements work automatically
+- **🔧 Dependency Update**: tsvesync library automatically updated to version 1.2.0
+
 ## 1.1.2 (2025-09-03)
 
 ### Enhanced

package/dist/accessories/air-purifier.accessory.d.ts

@@ -24,6 +24,7 @@ export declare class AirPurifierAccessory extends BaseAccessory {
      * Get the maximum fan speed for the device
      */
     private getMaxFanSpeed;
+    private isCore200S;
     /**
      * Calculate the appropriate step size for discrete speed levels
      */

package/dist/accessories/air-purifier.accessory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"air-purifier.accessory.d.ts","sourceRoot":"","sources":["../../src/accessories/air-purifier.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,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAkC9E,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAC7C,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,cAAc,CAAkB;gBAGtC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,iBAAiB;IAiD3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAqIlB;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAmBvC;;OAEG;IACH,OAAO,CAAC,cAAc;IAiCtB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAWlC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;;;;;;;;;;;OAYG;YACW,oCAAoC;IAoClD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAqI9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;OAEG;YACW,yBAAyB;IAOvC;;OAEG;YACW,kBAAkB;IAOhC;;OAEG;YACW,eAAe;IAI7B;;OAEG;IACH,SAAS,CAAC,qBAAqB,IAAI,kBAAkB;IAcrD;;OAEG;cACa,0BAA0B,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAqHvE;;OAEG;YACW,cAAc;IAY5B;;OAEG;YACW,cAAc;IA2C5B;;OAEG;YACW,gBAAgB;IA0B9B;;OAEG;YACW,gBAAgB;YAgLhB,SAAS;YAIT,SAAS;CAoExB"}
+{"version":3,"file":"air-purifier.accessory.d.ts","sourceRoot":"","sources":["../../src/accessories/air-purifier.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,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAkC9E,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAC7C,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,cAAc,CAAkB;gBAGtC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,iBAAiB;IAiD3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAqIlB;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAmBvC;;OAEG;IACH,OAAO,CAAC,cAAc;IAiCtB,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAclC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;;;;;;;;;;;OAYG;YACW,oCAAoC;IAoClD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAqI9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;OAEG;YACW,yBAAyB;IAOvC;;OAEG;YACW,kBAAkB;IAOhC;;OAEG;YACW,eAAe;IAI7B;;OAEG;IACH,SAAS,CAAC,qBAAqB,IAAI,kBAAkB;IAcrD;;OAEG;cACa,0BAA0B,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAsHvE;;OAEG;YACW,cAAc;IAY5B;;OAEG;YACW,cAAc;IA2C5B;;OAEG;YACW,gBAAgB;IA0B9B;;OAEG;YACW,gBAAgB;YAoLhB,SAAS;YAIT,SAAS;CAoExB"}

package/dist/accessories/air-purifier.accessory.js

@@ -214,13 +214,20 @@ class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
         // Default to 3 for unknown devices
         return 3;
     }
+    isCore200S() {
+        return (this.device.deviceType || '').toUpperCase().includes('CORE200S');
+    }
     /**
      * Calculate the appropriate step size for discrete speed levels
      */
     calculateRotationSpeedStep() {
-        // Expose Sleep as the first notch when supported: 0,25,50,75,100
+        // Expose Sleep as the first notch when supported.
+        // Core 200S uses 3 manual speeds (25% step). 4-speed models use 20% step.
         if (this.hasFeature('sleep_mode')) {
-            return 25;
+            if (this.isCore200S())
+                return 25;
+            const max = this.getMaxFanSpeed();
+            return max >= 4 ? 20 : 25;
         }
         const maxSpeed = this.getMaxFanSpeed();
         if (maxSpeed === 3)
@@ -233,15 +240,15 @@ class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
      * Convert device speed to percentage
      */
     speedToPercentage(speed) {
-        // Sleep as first notch: show manual 1→50, 2→75, 3+→100
+        // Sleep as first notch: map manual speeds to notches based on model
         if (this.hasFeature('sleep_mode')) {
             if (typeof speed !== 'number' || speed <= 0)
                 return 0;
-            if (speed === 1)
-                return 50;
-            if (speed === 2)
-                return 75;
-            return 100;
+            const step = this.calculateRotationSpeedStep();
+            const max = this.isCore200S() ? 3 : this.getMaxFanSpeed();
+            // Manual speeds occupy notches 2..(max+1)
+            const notch = Math.max(2, Math.min(max + 1, speed + 1));
+            return Math.min(100, notch * step);
         }
         const maxSpeed = this.getMaxFanSpeed();
         if (maxSpeed <= 0 || typeof speed !== 'number' || speed <= 0)
@@ -296,16 +303,16 @@ class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
      * Convert percentage to device speed
      */
     percentageToSpeed(percentage) {
-        // Sleep as first notch: round to nearest 25% and map 50/75/100 → 1/2/3
+        // Sleep as first notch: round to nearest step and map notches → speeds
         if (this.hasFeature('sleep_mode')) {
             if (typeof percentage !== 'number')
                 return 1;
-            const notch = Math.max(0, Math.min(4, Math.round(Math.min(100, Math.max(0, percentage)) / 25)));
-            if (notch <= 2)
-                return 1; // 50%
-            if (notch === 3)
-                return 2; // 75%
-            return 3; // 100%
+            const step = this.calculateRotationSpeedStep();
+            const max = this.isCore200S() ? 3 : this.getMaxFanSpeed();
+            const maxNotch = max + 1; // include Sleep notch
+            const notch = Math.max(0, Math.min(maxNotch, Math.round(Math.min(100, Math.max(0, percentage)) / step)));
+            const manualNotch = Math.max(2, notch);
+            return Math.min(max, manualNotch - 1);
         }
         const maxSpeed = this.getMaxFanSpeed();
         if (maxSpeed <= 0 || typeof percentage !== 'number')
@@ -511,9 +518,10 @@ class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
         this.service.updateCharacteristic(this.platform.Characteristic.TargetAirPurifierState, targetState);
         // Update rotation speed
         if (isOn && this.hasFeature('sleep_mode') && isSleep) {
-            this.service.updateCharacteristic(this.platform.Characteristic.RotationSpeed, 25);
+            const step = this.calculateRotationSpeedStep();
+            this.service.updateCharacteristic(this.platform.Characteristic.RotationSpeed, step);
             this.lastSetSpeed = 0;
-            this.lastSetPercentage = 25;
+            this.lastSetPercentage = step;
         }
         else if (isOn && details.speed !== undefined && details.speed !== null) {
             // Check if we should skip this update
@@ -595,7 +603,7 @@ class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
             }
             // For all other devices, including Core300S, normal mode handling
             const mode = targetState === 1 ? 'auto' : 'manual';
-            this.platform.log.debug(`Setting mode to ${mode} for device: ${this.device.deviceName}`);
+            this.platform.log.info(`Changing mode to ${mode} for device: ${this.device.deviceName}`);
             let success = false;
             // Use the appropriate method to set the mode
             if (targetState === 1 && typeof extendedDevice.autoMode === 'function') {
@@ -634,7 +642,7 @@ class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
             // If in sleep mode, surface the first notch
             const extended = this.device;
             if (this.hasFeature('sleep_mode') && (extended.mode || '').toLowerCase() === 'sleep') {
-                return 25;
+                return this.calculateRotationSpeedStep();
             }
             return 0;
         }
@@ -695,10 +703,13 @@ class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
             }
             // When using sleep-as-first-notch, map slider notches robustly by rounding
             if (this.hasFeature('sleep_mode')) {
-                const notch = Math.max(0, Math.min(4, Math.round(percentage / 25)));
+                const max = this.isCore200S() ? 3 : this.getMaxFanSpeed();
+                const step = this.calculateRotationSpeedStep();
+                const maxNotch = max + 1; // include Sleep notch
+                const notch = Math.max(0, Math.min(maxNotch, Math.round(percentage / step)));
                 if (notch <= 1) {
                     // Sleep
-                    this.platform.log.debug(`Setting sleep mode via slider on ${this.device.deviceName} (notch=${notch})`);
+                    this.platform.log.info(`Changing mode to sleep for device: ${this.device.deviceName}`);
                     let ok = false;
                     if (typeof extendedDevice.sleepMode === 'function') {
                         ok = await extendedDevice.sleepMode();
@@ -710,20 +721,21 @@ class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
                         throw new Error('Failed to set sleep mode');
                     }
                     // Immediate UI feedback
-                    this.service.updateCharacteristic(this.platform.Characteristic.RotationSpeed, 25);
+                    this.service.updateCharacteristic(this.platform.Characteristic.RotationSpeed, step);
                     this.service.updateCharacteristic(this.platform.Characteristic.Active, 1);
                     this.service.updateCharacteristic(this.platform.Characteristic.CurrentAirPurifierState, 2);
                     this.lastSetSpeed = 0;
-                    this.lastSetPercentage = 25;
+                    this.lastSetPercentage = step;
                     this.skipNextUpdate = true;
                     return;
                 }
                 else {
-                    // Map notches 2/3/4 to speeds 1/2/3
-                    const desiredSpeed = Math.min(3, notch - 1);
+                    // Map manual notches (2..maxNotch) to speeds 1..max
+                    const desiredSpeed = Math.min(max, notch - 1);
                     // Ensure manual mode before speed change if necessary
                     const modeNow = (extendedDevice.mode || '').toLowerCase();
                     if (modeNow === 'auto' || modeNow === 'sleep') {
+                        this.platform.log.info(`Changing mode to manual for device: ${this.device.deviceName}`);
                         if (typeof extendedDevice.manualMode === 'function') {
                             await extendedDevice.manualMode();
                         }
@@ -732,7 +744,7 @@ class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
                         }
                     }
                     // Update UI early
-                    const uiPct = desiredSpeed === 1 ? 50 : desiredSpeed === 2 ? 75 : 100;
+                    const uiPct = Math.min(100, (desiredSpeed + 1) * step);
                     this.service.updateCharacteristic(this.platform.Characteristic.RotationSpeed, uiPct);
                     this.lastSetSpeed = desiredSpeed;
                     this.lastSetPercentage = uiPct;