tsvesync 1.3.12 → 1.4.0

package/dist/lib/fans/air131.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VeSyncAir131 = void 0;
 const vesyncFan_1 = require("../vesyncFan");
+const helpers_1 = require("../helpers");
 const logger_1 = require("../logger");
 /**
  * VeSync Air Purifier 131 Series (LV-PUR131S, LV-RH131S)
@@ -78,6 +79,7 @@ class VeSyncAir131 extends vesyncFan_1.VeSyncFan {
                     logger_1.logger.debug(`${this.deviceName}: API response structure:`, JSON.stringify(data, null, 2));
                 }
             }
+            const normalizedAirQuality = helpers_1.Helpers.normalizeAirQuality(data.airQuality);
             this.details = {
                 mode: data.mode || 'manual', // Default to manual if not specified
                 speed: data.level || 0,
@@ -86,6 +88,8 @@ class VeSyncAir131 extends vesyncFan_1.VeSyncFan {
                 child_lock: data.childLock || false,
                 air_quality: data.airQuality || 'unknown',
                 air_quality_value: data.air_quality_value || 0,
+                air_quality_level: normalizedAirQuality.level >= 1 ? normalizedAirQuality.level : undefined,
+                air_quality_label: normalizedAirQuality.label,
                 active_time: data.activeTime || 0
             };
             // Store last known speed when device is on and has a valid speed

package/dist/lib/fans/airBaseV2.d.ts

@@ -57,6 +57,14 @@ export declare class VeSyncAirBaseV2 extends VeSyncAirBypass {
      * Override setMode to send workMode payloads for bypassV2 purifiers.
      */
     setMode(mode: string): Promise<boolean>;
+    /**
+     * Convenience helper to enter turbo mode when supported.
+     */
+    turboMode(): Promise<boolean>;
+    /**
+     * Convenience helper to enter pet mode when supported.
+     */
+    petMode(): Promise<boolean>;
     /**
      * Override changeFanSpeed to use manualSpeedLevel for bypassV2 purifiers.
      */

package/dist/lib/fans/airBaseV2.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VeSyncAirBaseV2 = void 0;
 const airBypass_1 = require("./airBypass");
 const logger_1 = require("../logger");
+const helpers_1 = require("../helpers");
 /**
  * VeSync Air Purifier with Bypass V2
  */
@@ -12,11 +13,11 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
         this._lightDetection = false;
         this._lightDetectionState = false;
         this.setSpeedLevel = null;
-        this.autoPreferences = ['default', 'efficient', 'quiet'];
         this.enabled = false;
         this._mode = '';
         this._speed = 0;
         this._timer = null;
