tsvesync 1.6.1 → 1.7.0

package/api/vesyncfan/LTF-F422_WJP.yaml

@@ -1,165 +1,209 @@
-change_fan_speed:
-  headers:
-    Content-Type: application/json; charset=UTF-8
-    User-Agent: okhttp/3.12.1
+# Tower fan request contracts, aligned with pyvesync devices/vesyncfan.py.
+# Authentication headers and metadata are supplied by Helpers at runtime.
+update:
+  method: post
+  url: /cloud/v2/deviceManaged/bypassV2
   json_object:
-    acceptLanguage: en
-    accountID: sample_id
-    appVersion: 2.8.6
+    method: bypassV2
     cid: LTF-F422_WJP-CID
-    configModel: ConfigModule
     configModule: ConfigModule
-    debugMode: false
-    deviceId: LTF-F422_WJP-CID
-    deviceRegion: US
+    payload:
+      method: getTowerFanStatus
+      source: APP
+      data: {}
+turn_on:
+  method: post
+  url: /cloud/v2/deviceManaged/bypassV2
+  json_object:
     method: bypassV2
+    cid: LTF-F422_WJP-CID
+    configModule: ConfigModule
     payload:
+      method: setSwitch
+      source: APP
+      data:
+        powerSwitch: 1
+        switchIdx: 0
+turn_off:
+  method: post
+  url: /cloud/v2/deviceManaged/bypassV2
+  json_object:
+    method: bypassV2
+    cid: LTF-F422_WJP-CID
+    configModule: ConfigModule
+    payload:
+      method: setSwitch
+      source: APP
+      data:
+        powerSwitch: 0
+        switchIdx: 0
+change_fan_speed:
+  method: post
+  url: /cloud/v2/deviceManaged/bypassV2
+  json_object:
+    method: bypassV2
+    cid: LTF-F422_WJP-CID
+    configModule: ConfigModule
+    payload:
+      method: setLevel
+      source: APP
       data:
         levelIdx: 0
         levelType: wind
         manualSpeedLevel: 3
-      method: setLevel
-      source: APP
-    phoneBrand: SM N9005
-    phoneOS: Android
-    timeZone: America/New_York
-    token: sample_tk
-    traceId: TRACE_ID
+manual_mode:
   method: post
   url: /cloud/v2/deviceManaged/bypassV2
-manual_mode:
-  headers:
-    Content-Type: application/json; charset=UTF-8
-    User-Agent: okhttp/3.12.1
   json_object:
-    acceptLanguage: en
-    accountID: sample_id
-    appVersion: 2.8.6
+    method: bypassV2
     cid: LTF-F422_WJP-CID
-    configModel: ConfigModule
     configModule: ConfigModule
-    debugMode: false
-    deviceId: LTF-F422_WJP-CID
-    deviceRegion: US
-    method: bypassV2
     payload:
+      method: setTowerFanMode
+      source: APP
       data:
         workMode: normal
+auto_mode:
+  method: post
+  url: /cloud/v2/deviceManaged/bypassV2
+  json_object:
+    method: bypassV2
+    cid: LTF-F422_WJP-CID
+    configModule: ConfigModule
+    payload:
       method: setTowerFanMode
       source: APP
-    phoneBrand: SM N9005
-    phoneOS: Android
-    timeZone: America/New_York
-    token: sample_tk
-    traceId: TRACE_ID
+      data:
+        workMode: auto
+sleep_mode:
   method: post
   url: /cloud/v2/deviceManaged/bypassV2
-sleep_mode:
-  headers:
-    Content-Type: application/json; charset=UTF-8
-    User-Agent: okhttp/3.12.1
   json_object:
-    acceptLanguage: en
-    accountID: sample_id
-    appVersion: 2.8.6
+    method: bypassV2
     cid: LTF-F422_WJP-CID
-    configModel: ConfigModule
     configModule: ConfigModule
-    debugMode: false
-    deviceId: LTF-F422_WJP-CID
-    deviceRegion: US
-    method: bypassV2
     payload:
+      method: setTowerFanMode
+      source: APP
       data:
         workMode: advancedSleep
+turbo_mode:
+  method: post
+  url: /cloud/v2/deviceManaged/bypassV2
+  json_object:
+    method: bypassV2
+    cid: LTF-F422_WJP-CID
+    configModule: ConfigModule
+    payload:
       method: setTowerFanMode
       source: APP
