@switchbot/homebridge-switchbot 4.3.2-beta.9 → 5.0.0-beta.0

package/src/{device → devices-hap}/iosensor.ts

@@ -5,7 +5,7 @@
 import type { CharacteristicValue, PlatformAccessory, Service } from 'homebridge'
 import type { device, outdoorMeterServiceData, outdoorMeterStatus, outdoorMeterWebhookContext, SwitchBotBLE } from 'node-switchbot'
 
-import type { SwitchBotPlatform } from '../platform.js'
+import type { SwitchBotHAPPlatform } from '../platform-hap.js'
 import type { devicesConfig, indoorOutdoorSensorConfig } from '../settings.js'
 
 import { Units } from 'homebridge'
@@ -59,7 +59,7 @@ export class IOSensor extends deviceBase {
   doIOSensorUpdate: Subject<void>
 
   constructor(
-    readonly platform: SwitchBotPlatform,
+    readonly platform: SwitchBotHAPPlatform,
     accessory: PlatformAccessory,
     device: device & devicesConfig,
   ) {

package/src/{device → devices-hap}/lightstrip.ts

@@ -5,7 +5,7 @@
 import type { CharacteristicValue, Controller, ControllerConstructor, ControllerServiceMap, PlatformAccessory, Service } from 'homebridge'
 import type { bodyChange, device, stripLightServiceData, stripLightStatus, stripLightWebhookContext, SwitchBotBLE, SwitchbotDevice, WoStrip } from 'node-switchbot'
 
-import type { SwitchBotPlatform } from '../platform.js'
+import type { SwitchBotHAPPlatform } from '../platform-hap.js'
 import type { devicesConfig, stripLightConfig } from '../settings.js'
 
 /*
@@ -54,7 +54,7 @@ export class StripLight extends deviceBase {
   doStripLightUpdate!: Subject<void>
 
   constructor(
-    readonly platform: SwitchBotPlatform,
+    readonly platform: SwitchBotHAPPlatform,
     accessory: PlatformAccessory,
     device: device & devicesConfig,
   ) {

package/src/{device → devices-hap}/lock.ts

@@ -5,7 +5,7 @@
 import type { CharacteristicValue, PlatformAccessory, Service } from 'homebridge'
 import type { bodyChange, device, lockProServiceData, lockProStatus, lockProWebhookContext, lockServiceData, lockStatus, lockWebhookContext, SwitchBotBLE, SwitchbotDevice, WoSmartLock } from 'node-switchbot'
 
-import type { SwitchBotPlatform } from '../platform.js'
+import type { SwitchBotHAPPlatform } from '../platform-hap.js'
 import type { devicesConfig, lockConfig } from '../settings.js'
 
 /*
@@ -60,7 +60,7 @@ export class Lock extends deviceBase {
   doLockUpdate!: Subject<void>
 
   constructor(
-    readonly platform: SwitchBotPlatform,
+    readonly platform: SwitchBotHAPPlatform,
     accessory: PlatformAccessory,
     device: device & devicesConfig,
   ) {

package/src/{device → devices-hap}/meter.ts

@@ -5,7 +5,7 @@
 import type { CharacteristicValue, PlatformAccessory, Service } from 'homebridge'
 import type { device, meterServiceData, meterStatus, meterWebhookContext, SwitchBotBLE } from 'node-switchbot'
 
-import type { SwitchBotPlatform } from '../platform.js'
+import type { SwitchBotHAPPlatform } from '../platform-hap.js'
 import type { devicesConfig, meterConfig } from '../settings.js'
 
 import { Units } from 'homebridge'
@@ -54,7 +54,7 @@ export class Meter extends deviceBase {
   doMeterUpdate: Subject<void>
 
   constructor(
-    readonly platform: SwitchBotPlatform,
+    readonly platform: SwitchBotHAPPlatform,
     accessory: PlatformAccessory,
     device: device & devicesConfig,
   ) {

package/src/{device → devices-hap}/meterplus.ts

@@ -5,7 +5,7 @@
 import type { CharacteristicValue, PlatformAccessory, Service } from 'homebridge'
 import type { device, meterPlusServiceData, meterPlusStatus, meterPlusWebhookContext, SwitchBotBLE } from 'node-switchbot'
 
-import type { SwitchBotPlatform } from '../platform.js'
+import type { SwitchBotHAPPlatform } from '../platform-hap.js'
 import type { devicesConfig, meterConfig } from '../settings.js'
 
 import { Units } from 'homebridge'
@@ -59,7 +59,7 @@ export class MeterPlus extends deviceBase {
   doMeterUpdate: Subject<void>
 
   constructor(
-    readonly platform: SwitchBotPlatform,
+    readonly platform: SwitchBotHAPPlatform,
     accessory: PlatformAccessory,
     device: device & devicesConfig,
   ) {

package/src/{device → devices-hap}/meterpro.ts

@@ -5,7 +5,7 @@
 import type { CharacteristicValue, PlatformAccessory, Service } from 'homebridge'
 import type { device, meterProCO2ServiceData, meterProCO2Status, meterProCO2WebhookContext, meterProServiceData, meterProStatus, meterProWebhookContext, SwitchBotBLE } from 'node-switchbot'
 
-import type { SwitchBotPlatform } from '../platform.js'
+import type { SwitchBotHAPPlatform } from '../platform-hap.js'
 import type { devicesConfig, meterProConfig } from '../settings.js'
 
 import { Units } from 'homebridge'
@@ -66,7 +66,7 @@ export class MeterPro extends deviceBase {
   doMeterUpdate: Subject<void>
 
   constructor(
-    readonly platform: SwitchBotPlatform,
+    readonly platform: SwitchBotHAPPlatform,
     accessory: PlatformAccessory,
     device: device & devicesConfig,
   ) {
@@ -237,7 +237,6 @@ export class MeterPro extends deviceBase {
         ? this.hap.Characteristic.CarbonDioxideDetected.CO2_LEVELS_ABNORMAL
         : this.hap.Characteristic.CarbonDioxideDetected.CO2_LEVELS_NORMAL
       this.debugLog(`CarbonDioxideDetected: ${this.CarbonDioxideSensor.CarbonDioxideDetected}`)
-      this.warnLog('Carbon Dioxide Sensor is not supported yet.')
     }
     // Battery Info
     if ('battery' in this.serviceData) {
@@ -277,7 +276,6 @@ export class MeterPro extends deviceBase {
         ? this.hap.Characteristic.CarbonDioxideDetected.CO2_LEVELS_ABNORMAL
         : this.hap.Characteristic.CarbonDioxideDetected.CO2_LEVELS_NORMAL
       this.debugLog(`CarbonDioxideDetected: ${this.CarbonDioxideSensor.CarbonDioxideDetected}`)
-      this.warnLog('Carbon Dioxide Sensor is not supported yet.')
     }
 
     // Battery Info
@@ -338,7 +336,6 @@ export class MeterPro extends deviceBase {
         ? this.hap.Characteristic.CarbonDioxideDetected.CO2_LEVELS_ABNORMAL
         : this.hap.Characteristic.CarbonDioxideDetected.CO2_LEVELS_NORMAL
       this.debugLog(`CarbonDioxideDetected: ${this.CarbonDioxideSensor.CarbonDioxideDetected}`)
-      this.warnLog('Carbon Dioxide Sensor is not supported yet.')
     }
   }
 
@@ -469,6 +466,14 @@ export class MeterPro extends deviceBase {
     if (!(this.device as meterProConfig).hide_temperature && this.TemperatureSensor?.Service) {
       await this.updateCharacteristic(this.TemperatureSensor.Service, this.hap.Characteristic.CurrentTemperature, this.TemperatureSensor.CurrentTemperature, 'CurrentTemperature')
     }
+    // CarbonDioxideDetected
+    if (!(this.device as meterProConfig).hide_co2 && this.CarbonDioxideSensor?.Service && this.device.deviceType === 'MeterPro(CO2)') {
+      await this.updateCharacteristic(this.CarbonDioxideSensor.Service, this.hap.Characteristic.CarbonDioxideDetected, this.CarbonDioxideSensor.CarbonDioxideDetected, 'CarbonDioxideDetected')
+    }
+    // CarbonDioxideLevel
+    if (!(this.device as meterProConfig).hide_co2 && this.CarbonDioxideSensor?.Service && this.device.deviceType === 'MeterPro(CO2)') {
+      await this.updateCharacteristic(this.CarbonDioxideSensor.Service, this.hap.Characteristic.CarbonDioxideLevel, this.CarbonDioxideSensor.CarbonDioxideLevel, 'CarbonDioxideLevel')
+    }
     // BatteryLevel
     await this.updateCharacteristic(this.Battery.Service, this.hap.Characteristic.BatteryLevel, this.Battery.BatteryLevel, 'BatteryLevel')
     // StatusLowBattery
@@ -491,6 +496,10 @@ export class MeterPro extends deviceBase {
       if (!(this.device as meterProConfig).hide_temperature && this.TemperatureSensor?.Service) {
         this.TemperatureSensor.Service.updateCharacteristic(this.hap.Characteristic.CurrentTemperature, 30)
       }
+      if (!(this.device as meterProConfig).hide_co2 && this.CarbonDioxideSensor?.Service && this.device.deviceType === 'MeterPro(CO2)') {
+        this.CarbonDioxideSensor.Service.updateCharacteristic(this.hap.Characteristic.CarbonDioxideDetected, this.hap.Characteristic.CarbonDioxideDetected.CO2_LEVELS_NORMAL)
+        this.CarbonDioxideSensor.Service.updateCharacteristic(this.hap.Characteristic.CarbonDioxideLevel, 0)
+      }
       this.Battery.Service.updateCharacteristic(this.hap.Characteristic.BatteryLevel, 100)
       this.Battery.Service.updateCharacteristic(this.hap.Characteristic.StatusLowBattery, this.hap.Characteristic.StatusLowBattery.BATTERY_LEVEL_NORMAL)
     }
@@ -503,6 +512,10 @@ export class MeterPro extends deviceBase {
     if (!(this.device as meterProConfig).hide_temperature && this.TemperatureSensor?.Service) {
       this.TemperatureSensor.Service.updateCharacteristic(this.hap.Characteristic.CurrentTemperature, e)
     }
+    if (!(this.device as meterProConfig).hide_co2 && this.CarbonDioxideSensor?.Service && this.device.deviceType === 'MeterPro(CO2)') {
+      this.CarbonDioxideSensor.Service.updateCharacteristic(this.hap.Characteristic.CarbonDioxideDetected, e)
+      this.CarbonDioxideSensor.Service.updateCharacteristic(this.hap.Characteristic.CarbonDioxideLevel, e)
+    }
     this.Battery.Service.updateCharacteristic(this.hap.Characteristic.BatteryLevel, e)
     this.Battery.Service.updateCharacteristic(this.hap.Characteristic.StatusLowBattery, e)
   }

package/src/{device → devices-hap}/motion.ts

@@ -5,7 +5,7 @@
 import type { CharacteristicValue, PlatformAccessory, Service } from 'homebridge'
 import type { device, motionSensorServiceData, motionSensorStatus, motionSensorWebhookContext, SwitchBotBLE } from 'node-switchbot'
 
-import type { SwitchBotPlatform } from '../platform.js'
+import type { SwitchBotHAPPlatform } from '../platform-hap.js'
 import type { devicesConfig, motionConfig } from '../settings.js'
 
 /*
@@ -58,7 +58,7 @@ export class Motion extends deviceBase {
   doMotionUpdate!: Subject<void>
 
   constructor(
-    readonly platform: SwitchBotPlatform,
+    readonly platform: SwitchBotHAPPlatform,
     accessory: PlatformAccessory,
     device: device & devicesConfig,
   ) {

package/src/{device → devices-hap}/plug.ts

@@ -5,7 +5,7 @@
 import type { CharacteristicValue, PlatformAccessory, Service } from 'homebridge'
 import type { bodyChange, device, plugMiniJPServiceData, plugMiniJPWebhookContext, plugMiniStatus, plugMiniUSServiceData, plugMiniUSWebhookContext, plugStatus, plugWebhookContext, SwitchBotBLE, SwitchbotDevice, WoPlugMiniUS } from 'node-switchbot'
 
-import type { SwitchBotPlatform } from '../platform.js'
+import type { SwitchBotHAPPlatform } from '../platform-hap.js'
 import type { devicesConfig } from '../settings.js'
 
 /*
@@ -40,7 +40,7 @@ export class Plug extends deviceBase {
   doPlugUpdate!: Subject<void>
 
   constructor(
-    readonly platform: SwitchBotPlatform,
+    readonly platform: SwitchBotHAPPlatform,
     accessory: PlatformAccessory,
     device: device & devicesConfig,
   ) {

package/src/{device → devices-hap}/relayswitch.ts

@@ -5,7 +5,7 @@
 import type { CharacteristicValue, PlatformAccessory, Service } from 'homebridge'
 import type { bodyChange, device, relaySwitch1Context, relaySwitch1PMContext, relaySwitch1PMServiceData, relaySwitch1PMStatus, relaySwitch1ServiceData, relaySwitch1Status, SwitchBotBLE, SwitchbotDevice, WoRelaySwitch1, WoRelaySwitch1PM } from 'node-switchbot'
 
-import type { SwitchBotPlatform } from '../platform.js'
+import type { SwitchBotHAPPlatform } from '../platform-hap.js'
 import type { devicesConfig, relaySwitch1Config, relaySwitch1PMConfig } from '../settings.js'
 
 /*
@@ -107,7 +107,7 @@ export class RelaySwitch extends deviceBase {
    * @constructor
    */
   constructor(
-    readonly platform: SwitchBotPlatform,
+    readonly platform: SwitchBotHAPPlatform,
     accessory: PlatformAccessory,
     device: device & devicesConfig,
   ) {

package/src/{device → devices-hap}/robotvacuumcleaner.ts

@@ -5,7 +5,7 @@
 import type { CharacteristicValue, PlatformAccessory, Service } from 'homebridge'
 import type { bodyChange, device, floorCleaningRobotS10Status, floorCleaningRobotS10WebhookContext, robotVacuumCleanerS1PlusStatus, robotVacuumCleanerS1PlusWebhookContext, robotVacuumCleanerS1Status, robotVacuumCleanerS1WebhookContext, robotVacuumCleanerServiceData, SwitchBotBLE, SwitchbotDevice } from 'node-switchbot'
 
-import type { SwitchBotPlatform } from '../platform.js'
+import type { SwitchBotHAPPlatform } from '../platform-hap.js'
 import type { devicesConfig } from '../settings.js'
 
 /*
@@ -49,7 +49,7 @@ export class RobotVacuumCleaner extends deviceBase {
   doRobotVacuumCleanerUpdate!: Subject<void>
 
   constructor(
-    readonly platform: SwitchBotPlatform,
+    readonly platform: SwitchBotHAPPlatform,
     accessory: PlatformAccessory,
     device: device & devicesConfig,
   ) {

package/src/{device → devices-hap}/waterdetector.ts

@@ -5,7 +5,7 @@
 import type { CharacteristicValue, PlatformAccessory, Service } from 'homebridge'
 import type { device, SwitchBotBLE, waterLeakDetectorServiceData, waterLeakDetectorStatus, waterLeakDetectorWebhookContext } from 'node-switchbot'
 
-import type { SwitchBotPlatform } from '../platform.js'
+import type { SwitchBotHAPPlatform } from '../platform-hap.js'
 import type { devicesConfig, waterDetectorConfig } from '../settings.js'
 
 /*
@@ -54,7 +54,7 @@ export class WaterDetector extends deviceBase {
   doWaterDetectorUpdate: Subject<void>
 
   constructor(
-    readonly platform: SwitchBotPlatform,
+    readonly platform: SwitchBotHAPPlatform,
     accessory: PlatformAccessory,
     device: device & devicesConfig,
   ) {

package/src/devices-matter/BaseMatterAccessory.ts

@@ -0,0 +1,131 @@
+/**
+ * Base Matter Accessory Class
+ *
+ * This base class implements the MatterAccessory interface and provides
+ * common functionality that all Matter devices can use.
+ *
+ * Individual device types should extend this class and call super() with
+ * the required configuration.
+ */
+
+import type { API, EndpointType, Logger, MatterAccessory } from 'homebridge'
+
+export interface BaseMatterAccessoryConfig {
+  uuid: string
+  displayName: string
+  deviceType: EndpointType
+  serialNumber: string
+  manufacturer: string
+  model: string
+  firmwareRevision: string
+  hardwareRevision: string
+  context?: Record<string, unknown>
+  clusters?: MatterAccessory['clusters']
+  handlers?: MatterAccessory['handlers']
+  parts?: MatterAccessory['parts']
+}
+
+/**
+ * Base class for all Matter accessories
+ * Implements the MatterAccessory interface and provides common methods
+ */
+export abstract class BaseMatterAccessory implements MatterAccessory {
+  // Required MatterAccessory properties
+  public readonly uuid: string
+  public readonly displayName: string
+  public readonly deviceType: EndpointType
+  public readonly serialNumber: string
+  public readonly manufacturer: string
+  public readonly model: string
+  public readonly firmwareRevision: string
+  public readonly hardwareRevision: string
+  public readonly context: Record<string, unknown>
+  public readonly clusters?: MatterAccessory['clusters']
+  public readonly handlers?: MatterAccessory['handlers']
+  public readonly parts?: MatterAccessory['parts']
+
+  // Protected properties available to child classes
+  protected readonly api: API
+  protected readonly log: Logger
+
+  constructor(
+    api: API,
+    log: Logger,
+    config: BaseMatterAccessoryConfig,
+  ) {
+    this.api = api
+    this.log = log
+
+    // Set all required properties
+    this.uuid = config.uuid
+    this.displayName = config.displayName
+    this.deviceType = config.deviceType
+    this.serialNumber = config.serialNumber
+    this.manufacturer = config.manufacturer
+    this.model = config.model
+    this.firmwareRevision = config.firmwareRevision
+    this.hardwareRevision = config.hardwareRevision
+    this.clusters = config.clusters
+    this.handlers = config.handlers
+    this.parts = config.parts
+
+    // Set context with all metadata
+    this.context = {
+      serialNumber: this.serialNumber,
+      manufacturer: this.manufacturer,
+      model: this.model,
+      firmwareRevision: this.firmwareRevision,
+      hardwareRevision: this.hardwareRevision,
+      ...config.context,
+    }
+  }
+
+  /**
+   * Update the accessory state
+   * Helper method to update cluster attributes
+   */
+  protected async updateState(cluster: string, attributes: Record<string, unknown>): Promise<void> {
+    await this.api.matter.updateAccessoryState(this.uuid, cluster, attributes)
+    this.log.debug(`[${this.displayName}] Updated ${cluster} state:`, attributes)
+  }
+
+  /**
+   * Log helper methods
+   */
+  protected logInfo(message: string, ...args: unknown[]): void {
+    this.log.info(`[${this.displayName}] ${message}`, ...args)
+  }
+
+  protected logError(message: string, ...args: unknown[]): void {
+    this.log.error(`[${this.displayName}] ${message}`, ...args)
+  }
+
+  protected logDebug(message: string, ...args: unknown[]): void {
+    this.log.debug(`[${this.displayName}] ${message}`, ...args)
+  }
+
+  protected logWarn(message: string, ...args: unknown[]): void {
+    this.log.warn(`[${this.displayName}] ${message}`, ...args)
+  }
+
+  /**
+   * Convert this class instance to a plain MatterAccessory object
+   * This is what gets registered with Homebridge
+   */
+  public toAccessory(): MatterAccessory {
+    return {
+      uuid: this.uuid,
+      displayName: this.displayName,
+      deviceType: this.deviceType,
+      serialNumber: this.serialNumber,
+      manufacturer: this.manufacturer,
+      model: this.model,
+      firmwareRevision: this.firmwareRevision,
+      hardwareRevision: this.hardwareRevision,
+      context: this.context,
+      clusters: this.clusters,
+      handlers: this.handlers,
+      parts: this.parts,
+    }
+  }
+}

package/src/devices-matter/ColorLightAccessory.ts

@@ -0,0 +1,113 @@
+/**
+ * Color Light Accessory Class (HS only)
+ * Hue and Saturation color control
+ */
+
+import type { API, Logger, MatterRequests } from 'homebridge'
+
+import { BaseMatterAccessory } from './BaseMatterAccessory.js'
+
+export class ColorLightAccessory extends BaseMatterAccessory {
+  constructor(api: API, log: Logger) {
+    const serialNumber = 'LIGHT-004'
+    super(api, log, {
+      uuid: api.matter.uuid.generate(serialNumber),
+      displayName: 'Colour Light (HS)',
+      deviceType: api.matter.deviceTypes.ExtendedColorLight,
+      serialNumber,
+      manufacturer: 'Homebridge Matter',
+      model: 'HB-MATTER-LIGHT-COLOUR-HS',
+      firmwareRevision: '2.0.0',
+      hardwareRevision: '1.0.0',
+
+      clusters: {
+        onOff: { onOff: false },
+        levelControl: {
+          currentLevel: 127,
+          minLevel: 1,
+          maxLevel: 254,
+        },
+        colorControl: {
+          colorMode: api.matter.types.ColorControl.ColorMode.CurrentHueAndCurrentSaturation,
+          currentHue: 0,
+          currentSaturation: 254,
+          currentX: 41942,
+          currentY: 21626,
+        },
+      },
+
+      handlers: {
+        onOff: {
+          on: async () => this.handleOn(),
+          off: async () => this.handleOff(),
+        },
+        levelControl: {
+          moveToLevelWithOnOff: async (request: MatterRequests.MoveToLevel) =>
+            this.handleSetLevel(request),
+        },
+        colorControl: {
+          moveToColorLogic: async (request: MatterRequests.MoveToColor) =>
+            this.handleSetColor(request),
+          moveToHueAndSaturationLogic: async (request: MatterRequests.MoveToHueAndSaturation) =>
+            this.handleSetHueSaturation(request),
+        },
+      },
+    })
+
+    this.logInfo('initialized.')
+  }
+
+  private async handleOn(): Promise<void> {
+    this.logInfo('turning on.')
+    // TODO: await myLightAPI.turnOn()
+  }
+
+  private async handleOff(): Promise<void> {
+    this.logInfo('turning off.')
+    // TODO: await myLightAPI.turnOff()
+  }
+
+  private async handleSetLevel(request: MatterRequests.MoveToLevel): Promise<void> {
+    this.logInfo(`MoveToLevel request: ${JSON.stringify(request)}`)
+    const { level } = request
+    const brightnessPercent = Math.round((level / 254) * 100)
+    this.logInfo(`setting brightness to ${brightnessPercent}%.`)
+    // TODO: await myLightAPI.setBrightness(brightnessPercent)
+  }
+
+  private async handleSetColor(request: MatterRequests.MoveToColor): Promise<void> {
+    this.logInfo(`MoveToColor request: ${JSON.stringify(request)}`)
+    const { colorX, colorY, transitionTime } = request
+    const xFloat = (colorX / 65535).toFixed(4)
+    const yFloat = (colorY / 65535).toFixed(4)
+    this.logInfo(`setting xy color to (${xFloat}, ${yFloat}) with transition ${transitionTime}.`)
+    // TODO: await myLightAPI.setXY(xFloat, yFloat, transitionTime)
+  }
+
+  private async handleSetHueSaturation(request: MatterRequests.MoveToHueAndSaturation): Promise<void> {
+    this.logInfo(`MoveToHueAndSaturation request: ${JSON.stringify(request)}`)
+    const { hue, saturation, transitionTime } = request
+    const hueDegrees = Math.round((hue / 254) * 360)
+    const saturationPercent = Math.round((saturation / 254) * 100)
+    this.logInfo(`setting color to ${hueDegrees}°, ${saturationPercent}% with transition ${transitionTime}.`)
+    // TODO: await myLightAPI.setColor(hueDegrees, saturationPercent, transitionTime)
+  }
+
+  public updateOnOffState(isOn: boolean): void {
+    this.updateState(this.api.matter.clusterNames.OnOff, { onOff: isOn })
+  }
+
+  public updateBrightness(percent: number): void {
+    const matterLevel = Math.max(1, Math.round((percent / 100) * 254))
+    this.updateState(this.api.matter.clusterNames.LevelControl, { currentLevel: matterLevel })
+  }
+
+  public updateHueSaturation(hue: number, saturation: number): void {
+    const matterHue = Math.round((hue / 360) * 254)
+    const matterSat = Math.round((saturation / 100) * 254)
+    this.updateState(this.api.matter.clusterNames.ColorControl, {
+      currentHue: matterHue,
+      currentSaturation: matterSat,
+    })
+  }
+}

package/src/devices-matter/ColorTemperatureLightAccessory.ts

@@ -0,0 +1,98 @@
+/**
+ * Color Temperature Light Accessory Class
+ */
+
+import type { API, Logger, MatterRequests } from 'homebridge'
+
+import { BaseMatterAccessory } from './BaseMatterAccessory.js'
+
+export class ColorTemperatureLightAccessory extends BaseMatterAccessory {
+  constructor(api: API, log: Logger) {
+    const serialNumber = 'LIGHT-003'
+    super(api, log, {
+      uuid: api.matter.uuid.generate(serialNumber),
+      displayName: 'Colour Temperature Light',
+      deviceType: api.matter.deviceTypes.ColorTemperatureLight,
+      serialNumber,
+      manufacturer: 'Homebridge Matter',
+      model: 'HB-MATTER-LIGHT-COLOUR-TEMP',
+      firmwareRevision: '2.0.0',
+      hardwareRevision: '1.0.0',
+
+      clusters: {
+        onOff: {
+          onOff: false,
+        },
+        levelControl: {
+          currentLevel: 127,
+          minLevel: 1,
+          maxLevel: 254,
+        },
+        colorControl: {
+          colorMode: api.matter.types.ColorControl.ColorMode.ColorTemperatureMireds,
+          colorTemperatureMireds: 250,
+          colorTempPhysicalMinMireds: 147,
+          colorTempPhysicalMaxMireds: 454,
+          coupleColorTempToLevelMinMireds: 147,
+        },
+      },
+
+      handlers: {
+        onOff: {
+          on: async () => this.handleOn(),
+          off: async () => this.handleOff(),
+        },
+        levelControl: {
+          moveToLevelWithOnOff: async (request: MatterRequests.MoveToLevel) =>
+            this.handleSetLevel(request),
+        },
+        colorControl: {
+          moveToColorTemperatureLogic: async (request: MatterRequests.MoveToColorTemperature) =>
+            this.handleSetColorTemperature(request),
+        },
+      },
+    })
+
+    this.logInfo('initialized.')
+  }
+
+  private async handleOn(): Promise<void> {
+    this.logInfo('turning on.')
+    // TODO: await myLightAPI.turnOn()
+  }
+
+  private async handleOff(): Promise<void> {
+    this.logInfo('turning off.')
+    // TODO: await myLightAPI.turnOff()
+  }
+
+  private async handleSetLevel(request: MatterRequests.MoveToLevel): Promise<void> {
+    this.logInfo(`MoveToLevel request: ${JSON.stringify(request)}`)
+    const { level } = request
+    const brightnessPercent = Math.round((level / 254) * 100)
+    this.logInfo(`setting brightness to ${brightnessPercent}% (level: ${level}).`)
+    // TODO: await myLightAPI.setBrightness(brightnessPercent)
+  }
+
+  private async handleSetColorTemperature(request: MatterRequests.MoveToColorTemperature): Promise<void> {
+    this.logInfo(`MoveToColorTemperature request: ${JSON.stringify(request)}`)
+    const { colorTemperatureMireds, transitionTime } = request
+    const kelvin = Math.round(1000000 / colorTemperatureMireds)
+    this.logInfo(`setting color temp to ${kelvin}k (${colorTemperatureMireds} mireds) with transitionTime=${transitionTime}.`)
+    // TODO: await myLightAPI.setColorTemperature(kelvin, transitionTime)
+  }
+
+  public updateOnOffState(isOn: boolean): void {
+    this.updateState(this.api.matter.clusterNames.OnOff, { onOff: isOn })
+  }
+
+  public updateBrightness(percent: number): void {
+    const matterLevel = Math.max(1, Math.round((percent / 100) * 254))
+    this.updateState(this.api.matter.clusterNames.LevelControl, { currentLevel: matterLevel })
+  }
+
+  public updateColorTemperature(kelvin: number): void {
+    const mireds = Math.round(1000000 / kelvin)
+    this.updateState(this.api.matter.clusterNames.ColorControl, { colorTemperatureMireds: mireds })
+  }
+}

package/src/devices-matter/ContactSensorAccessory.ts

@@ -0,0 +1,37 @@
+/**
+ * Contact Sensor Accessory Class
+ */
+
+import type { API, Logger } from 'homebridge'
+
+import { BaseMatterAccessory } from './BaseMatterAccessory.js'
+
+export class ContactSensorAccessory extends BaseMatterAccessory {
+  constructor(api: API, log: Logger) {
+    const serialNumber = 'SENSOR-001'
+    super(api, log, {
+      uuid: api.matter.uuid.generate(serialNumber),
+      displayName: 'Contact Sensor',
+      deviceType: api.matter.deviceTypes.ContactSensor,
+      serialNumber,
+      manufacturer: 'Homebridge Matter',
+      model: 'HB-MATTER-SENSOR-CONTACT',
+      firmwareRevision: '2.0.0',
+      hardwareRevision: '1.0.0',
+
+      clusters: {
+        booleanState: {
+          stateValue: true, // matter: true = closed/normal, false = open/triggered
+        },
+      },
+    })
+
+    this.logInfo('initialized.')
+  }
+
+  public updateContactState(isOpen: boolean): void {
+    // Matter BooleanState: false = open/triggered, true = closed/normal (inverted!)
+    this.updateState(this.api.matter.clusterNames.BooleanState, { stateValue: !isOpen })
+    this.logInfo(`contact state: ${isOpen ? 'OPEN' : 'CLOSED'}.`)
+  }
+}