@switchbot/homebridge-switchbot 5.0.0-beta.12 → 5.0.0-beta.121

package/dist/switchbotClient.js

@@ -0,0 +1,253 @@
+import { SwitchbotOperationError, SwitchbotAuthenticationError, CharacteristicMissingError } from './errors.js';
+/**
+ * Thin wrapper around node-switchbot v4.0.0-beta.2+
+ * Leverages upstream resilience features (retry, circuit breaker, connection intelligence)
+ * while maintaining plugin-specific features like write debouncing and OpenAPI fallback.
+ */
+export class SwitchBotClient {
+    cfg;
+    client = null;
+    baseUrl = 'https://api.switch-bot.com/v1.0';
+    requestTimeout = 5000;
+    maxRetries = 2;
+    writeDebounceMs = 100;
+    logger;
+    pendingWrites = new Map();
+    constructor(cfg) {
+        this.cfg = cfg;
+        this.logger = cfg?.logger ?? console;
+        if (typeof cfg?.requestTimeout === 'number')
+            this.requestTimeout = cfg.requestTimeout;
+        if (typeof cfg?.maxRetries === 'number')
+            this.maxRetries = cfg.maxRetries;
+        if (typeof cfg?.writeDebounceMs === 'number')
+            this.writeDebounceMs = cfg.writeDebounceMs;
+    }
+    async init() {
+        try {
+            // Dynamic import of node-switchbot v4 with native resilience features
+            const { SwitchBot } = await import('node-switchbot');
+            this.client = new SwitchBot({
+                token: this.cfg.openApiToken,
+                secret: this.cfg.openApiSecret,
+                // Enable all built-in resilience features from node-switchbot v4
+                enableFallback: true, // Auto-fallback from BLE to API
+                enableRetry: true, // Retry with exponential backoff
+                enableCircuitBreaker: true, // Circuit breaker per connection type
+                enableMetrics: true, // Connection tracking and statistics
+                enableBLE: true, // Enable BLE scanning by default
+                scanDuration: 5000, // BLE scan duration in milliseconds
+                ...(typeof this.cfg?.nodeClientConfig === 'object' && this.cfg.nodeClientConfig),
+            });
+            this.logger?.info?.('SwitchBot client initialized with native resilience features');
+        }
+        catch (e) {
+            this.logger?.warn?.('Failed to load node-switchbot; will use OpenAPI fallback:', e);
+            this.client = null;
+        }
+    }
+    async fetchWithTimeoutAndRetry(url, opts = {}, timeoutMs, retries) {
+        const to = typeof timeoutMs === 'number' ? timeoutMs : this.requestTimeout;
+        const max = typeof retries === 'number' ? retries : this.maxRetries;
+        let attempt = 0;
+        while (true) {
+            attempt += 1;
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), to);
+            try {
+                const fetchOpts = Object.assign({}, opts);
+                try {
+                    Object.defineProperty(fetchOpts, 'signal', { value: controller.signal, enumerable: false, configurable: true });
+                }
+                catch (_e) {
+                    // ignore
+                }
+                const resp = await fetch(url, fetchOpts);
+                clearTimeout(timer);
+                if (resp.ok)
+                    return resp;
+                // server error / rate limit: retry
+                if (resp.status >= 500 || resp.status === 429) {
+                    throw new Error(`retriable response: ${resp.status}`);
+                }
+                return resp;
+            }
+            catch (err) {
+                clearTimeout(timer);
+                if (attempt > max)
+                    throw err;
+                // exponential backoff
+                const backoff = Math.min(100 * Math.pow(2, attempt - 1), 2000);
+                await new Promise((r) => setTimeout(r, backoff));
+            }
+        }
+    }
+    async getDevice(id) {
+        // Try client API first (with node-switchbot's smart fallback and retry)
+        if (this.client?.getDevice) {
+            try {
+                return await this.client.getDevice(id);
+            }
+            catch (e) {
+                if (e instanceof SwitchbotAuthenticationError) {
+                    this.logger?.error?.(`Authentication error for getDevice(${id}):`, e.message);
+                    throw e;
+                }
+                else if (e instanceof SwitchbotOperationError) {
+                    this.logger?.warn?.(`Operation error for getDevice(${id}):`, e.message, e.code);
+                }
+                else if (e instanceof CharacteristicMissingError) {
+                    this.logger?.warn?.(`Characteristic missing for getDevice(${id}):`, e.characteristic);
+                }
+                else {
+                    this.logger?.warn?.(`Client getDevice failed for ${id}, trying OpenAPI fallback:`, e);
+                }
+            }
+        }
+        // Fallback: call OpenAPI via HTTP
+        if (this.cfg.openApiToken) {
+            const url = `${this.baseUrl}/devices/${id}`;
+            const opts = { headers: { Authorization: this.cfg.openApiToken } };
+            const resp = await this.fetchWithTimeoutAndRetry(url, opts);
+            return resp.json();
+        }
+        throw new SwitchbotOperationError('No SwitchBot client available', 'no_client');
+    }
+    async getDevices() {
+        // Try client API first
+        if (this.client?.getDevices) {
+            try {
+                return await this.client.getDevices();
+            }
+            catch (e) {
+                this.logger?.warn?.('Client getDevices failed, trying OpenAPI fallback:', e);
+            }
+        }
+        // Fallback: call OpenAPI
+        if (this.cfg.openApiToken) {
+            const url = `${this.baseUrl}/devices`;
+            const opts = { headers: { Authorization: this.cfg.openApiToken } };
+            const resp = await this.fetchWithTimeoutAndRetry(url, opts);
+            const data = await resp.json();
+            return (data?.body || data);
+        }
+        return [];
+    }
+    async setDeviceState(id, body) {
+        // Plugin-level debounce: coalesce rapid writes per device
+        if (!this.writeDebounceMs || this.writeDebounceMs <= 0) {
+            return this._doSetDeviceState(id, body);
+        }
+        return new Promise((resolve, reject) => {
+            const existing = this.pendingWrites.get(id);
+            if (existing) {
+                existing.body = body;
+                existing.resolvers.push({ resolve, reject });
+                return;
+            }
+            const resolvers = [{ resolve, reject }];
+            const timer = setTimeout(async () => {
+                const entry = this.pendingWrites.get(id);
+                if (!entry)
+                    return;
+                this.pendingWrites.delete(id);
+                try {
+                    const out = await this._doSetDeviceState(id, entry.body);
+                    for (const r of entry.resolvers)
+                        r.resolve(out);
+                }
+                catch (e) {
+                    if (e instanceof SwitchbotAuthenticationError) {
+                        this.logger?.error?.(`Authentication error for setDeviceState(${id}):`, e.message);
+                    }
+                    else if (e instanceof SwitchbotOperationError) {
+                        this.logger?.warn?.(`Operation error for setDeviceState(${id}):`, e.message, e.code);
+                    }
+                    else if (e instanceof CharacteristicMissingError) {
+                        this.logger?.warn?.(`Characteristic missing for setDeviceState(${id}):`, e.characteristic);
+                    }
+                    for (const r of entry.resolvers)
+                        r.reject(e);
+                }
+            }, this.writeDebounceMs);
+            this.pendingWrites.set(id, { timer, body, resolvers });
+        });
+    }
+    async _doSetDeviceState(id, body) {
+        // Prefer client API (which has node-switchbot's native resilience)
+        if (this.client?.setDeviceState) {
+            try {
+                this.logger?.debug?.(`[${id}] Using client.setDeviceState()`);
+                const result = await this.client.setDeviceState(id, body);
+                this.logger?.debug?.(`[${id}] client.setDeviceState() response:`, result);
+                return result;
+            }
+            catch (e) {
+                if (e instanceof SwitchbotAuthenticationError) {
+                    this.logger?.error?.(`Authentication error for setDeviceState(${id}):`, e.message);
+                    throw e;
+                }
+                else if (e instanceof SwitchbotOperationError) {
+                    this.logger?.warn?.(`Operation error for setDeviceState(${id}):`, e.message, e.code);
+                }
+                else if (e instanceof CharacteristicMissingError) {
+                    this.logger?.warn?.(`Characteristic missing for setDeviceState(${id}):`, e.characteristic);
+                }
+                else {
+                    this.logger?.warn?.(`Client setDeviceState failed for ${id}, trying fallback:`, e);
+                }
+            }
+        }
+        // Try generic sendCommand if available
+        if (this.client?.sendCommand) {
+            try {
+                this.logger?.debug?.(`[${id}] Using client.sendCommand()`);
+                const result = await this.client.sendCommand(id, body);
+                this.logger?.debug?.(`[${id}] client.sendCommand() response:`, result);
+                return result;
+            }
+            catch (e) {
+                if (e instanceof SwitchbotAuthenticationError) {
+                    this.logger?.error?.(`Authentication error for sendCommand(${id}):`, e.message);
+                    throw e;
+                }
+                else if (e instanceof SwitchbotOperationError) {
+                    this.logger?.warn?.(`Operation error for sendCommand(${id}):`, e.message, e.code);
+                }
+                else if (e instanceof CharacteristicMissingError) {
+                    this.logger?.warn?.(`Characteristic missing for sendCommand(${id}):`, e.characteristic);
+                }
+                else {
+                    this.logger?.warn?.(`Client sendCommand failed for ${id}, trying OpenAPI:`, e);
+                }
+            }
+        }
+        // OpenAPI fallback
+        if (this.cfg.openApiToken) {
+            const url = `${this.baseUrl}/devices/${id}/commands`;
+            const opts = {
+                method: 'POST',
+                headers: {
+                    Authorization: this.cfg.openApiToken,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(body),
+            };
+            this.logger?.debug?.(`[${id}] Using OpenAPI fallback POST ${url}`);
+            this.logger?.debug?.(`[${id}] Request body:`, body);
+            const resp = await this.fetchWithTimeoutAndRetry(url, opts);
+            const result = await resp.json();
+            this.logger?.debug?.(`[${id}] OpenAPI response:`, result);
+            this.logger?.debug?.(`[${id}] Response status:`, resp.status, resp.statusText);
+            return result;
+        }
+        throw new SwitchbotOperationError('No SwitchBot client available for setDeviceState', 'no_client');
+    }
+    async destroy() {
+        if (this.client?.destroy) {
+            await this.client.destroy();
+        }
+        this.client = null;
+    }
+}
+//# sourceMappingURL=switchbotClient.js.map

