@switchbot/homebridge-switchbot 5.0.0-beta.70 → 5.0.0-beta.72

package/src/devices-hap/device.ts

@@ -1,890 +0,0 @@
-/* Copyright(C) 2021-2024, donavanbecker (https://github.com/donavanbecker). All rights reserved.
- *
- * device.ts: @switchbot/homebridge-switchbot.
- */
-
-import type { API, CharacteristicValue, HAP, Logging, PlatformAccessory, Service } from 'homebridge'
-import type { MqttClient } from 'mqtt'
-import type { ad, bodyChange, device, deviceStatus, deviceStatusRequest, pushResponse, SwitchBotBLE } from 'node-switchbot'
-
-import type { SwitchBotHAPPlatform } from '../platform-hap.js'
-import type { blindTiltConfig, botConfig, ceilingLightConfig, colorBulbConfig, contactConfig, curtainConfig, devicesConfig, hubConfig, humidifierConfig, indoorOutdoorSensorConfig, lockConfig, meterConfig, motionConfig, plugConfig, relaySwitch1Config, relaySwitch1PMConfig, stripLightConfig, SwitchBotPlatformConfig, waterDetectorConfig } from '../settings.js'
-
-import { hostname } from 'node:os'
-
-import { SwitchBotBLEModel, SwitchBotBLEModelFriendlyName, SwitchBotBLEModelName, SwitchBotModel } from 'node-switchbot'
-
-import { deviceLoggingEnabled, deviceLoggingIsDebug, formatDeviceIdAsMac, isSuccessfulStatusCode, logDeviceStatusCode, safeStringify, sleep } from '../utils.js'
-
-export abstract class deviceBase {
-  public readonly api: API
-  public readonly log: Logging
-  public readonly config!: SwitchBotPlatformConfig
-  protected readonly hap: HAP
-
-  // Config
-  protected deviceLogging!: string
-  protected deviceRefreshRate!: number
-  protected deviceUpdateRate!: number
-  protected devicePushRate!: number
-  protected deviceMaxRetries!: number
-  protected deviceDelayBetweenRetries!: number
-
-  // Connection
-  protected readonly BLE: boolean
-  protected readonly OpenAPI: boolean
-
-  // Accsrroy Information
-  protected deviceModel!: SwitchBotModel
-  protected deviceBLEModel!: SwitchBotBLEModel
-
-  // MQTT
-  protected deviceMqttURL!: string
-  protected deviceMqttOptions!: any
-  protected deviceMqttPubOptions!: any
-
-  // BLE
-  protected scanDuration!: number
-
-  // EVE history service handler
-  protected historyService?: any = null
-
-  // MQTT stuff
-  protected mqttClient: MqttClient | null = null
-
-  constructor(
-    protected readonly platform: SwitchBotHAPPlatform,
-    protected accessory: PlatformAccessory,
-    protected device: device & devicesConfig,
-  ) {
-    this.api = this.platform.api
-    this.log = this.platform.log
-    this.config = this.platform.config
-    this.hap = this.api.hap
-
-    // Connection
-    this.BLE = this.device.connectionType === 'BLE' || this.device.connectionType === 'BLE/OpenAPI'
-    this.OpenAPI = this.device.connectionType === 'OpenAPI' || this.device.connectionType === 'BLE/OpenAPI'
-
-    this.getDeviceLogSettings(device)
-    this.getDeviceRateSettings(device)
-    this.getDeviceConfigSettings(device)
-    this.getDeviceContext(accessory, device)
-    this.getMqttSettings(device)
-
-    // Set accessory information
-    accessory
-      .getService(this.hap.Service.AccessoryInformation)!
-      .setCharacteristic(this.hap.Characteristic.Manufacturer, 'SwitchBot')
-      .setCharacteristic(this.hap.Characteristic.AppMatchingIdentifier, 'id1087374760')
-      .setCharacteristic(this.hap.Characteristic.Name, accessory.displayName)
-      .setCharacteristic(this.hap.Characteristic.ConfiguredName, accessory.displayName)
-      .setCharacteristic(this.hap.Characteristic.Model, device.model)
-      .setCharacteristic(this.hap.Characteristic.ProductData, device.deviceId)
-      .setCharacteristic(this.hap.Characteristic.SerialNumber, device.deviceId)
-  }
-
-  async getDeviceLogSettings(device: device & devicesConfig): Promise<void> {
-    this.deviceLogging = this.platform.debugMode ? 'debugMode' : device.logging ?? this.platform.platformLogging ?? 'standard'
-    const logging = this.platform.debugMode ? 'Debug Mode' : device.logging ? 'Device Config' : this.platform.platformLogging ? 'Platform Config' : 'Default'
-    this.debugLog(`Using ${logging} Logging: ${this.deviceLogging}`)
-  }
-
-  async getDeviceRateSettings(device: device & devicesConfig): Promise<void> {
-    // refreshRate
-    this.deviceRefreshRate = device.refreshRate ?? this.platform.platformRefreshRate ?? 300
-    const refreshRate = device.refreshRate ? 'Device Config' : this.platform.platformRefreshRate ? 'Platform Config' : 'Default'
-    this.accessory.context.refreshRate = this.deviceRefreshRate
-    // updateRate
-    this.deviceUpdateRate = device.updateRate ?? this.platform.platformUpdateRate ?? 5
-    const updateRate = device.updateRate ? 'Device Config' : this.platform.platformUpdateRate ? 'Platform Config' : 'Default'
-    this.accessory.context.updateRate = this.deviceUpdateRate
-    // pushRate
-    this.devicePushRate = device.pushRate ?? this.platform.platformPushRate ?? 0.1
-    const pushRate = device.pushRate ? 'Device Config' : this.platform.platformPushRate ? 'Platform Config' : 'Default'
-    this.accessory.context.pushRate = this.devicePushRate
-    this.debugLog(`Using ${refreshRate} refreshRate: ${this.deviceRefreshRate}, ${updateRate} updateRate: ${this.deviceUpdateRate}, ${pushRate} pushRate: ${this.devicePushRate}`)
-    // maxRetries
-    this.deviceMaxRetries = device.maxRetries ?? this.platform.platformMaxRetries ?? 2
-    const maxRetries = device.maxRetries ? 'Device' : this.platform.platformMaxRetries ? 'Platform' : 'Default'
-    this.debugLog(`Using ${maxRetries} Max Retries: ${this.deviceMaxRetries}`)
-    // delayBetweenRetries
-    this.deviceDelayBetweenRetries = device.delayBetweenRetries ? (device.delayBetweenRetries * 1000) : this.platform.platformDelayBetweenRetries ?? 3000
-    const delayBetweenRetries = device.delayBetweenRetries ? 'Device' : this.platform.platformDelayBetweenRetries ? 'Platform' : 'Default'
-    this.debugLog(`Using ${delayBetweenRetries} Delay Between Retries: ${this.deviceDelayBetweenRetries}`)
-    // scanDuration
-    this.scanDuration = Math.max(device.scanDuration ?? 1, this.deviceUpdateRate > 1 ? this.deviceUpdateRate : 1)
-    if (this.BLE) {
-      this.debugLog(`Using ${device.scanDuration ? 'Device Config' : 'Default'} scanDuration: ${this.scanDuration}`)
-      if (device.scanDuration && this.deviceUpdateRate > device.scanDuration) {
-        this.warnLog('scanDuration is less than updateRate, overriding scanDuration with updateRate')
-      }
-    }
-  }
-
-  async retryBLE({ max, fn }: { max: number, fn: { (): any, (): Promise<any> } }): Promise<null> {
-    return fn().catch(async (e: any) => {
-      if (max === 0) {
-        throw e
-      }
-      this.warnLog(e)
-      this.infoLog('Retrying')
-      await sleep(1000)
-      return this.retryBLE({ max: max - 1, fn })
-    })
-  }
-
-  maxRetryBLE(): number {
-    return this.device.maxRetry !== undefined ? this.device.maxRetry : 5
-  }
-
-  async getDeviceConfigSettings(device: device & devicesConfig): Promise<void> {
-    const deviceConfig = Object.assign(
-      {},
-      device.logging !== 'standard' && { logging: device.logging },
-      device.refreshRate !== 0 && { refreshRate: device.refreshRate },
-      device.updateRate !== 0 && { updateRate: device.updateRate },
-      device.scanDuration !== 0 && { scanDuration: device.scanDuration },
-      device.offline === true && { offline: device.offline },
-      device.maxRetry !== 0 && { maxRetry: device.maxRetry },
-      (device.webhook === true || (device.webhook === undefined && this.config.options?.webhook === true)) && {
-        webhook: device.webhook !== undefined ? device.webhook : this.config.options?.webhook,
-      },
-      device.connectionType !== '' && { connectionType: device.connectionType },
-      device.disablePlatformBLE !== false && { disablePlatformBLE: device.disablePlatformBLE },
-      device.external === true && { external: device.external },
-      device.mqttURL !== '' && { mqttURL: device.mqttURL },
-      device.mqttOptions && { mqttOptions: device.mqttOptions },
-      device.mqttPubOptions && { mqttPubOptions: device.mqttPubOptions },
-      device.maxRetries !== 0 && { maxRetries: device.maxRetries },
-      device.delayBetweenRetries !== 0 && { delayBetweenRetries: device.delayBetweenRetries },
-    )
-    let deviceSpecificConfig = {}
-    switch (device.configDeviceType) {
-      case 'Bot':
-        deviceSpecificConfig = device as botConfig
-        break
-      case 'Relay Switch 1':
-        deviceSpecificConfig = device as relaySwitch1Config
-        break
-      case 'Relay Switch 1PM':
-        deviceSpecificConfig = device as relaySwitch1PMConfig
-        break
-      case 'Meter':
-      case 'MeterPlus':
-        deviceSpecificConfig = device as meterConfig
-        break
-      case 'WoIOSensor':
-        deviceSpecificConfig = device as indoorOutdoorSensorConfig
-        break
-      case 'Humidifier':
-      case 'Humidifier2':
-        deviceSpecificConfig = device as humidifierConfig
-        break
-      case 'Curtain':
-      case 'Curtain3':
-        deviceSpecificConfig = device as curtainConfig
-        break
-      case 'Blind Tilt':
-        deviceSpecificConfig = device as blindTiltConfig
-        break
-      case 'Contact Sensor':
-        deviceSpecificConfig = device as contactConfig
-        break
-      case 'Motion Sensor':
-        deviceSpecificConfig = device as motionConfig
-        break
-      case 'Water Detector':
-        deviceSpecificConfig = device as waterDetectorConfig
-        break
-      case 'Plug':
-      case 'Plug Mini (US)':
-      case 'Plug Mini (JP)':
-        deviceSpecificConfig = device as plugConfig
-        break
-      case 'Color Bulb':
-        deviceSpecificConfig = device as colorBulbConfig
-        break
-      case 'Strip Light':
-        deviceSpecificConfig = device as stripLightConfig
-        break
-      case 'Ceiling Light':
-      case 'Ceiling Light Pro':
-        deviceSpecificConfig = device as ceilingLightConfig
-        break
-      case 'Smart Lock':
-      case 'Smart Lock Pro':
-        deviceSpecificConfig = device as lockConfig
-        break
-      case 'Hub 2':
-        deviceSpecificConfig = device as hubConfig
-        break
-      default:
-    }
-    const config = Object.assign(
-      {},
-      deviceConfig,
-      deviceSpecificConfig,
-    )
-
-    if (Object.keys(config).length !== 0) {
-      this.debugSuccessLog(`Config: ${JSON.stringify(config)}`)
-    }
-  }
-
-  /**
-   * Get the current ambient light level based on the light level, set_minLux, set_maxLux, and spaceBetweenLevels.
-   * @param lightLevel number
-   * @param set_minLux number
-   * @param set_maxLux number
-   * @param spaceBetweenLevels number
-   * @returns CurrentAmbientLightLevel
-   */
-  getLightLevel(lightLevel: number, set_minLux: number, set_maxLux: number, spaceBetweenLevels: number): number {
-    const numberOfLevels = spaceBetweenLevels + 1
-    this.debugLog(`LightLevel: ${lightLevel}, set_minLux: ${set_minLux}, set_maxLux: ${set_maxLux}, spaceBetweenLevels: ${spaceBetweenLevels}, numberOfLevels: ${numberOfLevels}`)
-    const CurrentAmbientLightLevel = lightLevel === 1
-      ? set_minLux
-      : lightLevel === numberOfLevels
-        ? set_maxLux
-        : ((set_maxLux - set_minLux) / spaceBetweenLevels) * (Number(lightLevel) - 1)
-    this.debugLog(`CurrentAmbientLightLevel: ${CurrentAmbientLightLevel}, LightLevel: ${lightLevel}, set_minLux: ${set_minLux}, set_maxLux: ${set_maxLux}`)
-    return CurrentAmbientLightLevel
-  }
-
-  /*
-   * Publish MQTT message for topics of
-   * 'homebridge-switchbot/${this.device.deviceType}/xx:xx:xx:xx:xx:xx'
-   */
-  async mqttPublish(message: string, topic?: string) {
-    const mac = this.device.deviceId?.toLowerCase().match(/[\s\S]{1,2}/g)?.join(':')
-    const options = this.deviceMqttPubOptions ?? {}
-    const mqttTopic = topic ? `/${topic}` : ''
-    const mqttMessageTopic = topic ? `${topic}/` : ''
-    this.mqttClient?.publish(`homebridge-switchbot/${this.device.deviceType}/${mac}${mqttTopic}`, `${message}`, options)
-    this.debugLog(`MQTT message: ${mqttMessageTopic}${message} options:${JSON.stringify(options)}`)
-  }
-
-  /*
-   * MQTT Settings
-   */
-  async getMqttSettings(device: device & devicesConfig): Promise<void> {
-    // mqttURL
-    this.deviceMqttURL = device.mqttURL ?? this.config.options?.mqttURL ?? ''
-    const mqttURL = device.mqttURL ? 'Device Config' : this.config.options?.mqttURL ? 'Platform Config' : 'Default'
-    // mqttOptions
-    this.deviceMqttOptions = device.mqttOptions ?? this.config.options?.mqttOptions ?? {}
-    const mqttOptions = device.mqttOptions ? 'Device Config' : this.config.options?.mqttOptions ? 'Platform Config' : 'Default'
-    // mqttPubOptions
-    this.deviceMqttPubOptions = device.mqttPubOptions ?? this.config.options?.mqttPubOptions ?? {}
-    const mqttPubOptions = device.mqttPubOptions ? 'Device Config' : this.config.options?.mqttPubOptions ? 'Platform Config' : 'Default'
-    this.debugLog(`Using ${mqttURL} MQTT URL: ${this.deviceMqttURL}, ${mqttOptions} mqttOptions: ${JSON.stringify(this.deviceMqttOptions)}, ${mqttPubOptions} mqttPubOptions: ${JSON.stringify(this.deviceMqttPubOptions)}`)
-  }
-
-  /*
-   * Setup EVE history graph feature if enabled.
-   */
-  async setupHistoryService(accessory: PlatformAccessory, device: device & devicesConfig): Promise<void> {
-    try {
-      const formattedDeviceId = formatDeviceIdAsMac(this.device.deviceId)
-      this.device.bleMac = formattedDeviceId
-      this.debugLog(`bleMac: ${this.device.bleMac}`)
-      this.historyService = device.history
-        ? new this.platform.fakegatoAPI('room', accessory, { log: this.platform.log, storage: 'fs', filename: `${hostname().split('.')[0]}_${this.device.bleMac}_persist.json` })
-        : null
-    } catch (error) {
-      this.errorLog(`failed to format device ID as MAC, Error: ${error}`)
-    }
-  }
-
-  async switchbotBLE(): Promise<any> {
-    const switchBotBLE = await this.platform.connectBLE(this.accessory, this.device)
-    // Convert to BLE Address
-    try {
-      const formattedDeviceId = formatDeviceIdAsMac(this.device.deviceId)
-      this.device.bleMac = formattedDeviceId
-      await this.getCustomBLEAddress(switchBotBLE)
-      this.debugLog(`bleMac: ${this.device.bleMac}`)
-      return switchBotBLE
-    } catch (error) {
-      this.errorLog(`failed to format device ID as MAC, Error: ${error}`)
-    }
-  }
-
-  async monitorAdvertisementPackets(switchbot: SwitchBotBLE): Promise<ad['serviceData']> {
-    this.debugLog(`Scanning for deviceID: ${this.device.bleMac} Model: ${this.device.bleModel} ModelName: ${this.device.bleModelName}...`)
-    try {
-      await switchbot.startScan({ model: this.device.bleModel, id: this.device.bleMac })
-    } catch (e: any) {
-      this.errorLog(`Failed to start BLE scanning. Error: ${e.message ?? e}`)
-    }
-    // Set an event handler
-    let serviceData = { model: this.device.bleModel, modelName: this.device.bleModelName } as ad['serviceData']
-    switchbot.onadvertisement = (ad: ad) => {
-      if (ad.address === this.device.bleMac && ad.serviceData.model === this.device.bleModel) {
-        this.debugLog(`ad: ${safeStringify(ad)}`)
-        this.debugLog(`${JSON.stringify(ad, null, '  ')}`)
-        this.debugLog(`address: ${ad.address}, model: ${ad.serviceData.model}`)
-        this.debugLog(`serviceData: ${JSON.stringify(ad.serviceData)}`)
-        serviceData = ad.serviceData
-      }
-    }
-    // Wait
-    await switchbot.wait(this.scanDuration * 1000)
-    // Stop to monitor
-    try {
-      await switchbot.stopScan()
-    } catch (e: any) {
-      this.errorLog(`Failed to stop BLE scanning. Error: ${e.message ?? e}`)
-    }
-    return serviceData
-  }
-
-  async getCustomBLEAddress(switchbot: SwitchBotBLE): Promise<void> {
-    if (this.device.customBLEaddress && this.deviceLogging.includes('debug')) {
-      this.debugLog(`customBLEaddress: ${this.device.customBLEaddress}`);
-      (async () => {
-        // Start to monitor advertisement packets
-        try {
-          await switchbot.startScan({ model: this.device.bleModel })
-        } catch (e: any) {
-          this.errorLog(`Failed to start BLE scanning. Error: ${e.message ?? e}`)
-        }
-        // Set an event handler
-        switchbot.onadvertisement = (ad: ad) => {
-          this.warnLog(`ad: ${JSON.stringify(ad, null, '  ')}`)
-        }
-        await sleep(10000)
-        // Stop to monitor
-        try {
-          switchbot.stopScan()
-        } catch (e: any) {
-          this.errorLog(`Failed to stop BLE scanning. Error: ${e.message ?? e}`)
-        }
-      })()
-    }
-  }
-
-  async pushChangeRequest<T extends pushResponse['body']>(bodyChange: bodyChange): Promise<{ body: T, statusCode: pushResponse['statusCode'] }> {
-    const { response, statusCode } = await this.platform.retryCommand(this.device, bodyChange, this.deviceMaxRetries, this.deviceDelayBetweenRetries)
-    return { body: response, statusCode }
-  }
-
-  async deviceRefreshStatus<T extends deviceStatus>(): Promise<{ body: T, statusCode: deviceStatusRequest['statusCode'] }> {
-    const { response, statusCode } = await this.platform.retryRequest(this.device, this.deviceMaxRetries, this.deviceDelayBetweenRetries)
-    return { body: response, statusCode }
-  }
-
-  /**
-   * Check if status code indicates success (100 or 200)
-   * @deprecated Use isSuccessfulStatusCode from utils.ts instead
-   */
-  async successfulStatusCodes<T extends { statusCode: number }>(deviceStatus: T): Promise<boolean> {
-    return isSuccessfulStatusCode(deviceStatus.statusCode)
-  }
-
-  /**
-   * Update the characteristic value and log the change.
-   *
-   * @param Service Service
-   * @param Characteristic Characteristic
-   * @param CharacteristicValue CharacteristicValue | undefined
-   * @param CharacteristicName string
-   * @param history object
-   * @return: void
-   *
-   */
-  async updateCharacteristic(Service: Service, Characteristic: any, CharacteristicValue: CharacteristicValue | undefined, CharacteristicName: string, history?: object): Promise<void> {
-    if (CharacteristicValue === undefined || CharacteristicValue === null) {
-      this.debugLog(`${CharacteristicName}: ${CharacteristicValue}`)
-    } else {
-      await this.mqtt(CharacteristicName, CharacteristicValue)
-      if (this.device.history) {
-        this.historyService?.addEntry(history)
-      }
-      Service.updateCharacteristic(Characteristic, CharacteristicValue)
-      this.debugLog(`updateCharacteristic ${CharacteristicName}: ${CharacteristicValue}`)
-      this.debugWarnLog(`${CharacteristicName} context before: ${this.accessory.context[CharacteristicName]}`)
-      this.accessory.context[CharacteristicName] = CharacteristicValue
-      this.debugWarnLog(`${CharacteristicName} context after: ${this.accessory.context[CharacteristicName]}`)
-    }
-  }
-
-  async mqtt(CharacteristicName: string, CharacteristicValue: CharacteristicValue) {
-    if (this.device.mqttURL) {
-      this.mqttPublish(CharacteristicName, CharacteristicValue.toString())
-    }
-  }
-
-  async getDeviceContext(accessory: PlatformAccessory, device: device & devicesConfig): Promise<void> {
-    const deviceMapping = {
-      'Humidifier': {
-        model: SwitchBotModel.Humidifier,
-        bleModel: SwitchBotBLEModel.Humidifier,
-        bleModelName: SwitchBotBLEModelName.Humidifier,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Humidifier,
-      },
-      'Humidifier2': {
-        model: SwitchBotModel.Humidifier2,
-        bleModel: SwitchBotBLEModel.Humidifier2,
-        bleModelName: SwitchBotBLEModelName.Humidifier2,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Humidifier2,
-      },
-      'Hub Mini': {
-        model: SwitchBotModel.HubMini,
-        bleModel: SwitchBotBLEModel.Unknown,
-        bleModelName: SwitchBotBLEModelName.Unknown,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
-      },
-      'Hub Plus': {
-        model: SwitchBotModel.HubPlus,
-        bleModel: SwitchBotBLEModel.Unknown,
-        bleModelName: SwitchBotBLEModelName.Unknown,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
-      },
-      'Hub 2': {
-        model: SwitchBotModel.Hub2,
-        bleModel: SwitchBotBLEModel.Hub2,
-        bleModelName: SwitchBotBLEModelName.Hub2,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Hub2,
-      },
-      'Hub 3': {
-        model: SwitchBotModel.Hub3,
-        bleModel: SwitchBotBLEModel.Hub3,
-        bleModelName: SwitchBotBLEModelName.Hub3,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Hub3,
-      },
-      'Bot': {
-        model: SwitchBotModel.Bot,
-        bleModel: SwitchBotBLEModel.Bot,
-        bleModelName: SwitchBotBLEModelName.Bot,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Bot,
-      },
-      'Relay Switch 1': {
-        model: SwitchBotModel.RelaySwitch1,
-        bleModel: SwitchBotBLEModel.RelaySwitch1,
-        bleModelName: SwitchBotBLEModelName.RelaySwitch1,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.RelaySwitch1,
-      },
-      'Relay Switch 1PM': {
-        model: SwitchBotModel.RelaySwitch1PM,
-        bleModel: SwitchBotBLEModel.RelaySwitch1PM,
-        bleModelName: SwitchBotBLEModelName.RelaySwitch1PM,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.RelaySwitch1PM,
-      },
-      'Meter': {
-        model: SwitchBotModel.Meter,
-        bleModel: SwitchBotBLEModel.Meter,
-        bleModelName: SwitchBotBLEModelName.Meter,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Meter,
-      },
-      'MeterPlus': {
-        model: SwitchBotModel.MeterPlusUS,
-        bleModel: SwitchBotBLEModel.MeterPlus,
-        bleModelName: SwitchBotBLEModelName.MeterPlus,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.MeterPlus,
-      },
-      'Meter Plus (JP)': {
-        model: SwitchBotModel.MeterPlusJP,
-        bleModel: SwitchBotBLEModel.MeterPlus,
-        bleModelName: SwitchBotBLEModelName.MeterPlus,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.MeterPlus,
-      },
-      'MeterPro': {
-        model: SwitchBotModel.MeterPro,
-        bleModel: SwitchBotBLEModel.MeterPro,
-        bleModelName: SwitchBotBLEModelName.MeterPro,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.MeterPro,
-      },
-      'MeterPro(CO2)': {
-        model: SwitchBotModel.MeterProCO2,
-        bleModel: SwitchBotBLEModel.MeterProCO2,
-        bleModelName: SwitchBotBLEModelName.MeterProCO2,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.MeterProCO2,
-      },
-      'WoIOSensor': {
-        model: SwitchBotModel.OutdoorMeter,
-        bleModel: SwitchBotBLEModel.OutdoorMeter,
-        bleModelName: SwitchBotBLEModelName.OutdoorMeter,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.OutdoorMeter,
-      },
-      'Water Detector': {
-        model: SwitchBotModel.WaterDetector,
-        bleModel: SwitchBotBLEModel.Leak,
-        bleModelName: SwitchBotBLEModelName.Leak,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Leak,
-      },
-      'Motion Sensor': {
-        model: SwitchBotModel.MotionSensor,
-        bleModel: SwitchBotBLEModel.MotionSensor,
-        bleModelName: SwitchBotBLEModelName.MotionSensor,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.MotionSensor,
-      },
-      'Contact Sensor': {
-        model: SwitchBotModel.ContactSensor,
-        bleModel: SwitchBotBLEModel.ContactSensor,
-        bleModelName: SwitchBotBLEModelName.ContactSensor,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.ContactSensor,
-      },
-      'Curtain': {
-        model: SwitchBotModel.Curtain,
-        bleModel: SwitchBotBLEModel.Curtain,
-        bleModelName: SwitchBotBLEModelName.Curtain,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Curtain,
-      },
-      'Curtain3': {
-        model: SwitchBotModel.Curtain3,
-        bleModel: SwitchBotBLEModel.Curtain3,
-        bleModelName: SwitchBotBLEModelName.Curtain3,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Curtain3,
-      },
-      'WoRollerShade': {
-        model: SwitchBotModel.Curtain3,
-        bleModel: SwitchBotBLEModel.Curtain3,
-        bleModelName: SwitchBotBLEModelName.Curtain3,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Curtain3,
-      },
-      'Roller Shade': {
-        model: SwitchBotModel.Curtain3,
-        bleModel: SwitchBotBLEModel.Curtain3,
-        bleModelName: SwitchBotBLEModelName.Curtain3,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Curtain3,
-      },
-      'Blind Tilt': {
-        model: SwitchBotModel.BlindTilt,
-        bleModel: SwitchBotBLEModel.BlindTilt,
-        bleModelName: SwitchBotBLEModelName.BlindTilt,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.BlindTilt,
-      },
-      'Plug': {
-        model: SwitchBotModel.Plug,
-        bleModel: SwitchBotBLEModel.PlugMiniUS,
-        bleModelName: SwitchBotBLEModelName.PlugMini,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.PlugMini,
-      },
-      'Plug Mini (US)': {
-        model: SwitchBotModel.PlugMiniUS,
-        bleModel: SwitchBotBLEModel.PlugMiniUS,
-        bleModelName: SwitchBotBLEModelName.PlugMini,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.PlugMini,
-      },
-      'Plug Mini (JP)': {
-        model: SwitchBotModel.PlugMiniJP,
-        bleModel: SwitchBotBLEModel.PlugMiniJP,
-        bleModelName: SwitchBotBLEModelName.PlugMini,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.PlugMini,
-      },
-      'Smart Lock': {
-        model: SwitchBotModel.Lock,
-        bleModel: SwitchBotBLEModel.Lock,
-        bleModelName: SwitchBotBLEModelName.Lock,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Lock,
-      },
-      'Smart Lock Pro': {
-        model: SwitchBotModel.LockPro,
-        bleModel: SwitchBotBLEModel.LockPro,
-        bleModelName: SwitchBotBLEModelName.LockPro,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.LockPro,
-      },
-      'Smart Lock Ultra': {
-        model: SwitchBotModel.LockPro,
-        bleModel: SwitchBotBLEModel.LockPro,
-        bleModelName: SwitchBotBLEModelName.LockPro,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.LockPro,
-      },
-      'Color Bulb': {
-        model: SwitchBotModel.ColorBulb,
-        bleModel: SwitchBotBLEModel.ColorBulb,
-        bleModelName: SwitchBotBLEModelName.ColorBulb,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.ColorBulb,
-      },
-      'K10+': {
-        model: SwitchBotModel.K10,
-        bleModel: SwitchBotBLEModel.Unknown,
-        bleModelName: SwitchBotBLEModelName.Unknown,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
-      },
-      'K10+ Pro': {
-        model: SwitchBotModel.K10Pro,
-        bleModel: SwitchBotBLEModel.Unknown,
-        bleModelName: SwitchBotBLEModelName.Unknown,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
-      },
-      'WoSweeper': {
-        model: SwitchBotModel.WoSweeper,
-        bleModel: SwitchBotBLEModel.Unknown,
-        bleModelName: SwitchBotBLEModelName.Unknown,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
-      },
-      'WoSweeperMini': {
-        model: SwitchBotModel.WoSweeperMini,
-        bleModel: SwitchBotBLEModel.Unknown,
-        bleModelName: SwitchBotBLEModelName.Unknown,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
-      },
-      'Robot Vacuum Cleaner S1': {
-        model: SwitchBotModel.RobotVacuumCleanerS1,
-        bleModel: SwitchBotBLEModel.Unknown,
-        bleModelName: SwitchBotBLEModelName.Unknown,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
-      },
-      'Robot Vacuum Cleaner S1 Plus': {
-        model: SwitchBotModel.RobotVacuumCleanerS1Plus,
-        bleModel: SwitchBotBLEModel.Unknown,
-        bleModelName: SwitchBotBLEModelName.Unknown,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
-      },
-      'Robot Vacuum Cleaner S10': {
-        model: SwitchBotModel.RobotVacuumCleanerS10,
-        bleModel: SwitchBotBLEModel.Unknown,
-        bleModelName: SwitchBotBLEModelName.Unknown,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
-      },
-      'Ceiling Light': {
-        model: SwitchBotModel.CeilingLight,
-        bleModel: SwitchBotBLEModel.CeilingLight,
-        bleModelName: SwitchBotBLEModelName.CeilingLight,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.CeilingLight,
-      },
-      'Ceiling Light Pro': {
-        model: SwitchBotModel.CeilingLightPro,
-        bleModel: SwitchBotBLEModel.CeilingLightPro,
-        bleModelName: SwitchBotBLEModelName.CeilingLightPro,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.CeilingLightPro,
-      },
-      'Strip Light': {
-        model: SwitchBotModel.StripLight,
-        bleModel: SwitchBotBLEModel.StripLight,
-        bleModelName: SwitchBotBLEModelName.StripLight,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.StripLight,
-      },
-      'Indoor Cam': {
-        model: SwitchBotModel.IndoorCam,
-        bleModel: SwitchBotBLEModel.Unknown,
-        bleModelName: SwitchBotBLEModelName.Unknown,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
-      },
-      'Remote': {
-        model: SwitchBotModel.Remote,
-        bleModel: SwitchBotBLEModel.Unknown,
-        bleModelName: SwitchBotBLEModelName.Unknown,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
-      },
-      'remote with screen+': {
-        model: SwitchBotModel.UniversalRemote,
-        bleModel: SwitchBotBLEModel.Unknown,
-        bleModelName: SwitchBotBLEModelName.Unknown,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
-      },
-      'Battery Circulator Fan': {
-        model: SwitchBotModel.BatteryCirculatorFan,
-        bleModel: SwitchBotBLEModel.Unknown,
-        bleModelName: SwitchBotBLEModelName.Unknown,
-        bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
-      },
-    }
-    const defaultDevice = {
-      model: SwitchBotModel.Unknown,
-      bleModel: SwitchBotBLEModel.Unknown,
-      bleModelName: SwitchBotBLEModelName.Unknown,
-      bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
-    }
-    const deviceConfig = deviceMapping[device.deviceType] || defaultDevice
-    device.model = deviceConfig.model
-    device.bleModel = deviceConfig.bleModel
-    device.bleModelName = deviceConfig.bleModelName
-    device.bleModelFriednlyName = deviceConfig.bleModelFriednlyName
-    this.debugLog(`Model: ${device.model}, BLE Model: ${device.bleModel}, BLE Model Name: ${device.bleModelName}, BLE Model Friendly Name: ${device.bleModelFriednlyName}`)
-
-    const deviceFirmwareVersion = device.firmware ?? device.version ?? accessory.context.version ?? this.platform.version ?? '0.0.0'
-    const version = deviceFirmwareVersion.toString()
-    this.debugLog(`Firmware Version: ${version.replace(/^V|-.*$/g, '')}`)
-    let deviceVersion: string
-    if (version?.includes('.') === false) {
-      const replace = version?.replace(/^V|-.*$/g, '')
-      const match = replace?.match(/./g)
-      const validVersion = match?.join('.')
-      deviceVersion = validVersion ?? '0.0.0'
-    } else {
-      deviceVersion = version.replace(/^V|-.*$/g, '') ?? '0.0.0'
-    }
-    accessory
-      .getService(this.hap.Service.AccessoryInformation)!
-      .setCharacteristic(this.hap.Characteristic.HardwareRevision, deviceVersion)
-      .setCharacteristic(this.hap.Characteristic.SoftwareRevision, deviceVersion)
-      .setCharacteristic(this.hap.Characteristic.FirmwareRevision, deviceVersion)
-      .getCharacteristic(this.hap.Characteristic.FirmwareRevision)
-      .updateValue(deviceVersion)
-    accessory.context.version = deviceVersion
-    this.debugSuccessLog(`version: ${accessory.context.version}`)
-
-    // Expose effective webhook setting on accessory context (parity with Matter)
-    try {
-      const effectiveWebhook = device.webhook !== undefined ? device.webhook : (this.config.options?.webhook === true ? true : undefined)
-      if (effectiveWebhook !== undefined) {
-        accessory.context.webhook = effectiveWebhook
-        this.debugLog(`Effective webhook for ${device.deviceId}: ${String(effectiveWebhook)}`)
-      }
-    } catch (e: any) {
-      this.debugLog(`Failed to set webhook context for ${device.deviceId}: ${e?.message ?? e}`)
-    }
-  }
-
-  async statusCode(statusCode: number): Promise<void> {
-    await logDeviceStatusCode(
-      statusCode,
-      {
-        debugLog: this.debugLog.bind(this),
-        debugErrorLog: this.debugErrorLog.bind(this),
-        errorLog: this.errorLog.bind(this),
-        infoLog: this.infoLog.bind(this),
-      },
-      this.device.deviceId,
-      this.device.hubDeviceId,
-    )
-  }
-
-  /**
-   * Logging for Device
-   * Modernized logging methods with improved type safety and formatting
-   */
-  infoLog(message: string, ...args: unknown[]): void {
-    if (!this.enablingDeviceLogging()) {
-      return
-    }
-    const prefix = `${this.device.deviceType}: ${this.accessory.displayName}`
-    this.logWith('info', prefix, undefined, this.formatLogMessage(message, ...args))
-  }
-
-  successLog(message: string, ...args: unknown[]): void {
-    if (!this.enablingDeviceLogging()) {
-      return
-    }
-    const prefix = `${this.device.deviceType}: ${this.accessory.displayName}`
-    this.logWith('success', prefix, undefined, this.formatLogMessage(message, ...args))
-  }
-
-  debugSuccessLog(message: string, ...args: unknown[]): void {
-    if (!this.enablingDeviceLogging() || !this.loggingIsDebug()) {
-      return
-    }
-    const prefix = `[DEBUG] ${this.device.deviceType}: ${this.accessory.displayName}`
-    this.logWith('success', prefix, 'debugSuccessLog', this.formatLogMessage(message, ...args))
-  }
-
-  warnLog(message: string, ...args: unknown[]): void {
-    if (!this.enablingDeviceLogging()) {
-      return
-    }
-    const prefix = `${this.device.deviceType}: ${this.accessory.displayName}`
-    this.logWith('warn', prefix, undefined, this.formatLogMessage(message, ...args))
-  }
-
-  debugWarnLog(message: string, ...args: unknown[]): void {
-    if (!this.enablingDeviceLogging() || !this.loggingIsDebug()) {
-      return
-    }
-    const prefix = `[DEBUG] ${this.device.deviceType}: ${this.accessory.displayName}`
-    this.logWith('warn', prefix, 'debugWarnLog', this.formatLogMessage(message, ...args))
-  }
-
-  errorLog(message: string, ...args: unknown[]): void {
-    if (!this.enablingDeviceLogging()) {
-      return
-    }
-    const prefix = `${this.device.deviceType}: ${this.accessory.displayName}`
-    this.logWith('error', prefix, undefined, this.formatLogMessage(message, ...args))
-  }
-
-  debugErrorLog(message: string, ...args: unknown[]): void {
-    if (!this.enablingDeviceLogging() || !this.loggingIsDebug()) {
-      return
-    }
-    const prefix = `[DEBUG] ${this.device.deviceType}: ${this.accessory.displayName}`
-    this.logWith('error', prefix, 'debugErrorLog', this.formatLogMessage(message, ...args))
-  }
-
-  debugLog(message: string, ...args: unknown[]): void {
-    if (!this.enablingDeviceLogging()) {
-      return
-    }
-    // debug behaves differently depending on debug vs debugMode
-    const prefix = this.deviceLogging === 'debug'
-      ? `[DEBUG] ${this.device.deviceType}: ${this.accessory.displayName}`
-      : `${this.device.deviceType}: ${this.accessory.displayName}`
-    this.logWith('debug', prefix, 'debugLog', this.formatLogMessage(message, ...args))
-  }
-
-  /**
-   * Format log message with arguments - handles both legacy and modern patterns
-   */
-  private formatLogMessage(message: string | any, ...args: unknown[]): string {
-    // Handle legacy String(...log) pattern for backward compatibility
-    if (typeof message !== 'string' && args.length === 0) {
-      return String(message)
-    }
-
-    // Modern pattern: format message with arguments
-    if (args.length === 0) {
-      return String(message)
-    }
-
-    // Format arguments similar to how platform logging works
-    const formattedArgs = args.map((arg) => {
-      if (typeof arg === 'string') {
-        return arg
-      }
-      try {
-        return JSON.stringify(arg)
-      } catch {
-        return String(arg)
-      }
-    })
-
-    return args.length > 0 ? `${message} ${formattedArgs.join(' ')}` : String(message)
-  }
-
-  // Generic logger used by device log helpers. Attempts to call a platform
-  // helper method first (if present), then falls back to the local logger.
-  protected logWith(level: string, message: string, platformMethodName?: string, payload?: string): void {
-    const method = platformMethodName ?? `${level}Log`
-    const pFn = (this.platform as any)?.[method]
-    if (typeof pFn === 'function') {
-      try {
-        // Forward both a short message (title) and optional payload to the
-        // platform logger so it can format/attach metadata consistently.
-        if (payload !== undefined) {
-          pFn(message, payload)
-        } else {
-          pFn(message)
-        }
-        return
-      } catch (_err) {
-        // fallthrough to local logger
-      }
-    }
-    const map: Record<string, string> = {
-      info: 'info',
-      success: 'success',
-      debug: 'debug',
-      warn: 'warn',
-      error: 'error',
-    }
-    const local = (this.log as any)[map[level] ?? level]
-    if (typeof local === 'function') {
-      if (payload !== undefined) {
-        local.call(this.log, message, payload)
-      } else {
-        local.call(this.log, message)
-      }
-    }
-  }
-
-  loggingIsDebug(): boolean {
-    return deviceLoggingIsDebug(this.deviceLogging)
-  }
-
-  enablingDeviceLogging(): boolean {
-    return deviceLoggingEnabled(this.deviceLogging, this.platform.platformLogging)
-  }
-}