matterbridge-example-dynamic-platform 3.0.3-dev-20260822-8bd7fd5 → 3.0.3-dev-20260829-d83e6fe

package/CHANGELOG.md

@@ -33,7 +33,7 @@ If you like this project and find it useful, please consider giving it a star on
 
 ### Breaking changes
 
-- [matterbridge]: Require matterbridge v.3.10.6 with matter v.1.6.0.
+- [matterbridge]: Require matterbridge v.3.10.7 with matter v.1.6.0.
 - [fanControl]: Matterbridge v.3.10.6 now manages the compliant FanControl `fanMode` and `percentSetting` synchronization; plugin examples now only update `percentCurrent` as physical device feedback.
 
 ### Added
@@ -42,10 +42,21 @@ If you like this project and find it useful, please consider giving it a star on
 - [platform]: Add `closureRoofWindow` device with ventilation opening support. Thanks Ludovic BOUÉ.
 - [devcontainer]: Upgrade the `Dev Container` to v.2.0.0, using the Node.js and Bun stack.
 
+### Changed
+
+- [package]: Update dependencies.
+- [package]: Bump `@types/node` to v.26.4.0.
+- [package]: Bump `oxfmt` to v.0.65.0.
+- [package]: Bump `oxlint` to v.1.80.0.
+
 ### Fixed
 
 - [speaker]: Update to the `Speaker` constructor options object required by matterbridge v.3.10.6.
 - [fanControl]: `percentSetting` is no longer nullable in matterbridge v.3.10.6; set it to 0 instead of null when turning off the air conditioner.
+- [energy]: Update `WaterHeater`, `Evse`, `SolarPower`, `BatteryStorage`, and `HeatPump` to the options object constructor, present since matterbridge v.3.10.7. The deprecated positional-arguments constructors are still supported but no longer used in this plugin.
+- [devices]: Update `RoboticVacuumCleaner`, `Oven.addCabinet`, `Cooktop.addSurface`, and `Refrigerator.addCabinet` to the options object form, removing the last `typescript/no-deprecated` oxlint suppressions in the platform.
+- [platform]: Make the local `addDevice` helper generic (`addDevice<T extends MatterbridgeEndpoint>`) so it returns the same subclass it was given, removing 9 `typescript/no-unsafe-type-assertion` oxlint suppressions at its call sites.
+- [platform]: Type `initializePlugin`'s `config` parameter directly as `DynamicPlatformConfig`, matching the pattern used in production plugins, removing the last `typescript/no-unsafe-type-assertion` cast on plugin startup.
 
 <a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="80"></a>
 

package/dist/module.js

@@ -20,6 +20,9 @@ function matterToLux(value) {
     const lux = Math.pow(10, v / 10000);
     return Math.round(lux < 0 ? 0 : lux);
 }
+function isDeviceTypeList(value) {
+    return Array.isArray(value);
+}
 export default function initializePlugin(matterbridge, log, config) {
     return new ExampleMatterbridgeDynamicPlatform(matterbridge, log, config);
 }
