tsvesync 1.0.89 → 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.89",
+  "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/helpers.ts

@@ -7,157 +7,9 @@ import crypto from 'crypto';
 import { VeSync } from './vesync';
 import { logger } from './logger';
 
-// API configuration
+// API configuration - Always use US endpoint
 let _apiBaseUrl = 'https://smartapi.vesync.com';
 
-// Regional API endpoints
-export const REGIONAL_ENDPOINTS = {
-    US: 'https://smartapi.vesync.com',
-    EU: 'https://smartapi.vesync.eu',
-    ASIA: 'https://smartapi.vesync.com.cn'
-} as const;
-
-// Timezone to region mapping for API endpoint detection
-const TIMEZONE_REGION_MAP: Record<string, keyof typeof REGIONAL_ENDPOINTS> = {
-    // European timezones - Western Europe
-    'Europe/Berlin': 'EU',
-    'Europe/London': 'EU',
-    'Europe/Paris': 'EU',
-    'Europe/Rome': 'EU',
-    'Europe/Madrid': 'EU',
-    'Europe/Amsterdam': 'EU',
-    'Europe/Vienna': 'EU',
-    'Europe/Brussels': 'EU',
-    'Europe/Copenhagen': 'EU',
-    'Europe/Dublin': 'EU',
-    'Europe/Helsinki': 'EU',
-    'Europe/Lisbon': 'EU',
-    'Europe/Luxembourg': 'EU',
-    'Europe/Oslo': 'EU',
-    'Europe/Prague': 'EU',
-    'Europe/Stockholm': 'EU',
-    'Europe/Warsaw': 'EU',
-    'Europe/Zurich': 'EU',
-    
-    // European timezones - Eastern Europe
-    'Europe/Athens': 'EU',
-    'Europe/Budapest': 'EU',
-    'Europe/Bucharest': 'EU',
-    'Europe/Sofia': 'EU',
-    'Europe/Kiev': 'EU',
-    'Europe/Riga': 'EU',
-    'Europe/Vilnius': 'EU',
-    'Europe/Tallinn': 'EU',
-    'Europe/Zagreb': 'EU',
-    'Europe/Ljubljana': 'EU',
-    'Europe/Bratislava': 'EU',
-    'Europe/Belgrade': 'EU',
-    'Europe/Sarajevo': 'EU',
-    'Europe/Podgorica': 'EU',
-    'Europe/Skopje': 'EU',
-    'Europe/Tirane': 'EU',
-    
-    // European timezones - Nordic/Baltic
-    'Europe/Reykjavik': 'EU',
-    'Europe/Moscow': 'EU',
-    'Europe/Kaliningrad': 'EU',
-    'Europe/Minsk': 'EU',
-    
-    // European timezones - Other
-    'Europe/Malta': 'EU',
-    'Europe/Monaco': 'EU',
-    'Europe/Vatican': 'EU',
-    'Europe/San_Marino': 'EU',
-    'Europe/Andorra': 'EU',
-    'Europe/Gibraltar': 'EU',
-    'Europe/Isle_of_Man': 'EU',
-    'Europe/Jersey': 'EU',
-    'Europe/Guernsey': 'EU',
-    
-    // Asian timezones - East Asia
-    'Asia/Shanghai': 'ASIA',
-    'Asia/Beijing': 'ASIA',
-    'Asia/Hong_Kong': 'ASIA',
-    'Asia/Tokyo': 'ASIA',
-    'Asia/Seoul': 'ASIA',
-    'Asia/Singapore': 'ASIA',
-    'Asia/Taipei': 'ASIA',
-    'Asia/Macau': 'ASIA',
-    
-    // Asian timezones - Southeast Asia
-    'Asia/Bangkok': 'ASIA',
-    'Asia/Jakarta': 'ASIA',
-    'Asia/Manila': 'ASIA',
-    'Asia/Ho_Chi_Minh': 'ASIA',
-    'Asia/Kuala_Lumpur': 'ASIA',
-    'Asia/Phnom_Penh': 'ASIA',
-    'Asia/Vientiane': 'ASIA',
-    'Asia/Yangon': 'ASIA',
-    'Asia/Brunei': 'ASIA',
-    
-    // Asian timezones - South Asia
-    'Asia/Mumbai': 'ASIA',
-    'Asia/Delhi': 'ASIA',
-    'Asia/Kolkata': 'ASIA',
-    'Asia/Dhaka': 'ASIA',
-    'Asia/Karachi': 'ASIA',
-    'Asia/Colombo': 'ASIA',
-    'Asia/Kathmandu': 'ASIA',
-    'Asia/Thimphu': 'ASIA',
-    
-    // Asian timezones - Central Asia
-    'Asia/Almaty': 'ASIA',
-    'Asia/Bishkek': 'ASIA',
-    'Asia/Dushanbe': 'ASIA',
-    'Asia/Tashkent': 'ASIA',
-    'Asia/Ashgabat': 'ASIA',
-    
-    // Asian timezones - West Asia / Middle East
-    'Asia/Dubai': 'ASIA',
-    'Asia/Riyadh': 'ASIA',
-    'Asia/Tehran': 'ASIA',
-    'Asia/Baghdad': 'ASIA',
-    'Asia/Kuwait': 'ASIA',
-    'Asia/Qatar': 'ASIA',
-    'Asia/Bahrain': 'ASIA',
-    'Asia/Muscat': 'ASIA',
-    'Asia/Baku': 'ASIA',
-    'Asia/Yerevan': 'ASIA',
-    'Asia/Tbilisi': 'ASIA',
-    
-    // Oceania (using ASIA endpoint for now)
-    'Australia/Sydney': 'ASIA',
-    'Australia/Melbourne': 'ASIA',
-    'Australia/Brisbane': 'ASIA',
-    'Australia/Perth': 'ASIA',
-    'Australia/Adelaide': 'ASIA',
-    'Australia/Hobart': 'ASIA',
-    'Australia/Darwin': 'ASIA',
-    'Australia/Canberra': 'ASIA',
-    'Pacific/Auckland': 'ASIA',
-    'Pacific/Wellington': 'ASIA',
-    'Pacific/Fiji': 'ASIA',
-    'Pacific/Honolulu': 'US',
-    
-    // North America (Canada)
-    'America/Toronto': 'US',
-    'America/Montreal': 'US',
-    'America/Vancouver': 'US',
-    'America/Calgary': 'US',
-    'America/Edmonton': 'US',
-    'America/Winnipeg': 'US',
-    'America/Halifax': 'US',
-    'America/St_Johns': 'US',
-    
-    // North America (Mexico)
-    'America/Mexico_City': 'US',
-    'America/Tijuana': 'US',
-    'America/Cancun': 'US',
-    'America/Merida': 'US',
-    'America/Monterrey': 'US'
-    // US and other timezones default to US endpoint
-};
-
 export function getApiBaseUrl(): string {
     return _apiBaseUrl;
 }
