node-switchbot 3.6.6 → 4.0.0-beta.1

package/dist/types/ble.js

@@ -1,2 +1,95 @@
-export {};
+/* Copyright(C) 2024-2026, donavanbecker (https://github.com/donavanbecker). All rights reserved.
+ *
+ * types/ble.ts: SwitchBot v4.0.0 - BLE Type Definitions
+ */
+/**
+ * SwitchBot BLE Model identifiers
+ */
+export var SwitchBotBLEModel;
+(function (SwitchBotBLEModel) {
+    SwitchBotBLEModel["Bot"] = "H";
+    SwitchBotBLEModel["Curtain"] = "c";
+    SwitchBotBLEModel["Curtain3"] = "{";
+    SwitchBotBLEModel["Plug"] = "g";
+    SwitchBotBLEModel["PlugMiniUS"] = "j";
+    // eslint-disable-next-line ts/no-duplicate-enum-values
+    SwitchBotBLEModel["PlugMiniJP"] = "j";
+    SwitchBotBLEModel["Meter"] = "T";
+    SwitchBotBLEModel["MeterPlus"] = "i";
+    SwitchBotBLEModel["MeterPro"] = "o";
+    SwitchBotBLEModel["MeterProCO2"] = "w";
+    SwitchBotBLEModel["OutdoorMeter"] = "n";
+    // eslint-disable-next-line ts/no-duplicate-enum-values
+    SwitchBotBLEModel["Lock"] = "o";
+    SwitchBotBLEModel["LockPro"] = "\u0011";
+    SwitchBotBLEModel["Keypad"] = "k";
+    SwitchBotBLEModel["KeypadTouch"] = "\v";
+    SwitchBotBLEModel["MotionSensor"] = "s";
+    SwitchBotBLEModel["ContactSensor"] = "d";
+    SwitchBotBLEModel["CeilingLight"] = "q";
+    SwitchBotBLEModel["CeilingLightPro"] = "r";
+    SwitchBotBLEModel["StripLight"] = "p";
+    SwitchBotBLEModel["ColorBulb"] = "u";
+    SwitchBotBLEModel["RobotVacuumCleanerS1"] = "\n";
+    SwitchBotBLEModel["RobotVacuumCleanerS1Plus"] = "\f";
+    SwitchBotBLEModel["RobotVacuumCleanerK10Plus"] = "\u000F";
+    SwitchBotBLEModel["Humidifier"] = "e";
+    SwitchBotBLEModel["Humidifier2"] = "\u0007";
+    SwitchBotBLEModel["BlindTilt"] = "x";
+    SwitchBotBLEModel["Hub2"] = "\u0001";
+    SwitchBotBLEModel["Hub3"] = "\u0002";
+    SwitchBotBLEModel["Remote"] = "\u0005";
+    SwitchBotBLEModel["BatteryCirculatorFan"] = "\u0004";
+    SwitchBotBLEModel["AirPurifier"] = "\b";
+    SwitchBotBLEModel["AirPurifierTable"] = "\t";
+    SwitchBotBLEModel["WaterLeakDetector"] = "y";
+    SwitchBotBLEModel["PresenceSensor"] = "\u0006";
+    SwitchBotBLEModel["RelaySwitch1PM"] = "\r";
+    SwitchBotBLEModel["RelaySwitch1"] = "\u000E";
+    SwitchBotBLEModel["K10ProComboK10Pro"] = "\u0010";
+})(SwitchBotBLEModel || (SwitchBotBLEModel = {}));
+/**
+ * SwitchBot BLE Model Names
+ */
+export var SwitchBotBLEModelName;
+(function (SwitchBotBLEModelName) {
+    SwitchBotBLEModelName["Bot"] = "WoHand";
+    SwitchBotBLEModelName["Curtain"] = "WoCurtain";
+    SwitchBotBLEModelName["Curtain3"] = "WoCurtain3";
+    SwitchBotBLEModelName["Plug"] = "WoPlugUS";
+    SwitchBotBLEModelName["PlugMiniUS"] = "WoPlugMiniUS";
+    SwitchBotBLEModelName["PlugMiniJP"] = "WoPlugMiniJP";
+    SwitchBotBLEModelName["Meter"] = "WoSensorTH";
+    SwitchBotBLEModelName["MeterPlus"] = "WoSensorTHPlus";
+    SwitchBotBLEModelName["MeterPro"] = "WoSensorTHPro";
+    SwitchBotBLEModelName["MeterProCO2"] = "WoSensorTHProCO2";
+    SwitchBotBLEModelName["OutdoorMeter"] = "WoIOSensorTH";
+    SwitchBotBLEModelName["Lock"] = "WoSmartLock";
+    SwitchBotBLEModelName["LockPro"] = "WoSmartLockPro";
+    SwitchBotBLEModelName["Keypad"] = "WoKeypad";
+    SwitchBotBLEModelName["KeypadTouch"] = "WoKeypadTouch";
+    SwitchBotBLEModelName["MotionSensor"] = "WoMotion";
+    SwitchBotBLEModelName["ContactSensor"] = "WoContact";
+    SwitchBotBLEModelName["CeilingLight"] = "WoCeilingLight";
+    SwitchBotBLEModelName["CeilingLightPro"] = "WoCeilingLightPro";
+    SwitchBotBLEModelName["StripLight"] = "WoStrip";
+    SwitchBotBLEModelName["ColorBulb"] = "WoBulb";
+    SwitchBotBLEModelName["RobotVacuumCleanerS1"] = "WoVacS1";
+    SwitchBotBLEModelName["RobotVacuumCleanerS1Plus"] = "WoVacS1Plus";
+    SwitchBotBLEModelName["RobotVacuumCleanerK10Plus"] = "WoVacK10Plus";
+    SwitchBotBLEModelName["Humidifier"] = "WoHumi";
+    SwitchBotBLEModelName["Humidifier2"] = "WoHumi2";
+    SwitchBotBLEModelName["BlindTilt"] = "WoBlindTilt";
+    SwitchBotBLEModelName["Hub2"] = "WoHub2";
+    SwitchBotBLEModelName["Hub3"] = "WoHub3";
+    SwitchBotBLEModelName["Remote"] = "WoRemote";
+    SwitchBotBLEModelName["BatteryCirculatorFan"] = "WoCirculatorFan";
+    SwitchBotBLEModelName["AirPurifier"] = "WoAirPurifier";
+    SwitchBotBLEModelName["AirPurifierTable"] = "WoAirPurifierTable";
+    SwitchBotBLEModelName["WaterLeakDetector"] = "WoLeak";
+    SwitchBotBLEModelName["PresenceSensor"] = "WoPresence";
+    SwitchBotBLEModelName["RelaySwitch1PM"] = "WoRelaySwitch1PM";
+    SwitchBotBLEModelName["RelaySwitch1"] = "WoRelaySwitch1";
+    SwitchBotBLEModelName["K10ProComboK10Pro"] = "WoVacK10ProCombo";
+})(SwitchBotBLEModelName || (SwitchBotBLEModelName = {}));
 //# sourceMappingURL=ble.js.map