@@ -113,8 +116,8 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
     constructor(matterbridge, log, config) {
         super(matterbridge, log, config);
         this.config = config;
-        if (typeof this.verifyMatterbridgeVersion !== 'function' || !this.verifyMatterbridgeVersion('3.10.6')) {
-            throw new Error(`This plugin requires Matterbridge version >= "3.10.6". Please update Matterbridge from ${this.matterbridge.matterbridgeVersion} to the latest version in the frontend.`);
+        if (typeof this.verifyMatterbridgeVersion !== 'function' || !this.verifyMatterbridgeVersion('3.10.7')) {
+            throw new Error(`This plugin requires Matterbridge version >= "3.10.7". Please update Matterbridge from ${this.matterbridge.matterbridgeVersion} to the latest version in the frontend.`);
         }
         this.log.info('Initializing platform:', this.config.name);
     }
@@ -173,18 +176,18 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         this.flow = await this.addDevice(this.flow);
         this.soil = new SoilSensor('Soil Sensor', 'SOI000067', { soilMoistureMeasuredValue: 45, temperatureMeasuredValue: 3500, batteryPowered: true });
         this.soil = await this.addDevice(this.soil);
-        this.irrigation = new IrrigationSystem('Irrigation System', 'IRR000068', { batteryPowered: true, flowMeasuredValue: 15 }).addZone(CommonNumberTag.One);
-        this.irrigation = (await this.addDevice(this.irrigation));
+        this.irrigation = new IrrigationSystem('Irrigation System', 'IRR000068', { batteryPowered: true, flowMeasuredValue: 15 }).addZone(CommonNumberTag.One, undefined, undefined, 2000, true);
+        this.irrigation = await this.addDevice(this.irrigation);
         this.irrigationSystem = new IrrigationSystem('Irrigation System 4 zones', 'IRR000069', { flowMeasuredValue: 60 })
-            .addZone(CommonNumberTag.One)
-            .addZone(CommonNumberTag.Two)
-            .addZone(CommonNumberTag.Three)
-            .addZone(CommonNumberTag.Four);
-        this.irrigationSystem = (await this.addDevice(this.irrigationSystem));
+            .addZone(CommonNumberTag.One, undefined, undefined, 2000, true)
+            .addZone(CommonNumberTag.Two, undefined, undefined, 2000, true)
+            .addZone(CommonNumberTag.Three, undefined, undefined, 2000, true)
+            .addZone(CommonNumberTag.Four, undefined, undefined, 2000, true);
+        this.irrigationSystem = await this.addDevice(this.irrigationSystem);
         this.closureGarageDoor = new Closure('Garage Door', 'GAR000071', {
             tagList: [getSemtag(ClosureTag.GarageDoor)],
         });
-        this.closureGarageDoor = (await this.addDevice(this.closureGarageDoor));
+        this.closureGarageDoor = await this.addDevice(this.closureGarageDoor);
         let closureGarageDoorMoveTimeout;
         function closureTargetToCurrentPosition(position) {
             if (position === ClosureControl.TargetPosition.MoveToFullyClosed)
@@ -224,7 +227,7 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         });
         const closureVenetianBlindLift = this.closureVenetianBlind.addPanel('Lift', [getSemtag(ClosurePanelTag.Lift)], 'lift');
         const closureVenetianBlindTilt = this.closureVenetianBlind.addPanel('Tilt', [getSemtag(ClosurePanelTag.Tilt)], 'tilt');
