tsvesync 1.0.11 → 1.0.13

package/dist/lib/vesyncSwitch.js

@@ -1,2 +1,78 @@
 "use strict";
-//# sourceMappingURL=vesyncSwitch.js.map
+/**
+ * VeSync Switch Classes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VeSyncSwitch = exports.switchConfig = void 0;
+const vesyncBaseDevice_1 = require("./vesyncBaseDevice");
+const logger_1 = require("./logger");
+// Switch configuration
+exports.switchConfig = {
+    'ESWL01': {
+        module: 'VeSyncWallSwitch',
+        features: []
+    },
+    'ESWD16': {
+        module: 'VeSyncDimmerSwitch',
+        features: ['dimmable']
+    },
+    'ESWL03': {
+        module: 'VeSyncWallSwitch',
+        features: []
+    }
+};
+/**
+ * Base class for VeSync Switches
+ */
+class VeSyncSwitch extends vesyncBaseDevice_1.VeSyncBaseDevice {
+    constructor(details, manager) {
+        var _a;
+        super(details, manager);
+        this.details = {};
+        this.features = [];
+        this.details = details;
+        this.features = ((_a = exports.switchConfig[this.deviceType]) === null || _a === void 0 ? void 0 : _a.features) || [];
+    }
+    /**
+     * Get active time of switch
+     */
+    get activeTime() {
+        var _a;
+        return (_a = this.details.active_time) !== null && _a !== void 0 ? _a : 0;
+    }
+    /**
+     * Return true if switch is dimmable
+     */
+    isDimmable() {
+        return this.features.includes('dimmable');
+    }
+    /**
+     * Return formatted device info to stdout
+     */
+    display() {
+        super.display();
+        const info = [
+            ['Active Time:', this.activeTime]
+        ];
+        for (const [key, value] of info) {
+            logger_1.logger.info(`${key.toString().padEnd(30, '.')} ${value}`);
+        }
+    }
+    /**
+     * Return JSON details for switch
+     */
+    displayJSON() {
+        const baseInfo = JSON.parse(super.displayJSON());
+        return JSON.stringify({
+            ...baseInfo,
+            'Active Time': this.activeTime
+        }, null, 4);
+    }
+    /**
+     * Update device details
+     */
+    async update() {
+        await this.getDetails();
+    }
+}
+exports.VeSyncSwitch = VeSyncSwitch;

package/dist/lib/vesyncSwitchImpl.d.ts

@@ -0,0 +1,82 @@
+/**
+ * VeSync Switch Implementations
+ */
+import { VeSyncSwitch } from './vesyncSwitch';
+import { VeSync } from './vesync';
+/**
+ * Basic Wall Switch Implementation (ESWL01, ESWL03)
+ */
+export declare class VeSyncWallSwitch extends VeSyncSwitch {
+    constructor(details: Record<string, any>, manager: VeSync);
+    /**
+     * Get wall switch details
+     */
+    getDetails(): Promise<void>;
+    /**
+     * Get switch device configuration info
+     */
+    getConfig(): Promise<void>;
+    /**
+     * Turn off wall switch
+     */
+    turnOff(): Promise<boolean>;
+    /**
+     * Turn on wall switch
+     */
+    turnOn(): Promise<boolean>;
+}
+/**
+ * Dimmer Switch Implementation (ESWD16)
+ */
+export declare class VeSyncDimmerSwitch extends VeSyncSwitch {
+    private _brightness;
+    private _rgbValue;
+    private _rgbStatus;
+    private _indicatorLight;
+    constructor(details: Record<string, any>, manager: VeSync);
+    /**
+     * Get dimmer switch details
+     */
+    getDetails(): Promise<void>;
+    /**
+     * Get dimmer switch configuration info
+     */
+    getConfig(): Promise<void>;
+    /**
+     * Turn off dimmer switch
+     */
+    turnOff(): Promise<boolean>;
+    /**
+     * Turn on dimmer switch
+     */
+    turnOn(): Promise<boolean>;
+    /**
+     * Set brightness level
+     */
+    setBrightness(brightness: number): Promise<boolean>;
+    /**
+     * Set RGB indicator color
+     */
+    rgbColorSet(red: number, green: number, blue: number): Promise<boolean>;
+    /**
+     * Turn on RGB indicator
+     */
+    rgbColorOff(): Promise<boolean>;
+    /**
+     * Turn RGB Color On
+     */
+    rgbColorOn(): Promise<boolean>;
+    /**
+     * Turn indicator light on
+     */
+    indicatorLightOn(): Promise<boolean>;
+    /**
+     * Turn indicator light off
+     */
+    indicatorLightOff(): Promise<boolean>;
+    get brightness(): number;
+    get indicatorLightStatus(): string;
+    get rgbLightStatus(): string;
+    get rgbLightValue(): Record<string, number>;
+}
+export declare const switchModules: Record<string, new (details: Record<string, any>, manager: VeSync) => VeSyncSwitch>;

