tsvesync 1.3.13 → 1.4.1

package/src/lib/fans/airBypass.ts

@@ -7,7 +7,9 @@ import { logger } from '../logger';
  * VeSync Air Purifier with Bypass
  */
 export class VeSyncAirBypass extends VeSyncFan {
-    protected readonly modes = ['auto', 'manual', 'sleep'] as const;
+    protected get modes(): ReadonlyArray<string> {
+        return this.getConfigModes(['auto', 'manual', 'sleep']);
+    }
     protected readonly displayModes = ['on', 'off'] as const;
     protected readonly childLockModes = ['on', 'off'] as const;
 
@@ -77,17 +79,33 @@ export class VeSyncAirBypass extends VeSyncFan {
                     }
                 }
 
+                // Parse air quality with fallback support for multiple API response formats
+                // Some devices (like Core 400S) may use PascalCase (AQLevel, PM25)
+                // while others use snake_case (air_quality, air_quality_value)
+                const airQualityLevel = result.air_quality || result.AQLevel || 0;
+                const airQualityValue = result.air_quality_value || result.PM25 || 0;
+
+                // Debug logging to diagnose air quality field availability
+                logger.debug(`${this.deviceName}: Air quality API response fields:`, {
+                    air_quality: result.air_quality,
+                    AQLevel: result.AQLevel,
+                    air_quality_value: result.air_quality_value,
+                    PM25: result.PM25,
+                    parsed_level: airQualityLevel,
+                    parsed_value: airQualityValue
+                });
+
                 this.details = {
                     mode: result.mode || '',
                     speed: result.level || 0,
                     filter_life: filterLife,
                     screen_status: result.display ? 'on' : 'off',
                     child_lock: result.child_lock || false,
-                    air_quality: result.air_quality || 0,
-                    air_quality_value: result.air_quality_value || 0
+                    air_quality: airQualityLevel,
+                    air_quality_value: airQualityValue
                 };
 
-                const normalizedAirQuality = Helpers.normalizeAirQuality(result.air_quality);
+                const normalizedAirQuality = Helpers.normalizeAirQuality(airQualityLevel);
                 if (normalizedAirQuality.level >= 1) {
                     this.details.air_quality_level = normalizedAirQuality.level;
                 }