-    phoneBrand: SM N9005
-    phoneOS: Android
-    timeZone: America/New_York
-    token: sample_tk
-    traceId: TRACE_ID
+      data:
+        workMode: turbo
+oscillation_on:
   method: post
   url: /cloud/v2/deviceManaged/bypassV2
-turn_off:
-  headers:
-    Content-Type: application/json; charset=UTF-8
-    User-Agent: okhttp/3.12.1
   json_object:
-    acceptLanguage: en
-    accountID: sample_id
-    appVersion: 2.8.6
+    method: bypassV2
     cid: LTF-F422_WJP-CID
-    configModel: ConfigModule
     configModule: ConfigModule
-    debugMode: false
-    deviceId: LTF-F422_WJP-CID
-    deviceRegion: US
+    payload:
+      method: setOscillationSwitch
+      source: APP
+      data:
+        oscillationSwitch: 1
+oscillation_off:
+  method: post
+  url: /cloud/v2/deviceManaged/bypassV2
+  json_object:
     method: bypassV2
+    cid: LTF-F422_WJP-CID
+    configModule: ConfigModule
     payload:
+      method: setOscillationSwitch
+      source: APP
       data:
-        powerSwitch: 0
-        switchIdx: 0
-      method: setSwitch
+        oscillationSwitch: 0
+display_on:
+  method: post
+  url: /cloud/v2/deviceManaged/bypassV2
+  json_object:
+    method: bypassV2
+    cid: LTF-F422_WJP-CID
+    configModule: ConfigModule
+    payload:
+      method: setDisplay
       source: APP
-    phoneBrand: SM N9005
-    phoneOS: Android
-    timeZone: America/New_York
-    token: sample_tk
-    traceId: TRACE_ID
+      data:
+        screenSwitch: 1
+display_off:
   method: post
   url: /cloud/v2/deviceManaged/bypassV2
-turn_on:
-  headers:
-    Content-Type: application/json; charset=UTF-8
-    User-Agent: okhttp/3.12.1
   json_object:
-    acceptLanguage: en
-    accountID: sample_id
-    appVersion: 2.8.6
+    method: bypassV2
     cid: LTF-F422_WJP-CID
-    configModel: ConfigModule
     configModule: ConfigModule
-    debugMode: false
-    deviceId: LTF-F422_WJP-CID
-    deviceRegion: US
+    payload:
+      method: setDisplay
+      source: APP
+      data:
+        screenSwitch: 0
+mute_on:
+  method: post
+  url: /cloud/v2/deviceManaged/bypassV2
+  json_object:
     method: bypassV2
+    cid: LTF-F422_WJP-CID
+    configModule: ConfigModule
     payload:
+      method: setMuteSwitch
+      source: APP
       data:
-        powerSwitch: 1
-        switchIdx: 0
-      method: setSwitch
+        muteSwitch: 1
+mute_off:
+  method: post
+  url: /cloud/v2/deviceManaged/bypassV2
+  json_object:
+    method: bypassV2
+    cid: LTF-F422_WJP-CID
+    configModule: ConfigModule
+    payload:
+      method: setMuteSwitch
       source: APP
-    phoneBrand: SM N9005
-    phoneOS: Android
-    timeZone: America/New_York
-    token: sample_tk
-    traceId: TRACE_ID
+      data:
+        muteSwitch: 0
+set_timer:
   method: post
   url: /cloud/v2/deviceManaged/bypassV2
-update:
-  headers:
-    Content-Type: application/json; charset=UTF-8
-    User-Agent: okhttp/3.12.1
   json_object:
-    acceptLanguage: en
-    accountID: sample_id
-    appVersion: 2.8.6
+    method: bypassV2
     cid: LTF-F422_WJP-CID
-    configModel: ConfigModule
     configModule: ConfigModule
-    debugMode: false
-    deviceId: LTF-F422_WJP-CID
-    deviceRegion: US
+    payload:
+      method: setTimer
+      source: APP
+      data:
+        action: 'off'
+        total: 3600
+get_timer:
+  method: post
+  url: /cloud/v2/deviceManaged/bypassV2
+  json_object:
     method: bypassV2
+    cid: LTF-F422_WJP-CID
+    configModule: ConfigModule
     payload:
-      data: {}
-      method: getTowerFanStatus
+      method: getTimer
       source: APP