package/dist/lib/vesyncSwitchImpl.js

@@ -0,0 +1,344 @@
+"use strict";
+/**
+ * VeSync Switch Implementations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.switchModules = exports.VeSyncDimmerSwitch = exports.VeSyncWallSwitch = void 0;
+const vesyncSwitch_1 = require("./vesyncSwitch");
+const helpers_1 = require("./helpers");
+const logger_1 = require("./logger");
+/**
+ * Basic Wall Switch Implementation (ESWL01, ESWL03)
+ */
+class VeSyncWallSwitch extends vesyncSwitch_1.VeSyncSwitch {
+    constructor(details, manager) {
+        super(details, manager);
+        logger_1.logger.debug(`Initialized VeSyncWallSwitch device: ${this.deviceName}`);
+    }
+    /**
+     * Get wall switch details
+     */
+    async getDetails() {
+        logger_1.logger.debug(`Getting details for device: ${this.deviceName}`);
+        const body = {
+            ...helpers_1.Helpers.reqBody(this.manager, 'devicedetail'),
+            uuid: this.cid,
+            method: 'devicedetail'
+        };
+        const [response] = await helpers_1.Helpers.callApi('/inwallswitch/v1/device/devicedetail', 'post', body, helpers_1.Helpers.reqHeaders(this.manager));
+        if ((response === null || response === void 0 ? void 0 : response.code) === 0 && (response === null || response === void 0 ? void 0 : response.result)) {
+            const result = response.result;
+            this.deviceStatus = result.deviceStatus || this.deviceStatus;
+            this.details.active_time = result.activeTime || 0;
+            this.connectionStatus = result.connectionStatus || this.connectionStatus;
+            logger_1.logger.debug(`Successfully got details for device: ${this.deviceName}`);
+        }
+        else {
+            logger_1.logger.error(`Failed to get details for device: ${this.deviceName}`);
+        }
+    }
+    /**
+     * Get switch device configuration info
+     */
+    async getConfig() {
+        logger_1.logger.debug(`Getting configuration for device: ${this.deviceName}`);
+        const body = {
+            ...helpers_1.Helpers.reqBody(this.manager, 'devicedetail'),
+            method: 'configurations',
+            uuid: this.cid
+        };
+        const [response] = await helpers_1.Helpers.callApi('/inwallswitch/v1/device/configurations', 'post', body, helpers_1.Helpers.reqHeaders(this.manager));
+        if ((response === null || response === void 0 ? void 0 : response.code) === 0) {
+            this.config = helpers_1.Helpers.buildConfigDict(response);
+            logger_1.logger.debug(`Successfully got configuration for device: ${this.deviceName}`);
+        }
+        else {
+            logger_1.logger.error(`Failed to get configuration for device: ${this.deviceName}`);
+        }
+    }
+    /**
+     * Turn off wall switch
+     */
+    async turnOff() {
+        logger_1.logger.debug(`Turning off device: ${this.deviceName}`);
+        const body = {
+            ...helpers_1.Helpers.reqBody(this.manager, 'devicestatus'),
+            status: 'off',
+            uuid: this.cid
+        };
+        const [response] = await helpers_1.Helpers.callApi('/inwallswitch/v1/device/devicestatus', 'put', body, helpers_1.Helpers.reqHeaders(this.manager));
+        if ((response === null || response === void 0 ? void 0 : response.code) === 0) {
+            this.deviceStatus = 'off';
+            logger_1.logger.debug(`Successfully turned off device: ${this.deviceName}`);
+            return true;
+        }
+        logger_1.logger.error(`Failed to turn off device: ${this.deviceName}`);
+        return false;
+    }
+    /**
+     * Turn on wall switch
+     */
+    async turnOn() {
+        logger_1.logger.debug(`Turning on device: ${this.deviceName}`);
+        const body = {
+            ...helpers_1.Helpers.reqBody(this.manager, 'devicestatus'),
+            status: 'on',
+            uuid: this.cid
+        };
+        const [response] = await helpers_1.Helpers.callApi('/inwallswitch/v1/device/devicestatus', 'put', body, helpers_1.Helpers.reqHeaders(this.manager));
+        if ((response === null || response === void 0 ? void 0 : response.code) === 0) {
+            this.deviceStatus = 'on';
+            logger_1.logger.debug(`Successfully turned on device: ${this.deviceName}`);
+            return true;
+        }
+        logger_1.logger.error(`Failed to turn on device: ${this.deviceName}`);
+        return false;
+    }
+}
+exports.VeSyncWallSwitch = VeSyncWallSwitch;
+/**
+ * Dimmer Switch Implementation (ESWD16)
+ */
+class VeSyncDimmerSwitch extends vesyncSwitch_1.VeSyncSwitch {
+    constructor(details, manager) {
+        super(details, manager);
+        this._brightness = 0;
+        this._rgbValue = { red: 0, blue: 0, green: 0 };
+        this._rgbStatus = 'unknown';
+        this._indicatorLight = 'unknown';
+        logger_1.logger.debug(`Initialized VeSyncDimmerSwitch device: ${this.deviceName}`);
+    }
+    /**
+     * Get dimmer switch details
+     */
+    async getDetails() {
+        logger_1.logger.debug(`Getting details for device: ${this.deviceName}`);
+        const body = {
+            ...helpers_1.Helpers.reqBody(this.manager, 'devicedetail'),
+            uuid: this.cid,
+            method: 'devicedetail'
+        };
+        const [response] = await helpers_1.Helpers.callApi('/dimmer/v1/device/devicedetail', 'post', body, helpers_1.Helpers.reqHeaders(this.manager));
+        if ((response === null || response === void 0 ? void 0 : response.code) === 0 && (response === null || response === void 0 ? void 0 : response.result)) {
+            const result = response.result;
+            this.deviceStatus = result.deviceStatus || this.deviceStatus;
+            this.details.active_time = result.activeTime || 0;
+            this.connectionStatus = result.connectionStatus || this.connectionStatus;
+            this._brightness = result.brightness || this._brightness;
+            this._rgbStatus = result.rgbStatus || this._rgbStatus;
+            this._indicatorLight = result.indicatorlightStatus || this._indicatorLight;
+            if (result.rgbValue) {
+                this._rgbValue = {
+                    red: result.rgbValue.red || 0,
+                    green: result.rgbValue.green || 0,
+                    blue: result.rgbValue.blue || 0
+                };
+            }
+            logger_1.logger.debug(`Successfully got details for device: ${this.deviceName}`);
+        }
+        else {
+            logger_1.logger.error(`Failed to get details for device: ${this.deviceName}`);
+        }
+    }
+    /**
+     * Get dimmer switch configuration info
+     */
+    async getConfig() {
+        logger_1.logger.debug(`Getting configuration for device: ${this.deviceName}`);
+        const body = {
+            ...helpers_1.Helpers.reqBody(this.manager, 'devicedetail'),
+            method: 'configurations',
+            uuid: this.cid
+        };
+        const [response] = await helpers_1.Helpers.callApi('/dimmer/v1/device/configurations', 'post', body, helpers_1.Helpers.reqHeaders(this.manager));
+        if ((response === null || response === void 0 ? void 0 : response.code) === 0) {
+            this.config = helpers_1.Helpers.buildConfigDict(response);
+            logger_1.logger.debug(`Successfully got configuration for device: ${this.deviceName}`);
+        }
+        else {
+            logger_1.logger.error(`Failed to get configuration for device: ${this.deviceName}`);
+        }
+    }
+    /**
+     * Turn off dimmer switch
+     */
+    async turnOff() {
+        logger_1.logger.debug(`Turning off device: ${this.deviceName}`);
+        const body = {
+            ...helpers_1.Helpers.reqBody(this.manager, 'devicestatus'),
+            status: 'off',
+            uuid: this.cid
+        };
+        const [response] = await helpers_1.Helpers.callApi('/dimmer/v1/device/devicestatus', 'put', body, helpers_1.Helpers.reqHeaders(this.manager));
+        if ((response === null || response === void 0 ? void 0 : response.code) === 0) {
+            this.deviceStatus = 'off';
+            logger_1.logger.debug(`Successfully turned off device: ${this.deviceName}`);
+            return true;
+        }
+        logger_1.logger.error(`Failed to turn off device: ${this.deviceName}`);
+        return false;
+    }
+    /**
+     * Turn on dimmer switch
+     */
+    async turnOn() {
+        logger_1.logger.debug(`Turning on device: ${this.deviceName}`);
+        const body = {
+            ...helpers_1.Helpers.reqBody(this.manager, 'devicestatus'),
+            status: 'on',
+            uuid: this.cid
+        };
+        const [response] = await helpers_1.Helpers.callApi('/dimmer/v1/device/devicestatus', 'put', body, helpers_1.Helpers.reqHeaders(this.manager));
+        if ((response === null || response === void 0 ? void 0 : response.code) === 0) {
+            this.deviceStatus = 'on';
+            logger_1.logger.debug(`Successfully turned on device: ${this.deviceName}`);
+            return true;
+        }
+        logger_1.logger.error(`Failed to turn on device: ${this.deviceName}`);
+        return false;
+    }
+    /**
+     * Set brightness level
+     */
+    async setBrightness(brightness) {
+        if (!this.isDimmable()) {
+            logger_1.logger.error(`Device ${this.deviceName} does not support dimming`);
+            return false;
+        }
+        logger_1.logger.debug(`Setting brightness to ${brightness} for device: ${this.deviceName}`);
+        const body = {
+            ...helpers_1.Helpers.reqBody(this.manager, 'devicestatus'),
+            brightness: brightness.toString(),
+            uuid: this.cid
+        };
+        const [response] = await helpers_1.Helpers.callApi('/dimmer/v1/device/updatebrightness', 'put', body, helpers_1.Helpers.reqHeaders(this.manager));
+        if ((response === null || response === void 0 ? void 0 : response.code) === 0) {
+            this._brightness = brightness;
+            logger_1.logger.debug(`Successfully set brightness to ${brightness} for device: ${this.deviceName}`);
+            return true;
+        }
+        logger_1.logger.error(`Failed to set brightness to ${brightness} for device: ${this.deviceName}`);
+        return false;
+    }
+    /**
+     * Set RGB indicator color
+     */
+    async rgbColorSet(red, green, blue) {
+        logger_1.logger.debug(`Setting RGB color to (${red}, ${green}, ${blue}) for device: ${this.deviceName}`);
+        const body = {
+            ...helpers_1.Helpers.reqBody(this.manager, 'devicestatus'),
+            rgbValue: {
+                red: Math.round(red),
+                green: Math.round(green),
+                blue: Math.round(blue)
+            },
+            status: 'on',
+            uuid: this.cid
+        };
+        const [response] = await helpers_1.Helpers.callApi('/dimmer/v1/device/devicergbstatus', 'put', body, helpers_1.Helpers.reqHeaders(this.manager));
+        if ((response === null || response === void 0 ? void 0 : response.code) === 0) {
+            this._rgbValue = { red, green, blue };
+            this._rgbStatus = 'on';
+            logger_1.logger.debug(`Successfully set RGB color for device: ${this.deviceName}`);
+            return true;
+        }
+        logger_1.logger.error(`Failed to set RGB color for device: ${this.deviceName}`);
+        return false;
+    }
+    /**
+     * Turn on RGB indicator
+     */
+    async rgbColorOff() {
+        logger_1.logger.debug(`Turning off RGB color for device: ${this.deviceName}`);
+        const body = {
+            ...helpers_1.Helpers.reqBody(this.manager, 'devicestatus'),
+            status: 'off',
+            uuid: this.cid
+        };
+        const [response] = await helpers_1.Helpers.callApi('/dimmer/v1/device/devicergbstatus', 'put', body, helpers_1.Helpers.reqHeaders(this.manager));
+        if ((response === null || response === void 0 ? void 0 : response.code) === 0) {
+            this._rgbStatus = 'off';
+            logger_1.logger.debug(`Successfully turned off RGB color for device: ${this.deviceName}`);
+            return true;
+        }
+        logger_1.logger.error(`Failed to turn off RGB color for device: ${this.deviceName}`);
+        return false;
+    }
+    /**
+     * Turn RGB Color On
+     */
+    async rgbColorOn() {
+        logger_1.logger.debug(`Turning on RGB color for device: ${this.deviceName}`);
+        const body = {
+            ...helpers_1.Helpers.reqBody(this.manager, 'devicestatus'),
+            uuid: this.cid,
+            status: 'on'
+        };
+        const [response] = await helpers_1.Helpers.callApi('/dimmer/v1/device/devicergbstatus', 'put', body, helpers_1.Helpers.reqHeaders(this.manager));
+        if ((response === null || response === void 0 ? void 0 : response.code) === 0) {
+            this._rgbStatus = 'on';
+            logger_1.logger.debug(`Successfully turned on RGB color for device: ${this.deviceName}`);
+            return true;
+        }
+        logger_1.logger.error(`Failed to turn on RGB color for device: ${this.deviceName}`);
+        return false;
+    }
+    /**
+     * Turn indicator light on
+     */
+    async indicatorLightOn() {
+        logger_1.logger.debug(`Turning on indicator light for device: ${this.deviceName}`);
+        const body = {
+            ...helpers_1.Helpers.reqBody(this.manager, 'devicestatus'),
+            uuid: this.cid,
+            status: 'on'
+        };
+        const [response] = await helpers_1.Helpers.callApi('/dimmer/v1/device/indicatorlightstatus', 'put', body, helpers_1.Helpers.reqHeaders(this.manager));
+        if ((response === null || response === void 0 ? void 0 : response.code) === 0) {
+            this._indicatorLight = 'on';
+            logger_1.logger.debug(`Successfully turned on indicator light for device: ${this.deviceName}`);
+            return true;
+        }
+        logger_1.logger.error(`Failed to turn on indicator light for device: ${this.deviceName}`);
+        return false;
+    }
+    /**
+     * Turn indicator light off
+     */
+    async indicatorLightOff() {
+        logger_1.logger.debug(`Turning off indicator light for device: ${this.deviceName}`);
+        const body = {
+            ...helpers_1.Helpers.reqBody(this.manager, 'devicestatus'),
+            uuid: this.cid,
+            status: 'off'
+        };
+        const [response] = await helpers_1.Helpers.callApi('/dimmer/v1/device/indicatorlightstatus', 'put', body, helpers_1.Helpers.reqHeaders(this.manager));
+        if ((response === null || response === void 0 ? void 0 : response.code) === 0) {
+            this._indicatorLight = 'off';
+            logger_1.logger.debug(`Successfully turned off indicator light for device: ${this.deviceName}`);
+            return true;
+        }
+        logger_1.logger.error(`Failed to turn off indicator light for device: ${this.deviceName}`);
+        return false;
+    }
+    // Getters
+    get brightness() {
+        return this._brightness;
+    }
+    get indicatorLightStatus() {
+        return this._indicatorLight;
+    }
+    get rgbLightStatus() {
+        return this._rgbStatus;
+    }
+    get rgbLightValue() {
+        return { ...this._rgbValue };
+    }
+}
+exports.VeSyncDimmerSwitch = VeSyncDimmerSwitch;
+// Export switch modules dictionary
+exports.switchModules = {
+    'ESWL01': VeSyncWallSwitch,
+    'ESWL03': VeSyncWallSwitch,
+    'ESWD16': VeSyncDimmerSwitch
+};

