@switchbot/homebridge-switchbot 5.0.0-beta.99 → 5.0.0

package/src/platform.ts

@@ -1,963 +0,0 @@
-import type { SwitchBotPluginConfig } from './settings.js'
-import type { API, Logger, PlatformConfig } from 'homebridge'
-
-import { createDevice } from './deviceFactory.js'
-import { PLATFORM_NAME, PLUGIN_NAME } from './settings.js'
-import { SwitchBotClient } from './switchbotClient.js'
-
-// Which device types should prefer Matter if available
-// Based on HAP service mappings: device implementations use specific HomeKit services
-// that map to corresponding Matter clusters when Matter is enabled
-const DEVICE_MATTER_SUPPORTED: Record<string, boolean> = {
-  // Core devices
-  'bot': true, // Switch → OnOff
-  'curtain': true, // WindowCovering → WindowCovering
-  'fan': true, // Fan → FanControl
-  'light': true, // Lightbulb → OnOff + LevelControl
-  'lightstrip': true, // Lightbulb (color) → OnOff + LevelControl + ColorControl
-  'motion': true, // MotionSensor → OccupancySensing
-  'contact': true, // ContactSensor → BooleanState
-  'vacuum': true, // Switch → RobotVacuumCleaner
-  'lock': true, // LockMechanism → DoorLock
-  'humidifier': true, // Fan + Humidity → OnOff + FanControl + RelativeHumidityMeasurement
-  'temperature': true, // TemperatureSensor → TemperatureMeasurement
-
-  // Switch devices
-  'relay': true, // Switch → OnOff
-  'relay switch 1': true, // Switch → OnOff
-  'relay switch 1pm': true, // Switch → OnOff
-  'plug': true, // Outlet → OnOff
-  'plug mini (jp)': true, // Outlet → OnOff
-  'plug mini (us)': true, // Outlet → OnOff
-
-  // Window covering variants
-  'blindtilt': true, // WindowCovering → WindowCovering
-  'blind tilt': true, // WindowCovering → WindowCovering
-  'curtain3': true, // WindowCovering → WindowCovering
-  'rollershade': true, // WindowCovering → WindowCovering
-  'roller shade': true, // WindowCovering → WindowCovering
-  'worollershade': true, // WindowCovering → WindowCovering
-  'wo rollershade': true, // WindowCovering → WindowCovering
-
-  // Vacuum variants (normalized to 'vacuum' before lookup)
-  'wosweeper': true, // VacuumDevice → RobotVacuumCleaner
-  'wosweepermini': true, // VacuumDevice → RobotVacuumCleaner
-  'wosweeperminipro': true, // VacuumDevice → RobotVacuumCleaner
-  'k10+': true, // VacuumDevice → RobotVacuumCleaner
-  'k10+ pro': true, // VacuumDevice → RobotVacuumCleaner
-
-  // Sensors
-  'meter': true, // TemperatureSensor + HumiditySensor → TemperatureMeasurement + RelativeHumidityMeasurement
-  'meterplus': true, // TemperatureSensor + HumiditySensor → TemperatureMeasurement + RelativeHumidityMeasurement
-  'meter plus (jp)': true, // TemperatureSensor + HumiditySensor → TemperatureMeasurement + RelativeHumidityMeasurement
-  'meterpro': true, // TemperatureSensor + HumiditySensor → TemperatureMeasurement + RelativeHumidityMeasurement
-  'meterpro(co2)': true, // TemperatureSensor + HumiditySensor → TemperatureMeasurement + RelativeHumidityMeasurement
-  'waterdetector': true, // LeakSensor → BooleanState
-  'water detector': true, // LeakSensor → BooleanState
-
-  // Other devices
-  'smart fan': true, // Fan → FanControl
-  'strip light': true, // Lightbulb (color) → OnOff + LevelControl + ColorControl
-  'hub 2': false, // Hub device - not exposed as accessory
-  'walletfinder': false, // Button device - Matter support TBD
-}
-
-// Default Matter cluster configurations by device type
-// Maps device types to their Matter cluster states (used when device doesn't provide clusters)
-// Note: wosweeper/curtain/plug variants are normalized before cluster lookup (see loadDevices)
-const DEVICE_MATTER_CLUSTERS: Record<string, any> = {
-  // Core devices - aligned with HAP service implementations
-  bot: { onOff: { onOff: false } }, // Switch → OnOff
-  vacuum: {
-    rvcRunMode: {
-      supportedModes: [
-        { label: 'Idle', mode: 0, modeTags: [{ value: 16384 }] },
-        { label: 'Cleaning', mode: 1, modeTags: [{ value: 16385 }] },
-      ],
-      currentMode: 0,
-    },
-    rvcCleanMode: {
-      supportedModes: [
-        { label: 'Vacuum', mode: 0, modeTags: [{ value: 16385 }] },
-      ],
-      currentMode: 0,
-    },
-    rvcOperationalState: {
-      operationalStateList: [
-        { operationalStateId: 0 }, // Stopped
-        { operationalStateId: 1 }, // Running
-        { operationalStateId: 2 }, // Paused
-        { operationalStateId: 3 }, // Error (required)
-        { operationalStateId: 64 }, // Seeking charger
-        { operationalStateId: 65 }, // Charging
-        { operationalStateId: 66 }, // Docked
-      ],
-      operationalState: 66,
-    },
-  }, // Switch in HAP, RobotVacuumCleaner in Matter
-  curtain: {
-    windowCovering: {
-      currentPositionLiftPercent100ths: 0,
-      targetPositionLiftPercent100ths: 0,
-      operationalStatus: 0,
-    },
-  }, // WindowCovering → WindowCovering (includes curtain3, rollershade variants via normalization)
-  blindtilt: {
-    windowCovering: {
-      currentPositionLiftPercent100ths: 0,
-      targetPositionLiftPercent100ths: 0,
-      currentPositionTiltPercent100ths: 0,
-      targetPositionTiltPercent100ths: 0,
-      operationalStatus: 0,
-    },
-  }, // WindowCovering with tilt → WindowCovering
-  fan: {
-    onOff: { onOff: false },
-    fanControl: {
-      fanMode: 0,
-      percentCurrent: 0,
-      percentSetting: 0,
-      speedCurrent: 0,
-      speedMax: 100,
-    },
-  }, // Fan → OnOff + FanControl
-  light: {
-    onOff: { onOff: false },
-    levelControl: {
-      currentLevel: 0,
-      minLevel: 0,
-      maxLevel: 254,
-    },
-  }, // Lightbulb → OnOff + LevelControl
-  lightstrip: {
-    onOff: { onOff: false },
-    levelControl: {
-      currentLevel: 0,
-      minLevel: 0,
-      maxLevel: 254,
-    },
-    colorControl: {
-      currentHue: 0,
-      currentSaturation: 0,
-      colorTemperatureMireds: 400,
-      colorMode: 0,
-    },
-  }, // Lightbulb with color → OnOff + LevelControl + ColorControl
-  lock: {
-    doorLock: {
-      lockState: 0,
-      lockType: 0,
-      actuatorEnabled: true,
-      operatingMode: 0,
-    },
-  }, // LockMechanism → DoorLock
-  motion: {
-    occupancySensing: {
-      occupancy: 0,
-      occupancySensorType: 0,
-    },
-  }, // MotionSensor → OccupancySensing
-  contact: {
-    booleanState: {
-      stateValue: false,
-    },
-  }, // ContactSensor → BooleanState
-  humidifier: {
-    onOff: { onOff: false },
-    fanControl: {
-      fanMode: 0,
-      percentCurrent: 0,
-    },
-    relativeHumidityMeasurement: {
-      measuredValue: 0,
-      minMeasuredValue: 0,
-      maxMeasuredValue: 100,
-    },
-  }, // HumidifierDehumidifier → OnOff + FanControl + RelativeHumidityMeasurement
-  temperature: {
-    temperatureMeasurement: {
-      measuredValue: 0,
-      minMeasuredValue: -27315,
-      maxMeasuredValue: 32767,
-    },
-  }, // TemperatureSensor → TemperatureMeasurement
-
-  // Switch/Outlet devices
-  relay: { onOff: { onOff: false } }, // Switch → OnOff
-  plug: {
-    onOff: { onOff: false },
-    electricalMeasurement: {
-      activePower: 0,
-      rmsCurrent: 0,
-      rmsVoltage: 0,
-    },
-  }, // Outlet → OnOff + ElectricalMeasurement (for PM models)
-
-  // Sensors
-  meter: {
-    temperatureMeasurement: {
-      measuredValue: 0,
-      minMeasuredValue: -27315,
-      maxMeasuredValue: 32767,
-    },
-    relativeHumidityMeasurement: {
-      measuredValue: 0,
-      minMeasuredValue: 0,
-      maxMeasuredValue: 100,
-    },
-  }, // TemperatureSensor + HumiditySensor → TemperatureMeasurement + RelativeHumidityMeasurement
-  waterdetector: {
-    booleanState: {
-      stateValue: false,
-    },
-  }, // LeakSensor → BooleanState
-}
-
-const DEVICE_MATTER_DEVICE_TYPE_KEYS: Record<string, string> = {
-  bot: 'OnOffSwitch',
-  vacuum: 'RoboticVacuumCleaner',
-  curtain: 'WindowCovering',
-  blindtilt: 'WindowCovering',
-  fan: 'Fan',
-  light: 'DimmableLight',
-  lightstrip: 'ExtendedColorLight',
-  lock: 'DoorLock',
-  motion: 'MotionSensor',
-  contact: 'ContactSensor',
-  humidifier: 'Fan',
-  temperature: 'TemperatureSensor',
-  relay: 'OnOffSwitch',
-  plug: 'OnOffOutlet',
-  meter: 'TemperatureSensor',
-  waterdetector: 'LeakSensor',
-}
-
-// Default Matter cluster handlers by device type
-// Provides handler stubs for devices with interactive clusters
-const DEVICE_MATTER_HANDLERS: Record<string, any> = {
-  vacuum: {
-    rvcRunMode: {
-      // Handle changing vacuum run mode (Idle, Cleaning, Mapping)
-      changeToMode: async (request: any) => {
-        const modeNames = ['Idle', 'Cleaning', 'Mapping']
-        const modeName = modeNames[request?.newMode] || `Unknown (${request?.newMode})`
-        console.log('[SwitchBot] RVC run mode change requested:', modeName)
-        // TODO: Send API command to SwitchBot device to change run mode
-        // await this.client.setDeviceState(deviceId, { command: 'setMode', parameter: modeName })
-      },
-    },
-    rvcCleanMode: {
-      // Handle changing vacuum clean mode (Vacuum, Mop, etc.)
-      changeToMode: async (request: any) => {
-        const modeName = request?.newMode !== undefined ? `Mode ${request.newMode}` : 'Unknown'
-        console.log('[SwitchBot] RVC clean mode change requested:', modeName)
-        // TODO: Send API command to SwitchBot device to change clean mode
-      },
-    },
-    rvcOperationalState: {
-      // Handle pause command
-      pause: async () => {
-        console.log('[SwitchBot] RVC pause command received')
-        // TODO: Send pause command to SwitchBot device
-      },
-      // Handle resume command
-      resume: async () => {
-        console.log('[SwitchBot] RVC resume command received')
-        // TODO: Send resume command to SwitchBot device
-      },
-      // Handle return to dock command
-      goHome: async () => {
-        console.log('[SwitchBot] RVC goHome command received')
-        // TODO: Send return-to-dock command to SwitchBot device
-      },
-    },
-  },
-  bot: {
-    onOff: {
-      // Handle on/off switch commands
-      on: async () => {
-        console.log('[SwitchBot] Bot ON command received')
-        // TODO: Send ON command to SwitchBot device
-      },
-      off: async () => {
-        console.log('[SwitchBot] Bot OFF command received')
-        // TODO: Send OFF command to SwitchBot device
-      },
-    },
-  },
-  curtain: {
-    windowCovering: {
-      // Handle curtain position changes
-      goToLiftPercentage: async (request: any) => {
-        console.log('[SwitchBot] Curtain position change requested:', request?.liftPercent100thsValue)
-        // TODO: Send position command to SwitchBot device
-      },
-      upOrOpen: async () => {
-        console.log('[SwitchBot] Curtain open command received')
-        // TODO: Send open command to SwitchBot device
-      },
-      downOrClose: async () => {
-        console.log('[SwitchBot] Curtain close command received')
-        // TODO: Send close command to SwitchBot device
-      },
-      stopMotion: async () => {
-        console.log('[SwitchBot] Curtain stop command received')
-        // TODO: Send stop command to SwitchBot device
-      },
-    },
-  },
-  plug: {
-    onOff: {
-      on: async () => {
-        console.log('[SwitchBot] Plug ON command received')
-      },
-      off: async () => {
-        console.log('[SwitchBot] Plug OFF command received')
-      },
-    },
-  },
-  lock: {
-    doorLock: {
-      setLockState: async (request: any) => {
-        const state = request?.lockState === 1 ? 'LOCKED' : 'UNLOCKED'
-        console.log('[SwitchBot] Lock state change requested:', state)
-      },
-    },
-  },
-}
-
-function resolveMatterDeviceType(matterApi: any, type: string, createdDeviceType?: any, clusters?: any): any {
-  if (createdDeviceType && typeof createdDeviceType === 'object' && typeof createdDeviceType.with === 'function') {
-    return createdDeviceType
-  }
-
-  const lowerType = (typeof createdDeviceType === 'string' && createdDeviceType) ? createdDeviceType.toLowerCase() : (type || '').toLowerCase()
-
-  // Cluster-based upgrade for color lights if descriptor omitted device type.
-  const hasColorControl = !!clusters?.colorControl
-  const inferredType = hasColorControl && lowerType === 'light'
-    ? 'lightstrip'
-    : lowerType
-
-  const mappedKey = DEVICE_MATTER_DEVICE_TYPE_KEYS[inferredType] || 'OnOffSwitch'
-  return matterApi?.deviceTypes?.[mappedKey] || matterApi?.deviceTypes?.OnOffSwitch
-}
-
-export class SwitchBotHAPPlatform {
-  api: API | undefined
-  log: Logger
-  config: SwitchBotPluginConfig
-  devices: any[] = []
-  // cached accessories restored by Homebridge
-  accessories: Map<string, any>
-  // Track last loaded config to detect changes
-  private lastConfigHash: string = ''
-  private configReloadInterval: NodeJS.Timeout | null = null
-
-  constructor(log: Logger, config: PlatformConfig, api?: API) {
-    this.log = log
-    this.config = (config as any) ?? {}
-    this.api = api
-    this.accessories = new Map()
-    this.log.info('SwitchBot HAP platform initialized')
-
-    // Create/shared SwitchBot client and attach to config so child devices reuse it.
-    try {
-      const client = new SwitchBotClient(this.config)
-      void client.init()
-      ;(this.config as any)._client = client
-    } catch (e) {
-      this.log.debug('Failed to create shared SwitchBot client', e)
-    }
-
-    // Create/shared SwitchBot client and attach to config so child devices reuse it.
-    try {
-      const client = new SwitchBotClient(this.config)
-      void client.init()
-      ;(this.config as any)._client = client
-    } catch (e) {
-      this.log.debug('Failed to create shared SwitchBot client', e)
-    }
-
-    // Wait for Homebridge to finish launching to create/register accessories
-    if (this.api && typeof (this.api as any).on === 'function') {
-      ;(this.api as any).on('didFinishLaunching', () => {
-        void this.loadDevices()
-        // Start periodic config reload to pick up UI changes
-        this.configReloadInterval = setInterval(() => {
-          void this.checkAndReloadDevices()
-        }, 10000) // Check every 10 seconds
-      })
-    } else {
-      void this.loadDevices()
-      // Start periodic config reload to pick up UI changes
-      this.configReloadInterval = setInterval(() => {
-        void this.checkAndReloadDevices()
-      }, 10000) // Check every 10 seconds
-    }
-  }
-
-  private getConfigHash(): string {
-    // Create a simple hash of current device config to detect changes
-    const devices = (this.config as any)?.devices ?? []
-    return JSON.stringify(devices.map((d: any) => ({
-      id: d.deviceId ?? d.id,
-      type: d.configDeviceType ?? d.type,
-      name: d.configDeviceName ?? d.name,
-    })))
-  }
-
-  private async checkAndReloadDevices() {
-    const currentHash = this.getConfigHash()
-    if (currentHash !== this.lastConfigHash) {
-      this.log.info('[SwitchBot] Detected config changes, reloading devices...')
-      // Clear existing devices
-      this.devices = []
-      await this.loadDevices()
-    }
-  }
-
-  async loadDevices() {
-    const devices = (this.config as any)?.devices ?? []
-    for (const raw of devices) {
-      // Normalize config keys from UI schema to internal shape
-      const d: any = {
-        id: raw.deviceId ?? raw.id,
-        name: raw.configDeviceName ?? raw.name,
-        type: raw.configDeviceType ?? raw.type ?? raw.deviceType ?? 'unknown',
-        _raw: raw,
-      }
-
-      let type: string = d.type
-      // Normalize device type variants for consistent Matter cluster lookup
-      // Vacuum variants
-      if (['wosweeper', 'wosweepermini', 'wosweeperminipro', 'k10+', 'k10+ pro'].includes((type || '').toLowerCase())) {
-        type = 'vacuum'
-      }
-      // Window covering variants
-      if (['blindtilt', 'blind tilt', 'curtain3', 'rollershade', 'roller shade', 'worollershade', 'wo rollershade'].includes((type || '').toLowerCase())) {
-        type = 'curtain'
-      }
-      // Plug variants
-      if (['plug mini (jp)', 'plug mini (us)'].includes((type || '').toLowerCase())) {
-        type = 'plug'
-      }
-      // Meter variants
-      if (['meterplus', 'meter plus (jp)', 'meterpro', 'meterpro(co2)'].includes((type || '').toLowerCase())) {
-        type = 'meter'
-      }
-      // Relay switch variants
-      if (['relay switch 1', 'relay switch 1pm'].includes((type || '').toLowerCase())) {
-        type = 'relay'
-      }
-      // Water detector variants
-      if (['water detector'].includes((type || '').toLowerCase())) {
-        type = 'waterdetector'
-      }
-      // Fan variants
-      if (['smart fan'].includes((type || '').toLowerCase())) {
-        type = 'fan'
-      }
-      // Light variants
-      if (['strip light'].includes((type || '').toLowerCase())) {
-        type = 'lightstrip'
-      }
-
-      const matterSupported = !!DEVICE_MATTER_SUPPORTED[(type || '').toLowerCase()]
-      // Auto-detect Matter from Homebridge API, allow manual override via config
-      const matterAvailable = !!(this.api?.isMatterAvailable?.() && this.api?.isMatterEnabled?.())
-      const matterEnabled = matterAvailable || !!this.config.enableMatter
-      const useMatter = !!(matterEnabled && matterSupported && (!!this.config.preferMatter || matterAvailable))
-
-      try {
-        const created = await createDevice({ id: d.id, type, name: d.name }, this.config, useMatter)
-        this.devices.push(created)
-        // Prefer Matter: try registering to the Matter child bridge first.
-        let matterRegistered = false
-        if (useMatter) {
-          this.log.info(`Attempting Matter registration for ${d.id} (${type})`)
-          // If Homebridge Matter APIs are available, register the accessory
-          try {
-            const matterApi = (this.api as any)?.matter
-            if (this.api?.isMatterAvailable?.() && this.api?.isMatterEnabled?.() && matterApi && typeof matterApi.registerPlatformAccessories === 'function') {
-              const createdDesc = created.createAccessory?.(this.api) || { id: d.id, name: d.name || type }
-              const uuid = matterApi.uuid.generate(`${d.id}`)
-              const defaultClusters = DEVICE_MATTER_CLUSTERS[type.toLowerCase()] || { onOff: { onOff: false } }
-              const clusters = createdDesc.clusters || defaultClusters
-              const deviceType = resolveMatterDeviceType(matterApi, type, createdDesc.deviceType, clusters)
-              const accessory: any = {
-                UUID: uuid,
-                displayName: createdDesc.name || d.name || type,
-                deviceType,
-                manufacturer: createdDesc.manufacturer || 'SwitchBot',
-                model: createdDesc.model || type,
-                serialNumber: createdDesc.serialNumber || d.id,
-                reachable: createdDesc.reachable !== false,
-                firmwareRevision: createdDesc.firmwareRevision || '1.0.0',
-                hardwareRevision: createdDesc.hardwareRevision || '',
-                clusters,
-                context: { deviceId: d.id, type, _created: true },
-              }
-              try {
-                await matterApi.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [accessory])
-                this.accessories.set(uuid, accessory)
-                matterRegistered = true
-                this.log.info(`Registered Matter accessory ${d.id} (${type}) with uuid=${uuid}`)
-              } catch (e) {
-                this.log.warn('Failed to register Matter accessory with Homebridge matter API', e)
-              }
-            } else {
-              this.log.info('Homebridge Matter API not available or not enabled; will fallback to HAP')
-            }
-          } catch (e) {
-            this.log.warn('Matter registration attempt failed', e)
-          }
-        }
-
-        // If Matter wasn't registered (either not supported, API missing, or registration failed), fall back to HAP registration.
-        if (!matterRegistered && this.api && (this.api as any).hap) {
-          // Basic HAP accessory creation using homebridge API when available
-          try {
-            const hap = (this.api as any).hap
-            const uuid = hap.uuid.generate(`${d.id}`)
-            // Reuse cached accessory if available by uuid
-            let accessory: any = this.accessories.get(uuid)
-            // If not found by uuid, attempt to find by stored deviceId in accessory.context
-            if (!accessory) {
-              for (const [, a] of Array.from(this.accessories.entries())) {
-                try {
-                  if (a && a.context && a.context.deviceId === d.id) {
-                    accessory = a
-                    break
-                  }
-                } catch (e) {
-                  // ignore
-                }
-              }
-            }
-
-            if (!accessory) {
-              accessory = new (this.api as any).platformAccessory(d.name || type, uuid)
-              // Store device metadata on accessory.context for persistence across restarts
-              try {
-                accessory.context = accessory.context || {}
-                accessory.context.deviceId = d.id
-                accessory.context.type = type
-              } catch (e) {
-                // ignore context failures
-              }
-              // Register new accessory with Homebridge so it's cached
-              try {
-                ;(this.api as any).registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [accessory])
-              } catch (e) {
-                // older API variations may require different registration; ignore if unavailable
-              }
-              this.accessories.set(uuid, accessory)
-            } else {
-              // ensure context includes deviceId (in case restored accessory lacked it)
-              try {
-                accessory.context = accessory.context || {}
-                accessory.context.deviceId = accessory.context.deviceId || d.id
-                accessory.context.type = accessory.context.type || type
-              } catch (e) {
-                // ignore
-              }
-            }
-            // Add basic service descriptor from device
-            const accDesc = created.createAccessory?.(this.api)
-            if (accDesc && accDesc.services) {
-              for (const s of accDesc.services) {
-                const Service = hap.Service[s.type] || hap.Service[s.type]
-                if (!Service) {
-                  continue
-                }
-                const service = accessory.getService(Service) || accessory.addService(Service)
-                for (const [charName, getterSetterRaw] of Object.entries(s.characteristics || {})) {
-                  const getterSetter: any = getterSetterRaw
-                  const Characteristic = (hap.Characteristic as any)[charName]
-                  if (!Characteristic) {
-                    continue
-                  }
-                  // Apply characteristic props if provided (min/max/step)
-                  if (getterSetter && getterSetter.props) {
-                    try {
-                      service.getCharacteristic(Characteristic).setProps(getterSetter.props)
-                    } catch (e) {
-                      // ignore setProps failures on older HAP implementations
-                    }
-                  }
-
-                  // Wire simple get/set handlers if provided
-                  if (getterSetter && typeof getterSetter.get === 'function') {
-                    service.getCharacteristic(Characteristic).onGet(getterSetter.get)
-                  }
-                  if (getterSetter && typeof getterSetter.set === 'function') {
-                    service.getCharacteristic(Characteristic).onSet(getterSetter.set)
-                  }
-                }
-              }
-            }
-            this.log.info(`Created/updated HAP accessory ${d.id} (${type})`)
-          } catch (e) {
-            this.log.warn('HAP accessory creation failed', e)
-          }
-        } else if (!matterRegistered) {
-          this.log.info(`Created HAP descriptor for ${d.id} (${type}) (API not available to register)`)
-        }
-      } catch (e) {
-        this.log.error(`Failed to create device ${d.id}:`, e as any)
-      }
-    }
-    // Update hash after successfully loading devices
-    this.lastConfigHash = this.getConfigHash()
-  }
-
-  // Example lifecycle method called by Homebridge
-  async configureAccessory(accessory: any) {
-    // Homebridge calls this for restored cached accessories — keep a reference.
-    try {
-      const uuid = accessory.UUID || accessory.UUID
-      this.accessories.set(uuid, accessory)
-      this.log.info(`Restored cached accessory ${accessory.displayName || uuid}`)
-    } catch (e) {
-      this.log.warn('configureAccessory failed to restore accessory', e)
-    }
-  }
-
-  // Called by Homebridge when a cached Matter accessory is restored
-  configureMatterAccessory?(accessory: any) {
-    try {
-      const uuid = accessory.uuid || accessory.UUID || accessory.uuid
-      this.accessories.set(uuid, accessory)
-      this.log.info(`Restored cached Matter accessory ${accessory.displayName || uuid}`)
-    } catch (e) {
-      this.log.warn('configureMatterAccessory failed to restore accessory', e)
-    }
-  }
-}
-
-// Matter platform implementation (placeholder)
-export class SwitchBotMatterPlatform {
-  api: API | undefined
-  log: Logger
-  config: SwitchBotPluginConfig
-  devices: any[] = []
-  accessories: Map<string, any>
-  // Track last loaded config to detect changes
-  private lastConfigHash: string = ''
-  private configReloadInterval: NodeJS.Timeout | null = null
-
-  constructor(log: Logger, config: PlatformConfig, api?: API) {
-    this.log = log
-    this.config = (config as any) ?? {}
-    this.api = api
-    this.accessories = new Map()
-    this.log.info('SwitchBot Matter platform initialized')
-
-    if (this.api && typeof (this.api as any).on === 'function') {
-      ;(this.api as any).on('didFinishLaunching', () => {
-        ;(async () => {
-          // After launch, perform discovery (if any) and register Matter accessories
-          try {
-            await this.loadDevices()
-            if ((this.api as any).isMatterAvailable?.() && (this.api as any).isMatterEnabled?.() && (this.api as any).matter && typeof (this.api as any).matter.registerPlatformAccessories === 'function') {
-              try {
-                await (this as any).registerMatterAccessories?.()
-              } catch (e) {
-                this.log.warn('registerMatterAccessories failed', e)
-              }
-            }
-          } catch (e) {
-            this.log.warn('Error during Matter platform startup', e)
-          }
-        })()
-        // Start periodic config reload to pick up UI changes
-        this.configReloadInterval = setInterval(() => {
-          void this.checkAndReloadDevices()
-        }, 10000) // Check every 10 seconds
-      })
-    } else {
-      void this.loadDevices()
-      // Start periodic config reload to pick up UI changes
-      this.configReloadInterval = setInterval(() => {
-        void this.checkAndReloadDevices()
-      }, 10000) // Check every 10 seconds
-    }
-    // Create/shared SwitchBot client and attach to config so child devices reuse it.
-    try {
-      const client = new SwitchBotClient(this.config)
-      void client.init()
-      ;(this.config as any)._client = client
-    } catch (e) {
-      this.log.debug('Failed to create shared SwitchBot client', e)
-    }
-  }
-
-  async loadDevices() {
-    const devices = (this.config as any)?.devices ?? []
-    for (const raw of devices) {
-      // Normalize config keys produced by the UI schema
-      const d: any = {
-        id: raw.deviceId ?? raw.id,
-        name: raw.configDeviceName ?? raw.name,
-        type: raw.configDeviceType ?? raw.type ?? raw.deviceType ?? 'unknown',
-        _raw: raw,
-      }
-
-      let type: string = d.type
-      // Normalize device type variants for consistent Matter cluster lookup
-      // Vacuum variants
-      if (['wosweeper', 'wosweepermini', 'wosweeperminipro', 'k10+', 'k10+ pro'].includes((type || '').toLowerCase())) {
-        type = 'vacuum'
-      }
-      // Window covering variants
-      if (['blindtilt', 'blind tilt', 'curtain3', 'rollershade', 'roller shade', 'worollershade', 'wo rollershade'].includes((type || '').toLowerCase())) {
-        type = 'curtain'
-      }
-      // Plug variants
-      if (['plug mini (jp)', 'plug mini (us)'].includes((type || '').toLowerCase())) {
-        type = 'plug'
-      }
-      // Meter variants
-      if (['meterplus', 'meter plus (jp)', 'meterpro', 'meterpro(co2)'].includes((type || '').toLowerCase())) {
-        type = 'meter'
-      }
-      // Relay switch variants
-      if (['relay switch 1', 'relay switch 1pm'].includes((type || '').toLowerCase())) {
-        type = 'relay'
-      }
-      // Water detector variants
-      if (['water detector'].includes((type || '').toLowerCase())) {
-        type = 'waterdetector'
-      }
-      // Fan variants
-      if (['smart fan'].includes((type || '').toLowerCase())) {
-        type = 'fan'
-      }
-      // Light variants
-      if (['strip light'].includes((type || '').toLowerCase())) {
-        type = 'lightstrip'
-      }
-
-      const matterSupported = !!DEVICE_MATTER_SUPPORTED[(type || '').toLowerCase()]
-      // Auto-detect Matter from Homebridge API, allow manual override via config
-      const matterAvailable = this.api?.isMatterAvailable?.() && this.api?.isMatterEnabled?.()
-      const matterEnabled = matterAvailable || !!this.config.enableMatter
-      const useMatter = matterEnabled && matterSupported
-      try {
-        const created = await createDevice({ id: d.id, type, name: d.name }, this.config, useMatter)
-        this.devices.push(created)
-        if (useMatter) {
-          this.log.info(`Prepared Matter accessory for ${d.id} (${type})${matterAvailable ? ' (auto-detected)' : ' (manually enabled)'}`)
-        } else {
-          if (!matterEnabled) {
-            this.log.info(`Skipping Matter for ${d.id} (${type}) - Matter not available on this bridge`)
-          } else if (!matterSupported) {
-            this.log.info(`Skipping Matter for ${d.id} (${type}) - device type not supported`)
-          } else {
-            this.log.info(`Skipping Matter for ${d.id} (${type}) - not supported`)
-          }
-        }
-      } catch (e) {
-        this.log.error(`Failed to create Matter device ${d.id}:`, e as any)
-      }
-    }
-    // Update hash after successfully loading devices
-    this.lastConfigHash = this.getConfigHash()
-  }
-
-  private getConfigHash(): string {
-    // Create a simple hash of current device config to detect changes
-    const devices = (this.config as any)?.devices ?? []
-    return JSON.stringify(devices.map((d: any) => ({
-      id: d.deviceId ?? d.id,
-      type: d.configDeviceType ?? d.type,
-      name: d.configDeviceName ?? d.name,
-    })))
-  }
-
-  private async checkAndReloadDevices() {
-    const currentHash = this.getConfigHash()
-    if (currentHash !== this.lastConfigHash) {
-      this.log.info('[SwitchBot] Detected config changes, reloading devices...')
-      // Clear existing devices
-      this.devices = []
-      await this.loadDevices()
-    }
-  }
-
-  async configureAccessory(accessory: any) {
-    try {
-      const uuid = accessory.UUID || accessory.UUID
-      this.accessories.set(uuid, accessory)
-      this.log.info(`Restored cached Matter accessory ${accessory.displayName || uuid}`)
-    } catch (e) {
-      this.log.warn('configureAccessory failed to restore Matter accessory', e)
-    }
-  }
-
-  // Homebridge calls this when restoring cached Matter accessories
-  configureMatterAccessory(accessory: any) {
-    try {
-      const uuid = accessory.uuid || accessory.UUID || accessory.uuid
-      this.accessories.set(uuid, accessory)
-      this.log.info(`Restored cached Matter accessory ${accessory.displayName || uuid}`)
-    } catch (e) {
-      this.log.warn('configureMatterAccessory failed to restore Matter accessory', e)
-    }
-  }
-
-  // Register serialized Matter accessories via Homebridge Matter API
-  async registerMatterAccessories() {
-    if (!this.api) {
-      return
-    }
-    const matterApi = (this.api as any).matter
-    if (!matterApi || typeof matterApi.registerPlatformAccessories !== 'function') {
-      this.log.info('Homebridge Matter API not available; skipping Matter accessory registration')
-      return
-    }
-
-    const devices = (this.config as any)?.devices ?? []
-    const accessoriesToRegister: any[] = []
-
-    // Auto-detect Matter from Homebridge API
-    const matterAvailable = this.api?.isMatterAvailable?.() && this.api?.isMatterEnabled?.()
-    const matterEnabled = matterAvailable || !!this.config.enableMatter
-
-    for (const raw of devices) {
-      const d: any = {
-        id: raw.deviceId ?? raw.id,
-        name: raw.configDeviceName ?? raw.name,
-        type: raw.configDeviceType ?? raw.type ?? raw.deviceType ?? 'unknown',
-      }
-
-      if (!d.id) {
-        continue
-      }
-
-      let type: string = d.type
-      // Normalize device type variants for consistent Matter cluster lookup
-      // Vacuum variants
-      if (['wosweeper', 'wosweepermini', 'wosweeperminipro', 'k10+', 'k10+ pro'].includes((type || '').toLowerCase())) {
-        type = 'vacuum'
-      }
-      // Window covering variants
-      if (['blindtilt', 'blind tilt', 'curtain3', 'rollershade', 'roller shade', 'worollershade', 'wo rollershade'].includes((type || '').toLowerCase())) {
-        type = 'curtain'
-      }
-      // Plug variants
-      if (['plug mini (jp)', 'plug mini (us)'].includes((type || '').toLowerCase())) {
-        type = 'plug'
-      }
-      // Meter variants
-      if (['meterplus', 'meter plus (jp)', 'meterpro', 'meterpro(co2)'].includes((type || '').toLowerCase())) {
-        type = 'meter'
-      }
-      // Relay switch variants
-      if (['relay switch 1', 'relay switch 1pm'].includes((type || '').toLowerCase())) {
-        type = 'relay'
-      }
-      // Water detector variants
-      if (['water detector'].includes((type || '').toLowerCase())) {
-        type = 'waterdetector'
-      }
-      // Fan variants
-      if (['smart fan'].includes((type || '').toLowerCase())) {
-        type = 'fan'
-      }
-      // Light variants
-      if (['strip light'].includes((type || '').toLowerCase())) {
-        type = 'lightstrip'
-      }
-
-      const matterSupported = !!DEVICE_MATTER_SUPPORTED[(type || '').toLowerCase()]
-      const useMatter = matterEnabled && matterSupported
-      if (!useMatter) {
-        continue
-      }
-
-      try {
-        const created = await createDevice({ id: d.id, type, name: d.name }, this.config, true)
-        const createdDesc = created.createAccessory?.(this.api) || { id: d.id, name: d.name || type }
-        const uuid = matterApi.uuid.generate(`${d.id}`)
-        // Try to find existing restored accessory by deviceId
-        let existing: any | undefined
-        for (const [, a] of Array.from(this.accessories.entries())) {
-          try {
-            if (a && a.context && a.context.deviceId === d.id) {
-              existing = a
-              break
-            }
-          } catch (e) {
-            // ignore
-          }
-        }
-
-        if (existing) {
-          // Ensure context and displayName are up to date
-          // Prioritize device-specific Matter clusters (e.g., RVC for vacuum) over generic HAP-derived clusters
-          let clusters = DEVICE_MATTER_CLUSTERS[type.toLowerCase()]
-          if (!clusters) {
-            clusters = existing.clusters || createdDesc.clusters || { onOff: { onOff: false } }
-          }
-          const deviceType = resolveMatterDeviceType(matterApi, type, existing.deviceType || createdDesc.deviceType, clusters)
-          existing.context = existing.context || {}
-          existing.context.deviceId = existing.context.deviceId || d.id
-          existing.context.type = existing.context.type || type
-          existing.deviceType = deviceType
-          existing.manufacturer = existing.manufacturer || createdDesc.manufacturer || 'SwitchBot'
-          existing.model = existing.model || createdDesc.model || type
-          existing.serialNumber = existing.serialNumber || createdDesc.serialNumber || d.id
-          existing.reachable = existing.reachable !== false
-          existing.firmwareRevision = existing.firmwareRevision || createdDesc.firmwareRevision || '1.0.0'
-          existing.hardwareRevision = existing.hardwareRevision || createdDesc.hardwareRevision || ''
-          existing.clusters = clusters
-          existing.handlers = createdDesc.handlers || DEVICE_MATTER_HANDLERS[type.toLowerCase()] || undefined
-          existing.displayName = createdDesc.name || d.name || type
-          existing.UUID = existing.UUID || existing.uuid || uuid
-          accessoriesToRegister.push(existing)
-          this.accessories.set(existing.UUID || uuid, existing)
-        } else {
-          // Prioritize device-specific Matter clusters (e.g., RVC for vacuum) over generic HAP-derived clusters
-          let clusters = DEVICE_MATTER_CLUSTERS[type.toLowerCase()]
-          if (!clusters) {
-            clusters = createdDesc.clusters || { onOff: { onOff: false } }
-          }
-          const deviceType = resolveMatterDeviceType(matterApi, type, createdDesc.deviceType, clusters)
-          const serialized: any = {
-            UUID: uuid,
-            displayName: createdDesc.name || d.name || type,
-            deviceType,
-            manufacturer: createdDesc.manufacturer || 'SwitchBot',
-            model: createdDesc.model || type,
-            serialNumber: createdDesc.serialNumber || d.id,
-            reachable: createdDesc.reachable !== false,
-            firmwareRevision: createdDesc.firmwareRevision || '1.0.0',
-            hardwareRevision: createdDesc.hardwareRevision || '',
-            clusters,
-            handlers: createdDesc.handlers || DEVICE_MATTER_HANDLERS[type.toLowerCase()] || undefined,
-            context: { deviceId: d.id, type, created: true },
-          }
-          accessoriesToRegister.push(serialized)
-          this.accessories.set(uuid, serialized)
-        }
-      } catch (e) {
-        this.log.warn(`Failed to prepare Matter accessory for ${d.id} (${type})`, e)
-      }
-    }
-
-    if (accessoriesToRegister.length > 0) {
-      try {
-        await matterApi.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, accessoriesToRegister)
-        this.log.info(`Registered ${accessoriesToRegister.length} Matter accessory(ies) with Homebridge`)
-      } catch (e) {
-        this.log.warn('Failed to register Matter accessories', e)
-      }
-    } else {
-      this.log.info('No Matter accessories to register')
-    }
-  }
-}
-
-export default SwitchBotHAPPlatform