homebridge-tsvesync 1.1.1 → 1.3.3

package/CHANGELOG.md

@@ -1,5 +1,348 @@
 # Changelog
 
+## 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
+- **🌙 Advanced Sleep Mode Speed Control**: Significantly improved HomeKit sleep mode integration
+  - **🎯 Sleep as First Notch**: Sleep mode now appears as the first position (25%) on HomeKit speed slider for supported devices
+  - **🎛️ Better Speed Mapping**: Enhanced speed control with 25%/50%/75%/100% positions for intuitive user control
+  - **🔄 Smart Mode Transitions**: Automatic manual mode switching when adjusting speeds from sleep mode
+  - **📱 Immediate UI Feedback**: Instant HomeKit characteristic updates for responsive user experience
+  - **🛡️ Error Recovery**: Comprehensive error handling with state reversion on API failures
+
+- **⚡ Performance Optimizations**: Streamlined speed control logic for better performance
+  - **🔧 Consolidated Code**: Refactored speed conversion methods for improved maintainability
+  - **📊 Efficient Calculations**: Optimized percentage-to-speed and speed-to-percentage conversions
+  - **🎯 Reduced Complexity**: Simplified conditional logic while maintaining full functionality
+  - **💾 Memory Efficiency**: Better resource utilization with consolidated helper methods
+
+### Fixed
+- **🌪️ Enhanced Speed Restoration**: Improved device speed handling across all air purifier models
+  - **🎛️ Sleep Mode Detection**: Better detection and handling of sleep mode state transitions
+  - **🔄 Mode Synchronization**: Improved synchronization between device mode and HomeKit display
+  - **📱 Slider Accuracy**: More accurate speed slider positions for devices with sleep mode support
+  - **🛡️ State Consistency**: Enhanced state management to prevent speed control conflicts
+
+### Technical Details
+- **🏗️ Refactored Architecture**: Consolidated speed calculation methods for better code organization
+- **🎯 Feature Detection**: Enhanced hasFeature('sleep_mode') integration for dynamic behavior
+- **🔧 Method Optimization**: Streamlined percentageToSpeed() and speedToPercentage() methods
+- **📊 Improved Mapping**: Better notch-based speed mapping with rounding for discrete positions
+- **🛡️ Enhanced Validation**: Improved input validation and boundary checking for speed values
+
+### Affected Devices
+- **Sleep Mode Devices**: Air purifiers with sleep mode support now have enhanced speed control
+- **All Air Purifiers**: Benefit from optimized speed conversion logic and better performance
+- **Core/Vital/LAP Series**: Improved HomeKit integration with consistent speed control behavior
+
+### Migration Notes
+- **🚀 Automatic Enhancement**: Speed control improvements activate automatically after Homebridge restart
+- **📱 HomeKit Changes**: Supported devices will show sleep mode as first notch on speed slider
+- **🔄 Backward Compatible**: All existing functionality preserved with enhanced capabilities
+- **✅ No Configuration**: No configuration changes required - enhancements work automatically
+
+### Dependencies
+- **📦 tsvesync**: Updated to 1.1.2 for synchronized release versioning
+
 ## 1.1.1 (2025-08-30)
 
 ### Improved

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;IAclC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;;;;;;;;;;;OAYG;YACW,oCAAoC;IAoClD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsCzB;;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;IA8GvE;;OAEG;YACW,cAAc;IAY5B;;OAEG;YACW,cAAc;IA2C5B;;OAEG;YACW,gBAAgB;IAqB9B;;OAEG;YACW,gBAAgB;YAmHhB,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,50 +214,49 @@ 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() {
-        const maxSpeed = this.getMaxFanSpeed();
-        // For devices with discrete speed levels, set appropriate step size
-        if (maxSpeed === 3) {
-            return 33.33; // Creates exact positions: 0%, 33.33%, 66.67%, 100%
-        }
-        else if (maxSpeed === 4) {
-            return 25; // Creates exact positions: 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')) {
+            if (this.isCore200S())
+                return 25;
+            const max = this.getMaxFanSpeed();
+            return max >= 4 ? 20 : 25;
         }
-        // Default to continuous slider for other devices
+        const maxSpeed = this.getMaxFanSpeed();
+        if (maxSpeed === 3)
+            return 33.33;
+        if (maxSpeed === 4)
+            return 25;
         return 1;
     }
     /**
      * Convert device speed to percentage
      */
     speedToPercentage(speed) {
+        // 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;
+            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();
-        // Ensure we have valid numbers
-        if (maxSpeed <= 0 || typeof speed !== 'number' || speed <= 0) {
+        if (maxSpeed <= 0 || typeof speed !== 'number' || speed <= 0)
             return 0;
-        }
-        // For devices with 3 speed levels
-        if (maxSpeed === 3) {
-            switch (speed) {
-                case 1: return 33.33; // Low -> 33.33%
-                case 2: return 66.67; // Medium -> 66.67%
-                case 3: return 100; // High -> 100%
-                default: return 0;
-            }
-        }
-        // For devices with 4 speed levels
-        else if (maxSpeed === 4) {
-            switch (speed) {
-                case 1: return 25; // Low -> 25%
-                case 2: return 50; // Medium-Low -> 50%
-                case 3: return 75; // Medium-High -> 75%
-                case 4: return 100; // High -> 100%
-                default: return 0;
-            }
-        }
-        // Default calculation
+        if (maxSpeed === 3)
+            return speed === 1 ? 33.33 : speed === 2 ? 66.67 : 100;
+        if (maxSpeed === 4)
+            return speed === 1 ? 25 : speed === 2 ? 50 : speed === 3 ? 75 : 100;
         return Math.min(100, Math.max(0, Math.round((speed / maxSpeed) * 100)));
     }
     /**
@@ -304,41 +303,25 @@ class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
      * Convert percentage to device speed
      */
     percentageToSpeed(percentage) {
-        const maxSpeed = this.getMaxFanSpeed();
-        // Ensure we have valid numbers
-        if (maxSpeed <= 0 || typeof percentage !== 'number') {
-            return 1; // Default to lowest speed
+        // Sleep as first notch: round to nearest step and map notches → speeds
+        if (this.hasFeature('sleep_mode')) {
+            if (typeof percentage !== 'number')
+                return 1;
+            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);
         }
-        // Ensure percentage is between 0 and 100
+        const maxSpeed = this.getMaxFanSpeed();
+        if (maxSpeed <= 0 || typeof percentage !== 'number')
+            return 1;
         percentage = Math.min(100, Math.max(0, percentage));
-        // For devices with 3 speed levels
-        if (maxSpeed === 3) {
-            if (percentage <= 33.34) {
-                return 1; // Low
-            }
-            else if (percentage <= 66.67) {
-                return 2; // Medium
-            }
-            else {
-                return 3; // High
-            }
-        }
-        // For devices with 4 speed levels
-        else if (maxSpeed === 4) {
-            if (percentage <= 25) {
-                return 1; // Low
-            }
-            else if (percentage <= 50) {
-                return 2; // Medium-Low
-            }
-            else if (percentage <= 75) {
-                return 3; // Medium-High
-            }
-            else {
-                return 4; // High
-            }
-        }
-        // Default calculation
+        if (maxSpeed === 3)
+            return percentage <= 33.34 ? 1 : percentage <= 66.67 ? 2 : 3;
+        if (maxSpeed === 4)
+            return percentage <= 25 ? 1 : percentage <= 50 ? 2 : percentage <= 75 ? 3 : 4;
         return Math.max(1, Math.min(Math.round((percentage / 100) * maxSpeed), maxSpeed));
     }
     /**
@@ -511,8 +494,11 @@ class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
      */
     async updateDeviceSpecificStates(details) {
         var _a, _b;
-        // Update power state
-        const isOn = details.enabled || details.deviceStatus === 'on';
+        // Update power state (treat sleep as on for some VeSync models)
+        const extended = this.device;
+        const mode = (extended.mode || details.mode || '').toLowerCase();
+        const isSleep = mode === 'sleep';
+        const isOn = isSleep || details.enabled || details.deviceStatus === 'on';
         this.service.updateCharacteristic(this.platform.Characteristic.Active, isOn ? 1 : 0);
         // Update current state (INACTIVE = 0, IDLE = 1, PURIFYING_AIR = 2)
         this.service.updateCharacteristic(this.platform.Characteristic.CurrentAirPurifierState, isOn ? 2 : 0);
@@ -531,7 +517,13 @@ class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
         }
         this.service.updateCharacteristic(this.platform.Characteristic.TargetAirPurifierState, targetState);
         // Update rotation speed
