tsvesync 1.0.90 → 1.0.91

package/dist/lib/vesyncFan.js

@@ -375,7 +375,14 @@ class VeSyncFan extends vesyncBaseDevice_1.VeSyncBaseDevice {
      */
     get filterLife() {
         var _a;
-        return (_a = this.details.filter_life) !== null && _a !== void 0 ? _a : 0;
+        // Handle different filter_life formats from different devices
+        const filterLife = this.details.filter_life;
+        // For Air131 devices, filter_life is an object with percent property
+        if (typeof filterLife === 'object' && filterLife !== null && 'percent' in filterLife) {
+            return (_a = filterLife.percent) !== null && _a !== void 0 ? _a : 0;
+        }
+        // For other devices, filter_life is a direct number
+        return typeof filterLife === 'number' ? filterLife : 0;
     }
     /**
      * Get screen status
@@ -392,12 +399,46 @@ class VeSyncFan extends vesyncBaseDevice_1.VeSyncBaseDevice {
         return (_a = this.details.child_lock) !== null && _a !== void 0 ? _a : false;
     }
     /**
-     * Get air quality (if supported)
+     * Get air quality level (if supported)
      */
-    get airQuality() {
+    get airQualityLevel() {
         var _a;
         return (_a = this.details.air_quality) !== null && _a !== void 0 ? _a : '';
     }
+    /**
+     * Get air quality (alias for airQualityLevel for backward compatibility)
+     */
+    get airQuality() {
+        return this.airQualityLevel;
+    }
+    /**
+     * Get air quality value - PM2.5 in μg/m³ (if supported)
+     */
+    get airQualityValue() {
+        var _a;
+        return (_a = this.details.air_quality_value) !== null && _a !== void 0 ? _a : 0;
+    }
+    /**
+     * Get PM1 value (if supported)
+     */
+    get pm1() {
+        var _a;
+        return (_a = this.details.pm1) !== null && _a !== void 0 ? _a : 0;
+    }
+    /**
+     * Get PM10 value (if supported)
+     */
+    get pm10() {
+        var _a;
+        return (_a = this.details.pm10) !== null && _a !== void 0 ? _a : 0;
+    }
+    /**
+     * Get air quality percentage (if supported)
+     */
+    get aqPercent() {
+        var _a;
+        return (_a = this.details.aq_percent) !== null && _a !== void 0 ? _a : 0;
+    }
     /**
      * Get humidity level (if supported)
      */
@@ -445,7 +486,19 @@ class VeSyncFan extends vesyncBaseDevice_1.VeSyncBaseDevice {
             info.push(['Child Lock: ', this.childLock ? 'Enabled' : 'Disabled']);
         }
         if (this.hasFeature('air_quality')) {
-            info.push(['Air Quality: ', this.airQuality]);
+            info.push(['Air Quality Level: ', this.airQualityLevel]);
+            if (this.airQualityValue > 0) {
+                info.push(['Air Quality Value: ', this.airQualityValue, ' μg/m³']);
+            }
+            if (this.pm1 > 0) {
+                info.push(['PM1: ', this.pm1, ' μg/m³']);
+            }
+            if (this.pm10 > 0) {
+                info.push(['PM10: ', this.pm10, ' μg/m³']);
+            }
+            if (this.aqPercent > 0) {
+                info.push(['AQ Percent: ', this.aqPercent, '%']);
+            }
         }
         if (this.hasFeature('humidity')) {
             info.push(['Humidity: ', this.humidity, '%']);
@@ -486,7 +539,19 @@ class VeSyncFan extends vesyncBaseDevice_1.VeSyncBaseDevice {
             details['Child Lock'] = this.childLock ? 'Enabled' : 'Disabled';
         }
         if (this.hasFeature('air_quality')) {
-            details['Air Quality'] = this.airQuality;
+            details['Air Quality Level'] = this.airQualityLevel.toString();
+            if (this.airQualityValue > 0) {
+                details['Air Quality Value'] = this.airQualityValue.toString();
+            }
+            if (this.pm1 > 0) {
+                details['PM1'] = this.pm1.toString();
+            }
+            if (this.pm10 > 0) {
+                details['PM10'] = this.pm10.toString();
+            }
+            if (this.aqPercent > 0) {
+                details['AQ Percent'] = this.aqPercent.toString();
+            }
         }
         if (this.hasFeature('humidity')) {
             details['Humidity'] = this.humidity.toString();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tsvesync",
-  "version": "1.0.90",
+  "version": "1.0.91",
   "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

@@ -67,10 +67,11 @@ export class VeSyncAir131 extends VeSyncFan {
             this.details = {
                 mode: data.mode || 'manual',  // Default to manual if not specified
                 speed: data.level || 0,
-                filterLife: data.filterLife || 0,
-                screenStatus: data.screenStatus || 'off',
-                childLock: data.childLock || false,
-                airQuality: data.airQuality || 'unknown',
+                filter_life: data.filterLife || data.filter_life || 0,
+                screen_status: data.screenStatus || 'off',
+                child_lock: data.childLock || false,
+                air_quality: data.airQuality || 'unknown',
+                air_quality_value: data.air_quality_value || 0,
                 active_time: data.activeTime || 0
             };
             

package/src/lib/fans/airBypass.ts

@@ -64,12 +64,18 @@ export class VeSyncAirBypass extends VeSyncFan {
                 this.details = {
                     mode: result.mode || '',
                     speed: result.level || 0,
-                    filterLife: result.filter_life || 0,
-                    screenStatus: result.display ? 'on' : 'off',
-                    childLock: result.child_lock || false,
-                    airQuality: result.air_quality || 0
+                    filter_life: result.filter_life || 0,
+                    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
                 };
 
+                // 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;
+                if ('AQPercent' in result) this.details.aq_percent = result.AQPercent;
+
                 // Don't overwrite config as it contains features array
                 if (result.configuration) {
                     this.details.configuration = result.configuration;

package/src/lib/vesyncFan.ts

@@ -322,10 +322,14 @@ export abstract class VeSyncFan extends VeSyncBaseDevice {
     protected details: {
         mode?: string;
         speed?: number;
-        filter_life?: number;
+        filter_life?: number | { percent: number };
         screen_status?: 'on' | 'off';
         child_lock?: boolean;
-        air_quality?: string;
+        air_quality?: string | number;
+        air_quality_value?: number;
+        pm1?: number;
+        pm10?: number;
+        aq_percent?: number;
         humidity?: number;
         mist_level?: number;
         warm_level?: number;
@@ -417,7 +421,16 @@ export abstract class VeSyncFan extends VeSyncBaseDevice {
      * Get filter life percentage
      */
     get filterLife(): number {
-        return this.details.filter_life ?? 0;
+        // Handle different filter_life formats from different devices
+        const filterLife = this.details.filter_life;
+        
+        // For Air131 devices, filter_life is an object with percent property
+        if (typeof filterLife === 'object' && filterLife !== null && 'percent' in filterLife) {
+            return filterLife.percent ?? 0;
+        }
+        
+        // For other devices, filter_life is a direct number
+        return typeof filterLife === 'number' ? filterLife : 0;
     }
 
     /**
@@ -435,12 +448,47 @@ export abstract class VeSyncFan extends VeSyncBaseDevice {
     }
 
     /**
-     * Get air quality (if supported)
+     * Get air quality level (if supported)
      */
-    get airQuality(): string {
+    get airQualityLevel(): string | number {
         return this.details.air_quality ?? '';
     }
 
+    /**
+     * Get air quality (alias for airQualityLevel for backward compatibility)
+     */
+    get airQuality(): string | number {
+        return this.airQualityLevel;
+    }
+
+    /**
+     * Get air quality value - PM2.5 in μg/m³ (if supported)
+     */
+    get airQualityValue(): number {
+        return this.details.air_quality_value ?? 0;
+    }
+
+    /**
+     * Get PM1 value (if supported)
+     */
+    get pm1(): number {
+        return this.details.pm1 ?? 0;
+    }
+
+    /**
+     * Get PM10 value (if supported)
+     */
+    get pm10(): number {
+        return this.details.pm10 ?? 0;
+    }
+
+    /**
+     * Get air quality percentage (if supported)
+     */
+    get aqPercent(): number {
+        return this.details.aq_percent ?? 0;
+    }
+
     /**
      * Get humidity level (if supported)
      */
@@ -491,7 +539,19 @@ export abstract class VeSyncFan extends VeSyncBaseDevice {
             info.push(['Child Lock: ', this.childLock ? 'Enabled' : 'Disabled']);
         }
         if (this.hasFeature('air_quality')) {
-            info.push(['Air Quality: ', this.airQuality]);
+            info.push(['Air Quality Level: ', this.airQualityLevel]);
+            if (this.airQualityValue > 0) {
+                info.push(['Air Quality Value: ', this.airQualityValue, ' μg/m³']);
+            }
+            if (this.pm1 > 0) {
+                info.push(['PM1: ', this.pm1, ' μg/m³']);
+            }
+            if (this.pm10 > 0) {
+                info.push(['PM10: ', this.pm10, ' μg/m³']);
+            }
+            if (this.aqPercent > 0) {
+                info.push(['AQ Percent: ', this.aqPercent, '%']);
+            }
         }
         if (this.hasFeature('humidity')) {
             info.push(['Humidity: ', this.humidity, '%']);
@@ -534,7 +594,19 @@ export abstract class VeSyncFan extends VeSyncBaseDevice {
             details['Child Lock'] = this.childLock ? 'Enabled' : 'Disabled';
         }
         if (this.hasFeature('air_quality')) {
-            details['Air Quality'] = this.airQuality;
+            details['Air Quality Level'] = this.airQualityLevel.toString();
+            if (this.airQualityValue > 0) {
+                details['Air Quality Value'] = this.airQualityValue.toString();
+            }
+            if (this.pm1 > 0) {
+                details['PM1'] = this.pm1.toString();
+            }
+            if (this.pm10 > 0) {
+                details['PM10'] = this.pm10.toString();
+            }
+            if (this.aqPercent > 0) {
+                details['AQ Percent'] = this.aqPercent.toString();
+            }
         }
         if (this.hasFeature('humidity')) {
             details['Humidity'] = this.humidity.toString();