matterbridge-example-dynamic-platform 1.3.1-dev-20250630-905428f → 1.3.1

package/CHANGELOG.md

@@ -23,16 +23,18 @@ 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.3.1] - 2025-06-??
+## [1.3.1] - 2025-07-04
 
 ### Added
 
 - [platform]: Added solarPower device type (not supported by the Home app).
 - [platform]: Added batteryStoraga device type (not supported by the Home app).
+- [platform]: Added heatPump device type (not supported by the Home app).
 
 ### Changed
 
 - [platform]: Changed imports from matterbridge/devices.
+- [package]: Require matterbridge 3.1.1.
 
 <a href="https://www.buymeacoffee.com/luligugithub">
   <img src="bmc-button.svg" alt="Buy me a coffee" width="80">

package/README.md

@@ -17,7 +17,7 @@
 
 Matterbridge dynamic platform example plugin is a template to develop your own plugin using the dynamic platform.
 
-It exposes 43 virtual devices:
+It exposes 44 virtual devices:
 
 - a switch with onOff cluster
 - a light with onOff
@@ -62,7 +62,8 @@ It exposes 43 virtual devices:
 - a water heater device (supported by SmartThings and Home Assistant)
 - a car charger device (supported by Home Assistant)
 - a solar power device
-- a batter storage device
+- a battery storage device
+- a heat pump device
 
 All these devices continuously change state and position. The plugin also shows how to use all the command handlers (you can control all the devices), how to subscribe to attributes and how to trigger events.
 

package/dist/platform.js

@@ -1,5 +1,5 @@
 import { MatterbridgeEndpoint, MatterbridgeDynamicPlatform, airQualitySensor, bridgedNode, colorTemperatureLight, coverDevice, dimmableLight, doorLockDevice, fanDevice, flowSensor, humiditySensor, onOffLight, onOffOutlet, onOffSwitch, powerSource, rainSensor, smokeCoAlarm, temperatureSensor, thermostatDevice, waterFreezeDetector, waterLeakDetector, airPurifier, pumpDevice, waterValve, genericSwitch, airConditioner, cooktop, extractorHood, microwaveOven, oven, refrigerator, dishwasher, onOffMountedSwitch, dimmableMountedSwitch, extendedColorLight, } from 'matterbridge';
-import { RoboticVacuumCleaner, LaundryWasher, WaterHeater, Evse, SolarPower, BatteryStorage, LaundryDryer } from 'matterbridge/devices';
+import { RoboticVacuumCleaner, LaundryWasher, WaterHeater, Evse, SolarPower, BatteryStorage, LaundryDryer, HeatPump } from 'matterbridge/devices';
 import { isValidBoolean, isValidNumber } from 'matterbridge/utils';
 import { LocationTag, NumberTag, PositionTag } from 'matterbridge/matter';
 import { PowerSource, BooleanState, OnOff, LevelControl, AirQuality, CarbonDioxideConcentrationMeasurement, CarbonMonoxideConcentrationMeasurement, FlowMeasurement, ColorControl, DoorLock, FanControl, FormaldehydeConcentrationMeasurement, NitrogenDioxideConcentrationMeasurement, OzoneConcentrationMeasurement, Pm10ConcentrationMeasurement, Pm1ConcentrationMeasurement, Pm25ConcentrationMeasurement, RadonConcentrationMeasurement, RelativeHumidityMeasurement, RelativeHumidityMeasurementCluster, SmokeCoAlarm, TemperatureMeasurement, Thermostat, ThermostatCluster, TotalVolatileOrganicCompoundsConcentrationMeasurement, WindowCovering, EnergyEvseMode, EnergyEvse, } from 'matterbridge/matter/clusters';
@@ -42,6 +42,7 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
     laundryDryer;
     solarPower;
     batteryStorage;
+    heatPump;
     switchInterval;
     lightInterval;
     outletInterval;
@@ -64,8 +65,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.6')) {
-            throw new Error(`This plugin requires Matterbridge version >= "3.0.6". 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.1.1')) {
+            throw new Error(`This plugin requires Matterbridge version >= "3.1.1". 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)
@@ -997,42 +998,48 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             this.latchingSwitch = undefined;
         }
         if (this.config.enableRVC === true) {
-            const robot = new RoboticVacuumCleaner('Robot Vacuum', '1238777820');
+            const robot = new RoboticVacuumCleaner('Robot Vacuum', 'RVC1238777820');
             this.setSelectDevice(robot.serialNumber ?? '', robot.deviceName ?? '', undefined, 'hub');
             if (this.validateDevice(robot.deviceName ?? '')) {
                 await this.registerDevice(robot);
                 this.bridgedDevices.set(robot.deviceName ?? '', robot);
             }
         }