package/dist/types/ble.js.map

@@ -1 +1 @@
-{"version":3,"file":"ble.js","sourceRoot":"","sources":["../../src/types/ble.ts"],"names":[],"mappings":""}
+{"version":3,"file":"ble.js","sourceRoot":"","sources":["../../src/types/ble.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkNH;;GAEG;AACH,MAAM,CAAN,IAAY,iBAyCX;AAzCD,WAAY,iBAAiB;IAC3B,8BAAS,CAAA;IACT,kCAAa,CAAA;IACb,mCAAc,CAAA;IACd,+BAAU,CAAA;IACV,qCAAgB,CAAA;IAChB,uDAAuD;IACvD,qCAAgB,CAAA;IAChB,gCAAW,CAAA;IACX,oCAAe,CAAA;IACf,mCAAc,CAAA;IACd,sCAAiB,CAAA;IACjB,uCAAkB,CAAA;IAClB,uDAAuD;IACvD,+BAAU,CAAA;IACV,uCAAgB,CAAA;IAChB,iCAAY,CAAA;IACZ,uCAAoB,CAAA;IACpB,uCAAkB,CAAA;IAClB,wCAAmB,CAAA;IACnB,uCAAkB,CAAA;IAClB,0CAAqB,CAAA;IACrB,qCAAgB,CAAA;IAChB,oCAAe,CAAA;IACf,gDAA6B,CAAA;IAC7B,oDAAiC,CAAA;IACjC,yDAAkC,CAAA;IAClC,qCAAgB,CAAA;IAChB,2CAAoB,CAAA;IACpB,oCAAe,CAAA;IACf,oCAAa,CAAA;IACb,oCAAa,CAAA;IACb,sCAAe,CAAA;IACf,oDAA6B,CAAA;IAC7B,uCAAoB,CAAA;IACpB,4CAAyB,CAAA;IACzB,4CAAuB,CAAA;IACvB,8CAAuB,CAAA;IACvB,0CAAuB,CAAA;IACvB,4CAAqB,CAAA;IACrB,iDAA0B,CAAA;AAC5B,CAAC,EAzCW,iBAAiB,KAAjB,iBAAiB,QAyC5B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,qBAuCX;AAvCD,WAAY,qBAAqB;IAC/B,uCAAc,CAAA;IACd,8CAAqB,CAAA;IACrB,gDAAuB,CAAA;IACvB,0CAAiB,CAAA;IACjB,oDAA2B,CAAA;IAC3B,oDAA2B,CAAA;IAC3B,6CAAoB,CAAA;IACpB,qDAA4B,CAAA;IAC5B,mDAA0B,CAAA;IAC1B,yDAAgC,CAAA;IAChC,sDAA6B,CAAA;IAC7B,6CAAoB,CAAA;IACpB,mDAA0B,CAAA;IAC1B,4CAAmB,CAAA;IACnB,sDAA6B,CAAA;IAC7B,kDAAyB,CAAA;IACzB,oDAA2B,CAAA;IAC3B,wDAA+B,CAAA;IAC/B,8DAAqC,CAAA;IACrC,+CAAsB,CAAA;IACtB,6CAAoB,CAAA;IACpB,yDAAgC,CAAA;IAChC,iEAAwC,CAAA;IACxC,mEAA0C,CAAA;IAC1C,8CAAqB,CAAA;IACrB,gDAAuB,CAAA;IACvB,kDAAyB,CAAA;IACzB,wCAAe,CAAA;IACf,wCAAe,CAAA;IACf,4CAAmB,CAAA;IACnB,iEAAwC,CAAA;IACxC,sDAA6B,CAAA;IAC7B,gEAAuC,CAAA;IACvC,qDAA4B,CAAA;IAC5B,sDAA6B,CAAA;IAC7B,4DAAmC,CAAA;IACnC,wDAA+B,CAAA;IAC/B,+DAAsC,CAAA;AACxC,CAAC,EAvCW,qBAAqB,KAArB,qBAAqB,QAuChC"}

package/dist/types/device.d.ts

@@ -0,0 +1,209 @@
+import type { DeviceStatus } from './index.js';
+export type { DeviceStatus };
+/**
+ * Bot (WoHand) specific types
+ */
+export interface BotStatus extends DeviceStatus {
+    power: 'on' | 'off';
+    mode?: 'press' | 'switch' | 'customize';
+}
+export interface BotCommands {
+    turnOn: () => Promise<boolean>;
+    turnOff: () => Promise<boolean>;
+    press: () => Promise<boolean>;
+}
+/**
+ * Curtain (WoCurtain) specific types
+ */
+export interface CurtainStatus extends DeviceStatus {
+    position: number;
+    calibrated?: boolean;
+    moving?: boolean;
+    direction?: 'opening' | 'closing';
+    slidePosition?: number;
+}
+export interface CurtainCommands {
+    open: () => Promise<boolean>;
+    close: () => Promise<boolean>;
+    pause: () => Promise<boolean>;
+    setPosition: (position: number) => Promise<boolean>;
+}
+/**
+ * Lock (WoSmartLock) specific types
+ */
+export interface LockStatus extends DeviceStatus {
+    lockState: 'locked' | 'unlocked' | 'jammed';
+    doorState?: 'opened' | 'closed';
+    calibrated?: boolean;
+}
+export interface LockCommands {
+    lock: () => Promise<boolean>;
+    unlock: () => Promise<boolean>;
+}
+/**
+ * Meter (Temperature/Humidity) specific types
+ */
+export interface MeterStatus extends DeviceStatus {
+    temperature: number;
+    humidity: number;
+    temperatureScale?: 'c' | 'f';
+}
+/**
+ * Contact Sensor specific types
+ */
+export interface ContactStatus extends DeviceStatus {
+    openState: 'open' | 'closed' | 'timeout';
+    moveDetected?: boolean;
+    brightness?: 'bright' | 'dim' | 'dark';
+}
+/**
+ * Motion Sensor specific types
+ */
+export interface MotionStatus extends DeviceStatus {
+    moveDetected: boolean;
+    brightness?: 'bright' | 'dim' | 'dark';
+}
+/**
+ * Plug specific types
+ */
+export interface PlugStatus extends DeviceStatus {
+    power: 'on' | 'off';
+    voltage?: number;
+    electricCurrent?: number;
+    electricityOfDay?: number;
+}
+export interface PlugCommands {
+    turnOn: () => Promise<boolean>;
+    turnOff: () => Promise<boolean>;
+    toggle: () => Promise<boolean>;
+}
+/**
+ * Bulb/Light specific types
+ */
+export interface BulbStatus extends DeviceStatus {
+    power: 'on' | 'off';
+    brightness?: number;
+    colorTemperature?: number;
+    color?: {
+        r: number;
+        g: number;
+        b: number;
+    };
+}
+export interface BulbCommands {
+    turnOn: () => Promise<boolean>;
+    turnOff: () => Promise<boolean>;
+    setBrightness: (brightness: number) => Promise<boolean>;
+    setColorTemperature: (temperature: number) => Promise<boolean>;
+    setColor: (red: number, green: number, blue: number) => Promise<boolean>;
+}
+/**
+ * Strip Light specific types
+ */
+export interface StripStatus extends BulbStatus {
+}
+export interface StripCommands extends BulbCommands {
+}
+/**
+ * Ceiling Light specific types
+ */
+export interface CeilingLightStatus extends BulbStatus {
+}
+export interface CeilingLightCommands extends BulbCommands {
+}
+/**
+ * Blind Tilt specific types
+ */
+export interface BlindTiltStatus extends DeviceStatus {
+    position: number;
+    direction?: 'opening' | 'closing';
+    moving?: boolean;
+}
+export interface BlindTiltCommands {
+    open: () => Promise<boolean>;
+    close: () => Promise<boolean>;
+    closeUp: () => Promise<boolean>;
+    closeDown: () => Promise<boolean>;
+    pause: () => Promise<boolean>;
+    setPosition: (position: number) => Promise<boolean>;
+}
+/**
+ * Humidifier specific types
+ */
+export interface HumidifierStatus extends DeviceStatus {
+    power: 'on' | 'off';
+    humidity?: number;
+    mode?: 'auto' | 'manual';
+    nebulizationEfficiency?: number;
+    lackWater?: boolean;
+    temperature?: number;
+}
+export interface HumidifierCommands {
+    turnOn: () => Promise<boolean>;
+    turnOff: () => Promise<boolean>;
+    setMode: (mode: 'auto' | 'manual') => Promise<boolean>;
+    setEfficiency: (level: number) => Promise<boolean>;
+}
+/**
+ * Air Purifier specific types
+ */
+export interface AirPurifierStatus extends DeviceStatus {
+    power: 'on' | 'off';
+    fanSpeed?: number;
+    mode?: 'auto' | 'manual' | 'sleep';
+    pm25?: number;
+    airQuality?: 'excellent' | 'good' | 'fair' | 'poor';
+}
+export interface AirPurifierCommands {
+    turnOn: () => Promise<boolean>;
+    turnOff: () => Promise<boolean>;
+    setMode: (mode: 'auto' | 'manual' | 'sleep') => Promise<boolean>;
+    setFanSpeed: (speed: number) => Promise<boolean>;
+}
+/**
+ * Hub specific types
+ */
+export interface HubStatus extends DeviceStatus {
+    temperature?: number;
+    humidity?: number;
+    lightLevel?: number;
+}
+/**
+ * Leak Detector specific types
+ */
+export interface LeakStatus extends DeviceStatus {
+    waterLeakDetected: boolean;
+}
+/**
+ * Presence Sensor specific types
+ */
+export interface PresenceStatus extends DeviceStatus {
+    moveDetected: boolean;
+    brightness?: 'bright' | 'dim' | 'dark';
+}
+/**
+ * Relay Switch specific types
+ */
+export interface RelaySwitchStatus extends DeviceStatus {
+    power: 'on' | 'off';
+    voltage?: number;
+    electricCurrent?: number;
+    electricityOfDay?: number;
+}
+export interface RelaySwitchCommands {
+    turnOn: () => Promise<boolean>;
+    turnOff: () => Promise<boolean>;
+    toggle: () => Promise<boolean>;
+}
+/**
+ * Keypad specific types
+ */
+export interface KeypadStatus extends DeviceStatus {
+    lockState?: 'locked' | 'unlocked';
+}
+/**
+ * Remote specific types
+ */
+export interface RemoteStatus extends DeviceStatus {
+}
+//# sourceMappingURL=device.d.ts.map

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

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

package/dist/types/device.js

@@ -0,0 +1,6 @@
+/* Copyright(C) 2024-2026, donavanbecker (https://github.com/donavanbecker). All rights reserved.
+ *
+ * types/device.ts: SwitchBot v4.0.0 - Device-Specific Type Definitions
+ */
+export {};
+//# sourceMappingURL=device.js.map

package/dist/types/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../../src/types/device.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/index.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Log levels for debugging and diagnostics
+ */
+export declare enum LogLevel {
+    NONE = 0,
+    ERROR = 1,
+    WARN = 2,
+    INFO = 3,
+    DEBUG = 4
+}
+/**
+ * Device connection type
+ */
+export type ConnectionType = 'ble' | 'api' | 'hybrid';
+/**
+ * SwitchBot configuration options
+ */
+export interface SwitchBotConfig {
+    /** OpenAPI token (optional - required for API/Hybrid mode) */
+    token?: string;
+    /** OpenAPI secret (optional - required for API/Hybrid mode) */
+    secret?: string;
+    /** OpenAPI base URL (optional - defaults to official API) */
+    baseURL?: string;
+    /** Enable BLE scanning (default: true on Linux) */
+    enableBLE?: boolean;
+    /** BLE scan timeout in milliseconds (default: 10000) */
+    scanTimeout?: number;
+    /** Enable BLE to API fallback on errors (default: true) */
+    enableFallback?: boolean;
+    /** Log level (default: WARN) */
+    logLevel?: LogLevel;
+    /** Noble instance (optional - for custom BLE configuration) */
+    noble?: any;
+}
+/**
+ * Device discovery options
+ */
+export interface DiscoveryOptions {
+    /** Scan for BLE devices (default: true if BLE enabled) */
+    scanBLE?: boolean;
+    /** Fetch devices from API (default: true if credentials provided) */
+    fetchAPI?: boolean;
+    /** Discovery timeout in milliseconds (default: 10000) */
+    timeout?: number;
+    /** Filter by device ID (optional) */
+    deviceId?: string;
+    /** Filter by device MAC address (optional) */
+    mac?: string;
+    /** Filter by device type (optional) */
+    deviceType?: string;
+}
+/**
+ * Base device information
+ */
+export interface DeviceInfo {
+    /** Device ID */
+    id: string;
+    /** Device name */
+    name: string;
+    /** Device type (e.g., 'Bot', 'Curtain', 'Lock') */
+    deviceType: string;
+    /** Device model */
+    model?: string;
+    /** MAC address (for BLE devices) */
+    mac?: string;
+    /** Available connection types */
+    connectionTypes: ConnectionType[];
+    /** Current active connection type */
+    activeConnection?: ConnectionType;
+    /** Hub device ID (if device is controlled through a hub) */
+    hubDeviceId?: string;
+    /** Battery level (0-100) */
+    battery?: number;
+    /** RSSI signal strength (for BLE) */
+    rssi?: number;
+    /** Firmware version */
+    version?: string;
+    /** CloudService enabled in OpenAPI */
+    cloudServiceEnabled?: boolean;
+}
+/**
+ * Device command result
+ */
+export interface CommandResult {
+    /** Success status */
+    success: boolean;
+    /** Connection type used */
+    connectionType: ConnectionType;
+    /** Error message (if failed) */
+    error?: string;
+    /** Response data */
+    data?: any;
+    /** Whether API fallback was used */
+    usedFallback?: boolean;
+}
+/**
+ * Device status (generic - specific devices extend this)
+ */
+export interface DeviceStatus {
+    /** Device ID */
+    deviceId: string;
+    /** Connection type used to retrieve status */
+    connectionType: ConnectionType;
+    /** Firmware version */
+    version?: string;
+    /** Battery level (0-100) */
+    battery?: number;
+    /** Last updated timestamp */
+    updatedAt?: Date;
+}
+export * from './api.js';
+export * from './ble.js';
+export * from './device.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,oBAAY,QAAQ;IAClB,IAAI,IAAI;IACR,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAA;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,GAAG,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAA;IAClB,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,eAAe,EAAE,cAAc,EAAE,CAAA;IACjC,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,cAAc,CAAA;IACjC,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,2BAA2B;IAC3B,cAAc,EAAE,cAAc,CAAA;IAC9B,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oBAAoB;IACpB,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,oCAAoC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,8CAA8C;IAC9C,cAAc,EAAE,cAAc,CAAA;IAC9B,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,IAAI,CAAA;CACjB;AAED,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA"}

package/dist/types/index.js

@@ -0,0 +1,19 @@
+/* Copyright(C) 2024-2026, donavanbecker (https://github.com/donavanbecker). All rights reserved.
+ *
+ * types/index.ts: SwitchBot v4.0.0 - Core Type Definitions
+ */
+/**
+ * Log levels for debugging and diagnostics
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["NONE"] = 0] = "NONE";
+    LogLevel[LogLevel["ERROR"] = 1] = "ERROR";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["INFO"] = 3] = "INFO";
+    LogLevel[LogLevel["DEBUG"] = 4] = "DEBUG";
+})(LogLevel || (LogLevel = {}));
+export * from './api.js';
+export * from './ble.js';
+export * from './device.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,uCAAQ,CAAA;IACR,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;AACX,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB;AA6GD,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA"}

package/dist/utils/index.d.ts

@@ -0,0 +1,97 @@
+import type { LogLevel } from '../types/index.js';
+import { Buffer } from 'node:buffer';
+/**
+ * Logger utility for consistent logging across the library
+ */
+export declare class Logger {
+    private readonly name;
+    private level;
+    constructor(name: string, level?: LogLevel);
+    setLevel(level: LogLevel): void;
+    error(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+}
+/**
+ * Validate MAC address format
+ */
+export declare function isValidMAC(mac: string): boolean;
+/**
+ * Normalize MAC address to lowercase with colons
+ */
+export declare function normalizeMAC(mac: string): string;
+/**
+ * Convert MAC address to device ID format
+ */
+export declare function macToDeviceId(mac: string): string;
+/**
+ * Delay utility
+ */
+export declare function delay(ms: number): Promise<void>;
+/**
+ * Timeout promise wrapper
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, errorMessage?: string): Promise<T>;
+/**
+ * Retry utility with exponential backoff
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: {
+    maxAttempts?: number;
+    delayMs?: number;
+    backoff?: boolean;
+    onRetry?: (attempt: number, error: Error) => void;
+}): Promise<T>;
+/**
+ * Clamp a number between min and max
+ */
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Convert temperature from Celsius to Fahrenheit
+ */
+export declare function celsiusToFahrenheit(celsius: number): number;
+/**
+ * Convert temperature from Fahrenheit to Celsius
+ */
+export declare function fahrenheitToCelsius(fahrenheit: number): number;
+/**
+ * Parse hex string to buffer
+ */
+export declare function hexToBuffer(hex: string): Buffer;
+/**
+ * Convert buffer to hex string
+ */
+export declare function bufferToHex(buffer: Buffer): string;
+/**
+ * Generate random nonce for API requests
+ */
+export declare function generateNonce(): string;
+/**
+ * Generate timestamp for API requests
+ */
+export declare function generateTimestamp(): string;
+/**
+ * Create HMAC-SHA256 signature for OpenAPI
+ */
+export declare function createSignature(token: string, secret: string, timestamp: string, nonce: string): Promise<string>;
+/**
+ * Safe JSON parse with fallback
+ */
+export declare function safeJsonParse<T>(json: string, fallback: T): T;
+/**
+ * Check if value is a promise
+ */
+export declare function isPromise<T>(value: any): value is Promise<T>;
+/**
+ * Deep clone an object
+ */
+export declare function deepClone<T>(obj: T): T;
+/**
+ * Debounce function
+ */
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, delayMs: number): (...args: Parameters<T>) => void;
+/**
+ * Throttle function
+ */
+export declare function throttle<T extends (...args: any[]) => any>(fn: T, limitMs: number): (...args: Parameters<T>) => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC;;GAEG;AACH,qBAAa,MAAM;IAEf,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,KAAK;gBADI,IAAI,EAAE,MAAM,EACrB,KAAK,GAAE,QAAY;IAG7B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;CAK7C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,SAAwB,GACnC,OAAO,CAAC,CAAC,CAAC,CAeZ;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CAC7C,GACL,OAAO,CAAC,CAAC,CAAC,CAyBZ;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAM7D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAE5D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAEtC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,OAAO,EAAE,MAAM,GACd,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAYlC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,OAAO,EAAE,MAAM,GACd,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAUlC"}