tsvesync 1.5.2 → 1.6.0

package/dist/lib/fans/air131.js

@@ -85,7 +85,8 @@ class VeSyncAir131 extends vesyncFan_1.VeSyncFan {
                 speed: data.level || 0,
                 filter_life: filterLife,
                 screen_status: data.screenStatus || 'off',
-                child_lock: data.childLock || false,
+                // The 131 API reports childLock as the string 'on'/'off'
+                child_lock: data.childLock === 'on' || data.childLock === true,
                 air_quality: data.airQuality || 'unknown',
                 air_quality_value: data.air_quality_value || 0,
                 air_quality_level: normalizedAirQuality.level >= 1 ? normalizedAirQuality.level : undefined,
@@ -343,7 +344,7 @@ class VeSyncAir131 extends vesyncFan_1.VeSyncFan {
         });
         const success = this.checkResponse([response, status], 'setChildLock');
         if (success) {
-            this.details.childLock = enabled;
+            this.details.child_lock = enabled;
             return true;
         }
         else {

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

@@ -54,6 +54,14 @@ export declare class VeSyncAirBaseV2 extends VeSyncAirBypass {
      * Override turn off to use the powerSwitch payload required by bypassV2 purifiers.
      */
     turnOff(): Promise<boolean>;
+    /**
+     * Override setChildLock to send the childLockSwitch payload required by
+     * bypassV2 purifiers (Vital 100S/200S, Everest Air). These devices report
+     * child lock as childLockSwitch 0|1 and reject the legacy child_lock
+     * boolean payload used by the Core series (matches pyvesync, which sends
+     * {'childLockSwitch': int} for this family).
+     */
+    setChildLock(enabled: boolean): Promise<boolean>;
     /**
      * Override setMode to send workMode payloads for bypassV2 purifiers.
      */

package/dist/lib/fans/airBaseV2.js

@@ -264,6 +264,47 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
             return super.turnOff();
         }
     }
+    /**
+     * Override setChildLock to send the childLockSwitch payload required by
+     * bypassV2 purifiers (Vital 100S/200S, Everest Air). These devices report
+     * child lock as childLockSwitch 0|1 and reject the legacy child_lock
+     * boolean payload used by the Core series (matches pyvesync, which sends
+     * {'childLockSwitch': int} for this family).
+     */
+    async setChildLock(enabled) {
+        var _a;
+        if (!this.requiresPowerSwitchPayload()) {
+            // Use parent implementation for non-bypassV2 models
+            return super.setChildLock(enabled);
+        }
+        if (!this.hasFeature('child_lock')) {
+            const error = 'Child lock not supported';
+            logger_1.logger.error(`${error} for device: ${this.deviceName}`);
+            throw new Error(error);
+        }
+        logger_1.logger.debug(`Setting child lock to ${enabled ? 'on' : 'off'} for device: ${this.deviceName}`);
+        const [head, body] = this.buildApiDict('setChildLock');
+        body.payload.data = {
+            childLockSwitch: enabled ? 1 : 0
+        };
+        const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', body, head);
+        const success = this.checkV2Response(response, status, 'setChildLock');
+        // Code 11000000 marks the feature unsupported even when the envelope
+        // succeeds, so it must override the lenient inner-code handling
+        if ((response === null || response === void 0 ? void 0 : response.code) === 11000000 || (((_a = response === null || response === void 0 ? void 0 : response.result) === null || _a === void 0 ? void 0 : _a.code) === 11000000)) {
+            logger_1.logger.warn(`Child lock control not supported via API for device: ${this.deviceName}`);
+            return false;
+        }
+        if (success) {
+            // No deferred details refresh here: pyvesync and the Core path
+            // both rely on the optimistic update plus the next regular poll
+            this.details.child_lock = enabled;
+        }
+        else {
+            logger_1.logger.error(`Failed to set child lock to ${enabled ? 'on' : 'off'} for device: ${this.deviceName}`);
+        }
+        return success;
+    }
     /**
      * Override setMode to send workMode payloads for bypassV2 purifiers.
      */

package/dist/lib/fans/airBypass.js