-        if (isOn && details.speed !== undefined && details.speed !== null) {
+        if (isOn && this.hasFeature('sleep_mode') && isSleep) {
+            const step = this.calculateRotationSpeedStep();
+            this.service.updateCharacteristic(this.platform.Characteristic.RotationSpeed, step);
+            this.lastSetSpeed = 0;
+            this.lastSetPercentage = step;
+        }
+        else if (isOn && details.speed !== undefined && details.speed !== null) {
             // Check if we should skip this update
             if (this.skipNextUpdate) {
                 this.platform.log.debug(`Skipping update for ${this.device.deviceName} as requested`);
@@ -611,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') {
@@ -647,6 +639,11 @@ class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
         if (this.device.deviceStatus !== 'on' ||
             this.device.speed === undefined ||
             this.device.speed === null) {
+            // If in sleep mode, surface the first notch
+            const extended = this.device;
+            if (this.hasFeature('sleep_mode') && (extended.mode || '').toLowerCase() === 'sleep') {
+                return this.calculateRotationSpeedStep();
+            }
             return 0;
         }
         // If we have a last set percentage, use that instead of calculating from device speed
@@ -704,6 +701,63 @@ class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
                 // Update device state to get fresh mode information
                 await this.updateDeviceSpecificStates(this.device);
             }
+            // When using sleep-as-first-notch, map slider notches robustly by rounding
+            if (this.hasFeature('sleep_mode')) {
+                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.info(`Changing mode to sleep for device: ${this.device.deviceName}`);
+                    let ok = false;
+                    if (typeof extendedDevice.sleepMode === 'function') {
+                        ok = await extendedDevice.sleepMode();
+                    }
+                    else if (typeof extendedDevice.setMode === 'function') {
+                        ok = await extendedDevice.setMode('sleep');
+                    }
+                    if (!ok) {
+                        throw new Error('Failed to set sleep mode');
+                    }
+                    // Immediate UI feedback
+                    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 = step;
+                    this.skipNextUpdate = true;
+                    return;
+                }
+                else {
+                    // 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();
+                        }
+                        else if (typeof extendedDevice.setMode === 'function') {
+                            await extendedDevice.setMode('manual');
+                        }
+                    }
+                    // Update UI early
+                    const uiPct = Math.min(100, (desiredSpeed + 1) * step);
+                    this.service.updateCharacteristic(this.platform.Characteristic.RotationSpeed, uiPct);
+                    this.lastSetSpeed = desiredSpeed;
+                    this.lastSetPercentage = uiPct;
+                    this.skipNextUpdate = true;
+                    const ok = await this.device.changeFanSpeed(desiredSpeed);
+                    if (!ok) {
+                        this.lastSetSpeed = 0;
+                        this.lastSetPercentage = 0;
+                        throw new Error(`Failed to set speed to ${desiredSpeed}`);
+                    }
+                    return;
+                }
+            }
             // Check if fan speed control is supported in current mode
             if (!this.isFeatureSupportedInCurrentMode('fan_speed')) {
                 this.platform.log.warn(`Fan speed control not supported in ${extendedDevice.mode} mode for device: ${this.device.deviceName}`);
@@ -725,6 +779,16 @@ class AirPurifierAccessory extends base_accessory_1.BaseAccessory {
                     }
                 }
             }
+            // For devices without sleep notch, ensure manual mode if required
+            const modeNow = (extendedDevice.mode || '').toLowerCase();
+            if (modeNow === 'auto') {
+                if (typeof extendedDevice.manualMode === 'function') {
+                    await extendedDevice.manualMode();
+                }
+                else if (typeof extendedDevice.setMode === 'function') {
+                    await extendedDevice.setMode('manual');
+                }
+            }
             // Convert percentage to device speed using our consistent conversion method
             const speed = this.percentageToSpeed(percentage);
             // Final validation to ensure speed is a valid number