matterbridge-example-dynamic-platform 1.2.2 → 1.2.3-rc.1

package/CHANGELOG.md

@@ -8,10 +8,26 @@ If you like this project and find it useful, please consider giving it a star on
   <img src="bmc-button.svg" alt="Buy me a coffee" width="120">
 </a>
 
-## [1.2.2] - 2025-05-19
+## [1.2.3] - 2025-05-25
+
+### Added
+
+- [platform]: Added a cover device with both lift and tilt (supported by the Home app).
 
 ### Changed
 
+- [package]: Require matterbridge 3.0.4.
+- [package]: Updated package.
+- [package]: Updated dependencies.
+
+<a href="https://www.buymeacoffee.com/luligugithub">
+  <img src="bmc-button.svg" alt="Buy me a coffee" width="80">
+</a>
+
+## [1.2.2] - 2025-05-19
+
+### Added
+
 - [package]: Added waterHeater device type (not supported by Alexa and Apple Home)
 
 ### Changed

package/README.md

@@ -16,7 +16,7 @@
 
 Matterbridge dynamic platform example plugin is a template to develop your own plugin using the dynamic platform.
 
-It exposes 38 devices:
+It exposes 40 virtual devices:
 
 - a switch with onOff cluster
 - a light with onOff
@@ -26,7 +26,8 @@ It exposes 38 devices:
 - a light with onOff, levelControl and colorControl (with XY and CT) clusters
 - a light with onOff, levelControl and colorControl (with CT only) clusters
 - an outlet (plug) with onOff cluster
-- a cover with windowCovering cluster
+- a cover with windowCovering cluster and lift feature
+- a cover with windowCovering cluster and both lift and tilt features
 - a lock with doorLock cluster
 - a thermo autoMode (i.e. with Auto Heat and Cool features) with thermostat cluster and 3 sub endpoints with flowMeasurement cluster, temperatureMeasurement cluster
   and relativeHumidityMeasurement cluster (to show how to create a composed device with sub endpoints)

package/dist/appliances.js

@@ -1,7 +1,7 @@
 import { MatterbridgeEndpoint, MatterbridgeServer, MatterbridgeOnOffServer, laundryWasher, laundryDryer, dishwasher, refrigerator, temperatureControlledCabinetCooler, oven, temperatureControlledCabinetHeater, microwaveOven, extractorHood, cooktop, cookSurface, powerSource, } from 'matterbridge';