-    phoneBrand: SM N9005
-    phoneOS: Android
-    timeZone: America/New_York
-    token: sample_tk
-    traceId: TRACE_ID
+      data: {}
+clear_timer:
   method: post
   url: /cloud/v2/deviceManaged/bypassV2
+  json_object:
+    method: bypassV2
+    cid: LTF-F422_WJP-CID
+    configModule: ConfigModule
+    payload:
+      method: clearTimer
+      source: APP
+      data:
+        id: 1

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export { VeSyncAirBypass } from './lib/vesyncFanImpl';
 export { VeSyncOutlet7A, VeSyncOutlet10A, VeSyncOutlet15A, VeSyncOutdoorPlug } from './lib/vesyncOutletImpl';
 export { VeSyncBulb } from './lib/vesyncBulb';
 export { VeSyncWallSwitch, VeSyncDimmerSwitch } from './lib/vesyncSwitchImpl';
+export { VeSyncTowerFan } from './lib/fans/towerFan';
 export { VeSyncBaseDevice } from './lib/vesyncBaseDevice';
 export { Helpers, setApiBaseUrl } from './lib/helpers';
 export { CREDENTIAL_ERROR_CODES, CROSS_REGION_ERROR_CODES, isCredentialError, isCrossRegionError } from './lib/constants';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.decodeJwtTimestamps = exports.isCrossRegionError = exports.isCredentialError = exports.CROSS_REGION_ERROR_CODES = exports.CREDENTIAL_ERROR_CODES = exports.setApiBaseUrl = exports.Helpers = exports.VeSyncBaseDevice = exports.VeSyncDimmerSwitch = exports.VeSyncWallSwitch = exports.VeSyncBulb = exports.VeSyncOutdoorPlug = exports.VeSyncOutlet15A = exports.VeSyncOutlet10A = exports.VeSyncOutlet7A = exports.VeSyncAirBypass = exports.VeSync = void 0;
+exports.decodeJwtTimestamps = exports.isCrossRegionError = exports.isCredentialError = exports.CROSS_REGION_ERROR_CODES = exports.CREDENTIAL_ERROR_CODES = exports.setApiBaseUrl = exports.Helpers = exports.VeSyncBaseDevice = exports.VeSyncTowerFan = exports.VeSyncDimmerSwitch = exports.VeSyncWallSwitch = exports.VeSyncBulb = exports.VeSyncOutdoorPlug = exports.VeSyncOutlet15A = exports.VeSyncOutlet10A = exports.VeSyncOutlet7A = exports.VeSyncAirBypass = exports.VeSync = void 0;
 // Export main VeSync manager class
 var vesync_1 = require("./lib/vesync");
 Object.defineProperty(exports, "VeSync", { enumerable: true, get: function () { return vesync_1.VeSync; } });
