tsvesync 1.0.52 → 1.0.55

package/dist/lib/vesyncFan.js

@@ -189,98 +189,121 @@ exports.fanConfig = {
     // Classic Series
     'Classic300S': {
         module: 'VeSyncHumidifier',
-        features: ['display', 'humidity', 'mist', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'Classic200S': {
         module: 'VeSyncHumidifier',
-        features: ['display', 'humidity', 'mist', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     // Dual Series
     'Dual200S': {
         module: 'VeSyncHumidifier',
-        features: ['display', 'humidity', 'mist', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'timer', 'auto_mode'],
+        levels: [1, 2]
     },
     // LUH Series
     'LUH-A601S-WUSB': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-A601S-AUSW': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-D301S-WUSR': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2]
     },
     'LUH-D301S-WJP': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2]
     },
     'LUH-D301S-WEU': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2]
     },
     'LUH-A602S-WUSR': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-A602S-WUS': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-A602S-WEUR': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-A602S-WEU': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-A602S-WJP': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-A602S-WUSC': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-O451S-WEU': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-O451S-WUS': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-O451S-WUSR': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-O601S-WUS': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-O601S-KUS': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-M101S-WUS': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-M101S-WEUR': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     // LEH Series
     'LEH-S601S-WUS': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode', 'drying']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode', 'drying'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LEH-S601S-WUSR': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode', 'drying']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode', 'drying'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     // LV Series
     'LV-PUR131S': {

package/dist/lib/vesyncFanImpl.d.ts

@@ -91,11 +91,40 @@ export declare class VeSyncHumidifier extends VeSyncFan {
         min: number;
         max: number;
     };
+    protected readonly states: readonly ["inactive", "idle", "humidifying"];
     constructor(details: Record<string, any>, manager: VeSync);
+    /**
+     * Get current operational state
+     */
+    get currentState(): string;
+    /**
+     * Get water level percentage
+     */
+    get waterLevel(): number;
+    /**
+     * Get water tank status
+     */
+    get waterTankLifted(): boolean;
+    /**
+     * Get oscillation state
+     */
+    get oscillationEnabled(): boolean;
+    /**
+     * Set oscillation state
+     */
+    setOscillation(enabled: boolean): Promise<boolean>;
     /**
      * Get device details
      */
     getDetails(): Promise<Boolean>;
+    /**
+     * Display device info
+     */
+    display(): void;
+    /**
+     * Return JSON details
+     */
+    displayJSON(): string;
     /**
      * Turn device on
      */

package/dist/lib/vesyncFanImpl.js

@@ -26,6 +26,7 @@ class VeSyncAirBypass extends vesyncFan_1.VeSyncFan {
         const body = {
             ...helpers_1.Helpers.reqBody(this.manager, 'bypassV2'),
             cid: this.cid,
+            deviceId: this.cid, // Add deviceId to match YAML spec
             configModule: this.configModule,
             payload: {
                 method,
@@ -209,10 +210,11 @@ class VeSyncAirBypass extends vesyncFan_1.VeSyncFan {
      * Change fan speed
      */
     async changeFanSpeed(speed) {
-        var _a;
-        const speeds = (_a = this.config.levels) !== null && _a !== void 0 ? _a : [];
-        if (!speeds.includes(speed)) {
-            logger_1.logger.error(`Invalid speed: ${speed}. Must be one of: ${speeds.join(', ')} for device: ${this.deviceName}`);
+        var _a, _b, _c;
+        logger_1.logger.debug(`Attempting to change fan speed to ${speed} for device: ${this.deviceName}`);
+        logger_1.logger.debug(`Available speeds: ${(_a = this.config.levels) === null || _a === void 0 ? void 0 : _a.join(', ')}`);
+        if (!((_b = this.config.levels) === null || _b === void 0 ? void 0 : _b.includes(speed))) {
+            logger_1.logger.error(`Invalid speed: ${speed}. Must be one of: ${(_c = this.config.levels) === null || _c === void 0 ? void 0 : _c.join(', ')} for device: ${this.deviceName}`);
             return false;
         }
         logger_1.logger.info(`Changing fan speed to ${speed} for device: ${this.deviceName}`);
@@ -241,10 +243,11 @@ class VeSyncAirBypass extends vesyncFan_1.VeSyncFan {
      * Set device mode
      */
     async setMode(mode) {
-        if (!this.modes.includes(mode)) {
-            const error = `Invalid mode: ${mode}. Must be one of: ${this.modes.join(', ')}`;
-            logger_1.logger.error(`${error} for device: ${this.deviceName}`);
-            throw new Error(error);
+        const modeStr = mode.toLowerCase();
+        if (!this.modes.includes(modeStr)) {
+            logger_1.logger.debug(`Invalid humidity mode used - ${mode}`);
+            logger_1.logger.debug(`Proper modes for this device are - ${this.modes.join(', ')}`);
+            return false;
         }
         logger_1.logger.debug(`Setting mode to ${mode} for device: ${this.deviceName}`);
         const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', {
@@ -253,15 +256,15 @@ class VeSyncAirBypass extends vesyncFan_1.VeSyncFan {
             configModule: this.configModule,
             payload: {
                 data: {
-                    mode
+                    workMode: this.deviceType.startsWith('Superior') && modeStr === 'auto' ? 'autoPro' : modeStr
                 },
-                method: 'setPurifierMode',
+                method: 'setHumidifierMode',
                 source: 'APP'
             }
         }, helpers_1.Helpers.reqHeaderBypass());
         const success = this.checkResponse([response, status], 'setMode');
         if (!success) {
-            logger_1.logger.error(`Failed to set mode to ${mode} for device: ${this.deviceName}`);
+            logger_1.logger.debug('Error setting humidity mode');
         }
         return success;
     }
@@ -488,6 +491,7 @@ class VeSyncHumidifier extends vesyncFan_1.VeSyncFan {
         this.modes = ['auto', 'manual', 'sleep'];
         this.displayModes = ['on', 'off'];
         this.humidityRange = { min: 30, max: 80 };
+        this.states = ['inactive', 'idle', 'humidifying'];
         // Set mist levels based on model
         switch (this.deviceType) {
             case 'Dual200S':
@@ -502,6 +506,66 @@ class VeSyncHumidifier extends vesyncFan_1.VeSyncFan {
         }
         logger_1.logger.debug(`Initialized VeSyncHumidifier device: ${this.deviceName}`);
     }
+    /**
+     * Get current operational state
+     */
+    get currentState() {
+        if (this.deviceStatus === 'off') {
+            return 'inactive';
+        }
+        if (this.details.water_lacks) {
+            return 'idle';
+        }
+        return 'humidifying';
+    }
+    /**
+     * Get water level percentage
+     */
+    get waterLevel() {
+        var _a;
+        return (_a = this.details.water_level) !== null && _a !== void 0 ? _a : 0;
+    }
+    /**
+     * Get water tank status
+     */
+    get waterTankLifted() {
+        var _a;
+        return (_a = this.details.water_tank_lifted) !== null && _a !== void 0 ? _a : false;
+    }
+    /**
+     * Get oscillation state
+     */
+    get oscillationEnabled() {
+        var _a;
+        return (_a = this.details.oscillation_enabled) !== null && _a !== void 0 ? _a : false;
+    }
+    /**
+     * Set oscillation state
+     */
+    async setOscillation(enabled) {
+        if (!this.hasFeature('oscillation')) {
+            logger_1.logger.debug('Oscillation not supported');
+            return false;
+        }
+        logger_1.logger.debug(`Setting oscillation to ${enabled ? 'on' : 'off'} for device: ${this.deviceName}`);
+        const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', {
+            ...helpers_1.Helpers.reqBody(this.manager, 'bypassV2'),
+            cid: this.cid,
+            configModule: this.configModule,
+            payload: {
+                data: {
+                    oscillationEnabled: enabled
+                },
+                method: 'setSwing',
+                source: 'APP'
+            }
+        }, helpers_1.Helpers.reqHeaderBypass());
+        const success = this.checkResponse([response, status], 'setOscillation');
+        if (!success) {
+            logger_1.logger.debug('Error setting oscillation');
+        }
+        return success;
+    }
     /**
      * Get device details
      */
@@ -533,12 +597,13 @@ class VeSyncHumidifier extends vesyncFan_1.VeSyncFan {
                 humidity: result.humidity || 0,
                 mist_level: result.mistLevel || 0,
                 mist_virtual_level: result.virtualLevel || 0,
-                warm_level: result.warmLevel || 0,
                 water_lacks: result.waterLacks || false,
-                humidity_high: result.humidityHigh || false,
+                water_level: result.waterLevel || 0,
                 water_tank_lifted: result.waterTankLifted || false,
+                humidity_high: result.humidityHigh || false,
                 display: result.display || false,
                 automatic_stop: result.automaticStop || false,
+                oscillation_enabled: result.oscillationEnabled || false,
                 configuration: result.configuration || {},
                 connection_status: result.connectionStatus || null
             };
@@ -546,6 +611,34 @@ class VeSyncHumidifier extends vesyncFan_1.VeSyncFan {
         }
         return success;
     }
+    /**
+     * Display device info
+     */
+    display() {
+        super.display();
+        const info = [
+            ['Current State: ', this.currentState],
+            ['Water Level: ', this.waterLevel, '%'],
+            ['Water Tank: ', this.waterTankLifted ? 'Lifted' : 'Seated'],
+            ['Oscillation: ', this.oscillationEnabled ? 'On' : 'Off']
+        ];
+        for (const [key, value, unit = ''] of info) {
+            logger_1.logger.info(`${key.toString().padEnd(30, '.')} ${value}${unit}`);
+        }
+    }
+    /**
+     * Return JSON details
+     */
+    displayJSON() {
+        const baseInfo = JSON.parse(super.displayJSON());
+        return JSON.stringify({
+            ...baseInfo,
+            'Current State': this.currentState,
+            'Water Level': this.waterLevel,
+            'Water Tank': this.waterTankLifted ? 'Lifted' : 'Seated',
+            'Oscillation': this.oscillationEnabled ? 'On' : 'Off'
+        }, null, 4);
+    }
     /**
      * Turn device on
      */
@@ -610,9 +703,9 @@ class VeSyncHumidifier extends vesyncFan_1.VeSyncFan {
      */
     async setMistLevel(level) {
         if (!this.mistLevels.includes(level)) {
-            const error = `Invalid mist level: ${level}. Must be one of: ${this.mistLevels.join(', ')}`;
-            logger_1.logger.error(`${error} for device: ${this.deviceName}`);
-            throw new Error(error);
+            logger_1.logger.debug(`Invalid mist level: ${level} for device: ${this.deviceName}`);
+            logger_1.logger.debug(`Valid levels for ${this.deviceType}: ${this.mistLevels.join(', ')}`);
+            return false;
         }
         logger_1.logger.info(`Setting mist level to ${level} for device: ${this.deviceName}`);
         const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', {
@@ -621,9 +714,9 @@ class VeSyncHumidifier extends vesyncFan_1.VeSyncFan {
             configModule: this.configModule,
             payload: {
                 data: {
-                    id: 0,
-                    level: level,
-                    type: 'mist'
+                    levelIdx: 0,
+                    virtualLevel: level,
+                    levelType: 'mist'
                 },
                 method: 'setVirtualLevel',
                 source: 'APP'
@@ -631,7 +724,7 @@ class VeSyncHumidifier extends vesyncFan_1.VeSyncFan {
         }, helpers_1.Helpers.reqHeaderBypass());
         const success = this.checkResponse([response, status], 'setMistLevel');
         if (!success) {
-            logger_1.logger.error(`Failed to set mist level to ${level} for device: ${this.deviceName}`);
+            logger_1.logger.debug('Error setting mist level');
         }
         return success;
     }
@@ -646,10 +739,11 @@ class VeSyncHumidifier extends vesyncFan_1.VeSyncFan {
      * Set device mode
      */
     async setMode(mode) {
-        if (!this.modes.includes(mode)) {
-            const error = `Invalid mode: ${mode}. Must be one of: ${this.modes.join(', ')}`;
-            logger_1.logger.error(`${error} for device: ${this.deviceName}`);
-            throw new Error(error);
+        const modeStr = mode.toLowerCase();
+        if (!this.modes.includes(modeStr)) {
+            logger_1.logger.debug(`Invalid humidity mode used - ${mode}`);
+            logger_1.logger.debug(`Proper modes for this device are - ${this.modes.join(', ')}`);
+            return false;
         }
         logger_1.logger.debug(`Setting mode to ${mode} for device: ${this.deviceName}`);
         const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', {
@@ -658,7 +752,7 @@ class VeSyncHumidifier extends vesyncFan_1.VeSyncFan {
             configModule: this.configModule,
             payload: {
                 data: {
-                    mode
+                    workMode: this.deviceType.startsWith('Superior') && modeStr === 'auto' ? 'autoPro' : modeStr
                 },
                 method: 'setHumidifierMode',
                 source: 'APP'
@@ -666,7 +760,7 @@ class VeSyncHumidifier extends vesyncFan_1.VeSyncFan {
         }, helpers_1.Helpers.reqHeaderBypass());
         const success = this.checkResponse([response, status], 'setMode');
         if (!success) {
-            logger_1.logger.error(`Failed to set mode to ${mode} for device: ${this.deviceName}`);
+            logger_1.logger.debug('Error setting humidity mode');
         }
         return success;
     }
@@ -916,10 +1010,11 @@ class VeSyncWarmHumidifier extends VeSyncHumidifier {
      * Set device mode
      */
     async setMode(mode) {
-        if (!this.modes.includes(mode)) {
-            const error = `Invalid mode: ${mode}. Must be one of: ${this.modes.join(', ')}`;
-            logger_1.logger.error(`${error} for device: ${this.deviceName}`);
-            throw new Error(error);
+        const modeStr = mode.toLowerCase();
+        if (!this.modes.includes(modeStr)) {
+            logger_1.logger.debug(`Invalid humidity mode used - ${mode}`);
+            logger_1.logger.debug(`Proper modes for this device are - ${this.modes.join(', ')}`);
+            return false;
         }
         logger_1.logger.debug(`Setting mode to ${mode} for device: ${this.deviceName}`);
         const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', {
@@ -928,18 +1023,15 @@ class VeSyncWarmHumidifier extends VeSyncHumidifier {
             configModule: this.configModule,
             payload: {
                 data: {
-                    mode
+                    workMode: this.deviceType.startsWith('Superior') && modeStr === 'auto' ? 'autoPro' : modeStr
                 },
                 method: 'setHumidifierMode',
                 source: 'APP'
             }
         }, helpers_1.Helpers.reqHeaderBypass());
         const success = this.checkResponse([response, status], 'setMode');
-        if (success) {
-            this.details.mode = mode;
-        }
-        else {
-            logger_1.logger.error(`Failed to set mode to ${mode} for device: ${this.deviceName}`);
+        if (!success) {
+            logger_1.logger.debug('Error setting humidity mode');
         }
         return success;
     }
@@ -948,14 +1040,13 @@ class VeSyncWarmHumidifier extends VeSyncHumidifier {
      */
     async setWarmLevel(level) {
         if (!this.hasFeature('warm')) {
-            const error = 'Warm mist control not supported';
-            logger_1.logger.error(`${error} for device: ${this.deviceName}`);
-            throw new Error(error);
+            logger_1.logger.debug('Warm mist control not supported');
+            return false;
         }
         if (!this.warmLevels.includes(level)) {
-            const error = `Invalid warm level: ${level}. Must be one of: ${this.warmLevels.join(', ')}`;
-            logger_1.logger.error(`${error} for device: ${this.deviceName}`);
-            throw new Error(error);
+            logger_1.logger.debug(`Invalid warm level: ${level} for device: ${this.deviceName}`);
+            logger_1.logger.debug(`Valid levels for ${this.deviceType}: ${this.warmLevels.join(', ')}`);
+            return false;
         }
         logger_1.logger.debug(`Setting warm level to ${level} for device: ${this.deviceName}`);
         const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', {
@@ -1094,6 +1185,7 @@ class VeSyncAirBaseV2 extends VeSyncAirBypass {
         const body = {
             ...helpers_1.Helpers.reqBody(this.manager, 'bypassV2'),
             cid: this.cid,
+            deviceId: this.cid, // Add deviceId to match YAML spec
             configModule: this.configModule,
             payload: {
                 method,
@@ -1502,6 +1594,7 @@ class VeSyncTowerFan extends VeSyncAirBaseV2 {
         const body = {
             ...helpers_1.Helpers.reqBody(this.manager, 'bypassV2'),
             cid: this.cid,
+            deviceId: this.cid, // Add deviceId to match YAML spec
             configModule: this.configModule,
             payload: {
                 method,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tsvesync",
-  "version": "1.0.52",
+  "version": "1.0.55",
   "description": "A TypeScript library for interacting with VeSync smart home devices",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/lib/vesyncFan.ts

@@ -200,101 +200,124 @@ export const fanConfig: FanConfig = {
     // Classic Series
     'Classic300S': {
         module: 'VeSyncHumidifier',
-        features: ['display', 'humidity', 'mist', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'Classic200S': {
         module: 'VeSyncHumidifier',
-        features: ['display', 'humidity', 'mist', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     
     // Dual Series
     'Dual200S': {
         module: 'VeSyncHumidifier',
-        features: ['display', 'humidity', 'mist', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'timer', 'auto_mode'],
+        levels: [1, 2]
     },
     
     // LUH Series
     'LUH-A601S-WUSB': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-A601S-AUSW': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-D301S-WUSR': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2]
     },
     'LUH-D301S-WJP': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2]
     },
     'LUH-D301S-WEU': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2]
     },
     'LUH-A602S-WUSR': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-A602S-WUS': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-A602S-WEUR': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-A602S-WEU': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-A602S-WJP': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-A602S-WUSC': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-O451S-WEU': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-O451S-WUS': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-O451S-WUSR': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-O601S-WUS': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-O601S-KUS': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-M101S-WUS': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LUH-M101S-WEUR': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     
     // LEH Series
     'LEH-S601S-WUS': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode', 'drying']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode', 'drying'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     'LEH-S601S-WUSR': {
         module: 'VeSyncWarmHumidifier',
-        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode', 'drying']
+        features: ['display', 'humidity', 'mist', 'warm', 'timer', 'auto_mode', 'drying'],
+        levels: [1, 2, 3, 4, 5, 6, 7, 8, 9]
     },
     
     // LV Series

package/src/lib/vesyncFanImpl.ts

@@ -28,6 +28,7 @@ export class VeSyncAirBypass extends VeSyncFan {
         const body = {
             ...Helpers.reqBody(this.manager, 'bypassV2'),
             cid: this.cid,
+            deviceId: this.cid,  // Add deviceId to match YAML spec
             configModule: this.configModule,
             payload: {
                 method,
@@ -257,9 +258,11 @@ export class VeSyncAirBypass extends VeSyncFan {
      * Change fan speed
      */
     async changeFanSpeed(speed: number): Promise<boolean> {
-        const speeds = this.config.levels ?? [];
-        if (!speeds.includes(speed)) {
-            logger.error(`Invalid speed: ${speed}. Must be one of: ${speeds.join(', ')} for device: ${this.deviceName}`);
+        logger.debug(`Attempting to change fan speed to ${speed} for device: ${this.deviceName}`);
+        logger.debug(`Available speeds: ${this.config.levels?.join(', ')}`);
+
+        if (!this.config.levels?.includes(speed)) {
+            logger.error(`Invalid speed: ${speed}. Must be one of: ${this.config.levels?.join(', ')} for device: ${this.deviceName}`);
             return false;
         }
 
@@ -296,10 +299,11 @@ export class VeSyncAirBypass extends VeSyncFan {
      * Set device mode
      */
     async setMode(mode: string): Promise<boolean> {
-        if (!this.modes.includes(mode as any)) {
-            const error = `Invalid mode: ${mode}. Must be one of: ${this.modes.join(', ')}`;
-            logger.error(`${error} for device: ${this.deviceName}`);
-            throw new Error(error);
+        const modeStr = mode.toLowerCase();
+        if (!this.modes.includes(modeStr as any)) {
+            logger.debug(`Invalid humidity mode used - ${mode}`);
+            logger.debug(`Proper modes for this device are - ${this.modes.join(', ')}`);
+            return false;
         }
 
         logger.debug(`Setting mode to ${mode} for device: ${this.deviceName}`);
@@ -312,9 +316,9 @@ export class VeSyncAirBypass extends VeSyncFan {
                 configModule: this.configModule,
                 payload: {
                     data: {
-                        mode
+                        workMode: this.deviceType.startsWith('Superior') && modeStr === 'auto' ? 'autoPro' : modeStr
                     },
-                    method: 'setPurifierMode',
+                    method: 'setHumidifierMode',
                     source: 'APP'
                 }
             },
@@ -323,7 +327,7 @@ export class VeSyncAirBypass extends VeSyncFan {
 
         const success = this.checkResponse([response, status], 'setMode');
         if (!success) {
-            logger.error(`Failed to set mode to ${mode} for device: ${this.deviceName}`);
+            logger.debug('Error setting humidity mode');
         }
         return success;
     }
@@ -600,6 +604,7 @@ export class VeSyncHumidifier extends VeSyncFan {
     protected readonly mistLevels: number[];
     protected readonly displayModes = ['on', 'off'] as const;
     protected readonly humidityRange = { min: 30, max: 80 };
+    protected readonly states = ['inactive', 'idle', 'humidifying'] as const;
 
     constructor(details: Record<string, any>, manager: VeSync) {
         super(details, manager);
@@ -618,6 +623,75 @@ export class VeSyncHumidifier extends VeSyncFan {
         logger.debug(`Initialized VeSyncHumidifier device: ${this.deviceName}`);
     }
 
+    /**
+     * Get current operational state
+     */
+    get currentState(): string {
+        if (this.deviceStatus === 'off') {
+            return 'inactive';
+        }
+        if (this.details.water_lacks) {
+            return 'idle';
+        }
+        return 'humidifying';
+    }
+
+    /**
+     * Get water level percentage
+     */
+    get waterLevel(): number {
+        return this.details.water_level ?? 0;
+    }
+
+    /**
+     * Get water tank status
+     */
+    get waterTankLifted(): boolean {
+        return this.details.water_tank_lifted ?? false;
+    }
+
+    /**
+     * Get oscillation state
+     */
+    get oscillationEnabled(): boolean {
+        return this.details.oscillation_enabled ?? false;
+    }
+
+    /**
+     * Set oscillation state
+     */
+    async setOscillation(enabled: boolean): Promise<boolean> {
+        if (!this.hasFeature('oscillation')) {
+            logger.debug('Oscillation not supported');
+            return false;
+        }
+
+        logger.debug(`Setting oscillation to ${enabled ? 'on' : 'off'} for device: ${this.deviceName}`);
+        const [response, status] = await this.callApi(
+            '/cloud/v2/deviceManaged/bypassV2',
+            'post',
+            {
+                ...Helpers.reqBody(this.manager, 'bypassV2'),
+                cid: this.cid,
+                configModule: this.configModule,
+                payload: {
+                    data: {
+                        oscillationEnabled: enabled
+                    },
+                    method: 'setSwing',
+                    source: 'APP'
+                }
+            },
+            Helpers.reqHeaderBypass()
+        );
+
+        const success = this.checkResponse([response, status], 'setOscillation');
+        if (!success) {
+            logger.debug('Error setting oscillation');
+        }
+        return success;
+    }
+
     /**
      * Get device details
      */
@@ -655,12 +729,13 @@ export class VeSyncHumidifier extends VeSyncFan {
                 humidity: result.humidity || 0,
                 mist_level: result.mistLevel || 0,
                 mist_virtual_level: result.virtualLevel || 0,
-                warm_level: result.warmLevel || 0,
                 water_lacks: result.waterLacks || false,
-                humidity_high: result.humidityHigh || false,
+                water_level: result.waterLevel || 0,
                 water_tank_lifted: result.waterTankLifted || false,
+                humidity_high: result.humidityHigh || false,
                 display: result.display || false,
                 automatic_stop: result.automaticStop || false,
+                oscillation_enabled: result.oscillationEnabled || false,
                 configuration: result.configuration || {},
                 connection_status: result.connectionStatus || null
             };
@@ -669,6 +744,37 @@ export class VeSyncHumidifier extends VeSyncFan {
         return success;
     }
 
+    /**
+     * Display device info
+     */
+    override display(): void {
+        super.display();
+        const info = [
+            ['Current State: ', this.currentState],
+            ['Water Level: ', this.waterLevel, '%'],
+            ['Water Tank: ', this.waterTankLifted ? 'Lifted' : 'Seated'],
+            ['Oscillation: ', this.oscillationEnabled ? 'On' : 'Off']
+        ];
+
+        for (const [key, value, unit = ''] of info) {
+            logger.info(`${key.toString().padEnd(30, '.')} ${value}${unit}`);
+        }
+    }
+
+    /**
+     * Return JSON details
+     */
+    override displayJSON(): string {
+        const baseInfo = JSON.parse(super.displayJSON());
+        return JSON.stringify({
+            ...baseInfo,
+            'Current State': this.currentState,
+            'Water Level': this.waterLevel,
+            'Water Tank': this.waterTankLifted ? 'Lifted' : 'Seated',
+            'Oscillation': this.oscillationEnabled ? 'On' : 'Off'
+        }, null, 4);
+    }
+
     /**
      * Turn device on
      */
@@ -740,9 +846,9 @@ export class VeSyncHumidifier extends VeSyncFan {
      */
     async setMistLevel(level: number): Promise<boolean> {
         if (!this.mistLevels.includes(level)) {
-            const error = `Invalid mist level: ${level}. Must be one of: ${this.mistLevels.join(', ')}`;
-            logger.error(`${error} for device: ${this.deviceName}`);
-            throw new Error(error);
+            logger.debug(`Invalid mist level: ${level} for device: ${this.deviceName}`);
+            logger.debug(`Valid levels for ${this.deviceType}: ${this.mistLevels.join(', ')}`);
+            return false;
         }
 
         logger.info(`Setting mist level to ${level} for device: ${this.deviceName}`);
@@ -755,9 +861,9 @@ export class VeSyncHumidifier extends VeSyncFan {
                 configModule: this.configModule,
                 payload: {
                     data: {
-                        id: 0,
-                        level: level,
-                        type: 'mist'
+                        levelIdx: 0,
+                        virtualLevel: level,
+                        levelType: 'mist'
                     },
                     method: 'setVirtualLevel',
                     source: 'APP'
@@ -768,7 +874,7 @@ export class VeSyncHumidifier extends VeSyncFan {
 
         const success = this.checkResponse([response, status], 'setMistLevel');
         if (!success) {
-            logger.error(`Failed to set mist level to ${level} for device: ${this.deviceName}`);
+            logger.debug('Error setting mist level');
         }
         return success;
     }
@@ -785,10 +891,11 @@ export class VeSyncHumidifier extends VeSyncFan {
      * Set device mode
      */
     async setMode(mode: string): Promise<boolean> {
-        if (!this.modes.includes(mode as any)) {
-            const error = `Invalid mode: ${mode}. Must be one of: ${this.modes.join(', ')}`;
-            logger.error(`${error} for device: ${this.deviceName}`);
-            throw new Error(error);
+        const modeStr = mode.toLowerCase();
+        if (!this.modes.includes(modeStr as any)) {
+            logger.debug(`Invalid humidity mode used - ${mode}`);
+            logger.debug(`Proper modes for this device are - ${this.modes.join(', ')}`);
+            return false;
         }
 
         logger.debug(`Setting mode to ${mode} for device: ${this.deviceName}`);
@@ -801,7 +908,7 @@ export class VeSyncHumidifier extends VeSyncFan {
                 configModule: this.configModule,
                 payload: {
                     data: {
-                        mode
+                        workMode: this.deviceType.startsWith('Superior') && modeStr === 'auto' ? 'autoPro' : modeStr
                     },
                     method: 'setHumidifierMode',
                     source: 'APP'
@@ -812,7 +919,7 @@ export class VeSyncHumidifier extends VeSyncFan {
 
         const success = this.checkResponse([response, status], 'setMode');
         if (!success) {
-            logger.error(`Failed to set mode to ${mode} for device: ${this.deviceName}`);
+            logger.debug('Error setting humidity mode');
         }
         return success;
     }
@@ -1117,10 +1224,11 @@ export class VeSyncWarmHumidifier extends VeSyncHumidifier {
      * Set device mode
      */
     async setMode(mode: string): Promise<boolean> {
-        if (!this.modes.includes(mode as any)) {
-            const error = `Invalid mode: ${mode}. Must be one of: ${this.modes.join(', ')}`;
-            logger.error(`${error} for device: ${this.deviceName}`);
-            throw new Error(error);
+        const modeStr = mode.toLowerCase();
+        if (!this.modes.includes(modeStr as any)) {
+            logger.debug(`Invalid humidity mode used - ${mode}`);
+            logger.debug(`Proper modes for this device are - ${this.modes.join(', ')}`);
+            return false;
         }
 
         logger.debug(`Setting mode to ${mode} for device: ${this.deviceName}`);
@@ -1133,7 +1241,7 @@ export class VeSyncWarmHumidifier extends VeSyncHumidifier {
                 configModule: this.configModule,
                 payload: {
                     data: {
-                        mode
+                        workMode: this.deviceType.startsWith('Superior') && modeStr === 'auto' ? 'autoPro' : modeStr
                     },
                     method: 'setHumidifierMode',
                     source: 'APP'
@@ -1143,10 +1251,8 @@ export class VeSyncWarmHumidifier extends VeSyncHumidifier {
         );
 
         const success = this.checkResponse([response, status], 'setMode');
-        if (success) {
-            this.details.mode = mode;
-        } else {
-            logger.error(`Failed to set mode to ${mode} for device: ${this.deviceName}`);
+        if (!success) {
+            logger.debug('Error setting humidity mode');
         }
         return success;
     }
@@ -1156,15 +1262,14 @@ export class VeSyncWarmHumidifier extends VeSyncHumidifier {
      */
     async setWarmLevel(level: number): Promise<boolean> {
         if (!this.hasFeature('warm')) {
-            const error = 'Warm mist control not supported';
-            logger.error(`${error} for device: ${this.deviceName}`);
-            throw new Error(error);
+            logger.debug('Warm mist control not supported');
+            return false;
         }
 
         if (!this.warmLevels.includes(level)) {
-            const error = `Invalid warm level: ${level}. Must be one of: ${this.warmLevels.join(', ')}`;
-            logger.error(`${error} for device: ${this.deviceName}`);
-            throw new Error(error);
+            logger.debug(`Invalid warm level: ${level} for device: ${this.deviceName}`);
+            logger.debug(`Valid levels for ${this.deviceType}: ${this.warmLevels.join(', ')}`);
+            return false;
         }
 
         logger.debug(`Setting warm level to ${level} for device: ${this.deviceName}`);
@@ -1330,6 +1435,7 @@ export class VeSyncAirBaseV2 extends VeSyncAirBypass {
         const body = {
             ...Helpers.reqBody(this.manager, 'bypassV2'),
             cid: this.cid,
+            deviceId: this.cid,  // Add deviceId to match YAML spec
             configModule: this.configModule,
             payload: {
                 method,
@@ -1850,6 +1956,7 @@ export class VeSyncTowerFan extends VeSyncAirBaseV2 {
         const body = {
             ...Helpers.reqBody(this.manager, 'bypassV2'),
             cid: this.cid,
+            deviceId: this.cid,  // Add deviceId to match YAML spec
             configModule: this.configModule,
             payload: {
                 method,