tsvesync 1.3.12 → 1.3.13

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.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
  */
@@ -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;

package/dist/lib/fans/airBypass.js

@@ -78,6 +78,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;

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

@@ -25,6 +25,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;
@@ -90,6 +92,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)
      */

package/dist/lib/vesyncFan.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VeSyncFan = exports.fanConfig = void 0;
 const vesyncBaseDevice_1 = require("./vesyncBaseDevice");
 const logger_1 = require("./logger");
+const helpers_1 = require("./helpers");
 // Fan configuration
 exports.fanConfig = {
     // Core Series
@@ -418,6 +419,22 @@ class VeSyncFan extends vesyncBaseDevice_1.VeSyncBaseDevice {
         var _a;
         return (_a = this.details.air_quality_value) !== null && _a !== void 0 ? _a : 0;
     }
+    /**
+     * Normalized air quality metadata aligned with pyvesync levels.
+     */
+    getNormalizedAirQuality() {
+        var _a;
+        if (typeof this.details.air_quality_level === 'number' && this.details.air_quality_level >= 1) {
+            const label = (_a = this.details.air_quality_label) !== null && _a !== void 0 ? _a : helpers_1.Helpers.normalizeAirQuality(this.details.air_quality_level).label;
+            return { level: this.details.air_quality_level, label };
+        }
+        const normalized = helpers_1.Helpers.normalizeAirQuality(this.details.air_quality);
+        if (normalized.level >= 1) {
+            this.details.air_quality_level = normalized.level;
+            this.details.air_quality_label = normalized.label;
+        }
+        return normalized;
+    }
     /**
      * Get PM1 value (if supported)
      */

package/package.json

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

package/src/lib/fans/air131.ts

@@ -88,6 +88,8 @@ export class VeSyncAir131 extends VeSyncFan {
                 }
             }
 
+            const normalizedAirQuality = Helpers.normalizeAirQuality(data.airQuality);
+
             this.details = {
                 mode: data.mode || 'manual',  // Default to manual if not specified
                 speed: data.level || 0,
@@ -96,6 +98,8 @@ export class VeSyncAir131 extends 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
             };
             

package/src/lib/fans/airBaseV2.ts

@@ -1,6 +1,7 @@
 import { VeSyncAirBypass } from './airBypass';
 import { VeSync } from '../vesync';
 import { logger } from '../logger';
+import { Helpers } from '../helpers';
 
 /**
  * VeSync Air Purifier with Bypass V2
@@ -189,6 +190,11 @@ export class VeSyncAirBaseV2 extends VeSyncAirBypass {
         if (this.hasFeature('air_quality')) {
             this.details.air_quality_value = devDict.PM25 ?? 0;
             this.details.air_quality = devDict.AQLevel ?? 0;
+            const normalizedAirQuality = 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;

package/src/lib/fans/airBypass.ts

@@ -87,6 +87,12 @@ export class VeSyncAirBypass extends VeSyncFan {
                     air_quality_value: result.air_quality_value || 0
                 };
 
+                const normalizedAirQuality = 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;
                 if ('PM10' in result) this.details.pm10 = result.PM10;

package/src/lib/helpers.ts

@@ -245,6 +245,52 @@ export class Helpers {
         return generateTraceId();
     }
 
+    static normalizeAirQuality(value: unknown): { level: number; label: string } {
+        const stringMap: Record<string, number> = {
+            '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/src/lib/vesyncFan.ts

@@ -5,6 +5,7 @@
 import { VeSyncBaseDevice } from './vesyncBaseDevice';
 import { VeSync } from './vesync';
 import { logger } from './logger';
+import { Helpers } from './helpers';
 
 interface FanConfig {
     [key: string]: {
@@ -327,6 +328,8 @@ export 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;
@@ -468,6 +471,23 @@ export abstract class VeSyncFan extends VeSyncBaseDevice {
         return this.details.air_quality_value ?? 0;
     }
 
+    /**
+     * Normalized air quality metadata aligned with pyvesync levels.
+     */
+    getNormalizedAirQuality(): { level: number; label: string } {
+        if (typeof this.details.air_quality_level === 'number' && this.details.air_quality_level >= 1) {
+            const label = this.details.air_quality_label ?? Helpers.normalizeAirQuality(this.details.air_quality_level).label;
+            return { level: this.details.air_quality_level, label };
+        }
+
+        const normalized = Helpers.normalizeAirQuality(this.details.air_quality);
+        if (normalized.level >= 1) {
+            this.details.air_quality_level = normalized.level;
+            this.details.air_quality_label = normalized.label;
+        }
+        return normalized;
+    }
+
     /**
      * Get PM1 value (if supported)
      */