@@ -316,7 +316,7 @@ class VeSyncAirBypass extends vesyncFan_1.VeSyncFan {
             configModule: this.configModule,
             payload: {
                 data: {
-                    state: enabled
+                    child_lock: enabled
                 },
                 method: 'setChildLock',
                 source: 'APP'
@@ -329,7 +329,7 @@ class VeSyncAirBypass extends vesyncFan_1.VeSyncFan {
             return false;
         }
         if (success) {
-            this.details.childLock = enabled;
+            this.details.child_lock = enabled;
             return true;
         }
         else {

package/dist/lib/vesyncFan.js

@@ -228,22 +228,26 @@ exports.fanConfig = {
     // LTF Series
     'LTF-F422S-KEU': {
         module: 'VeSyncTowerFan',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
+        // No child_lock: the LTF-F422S API neither reports nor accepts it (pyvesync parity)
+        features: ['display', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
         levels: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
     },
     'LTF-F422S-WUSR': {
         module: 'VeSyncTowerFan',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
+        // No child_lock: the LTF-F422S API neither reports nor accepts it (pyvesync parity)
+        features: ['display', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
         levels: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
     },
     'LTF-F422_WJP': {
         module: 'VeSyncTowerFan',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
+        // No child_lock: the LTF-F422S API neither reports nor accepts it (pyvesync parity)
+        features: ['display', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
         levels: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
     },
     'LTF-F422S-WUS': {
         module: 'VeSyncTowerFan',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
+        // No child_lock: the LTF-F422S API neither reports nor accepts it (pyvesync parity)
+        features: ['display', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
         levels: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
     },
     // Classic Series

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tsvesync",
-  "version": "1.5.2",
+  "version": "1.6.0",
   "description": "A TypeScript library for interacting with VeSync smart home devices",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,6 +8,7 @@
     "build": "tsc",
     "clean": "rm -rf dist",
     "test:everest": "ts-node test/everest-air-parity.test.ts",
+    "test:child-lock": "ts-node test/child-lock-parity.test.ts",
     "prepare": "npm run build",
     "version": "git add -A src",
     "postversion": "git push && git push --tags",

package/src/lib/fans/air131.ts

@@ -95,7 +95,8 @@ export class VeSyncAir131 extends VeSyncFan {
                 speed: data.level || 0,
                 filter_life: filterLife,
                 screen_status: data.screenStatus || 'off',
-                child_lock: data.childLock || false,
+                // The 131 API reports childLock as the string 'on'/'off'
+                child_lock: data.childLock === 'on' || data.childLock === true,
                 air_quality: data.airQuality || 'unknown',
                 air_quality_value: data.air_quality_value || 0,
                 air_quality_level: normalizedAirQuality.level >= 1 ? normalizedAirQuality.level : undefined,
@@ -413,7 +414,7 @@ export class VeSyncAir131 extends VeSyncFan {
 
         const success = this.checkResponse([response, status], 'setChildLock');
         if (success) {
-            this.details.childLock = enabled;
+            this.details.child_lock = enabled;
             return true;
         } else {
             // Check for error code 11000000 (feature not supported)

package/src/lib/fans/airBaseV2.ts

@@ -311,6 +311,58 @@ export class VeSyncAirBaseV2 extends VeSyncAirBypass {
         }
     }
 
+    /**
+     * Override setChildLock to send the childLockSwitch payload required by
+     * bypassV2 purifiers (Vital 100S/200S, Everest Air). These devices report
+     * child lock as childLockSwitch 0|1 and reject the legacy child_lock
+     * boolean payload used by the Core series (matches pyvesync, which sends
+     * {'childLockSwitch': int} for this family).
+     */
+    override async setChildLock(enabled: boolean): Promise<boolean> {
+        if (!this.requiresPowerSwitchPayload()) {
+            // Use parent implementation for non-bypassV2 models
+            return super.setChildLock(enabled);
+        }
+
+        if (!this.hasFeature('child_lock')) {
+            const error = 'Child lock not supported';
+            logger.error(`${error} for device: ${this.deviceName}`);
+            throw new Error(error);
+        }
+
+        logger.debug(`Setting child lock to ${enabled ? 'on' : 'off'} for device: ${this.deviceName}`);
+
+        const [head, body] = this.buildApiDict('setChildLock');
+        body.payload.data = {
+            childLockSwitch: enabled ? 1 : 0
+        };
+
+        const [response, status] = await this.callApi(
+            '/cloud/v2/deviceManaged/bypassV2',
+            'post',
+            body,
+            head
+        );
+
+        const success = this.checkV2Response(response, status, 'setChildLock');
+
+        // Code 11000000 marks the feature unsupported even when the envelope
+        // succeeds, so it must override the lenient inner-code handling
+        if (response?.code === 11000000 || (response?.result?.code === 11000000)) {
+            logger.warn(`Child lock control not supported via API for device: ${this.deviceName}`);
+            return false;
+        }
+
+        if (success) {
+            // No deferred details refresh here: pyvesync and the Core path
+            // both rely on the optimistic update plus the next regular poll
+            this.details.child_lock = enabled;
+        } else {
+            logger.error(`Failed to set child lock to ${enabled ? 'on' : 'off'} for device: ${this.deviceName}`);
+        }
+        return success;
+    }
+
     /**
      * Override setMode to send workMode payloads for bypassV2 purifiers.
      */

package/src/lib/fans/airBypass.ts

@@ -376,7 +376,7 @@ export class VeSyncAirBypass extends VeSyncFan {
                 configModule: this.configModule,
                 payload: {
                     data: {
-                        state: enabled
+                        child_lock: enabled
                     },
                     method: 'setChildLock',
                     source: 'APP'
@@ -394,7 +394,7 @@ export class VeSyncAirBypass extends VeSyncFan {
         }
         
         if (success) {
-            this.details.childLock = enabled;
+            this.details.child_lock = enabled;
             return true;
         } else {
             logger.error(`Failed to set child lock to ${enabled ? 'on' : 'off'} for device: ${this.deviceName}`);

package/src/lib/vesyncFan.ts

@@ -242,22 +242,26 @@ export const fanConfig: FanConfig = {
     // LTF Series
     'LTF-F422S-KEU': {
         module: 'VeSyncTowerFan',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
+        // No child_lock: the LTF-F422S API neither reports nor accepts it (pyvesync parity)
+        features: ['display', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
         levels: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
     },
     'LTF-F422S-WUSR': {
         module: 'VeSyncTowerFan',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
+        // No child_lock: the LTF-F422S API neither reports nor accepts it (pyvesync parity)
+        features: ['display', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
         levels: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
     },
     'LTF-F422_WJP': {
         module: 'VeSyncTowerFan',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
+        // No child_lock: the LTF-F422S API neither reports nor accepts it (pyvesync parity)
+        features: ['display', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
         levels: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
     },
     'LTF-F422S-WUS': {
         module: 'VeSyncTowerFan',
-        features: ['display', 'child_lock', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
+        // No child_lock: the LTF-F422S API neither reports nor accepts it (pyvesync parity)
+        features: ['display', 'night_light', 'timer', 'fan_speeds', 'tower_modes'],
         levels: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
     },