@@ -17,6 +17,9 @@ Object.defineProperty(exports, "VeSyncBulb", { enumerable: true, get: function (
 var vesyncSwitchImpl_1 = require("./lib/vesyncSwitchImpl");
 Object.defineProperty(exports, "VeSyncWallSwitch", { enumerable: true, get: function () { return vesyncSwitchImpl_1.VeSyncWallSwitch; } });
 Object.defineProperty(exports, "VeSyncDimmerSwitch", { enumerable: true, get: function () { return vesyncSwitchImpl_1.VeSyncDimmerSwitch; } });
+// Tower fan API
+var towerFan_1 = require("./lib/fans/towerFan");
+Object.defineProperty(exports, "VeSyncTowerFan", { enumerable: true, get: function () { return towerFan_1.VeSyncTowerFan; } });
 // Export base device class
 var vesyncBaseDevice_1 = require("./lib/vesyncBaseDevice");
 Object.defineProperty(exports, "VeSyncBaseDevice", { enumerable: true, get: function () { return vesyncBaseDevice_1.VeSyncBaseDevice; } });

package/dist/lib/fans/index.js

@@ -71,6 +71,7 @@ exports.fanModules = {
     // LTF Series
     'LTF-F422S-KEU': towerFan_1.VeSyncTowerFan,
     'LTF-F422S-WUSR': towerFan_1.VeSyncTowerFan,
+    'LTF-F422S-WJP': towerFan_1.VeSyncTowerFan,
     'LTF-F422_WJP': towerFan_1.VeSyncTowerFan,
     'LTF-F422S-WUS': towerFan_1.VeSyncTowerFan,
     // Classic Series

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

@@ -1,105 +1,53 @@
 import { VeSyncAirBaseV2 } from './airBaseV2';
 import { VeSync } from '../vesync';
-/**
- * VeSync Tower Fan Implementation
- */
+/** LTF-F422S tower fans use different commands from bypassV2 purifiers. */
 export declare class VeSyncTowerFan extends VeSyncAirBaseV2 {
-    protected readonly towerModes: readonly ["normal", "advancedSleep", "off"];
+    protected readonly towerModes: readonly ["normal", "auto", "advancedSleep", "turbo", "off"];
+    private timerId?;
+    private timerDeadline?;
     constructor(details: Record<string, any>, manager: VeSync);
-    /**
-     * Get device details
-     */
-    getDetails(): Promise<Boolean>;
-    /**
-     * Toggle device power
-     */
+    /** A successful cloud envelope can still contain a rejected device command. */
+    protected checkResponse(response: [any, number], method: string): boolean;
+    private request;
+    getDetails(): Promise<boolean>;
     toggleSwitch(toggle: boolean): Promise<boolean>;
-    /**
-     * Turn device on
-     */
     turnOn(): Promise<boolean>;
-    /**
-     * Turn device off
-     */
     turnOff(): Promise<boolean>;
-    /**
-     * Set tower fan mode
-     */
     mode_toggle(mode: string): Promise<boolean>;
-    /**
-     * Change fan speed
-     */
-    changeFanSpeed(speed: number): Promise<boolean>;
-    /**
-     * Set normal mode
-     */
+    setMode(mode: string): Promise<boolean>;
     normal_mode(): Promise<boolean>;
-    /**
-     * Set manual mode - adapter to set mode to normal
-     */
     manual_mode(): Promise<boolean>;
-    /**
-     * Set advanced sleep mode
-     */
     advanced_sleep_mode(): Promise<boolean>;
-    /**
-     * Set sleep mode - adapter for advanced sleep mode
-     */
     sleep_mode(): Promise<boolean>;
-    /**
-     * Override setMode to handle tower fan specific modes
-     */
-    setMode(mode: string): Promise<boolean>;
-    /**
-     * Get current speed
-     */
+    changeFanSpeed(speed: number): Promise<boolean>;
+    setOscillation(toggle: boolean): Promise<boolean>;
+    setOscillationOn(): Promise<boolean>;
+    setOscillationOff(): Promise<boolean>;
+    setDisplay(enabled: boolean): Promise<boolean>;
+    setMute(enabled: boolean): Promise<boolean>;
+    /** Public timer duration remains hours, like the other tsvesync devices. */
+    setTimer(hours: number, action?: string): Promise<boolean>;
+    getTimer(): Promise<boolean>;
+    clearTimer(): Promise<boolean>;
+    private updateTimerState;
+    get timerRemaining(): number;
+    get mode(): string;
+    set mode(value: string);
     get speed(): number;
-    /**
-     * Get display status
-     */
+    set speed(value: number);
     get displayState(): boolean;
-    /**
-     * Get oscillation status
-     */
+    get displayEnabled(): boolean;
+    get screenStatus(): 'on' | 'off';
     get oscillationState(): boolean;
-    /**
-     * Get mute status
-     */
+    get oscillationEnabled(): boolean;
     get muteState(): boolean;
-    /**
-     * Get temperature (in tenths of a degree)
-     */
+    /** Raw API temperature is Fahrenheit times ten, retained for compatibility. */
     get temperature(): number;
-    /**
-     * Get humidity percentage
-     */
+    get temperatureCelsius(): number | undefined;
     get humidity(): number;
-    /**
-     * Get thermal comfort level
-     */
     get thermalComfort(): number;
-    /**
-     * Get sleep preferences
-     */
     get sleepPreference(): Record<string, any>;
-    /**
-     * Get schedule count
-     */
     get scheduleCount(): number;
-    /**
-     * Get error code
-     */
     get errorCode(): number;
-    /**
-     * Turn oscillation on
-     */
-    setOscillationOn(): Promise<boolean>;
-    /**
-     * Turn oscillation off
-     */
-    setOscillationOff(): Promise<boolean>;
-    /**
-     * Display device info
-     */
     display(): void;
 }