node-switchbot 3.6.6 → 4.0.0-beta.1

package/dist/errors.js

@@ -0,0 +1,103 @@
+/* Copyright(C) 2024-2026, donavanbecker (https://github.com/donavanbecker). All rights reserved.
+ *
+ * errors.ts: SwitchBot v4.0.0 - Custom Error Classes
+ */
+/**
+ * Base error class for SwitchBot errors
+ */
+export class SwitchBotError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'SwitchBotError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+/**
+ * Error thrown when BLE is not available or supported
+ */
+export class BLENotAvailableError extends SwitchBotError {
+    constructor(message = 'BLE not available on this platform or device') {
+        super(message, 'BLE_NOT_AVAILABLE');
+        this.name = 'BLENotAvailableError';
+    }
+}
+/**
+ * Error thrown when API is not available or credentials are missing
+ */
+export class APINotAvailableError extends SwitchBotError {
+    constructor(message = 'API not available or credentials not provided') {
+        super(message, 'API_NOT_AVAILABLE');
+        this.name = 'APINotAvailableError';
+    }
+}
+/**
+ * Error thrown when a device is not found
+ */
+export class DeviceNotFoundError extends SwitchBotError {
+    constructor(deviceId) {
+        super(`Device not found: ${deviceId}`, 'DEVICE_NOT_FOUND');
+        this.name = 'DeviceNotFoundError';
+    }
+}
+/**
+ * Error thrown when a command fails
+ */
+export class CommandFailedError extends SwitchBotError {
+    connectionType;
+    originalError;
+    constructor(message, connectionType, originalError) {
+        super(message, 'COMMAND_FAILED');
+        this.connectionType = connectionType;
+        this.originalError = originalError;
+        this.name = 'CommandFailedError';
+    }
+}
+/**
+ * Error thrown when a connection timeout occurs
+ */
+export class ConnectionTimeoutError extends SwitchBotError {
+    timeoutMs;
+    constructor(message = 'Connection timeout', timeoutMs) {
+        super(message, 'CONNECTION_TIMEOUT');
+        this.timeoutMs = timeoutMs;
+        this.name = 'ConnectionTimeoutError';
+    }
+}
+/**
+ * Error thrown when device discovery fails
+ */
+export class DiscoveryError extends SwitchBotError {
+    originalError;
+    constructor(message, originalError) {
+        super(message, 'DISCOVERY_ERROR');
+        this.originalError = originalError;
+        this.name = 'DiscoveryError';
+    }
+}
+/**
+ * Error thrown when API request fails
+ */
+export class APIError extends SwitchBotError {
+    statusCode;
+    statusMessage;
+    constructor(message, statusCode, statusMessage) {
+        super(message, 'API_ERROR');
+        this.statusCode = statusCode;
+        this.statusMessage = statusMessage;
+        this.name = 'APIError';
+    }
+}
+/**
+ * Error thrown when invalid parameters are provided
+ */
+export class ValidationError extends SwitchBotError {
+    parameter;
+    constructor(message, parameter) {
+        super(message, 'VALIDATION_ERROR');
+        this.parameter = parameter;
+        this.name = 'ValidationError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACM;IAA7C,YAAY,OAAe,EAAkB,IAAa;QACxD,KAAK,CAAC,OAAO,CAAC,CAAA;QAD6B,SAAI,GAAJ,IAAI,CAAS;QAExD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;IACjD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,cAAc;IACtD,YAAY,OAAO,GAAG,8CAA8C;QAClE,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAA;QACnC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,cAAc;IACtD,YAAY,OAAO,GAAG,+CAA+C;QACnE,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAA;QACnC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IACrD,YAAY,QAAgB;QAC1B,KAAK,CAAC,qBAAqB,QAAQ,EAAE,EAAE,kBAAkB,CAAC,CAAA;QAC1D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IAGlC;IACA;IAHlB,YACE,OAAe,EACC,cAA8B,EAC9B,aAAqB;QAErC,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAA;QAHhB,mBAAc,GAAd,cAAc,CAAgB;QAC9B,kBAAa,GAAb,aAAa,CAAQ;QAGrC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,cAAc;IACI;IAA5D,YAAY,OAAO,GAAG,oBAAoB,EAAkB,SAAkB;QAC5E,KAAK,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAA;QADsB,cAAS,GAAT,SAAS,CAAS;QAE5E,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;IACtC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,cAAc;IACH;IAA7C,YAAY,OAAe,EAAkB,aAAqB;QAChE,KAAK,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAA;QADU,kBAAa,GAAb,aAAa,CAAQ;QAEhE,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;IAC9B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,cAAc;IAGxB;IACA;IAHlB,YACE,OAAe,EACC,UAAmB,EACnB,aAAsB;QAEtC,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;QAHX,eAAU,GAAV,UAAU,CAAS;QACnB,kBAAa,GAAb,aAAa,CAAS;QAGtC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;IACxB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,cAAc;IACJ;IAA7C,YAAY,OAAe,EAAkB,SAAkB;QAC7D,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAA;QADS,cAAS,GAAT,SAAS,CAAS;QAE7D,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,8 +1,12 @@
-export * from './device.js';
-export { ParameterChecker, parameterChecker } from './parameter-checker.js';
+export { OpenAPIClient } from './api.js';
+export { BLEConnection, BLEScanner } from './ble.js';
+export { DeviceManager, SwitchBotDevice } from './devices/base.js';
+export { WoAirPurifier, WoAirPurifierTable, WoBlindTilt, WoBulb, WoCeilingLight, WoContact, WoCurtain, WoHand, WoHub2, WoHub3, WoHumi, WoHumi2, WoIOSensorTH, WoKeypad, WoLeak, WoPlugMiniJP, WoPlugMiniUS, WoPresence, WoRelaySwitch1, WoRelaySwitch1PM, WoRemote, WoSensorTH, WoSensorTHPlus, WoSensorTHPro, WoSensorTHProCO2, WoSmartLock, WoSmartLockPro, WoStrip, } from './devices/index.js';
+export { APIError, APINotAvailableError, BLENotAvailableError, CommandFailedError, ConnectionTimeoutError, DeviceNotFoundError, DiscoveryError, SwitchBotError, ValidationError, } from './errors.js';
 export { updateBaseURL, urls } from './settings.js';
-export * from './switchbot-ble.js';
-export * from './switchbot-openapi.js';
-export * from './types/ble.js';
-export * from './types/openapi.js';
+export { SwitchBot } from './switchbot.js';
+export type { APICommandRequest, APICommandResponse, APIDevice, APIDeviceStatus, APIErrorResponse, APIResponse, DeviceListResponse, PhysicalDeviceType, SceneListResponse, VirtualDeviceType, WebhookConfig, WebhookDetails, WebhookQueryResponse, WebhookSetupResponse, } from './types/api.js';
+export type { AirPurifierServiceData, BLEAdvertisement, BLEScanOptions, BLEServiceData, BlindTiltServiceData, BotServiceData, BulbServiceData, CeilingLightServiceData, ContactServiceData, CurtainServiceData, HubServiceData, HumidifierServiceData, LeakServiceData, LockServiceData, MeterServiceData, MotionServiceData, PlugServiceData, PresenceServiceData, RelaySwitchServiceData, StripServiceData, SwitchBotBLEModel, SwitchBotBLEModelName, } from './types/ble.js';
+export type { AirPurifierCommands, AirPurifierStatus, BlindTiltCommands, BlindTiltStatus, BotCommands, BotStatus, BulbCommands, BulbStatus, CeilingLightCommands, CeilingLightStatus, ContactStatus, CurtainCommands, CurtainStatus, HubStatus, HumidifierCommands, HumidifierStatus, KeypadStatus, LeakStatus, LockCommands, LockStatus, MeterStatus, MotionStatus, PlugCommands, PlugStatus, PresenceStatus, RelaySwitchCommands, RelaySwitchStatus, RemoteStatus, StripCommands, StripStatus, } from './types/device.js';
+export type { CommandResult, ConnectionType, DeviceInfo, DeviceStatus, DiscoveryOptions, LogLevel, SwitchBotConfig, } from './types/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC3E,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACnD,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA;AAGtC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,MAAM,EACN,cAAc,EACd,SAAS,EACT,SAAS,EACT,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,OAAO,GACR,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAG1C,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,SAAS,EACT,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,WAAW,GACZ,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,aAAa,EACb,cAAc,EACd,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,eAAe,GAChB,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -1,14 +1,13 @@
-/* Copyright(C) 2024, donavanbecker (https://github.com/donavanbecker). All rights reserved.
+/* Copyright(C) 2024-2026, donavanbecker (https://github.com/donavanbecker). All rights reserved.
  *
- * index.ts: Switchbot BLE API registration.
+ * index.ts: SwitchBot v4.0.0 - Hybrid BLE/OpenAPI Main Exports
  */
-// Primary module exports
-export * from './device.js';
-export { ParameterChecker, parameterChecker } from './parameter-checker.js';
+// Main classes (alphabetically by module path)
+export { OpenAPIClient } from './api.js';
+export { BLEConnection, BLEScanner } from './ble.js';
+export { DeviceManager, SwitchBotDevice } from './devices/base.js';
+export { WoAirPurifier, WoAirPurifierTable, WoBlindTilt, WoBulb, WoCeilingLight, WoContact, WoCurtain, WoHand, WoHub2, WoHub3, WoHumi, WoHumi2, WoIOSensorTH, WoKeypad, WoLeak, WoPlugMiniJP, WoPlugMiniUS, WoPresence, WoRelaySwitch1, WoRelaySwitch1PM, WoRemote, WoSensorTH, WoSensorTHPlus, WoSensorTHPro, WoSensorTHProCO2, WoSmartLock, WoSmartLockPro, WoStrip, } from './devices/index.js';
+export { APIError, APINotAvailableError, BLENotAvailableError, CommandFailedError, ConnectionTimeoutError, DeviceNotFoundError, DiscoveryError, SwitchBotError, ValidationError, } from './errors.js';
 export { updateBaseURL, urls } from './settings.js';
-export * from './switchbot-ble.js';
-export * from './switchbot-openapi.js';
-// Type definitions
-export * from './types/ble.js';
-export * from './types/openapi.js';
+export { SwitchBot } from './switchbot.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,yBAAyB;AACzB,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC3E,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACnD,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA;AAEtC,mBAAmB;AACnB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+CAA+C;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,MAAM,EACN,cAAc,EACd,SAAS,EACT,SAAS,EACT,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,OAAO,GACR,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/settings.d.ts

@@ -1,53 +1,132 @@
 /**
- * Updates the base URL for the SwitchBot API endpoints.
- * @param {string} newBaseURL - The new base URL to use.
+ * OpenAPI Configuration
  */
-export declare function updateBaseURL(newBaseURL: string): void;
+export declare const DEFAULT_BASE_URL = "https://api.switch-bot.com";
+export declare const API_VERSION = "v1.1";
 export declare const urls: {
-    readonly baseURL: string;
-    readonly devicesURL: string;
-    readonly setupWebhook: string;
-    readonly queryWebhook: string;
-    readonly updateWebhook: string;
-    readonly deleteWebhook: string;
+    base: string;
+    devices: string;
+    scenes: string;
+    webhook: string;
 };
 /**
- * constants used to access SwitchBot BLE API
- */
-export declare const SERV_UUID_PRIMARY = "cba20d00224d11e69fb80002a5d5c51b";
-export declare const CHAR_UUID_WRITE = "cba20002224d11e69fb80002a5d5c51b";
-export declare const CHAR_UUID_NOTIFY = "cba20003224d11e69fb80002a5d5c51b";
-export declare const CHAR_UUID_DEVICE = "2a00";
-export declare const READ_TIMEOUT_MSEC = 3000;
-export declare const WRITE_TIMEOUT_MSEC = 3000;
-export declare const COMMAND_TIMEOUT_MSEC = 3000;
-export declare const DEFAULT_DISCOVERY_DURATION = 5000;
-export declare const PRIMARY_SERVICE_UUID_LIST: never[];
-export declare enum WoSmartLockProCommands {
-    GET_CKIV = "570f2103",
-    LOCK_INFO = "570f4f8102",
-    UNLOCK = "570f4e0101000080",
-    UNLOCK_NO_UNLATCH = "570f4e01010000a0",
-    LOCK = "570f4e0101000000",
-    ENABLE_NOTIFICATIONS = "570e01001e00008101",
-    DISABLE_NOTIFICATIONS = "570e00"
-}
-export declare enum WoSmartLockCommands {
-    GET_CKIV = "570f2103",
-    LOCK_INFO = "570f4f8101",
-    UNLOCK = "570f4e01011080",
-    UNLOCK_NO_UNLATCH = "570f4e010110a0",
-    LOCK = "570f4e01011000",
-    ENABLE_NOTIFICATIONS = "570e01001e00008101",
-    DISABLE_NOTIFICATIONS = "570e00"
-}
-export declare enum WoSmartLockUltraCommands {
-    GET_CKIV = "570f2103",
-    LOCK_INFO = "570f4f8102",
-    UNLOCK = "570f4e0101000080",
-    UNLOCK_NO_UNLATCH = "570f4e01010000a0",
-    LOCK = "570f4e0101000000",
-    ENABLE_NOTIFICATIONS = "570e01001e00008101",
-    DISABLE_NOTIFICATIONS = "570e00"
-}
+ * Update the base URL for all API endpoints
+ * @param newBaseURL - The new base URL to use
+ */
+export declare function updateBaseURL(newBaseURL: string): void;
+/**
+ * BLE Configuration
+ */
+export declare const BLE_SERVICE_UUID = "cba20d00224d11e69fb80002a5d5c51b";
+export declare const BLE_WRITE_CHARACTERISTIC_UUID = "cba20002224d11e69fb80002a5d5c51b";
+export declare const BLE_NOTIFY_CHARACTERISTIC_UUID = "cba20003224d11e69fb80002a5d5c51b";
+export declare const SERV_UUID_PRIMARY = "cba20d00-224d-11e6-9fb8-0002a5d5c51b";
+export declare const CHAR_UUID_WRITE = "cba20002-224d-11e6-9fb8-0002a5d5c51b";
+export declare const CHAR_UUID_NOTIFY = "cba20003-224d-11e6-9fb8-0002a5d5c51b";
+export declare const CHAR_UUID_DEVICE = "cba20d00-224d-11e6-9fb8-0002a5d5c51b";
+/**
+ * BLE Timeouts (in milliseconds)
+ */
+export declare const BLE_SCAN_TIMEOUT = 10000;
+export declare const BLE_CONNECT_TIMEOUT = 10000;
+export declare const BLE_COMMAND_TIMEOUT = 5000;
+export declare const READ_TIMEOUT_MSEC = 10000;
+export declare const WRITE_TIMEOUT_MSEC = 10000;
+/**
+ * Device Command Constants
+ */
+export declare const DEVICE_COMMANDS: {
+    readonly BOT: {
+        readonly PRESS: readonly [87, 1, 0];
+        readonly TURN_ON: readonly [87, 1, 1];
+        readonly TURN_OFF: readonly [87, 1, 2];
+        readonly DOWN: readonly [87, 1, 1];
+        readonly UP: readonly [87, 1, 2];
+    };
+    readonly CURTAIN: {
+        readonly OPEN: readonly [87, 15, 69, 1, 5, 255, 0];
+        readonly CLOSE: readonly [87, 15, 69, 1, 5, 255, 100];
+        readonly PAUSE: readonly [87, 15, 69, 1, 0, 255];
+        readonly POSITION: readonly [87, 15, 69, 1, 5, 255];
+    };
+    readonly BLIND_TILT: {
+        readonly OPEN: readonly [87, 15, 69, 1, 5, 255, 50];
+        readonly CLOSE_UP: readonly [87, 15, 69, 1, 5, 255, 100];
+        readonly CLOSE_DOWN: readonly [87, 15, 69, 1, 5, 255, 0];
+        readonly PAUSE: readonly [87, 15, 69, 1, 0, 255];
+    };
+    readonly BULB: {
+        readonly BASE: readonly [87, 15, 71, 1];
+        readonly READ_STATE: readonly [87, 15, 72, 1];
+        readonly TURN_ON: readonly [1, 1];
+        readonly TURN_OFF: readonly [1, 2];
+        readonly SET_BRIGHTNESS: readonly [2, 20];
+        readonly SET_COLOR_TEMP: readonly [2, 23];
+        readonly SET_RGB: readonly [2, 18];
+    };
+    readonly HUMIDIFIER: {
+        readonly HEADER: "5701";
+        readonly TURN_ON: "570101";
+        readonly TURN_OFF: "570102";
+        readonly INCREASE: "570103";
+        readonly DECREASE: "570104";
+        readonly SET_AUTO_MODE: "570105";
+        readonly SET_MANUAL_MODE: "570106";
+    };
+    readonly AIR_PURIFIER: {
+        readonly TURN_ON: readonly [87, 1, 1];
+        readonly TURN_OFF: readonly [87, 1, 2];
+        readonly SET_MODE: readonly [87, 2];
+        readonly SET_SPEED: readonly [87, 3];
+    };
+    readonly PLUG: {
+        readonly TURN_ON: readonly [87, 15, 80, 1, 1];
+        readonly TURN_OFF: readonly [87, 15, 80, 1, 2];
+        readonly TOGGLE: readonly [87, 15, 80, 1, 0];
+    };
+    readonly COMMON: {
+        readonly POWER_ON: readonly [87, 1, 1];
+        readonly POWER_OFF: readonly [87, 1, 2];
+    };
+};
+/**
+ * Lock Command Constants (WoSmartLock)
+ */
+export declare const WoSmartLockCommands: {
+    readonly LOCK: readonly [87, 15, 78, 1, 0];
+    readonly UNLOCK: readonly [87, 15, 78, 1, 1];
+};
+/**
+ * Lock Pro Command Constants (WoSmartLockPro)
+ */
+export declare const WoSmartLockProCommands: {
+    readonly LOCK: readonly [87, 15, 79, 1, 0];
+    readonly UNLOCK: readonly [87, 15, 79, 1, 1];
+    readonly UNLATCH: readonly [87, 15, 79, 1, 2];
+};
+/**
+ * Device Model to Type Mapping
+ */
+export declare const DEVICE_MODEL_MAP: Record<string, string>;
+/**
+ * Device Type to Class Name Mapping
+ */
+export declare const DEVICE_CLASS_MAP: Record<string, string>;
+/**
+ * Default configuration values
+ */
+export declare const DEFAULTS: {
+    readonly logLevel: 2;
+    readonly scanTimeout: 10000;
+    readonly connectTimeout: 10000;
+    readonly commandTimeout: 5000;
+    readonly enableBLE: true;
+    readonly enableFallback: true;
+    readonly baseURL: "https://api.switch-bot.com";
+};
+/**
+ * Platform detection
+ */
+export declare const IS_LINUX: boolean;
+export declare const BLE_SUPPORTED: boolean;
 //# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED,eAAO,MAAM,IAAI;;;;;;;CAmBhB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,qCAAqC,CAAA;AACnE,eAAO,MAAM,eAAe,qCAAqC,CAAA;AACjE,eAAO,MAAM,gBAAgB,qCAAqC,CAAA;AAClE,eAAO,MAAM,gBAAgB,SAAS,CAAA;AAEtC,eAAO,MAAM,iBAAiB,OAAO,CAAA;AACrC,eAAO,MAAM,kBAAkB,OAAO,CAAA;AACtC,eAAO,MAAM,oBAAoB,OAAO,CAAA;AAExC,eAAO,MAAM,0BAA0B,OAAO,CAAA;AAC9C,eAAO,MAAM,yBAAyB,SAAK,CAAA;AAE3C,oBAAY,sBAAsB;IAChC,QAAQ,aAAa;IACrB,SAAS,eAAe;IACxB,MAAM,qBAAqB;IAC3B,iBAAiB,qBAAqB;IACtC,IAAI,qBAAqB;IACzB,oBAAoB,uBAAuB;IAC3C,qBAAqB,WAAW;CACjC;AAED,oBAAY,mBAAmB;IAC7B,QAAQ,aAAa;IACrB,SAAS,eAAe;IACxB,MAAM,mBAAmB;IACzB,iBAAiB,mBAAmB;IACpC,IAAI,mBAAmB;IACvB,oBAAoB,uBAAuB;IAC3C,qBAAqB,WAAW;CACjC;AAGD,oBAAY,wBAAwB;IAClC,QAAQ,aAAa;IACrB,SAAS,eAAe;IACxB,MAAM,qBAAqB;IAC3B,iBAAiB,qBAAqB;IACtC,IAAI,qBAAqB;IACzB,oBAAoB,uBAAuB;IAC3C,qBAAqB,WAAW;CACjC"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,eAAO,MAAM,gBAAgB,+BAA+B,CAAA;AAC5D,eAAO,MAAM,WAAW,SAAS,CAAA;AAEjC,eAAO,MAAM,IAAI,EAAE;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAMhB,CAAA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAKtD;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,qCAAqC,CAAA;AAClE,eAAO,MAAM,6BAA6B,qCAAqC,CAAA;AAC/E,eAAO,MAAM,8BAA8B,qCAAqC,CAAA;AAGhF,eAAO,MAAM,iBAAiB,yCAAyC,CAAA;AACvE,eAAO,MAAM,eAAe,yCAAyC,CAAA;AACrE,eAAO,MAAM,gBAAgB,yCAAyC,CAAA;AACtE,eAAO,MAAM,gBAAgB,yCAAyC,CAAA;AAEtE;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAQ,CAAA;AACrC,eAAO,MAAM,mBAAmB,QAAQ,CAAA;AACxC,eAAO,MAAM,mBAAmB,OAAO,CAAA;AACvC,eAAO,MAAM,iBAAiB,QAAQ,CAAA;AACtC,eAAO,MAAM,kBAAkB,QAAQ,CAAA;AAEvC;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoElB,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;CAGtB,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;CAIzB,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAqC1C,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0C1C,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;CAQX,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,QAAQ,SAA+B,CAAA;AACpD,eAAO,MAAM,aAAa,SAAW,CAAA"}

package/dist/settings.js

@@ -1,80 +1,230 @@
-/**
- * Switchbot BLE API registration settings.
+/* Copyright(C) 2024-2026, donavanbecker (https://github.com/donavanbecker). All rights reserved.
  *
- * © 2024, donavanbecker (https://github.com/donavanbecker). All rights reserved.
+ * settings.ts: SwitchBot v4.0.0 - Configuration and Constants
+ */
+import process from 'node:process';
+/**
+ * OpenAPI Configuration
  */
-let baseURL = 'https://api.switch-bot.com';
-// API version used for endpoint paths
-const API_VERSION = '/v1.1';
-// URLs are generated dynamically via getters below
+export const DEFAULT_BASE_URL = 'https://api.switch-bot.com';
+export const API_VERSION = 'v1.1';
+export const urls = {
+    base: DEFAULT_BASE_URL,
+    devices: `${DEFAULT_BASE_URL}/${API_VERSION}/devices`,
+    scenes: `${DEFAULT_BASE_URL}/${API_VERSION}/scenes`,
+    webhook: `${DEFAULT_BASE_URL}/${API_VERSION}/webhook`,
+};
 /**
- * Updates the base URL for the SwitchBot API endpoints.
- * @param {string} newBaseURL - The new base URL to use.
+ * Update the base URL for all API endpoints
+ * @param newBaseURL - The new base URL to use
  */
 export function updateBaseURL(newBaseURL) {
-    baseURL = newBaseURL;
+    urls.base = newBaseURL;
+    urls.devices = `${newBaseURL}/${API_VERSION}/devices`;
+    urls.scenes = `${newBaseURL}/${API_VERSION}/scenes`;
+    urls.webhook = `${newBaseURL}/${API_VERSION}/webhook`;
 }
-export const urls = {
-    get baseURL() {
-        return baseURL;
+/**
+ * BLE Configuration
+ */
+export const BLE_SERVICE_UUID = 'cba20d00224d11e69fb80002a5d5c51b';
+export const BLE_WRITE_CHARACTERISTIC_UUID = 'cba20002224d11e69fb80002a5d5c51b';
+export const BLE_NOTIFY_CHARACTERISTIC_UUID = 'cba20003224d11e69fb80002a5d5c51b';
+// Alternative UUIDs for specific devices
+export const SERV_UUID_PRIMARY = 'cba20d00-224d-11e6-9fb8-0002a5d5c51b';
+export const CHAR_UUID_WRITE = 'cba20002-224d-11e6-9fb8-0002a5d5c51b';
+export const CHAR_UUID_NOTIFY = 'cba20003-224d-11e6-9fb8-0002a5d5c51b';
+export const CHAR_UUID_DEVICE = 'cba20d00-224d-11e6-9fb8-0002a5d5c51b';
+/**
+ * BLE Timeouts (in milliseconds)
+ */
+export const BLE_SCAN_TIMEOUT = 10000;
+export const BLE_CONNECT_TIMEOUT = 10000;
+export const BLE_COMMAND_TIMEOUT = 5000;
+export const READ_TIMEOUT_MSEC = 10000;
+export const WRITE_TIMEOUT_MSEC = 10000;
+/**
+ * Device Command Constants
+ */
+export const DEVICE_COMMANDS = {
+    // Bot (WoHand)
+    BOT: {
+        PRESS: [0x57, 0x01, 0x00],
+        TURN_ON: [0x57, 0x01, 0x01],
+        TURN_OFF: [0x57, 0x01, 0x02],
+        DOWN: [0x57, 0x01, 0x01],
+        UP: [0x57, 0x01, 0x02],
     },
-    get devicesURL() {
-        return `${baseURL}${API_VERSION}/devices`;
+    // Curtain (WoCurtain)
+    CURTAIN: {
+        OPEN: [0x57, 0x0F, 0x45, 0x01, 0x05, 0xFF, 0x00],
+        CLOSE: [0x57, 0x0F, 0x45, 0x01, 0x05, 0xFF, 0x64],
+        PAUSE: [0x57, 0x0F, 0x45, 0x01, 0x00, 0xFF],
+        POSITION: [0x57, 0x0F, 0x45, 0x01, 0x05, 0xFF], // Add position byte
     },
-    get setupWebhook() {
-        return `${baseURL}${API_VERSION}/webhook/setupWebhook`;
+    // Blind Tilt
+    BLIND_TILT: {
+        OPEN: [0x57, 0x0F, 0x45, 0x01, 0x05, 0xFF, 0x32],
+        CLOSE_UP: [0x57, 0x0F, 0x45, 0x01, 0x05, 0xFF, 0x64],
+        CLOSE_DOWN: [0x57, 0x0F, 0x45, 0x01, 0x05, 0xFF, 0x00],
+        PAUSE: [0x57, 0x0F, 0x45, 0x01, 0x00, 0xFF],
     },
-    get queryWebhook() {
-        return `${baseURL}${API_VERSION}/webhook/queryWebhook`;
+    // Bulb (WoBulb)
+    BULB: {
+        BASE: [0x57, 0x0F, 0x47, 0x01],
+        READ_STATE: [0x57, 0x0F, 0x48, 0x01],
+        TURN_ON: [0x01, 0x01],
+        TURN_OFF: [0x01, 0x02],
+        SET_BRIGHTNESS: [0x02, 0x14], // Add brightness byte
+        SET_COLOR_TEMP: [0x02, 0x17], // Add temp bytes
+        SET_RGB: [0x02, 0x12], // Add RGB bytes
     },
-    get updateWebhook() {
-        return `${baseURL}${API_VERSION}/webhook/updateWebhook`;
+    // Humidifier
+    HUMIDIFIER: {
+        HEADER: '5701',
+        TURN_ON: '570101',
+        TURN_OFF: '570102',
+        INCREASE: '570103',
+        DECREASE: '570104',
+        SET_AUTO_MODE: '570105',
+        SET_MANUAL_MODE: '570106',
     },
-    get deleteWebhook() {
-        return `${baseURL}${API_VERSION}/webhook/deleteWebhook`;
+    // Air Purifier
+    AIR_PURIFIER: {
+        TURN_ON: [0x57, 0x01, 0x01],
+        TURN_OFF: [0x57, 0x01, 0x02],
+        SET_MODE: [0x57, 0x02], // Add mode byte
+        SET_SPEED: [0x57, 0x03], // Add speed byte
     },
+    // Plug
+    PLUG: {
+        TURN_ON: [0x57, 0x0F, 0x50, 0x01, 0x01],
+        TURN_OFF: [0x57, 0x0F, 0x50, 0x01, 0x02],
+        TOGGLE: [0x57, 0x0F, 0x50, 0x01, 0x00],
+    },
+    // Common commands
+    COMMON: {
+        POWER_ON: [0x57, 0x01, 0x01],
+        POWER_OFF: [0x57, 0x01, 0x02],
+    },
+};
+/**
+ * Lock Command Constants (WoSmartLock)
+ */
+export const WoSmartLockCommands = {
+    LOCK: [0x57, 0x0F, 0x4E, 0x01, 0x00],
+    UNLOCK: [0x57, 0x0F, 0x4E, 0x01, 0x01],
+};
+/**
+ * Lock Pro Command Constants (WoSmartLockPro)
+ */
+export const WoSmartLockProCommands = {
+    LOCK: [0x57, 0x0F, 0x4F, 0x01, 0x00],
+    UNLOCK: [0x57, 0x0F, 0x4F, 0x01, 0x01],
+    UNLATCH: [0x57, 0x0F, 0x4F, 0x01, 0x02],
+};
+/**
+ * Device Model to Type Mapping
+ */
+export const DEVICE_MODEL_MAP = {
+    'H': 'Bot',
+    'c': 'Curtain',
+    '{': 'Curtain3',
+    'g': 'Plug',
+    'j': 'Plug Mini (US)',
+    'T': 'Meter',
+    'i': 'Meter Plus',
+    'o': 'Lock',
+    '\x11': 'Lock Pro',
+    'k': 'Keypad',
+    '\x0B': 'Keypad Touch',
+    's': 'Motion Sensor',
+    'd': 'Contact Sensor',
+    'q': 'Ceiling Light',
+    'r': 'Ceiling Light Pro',
+    'p': 'Strip Light',
+    'u': 'Color Bulb',
+    '\x0A': 'Robot Vacuum Cleaner S1',
+    '\x0C': 'Robot Vacuum Cleaner S1 Plus',
+    '\x0F': 'Robot Vacuum Cleaner K10 Plus',
+    'e': 'Humidifier',
+    '\x07': 'Humidifier 2',
+    'x': 'Blind Tilt',
+    '\x01': 'Hub 2',
+    '\x02': 'Hub 3',
+    '\x05': 'Remote',
+    '\x04': 'Battery Circulator Fan',
+    '\x08': 'Air Purifier',
+    '\x09': 'Air Purifier Table',
+    'y': 'Water Leak Detector',
+    '\x06': 'Presence Sensor',
+    '\x0D': 'Relay Switch 1PM',
+    '\x0E': 'Relay Switch 1',
+    '\x10': 'K10+ Pro Combo',
+    'w': 'Meter Pro (CO2)',
+    'n': 'Outdoor Meter',
+};
+/**
+ * Device Type to Class Name Mapping
+ */
+export const DEVICE_CLASS_MAP = {
+    'Bot': 'WoHand',
+    'Curtain': 'WoCurtain',
+    'Curtain3': 'WoCurtain',
+    'Plug': 'WoPlugUS',
+    'Plug Mini (US)': 'WoPlugMiniUS',
+    'Plug Mini (JP)': 'WoPlugMiniJP',
+    'Plug Mini (EU)': 'WoPlugMiniEU',
+    'Meter': 'WoSensorTH',
+    'Meter Plus': 'WoSensorTHPlus',
+    'Meter Pro': 'WoSensorTHPro',
+    'Meter Pro (CO2)': 'WoSensorTHProCO2',
+    'Outdoor Meter': 'WoIOSensorTH',
+    'Lock': 'WoSmartLock',
+    'Lock Pro': 'WoSmartLockPro',
+    'Keypad': 'WoKeypad',
+    'Keypad Touch': 'WoKeypad',
+    'Motion Sensor': 'WoPresence',
+    'Contact Sensor': 'WoContact',
+    'Ceiling Light': 'WoCeilingLight',
+    'Ceiling Light Pro': 'WoCeilingLight',
+    'Strip Light': 'WoStrip',
+    'Color Bulb': 'WoBulb',
+    'Robot Vacuum Cleaner S1': 'WoVacuum',
+    'Robot Vacuum Cleaner S1 Plus': 'WoVacuum',
+    'Robot Vacuum Cleaner K10 Plus': 'WoVacuum',
+    'Humidifier': 'WoHumi',
+    'Humidifier 2': 'WoHumi2',
+    'Blind Tilt': 'WoBlindTilt',
+    'Hub 2': 'WoHub2',
+    'Hub 3': 'WoHub3',
+    'Hub Mini': 'WoHub2',
+    'Hub Plus': 'WoHub2',
+    'Remote': 'WoRemote',
+    'Battery Circulator Fan': 'WoFan',
+    'Air Purifier': 'WoAirPurifier',
+    'Air Purifier Table': 'WoAirPurifierTable',
+    'Water Leak Detector': 'WoLeak',
+    'Presence Sensor': 'WoPresence',
+    'Relay Switch 1PM': 'WoRelaySwitch1PM',
+    'Relay Switch 1': 'WoRelaySwitch1',
+    'K10+ Pro Combo': 'WoVacuum',
+};
+/**
+ * Default configuration values
+ */
+export const DEFAULTS = {
+    logLevel: 2, // WARN
+    scanTimeout: BLE_SCAN_TIMEOUT,
+    connectTimeout: BLE_CONNECT_TIMEOUT,
+    commandTimeout: BLE_COMMAND_TIMEOUT,
+    enableBLE: true,
+    enableFallback: true,
+    baseURL: DEFAULT_BASE_URL,
 };
 /**
- * constants used to access SwitchBot BLE API
+ * Platform detection
  */
-export const SERV_UUID_PRIMARY = 'cba20d00224d11e69fb80002a5d5c51b';
-export const CHAR_UUID_WRITE = 'cba20002224d11e69fb80002a5d5c51b';
-export const CHAR_UUID_NOTIFY = 'cba20003224d11e69fb80002a5d5c51b';
-export const CHAR_UUID_DEVICE = '2a00';
-export const READ_TIMEOUT_MSEC = 3000;
-export const WRITE_TIMEOUT_MSEC = 3000;
-export const COMMAND_TIMEOUT_MSEC = 3000;
-export const DEFAULT_DISCOVERY_DURATION = 5000;
-export const PRIMARY_SERVICE_UUID_LIST = [];
-export var WoSmartLockProCommands;
-(function (WoSmartLockProCommands) {
-    WoSmartLockProCommands["GET_CKIV"] = "570f2103";
-    WoSmartLockProCommands["LOCK_INFO"] = "570f4f8102";
-    WoSmartLockProCommands["UNLOCK"] = "570f4e0101000080";
-    WoSmartLockProCommands["UNLOCK_NO_UNLATCH"] = "570f4e01010000a0";
-    WoSmartLockProCommands["LOCK"] = "570f4e0101000000";
-    WoSmartLockProCommands["ENABLE_NOTIFICATIONS"] = "570e01001e00008101";
-    WoSmartLockProCommands["DISABLE_NOTIFICATIONS"] = "570e00";
-})(WoSmartLockProCommands || (WoSmartLockProCommands = {}));
-export var WoSmartLockCommands;
-(function (WoSmartLockCommands) {
-    WoSmartLockCommands["GET_CKIV"] = "570f2103";
-    WoSmartLockCommands["LOCK_INFO"] = "570f4f8101";
-    WoSmartLockCommands["UNLOCK"] = "570f4e01011080";
-    WoSmartLockCommands["UNLOCK_NO_UNLATCH"] = "570f4e010110a0";
-    WoSmartLockCommands["LOCK"] = "570f4e01011000";
-    WoSmartLockCommands["ENABLE_NOTIFICATIONS"] = "570e01001e00008101";
-    WoSmartLockCommands["DISABLE_NOTIFICATIONS"] = "570e00";
-})(WoSmartLockCommands || (WoSmartLockCommands = {}));
-// Lock Ultra uses the same command structure as Lock Pro (AES/IV based).
-export var WoSmartLockUltraCommands;
-(function (WoSmartLockUltraCommands) {
-    WoSmartLockUltraCommands["GET_CKIV"] = "570f2103";
-    WoSmartLockUltraCommands["LOCK_INFO"] = "570f4f8102";
-    WoSmartLockUltraCommands["UNLOCK"] = "570f4e0101000080";
-    WoSmartLockUltraCommands["UNLOCK_NO_UNLATCH"] = "570f4e01010000a0";
-    WoSmartLockUltraCommands["LOCK"] = "570f4e0101000000";
-    WoSmartLockUltraCommands["ENABLE_NOTIFICATIONS"] = "570e01001e00008101";
-    WoSmartLockUltraCommands["DISABLE_NOTIFICATIONS"] = "570e00";
-})(WoSmartLockUltraCommands || (WoSmartLockUltraCommands = {}));
+export const IS_LINUX = process.platform === 'linux';
+export const BLE_SUPPORTED = IS_LINUX;
 //# sourceMappingURL=settings.js.map