@@ -166,24 +18,6 @@ export function setApiBaseUrl(url: string): void {
     _apiBaseUrl = url;
 }
 
-/**
- * Get regional API endpoint based on timezone
- */
-export function getRegionalEndpoint(timeZone: string): string {
-    const region = TIMEZONE_REGION_MAP[timeZone] || 'US';
-    return REGIONAL_ENDPOINTS[region];
-}
-
-/**
- * Set API endpoint based on timezone if not explicitly set
- */
-export function setRegionalEndpoint(timeZone: string): void {
-    const regionalUrl = getRegionalEndpoint(timeZone);
-    if (_apiBaseUrl === REGIONAL_ENDPOINTS.US && regionalUrl !== REGIONAL_ENDPOINTS.US) {
-        logger.debug(`Setting regional API endpoint for ${timeZone}: ${regionalUrl}`);
-        setApiBaseUrl(regionalUrl);
-    }
-}
 
 export const API_RATE_LIMIT = 30;
 export const API_TIMEOUT = 15000;
@@ -375,8 +209,8 @@ export class Helpers {
         try {
             // Ensure API base URL is properly set
             if (!_apiBaseUrl || _apiBaseUrl === 'undefined') {
-                logger.error('API base URL is not properly configured. Setting regional endpoint...');
-                setRegionalEndpoint(manager.timeZone);
+                logger.error('API base URL is not properly configured. Setting to default US endpoint...');
+                setApiBaseUrl('https://smartapi.vesync.com');
             }
             
             const url = _apiBaseUrl + endpoint;

package/src/lib/vesync.ts

@@ -2,7 +2,7 @@
  * VeSync API Device Library
  */
 
-import { Helpers, API_RATE_LIMIT, DEFAULT_TZ, setApiBaseUrl, setRegionalEndpoint, getApiBaseUrl } from './helpers';
+import { Helpers, API_RATE_LIMIT, DEFAULT_TZ, setApiBaseUrl, getApiBaseUrl } from './helpers';
 import { VeSyncBaseDevice } from './vesyncBaseDevice';
 import { fanModules } from './vesyncFanImpl';
 import { outletModules } from './vesyncOutletImpl';
@@ -180,7 +180,7 @@ export class VeSync {
      * Initialize VeSync Manager
      * @param username - VeSync account username
      * @param password - VeSync account password
-     * @param timeZone - Optional timezone (defaults to America/New_York)
+     * @param timeZone - Optional timezone for device operations (defaults to America/New_York)
      * @param debug - Optional debug mode flag
      * @param redact - Optional redact mode flag
      * @param apiUrl - Optional API base URL override
@@ -241,12 +241,12 @@ export class VeSync {
             logger.debug('Time zone is not a string');
         }
 
-        // Set custom API URL if provided, otherwise use regional endpoint
+        // Set custom API URL if provided, otherwise use default US endpoint
         if (apiUrl) {
             setApiBaseUrl(apiUrl);
         } else {
-            // Automatically set regional endpoint based on timezone
-            setRegionalEndpoint(this.timeZone);
+            // Always use US endpoint
+            setApiBaseUrl('https://smartapi.vesync.com');
         }
 
         // Set custom logger if provided
@@ -535,7 +535,7 @@ export class VeSync {
                     switch (response.code) {
                         case -11012022:
                             logger.error('App version too low error. Current version:', body.appVersion);
-                            logger.error('This typically indicates a regional API compatibility issue.');
+                            logger.error('This typically indicates an API version compatibility issue.');
                             break;
                         case -11003:
                             logger.error('Authentication failed - check credentials');

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();