node-switchbot 2.5.0-beta.2 → 2.5.0-beta.21

package/dist/device/woplugmini.js

@@ -1,60 +1,52 @@
-import { Buffer } from 'node:buffer';
 /* Copyright(C) 2024, donavanbecker (https://github.com/donavanbecker). All rights reserved.
  *
  * woplugmini.ts: Switchbot BLE API registration.
  */
+import { Buffer } from 'node:buffer';
 import { SwitchbotDevice } from '../device.js';
 import { SwitchBotBLEModel, SwitchBotBLEModelFriendlyName, SwitchBotBLEModelName } from '../types/types.js';
 /**
+ * Class representing a WoPlugMini device.
  * @see https://github.com/OpenWonderLabs/SwitchBotAPI-BLE/blob/latest/devicetypes/plugmini.md
  */
 export class WoPlugMini extends SwitchbotDevice {
+    /**
+     * Parses the service data for WoPlugMini US.
+     * @param {Buffer} manufacturerData - The manufacturer data buffer.
+     * @param {Function} [onlog] - Optional logging function.
+     * @returns {Promise<object | null>} - Parsed service data or null if invalid.
+     */
     static async parseServiceData_US(manufacturerData, onlog) {
-        if (manufacturerData.length !== 14) {
-            if (onlog && typeof onlog === 'function') {
-                onlog(`[parseServiceDataForWoPlugMiniUS] Buffer length ${manufacturerData.length} should be 14`);
-            }
-            return null;
-        }
-        const byte9 = manufacturerData.readUInt8(9); // byte9:  plug mini state; 0x00=off, 0x80=on
-        const byte10 = manufacturerData.readUInt8(10); // byte10: bit0: 0=no delay,1=delay, bit1:0=no timer, 1=timer; bit2:0=no sync time, 1=sync'ed time
-        const byte11 = manufacturerData.readUInt8(11); // byte11: wifi rssi
-        const byte12 = manufacturerData.readUInt8(12); // byte12: bit7: overload?
-        const byte13 = manufacturerData.readUInt8(13); // byte12[bit0~6] + byte13: current power value
-        const state = byte9 === 0x00 ? 'off' : byte9 === 0x80 ? 'on' : null;
-        const delay = !!(byte10 & 0b00000001);
-        const timer = !!(byte10 & 0b00000010);
-        const syncUtcTime = !!(byte10 & 0b00000100);
-        const wifiRssi = byte11;
-        const overload = !!(byte12 & 0b10000000);
-        const currentPower = (((byte12 & 0b01111111) << 8) + byte13) / 10; // in watt
-        // TODO: voltage ???
-        const data = {
-            model: SwitchBotBLEModel.PlugMiniUS,
-            modelName: SwitchBotBLEModelName.PlugMini,
-            modelFriendlyName: SwitchBotBLEModelFriendlyName.PlugMini,
-            state,
-            delay,
-            timer,
-            syncUtcTime,
-            wifiRssi,
-            overload,
-            currentPower,
-        };
-        return data;
+        return this.parseServiceData(manufacturerData, SwitchBotBLEModel.PlugMiniUS, onlog);
     }
+    /**
+     * Parses the service data for WoPlugMini JP.
+     * @param {Buffer} manufacturerData - The manufacturer data buffer.
+     * @param {Function} [onlog] - Optional logging function.
+     * @returns {Promise<object | null>} - Parsed service data or null if invalid.
+     */
     static async parseServiceData_JP(manufacturerData, onlog) {
+        return this.parseServiceData(manufacturerData, SwitchBotBLEModel.PlugMiniJP, onlog);
+    }
+    /**
+     * Parses the service data for WoPlugMini.
+     * @param {Buffer} manufacturerData - The manufacturer data buffer.
+     * @param {SwitchBotBLEModel} model - The model of the plug mini.
+     * @param {Function} [onlog] - Optional logging function.
+     * @returns {Promise<object | null>} - Parsed service data or null if invalid.
+     */
+    static async parseServiceData(manufacturerData, model, onlog) {
         if (manufacturerData.length !== 14) {
-            if (onlog && typeof onlog === 'function') {
-                onlog(`[parseServiceDataForWoPlugMiniJP] Buffer length ${manufacturerData.length} should be 14`);
-            }
+            onlog?.(`[parseServiceDataForWoPlugMini] Buffer length ${manufacturerData.length} should be 14`);
             return null;
         }
-        const byte9 = manufacturerData.readUInt8(9); // byte9:  plug mini state; 0x00=off, 0x80=on
-        const byte10 = manufacturerData.readUInt8(10); // byte10: bit0: 0=no delay,1=delay, bit1:0=no timer, 1=timer; bit2:0=no sync time, 1=sync'ed time
-        const byte11 = manufacturerData.readUInt8(11); // byte11: wifi rssi
-        const byte12 = manufacturerData.readUInt8(12); // byte12: bit7: overload?
-        const byte13 = manufacturerData.readUInt8(13); // byte12[bit0~6] + byte13: current power value
+        const [byte9, byte10, byte11, byte12, byte13] = [
+            manufacturerData.readUInt8(9),
+            manufacturerData.readUInt8(10),
+            manufacturerData.readUInt8(11),
+            manufacturerData.readUInt8(12),
+            manufacturerData.readUInt8(13),
+        ];
         const state = byte9 === 0x00 ? 'off' : byte9 === 0x80 ? 'on' : null;
         const delay = !!(byte10 & 0b00000001);
         const timer = !!(byte10 & 0b00000010);
@@ -62,9 +54,8 @@ export class WoPlugMini extends SwitchbotDevice {
         const wifiRssi = byte11;
         const overload = !!(byte12 & 0b10000000);
         const currentPower = (((byte12 & 0b01111111) << 8) + byte13) / 10; // in watt
-        // TODO: voltage ???
-        const data = {
-            model: SwitchBotBLEModel.PlugMiniJP,
+        return {
+            model,
             modelName: SwitchBotBLEModelName.PlugMini,
             modelFriendlyName: SwitchBotBLEModelFriendlyName.PlugMini,
             state,
@@ -75,61 +66,64 @@ export class WoPlugMini extends SwitchbotDevice {
             overload,
             currentPower,
         };
-        return data;
     }
     /**
-     * @returns resolves with a boolean that tells whether the plug in ON(true) or OFF(false)
+     * Reads the state of the plug.
+     * @returns {Promise<boolean>} - Resolves with a boolean that tells whether the plug is ON (true) or OFF (false).
      */
     async readState() {
-        return await this.operatePlug([0x57, 0x0F, 0x51, 0x01]);
+        return this.operatePlug([0x57, 0x0F, 0x51, 0x01]);
     }
     /**
+     * Sets the state of the plug.
      * @private
+     * @param {number[]} reqByteArray - The request byte array.
+     * @returns {Promise<boolean>} - Resolves with a boolean that tells whether the plug is ON (true) or OFF (false).
      */
     async setState(reqByteArray) {
         const base = [0x57, 0x0F, 0x50, 0x01];
-        return await this.operatePlug([...base, ...reqByteArray]);
+        return this.operatePlug([...base, ...reqByteArray]);
     }
     /**
-     * @returns resolves with a boolean that tells whether the plug in ON(true) or OFF(false)
+     * Turns on the plug.
+     * @returns {Promise<boolean>} - Resolves with a boolean that tells whether the plug is ON (true) or OFF (false).
      */
     async turnOn() {
-        return await this.setState([0x01, 0x80]);
+        return this.setState([0x01, 0x80]);
     }
     /**
-     * @returns resolves with a boolean that tells whether the plug in ON(true) or OFF(false)
+     * Turns off the plug.
+     * @returns {Promise<boolean>} - Resolves with a boolean that tells whether the plug is ON (true) or OFF (false).
      */
     async turnOff() {
-        return await this.setState([0x01, 0x00]);
+        return this.setState([0x01, 0x00]);
     }
     /**
-     * @returns resolves with a boolean that tells whether the plug in ON(true) or OFF(false)
+     * Toggles the state of the plug.
+     * @returns {Promise<boolean>} - Resolves with a boolean that tells whether the plug is ON (true) or OFF (false).
      */
     async toggle() {
-        return await this.setState([0x02, 0x80]);
+        return this.setState([0x02, 0x80]);
     }
+    /**
+     * Operates the plug with the given bytes.
+     * @param {number[]} bytes - The byte array to send to the plug.
+     * @returns {Promise<boolean>} - Resolves with a boolean that tells whether the plug is ON (true) or OFF (false).
+     */
     async operatePlug(bytes) {
-        const req_buf = Buffer.from(bytes);
-        await this.command(req_buf)
-            .then((res_bytes) => {
-            const res_buf = Buffer.from(res_bytes);
-            if (res_buf.length === 2) {
-                const code = res_buf.readUInt8(1);
-                if (code === 0x00 || code === 0x80) {
-                    const is_on = code === 0x80;
-                    return is_on;
-                }
-                else {
-                    throw new Error(`The device returned an error: 0x${res_buf.toString('hex')}`);
-                }
-            }
-            else {
-                throw new Error(`Expecting a 2-byte response, got instead: 0x${res_buf.toString('hex')}`);
-            }
-        })
-            .catch((error) => {
-            throw error;
-        });
+        const reqBuf = Buffer.from(bytes);
+        const resBytes = await this.command(reqBuf);
+        const resBuf = Buffer.from(resBytes);
+        if (resBuf.length !== 2) {
+            throw new Error(`Expecting a 2-byte response, got instead: 0x${resBuf.toString('hex')}`);
+        }
+        const code = resBuf.readUInt8(1);
+        if (code === 0x00 || code === 0x80) {
+            return code === 0x80;
+        }
+        else {
+            throw new Error(`The device returned an error: 0x${resBuf.toString('hex')}`);
+        }
     }
 }
 //# sourceMappingURL=woplugmini.js.map

package/dist/device/woplugmini.js.map

@@ -1 +1 @@
-{"version":3,"file":"woplugmini.js","sourceRoot":"","sources":["../../src/device/woplugmini.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"woplugmini.js","sourceRoot":"","sources":["../../src/device/woplugmini.ts"],"names":[],"mappings":"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"}

package/dist/device/wopresence.d.ts

@@ -1,7 +1,17 @@
 import type { Buffer } from 'node:buffer';
 import type { motionSensorServiceData } from '../types/bledevicestatus.js';
 import { SwitchbotDevice } from '../device.js';
+/**
+ * Class representing a WoPresence device.
+ * @see https://github.com/OpenWonderLabs/SwitchBotAPI-BLE/blob/latest/devicetypes/meter.md
+ */
 export declare class WoPresence extends SwitchbotDevice {
-    static parseServiceData(serviceData: Buffer, onlog: ((message: string) => void) | undefined): Promise<motionSensorServiceData | null>;
+    /**
+     * Parses the service data for WoPresence.
+     * @param {Buffer} serviceData - The service data buffer.
+     * @param {Function} [onlog] - Optional logging function.
+     * @returns {Promise<motionSensorServiceData | null>} - Parsed service data or null if invalid.
+     */
+    static parseServiceData(serviceData: Buffer, onlog?: (message: string) => void): Promise<motionSensorServiceData | null>;
 }
 //# sourceMappingURL=wopresence.d.ts.map

package/dist/device/wopresence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wopresence.d.ts","sourceRoot":"","sources":["../../src/device/wopresence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAM1E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAG9C,qBAAa,UAAW,SAAQ,eAAe;WAChC,gBAAgB,CAC3B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,GAC7C,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;CAqC3C"}
+{"version":3,"file":"wopresence.d.ts","sourceRoot":"","sources":["../../src/device/wopresence.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAE1E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAG9C;;;GAGG;AACH,qBAAa,UAAW,SAAQ,eAAe;IAC7C;;;;;OAKG;WACU,gBAAgB,CAC3B,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;CAwB3C"}

package/dist/device/wopresence.js

@@ -1,40 +1,34 @@
-/* Copyright(C) 2024, donavanbecker (https://github.com/donavanbecker). All rights reserved.
- *
- * wopresence.ts: Switchbot BLE API registration.
- */
 import { SwitchbotDevice } from '../device.js';
 import { SwitchBotBLEModel, SwitchBotBLEModelFriendlyName, SwitchBotBLEModelName } from '../types/types.js';
+/**
+ * Class representing a WoPresence device.
+ * @see https://github.com/OpenWonderLabs/SwitchBotAPI-BLE/blob/latest/devicetypes/meter.md
+ */
 export class WoPresence extends SwitchbotDevice {
+    /**
+     * Parses the service data for WoPresence.
+     * @param {Buffer} serviceData - The service data buffer.
+     * @param {Function} [onlog] - Optional logging function.
+     * @returns {Promise<motionSensorServiceData | null>} - Parsed service data or null if invalid.
+     */
     static async parseServiceData(serviceData, onlog) {
         if (serviceData.length !== 6) {
-            if (onlog && typeof onlog === 'function') {
-                onlog(`[parseServiceDataForWoPresence] Buffer length ${serviceData.length} !== 6!`);
-            }
+            onlog?.(`[parseServiceDataForWoPresence] Buffer length ${serviceData.length} !== 6!`);
             return null;
         }
-        const byte1 = serviceData.readUInt8(1);
-        const byte2 = serviceData.readUInt8(2);
-        const byte5 = serviceData.readUInt8(5);
-        const tested = !!(byte1 & 0b10000000);
-        const movement = !!(byte1 & 0b01000000);
-        const battery = byte2 & 0b01111111;
-        const led = (byte5 & 0b00100000) >> 5;
-        const iot = (byte5 & 0b00010000) >> 4;
-        const sense_distance = (byte5 & 0b00001100) >> 2;
-        const lightLevel = byte5 & 0b00000011;
-        const is_light = !!(byte5 & 0b00000010);
+        const [byte1, byte2, , , , byte5] = serviceData;
         const data = {
             model: SwitchBotBLEModel.MotionSensor,
             modelName: SwitchBotBLEModelName.MotionSensor,
             modelFriendlyName: SwitchBotBLEModelFriendlyName.MotionSensor,
-            tested,
-            movement,
-            battery,
-            led,
-            iot,
-            sense_distance,
-            lightLevel: lightLevel === 1 ? 'dark' : lightLevel === 2 ? 'bright' : 'unknown',
-            is_light,
+            tested: !!(byte1 & 0b10000000),
+            movement: !!(byte1 & 0b01000000),
+            battery: byte2 & 0b01111111,
+            led: (byte5 & 0b00100000) >> 5,
+            iot: (byte5 & 0b00010000) >> 4,
+            sense_distance: (byte5 & 0b00001100) >> 2,
+            lightLevel: (byte5 & 0b00000011) === 1 ? 'dark' : (byte5 & 0b00000011) === 2 ? 'bright' : 'unknown',
+            is_light: !!(byte5 & 0b00000010),
         };
         return data;
     }

package/dist/device/wopresence.js.map

@@ -1 +1 @@
-{"version":3,"file":"wopresence.js","sourceRoot":"","sources":["../../src/device/wopresence.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAE3G,MAAM,OAAO,UAAW,SAAQ,eAAe;IAC7C,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAC3B,WAAmB,EACnB,KAA8C;QAE9C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBACzC,KAAK,CAAC,iDAAiD,WAAW,CAAC,MAAM,SAAS,CAAC,CAAA;YACrF,CAAC;YACD,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;QACtC,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;QACtC,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;QAEtC,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,CAAA;QACrC,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,CAAA;QACvC,MAAM,OAAO,GAAG,KAAK,GAAG,UAAU,CAAA;QAClC,MAAM,GAAG,GAAG,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QACrC,MAAM,GAAG,GAAG,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QACrC,MAAM,cAAc,GAAG,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAChD,MAAM,UAAU,GAAG,KAAK,GAAG,UAAU,CAAA;QACrC,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,CAAA;QAEvC,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,iBAAiB,CAAC,YAAY;YACrC,SAAS,EAAE,qBAAqB,CAAC,YAAY;YAC7C,iBAAiB,EAAE,6BAA6B,CAAC,YAAY;YAC7D,MAAM;YACN,QAAQ;YACR,OAAO;YACP,GAAG;YACH,GAAG;YACH,cAAc;YACd,UAAU,EAAE,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YAC/E,QAAQ;SACT,CAAA;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}
+{"version":3,"file":"wopresence.js","sourceRoot":"","sources":["../../src/device/wopresence.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAE3G;;;GAGG;AACH,MAAM,OAAO,UAAW,SAAQ,eAAe;IAC7C;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAC3B,WAAmB,EACnB,KAAiC;QAEjC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,KAAK,EAAE,CAAC,iDAAiD,WAAW,CAAC,MAAM,SAAS,CAAC,CAAA;YACrF,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,AAAD,EAAG,AAAD,EAAG,AAAD,EAAG,KAAK,CAAC,GAAG,WAAW,CAAA;QAE/C,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,iBAAiB,CAAC,YAAY;YACrC,SAAS,EAAE,qBAAqB,CAAC,YAAY;YAC7C,iBAAiB,EAAE,6BAA6B,CAAC,YAAY;YAC7D,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC;YAC9B,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC;YAChC,OAAO,EAAE,KAAK,GAAG,UAAU;YAC3B,GAAG,EAAE,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC;YAC9B,GAAG,EAAE,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC;YAC9B,cAAc,EAAE,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC;YACzC,UAAU,EAAE,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YACnG,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC;SACjC,CAAA;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/device/wosensorth.d.ts

@@ -1,8 +1,24 @@
 import type { Buffer } from 'node:buffer';
 import type { meterPlusServiceData, meterServiceData } from '../types/bledevicestatus.js';
 import { SwitchbotDevice } from '../device.js';
+/**
+ * Class representing a WoSensorTH device.
+ * @see https://github.com/OpenWonderLabs/SwitchBotAPI-BLE/blob/latest/devicetypes/meter.md
+ */
 export declare class WoSensorTH extends SwitchbotDevice {
-    static parseServiceData(serviceData: Buffer, onlog: ((message: string) => void) | undefined): Promise<meterServiceData | null>;
-    static parseServiceData_Plus(serviceData: Buffer, onlog: ((message: string) => void) | undefined): Promise<meterPlusServiceData | null>;
+    /**
+     * Parses the service data for WoSensorTH.
+     * @param {Buffer} serviceData - The service data buffer.
+     * @param {Function} [onlog] - Optional logging function.
+     * @returns {Promise<meterServiceData | null>} - Parsed service data or null if invalid.
+     */
+    static parseServiceData(serviceData: Buffer, onlog?: (message: string) => void): Promise<meterServiceData | null>;
+    /**
+     * Parses the service data for WoSensorTH Plus.
+     * @param {Buffer} serviceData - The service data buffer.
+     * @param {Function} [onlog] - Optional logging function.
+     * @returns {Promise<meterPlusServiceData | null>} - Parsed service data or null if invalid.
+     */
+    static parseServiceData_Plus(serviceData: Buffer, onlog?: (message: string) => void): Promise<meterPlusServiceData | null>;
 }
 //# sourceMappingURL=wosensorth.d.ts.map

package/dist/device/wosensorth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wosensorth.d.ts","sourceRoot":"","sources":["../../src/device/wosensorth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAMzF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAG9C,qBAAa,UAAW,SAAQ,eAAe;WAChC,gBAAgB,CAC3B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,GAC7C,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;WAsCtB,qBAAqB,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,GAC7C,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;CAqCxC"}
+{"version":3,"file":"wosensorth.d.ts","sourceRoot":"","sources":["../../src/device/wosensorth.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAEzF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAG9C;;;GAGG;AACH,qBAAa,UAAW,SAAQ,eAAe;IAC7C;;;;;OAKG;WACU,gBAAgB,CAC3B,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAuBnC;;;;;OAKG;WACU,qBAAqB,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;CAsBxC"}

package/dist/device/wosensorth.js

@@ -1,77 +1,61 @@
-/* Copyright(C) 2024, donavanbecker (https://github.com/donavanbecker). All rights reserved.
- *
- * wosensorth.ts: Switchbot BLE API registration.
- */
 import { SwitchbotDevice } from '../device.js';
 import { SwitchBotBLEModel, SwitchBotBLEModelFriendlyName, SwitchBotBLEModelName } from '../types/types.js';
+/**
+ * Class representing a WoSensorTH device.
+ * @see https://github.com/OpenWonderLabs/SwitchBotAPI-BLE/blob/latest/devicetypes/meter.md
+ */
 export class WoSensorTH extends SwitchbotDevice {
+    /**
+     * Parses the service data for WoSensorTH.
+     * @param {Buffer} serviceData - The service data buffer.
+     * @param {Function} [onlog] - Optional logging function.
+     * @returns {Promise<meterServiceData | null>} - Parsed service data or null if invalid.
+     */
     static async parseServiceData(serviceData, onlog) {
         if (serviceData.length !== 6) {
-            if (onlog && typeof onlog === 'function') {
-                onlog(`[parseServiceDataForWoSensorTH] Buffer length ${serviceData.length} !== 6!`);
-            }
+            onlog?.(`[parseServiceDataForWoSensorTH] Buffer length ${serviceData.length} !== 6!`);
             return null;
         }
-        const byte2 = serviceData.readUInt8(2);
-        const byte3 = serviceData.readUInt8(3);
-        const byte4 = serviceData.readUInt8(4);
-        const byte5 = serviceData.readUInt8(5);
-        const temp_sign = byte4 & 0b10000000 ? 1 : -1;
-        const temp_c = temp_sign * ((byte4 & 0b01111111) + (byte3 & 0b00001111) / 10);
-        const temp_f = Math.round(((temp_c * 9 / 5) + 32) * 10) / 10;
-        const data = {
+        const [byte2, byte3, byte4, byte5] = [serviceData.readUInt8(2), serviceData.readUInt8(3), serviceData.readUInt8(4), serviceData.readUInt8(5)];
+        const tempSign = byte4 & 0b10000000 ? 1 : -1;
+        const tempC = tempSign * ((byte4 & 0b01111111) + (byte3 & 0b00001111) / 10);
+        const tempF = Math.round(((tempC * 9 / 5) + 32) * 10) / 10;
+        return {
             model: SwitchBotBLEModel.Meter,
             modelName: SwitchBotBLEModelName.Meter,
             modelFriendlyName: SwitchBotBLEModelFriendlyName.Meter,
-            /**
-             * @deprecated The `temperature` object is deprecated and will be removed in future versions.
-             * Use the `celcius` and `fahrenheit` properties directly instead.
-             */
-            temperature: {
-                c: temp_c,
-                f: temp_f,
-            },
-            celcius: temp_c,
-            fahrenheit: temp_f,
+            celsius: tempC,
+            fahrenheit: tempF,
             fahrenheit_mode: !!(byte5 & 0b10000000),
             humidity: byte5 & 0b01111111,
             battery: byte2 & 0b01111111,
         };
-        return data;
     }
+    /**
+     * Parses the service data for WoSensorTH Plus.
+     * @param {Buffer} serviceData - The service data buffer.
+     * @param {Function} [onlog] - Optional logging function.
+     * @returns {Promise<meterPlusServiceData | null>} - Parsed service data or null if invalid.
+     */
     static async parseServiceData_Plus(serviceData, onlog) {
         if (serviceData.length !== 6) {
-            if (onlog && typeof onlog === 'function') {
-                onlog(`[parseServiceDataForWoSensorTHPlus] Buffer length ${serviceData.length} !== 6!`);
-            }
+            onlog?.(`[parseServiceDataForWoSensorTHPlus] Buffer length ${serviceData.length} !== 6!`);
             return null;
         }
-        const byte2 = serviceData.readUInt8(2);
-        const byte3 = serviceData.readUInt8(3);
-        const byte4 = serviceData.readUInt8(4);
-        const byte5 = serviceData.readUInt8(5);
-        const temp_sign = byte4 & 0b10000000 ? 1 : -1;
-        const temp_c = temp_sign * ((byte4 & 0b01111111) + (byte3 & 0b00001111) / 10);
-        const temp_f = Math.round(((temp_c * 9 / 5) + 32) * 10) / 10;
-        const data = {
+        const [byte2, byte3, byte4, byte5] = [serviceData.readUInt8(2), serviceData.readUInt8(3), serviceData.readUInt8(4), serviceData.readUInt8(5)];
+        const tempSign = byte4 & 0b10000000 ? 1 : -1;
+        const tempC = tempSign * ((byte4 & 0b01111111) + (byte3 & 0b00001111) / 10);
+        const tempF = Math.round(((tempC * 9 / 5) + 32) * 10) / 10;
+        return {
             model: SwitchBotBLEModel.MeterPlus,
             modelName: SwitchBotBLEModelName.MeterPlus,
             modelFriendlyName: SwitchBotBLEModelFriendlyName.MeterPlus,
-            /**
-             * @deprecated The `temperature` object is deprecated and will be removed in future versions.
-             * Use the `celcius` and `fahrenheit` properties directly instead.
-             */
-            temperature: {
-                c: temp_c,
-                f: temp_f,
-            },
-            celcius: temp_c,
-            fahrenheit: temp_f,
+            celsius: tempC,
+            fahrenheit: tempF,
             fahrenheit_mode: !!(byte5 & 0b10000000),
             humidity: byte5 & 0b01111111,
             battery: byte2 & 0b01111111,
         };
-        return data;
     }
 }
 //# sourceMappingURL=wosensorth.js.map

package/dist/device/wosensorth.js.map

@@ -1 +1 @@
-{"version":3,"file":"wosensorth.js","sourceRoot":"","sources":["../../src/device/wosensorth.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wosensorth.js","sourceRoot":"","sources":["../../src/device/wosensorth.ts"],"names":[],"mappings":"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"}

package/dist/device/wosmartlock.d.ts

@@ -2,17 +2,14 @@ import type * as Noble from '@stoprocent/noble';
 import type { lockServiceData } from '../types/bledevicestatus.js';
 import { Buffer } from 'node:buffer';
 import { SwitchbotDevice } from '../device.js';
+/**
+ * Class representing a WoSmartLock device.
+ * @see https://github.com/OpenWonderLabs/SwitchBotAPI-BLE/blob/latest/devicetypes/lock.md
+ */
 export declare class WoSmartLock extends SwitchbotDevice {
     iv: Buffer | null;
     key_id: string;
     encryption_key: Buffer | null;
-    static COMMAND_GET_CKiv: string;
-    static COMMAND_LOCK_INFO: string;
-    static COMMAND_UNLOCK: string;
-    static COMMAND_UNLOCK_NO_UNLATCH: string;
-    static COMMAND_LOCK: string;
-    static COMMAND_ENABLE_NOTIFICATIONS: string;
-    static COMMAND_DISABLE_NOTIFICATIONS: string;
     static Result: {
         ERROR: number;
         SUCCESS: number;
@@ -20,17 +17,63 @@ export declare class WoSmartLock extends SwitchbotDevice {
     };
     static validateResponse(res: Buffer): Promise<number>;
     static getLockStatus(code: number): string;
-    static parseServiceData(serviceData: Buffer, manufacturerData: Buffer, onlog: ((message: string) => void) | undefined): Promise<lockServiceData | null>;
+    static parseServiceData(serviceData: Buffer, manufacturerData: Buffer, onlog?: (message: string) => void): Promise<lockServiceData | null>;
     constructor(peripheral: Noble.Peripheral, noble: typeof Noble);
+    /**
+     * Initializes the encryption key info for valid lock communication.
+     * @param {string} keyId - The key ID.
+     * @param {string} encryptionKey - The encryption key.
+     */
     setKey(keyId: string, encryptionKey: string): Promise<void>;
-    unlock(): Promise<void>;
-    unlockNoUnlatch(): Promise<void>;
-    lock(): Promise<void>;
-    info(): Promise<void>;
+    /**
+     * Unlocks the Smart Lock.
+     * @returns {Promise<number>} - The result of the unlock operation.
+     */
+    unlock(): Promise<number>;
+    /**
+     * Unlocks the Smart Lock without unlatching the door.
+     * @returns {Promise<number>} - The result of the unlock operation.
+     */
+    unlockNoUnlatch(): Promise<number>;
+    /**
+     * Locks the Smart Lock.
+     * @returns {Promise<number>} - The result of the lock operation.
+     */
+    lock(): Promise<number>;
+    /**
+     * Gets general state info from the Smart Lock.
+     * @returns {Promise<object | null>} - The state object or null if an error occurred.
+     */
+    info(): Promise<object | null>;
+    /**
+     * Encrypts a string using AES-128-CTR.
+     * @param {string} str - The string to encrypt.
+     * @returns {Promise<string>} - The encrypted string in hex format.
+     */
     encrypt(str: string): Promise<string>;
+    /**
+     * Decrypts a buffer using AES-128-CTR.
+     * @param {Buffer} data - The data to decrypt.
+     * @returns {Promise<Buffer>} - The decrypted data.
+     */
     decrypt(data: Buffer): Promise<Buffer>;
+    /**
+     * Retrieves the IV from the device.
+     * @returns {Promise<Buffer>} - The IV buffer.
+     */
     getIv(): Promise<Buffer>;
+    /**
+     * Sends an encrypted command to the device.
+     * @param {string} key - The command key.
+     * @returns {Promise<Buffer>} - The response buffer.
+     */
     encryptedCommand(key: string): Promise<Buffer>;
-    operateLock(key: string, encrypt?: boolean): Promise<Buffer | undefined>;
+    /**
+     * Operates the lock with the given command.
+     * @param {string} key - The command key.
+     * @param {boolean} [encrypt] - Whether to encrypt the command.
+     * @returns {Promise<Buffer>} - The response buffer.
+     */
+    operateLock(key: string, encrypt?: boolean): Promise<Buffer>;
 }
 //# sourceMappingURL=wosmartlock.d.ts.map

package/dist/device/wosmartlock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wosmartlock.d.ts","sourceRoot":"","sources":["../../src/device/wosmartlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,mBAAmB,CAAA;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAElE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAOpC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAI9C,qBAAa,WAAY,SAAQ,eAAe;IAC9C,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAE7B,MAAM,CAAC,gBAAgB,SAAa;IACpC,MAAM,CAAC,iBAAiB,SAAe;IACvC,MAAM,CAAC,cAAc,SAAmB;IACxC,MAAM,CAAC,yBAAyB,SAAmB;IACnD,MAAM,CAAC,YAAY,SAAmB;IACtC,MAAM,CAAC,4BAA4B,SAAuB;IAC1D,MAAM,CAAC,6BAA6B,SAAW;IAE/C,MAAM,CAAC,MAAM;;;;MAIZ;WAEY,gBAAgB,CAAC,GAAG,EAAE,MAAM;IAYzC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAqB7B,gBAAgB,CAC3B,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,GAC7C,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;gBA4CtB,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,KAAK;IAiBvD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;IAiB3C,MAAM;IAyBN,eAAe;IAyBf,IAAI;IAyBJ,IAAI;IAqBJ,OAAO,CAAC,GAAG,EAAE,MAAM;IAKnB,OAAO,CAAC,IAAI,EAAE,MAAM;IAKpB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAcxB,gBAAgB,CAAC,GAAG,EAAE,MAAM;IAkB5B,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,OAAc;CAmBvD"}
+{"version":3,"file":"wosmartlock.d.ts","sourceRoot":"","sources":["../../src/device/wosmartlock.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,KAAK,MAAM,mBAAmB,CAAA;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAElE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAI9C;;;GAGG;AACH,qBAAa,WAAY,SAAQ,eAAe;IACvC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAO;IACxB,MAAM,EAAE,MAAM,CAAK;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAO;IAE3C,MAAM,CAAC,MAAM;;;;MAIZ;WAEY,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAU3D,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;WAa7B,gBAAgB,CAC3B,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;gBA6BtB,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,KAAK;IAI7D;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAK/B;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAKxC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAK7B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAcpC;;;;OAIG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3C;;;;OAIG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK5C;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAY9B;;;;OAIG;IACG,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBpD;;;;;OAKG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAczE"}