package/dist/switchbotClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switchbotClient.js","sourceRoot":"","sources":["../src/switchbotClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAU/G;;;;GAIG;AACH,MAAM,OAAO,eAAe;IAClB,GAAG,CAAuB;IAC1B,MAAM,GAAe,IAAI,CAAA;IACzB,OAAO,GAAG,iCAAiC,CAAA;IAC3C,cAAc,GAAG,IAAI,CAAA;IACrB,UAAU,GAAG,CAAC,CAAA;IACd,eAAe,GAAG,GAAG,CAAA;IACrB,MAAM,CAAK;IACX,aAAa,GAAiH,IAAI,GAAG,EAAE,CAAA;IAE/I,YAAY,GAA0B;QACpC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;QACd,IAAI,CAAC,MAAM,GAAI,GAAW,EAAE,MAAM,IAAI,OAAO,CAAA;QAC7C,IAAI,OAAQ,GAAW,EAAE,cAAc,KAAK,QAAQ;YAAE,IAAI,CAAC,cAAc,GAAI,GAAW,CAAC,cAAc,CAAA;QACvG,IAAI,OAAQ,GAAW,EAAE,UAAU,KAAK,QAAQ;YAAE,IAAI,CAAC,UAAU,GAAI,GAAW,CAAC,UAAU,CAAA;QAC3F,IAAI,OAAQ,GAAW,EAAE,eAAe,KAAK,QAAQ;YAAE,IAAI,CAAC,eAAe,GAAI,GAAW,CAAC,eAAe,CAAA;IAC5G,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,sEAAsE;YACtE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAA;YACpD,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC;gBAC1B,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY;gBAC5B,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa;gBAC9B,iEAAiE;gBACjE,cAAc,EAAE,IAAI,EAAS,gCAAgC;gBAC7D,WAAW,EAAE,IAAI,EAAa,iCAAiC;gBAC/D,oBAAoB,EAAE,IAAI,EAAI,sCAAsC;gBACpE,aAAa,EAAE,IAAI,EAAW,qCAAqC;gBACnE,SAAS,EAAE,IAAI,EAAe,iCAAiC;gBAC/D,YAAY,EAAE,IAAI,EAAY,oCAAoC;gBAClE,GAAG,CAAC,OAAQ,IAAI,CAAC,GAAW,EAAE,gBAAgB,KAAK,QAAQ,IAAK,IAAI,CAAC,GAAW,CAAC,gBAAgB,CAAC;aACnG,CAAC,CAAA;YACF,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,8DAA8D,CAAC,CAAA;QACrF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,2DAA2D,EAAE,CAAC,CAAC,CAAA;YACnF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QACpB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,wBAAwB,CAAC,GAAW,EAAE,OAAY,EAAE,EAAE,SAAkB,EAAE,OAAgB;QACtG,MAAM,EAAE,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAA;QAC1E,MAAM,GAAG,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAA;QAEnE,IAAI,OAAO,GAAG,CAAC,CAAA;QACf,OAAO,IAAI,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC,CAAA;YACZ,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;YACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;YACtD,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;gBACzC,IAAI,CAAC;oBACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAA;gBACjH,CAAC;gBAAC,OAAO,EAAE,EAAE,CAAC;oBACZ,SAAS;gBACX,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;gBACxC,YAAY,CAAC,KAAK,CAAC,CAAA;gBACnB,IAAI,IAAI,CAAC,EAAE;oBAAE,OAAO,IAAI,CAAA;gBACxB,mCAAmC;gBACnC,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAC9C,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;gBACvD,CAAC;gBACD,OAAO,IAAI,CAAA;YACb,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,YAAY,CAAC,KAAK,CAAC,CAAA;gBACnB,IAAI,OAAO,GAAG,GAAG;oBAAE,MAAM,GAAG,CAAA;gBAC5B,sBAAsB;gBACtB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;gBAC9D,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,EAAU;QACxB,wEAAwE;QACxE,IAAI,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;YACxC,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBAChB,IAAI,CAAC,YAAY,4BAA4B,EAAE,CAAC;oBAC9C,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,sCAAsC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;oBAC7E,MAAM,CAAC,CAAA;gBACT,CAAC;qBAAM,IAAI,CAAC,YAAY,uBAAuB,EAAE,CAAC;oBAChD,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,iCAAiC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;gBACjF,CAAC;qBAAM,IAAI,CAAC,YAAY,0BAA0B,EAAE,CAAC;oBACnD,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,wCAAwC,EAAE,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC,CAAA;gBACvF,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,+BAA+B,EAAE,4BAA4B,EAAE,CAAC,CAAC,CAAA;gBACvF,CAAC;YACH,CAAC;QACH,CAAC;QACD,kCAAkC;QAClC,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,YAAY,EAAE,EAAE,CAAA;YAC3C,MAAM,IAAI,GAAG,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAA;YAClE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YAC3D,OAAO,IAAI,CAAC,IAAI,EAAE,CAAA;QACpB,CAAC;QACD,MAAM,IAAI,uBAAuB,CAAC,+BAA+B,EAAE,WAAW,CAAC,CAAA;IACjF,CAAC;IAED,KAAK,CAAC,UAAU;QACd,uBAAuB;QACvB,IAAI,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAA;YACvC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,oDAAoD,EAAE,CAAC,CAAC,CAAA;YAC9E,CAAC;QACH,CAAC;QACD,yBAAyB;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,UAAU,CAAA;YACrC,MAAM,IAAI,GAAG,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAA;YAClE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YAC3D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;YAC9B,OAAO,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,CAAU,CAAA;QACtC,CAAC;QACD,OAAO,EAAE,CAAA;IACX,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,EAAU,EAAE,IAAS;QACxC,0DAA0D;QAC1D,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,eAAe,IAAI,CAAC,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QACzC,CAAC;QAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YAC3C,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAA;gBACpB,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;gBAC5C,OAAM;YACR,CAAC;YAED,MAAM,SAAS,GAA6D,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;YACjG,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;gBAClC,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBACxC,IAAI,CAAC,KAAK;oBAAE,OAAM;gBAClB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;gBAC7B,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;oBACxD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS;wBAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;gBACjD,CAAC;gBAAC,OAAO,CAAM,EAAE,CAAC;oBAChB,IAAI,CAAC,YAAY,4BAA4B,EAAE,CAAC;wBAC9C,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,2CAA2C,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;oBACpF,CAAC;yBAAM,IAAI,CAAC,YAAY,uBAAuB,EAAE,CAAC;wBAChD,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,sCAAsC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;oBACtF,CAAC;yBAAM,IAAI,CAAC,YAAY,0BAA0B,EAAE,CAAC;wBACnD,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,6CAA6C,EAAE,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC,CAAA;oBAC5F,CAAC;oBACD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS;wBAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;gBAC9C,CAAC;YACH,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAA;YAExB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;QACxD,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,EAAU,EAAE,IAAS;QACnD,mEAAmE;QACnE,IAAI,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,iCAAiC,CAAC,CAAA;gBAC7D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;gBACzD,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,qCAAqC,EAAE,MAAM,CAAC,CAAA;gBACzE,OAAO,MAAM,CAAA;YACf,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBAChB,IAAI,CAAC,YAAY,4BAA4B,EAAE,CAAC;oBAC9C,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,2CAA2C,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;oBAClF,MAAM,CAAC,CAAA;gBACT,CAAC;qBAAM,IAAI,CAAC,YAAY,uBAAuB,EAAE,CAAC;oBAChD,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,sCAAsC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;gBACtF,CAAC;qBAAM,IAAI,CAAC,YAAY,0BAA0B,EAAE,CAAC;oBACnD,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,6CAA6C,EAAE,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC,CAAA;gBAC5F,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,oCAAoC,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAA;gBACpF,CAAC;YACH,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,IAAI,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,8BAA8B,CAAC,CAAA;gBAC1D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;gBACtD,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,kCAAkC,EAAE,MAAM,CAAC,CAAA;gBACtE,OAAO,MAAM,CAAA;YACf,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBAChB,IAAI,CAAC,YAAY,4BAA4B,EAAE,CAAC;oBAC9C,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,wCAAwC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;oBAC/E,MAAM,CAAC,CAAA;gBACT,CAAC;qBAAM,IAAI,CAAC,YAAY,uBAAuB,EAAE,CAAC;oBAChD,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,mCAAmC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;gBACnF,CAAC;qBAAM,IAAI,CAAC,YAAY,0BAA0B,EAAE,CAAC;oBACnD,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,0CAA0C,EAAE,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC,CAAA;gBACzF,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,iCAAiC,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAA;gBAChF,CAAC;YACH,CAAC;QACH,CAAC;QAED,mBAAmB;QACnB,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,YAAY,EAAE,WAAW,CAAA;YACpD,MAAM,IAAI,GAAG;gBACX,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY;oBACpC,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC3B,CAAA;YACD,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,iCAAiC,GAAG,EAAE,CAAC,CAAA;YAClE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAA;YACnD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YAC3D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;YAChC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAA;YACzD,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,oBAAoB,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;YAC9E,OAAO,MAAM,CAAA;QACf,CAAC;QAED,MAAM,IAAI,uBAAuB,CAAC,kDAAkD,EAAE,WAAW,CAAC,CAAA;IACpG,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAA;QAC7B,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;IACpB,CAAC;CACF"}

