@switchbot/homebridge-switchbot 5.0.0-beta.154 → 5.0.0-beta.155

package/src/deviceFactory.ts

@@ -1,6 +1,7 @@
-import type { DeviceType, SwitchBotPluginConfig } from './settings.js'
 import type { Logger } from 'homebridge'
 
+import type { DeviceType, SwitchBotPluginConfig } from './settings.js'
+
 import { DEVICE_TYPE_NORMALIZATION_MAP } from './device-types.js'
 import {
   BlindTiltDevice,
@@ -51,12 +52,12 @@ const DEVICE_CLASS_MAP: Record<string, any> = {
   'lightstrip': LightStripDevice,
   'motion': MotionSensorDevice,
   'contact': ContactSensorDevice,
-  'vacuum': VacuumDevice, // node-switchbot beta
+  'vacuum': VacuumDevice,
   // Canonical, normalized device type keys (lowercase, mapped to device classes)
   'video doorbell': GenericDevice,
-  'smart radiator thermostat': GenericDevice, // node-switchbot beta
+  'smart radiator thermostat': GenericDevice,
   'woiosensor': GenericDevice,
-  'garage door opener': GenericDevice, // node-switchbot beta
+  'garage door opener': GenericDevice,
   'air purifier table pm2.5': GenericDevice,
   'air purifier voc': GenericDevice,
   'air purifier table voc': GenericDevice,
@@ -65,9 +66,9 @@ const DEVICE_CLASS_MAP: Record<string, any> = {
   'meterpro(co2)': MeterDevice,
   'walletfinder': WalletFinderDevice,
   'plug': PlugDevice,
-  'plug mini (eu)': PlugMiniDevice, // node-switchbot beta
-  'plug mini (jp)': PlugMiniDevice, // node-switchbot beta
-  'plug mini (us)': PlugMiniDevice, // node-switchbot beta
+  'plug mini (eu)': PlugMiniDevice,
+  'plug mini (jp)': PlugMiniDevice,
+  'plug mini (us)': PlugMiniDevice,
   'relay switch 1pm': RelaySwitch1PMDevice,
   'relay switch 2pm': RelaySwitch1PMDevice,
   'k10+ pro': WoSweeperDevice,
@@ -77,26 +78,26 @@ const DEVICE_CLASS_MAP: Record<string, any> = {
   'ai hub': GenericDevice,
   'hub': GenericDevice,
   'hub 2': Hub2Device,
-  'hub 3': GenericDevice, // node-switchbot beta
-  'hub mini': GenericDevice, // node-switchbot beta
+  'hub 3': GenericDevice,
+  'hub mini': GenericDevice,
   'hub plus': GenericDevice,
   'indoor cam': GenericDevice,
   'pan/tilt cam': GenericDevice,
   'pan/tilt cam 2k': GenericDevice,
   'pan/tilt cam plus 2k': GenericDevice,
   'pan/tilt cam plus 3k': GenericDevice,
-  'humidifier': HumidifierDevice, // node-switchbot beta (Evaporative Humidifier)
-  'roller shade': RollerShadeDevice, // node-switchbot beta
-  'strip light 3': StripLightDevice, // node-switchbot beta
-  'circulator fan': FanDevice, // node-switchbot beta
-  'smart lock pro': LockDevice, // node-switchbot beta
-  'lock lite': LockDevice, // node-switchbot beta
-  'keypad': LockDevice, // node-switchbot beta
-  'lock vision pro': LockDevice, // node-switchbot beta
-  'floor lamp': LightDevice, // node-switchbot beta
-  'rgbicww floor lamp': LightStripDevice, // node-switchbot beta
-  'rgbicww strip light': LightStripDevice, // node-switchbot beta
-  'home climate panel': GenericDevice, // node-switchbot beta (Climate Panel)
+  'humidifier': HumidifierDevice, // Includes evaporative humidifier mapping
+  'roller shade': RollerShadeDevice,
+  'strip light 3': StripLightDevice,
+  'circulator fan': FanDevice,
+  'smart lock pro': LockDevice,
+  'lock lite': LockDevice,
+  'keypad': LockDevice,
+  'lock vision pro': LockDevice,
+  'floor lamp': LightDevice,
+  'rgbicww floor lamp': LightStripDevice,
+  'rgbicww strip light': LightStripDevice,
+  'home climate panel': GenericDevice, // Climate panel family
   'lock': LockDevice,
   'humidifier2': HumidifierDevice,
   'temperature': TemperatureSensorDevice,

package/src/errors.js

@@ -0,0 +1,32 @@
+// Error classes for node-switchbot v4 compatibility
+// Always use local fallback classes for compatibility; upstream error classes are not guaranteed to exist
+const SwitchbotOperationError = class extends Error {
+    code;
+    cause;
+    constructor(message, code, cause) {
+        super(message);
+        this.name = 'SwitchbotOperationError';
+        this.code = code;
+        this.cause = cause;
+    }
+};
+const SwitchbotAuthenticationError = class extends Error {
+    code;
+    cause;
+    constructor(message, code, cause) {
+        super(message);
+        this.name = 'SwitchbotAuthenticationError';
+        this.code = code;
+        this.cause = cause;
+    }
+};
+const CharacteristicMissingError = class extends Error {
+    characteristic;
+    constructor(message, characteristic) {
+        super(message);
+        this.name = 'CharacteristicMissingError';
+        this.characteristic = characteristic;
+    }
+};
+export { CharacteristicMissingError, SwitchbotAuthenticationError, SwitchbotOperationError };
+//# sourceMappingURL=errors.js.map

package/src/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["errors.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,0GAA0G;AAE1G,MAAM,uBAAuB,GAAG,KAAM,SAAQ,KAAK;IACjD,IAAI,CAAS;IACb,KAAK,CAAQ;IACb,YAAY,OAAe,EAAE,IAAa,EAAE,KAAa;QACvD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;CACF,CAAA;AAED,MAAM,4BAA4B,GAAG,KAAM,SAAQ,KAAK;IACtD,IAAI,CAAS;IACb,KAAK,CAAQ;IACb,YAAY,OAAe,EAAE,IAAa,EAAE,KAAa;QACvD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAA;QAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;CACF,CAAA;AAED,MAAM,0BAA0B,GAAG,KAAM,SAAQ,KAAK;IACpD,cAAc,CAAQ;IACtB,YAAY,OAAe,EAAE,cAAsB;QACjD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAA;QACxC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAA;IACtC,CAAC;CACF,CAAA;AAED,OAAO,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,CAAA"}

package/src/homebridge-ui/endpoints/discovery.ts

@@ -22,6 +22,8 @@ export function registerDiscoveryEndpoint(server: HomebridgePluginUiServer) {
         enableBLE: true,
         enableFallback: true,
         enableRetry: true,
+        enableCircuitBreaker: true,
+        enableConnectionIntelligence: true,
       })
 
       await switchbot.discover({ timeout: 1000 })
@@ -50,7 +52,7 @@ export function registerDiscoveryEndpoint(server: HomebridgePluginUiServer) {
       const token = getCredential(platform, 'openApiToken') || platform.token
       const secret = getCredential(platform, 'openApiSecret') || platform.secret
 
-      const hasOpenAPICredentials = !!token
+      const hasOpenAPICredentials = !!(token && secret)
 
       if (!hasOpenAPICredentials) {
         uiLog.warn('GET /discover - No OpenAPI credentials found, will attempt BLE-only discovery')
@@ -66,6 +68,8 @@ export function registerDiscoveryEndpoint(server: HomebridgePluginUiServer) {
         enableBLE: true,
         enableFallback: true,
         enableRetry: true,
+        enableCircuitBreaker: true,
+        enableConnectionIntelligence: true,
       })
 
       const deviceMap = new Map<string, any>()

package/src/settings.js

@@ -0,0 +1,8 @@
+export const PLUGIN_NAME = '@switchbot/homebridge-switchbot';
+export const PLATFORM_NAME = 'SwitchBot';
+export const DEFAULT_CONFIG = {
+    preferMatter: true,
+    enableMatter: true,
+    enableBLE: true,
+};
+//# sourceMappingURL=settings.js.map

package/src/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["settings.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,iCAAiC,CAAA;AAC5D,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAA;AAYxC,MAAM,CAAC,MAAM,cAAc,GAAmC;IAC5D,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,IAAI;IAClB,SAAS,EAAE,IAAI;CAChB,CAAA"}

package/src/switchbotClient.js

@@ -0,0 +1,247 @@
+import { getDeviceCommandHandler } from './deviceCommandMapper.js';
+import { CharacteristicMissingError, SwitchbotAuthenticationError, SwitchbotOperationError } from './errors.js';
+/**
+ * Thin wrapper around node-switchbot v4.0.0+
+ * 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;
+    writeDebounceMs = 100;
+    discoveryCacheTtlMs = 30_000;
+    lastDiscoveryAt = 0;
+    logger;
+    pendingWrites = new Map();
+    constructor(cfg) {
+        this.cfg = cfg;
+        this.logger = cfg?.logger;
+        if (!this.logger) {
+            throw new Error('SwitchBotClient requires a logger (Homebridge logger) in config');
+        }
+        if (typeof cfg?.writeDebounceMs === 'number') {
+            this.writeDebounceMs = cfg.writeDebounceMs;
+        }
+        if (typeof cfg?.discoveryCacheTtlMs === 'number') {
+            this.discoveryCacheTtlMs = Math.max(0, cfg.discoveryCacheTtlMs);
+        }
+    }
+    async init() {
+        if (this.client) {
+            return;
+        }
+        try {
+            // Dynamic import of node-switchbot v4 with native resilience features
+            const { SwitchBot } = await import('node-switchbot');
+            const rawNodeClientConfig = typeof this.cfg?.nodeClientConfig === 'object' ? this.cfg.nodeClientConfig : {};
+            const scanTimeout = this.resolveScanTimeoutMs(rawNodeClientConfig);
+            this.client = new SwitchBot({
+                token: this.cfg.openApiToken,
+                secret: this.cfg.openApiSecret,
+                // Enable 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
+                enableConnectionIntelligence: true, // Connection tracking and route preference
+                enableBLE: this.cfg.enableBLE !== false, // Use config value, default true
+                scanTimeout,
+                ...rawNodeClientConfig,
+            });
+            this.lastDiscoveryAt = 0;
+            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 getDevice(id) {
+        if (this.client) {
+            try {
+                const fromManager = this.getManagedDevice(id);
+                if (fromManager) {
+                    return fromManager;
+                }
+                const devices = await this.ensureDiscovered(false);
+                const fromDiscovery = devices.find((d) => d.id === id);
+                if (fromDiscovery) {
+                    return fromDiscovery;
+                }
+                const refreshDevices = await this.ensureDiscovered(true);
+                return refreshDevices.find((d) => d.id === 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);
+                    throw e;
+                }
+                else if (e instanceof CharacteristicMissingError) {
+                    this.logger?.warn?.(`Characteristic missing for getDevice(${id}):`, e.characteristic);
+                    throw e;
+                }
+                else {
+                    this.logger?.warn?.(`Client getDevice failed for ${id}:`, e);
+                    throw e;
+                }
+            }
+        }
+        throw new SwitchbotOperationError('No SwitchBot client available', 'no_client');
+    }
+    async getDevices() {
+        if (this.client) {
+            try {
+                const fromManager = this.getManagedDevices();
+                if (fromManager.length > 0) {
+                    return fromManager;
+                }
+                return await this.ensureDiscovered(false);
+            }
+            catch (e) {
+                this.logger?.warn?.('Client getDevices failed:', e);
+                throw e;
+            }
+        }
+        throw new SwitchbotOperationError('No SwitchBot client available', 'no_client');
+    }
+    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) {
+        if (!this.client) {
+            throw new SwitchbotOperationError('No SwitchBot client available for setDeviceState', 'no_client');
+        }
+        try {
+            const device = await this.getDevice(id);
+            if (!device) {
+                throw new SwitchbotOperationError(`Device ${id} not found`, 'device_not_found');
+            }
+            const deviceType = (device.deviceType ?? '').toLowerCase();
+            const command = body?.command;
+            if (!command) {
+                throw new SwitchbotOperationError('No command specified in body', 'no_command');
+            }
+            const handler = getDeviceCommandHandler(deviceType, command);
+            if (!handler) {
+                throw new SwitchbotOperationError(`Unsupported command '${command}' for device type '${deviceType}'`, 'unsupported_command');
+            }
+            this.logger?.debug?.(`[${id}] Calling mapped command '${command}' for device type '${deviceType}'`);
+            return await handler(device, body);
+        }
+        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);
+                throw e;
+            }
+            else if (e instanceof CharacteristicMissingError) {
+                this.logger?.warn?.(`Characteristic missing for setDeviceState(${id}):`, e.characteristic);
+                throw e;
+            }
+            else {
+                this.logger?.warn?.(`Device command failed for ${id}:`, e);
+                throw e;
+            }
+        }
+    }
+    async destroy() {
+        for (const [, pending] of this.pendingWrites) {
+            clearTimeout(pending.timer);
+            const err = new SwitchbotOperationError('Client destroyed before pending write was sent', 'client_destroyed');
+            for (const r of pending.resolvers) {
+                r.reject(err);
+            }
+        }
+        this.pendingWrites.clear();
+        if (this.client?.cleanup) {
+            await this.client.cleanup();
+        }
+        this.client = null;
+        this.lastDiscoveryAt = 0;
+    }
+    resolveScanTimeoutMs(rawNodeClientConfig) {
+        if (typeof rawNodeClientConfig.scanTimeout === 'number' && Number.isFinite(rawNodeClientConfig.scanTimeout)) {
+            return Math.max(500, rawNodeClientConfig.scanTimeout);
+        }
+        if (typeof rawNodeClientConfig.scanDuration === 'number' && Number.isFinite(rawNodeClientConfig.scanDuration)) {
+            return Math.max(500, rawNodeClientConfig.scanDuration);
+        }
+        if (typeof this.cfg?.bleScanDurationSeconds === 'number') {
+            return Math.max(500, this.cfg.bleScanDurationSeconds * 1000);
+        }
+        return 5000;
+    }
+    getManagedDevice(id) {
+        const manager = this.client?.devices;
+        if (manager?.get) {
+            return manager.get(id);
+        }
+        return undefined;
+    }
+    getManagedDevices() {
+        const manager = this.client?.devices;
+        if (manager?.list) {
+            const list = manager.list();
+            return Array.isArray(list) ? list : [];
+        }
+        return [];
+    }
+    async ensureDiscovered(force) {
+        if (!this.client) {
+            throw new SwitchbotOperationError('No SwitchBot client available', 'no_client');
+        }
+        const fromManager = this.getManagedDevices();
+        const cacheValid = this.discoveryCacheTtlMs > 0 && (Date.now() - this.lastDiscoveryAt) < this.discoveryCacheTtlMs;
+        if (!force && cacheValid && fromManager.length > 0) {
+            return fromManager;
+        }
+        const discovered = await this.client.discover();
+        this.lastDiscoveryAt = Date.now();
+        return discovered;
+    }
+}
+//# sourceMappingURL=switchbotClient.js.map

package/src/switchbotClient.js.map

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

package/src/switchbotClient.ts

@@ -13,7 +13,7 @@ export interface ISwitchBotClient {
 }
 
 /**
- * Thin wrapper around node-switchbot v4.0.0-beta.2+
+ * Thin wrapper around node-switchbot v4.0.0+
  * Leverages upstream resilience features (retry, circuit breaker, connection intelligence)
  * while maintaining plugin-specific features like write debouncing and OpenAPI fallback.
  */
@@ -21,6 +21,8 @@ export class SwitchBotClient implements ISwitchBotClient {
   private cfg: SwitchBotPluginConfig
   private client: SwitchBot | null = null
   private writeDebounceMs = 100
+  private discoveryCacheTtlMs = 30_000
+  private lastDiscoveryAt = 0
   private logger: import('homebridge').Logger
   private pendingWrites: Map<string, { timer: any, body: any, resolvers: Array<{ resolve: (v: any) => void, reject: (e: any) => void }> }> = new Map()
 
@@ -33,24 +35,34 @@ export class SwitchBotClient implements ISwitchBotClient {
     if (typeof (cfg as any)?.writeDebounceMs === 'number') {
       this.writeDebounceMs = (cfg as any).writeDebounceMs
     }
+    if (typeof (cfg as any)?.discoveryCacheTtlMs === 'number') {
+      this.discoveryCacheTtlMs = Math.max(0, (cfg as any).discoveryCacheTtlMs)
+    }
   }
 
   async init(): Promise<void> {
+    if (this.client) {
+      return
+    }
+
     try {
       // Dynamic import of node-switchbot v4 with native resilience features
       const { SwitchBot } = await import('node-switchbot')
+      const rawNodeClientConfig = typeof (this.cfg as any)?.nodeClientConfig === 'object' ? (this.cfg as any).nodeClientConfig : {}
+      const scanTimeout = this.resolveScanTimeoutMs(rawNodeClientConfig)
       this.client = new SwitchBot({
         token: this.cfg.openApiToken,
         secret: this.cfg.openApiSecret,
-        // Enable all built-in resilience features from node-switchbot v4
+        // Enable 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
+        enableConnectionIntelligence: true, // Connection tracking and route preference
         enableBLE: this.cfg.enableBLE !== false, // Use config value, default true
-        scanDuration: 5000, // BLE scan duration in milliseconds
-        ...(typeof (this.cfg as any)?.nodeClientConfig === 'object' && (this.cfg as any).nodeClientConfig),
+        scanTimeout,
+        ...rawNodeClientConfig,
       })
+      this.lastDiscoveryAt = 0
       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)
@@ -61,8 +73,19 @@ export class SwitchBotClient implements ISwitchBotClient {
   async getDevice(id: string): Promise<any> {
     if (this.client) {
       try {
-        const devices = await this.client.discover()
-        return devices.find((d: any) => d.id === id)
+        const fromManager = this.getManagedDevice(id)
+        if (fromManager) {
+          return fromManager
+        }
+
+        const devices = await this.ensureDiscovered(false)
+        const fromDiscovery = devices.find((d: any) => d.id === id)
+        if (fromDiscovery) {
+          return fromDiscovery
+        }
+
+        const refreshDevices = await this.ensureDiscovered(true)
+        return refreshDevices.find((d: any) => d.id === id)
       } catch (e: any) {
         if (e instanceof SwitchbotAuthenticationError) {
           this.logger?.error?.(`Authentication error for getDevice(${id}):`, e.message)
@@ -85,7 +108,11 @@ export class SwitchBotClient implements ISwitchBotClient {
   async getDevices(): Promise<any[]> {
     if (this.client) {
       try {
-        return await this.client.discover()
+        const fromManager = this.getManagedDevices()
+        if (fromManager.length > 0) {
+          return fromManager
+        }
+        return await this.ensureDiscovered(false)
       } catch (e) {
         this.logger?.warn?.('Client getDevices failed:', e)
         throw e
@@ -139,8 +166,7 @@ export class SwitchBotClient implements ISwitchBotClient {
       throw new SwitchbotOperationError('No SwitchBot client available for setDeviceState', 'no_client')
     }
     try {
-      const devices = await this.client.discover()
-      const device = devices.find((d: any) => d.id === id)
+      const device = await this.getDevice(id)
       if (!device) {
         throw new SwitchbotOperationError(`Device ${id} not found`, 'device_not_found')
       }
@@ -173,9 +199,68 @@ export class SwitchBotClient implements ISwitchBotClient {
   }
 
   async destroy(): Promise<void> {
+    for (const [, pending] of this.pendingWrites) {
+      clearTimeout(pending.timer)
+      const err = new SwitchbotOperationError('Client destroyed before pending write was sent', 'client_destroyed')
+      for (const r of pending.resolvers) {
+        r.reject(err)
+      }
+    }
+    this.pendingWrites.clear()
+
     if (this.client?.cleanup) {
       await this.client.cleanup()
     }
     this.client = null
+    this.lastDiscoveryAt = 0
+  }
+
+  private resolveScanTimeoutMs(rawNodeClientConfig: Record<string, any>): number {
+    if (typeof rawNodeClientConfig.scanTimeout === 'number' && Number.isFinite(rawNodeClientConfig.scanTimeout)) {
+      return Math.max(500, rawNodeClientConfig.scanTimeout)
+    }
+
+    if (typeof rawNodeClientConfig.scanDuration === 'number' && Number.isFinite(rawNodeClientConfig.scanDuration)) {
+      return Math.max(500, rawNodeClientConfig.scanDuration)
+    }
+
+    if (typeof (this.cfg as any)?.bleScanDurationSeconds === 'number') {
+      return Math.max(500, (this.cfg as any).bleScanDurationSeconds * 1000)
+    }
+
+    return 5000
+  }
+
+  private getManagedDevice(id: string): any {
+    const manager = (this.client as any)?.devices
+    if (manager?.get) {
+      return manager.get(id)
+    }
+    return undefined
+  }
+
+  private getManagedDevices(): any[] {
+    const manager = (this.client as any)?.devices
+    if (manager?.list) {
+      const list = manager.list()
+      return Array.isArray(list) ? list : []
+    }
+    return []
+  }
+
+  private async ensureDiscovered(force: boolean): Promise<any[]> {
+    if (!this.client) {
+      throw new SwitchbotOperationError('No SwitchBot client available', 'no_client')
+    }
+
+    const fromManager = this.getManagedDevices()
+    const cacheValid = this.discoveryCacheTtlMs > 0 && (Date.now() - this.lastDiscoveryAt) < this.discoveryCacheTtlMs
+    if (!force && cacheValid && fromManager.length > 0) {
+      return fromManager
+    }
+
+    const discovered = await this.client.discover()
+    this.lastDiscoveryAt = Date.now()
+    return discovered
   }
 }

package/test/client/switchbotClient.spec.ts

@@ -1,4 +1,4 @@
-import { describe, expect, it } from 'vitest'
+import { describe, expect, it, vi } from 'vitest'
 
 import { SwitchBotClient } from '../../src/switchbotClient'
 
@@ -20,4 +20,45 @@ describe('switchBotClient', () => {
     const client = new SwitchBotClient(cfg as any)
     expect((client as any).writeDebounceMs).toBe(321)
   })
+
+  it('should prefer managed devices before discovery', async () => {
+    const logger = { info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn() }
+    const client = new SwitchBotClient({ logger } as any)
+
+    const managedDevices = [{ id: 'managed-1' }]
+    const discover = vi.fn().mockResolvedValue([{ id: 'discovered-1' }])
+    ;(client as any).client = {
+      devices: {
+        list: () => managedDevices,
+        get: () => managedDevices[0],
+      },
+      discover,
+    }
+
+    const devices = await client.getDevices()
+    const device = await client.getDevice('managed-1')
+
+    expect(devices).toEqual(managedDevices)
+    expect(device).toEqual(managedDevices[0])
+    expect(discover).not.toHaveBeenCalled()
+  })
+
+  it('should discover device when manager does not have it', async () => {
+    const logger = { info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn() }
+    const client = new SwitchBotClient({ logger } as any)
+
+    const discovered = { id: 'abc123' }
+    const discover = vi.fn().mockResolvedValue([discovered])
+    ;(client as any).client = {
+      devices: {
+        list: () => [],
+        get: () => undefined,
+      },
+      discover,
+    }
+
+    const out = await client.getDevice('abc123')
+    expect(out).toEqual(discovered)
+    expect(discover).toHaveBeenCalledTimes(1)
+  })
 })

package/test/e2e/run-e2e.spec.ts

@@ -1,6 +1,7 @@
 import { execFile } from 'node:child_process'
 import path from 'node:path'
 import { promisify } from 'node:util'
+
 import { describe, it } from 'vitest'
 
 const execFileP = promisify(execFile)

package/tsconfig.ui.json

@@ -0,0 +1,11 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "declaration": false,
+    "declarationMap": false,
+    "outDir": "dist/homebridge-ui"
+  },
+  "include": [
+    "src/homebridge-ui/server.ts"
+  ]
+}