package/package.json

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

package/src/index.ts

@@ -0,0 +1,14 @@
+// Export main VeSync manager class
+export { VeSync } from './lib/vesync';
+
+// Export device classes
+export { VeSyncAirBypass } from './lib/vesyncFanImpl';
+export { VeSyncOutlet7A, VeSyncOutlet10A, VeSyncOutlet15A, VeSyncOutdoorPlug } from './lib/vesyncOutletImpl';
+export { VeSyncBulb } from './lib/vesyncBulb';
+export { VeSyncWallSwitch } from './lib/vesyncSwitchImpl';
+
+// Export base device class
+export { VeSyncBaseDevice } from './lib/vesyncBaseDevice';
+
+// Export helper functions
+export { Helpers, setApiBaseUrl } from './lib/helpers'; 

package/src/lib/helpers.ts

@@ -5,6 +5,7 @@
 import axios from 'axios';
 import crypto from 'crypto';
 import { VeSync } from './vesync';
+import { logger } from './logger';
 
 // API configuration
 let _apiBaseUrl = 'https://smartapi.vesync.com';
@@ -216,7 +217,7 @@ export class Helpers {
             if (error.response) {
                 return [error.response.data, error.response.status];
             }
-            console.error('API call failed:', error.message);
+            logger.error('API call failed:', error.message);
             return [null, 0];
         }
     }