package/dist/utils.d.ts

@@ -1,86 +1,40 @@
-import type { API } from 'homebridge';
-import type { blindTilt, curtain, curtain3, device } from 'node-switchbot';
-import type { devicesConfig } from './settings.js';
-export declare enum BlindTiltMappingMode {
-    OnlyUp = "only_up",
-    OnlyDown = "only_down",
-    DownAndUp = "down_and_up",
-    UpAndDown = "up_and_down",
-    UseTiltForDirection = "use_tilt_for_direction"
-}
-export declare function isCurtainDevice(device: device & devicesConfig): device is (curtain | curtain3) & devicesConfig;
-export declare function isBlindTiltDevice(device: device & devicesConfig): device is blindTilt & devicesConfig;
-export declare function sleep(ms: number): Promise<void>;
-/**
- * Check if the humidity is within the min and max range
- * @param humidity - The humidity value
- * @param min - The minimum humidity value
- * @param max - The maximum humidity value
- * @returns The humidity value
- */
-export declare function validHumidity(humidity: number, min?: number, max?: number): number;
-/**
- * Converts the value to celsius if the temperature units are in Fahrenheit
- */
-export declare function convertUnits(value: number, unit: string, convert?: string): number;
-/**
- * Safely serializes an object to a JSON string, handling circular references.
- *
- * @param obj - The object to be serialized.
- * @returns The JSON string representation of the object.
- */
-export declare function safeStringify(obj: any): string;
-/**
- * Formats a device ID as a MAC address.
- * Ensures the device ID does not already contain colons.
- *
- * @param deviceId - The device ID to format.
- * @param cassSensative - If the MAC address should be case sensitive. Default is false, which will return the MAC address in lowercase.
- * @returns The formatted MAC address.
- * @throws Will throw an error if the device ID is not a valid MAC address or a 12-character hexadecimal string.
- */
-export declare function formatDeviceIdAsMac(deviceId: string, cassSensative?: boolean): string;
-export declare function rgb2hs(r: any, g: any, b: any): number[];
-export declare function hs2rgb(h: any, s: any): number[];
-export declare function k2rgb(k: number): any;
-export declare function m2hs(m: any): number[];
-/**
- * Remove deviceConfig entries that contain only default/empty values.
- * Returns undefined if nothing meaningful remains.
- */
-export declare function cleanDeviceConfig(deviceConfig?: Record<string, Record<string, any>>): Record<string, Record<string, any>> | undefined;
-/**
- * Detect whether Matter is enabled/available on the provided Homebridge API object.
- * This encapsulates the multi-fallback detection used across the project.
- */
-/**
- * Detect whether Matter is enabled on the provided Homebridge API object.
- * Returns an object with an `enabled` boolean and an optional `reason` string
- * describing which check matched (useful for diagnostics).
- */
-export declare function detectMatter(apiObj: API): {
-    enabled: boolean;
-    reason?: string;
+import type { PlatformConfig } from 'homebridge';
+import type { SwitchBotPluginConfig } from './settings.js';
+export declare const MATTER_CLUSTER_IDS: {
+    readonly OnOff: 6;
+    readonly LevelControl: 8;
+    readonly ColorControl: 768;
+    readonly WindowCovering: 258;
+    readonly DoorLock: 257;
+    readonly FanControl: 514;
+    readonly RelativeHumidityMeasurement: 1029;
 };
-/**
- * Backwards-compatible boolean wrapper for detectMatter.
- */
-export declare function detectMatterEnabled(apiObj: API): boolean;
-/**
- * Create a Platform proxy class that selects between two platform constructors
- * (HAP vs Matter) at runtime using `detectMatter`. Returns a class suitable
- * for passing to `api.registerPlatform`.
- */
-export declare function createPlatformProxy(HAPCtor: any, MatterCtor: any): {
-    new (log: any, config: any, api: API): {
-        delegate: any;
-        readonly log: any;
-        readonly config: any;
-        readonly api: API;
-        configureAccessory(accessory: any): void;
-        configureMatterAccessory?(accessory: any): void;
-        get accessories(): any;
-        get matterAccessories(): any;
+export declare const MATTER_ATTRIBUTE_IDS: {
+    readonly OnOff: {
+        readonly OnOff: 0;
+    };
+    readonly LevelControl: {
+        readonly CurrentLevel: 0;
+    };
+    readonly ColorControl: {
+        readonly CurrentHue: 0;
+        readonly CurrentSaturation: 1;
+        readonly ColorTemperatureMireds: 2;
+    };
+    readonly WindowCovering: {
+        readonly CurrentPosition: 0;
+        readonly TargetPosition: 1;
+    };
+    readonly FanControl: {
+        readonly SpeedCurrent: 0;
+    };
+    readonly DoorLock: {
+        readonly LockState: 0;
+    };
+    readonly RelativeHumidityMeasurement: {
+        readonly MeasuredValue: 0;
     };
 };
+export declare function normalizeConfig(raw?: PlatformConfig): SwitchBotPluginConfig;
+export declare function createPlatformProxy(HAPPlatform: any, MatterPlatform: any): any;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,oBAAY,oBAAoB;IAC9B,MAAM,YAAY;IAClB,QAAQ,cAAc;IACtB,SAAS,gBAAgB;IACzB,SAAS,gBAAgB;IACzB,mBAAmB,2BAA2B;CAC/C;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,aAAa,CAE9G;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,IAAI,SAAS,GAAG,aAAa,CAErG;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AACD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAOlF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAQlF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,UAWrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CA6BrF;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,YAiC5C;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,YAyCpC;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,OA8D9B;AAED,wBAAgB,IAAI,CAAC,CAAC,KAAA,YA2ZrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,SAAS,CA2CrI;AAED;;;GAGG;AACH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,GAAG,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAsB/E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG;cAI5B,GAAG,UAA0B,GAAG,OAAuB,GAAG;kBAFjF,GAAG;sBAEoB,GAAG;yBAA0B,GAAG;sBAAuB,GAAG;sCAS7D,GAAG,GAAG,IAAI;6CAUH,GAAG,GAAG,IAAI;2BAU5B,GAAG;iCAQG,GAAG;;EAQ/B"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAG1D,eAAO,MAAM,kBAAkB;;;;;;;;CAQrB,CAAA;AAGV,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;CAQvB,CAAA;AAEV,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,qBAAqB,CAG3E;AAGD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,GAAG,GAAG,CAmB9E"}