-        this.waterHeater = new WaterHeater('Water Heater', '3456177820');
+        this.waterHeater = new WaterHeater('Water Heater', 'WH3456177820', 50, 60, 20, 80, undefined, 85, 220_000, 1_000, 220_000, 12_000_000, 500_000, 3_000_000);
         this.setSelectDevice(this.waterHeater.serialNumber ?? '', this.waterHeater.deviceName ?? '', undefined, 'hub');
         if (this.validateDevice(this.waterHeater.deviceName ?? '')) {
             await this.registerDevice(this.waterHeater);
             this.bridgedDevices.set(this.waterHeater.deviceName ?? '', this.waterHeater);
         }
-        this.evse = new Evse('Evse', '3456127820', 1, [
+        this.evse = new Evse('Evse', 'EV3456127820', 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.PluggedInDemand, EnergyEvse.SupplyState.ChargingEnabled, EnergyEvse.FaultState.NoError, 8_000, 32_000);
+        ], 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.setSelectDevice(this.evse.serialNumber ?? '', this.evse.deviceName ?? '', undefined, 'hub');
         if (this.validateDevice(this.evse.deviceName ?? '')) {
             await this.registerDevice(this.evse);
             this.bridgedDevices.set(this.evse.deviceName ?? '', this.evse);
         }
-        this.solarPower = new SolarPower('Solar Power', 'SP3456127821', 220_000, 10_000, 2200_000, 2_200_000, 1_000_000, 20_000_000);
+        this.solarPower = new SolarPower('Solar Power', 'SP3456127821', 220_000, 10_000, 2200_000, 2_200_000, -10_000_000, 500_000);
         this.setSelectDevice(this.solarPower.serialNumber ?? '', this.solarPower.deviceName ?? '', undefined, 'hub');
         if (this.validateDevice(this.solarPower.deviceName ?? '')) {
             await this.registerDevice(this.solarPower);
             this.bridgedDevices.set(this.solarPower.deviceName ?? '', this.solarPower);
         }
-        this.batteryStorage = new BatteryStorage('Battery Storage', 'BS3456127822', 75, PowerSource.BatChargeLevel.Ok, 220_000, 10_000, 2_200_000, 1_000_000, 2_000_000, 1_000_000, 10_000_000);
+        this.batteryStorage = new BatteryStorage('Battery Storage', 'BS3456127822', 75, PowerSource.BatChargeLevel.Ok, 220_000, 10_000, 2_200_000, 1_000_000, 2_000_000, -2_000_000, 3_000_000);
         this.setSelectDevice(this.batteryStorage.serialNumber ?? '', this.batteryStorage.deviceName ?? '', undefined, 'hub');
         if (this.validateDevice(this.batteryStorage.deviceName ?? '')) {
             await this.registerDevice(this.batteryStorage);
             this.bridgedDevices.set(this.batteryStorage.deviceName ?? '', this.batteryStorage);
         }
+        this.heatPump = new HeatPump('Heat Pump', 'HP1234567890', 220_000, 10_000, 2_200_000, 1_000_000, 500_000, 3_000_000);
+        this.setSelectDevice(this.heatPump.serialNumber ?? '', this.heatPump.deviceName ?? '', undefined, 'hub');
+        if (this.validateDevice(this.heatPump.deviceName ?? '')) {
+            await this.registerDevice(this.heatPump);
+            this.bridgedDevices.set(this.heatPump.deviceName ?? '', this.heatPump);
+        }
         this.laundryWasher = new LaundryWasher('Laundry Washer', 'LW1234567890');
         this.setSelectDevice(this.laundryWasher.serialNumber ?? '', this.laundryWasher.deviceName ?? '', undefined, 'hub');
         if (this.validateDevice(this.laundryWasher.deviceName ?? '')) {

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "1.3.1-dev-20250630-905428f",
+  "version": "1.3.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge-example-dynamic-platform",
-      "version": "1.3.1-dev-20250630-905428f",
+      "version": "1.3.1",
       "license": "Apache-2.0",
       "dependencies": {
         "node-ansi-logger": "3.1.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "1.3.1-dev-20250630-905428f",
+  "version": "1.3.1",
   "description": "Matterbridge dynamic plugin",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",