-        this.closureVenetianBlind = (await this.addDevice(this.closureVenetianBlind));
+        this.closureVenetianBlind = await this.addDevice(this.closureVenetianBlind);
         const closurePanelTargetPercent = (position) => {
             if (position === ClosureControl.TargetPosition.MoveToFullyOpen)
                 return 0;
@@ -1445,7 +1448,7 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         this.valve = new MatterbridgeEndpoint([waterValve, bridgedNode, powerSource], { id: 'Water valve' }, this.config.debug)
             .createDefaultBridgedDeviceBasicInformationClusterServer('Water valve', 'WAV00029', 0xfff1, 'Matterbridge', 'Matterbridge Water valve')
             .createDefaultIdentifyClusterServer()
-            .createDefaultValveConfigurationAndControlClusterServer()
+            .createDefaultValveConfigurationAndControlClusterServer(undefined, undefined, 2000, true)
             .createDefaultPowerSourceWiredClusterServer()
             .addRequiredClusterServers();
         this.valve = await this.addDevice(this.valve);
@@ -1681,68 +1684,130 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             .createDefaultLatchingSwitchClusterServer()
             .createDefaultPowerSourceReplaceableBatteryClusterServer(10, PowerSource.BatChargeLevel.Critical, 2850, 'CR2032', 1);
         this.latchingSwitch = await this.addDevice(this.latchingSwitch);
-        this.roboticVacuum = new RoboticVacuumCleaner(this.config.enableServerRvc ? 'Robot Vacuum Server' : 'Robot Vacuum', 'RVC00043', this.config.enableServerRvc ? 'server' : undefined, 1, [
-            { label: 'Idle', mode: 1, modeTags: [{ value: RvcRunMode.ModeTag.Idle }] },
-            { label: 'Cleaning', mode: 2, modeTags: [{ value: RvcRunMode.ModeTag.Cleaning }] },
-            { label: 'Mapping', mode: 3, modeTags: [{ value: RvcRunMode.ModeTag.Mapping }] },
-            { label: 'SpotCleaning', mode: 4, modeTags: [{ value: RvcRunMode.ModeTag.Cleaning }, { value: RvcRunMode.ModeTag.Max }] },
-        ], 1, [
-            { label: 'Vacuum', mode: 1, modeTags: [{ value: RvcCleanMode.ModeTag.Vacuum }] },
-            { label: 'Mop', mode: 2, modeTags: [{ value: RvcCleanMode.ModeTag.Mop }] },
-            { label: 'Clean', mode: 3, modeTags: [{ value: RvcCleanMode.ModeTag.DeepClean }] },
-        ], null, null, undefined, undefined, [
-            {
-                areaId: 1,
-                mapId: 1,
-                areaInfo: { locationInfo: { locationName: 'Living', floorNumber: 0, areaType: CommonAreaNamespaceTag.LivingRoom.tag }, landmarkInfo: null },
-            },
-            {
-                areaId: 2,
-                mapId: 1,
-                areaInfo: { locationInfo: { locationName: 'Kitchen', floorNumber: 0, areaType: CommonAreaNamespaceTag.Kitchen.tag }, landmarkInfo: null },
-            },
-            {
-                areaId: 3,
-                mapId: 2,
-                areaInfo: { locationInfo: { locationName: 'Bedroom', floorNumber: 1, areaType: CommonAreaNamespaceTag.Bedroom.tag }, landmarkInfo: null },
-            },
-            {
-                areaId: 4,
-                mapId: 2,
-                areaInfo: { locationInfo: { locationName: 'Bathroom', floorNumber: 1, areaType: CommonAreaNamespaceTag.Bathroom.tag }, landmarkInfo: null },
-            },
-        ], [], 1, [
-            {
-                mapId: 1,
-                name: 'Ground floor',
-            },
-            {
-                mapId: 2,
-                name: 'First floor',
-            },
-        ]);
+        this.roboticVacuum = new RoboticVacuumCleaner(this.config.enableServerRvc ? 'Robot Vacuum Server' : 'Robot Vacuum', 'RVC00043', {
+            mode: this.config.enableServerRvc ? 'server' : undefined,
+            currentRunMode: 1,
+            supportedRunModes: [
+                { label: 'Idle', mode: 1, modeTags: [{ value: RvcRunMode.ModeTag.Idle }] },
+                { label: 'Cleaning', mode: 2, modeTags: [{ value: RvcRunMode.ModeTag.Cleaning }] },
+                { label: 'Mapping', mode: 3, modeTags: [{ value: RvcRunMode.ModeTag.Mapping }] },
+                { label: 'SpotCleaning', mode: 4, modeTags: [{ value: RvcRunMode.ModeTag.Cleaning }, { value: RvcRunMode.ModeTag.Max }] },
+            ],
+            currentCleanMode: 1,
+            supportedCleanModes: [
+                { label: 'Vacuum', mode: 1, modeTags: [{ value: RvcCleanMode.ModeTag.Vacuum }] },
+                { label: 'Mop', mode: 2, modeTags: [{ value: RvcCleanMode.ModeTag.Mop }] },
+                { label: 'Clean', mode: 3, modeTags: [{ value: RvcCleanMode.ModeTag.DeepClean }] },
+            ],
+            currentPhase: null,
+            phaseList: null,
+            operationalState: undefined,
+            operationalStateList: undefined,
+            supportedAreas: [
+                {
+                    areaId: 1,
+                    mapId: 1,
+                    areaInfo: { locationInfo: { locationName: 'Living', floorNumber: 0, areaType: CommonAreaNamespaceTag.LivingRoom.tag }, landmarkInfo: null },
+                },
+                {
+                    areaId: 2,
+                    mapId: 1,
+                    areaInfo: { locationInfo: { locationName: 'Kitchen', floorNumber: 0, areaType: CommonAreaNamespaceTag.Kitchen.tag }, landmarkInfo: null },
+                },
+                {
+                    areaId: 3,
+                    mapId: 2,
+                    areaInfo: { locationInfo: { locationName: 'Bedroom', floorNumber: 1, areaType: CommonAreaNamespaceTag.Bedroom.tag }, landmarkInfo: null },
+                },
+                {
+                    areaId: 4,
+                    mapId: 2,
+                    areaInfo: { locationInfo: { locationName: 'Bathroom', floorNumber: 1, areaType: CommonAreaNamespaceTag.Bathroom.tag }, landmarkInfo: null },
+                },
+            ],
+            selectedAreas: [],
+            currentArea: 1,
+            supportedMaps: [
+                {
+                    mapId: 1,
+                    name: 'Ground floor',
+                },
+                {
+                    mapId: 2,
+                    name: 'First floor',
+                },
+            ],
+        });
         if (this.config.enableServerRvc) {
             this.log.notice('RVC is in server mode so it has its own QR code (it shows in the "Devices" panel of the Home page)');
         }
         this.roboticVacuum = await this.addDevice(this.roboticVacuum);
-        this.waterHeater = new WaterHeater('Water Heater', 'WHT00044', 50, 60, 20, 80, undefined, 85, 220_000, 1_000, 220_000, 12_000_000, 500_000, 3_000_000);
+        this.waterHeater = new WaterHeater('Water Heater', 'WHT00044', {
+            waterTemperature: 50,
+            targetWaterTemperature: 60,
+            minHeatSetpointLimit: 20,
+            maxHeatSetpointLimit: 80,
+            tankPercentage: 85,
+            voltage: 220_000,
+            current: 1_000,
+            power: 220_000,
+            energy: 12_000_000,
+            absMinPower: 500_000,
+            absMaxPower: 3_000_000,
+        });
         this.waterHeater = await this.addDevice(this.waterHeater);
-        this.evse = new Evse('Evse', 'EVS00045', 1, [
-            { label: 'On demand', mode: 1, modeTags: [{ value: EnergyEvseMode.ModeTag.Manual }] },
-            { label: 'Scheduled', mode: 2, modeTags: [{ value: EnergyEvseMode.ModeTag.TimeOfUse }] },
-            { label: 'Solar Charging', mode: 3, modeTags: [{ value: EnergyEvseMode.ModeTag.SolarCharging }] },
-            { label: 'Solar Charging Scheduled', mode: 4, modeTags: [{ value: EnergyEvseMode.ModeTag.SolarCharging }, { value: EnergyEvseMode.ModeTag.TimeOfUse }] },
-        ], EnergyEvse.State.PluggedInCharging, EnergyEvse.SupplyState.ChargingEnabled, EnergyEvse.FaultState.NoError, 220_000, 10_000, 2_200_000, 1_000_000, 500_000, 32_000_000);
+        this.evse = new Evse('Evse', 'EVS00045', {
+            currentMode: 1,
+            supportedModes: [
+                { label: 'On demand', mode: 1, modeTags: [{ value: EnergyEvseMode.ModeTag.Manual }] },
+                { label: 'Scheduled', mode: 2, modeTags: [{ value: EnergyEvseMode.ModeTag.TimeOfUse }] },
+                { label: 'Solar Charging', mode: 3, modeTags: [{ value: EnergyEvseMode.ModeTag.SolarCharging }] },
+                { label: 'Solar Charging Scheduled', mode: 4, modeTags: [{ value: EnergyEvseMode.ModeTag.SolarCharging }, { value: EnergyEvseMode.ModeTag.TimeOfUse }] },
+            ],
+            state: EnergyEvse.State.PluggedInCharging,
+            supplyState: EnergyEvse.SupplyState.ChargingEnabled,
+            faultState: EnergyEvse.FaultState.NoError,
+            voltage: 220_000,
+            current: 10_000,
+            power: 2_200_000,
+            energy: 1_000_000,
+            absMinPower: 500_000,
+            absMaxPower: 32_000_000,
+        });
         this.evse = await this.addDevice(this.evse);
-        this.solarPower = new SolarPower('Solar Power', 'SOL00046', 220_000, 10_000, 2200_000, 2_200_000, 0, 500_000);
+        this.solarPower = new SolarPower('Solar Power', 'SOL00046', {
+            voltage: 220_000,
+            current: 10_000,
+            power: 2200_000,
+            energyExported: 2_200_000,
+            absMinPower: 0,
+            absMaxPower: 500_000,
+        });
         this.solarPower.addPanel('Panel 1', CommonNumberTag.One);
         this.solarPower.addPanel('Panel 2', CommonNumberTag.Two);
         this.solarPower.addPanel('Panel 3', CommonNumberTag.Three);
         this.solarPower.addPanel('Panel 4', CommonNumberTag.Four);
-        this.solarPower = (await this.addDevice(this.solarPower));
-        this.batteryStorage = new BatteryStorage('Battery Storage', 'BST00047', 75, PowerSource.BatChargeLevel.Ok, 220_000, 10_000, 2_200_000, 1_000_000, 2_000_000, -2_000_000, 3_000_000);
+        this.solarPower = await this.addDevice(this.solarPower);
+        this.batteryStorage = new BatteryStorage('Battery Storage', 'BST00047', {
+            batPercentRemaining: 75,
+            batChargeLevel: PowerSource.BatChargeLevel.Ok,
+            voltage: 220_000,
+            current: 10_000,
+            power: 2_200_000,
+            energyImported: 1_000_000,
+            energyExported: 2_000_000,
+            absMinPower: -2_000_000,
+            absMaxPower: 3_000_000,
+        });
         this.batteryStorage = await this.addDevice(this.batteryStorage);
-        this.heatPump = new HeatPump('Heat Pump', 'HPU00048', 220_000, 10_000, 2_200_000, 1_000_000, 500_000, 3_000_000);
+        this.heatPump = new HeatPump('Heat Pump', 'HPU00048', {
+            voltage: 220_000,
+            current: 10_000,
+            power: 2_200_000,
+            energyImported: 1_000_000,
+            absMinPower: 500_000,
+            absMaxPower: 3_000_000,
+        });
         this.heatPump = await this.addDevice(this.heatPump);
         this.laundryWasher = new LaundryWasher('Laundry Washer', 'LWA00049');
         this.laundryWasher = await this.addDevice(this.laundryWasher);
@@ -1755,52 +1820,98 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         this.microwaveOven = new MicrowaveOven('Microwave Oven', 'MWO00053');
         this.microwaveOven = await this.addDevice(this.microwaveOven);
         this.oven = new Oven('Oven', 'OVN00054');
-        this.oven.addCabinet('Upper Cabinet', [{ mfgCode: null, namespaceId: CommonPositionTag.Top.namespaceId, tag: CommonPositionTag.Top.tag, label: CommonPositionTag.Top.label }], 2, [
-            { label: 'Bake', mode: 1, modeTags: [{ value: OvenMode.ModeTag.Bake }] },
-            { label: 'Convection', mode: 2, modeTags: [{ value: OvenMode.ModeTag.Convection }] },
-            { label: 'Grill', mode: 3, modeTags: [{ value: OvenMode.ModeTag.Grill }] },
-            { label: 'Roast', mode: 4, modeTags: [{ value: OvenMode.ModeTag.Roast }] },
-            { label: 'Clean', mode: 5, modeTags: [{ value: OvenMode.ModeTag.Clean }] },
-            { label: 'Convection Bake', mode: 6, modeTags: [{ value: OvenMode.ModeTag.ConvectionBake }] },
-            { label: 'Convection Roast', mode: 7, modeTags: [{ value: OvenMode.ModeTag.ConvectionRoast }] },
-            { label: 'Warming', mode: 8, modeTags: [{ value: OvenMode.ModeTag.Warming }] },
-            { label: 'Proofing', mode: 9, modeTags: [{ value: OvenMode.ModeTag.Proofing }] },
-            { label: 'Steam', mode: 10, modeTags: [{ value: OvenMode.ModeTag.Steam }] },
-        ], 180 * 100, 100 * 100, 300 * 100, 10 * 100, 20 * 100, OperationalState.OperationalStateEnum.Stopped, 2, ['pre-heating', 'pre-heated', 'cooling down']);
-        this.oven.addCabinet('Lower Cabinet', [{ mfgCode: null, namespaceId: CommonPositionTag.Bottom.namespaceId, tag: CommonPositionTag.Bottom.tag, label: CommonPositionTag.Bottom.label }], 3, [
-            { label: 'Convection', mode: 1, modeTags: [{ value: OvenMode.ModeTag.Convection }] },
-            { label: 'Clean', mode: 2, modeTags: [{ value: OvenMode.ModeTag.Clean }] },
-            { label: 'Steam', mode: 3, modeTags: [{ value: OvenMode.ModeTag.Steam }] },
-        ], 200 * 100, 100 * 100, 300 * 100, 10 * 100, 200 * 100, OperationalState.OperationalStateEnum.Running, 1, ['pre-heating', 'pre-heated', 'cooling down']);
-        this.oven = (await this.addDevice(this.oven));
+        this.oven.addCabinet('Upper Cabinet', {
+            tagList: [{ mfgCode: null, namespaceId: CommonPositionTag.Top.namespaceId, tag: CommonPositionTag.Top.tag, label: CommonPositionTag.Top.label }],
+            currentMode: 2,
+            supportedModes: [
+                { label: 'Bake', mode: 1, modeTags: [{ value: OvenMode.ModeTag.Bake }] },
+                { label: 'Convection', mode: 2, modeTags: [{ value: OvenMode.ModeTag.Convection }] },
+                { label: 'Grill', mode: 3, modeTags: [{ value: OvenMode.ModeTag.Grill }] },
+                { label: 'Roast', mode: 4, modeTags: [{ value: OvenMode.ModeTag.Roast }] },
+                { label: 'Clean', mode: 5, modeTags: [{ value: OvenMode.ModeTag.Clean }] },
+                { label: 'Convection Bake', mode: 6, modeTags: [{ value: OvenMode.ModeTag.ConvectionBake }] },
+                { label: 'Convection Roast', mode: 7, modeTags: [{ value: OvenMode.ModeTag.ConvectionRoast }] },
+                { label: 'Warming', mode: 8, modeTags: [{ value: OvenMode.ModeTag.Warming }] },
+                { label: 'Proofing', mode: 9, modeTags: [{ value: OvenMode.ModeTag.Proofing }] },
+                { label: 'Steam', mode: 10, modeTags: [{ value: OvenMode.ModeTag.Steam }] },
+            ],
+            targetTemperature: 180 * 100,
+            minTemperature: 100 * 100,
+            maxTemperature: 300 * 100,
+            step: 10 * 100,
+            currentTemperature: 20 * 100,
+            operationalState: OperationalState.OperationalStateEnum.Stopped,
+            currentPhase: 2,
+            phaseList: ['pre-heating', 'pre-heated', 'cooling down'],
+        });
+        this.oven.addCabinet('Lower Cabinet', {
+            tagList: [{ mfgCode: null, namespaceId: CommonPositionTag.Bottom.namespaceId, tag: CommonPositionTag.Bottom.tag, label: CommonPositionTag.Bottom.label }],
+            currentMode: 3,
+            supportedModes: [
+                { label: 'Convection', mode: 1, modeTags: [{ value: OvenMode.ModeTag.Convection }] },
+                { label: 'Clean', mode: 2, modeTags: [{ value: OvenMode.ModeTag.Clean }] },
+                { label: 'Steam', mode: 3, modeTags: [{ value: OvenMode.ModeTag.Steam }] },
+            ],
+            targetTemperature: 200 * 100,
+            minTemperature: 100 * 100,
+            maxTemperature: 300 * 100,
+            step: 10 * 100,
+            currentTemperature: 200 * 100,
+            operationalState: OperationalState.OperationalStateEnum.Running,
+            currentPhase: 1,
+            phaseList: ['pre-heating', 'pre-heated', 'cooling down'],
+        });
+        this.oven = await this.addDevice(this.oven);
         this.cooktop = new Cooktop('Cooktop', 'CKT00055');
-        this.cooktop.addSurface('Surface Top Left', [
-            { mfgCode: null, namespaceId: CommonPositionTag.Top.namespaceId, tag: CommonPositionTag.Top.tag, label: CommonPositionTag.Top.label },
-            { mfgCode: null, namespaceId: CommonPositionTag.Left.namespaceId, tag: CommonPositionTag.Left.tag, label: CommonPositionTag.Left.label },
-        ]);
-        this.cooktop.addSurface('Surface Top Right', [
-            { mfgCode: null, namespaceId: CommonPositionTag.Top.namespaceId, tag: CommonPositionTag.Top.tag, label: CommonPositionTag.Top.label },
-            { mfgCode: null, namespaceId: CommonPositionTag.Right.namespaceId, tag: CommonPositionTag.Right.tag, label: CommonPositionTag.Right.label },
-        ]);
-        this.cooktop.addSurface('Surface Bottom Left', [
-            { mfgCode: null, namespaceId: CommonPositionTag.Bottom.namespaceId, tag: CommonPositionTag.Bottom.tag, label: CommonPositionTag.Bottom.label },
-            { mfgCode: null, namespaceId: CommonPositionTag.Left.namespaceId, tag: CommonPositionTag.Left.tag, label: CommonPositionTag.Left.label },
-        ]);
-        this.cooktop.addSurface('Surface Bottom Right', [
-            { mfgCode: null, namespaceId: CommonPositionTag.Bottom.namespaceId, tag: CommonPositionTag.Bottom.tag, label: CommonPositionTag.Bottom.label },
-            { mfgCode: null, namespaceId: CommonPositionTag.Right.namespaceId, tag: CommonPositionTag.Right.tag, label: CommonPositionTag.Right.label },
-        ]);
-        this.cooktop = (await this.addDevice(this.cooktop));
+        this.cooktop.addSurface('Surface Top Left', {
+            tagList: [
+                { mfgCode: null, namespaceId: CommonPositionTag.Top.namespaceId, tag: CommonPositionTag.Top.tag, label: CommonPositionTag.Top.label },
+                { mfgCode: null, namespaceId: CommonPositionTag.Left.namespaceId, tag: CommonPositionTag.Left.tag, label: CommonPositionTag.Left.label },
+            ],
+        });
+        this.cooktop.addSurface('Surface Top Right', {
+            tagList: [
+                { mfgCode: null, namespaceId: CommonPositionTag.Top.namespaceId, tag: CommonPositionTag.Top.tag, label: CommonPositionTag.Top.label },
+                { mfgCode: null, namespaceId: CommonPositionTag.Right.namespaceId, tag: CommonPositionTag.Right.tag, label: CommonPositionTag.Right.label },
+            ],
+        });
+        this.cooktop.addSurface('Surface Bottom Left', {
+            tagList: [
+                { mfgCode: null, namespaceId: CommonPositionTag.Bottom.namespaceId, tag: CommonPositionTag.Bottom.tag, label: CommonPositionTag.Bottom.label },
+                { mfgCode: null, namespaceId: CommonPositionTag.Left.namespaceId, tag: CommonPositionTag.Left.tag, label: CommonPositionTag.Left.label },
+            ],
+        });
+        this.cooktop.addSurface('Surface Bottom Right', {
+            tagList: [
+                { mfgCode: null, namespaceId: CommonPositionTag.Bottom.namespaceId, tag: CommonPositionTag.Bottom.tag, label: CommonPositionTag.Bottom.label },
+                { mfgCode: null, namespaceId: CommonPositionTag.Right.namespaceId, tag: CommonPositionTag.Right.tag, label: CommonPositionTag.Right.label },
+            ],
+        });
+        this.cooktop = await this.addDevice(this.cooktop);
         const refrigerator = new Refrigerator('Refrigerator', 'REF00056');
-        refrigerator.addCabinet('Refrigerator Top', [
-            { mfgCode: null, namespaceId: CommonPositionTag.Top.namespaceId, tag: CommonPositionTag.Top.tag, label: 'Refrigerator Top' },
-            { mfgCode: null, namespaceId: RefrigeratorTag.Refrigerator.namespaceId, tag: RefrigeratorTag.Refrigerator.tag, label: RefrigeratorTag.Refrigerator.label },
-        ], 12 * 100, 5 * 100, 20 * 100, 1 * 100, 1200);
-        refrigerator.addCabinet('Freezer Bottom', [
-            { mfgCode: null, namespaceId: CommonPositionTag.Bottom.namespaceId, tag: CommonPositionTag.Bottom.tag, label: 'Freezer Bottom' },
-            { mfgCode: null, namespaceId: RefrigeratorTag.Freezer.namespaceId, tag: RefrigeratorTag.Freezer.tag, label: RefrigeratorTag.Freezer.label },
-        ], -18 * 100, -30 * 100, -10 * 100, 1 * 100, -1800);
-        this.refrigerator = (await this.addDevice(refrigerator));
+        refrigerator.addCabinet('Refrigerator Top', {
+            tagList: [
+                { mfgCode: null, namespaceId: CommonPositionTag.Top.namespaceId, tag: CommonPositionTag.Top.tag, label: 'Refrigerator Top' },
+                { mfgCode: null, namespaceId: RefrigeratorTag.Refrigerator.namespaceId, tag: RefrigeratorTag.Refrigerator.tag, label: RefrigeratorTag.Refrigerator.label },
+            ],
+            targetTemperature: 12 * 100,
+            minTemperature: 5 * 100,
+            maxTemperature: 20 * 100,
+            step: 1 * 100,
+            currentTemperature: 1200,
+        });
+        refrigerator.addCabinet('Freezer Bottom', {
+            tagList: [
+                { mfgCode: null, namespaceId: CommonPositionTag.Bottom.namespaceId, tag: CommonPositionTag.Bottom.tag, label: 'Freezer Bottom' },
+                { mfgCode: null, namespaceId: RefrigeratorTag.Freezer.namespaceId, tag: RefrigeratorTag.Freezer.tag, label: RefrigeratorTag.Freezer.label },
+            ],
+            targetTemperature: -18 * 100,
+            minTemperature: -30 * 100,
+            maxTemperature: -10 * 100,
+            step: 1 * 100,
+            currentTemperature: -1800,
+        });
+        this.refrigerator = await this.addDevice(refrigerator);
         this.airConditioner = new AirConditioner('Air Conditioner', 'ACO00027', {
             localTemperature: 20,
             occupiedCoolingSetpoint: 22,
@@ -1868,7 +1979,7 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             this.basicVideoPlayer?.log.info(`Command sendKey with ${keyCode} called`);
         });
         this.speaker = new Speaker('Speaker', 'SPE00057', { muted: false, volume: 100 });
-        this.speaker = (await this.addDevice(this.speaker));
+        this.speaker = await this.addDevice(this.speaker);
     }
     intervals = [];
     addInterval(callback, intervalTime) {
@@ -2606,8 +2717,8 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             if (device.mode === undefined && !device.deviceTypes.has(bridgedNode.code)) {
                 device.deviceTypes.set(bridgedNode.code, bridgedNode);
                 const options = device.getClusterServerOptions(Descriptor);
-                if (options?.deviceTypeList) {
-                    const deviceTypeList = options.deviceTypeList;
+                const deviceTypeList = options?.deviceTypeList;
+                if (isDeviceTypeList(deviceTypeList)) {
                     if (!deviceTypeList.find((dt) => dt.deviceType === bridgedNode.code)) {
                         deviceTypeList.push({ deviceType: bridgedNode.code, revision: bridgedNode.revision });
                     }

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "3.0.3-dev-20260822-8bd7fd5",
+  "version": "3.0.3-dev-20260829-d83e6fe",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge-example-dynamic-platform",
-      "version": "3.0.3-dev-20260822-8bd7fd5",
+      "version": "3.0.3-dev-20260829-d83e6fe",
       "license": "Apache-2.0",
       "dependencies": {
         "node-ansi-logger": "3.3.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "3.0.3-dev-20260822-8bd7fd5",
+  "version": "3.0.3-dev-20260829-d83e6fe",
   "description": "Matterbridge dynamic plugin",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",