@@ -98,6 +116,15 @@ export class VeSyncAirBypass extends VeSyncFan {
                 if ('PM10' in result) this.details.pm10 = result.PM10;
                 if ('AQPercent' in result) this.details.aq_percent = result.AQPercent;
 
+                // Debug log additional air quality fields for diagnostics
+                if (result.PM1 !== undefined || result.PM10 !== undefined || result.AQPercent !== undefined) {
+                    logger.debug(`${this.deviceName}: Additional air quality data:`, {
+                        PM1: result.PM1,
+                        PM10: result.PM10,
+                        AQPercent: result.AQPercent
+                    });
+                }
+
                 // Don't overwrite config as it contains features array
                 if (result.configuration) {
                     this.details.configuration = result.configuration;
@@ -216,16 +243,20 @@ export class VeSyncAirBypass extends VeSyncFan {
      * Set device mode
      */
     async setMode(mode: string): Promise<boolean> {
-        if (!this.modes.includes(mode as any)) {
+        const requested = mode.toLowerCase();
+        const supported = this.modes.map(m => m.toLowerCase());
+        const allowsCore200AutoFallback = this.deviceType.includes('Core200S') && requested === 'auto';
+
+        if (!supported.includes(requested) && !allowsCore200AutoFallback) {
             const error = `Invalid mode: ${mode}. Must be one of: ${this.modes.join(', ')}`;
             logger.error(`${error} for device: ${this.deviceName}`);
             throw new Error(error);
         }
 
-        logger.debug(`Setting mode to ${mode} for device: ${this.deviceName}`);
+        logger.debug(`Setting mode to ${requested} for device: ${this.deviceName}`);
 
         // Special handling for Core200S auto mode
-        if (this.deviceType.includes('Core200S') && mode === 'auto') {
+        if (allowsCore200AutoFallback) {
             // Core200S doesn't support auto mode, so we'll set it to manual mode
             logger.warn(`Auto mode not supported for ${this.deviceType}, using manual mode instead`);
             return this.setMode('manual');
@@ -241,7 +272,7 @@ export class VeSyncAirBypass extends VeSyncFan {
                 configModule: this.configModule,
                 payload: {
                     data: {
-                        mode
+                        mode: requested
                     },
                     method: 'setPurifierMode',
                     source: 'APP'
@@ -252,10 +283,10 @@ export class VeSyncAirBypass extends VeSyncFan {
 
         const success = this.checkResponse([response, status], 'setMode');
         if (success) {
-            this.details.mode = mode;
+            this.details.mode = requested;
             return true;
         } else {
-            logger.error(`Failed to set mode to ${mode} for device: ${this.deviceName}`);
+            logger.error(`Failed to set mode to ${requested} for device: ${this.deviceName}`);
             return false;
         }
     }

package/src/lib/vesyncFan.ts

@@ -7,12 +7,16 @@ import { VeSync } from './vesync';
 import { logger } from './logger';
 import { Helpers } from './helpers';
 
+interface FanConfigEntry {
+    module: 'VeSyncAirBypass' | 'VeSyncHumidifier' | 'VeSyncWarmHumidifier' | 'VeSyncTowerFan' | 'VeSyncAirBaseV2' | 'VeSyncSuperior6000S' | 'VeSyncHumid1000S' | 'VeSyncHumid200S' | 'VeSyncAir131';
+    features: string[];
+    levels?: number[];
+    modes?: ReadonlyArray<string>;
+    autoPreferences?: ReadonlyArray<string>;
+}
+
 interface FanConfig {
-    [key: string]: {
-        module: 'VeSyncAirBypass' | 'VeSyncHumidifier' | 'VeSyncWarmHumidifier' | 'VeSyncTowerFan' | 'VeSyncAirBaseV2' | 'VeSyncSuperior6000S' | 'VeSyncHumid1000S' | 'VeSyncHumid200S' | 'VeSyncAir131';
-        features: string[];
-        levels?: number[];
-    };
+    [key: string]: FanConfigEntry;
 }
 
 // Fan configuration
@@ -21,159 +25,218 @@ export const fanConfig: FanConfig = {
     'Core200S': {
         module: 'VeSyncAirBypass',
         features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speed', 'sleep_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]  // 4 levels including sleep mode, matching reference plugin
+        levels: [1, 2, 3, 4],  // 4 levels including sleep mode, matching reference plugin
+        modes: ['sleep', 'manual']
     },
     'Core300S': {
         module: 'VeSyncAirBypass',
         features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'Core400S': {
         module: 'VeSyncAirBypass',
         features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'Core600S': {
         module: 'VeSyncAirBypass',
         features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     
     // LAP Series
     'LAP-C201S-AUSR': {
         module: 'VeSyncAirBypass',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
-        levels: [1, 2, 3]
+        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speed', 'sleep_mode', 'filter_life'],
+        levels: [1, 2, 3],
+        modes: ['sleep', 'manual']
     },
     'LAP-C202S-WUSR': {
         module: 'VeSyncAirBypass',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
-        levels: [1, 2, 3]
+        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speed', 'sleep_mode', 'filter_life'],
+        levels: [1, 2, 3],
+        modes: ['sleep', 'manual']
     },
     'LAP-C301S-WJP': {
         module: 'VeSyncAirBypass',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-C302S-WUSB': {
         module: 'VeSyncAirBypass',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-C301S-WAAA': {
         module: 'VeSyncAirBypass',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-C401S-WJP': {
         module: 'VeSyncAirBypass',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-C401S-WUSR': {
         module: 'VeSyncAirBypass',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-C401S-WAAA': {
         module: 'VeSyncAirBypass',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-C601S-WUS': {
         module: 'VeSyncAirBypass',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-C601S-WUSR': {
         module: 'VeSyncAirBypass',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-C601S-WEU': {
         module: 'VeSyncAirBypass',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-V102S-AASR': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'pet_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto', 'pet'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-V102S-WUS': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'pet_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto', 'pet'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-V102S-WEU': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'pet_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto', 'pet'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-V102S-AUSR': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'pet_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto', 'pet'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-V102S-WJP': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_speed', 'auto_mode', 'sleep_mode', 'pet_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto', 'pet'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-V201S-AASR': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'light_detection', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'light_detection', 'fan_speed', 'auto_mode', 'sleep_mode', 'pet_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto', 'pet'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-V201S-WJP': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'light_detection', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'light_detection', 'fan_speed', 'auto_mode', 'sleep_mode', 'pet_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto', 'pet'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-V201S-WEU': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'light_detection', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'light_detection', 'fan_speed', 'auto_mode', 'sleep_mode', 'pet_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto', 'pet'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-V201S-WUS': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'light_detection', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'light_detection', 'fan_speed', 'auto_mode', 'sleep_mode', 'pet_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto', 'pet'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-V201-AUSR': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'light_detection', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'light_detection', 'fan_speed', 'auto_mode', 'sleep_mode', 'pet_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto', 'pet'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-V201S-AUSR': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'light_detection', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'light_detection', 'fan_speed', 'auto_mode', 'sleep_mode', 'pet_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto', 'pet'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-V201S-AEUR': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'light_detection', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3, 4]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'light_detection', 'fan_speed', 'auto_mode', 'sleep_mode', 'pet_mode', 'filter_life'],
+        levels: [1, 2, 3, 4],
+        modes: ['sleep', 'manual', 'auto', 'pet'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-EL551S-AUS': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_rotate', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_rotate', 'fan_speed', 'auto_mode', 'sleep_mode', 'turbo_mode', 'light_detection', 'filter_life'],
+        levels: [1, 2, 3],
+        modes: ['sleep', 'manual', 'auto', 'turbo'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-EL551S-AEUR': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_rotate', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_rotate', 'fan_speed', 'auto_mode', 'sleep_mode', 'turbo_mode', 'light_detection', 'filter_life'],
+        levels: [1, 2, 3],
+        modes: ['sleep', 'manual', 'auto', 'turbo'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-EL551S-WEU': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_rotate', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_rotate', 'fan_speed', 'auto_mode', 'sleep_mode', 'turbo_mode', 'light_detection', 'filter_life'],
+        levels: [1, 2, 3],
+        modes: ['sleep', 'manual', 'auto', 'turbo'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     'LAP-EL551S-WUS': {
         module: 'VeSyncAirBaseV2',
-        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_rotate', 'fan_speed', 'auto_mode', 'filter_life'],
-        levels: [1, 2, 3]
+        features: ['display', 'child_lock', 'night_light', 'air_quality', 'timer', 'fan_rotate', 'fan_speed', 'auto_mode', 'sleep_mode', 'turbo_mode', 'light_detection', 'filter_life'],
+        levels: [1, 2, 3],
+        modes: ['sleep', 'manual', 'auto', 'turbo'],
+        autoPreferences: ['default', 'efficient', 'quiet']
     },
     
     // LTF Series
@@ -342,20 +405,77 @@ export abstract class VeSyncFan extends VeSyncBaseDevice {
     protected mode_dict: Record<string, any> = {};
     protected speed_dict: Record<string, any> = {};
     protected _timer: number | { duration: number; action: string } | null = null;
-    protected config: {
-        module: 'VeSyncAirBypass' | 'VeSyncHumidifier' | 'VeSyncWarmHumidifier' | 'VeSyncTowerFan' | 'VeSyncAirBaseV2' | 'VeSyncSuperior6000S' | 'VeSyncHumid1000S' | 'VeSyncHumid200S' | 'VeSyncAir131';
-        features: string[];
-        levels?: number[];
-    };
+    protected config: FanConfigEntry;
 
     constructor(details: Record<string, any>, manager: VeSync) {
         super(details, manager);
         this.details = details;
-        this.config = fanConfig[this.deviceType] || { 
-            module: 'VeSyncAirBypass', 
-            features: [],
-            levels: []
-        };
+
+        // Try exact match first
+        let entry: FanConfigEntry | undefined = fanConfig[this.deviceType];
+
+        // If no exact match, try substring matching for LAP variants
+        // This handles cases where device reports as "LAP-C401S-WUSR" but we only have "Core400S" config
+        if (!entry) {
+            entry = this.findConfigBySubstring(this.deviceType);
+        }
+
+        if (entry) {
+            this.config = {
+                ...entry,
+                features: [...entry.features],
+                levels: entry.levels ? [...entry.levels] : undefined,
+                modes: entry.modes ? [...entry.modes] : undefined,
+                autoPreferences: entry.autoPreferences ? [...entry.autoPreferences] : undefined
+            };
+        } else {
+            this.config = {
+                module: 'VeSyncAirBypass',
+                features: [],
+                levels: [],
+                modes: [],
+                autoPreferences: []
+            };
+        }
+    }
+
+    /**
+     * Find config entry by substring matching for variant device types
+     * Maps LAP variants to their base model configs (e.g., LAP-C401S-WUSR → Core400S)
+     */
+    private findConfigBySubstring(deviceType: string): FanConfigEntry | undefined {
+        // Define model number mappings
+        const modelMappings: Array<{ patterns: string[]; configKey: string }> = [
+            // Core series air purifiers
+            { patterns: ['Core300S', '301S', '302S'], configKey: 'Core300S' },
+            { patterns: ['Core400S', '401S'], configKey: 'Core400S' },
+            { patterns: ['Core600S', '601S', '602S'], configKey: 'Core600S' },
+            { patterns: ['Core200S', '201S', '202S'], configKey: 'Core200S' },
+
+            // Vital series
+            { patterns: ['V102S'], configKey: 'LAP-V102S-AASR' },
+            { patterns: ['V201S'], configKey: 'LAP-V201S-AASR' },
+
+            // LV-PUR series
+            { patterns: ['LV-PUR131S', 'LV-RH131S'], configKey: 'LV-PUR131S' },
+
+            // Everest series
+            { patterns: ['LAP-EL551S'], configKey: 'LAP-EL551S-AUS' },
+        ];
+
+        // Check each mapping
+        for (const mapping of modelMappings) {
+            // If device type contains any of the patterns, use the config key
+            if (mapping.patterns.some(pattern => deviceType.includes(pattern))) {
+                const config = fanConfig[mapping.configKey];
+                if (config) {
+                    logger.debug(`${deviceType}: Using fallback config from ${mapping.configKey} via substring match`);
+                    return config;
+                }
+            }
+        }
+
+        return undefined;
     }
 
     /**
@@ -365,6 +485,40 @@ export abstract class VeSyncFan extends VeSyncBaseDevice {
         return this.config.features.includes(feature);
     }
 
+    /**
+     * Get configured modes for the device, falling back to provided defaults.
+     */
+    protected getConfigModes(defaultModes: ReadonlyArray<string> = []): ReadonlyArray<string> {
+        if (Array.isArray(this.config.modes) && this.config.modes.length > 0) {
+            return this.config.modes;
+        }
+        return defaultModes;
+    }
+
+    /**
+     * Get configured auto preferences for the device, falling back to provided defaults.
+     */
+    protected getConfigAutoPreferences(defaultPreferences: ReadonlyArray<string> = []): ReadonlyArray<string> {
+        if (Array.isArray(this.config.autoPreferences) && this.config.autoPreferences.length > 0) {
+            return this.config.autoPreferences;
+        }
+        return defaultPreferences;
+    }
+
+    /**
+     * Public accessor for supported modes for consumers that need to inspect capability metadata.
+     */
+    public getSupportedModes(defaultModes: ReadonlyArray<string> = []): ReadonlyArray<string> {
+        return this.getConfigModes(defaultModes);
+    }
+
+    /**
+     * Public accessor for supported auto preference profiles.
+     */
+    public getSupportedAutoPreferences(defaultPreferences: ReadonlyArray<string> = []): ReadonlyArray<string> {
+        return this.getConfigAutoPreferences(defaultPreferences);
+    }
+
     /**
      * Check if feature is supported in current mode
      */
@@ -403,7 +557,10 @@ export abstract class VeSyncFan extends VeSyncBaseDevice {
      * Get maximum fan speed level
      */
     getMaxFanSpeed(): number {
-        return this.config.levels ? Math.max(...this.config.levels) : 3;
+        if (this.config.levels && this.config.levels.length > 0) {
+            return Math.max(...this.config.levels);
+        }
+        return 3;
     }
 
     /**