+        this.autoPreferences = [...this.getConfigAutoPreferences(['default', 'efficient', 'quiet'])];
         logger_1.logger.debug(`Initialized VeSyncAirBaseV2 device: ${this.deviceName}`);
     }
     buildConfigDict(configDict) {
@@ -163,6 +164,11 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
         if (this.hasFeature('air_quality')) {
             this.details.air_quality_value = (_l = devDict.PM25) !== null && _l !== void 0 ? _l : 0;
             this.details.air_quality = (_m = devDict.AQLevel) !== null && _m !== void 0 ? _m : 0;
+            const normalizedAirQuality = helpers_1.Helpers.normalizeAirQuality(devDict.AQLevel);
+            if (normalizedAirQuality.level >= 1) {
+                this.details.air_quality_level = normalizedAirQuality.level;
+            }
+            this.details.air_quality_label = normalizedAirQuality.label;
         }
         if ('PM1' in devDict)
             this.details.pm1 = devDict.PM1;
@@ -259,28 +265,63 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
      * Override setMode to send workMode payloads for bypassV2 purifiers.
      */
     async setMode(mode) {
-        if (!this.modes.includes(mode)) {
+        var _a, _b;
+        const targetMode = mode.toLowerCase();
+        const supportedModes = this.modes.map(m => m.toLowerCase());
+        if (!supportedModes.includes(targetMode)) {
             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);
         }
         // Special handling for Core200S stays the same for all models
-        if (this.deviceType.includes('Core200S') && mode === 'auto') {
+        if (this.deviceType.includes('Core200S') && targetMode === 'auto') {
             logger_1.logger.warn(`Auto mode not supported for ${this.deviceType}, using manual mode instead`);
             return this.setMode('manual');
         }
+        // Manual mode should leverage changeFanSpeed to mirror pyvesync behaviour
+        if (targetMode === 'manual') {
+            const defaultLevel = this.config.levels && this.config.levels.length > 0
+                ? this.config.levels[0]
+                : 1;
+            const desiredLevel = (_b = (_a = this.details.manualSpeedLevel) !== null && _a !== void 0 ? _a : this.speed) !== null && _b !== void 0 ? _b : defaultLevel;
+            const success = await this.changeFanSpeed(desiredLevel);
+            if (success) {
+                this.details.mode = 'manual';
+                this.mode = 'manual';
+            }
+            return success;
+        }
         // BypassV2 purifiers need the workMode payload; other models use the base implementation
         if (this.requiresPowerSwitchPayload()) {
             logger_1.logger.debug(`Using bypassV2 mode payload for ${this.deviceName}`);
             const [head, body] = this.buildApiDict('setPurifierMode');
             body.payload.data = {
-                workMode: mode
+                workMode: targetMode
             };
             const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', body, head);
             const success = this.checkV2Response(response, status, 'setMode');
             if (success) {
-                this.details.mode = mode;
-                this._mode = mode;
+                this.details.mode = targetMode;
+                this.mode = targetMode;
+                // Update cached speed snapshot for special modes
+                if (targetMode === 'sleep') {
+                    this.speed = 0;
+                    this.details.speed = 0;
+                }
+                else if (targetMode === 'turbo') {
+                    const maxSpeed = this.config.levels && this.config.levels.length > 0
+                        ? Math.max(...this.config.levels)
+                        : this.speed;
+                    if (typeof maxSpeed === 'number' && maxSpeed > 0) {
+                        this.speed = maxSpeed;
+                        this.details.speed = maxSpeed;
+                    }
+                }
+                else if (targetMode === 'auto') {
+                    this.speed = 0;
+                    this.details.speed = 0;
+                    this.details.isAutoSentinel = true;
+                }
                 // Force a details update to sync state
                 setTimeout(() => {
                     this.getDetails().catch(e => {
@@ -290,7 +331,7 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
                 return true;
             }
             else {
-                logger_1.logger.error(`Failed to set mode to ${mode} for device: ${this.deviceName}`);
+                logger_1.logger.error(`Failed to set mode to ${targetMode} for device: ${this.deviceName}`);
                 return false;
             }
         }
@@ -299,6 +340,26 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
             return super.setMode(mode);
         }
     }
+    /**
+     * Convenience helper to enter turbo mode when supported.
+     */
+    async turboMode() {
+        if (!this.modes.map(m => m.toLowerCase()).includes('turbo')) {
+            logger_1.logger.debug(`Turbo mode not supported for device: ${this.deviceName}`);
+            return false;
+        }
+        return this.setMode('turbo');
+    }
+    /**
+     * Convenience helper to enter pet mode when supported.
+     */
+    async petMode() {
+        if (!this.modes.map(m => m.toLowerCase()).includes('pet')) {
+            logger_1.logger.debug(`Pet mode not supported for device: ${this.deviceName}`);
+            return false;
+        }
+        return this.setMode('pet');
+    }
     /**
      * Override changeFanSpeed to use manualSpeedLevel for bypassV2 purifiers.
      */
@@ -325,6 +386,10 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
             if (success) {
                 this.speed = speed;
                 this.details.manualSpeedLevel = speed;
+                this.details.speed = speed;
+                this.details.mode = 'manual';
+                this.mode = 'manual';
+                this.details.isAutoSentinel = false;
                 // Force a details update to sync state
                 setTimeout(() => {
                     this.getDetails().catch(e => {
@@ -351,6 +416,10 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
             if (success) {
                 this.speed = speed;
                 this.details.manualSpeedLevel = speed;
+                this.details.speed = speed;
+                this.details.mode = 'manual';
+                this.mode = 'manual';
+                this.details.isAutoSentinel = false;
                 return true;
             }
             else {
@@ -364,7 +433,7 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
      */
     async setAutoPreference(preference = 'default', roomSize = 600) {
         if (!this.autoPreferences.includes(preference)) {
-            logger_1.logger.debug(`Invalid preference: ${preference} - valid preferences are default, efficient, quiet`);
+            logger_1.logger.debug(`Invalid preference: ${preference} - valid preferences are ${this.autoPreferences.join(', ')}`);
             return false;
         }
         const [head, body] = this.buildApiDict('setAutoPreference');

package/dist/lib/fans/airBypass.d.ts

@@ -4,7 +4,7 @@ import { VeSync } from '../vesync';
  * VeSync Air Purifier with Bypass
  */
 export declare class VeSyncAirBypass extends VeSyncFan {
-    protected readonly modes: readonly ["auto", "manual", "sleep"];
+    protected get modes(): ReadonlyArray<string>;
     protected readonly displayModes: readonly ["on", "off"];
     protected readonly childLockModes: readonly ["on", "off"];
     constructor(details: Record<string, any>, manager: VeSync);

package/dist/lib/fans/airBypass.js

@@ -8,9 +8,11 @@ const logger_1 = require("../logger");
  * VeSync Air Purifier with Bypass
  */
 class VeSyncAirBypass extends vesyncFan_1.VeSyncFan {
+    get modes() {
+        return this.getConfigModes(['auto', 'manual', 'sleep']);
+    }
     constructor(details, manager) {
         super(details, manager);
-        this.modes = ['auto', 'manual', 'sleep'];
         this.displayModes = ['on', 'off'];
         this.childLockModes = ['on', 'off'];
         logger_1.logger.debug(`Initialized VeSyncAirBypass device: ${this.deviceName}`);
@@ -78,6 +80,11 @@ class VeSyncAirBypass extends vesyncFan_1.VeSyncFan {
                     air_quality: result.air_quality || 0,
                     air_quality_value: result.air_quality_value || 0
                 };
+                const normalizedAirQuality = helpers_1.Helpers.normalizeAirQuality(result.air_quality);
+                if (normalizedAirQuality.level >= 1) {
+                    this.details.air_quality_level = normalizedAirQuality.level;
+                }
+                this.details.air_quality_label = normalizedAirQuality.label;
                 // Capture additional air quality properties if available
                 if ('PM1' in result)
                     this.details.pm1 = result.PM1;
@@ -178,14 +185,17 @@ class VeSyncAirBypass extends vesyncFan_1.VeSyncFan {
      * Set device mode
      */
     async setMode(mode) {
-        if (!this.modes.includes(mode)) {
+        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_1.logger.error(`${error} for device: ${this.deviceName}`);
             throw new Error(error);
         }
-        logger_1.logger.debug(`Setting mode to ${mode} for device: ${this.deviceName}`);
+        logger_1.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_1.logger.warn(`Auto mode not supported for ${this.deviceType}, using manual mode instead`);
             return this.setMode('manual');
@@ -197,7 +207,7 @@ class VeSyncAirBypass extends vesyncFan_1.VeSyncFan {
             configModule: this.configModule,
             payload: {
                 data: {
-                    mode
+                    mode: requested
                 },
                 method: 'setPurifierMode',
                 source: 'APP'
@@ -205,11 +215,11 @@ class VeSyncAirBypass extends vesyncFan_1.VeSyncFan {
         }, helpers_1.Helpers.reqHeaderBypass());
         const success = this.checkResponse([response, status], 'setMode');
         if (success) {
-            this.details.mode = mode;
+            this.details.mode = requested;
             return true;
         }
         else {
-            logger_1.logger.error(`Failed to set mode to ${mode} for device: ${this.deviceName}`);
+            logger_1.logger.error(`Failed to set mode to ${requested} for device: ${this.deviceName}`);
             return false;
         }
     }

package/dist/lib/helpers.d.ts

@@ -106,6 +106,10 @@ export interface LoginResponse {
 export declare class Helpers {
     static shouldRedact: boolean;
     static generateTraceId(): string;
+    static normalizeAirQuality(value: unknown): {
+        level: number;
+        label: string;
+    };
     /**
      * Calculate MD5 hash
      */

package/dist/lib/helpers.js

@@ -182,6 +182,50 @@ class Helpers {
     static generateTraceId() {
         return generateTraceId();
     }
+    static normalizeAirQuality(value) {
+        const stringMap = {
+            'excellent': 1,
+            'very good': 1,
+            'good': 2,
+            'moderate': 3,
+            'fair': 3,
+            'inferior': 4,
+            'poor': 4,
+            'bad': 4,
+        };
+        if (typeof value === 'number') {
+            const level = Number.isFinite(value) ? Math.trunc(value) : -1;
+            if (level >= 1 && level <= 4) {
+                return {
+                    level,
+                    label: level === 1
+                        ? 'excellent'
+                        : level === 2
+                            ? 'good'
+                            : level === 3
+                                ? 'moderate'
+                                : 'poor',
+                };
+            }
+        }
+        else if (typeof value === 'string') {
+            const normalized = value.trim().toLowerCase();
+            const level = stringMap[normalized];
+            if (level) {
+                return {
+                    level,
+                    label: level === 1
+                        ? 'excellent'
+                        : level === 2
+                            ? 'good'
+                            : level === 3
+                                ? 'moderate'
+                                : 'poor',
+                };
+            }
+        }
+        return { level: -1, label: 'unknown' };
+    }
     /**
      * Calculate MD5 hash
      */

package/dist/lib/vesyncFan.d.ts

@@ -3,12 +3,15 @@
  */
 import { VeSyncBaseDevice } from './vesyncBaseDevice';
 import { VeSync } from './vesync';
+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;
 }
 export declare const fanConfig: FanConfig;
 /**
@@ -25,6 +28,8 @@ export declare abstract class VeSyncFan extends VeSyncBaseDevice {
         child_lock?: boolean;
         air_quality?: string | number;
         air_quality_value?: number;
+        air_quality_level?: number;
+        air_quality_label?: string;
         pm1?: number;
         pm10?: number;
         aq_percent?: number;
@@ -40,16 +45,28 @@ export declare abstract class VeSyncFan extends VeSyncBaseDevice {
         duration: number;
         action: string;
     } | 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);
     /**
      * Check if feature is supported
      */
     hasFeature(feature: string): boolean;
+    /**
+     * Get configured modes for the device, falling back to provided defaults.
+     */
+    protected getConfigModes(defaultModes?: ReadonlyArray<string>): ReadonlyArray<string>;
+    /**
+     * Get configured auto preferences for the device, falling back to provided defaults.
+     */
+    protected getConfigAutoPreferences(defaultPreferences?: ReadonlyArray<string>): ReadonlyArray<string>;
+    /**
+     * Public accessor for supported modes for consumers that need to inspect capability metadata.
+     */
+    getSupportedModes(defaultModes?: ReadonlyArray<string>): ReadonlyArray<string>;
+    /**
+     * Public accessor for supported auto preference profiles.
+     */
+    getSupportedAutoPreferences(defaultPreferences?: ReadonlyArray<string>): ReadonlyArray<string>;
     /**
      * Check if feature is supported in current mode
      */
@@ -90,6 +107,13 @@ export declare abstract class VeSyncFan extends VeSyncBaseDevice {
      * Get air quality value - PM2.5 in μg/m³ (if supported)
      */
     get airQualityValue(): number;
+    /**
+     * Normalized air quality metadata aligned with pyvesync levels.
+     */
+    getNormalizedAirQuality(): {
+        level: number;
+        label: string;
+    };
     /**
      * Get PM1 value (if supported)
      */