@@ -238,7 +239,7 @@ export class Helpers {
             const decoded = Buffer.from(value, 'hex');
             return decoded.readFloatBE(0).toString();
         } catch (error) {
-            console.debug('Error decoding hex value:', error);
+            logger.debug('Error decoding hex value:', error);
             return '0';
         }
     }

package/src/lib/logger.ts

@@ -0,0 +1,60 @@
+/**
+ * Logger utility for TSVeSync
+ */
+
+export enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+
+export class Logger {
+    private static instance: Logger;
+    private currentLevel: LogLevel = LogLevel.INFO;
+
+    private constructor() {}
+
+    static getInstance(): Logger {
+        if (!Logger.instance) {
+            Logger.instance = new Logger();
+        }
+        return Logger.instance;
+    }
+
+    setLevel(level: LogLevel): void {
+        this.currentLevel = level;
+    }
+
+    getLevel(): LogLevel {
+        return this.currentLevel;
+    }
+
+    debug(message: string, ...args: any[]): void {
+        if (this.currentLevel <= LogLevel.DEBUG) {
+            console.log(`[DEBUG] ${message}`, ...args);
+        }
+    }
+
+    info(message: string, ...args: any[]): void {
+        if (this.currentLevel <= LogLevel.INFO) {
+            console.log(`[INFO] ${message}`, ...args);
+        }
+    }
+
+    warn(message: string, ...args: any[]): void {
+        if (this.currentLevel <= LogLevel.WARN) {
+            console.warn(`[WARN] ${message}`, ...args);
+        }
+    }
+
+    error(message: string, ...args: any[]): void {
+        if (this.currentLevel <= LogLevel.ERROR) {
+            console.error(`[ERROR] ${message}`, ...args);
+        }
+    }
+}
+
+// Export singleton instance
+export const logger = Logger.getInstance();