-import { ClusterBehavior, PositionTag, RefrigeratorTag } from 'matterbridge/matter';
-import { OperationalState, TemperatureControl, DishwasherMode, LaundryWasherControls, LaundryWasherMode, LaundryDryerControls, OvenMode, ModeBase, RefrigeratorAndTemperatureControlledCabinetMode, MicrowaveOvenMode, MicrowaveOvenControl, OvenCavityOperationalState, } from 'matterbridge/matter/clusters';
-import { DishwasherAlarmServer, LaundryDryerControlsServer, LaundryWasherControlsServer, MicrowaveOvenControlBehavior, MicrowaveOvenModeServer, TemperatureControlBehavior, } from 'matterbridge/matter/behaviors';
+import { PositionTag, RefrigeratorTag } from 'matterbridge/matter';
+import { OperationalState, TemperatureControl, DishwasherMode, LaundryWasherControls, LaundryWasherMode, LaundryDryerControls, OvenMode, ModeBase, RefrigeratorAndTemperatureControlledCabinetMode, MicrowaveOvenMode, MicrowaveOvenControl, } from 'matterbridge/matter/clusters';
+import { DishwasherAlarmServer, DishwasherModeBehavior, LaundryDryerControlsServer, LaundryWasherControlsServer, LaundryWasherModeBehavior, MicrowaveOvenControlBehavior, MicrowaveOvenModeServer, OvenCavityOperationalStateBehavior, OvenModeBehavior, RefrigeratorAndTemperatureControlledCabinetModeBehavior, TemperatureControlBehavior, } from 'matterbridge/matter/behaviors';
 export class Appliances extends MatterbridgeEndpoint {
     constructor(deviceType, name, serial) {
         super([deviceType, powerSource], { uniqueStorageKey: `${name}-${serial}` }, true);
@@ -112,7 +112,7 @@ export class Appliances extends MatterbridgeEndpoint {
         }
     }
     createDefaultOvenCavityOperationalStateClusterServer(operationalState = OperationalState.OperationalStateEnum.Stopped) {
-        this.behaviors.require(OvenCavityOperationalStateServer, {
+        this.behaviors.require(MatterbridgeOvenCavityOperationalStateServer, {
             phaseList: [],
             currentPhase: null,
             operationalStateList: [
@@ -126,7 +126,7 @@ export class Appliances extends MatterbridgeEndpoint {
         return this;
     }
     static createDefaultRefrigeratorAndTemperatureControlledCabinetModeClusterServer(endpoint, currentMode) {
-        endpoint.behaviors.require(RefrigeratorAndTemperatureControlledCabinetModeServer, {
+        endpoint.behaviors.require(MatterbridgeRefrigeratorAndTemperatureControlledCabinetModeServer, {
             supportedModes: [
                 { label: 'Auto', mode: 0, modeTags: [{ value: RefrigeratorAndTemperatureControlledCabinetMode.ModeTag.Auto }] },
                 { label: 'RapidCool', mode: 1, modeTags: [{ value: RefrigeratorAndTemperatureControlledCabinetMode.ModeTag.RapidCool }] },
@@ -137,7 +137,7 @@ export class Appliances extends MatterbridgeEndpoint {
         return endpoint;
     }
     static createDefaultOvenModeClusterServer(endpoint, currentMode) {
-        endpoint.behaviors.require(OvenModeServer, {
+        endpoint.behaviors.require(MatterbridgeOvenModeServer, {
             supportedModes: [
                 { label: 'Bake', mode: 1, modeTags: [{ value: OvenMode.ModeTag.Bake }] },
                 { label: 'Convection', mode: 2, modeTags: [{ value: OvenMode.ModeTag.Convection }] },
@@ -155,7 +155,7 @@ export class Appliances extends MatterbridgeEndpoint {
         return endpoint;
     }
     createDefaultDishwasherModeClusterServer(currentMode) {
-        this.behaviors.require(DishwasherModeServer, {
+        this.behaviors.require(MatterbridgeDishwasherModeServer, {
             supportedModes: [
                 { label: 'Light', mode: 1, modeTags: [{ value: DishwasherMode.ModeTag.Light }] },
                 { label: 'Normal', mode: 2, modeTags: [{ value: DishwasherMode.ModeTag.Normal }] },
@@ -166,7 +166,7 @@ export class Appliances extends MatterbridgeEndpoint {
         return this;
     }
     createDefaultLaundryWasherModeClusterServer(currentMode) {
-        this.behaviors.require(LaundryWasherModeServer, {
+        this.behaviors.require(MatterbridgeLaundryWasherModeServer, {
             supportedModes: [
                 { label: 'Delicate', mode: 1, modeTags: [{ value: LaundryWasherMode.ModeTag.Delicate }] },
                 { label: 'Normal', mode: 2, modeTags: [{ value: LaundryWasherMode.ModeTag.Normal }] },
@@ -350,8 +350,7 @@ class MatterbridgeMicrowaveOvenControlServer extends MicrowaveOvenControlBehavio
         }
     }
 }
-export const OvenCavityOperationalStateBehavior = ClusterBehavior.withInterface().for(OvenCavityOperationalState.Cluster);
-export class OvenCavityOperationalStateServer extends OvenCavityOperationalStateBehavior {
+export class MatterbridgeOvenCavityOperationalStateServer extends OvenCavityOperationalStateBehavior {
     initialize() {
         const device = this.endpoint.stateOf(MatterbridgeServer).deviceCommand;
         device.log.info('OvenCavityOperationalStateServer initialized: setting operational state to Stopped and operational error to No error');
@@ -377,8 +376,7 @@ export class OvenCavityOperationalStateServer extends OvenCavityOperationalState
         };
     }
 }
-export const RefrigeratorAndTemperatureControlledCabinetModeBehavior = ClusterBehavior.withInterface().for(RefrigeratorAndTemperatureControlledCabinetMode.Cluster);
-class RefrigeratorAndTemperatureControlledCabinetModeServer extends RefrigeratorAndTemperatureControlledCabinetModeBehavior {
+class MatterbridgeRefrigeratorAndTemperatureControlledCabinetModeServer extends RefrigeratorAndTemperatureControlledCabinetModeBehavior {
     initialize() {
         const device = this.endpoint.stateOf(MatterbridgeServer).deviceCommand;
         device.log.info('MatterbridgeRefrigeratorAndTemperatureControlledCabinetModeServer initialized: setting currentMode to 1');
@@ -398,8 +396,7 @@ class RefrigeratorAndTemperatureControlledCabinetModeServer extends Refrigerator
         }
     }
 }
-export const OvenModeBehavior = ClusterBehavior.withInterface().for(OvenMode.Cluster);
-class OvenModeServer extends OvenModeBehavior {
+class MatterbridgeOvenModeServer extends OvenModeBehavior {
     initialize() {
         const device = this.endpoint.stateOf(MatterbridgeServer).deviceCommand;
         device.log.info('OvenModeServer initialized: setting currentMode to 3');
@@ -419,8 +416,7 @@ class OvenModeServer extends OvenModeBehavior {
         }
     }
 }
-export const DishwasherModeBehavior = ClusterBehavior.withInterface().for(DishwasherMode.Cluster);
-class DishwasherModeServer extends DishwasherModeBehavior {
+class MatterbridgeDishwasherModeServer extends DishwasherModeBehavior {
     initialize() {
         const device = this.endpoint.stateOf(MatterbridgeServer).deviceCommand;
         device.log.info('DishwasherModeServer initialized: setting currentMode to 3');
@@ -448,8 +444,7 @@ class DishwasherModeServer extends DishwasherModeBehavior {
         }
     }
 }
-export const LaundryWasherModeBehavior = ClusterBehavior.withInterface().for(LaundryWasherMode.Cluster);
-class LaundryWasherModeServer extends LaundryWasherModeBehavior {
+class MatterbridgeLaundryWasherModeServer extends LaundryWasherModeBehavior {
     initialize() {
         const device = this.endpoint.stateOf(MatterbridgeServer).deviceCommand;
         device.log.info('LaundryWasherModeServer initialized: setting currentMode to 3');

package/dist/platform.js

@@ -14,7 +14,8 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
     lightHS;
     lightCT;
     outlet;
-    cover;
+    coverLift;
+    coverLiftTilt;
     lock;
     thermoAuto;
     thermoHeat;
@@ -57,8 +58,8 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
     fanModeLookup = ['Off', 'Low', 'Medium', 'High', 'On', 'Auto', 'Smart'];
     constructor(matterbridge, log, config) {
         super(matterbridge, log, config);
-        if (this.verifyMatterbridgeVersion === undefined || typeof this.verifyMatterbridgeVersion !== 'function' || !this.verifyMatterbridgeVersion('3.0.3')) {
-            throw new Error(`This plugin requires Matterbridge version >= "3.0.3". Please update Matterbridge from ${this.matterbridge.matterbridgeVersion} to the latest version in the frontend.`);
+        if (this.verifyMatterbridgeVersion === undefined || typeof this.verifyMatterbridgeVersion !== 'function' || !this.verifyMatterbridgeVersion('3.0.4')) {
+            throw new Error(`This plugin requires Matterbridge version >= "3.0.4". Please update Matterbridge from ${this.matterbridge.matterbridgeVersion} to the latest version in the frontend.`);
         }
         this.log.info('Initializing platform:', this.config.name);
         if (config.whiteList === undefined)
@@ -432,41 +433,76 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             await this.outlet?.setAttribute(OnOff.Cluster.id, 'onOff', false, this.outlet?.log);
             this.outlet?.log.info('Command off called');
         });
-        this.cover = new MatterbridgeEndpoint([coverDevice, bridgedNode, powerSource], { uniqueStorageKey: 'Cover' }, this.config.debug)
+        this.coverLift = new MatterbridgeEndpoint([coverDevice, bridgedNode, powerSource], { uniqueStorageKey: 'CoverLift' }, this.config.debug)
             .createDefaultIdentifyClusterServer()
             .createDefaultGroupsClusterServer()
-            .createDefaultBridgedDeviceBasicInformationClusterServer('Cover', '0x01020564', 0xfff1, 'Matterbridge', 'Matterbridge Cover', parseInt(this.version.replace(/\D/g, '')), this.version === '' ? 'Unknown' : this.version, parseInt(this.matterbridge.matterbridgeVersion.replace(/\D/g, '')), this.matterbridge.matterbridgeVersion)
+            .createDefaultBridgedDeviceBasicInformationClusterServer('Cover lift', 'CL01020564', 0xfff1, 'Matterbridge', 'Matterbridge Cover', parseInt(this.version.replace(/\D/g, '')), this.version === '' ? 'Unknown' : this.version, parseInt(this.matterbridge.matterbridgeVersion.replace(/\D/g, '')), this.matterbridge.matterbridgeVersion)
             .createDefaultWindowCoveringClusterServer()
             .createDefaultPowerSourceRechargeableBatteryClusterServer(86);
-        this.setSelectDevice(this.cover.serialNumber ?? '', this.cover.deviceName ?? '', undefined, 'hub');
-        if (this.validateDevice(this.cover.deviceName ?? '')) {
-            await this.registerDevice(this.cover);
-            this.bridgedDevices.set(this.cover.deviceName ?? '', this.cover);
+        this.setSelectDevice(this.coverLift.serialNumber ?? '', this.coverLift.deviceName ?? '', undefined, 'hub');
+        if (this.validateDevice(this.coverLift.deviceName ?? '')) {
+            await this.registerDevice(this.coverLift);
+            this.bridgedDevices.set(this.coverLift.deviceName ?? '', this.coverLift);
         }
         else {
-            this.cover = undefined;
+            this.coverLift = undefined;
         }
-        this.cover?.subscribeAttribute(WindowCovering.Cluster.id, 'mode', (newValue, oldValue) => {
-            this.cover?.log.info(`Attribute mode changed from ${oldValue} to ${newValue}. Reverse: ${newValue.motorDirectionReversed}. Calibration: ${newValue.calibrationMode}. Maintenance: ${newValue.maintenanceMode}. LED: ${newValue.ledFeedback}`);
-        }, this.cover.log);
-        this.cover?.addCommandHandler('identify', async ({ request: { identifyTime } }) => {
-            this.cover?.log.info(`Command identify called identifyTime:${identifyTime}`);
+        this.coverLift?.addCommandHandler('identify', async ({ request: { identifyTime } }) => {
+            this.coverLift?.log.info(`Command identify called identifyTime:${identifyTime}`);
         });
-        this.cover?.addCommandHandler('stopMotion', async () => {
-            await this.cover?.setWindowCoveringTargetAsCurrentAndStopped();
-            this.cover?.log.info(`Command stopMotion called`);
+        this.coverLift?.addCommandHandler('stopMotion', async () => {
+            await this.coverLift?.setWindowCoveringTargetAsCurrentAndStopped();
+            this.coverLift?.log.info(`Command stopMotion called`);
         });
-        this.cover?.addCommandHandler('downOrClose', async () => {
-            await this.cover?.setWindowCoveringCurrentTargetStatus(10000, 10000, WindowCovering.MovementStatus.Stopped);
-            this.cover?.log.info(`Command downOrClose called`);
+        this.coverLift?.addCommandHandler('downOrClose', async () => {
+            await this.coverLift?.setWindowCoveringCurrentTargetStatus(10000, 10000, WindowCovering.MovementStatus.Stopped);
+            this.coverLift?.log.info(`Command downOrClose called`);
         });
-        this.cover?.addCommandHandler('upOrOpen', async () => {
-            await this.cover?.setWindowCoveringCurrentTargetStatus(0, 0, WindowCovering.MovementStatus.Stopped);
-            this.cover?.log.info(`Command upOrOpen called`);
+        this.coverLift?.addCommandHandler('upOrOpen', async () => {
+            await this.coverLift?.setWindowCoveringCurrentTargetStatus(0, 0, WindowCovering.MovementStatus.Stopped);
+            this.coverLift?.log.info(`Command upOrOpen called`);
         });
-        this.cover?.addCommandHandler('goToLiftPercentage', async ({ request: { liftPercent100thsValue } }) => {
-            await this.cover?.setWindowCoveringCurrentTargetStatus(liftPercent100thsValue, liftPercent100thsValue, WindowCovering.MovementStatus.Stopped);
-            this.cover?.log.info(`Command goToLiftPercentage ${liftPercent100thsValue} called`);
+        this.coverLift?.addCommandHandler('goToLiftPercentage', async ({ request: { liftPercent100thsValue } }) => {
+            await this.coverLift?.setWindowCoveringCurrentTargetStatus(liftPercent100thsValue, liftPercent100thsValue, WindowCovering.MovementStatus.Stopped);
+            this.coverLift?.log.info(`Command goToLiftPercentage ${liftPercent100thsValue} called`);
+        });
+        this.coverLiftTilt = new MatterbridgeEndpoint([coverDevice, bridgedNode, powerSource], { uniqueStorageKey: 'CoverLiftTilt' }, this.config.debug)
+            .createDefaultIdentifyClusterServer()
+            .createDefaultGroupsClusterServer()
+            .createDefaultBridgedDeviceBasicInformationClusterServer('Cover lift and tilt', 'CLT01020554', 0xfff1, 'Matterbridge', 'Matterbridge Cover', parseInt(this.version.replace(/\D/g, '')), this.version === '' ? 'Unknown' : this.version, parseInt(this.matterbridge.matterbridgeVersion.replace(/\D/g, '')), this.matterbridge.matterbridgeVersion)
+            .createDefaultLiftTiltWindowCoveringClusterServer()
+            .createDefaultPowerSourceRechargeableBatteryClusterServer(86);
+        this.setSelectDevice(this.coverLiftTilt.serialNumber ?? '', this.coverLiftTilt.deviceName ?? '', undefined, 'hub');
+        if (this.validateDevice(this.coverLiftTilt.deviceName ?? '')) {
+            await this.registerDevice(this.coverLiftTilt);
+            this.bridgedDevices.set(this.coverLiftTilt.deviceName ?? '', this.coverLiftTilt);
+        }
+        else {
+            this.coverLiftTilt = undefined;
+        }
+        this.coverLiftTilt?.addCommandHandler('identify', async ({ request: { identifyTime } }) => {
+            this.coverLiftTilt?.log.info(`Command identify called identifyTime:${identifyTime}`);
+        });
+        this.coverLiftTilt?.addCommandHandler('stopMotion', async () => {
+            await this.coverLiftTilt?.setWindowCoveringTargetAsCurrentAndStopped();
+            this.coverLiftTilt?.log.info(`Command stopMotion called`);
+        });
+        this.coverLiftTilt?.addCommandHandler('downOrClose', async () => {
+            await this.coverLiftTilt?.setWindowCoveringCurrentTargetStatus(10000, 10000, WindowCovering.MovementStatus.Stopped);
+            this.coverLiftTilt?.log.info(`Command downOrClose called`);
+        });
+        this.coverLiftTilt?.addCommandHandler('upOrOpen', async () => {
+            await this.coverLiftTilt?.setWindowCoveringCurrentTargetStatus(0, 0, WindowCovering.MovementStatus.Stopped);
+            this.coverLiftTilt?.log.info(`Command upOrOpen called`);
+        });
+        this.coverLiftTilt?.addCommandHandler('goToLiftPercentage', async ({ request: { liftPercent100thsValue } }) => {
+            await this.coverLiftTilt?.setWindowCoveringCurrentTargetStatus(liftPercent100thsValue, liftPercent100thsValue, WindowCovering.MovementStatus.Stopped);
+            this.coverLiftTilt?.log.info(`Command goToLiftPercentage ${liftPercent100thsValue} called`);
+        });
+        this.coverLiftTilt?.addCommandHandler('goToTiltPercentage', async ({ request: { tiltPercent100thsValue } }) => {
+            const position = this.coverLiftTilt?.getAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', this.coverLiftTilt?.log);
+            await this.coverLiftTilt?.setWindowCoveringTargetAndCurrentPosition(position, tiltPercent100thsValue);
+            this.coverLiftTilt?.log.info(`Command goToTiltPercentage ${tiltPercent100thsValue} called`);
         });
         this.lock = new MatterbridgeEndpoint([doorLockDevice, bridgedNode, powerSource], { uniqueStorageKey: 'Lock' }, this.config.debug)
             .createDefaultIdentifyClusterServer()
@@ -538,14 +574,14 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
                 this.thermoAuto?.log.info('Set occupiedCoolingSetpoint:', setpoint);
             }
         });
-        this.thermoAuto?.subscribeAttribute(ThermostatCluster.id, 'systemMode', async (value) => {
+        await this.thermoAuto?.subscribeAttribute(ThermostatCluster.id, 'systemMode', (value) => {
             const lookupSystemMode = ['Off', 'Auto', '', 'Cool', 'Heat', 'EmergencyHeat', 'Precooling', 'FanOnly', 'Dry', 'Sleep'];
             this.thermoAuto?.log.info('Subscribe systemMode called with:', lookupSystemMode[value]);
         }, this.thermoAuto.log);
-        this.thermoAuto?.subscribeAttribute(ThermostatCluster.id, 'occupiedHeatingSetpoint', async (value) => {
+        await this.thermoAuto?.subscribeAttribute(ThermostatCluster.id, 'occupiedHeatingSetpoint', (value) => {
             this.thermoAuto?.log.info('Subscribe occupiedHeatingSetpoint called with:', value / 100);
         }, this.thermoAuto.log);
-        this.thermoAuto?.subscribeAttribute(ThermostatCluster.id, 'occupiedCoolingSetpoint', async (value) => {
+        await this.thermoAuto?.subscribeAttribute(ThermostatCluster.id, 'occupiedCoolingSetpoint', (value) => {
             this.thermoAuto?.log.info('Subscribe occupiedCoolingSetpoint called with:', value / 100);
         }, this.thermoAuto.log);
         this.thermoHeat = new MatterbridgeEndpoint([thermostatDevice, bridgedNode, powerSource], { uniqueStorageKey: 'Thermostat (Heat)' }, this.config.debug)
@@ -580,11 +616,11 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         this.thermoHeat?.addCommandHandler('triggerEffect', async ({ request: { effectIdentifier, effectVariant } }) => {
             this.thermoHeat?.log.info(`Command identify called effectIdentifier ${effectIdentifier} effectVariant ${effectVariant}`);
         });
-        this.thermoHeat?.subscribeAttribute(ThermostatCluster.id, 'systemMode', async (value) => {
+        await this.thermoHeat?.subscribeAttribute(ThermostatCluster.id, 'systemMode', (value) => {
             const lookupSystemMode = ['Off', 'Auto', '', 'Cool', 'Heat', 'EmergencyHeat', 'Precooling', 'FanOnly', 'Dry', 'Sleep'];
             this.thermoHeat?.log.info('Subscribe systemMode called with:', lookupSystemMode[value]);
         }, this.thermoHeat.log);
-        this.thermoHeat?.subscribeAttribute(ThermostatCluster.id, 'occupiedHeatingSetpoint', async (value) => {
+        await this.thermoHeat?.subscribeAttribute(ThermostatCluster.id, 'occupiedHeatingSetpoint', (value) => {
             this.thermoHeat?.log.info('Subscribe occupiedHeatingSetpoint called with:', value / 100);
         }, this.thermoHeat.log);
         this.thermoCool = new MatterbridgeEndpoint([thermostatDevice, bridgedNode, powerSource], { uniqueStorageKey: 'Thermostat (Cool)' }, this.config.debug)
@@ -607,11 +643,11 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         this.thermoCool?.addCommandHandler('triggerEffect', async ({ request: { effectIdentifier, effectVariant } }) => {
             this.thermoCool?.log.info(`Command identify called effectIdentifier ${effectIdentifier} effectVariant ${effectVariant}`);
         });
-        this.thermoCool?.subscribeAttribute(ThermostatCluster.id, 'systemMode', async (value) => {
+        await this.thermoCool?.subscribeAttribute(ThermostatCluster.id, 'systemMode', (value) => {
             const lookupSystemMode = ['Off', 'Auto', '', 'Cool', 'Heat', 'EmergencyHeat', 'Precooling', 'FanOnly', 'Dry', 'Sleep'];
             this.thermoCool?.log.info('Subscribe systemMode called with:', lookupSystemMode[value]);
         }, this.thermoCool.log);
-        this.thermoCool?.subscribeAttribute(ThermostatCluster.id, 'occupiedCoolingSetpoint', async (value) => {
+        await this.thermoCool?.subscribeAttribute(ThermostatCluster.id, 'occupiedCoolingSetpoint', (value) => {
             this.thermoCool?.log.info('Subscribe occupiedCoolingSetpoint called with:', value / 100);
         }, this.thermoCool.log);
         this.airPurifier = new MatterbridgeEndpoint([airPurifier, temperatureSensor, humiditySensor, bridgedNode, powerSource], { uniqueStorageKey: 'Air purifier' }, this.config.debug)
@@ -634,31 +670,28 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         this.airPurifier?.addCommandHandler('identify', async ({ request: { identifyTime } }) => {
             this.airPurifier?.log.info(`Command identify called identifyTime:${identifyTime}`);
         });
-        this.airPurifier?.subscribeAttribute(FanControl.Cluster.id, 'fanMode', async (newValue, oldValue) => {
-            this.fan?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]}`);
+        await this.airPurifier?.subscribeAttribute(FanControl.Cluster.id, 'fanMode', (newValue, oldValue, context) => {
+            this.airPurifier?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]} context: ${context.offline === true ? 'offline' : 'online'}`);
             if (newValue === FanControl.FanMode.Off) {
-                await this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 0, this.airPurifier?.log);
+                this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 0, this.airPurifier?.log);
             }
             else if (newValue === FanControl.FanMode.Low) {
-                await this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 33, this.airPurifier?.log);
+                this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 33, this.airPurifier?.log);
             }
             else if (newValue === FanControl.FanMode.Medium) {
-                await this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 66, this.airPurifier?.log);
+                this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 66, this.airPurifier?.log);
             }
             else if (newValue === FanControl.FanMode.High) {
-                await this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.airPurifier?.log);
+                this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.airPurifier?.log);
             }
             else if (newValue === FanControl.FanMode.On) {
-                await this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.airPurifier?.log);
-            }
-            else if (newValue === FanControl.FanMode.Auto) {
-                await this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 50, this.airPurifier?.log);
+                this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.airPurifier?.log);
             }
         }, this.airPurifier.log);
-        this.airPurifier?.subscribeAttribute(FanControl.Cluster.id, 'percentSetting', async (newValue, oldValue) => {
-            this.fan?.log.info(`Percent setting changed from ${oldValue} to ${newValue}`);
+        await this.airPurifier?.subscribeAttribute(FanControl.Cluster.id, 'percentSetting', (newValue, oldValue, context) => {
+            this.airPurifier?.log.info(`Percent setting changed from ${oldValue} to ${newValue} context: ${context.offline === true ? 'offline' : 'online'}`);
             if (isValidNumber(newValue, 0, 100))
-                await this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', newValue, this.airPurifier?.log);
+                this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', newValue, this.airPurifier?.log);
         }, this.airPurifier.log);
         this.airConditioner = new MatterbridgeEndpoint([airConditioner, bridgedNode, powerSource], { uniqueStorageKey: 'Air Conditioner' }, this.config.debug)
             .createDefaultBridgedDeviceBasicInformationClusterServer('Air Conditioner', '0x96382864AC', 0xfff1, 'Matterbridge', 'Matterbridge Air Conditioner', parseInt(this.version.replace(/\D/g, '')), this.version === '' ? 'Unknown' : this.version, parseInt(this.matterbridge.matterbridgeVersion.replace(/\D/g, '')), this.matterbridge.matterbridgeVersion)
@@ -756,42 +789,42 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         else {
             this.fan = undefined;
         }
-        this.fan?.subscribeAttribute(FanControl.Cluster.id, 'fanMode', async (newValue, oldValue) => {
-            this.fan?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]}`);
+        await this.fan?.subscribeAttribute(FanControl.Cluster.id, 'fanMode', (newValue, oldValue, context) => {
+            this.fan?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]} context: ${context.offline === true ? 'offline' : 'online'}`);
             if (newValue === FanControl.FanMode.Off) {
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 0, this.fan?.log);
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 0, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 0, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 0, this.fan?.log);
             }
             else if (newValue === FanControl.FanMode.Low) {
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 33, this.fan?.log);
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 33, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 33, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 33, this.fan?.log);
             }
             else if (newValue === FanControl.FanMode.Medium) {
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 66, this.fan?.log);
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 66, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 66, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 66, this.fan?.log);
             }
             else if (newValue === FanControl.FanMode.High) {
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 100, this.fan?.log);
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 100, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.fan?.log);
             }
             else if (newValue === FanControl.FanMode.On) {
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 100, this.fan?.log);
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 100, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.fan?.log);
             }
             else if (newValue === FanControl.FanMode.Auto) {
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 50, this.fan?.log);
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 50, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 50, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 50, this.fan?.log);
             }
         }, this.fan.log);
-        this.fan?.subscribeAttribute(FanControl.Cluster.id, 'percentSetting', async (newValue, oldValue) => {
-            this.fan?.log.info(`Percent setting changed from ${oldValue} to ${newValue}`);
+        await this.fan?.subscribeAttribute(FanControl.Cluster.id, 'percentSetting', (newValue, oldValue, context) => {
+            this.fan?.log.info(`Percent setting changed from ${oldValue} to ${newValue} context: ${context.offline === true ? 'offline' : 'online'}`);
             if (isValidNumber(newValue, 0, 100))
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', newValue, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', newValue, this.fan?.log);
         }, this.fan.log);
-        this.fan?.subscribeAttribute(FanControl.Cluster.id, 'speedSetting', async (newValue, oldValue) => {
-            this.fan?.log.info(`Speed setting changed from ${oldValue} to ${newValue}`);
+        await this.fan?.subscribeAttribute(FanControl.Cluster.id, 'speedSetting', (newValue, oldValue, context) => {
+            this.fan?.log.info(`Speed setting changed from ${oldValue} to ${newValue} context: ${context.offline === true ? 'offline' : 'online'}`);
             if (isValidNumber(newValue, 0, 100))
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'speedCurrent', newValue, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'speedCurrent', newValue, this.fan?.log);
         }, this.fan.log);
         this.waterLeak = new MatterbridgeEndpoint([waterLeakDetector, bridgedNode, powerSource], { uniqueStorageKey: 'Water leak detector' }, this.config.debug)
             .createDefaultBridgedDeviceBasicInformationClusterServer('Water leak detector', 'serial_98745631222', 0xfff1, 'Matterbridge', 'Matterbridge WaterLeakDetector', parseInt(this.version.replace(/\D/g, '')), this.version === '' ? 'Unknown' : this.version, parseInt(this.matterbridge.matterbridgeVersion.replace(/\D/g, '')), this.matterbridge.matterbridgeVersion)
@@ -1091,17 +1124,17 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
                 }
             }, 60 * 1000 + 300);
         }
-        await this.cover?.setWindowCoveringTargetAsCurrentAndStopped();
-        this.cover?.log.info('Set cover initial targetPositionLiftPercent100ths = currentPositionLiftPercent100ths and operationalStatus to Stopped.');
+        await this.coverLift?.setWindowCoveringTargetAsCurrentAndStopped();
+        this.coverLift?.log.info('Set cover initial targetPositionLiftPercent100ths = currentPositionLiftPercent100ths and operationalStatus to Stopped.');
         if (this.config.useInterval) {
             this.coverInterval = setInterval(async () => {
-                let position = this.cover?.getAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', this.cover.log);
+                let position = this.coverLift?.getAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', this.coverLift.log);
                 if (isValidNumber(position, 0, 10000)) {
                     position = position > 9000 ? 0 : position + 1000;
-                    await this.cover?.setAttribute(WindowCovering.Cluster.id, 'targetPositionLiftPercent100ths', position, this.cover.log);
-                    await this.cover?.setAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', position, this.cover.log);
-                    await this.cover?.setAttribute(WindowCovering.Cluster.id, 'operationalStatus', { global: WindowCovering.MovementStatus.Stopped, lift: WindowCovering.MovementStatus.Stopped, tilt: WindowCovering.MovementStatus.Stopped }, this.cover.log);
-                    this.cover?.log.info(`Set cover current and target positionLiftPercent100ths to ${position} and operationalStatus to Stopped`);
+                    await this.coverLift?.setAttribute(WindowCovering.Cluster.id, 'targetPositionLiftPercent100ths', position, this.coverLift.log);
+                    await this.coverLift?.setAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', position, this.coverLift.log);
+                    await this.coverLift?.setAttribute(WindowCovering.Cluster.id, 'operationalStatus', { global: WindowCovering.MovementStatus.Stopped, lift: WindowCovering.MovementStatus.Stopped, tilt: WindowCovering.MovementStatus.Stopped }, this.coverLift.log);
+                    this.coverLift?.log.info(`Set cover current and target positionLiftPercent100ths to ${position} and operationalStatus to Stopped`);
                 }
             }, 60 * 1000 + 400);
         }
@@ -1276,26 +1309,27 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         await surface2?.setAttribute(OnOff.Cluster.id, 'onOff', true, surface2.log);
         surface2?.log.info(`Set Surface 2 onOff only OnOff to on`);
         if (this.config.useInterval) {
+            this.genericSwitchLastEvent = 'Release';
             this.genericSwitchInterval = setInterval(async () => {
                 if (this.genericSwitchLastEvent === 'Release') {
-                    await this.momentarySwitch?.triggerSwitchEvent('Single', this.momentarySwitch?.log);
                     this.genericSwitchLastEvent = 'Single';
+                    await this.momentarySwitch?.triggerSwitchEvent('Single', this.momentarySwitch?.log);
                 }
                 else if (this.genericSwitchLastEvent === 'Single') {
-                    await this.momentarySwitch?.triggerSwitchEvent('Double', this.momentarySwitch?.log);
                     this.genericSwitchLastEvent = 'Double';
+                    await this.momentarySwitch?.triggerSwitchEvent('Double', this.momentarySwitch?.log);
                 }
                 else if (this.genericSwitchLastEvent === 'Double') {
-                    await this.momentarySwitch?.triggerSwitchEvent('Long', this.momentarySwitch?.log);
                     this.genericSwitchLastEvent = 'Long';
+                    await this.momentarySwitch?.triggerSwitchEvent('Long', this.momentarySwitch?.log);
                 }
                 else if (this.genericSwitchLastEvent === 'Long') {
-                    await this.latchingSwitch?.triggerSwitchEvent('Press', this.latchingSwitch?.log);
                     this.genericSwitchLastEvent = 'Press';
+                    await this.latchingSwitch?.triggerSwitchEvent('Press', this.latchingSwitch?.log);
                 }
                 else if (this.genericSwitchLastEvent === 'Press') {
-                    await this.latchingSwitch?.triggerSwitchEvent('Release', this.latchingSwitch?.log);
                     this.genericSwitchLastEvent = 'Release';
+                    await this.latchingSwitch?.triggerSwitchEvent('Release', this.latchingSwitch?.log);
                 }
             }, 60 * 1000 + 1900);
         }

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "1.2.2",
+  "version": "1.2.3-rc.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge-example-dynamic-platform",
-      "version": "1.2.2",
+      "version": "1.2.3-rc.1",
       "license": "MIT",
       "dependencies": {
         "node-ansi-logger": "3.0.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "1.2.2",
+  "version": "1.2.3-rc.1",
   "description": "Matterbridge dynamic plugin",
   "author": "https://github.com/Luligu",
   "license": "MIT",
@@ -24,7 +24,11 @@
     "matter",
     "matter.js",
     "example",
-    "plugin"
+    "plugin",
+    "dynamic",
+    "platform",
+    "virtual device",
+    "virtual devices"
   ],
   "engines": {
     "node": ">=18.0.0 <19.0.0 || >=20.0.0 <21.0.0 || >=22.0.0"