matterbridge-example-dynamic-platform 3.0.3-dev-20260829-d83e6fe → 3.0.3

package/CHANGELOG.md

@@ -29,12 +29,12 @@ If you like this project and find it useful, please consider giving it a star on
 
 <a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="120"></a>
 
-## [3.0.3] - Dev branch
+## [3.0.3] - 2026-08-30
 
 ### Breaking changes
 
 - [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.
+- [fanControl]: Matterbridge v.3.10.7 now manages the compliant FanControl `fanMode` and `percentSetting` synchronization; plugins now only update `percentCurrent` as physical device feedback from `fanMode` and `percentSetting`.
 
 ### Added
 
@@ -48,6 +48,8 @@ If you like this project and find it useful, please consider giving it a star on
 - [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.
+- [package]: Bump `node-ansi-logger` to v.3.3.1.
+- [package]: Bump `node-persist-manager` to v.2.1.1.
 
 ### Fixed
 
@@ -57,6 +59,7 @@ If you like this project and find it useful, please consider giving it a star on
 - [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.
+- [illuminance]: `luxToMatter`/`matterToLux` were missing the `+ 1` offset required by the Matter spec's `MeasuredValue = 10,000 x log10(illuminance) + 1` formula (Matter 1.6.0 § 2.2.5.1); every encoded illuminance value was off by 1. Fixed and aligned with the corrected implementation in matterbridge's `packages/utils`.
 
 <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

@@ -2,26 +2,20 @@ import { aggregator, airPurifier, airQualitySensor, bridgedNode, closure, colorT
 import { AirConditioner, BasicVideoPlayer, BatteryStorage, Closure, Cooktop, Dishwasher, Evse, ExtractorHood, HeatPump, IrrigationSystem, LaundryDryer, LaundryWasher, MatterbridgeClosureControlServer, MicrowaveOven, Oven, Refrigerator, RoboticVacuumCleaner, SoilSensor, SolarPower, Speaker, WaterHeater, } from 'matterbridge/devices';
 import { debugStringify } from 'matterbridge/logger';
 import { ClosureCoveringTag, ClosurePanelTag, ClosureTag, ClosureWindowTag, CommonAreaNamespaceTag, CommonLocationTag, CommonNumberTag, CommonPositionTag, RefrigeratorTag, SwitchesTag, UINT16_MAX, UINT32_MAX, } from 'matterbridge/matter';
-import { AirQuality, BooleanState, BridgedDeviceBasicInformation, CarbonDioxideConcentrationMeasurement, CarbonMonoxideConcentrationMeasurement, ClosureControl, ClosureDimension, ColorControl, Descriptor, DeviceEnergyManagement, DoorLock, ElectricalEnergyMeasurement, ElectricalPowerMeasurement, EnergyEvse, EnergyEvseMode, FanControl, FlowMeasurement, FormaldehydeConcentrationMeasurement, Identify, IlluminanceMeasurement, LevelControl, NitrogenDioxideConcentrationMeasurement, OccupancySensing, OnOff, OperationalState, OvenMode, OzoneConcentrationMeasurement, Pm1ConcentrationMeasurement, Pm10ConcentrationMeasurement, Pm25ConcentrationMeasurement, PowerSource, PressureMeasurement, RadonConcentrationMeasurement, RelativeHumidityMeasurement, RvcCleanMode, RvcOperationalState, RvcRunMode, SmokeCoAlarm, TemperatureMeasurement, Thermostat, TotalVolatileOrganicCompoundsConcentrationMeasurement, WindowCovering, } from 'matterbridge/matter/clusters';
+import { AirQuality, BooleanState, BridgedDeviceBasicInformation, CarbonDioxideConcentrationMeasurement, CarbonMonoxideConcentrationMeasurement, ClosureControl, ClosureDimension, ColorControl, DeviceEnergyManagement, DoorLock, ElectricalEnergyMeasurement, ElectricalPowerMeasurement, EnergyEvse, EnergyEvseMode, FanControl, FlowMeasurement, FormaldehydeConcentrationMeasurement, Identify, IlluminanceMeasurement, LevelControl, NitrogenDioxideConcentrationMeasurement, OccupancySensing, OnOff, OperationalState, OvenMode, OzoneConcentrationMeasurement, Pm1ConcentrationMeasurement, Pm10ConcentrationMeasurement, Pm25ConcentrationMeasurement, PowerSource, PressureMeasurement, RadonConcentrationMeasurement, RelativeHumidityMeasurement, RvcCleanMode, RvcOperationalState, RvcRunMode, SmokeCoAlarm, TemperatureMeasurement, Thermostat, TotalVolatileOrganicCompoundsConcentrationMeasurement, WindowCovering, } from 'matterbridge/matter/clusters';
 import { ThreeLevelAuto } from 'matterbridge/matter/types';
-import { fireAndForget, getEnumDescription, isValidBoolean, isValidNumber, isValidObject, isValidString } from 'matterbridge/utils';
+import { fireAndForget, getEnumDescription, isValidBoolean, isValidNumber, isValidObject, isValidString, parseVersionString } from 'matterbridge/utils';
 function luxToMatter(lux) {
-    if (!Number.isFinite(lux) || lux <= 0)
+    if (!Number.isFinite(lux) || lux < 1)
         return 0;
-    const encoded = 10000 * Math.log10(lux);
-    if (!Number.isFinite(encoded) || encoded < 0)
-        return 0;
-    return Math.round(Math.min(encoded, 0xfffe));
+    const encoded = Math.round(10000 * Math.log10(lux) + 1);
+    return Math.min(encoded, 0xfffe);
 }
 function matterToLux(value) {
     if (!Number.isFinite(value) || value <= 0)
         return 0;
     const v = Math.min(value, 0xfffe);
-    const lux = Math.pow(10, v / 10000);
-    return Math.round(lux < 0 ? 0 : lux);
-}
-function isDeviceTypeList(value) {
-    return Array.isArray(value);
+    return Math.round(Math.pow(10, (v - 1) / 10000));
 }
 export default function initializePlugin(matterbridge, log, config) {
     return new ExampleMatterbridgeDynamicPlatform(matterbridge, log, config);
@@ -1319,16 +1313,16 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             const lookupSystemMode = ['Off', 'Auto', '', 'Cool', 'Heat', 'EmergencyHeat', 'Precooling', 'FanOnly', 'Dry', 'Sleep'];
             this.thermoAutoSchedules?.log.info(`Subscribe systemMode called with: ${lookupSystemMode[newValue]} (old value: ${lookupSystemMode[oldValue]})`);
         }, this.thermoAutoSchedules.log);
-        this.thermoAutoSchedules?.subscribeAttribute(Thermostat.id, 'occupiedHeatingSetpoint', (newValue, oldValue) => {
+        this.thermoAutoSchedules?.subscribeAttribute(Thermostat, 'occupiedHeatingSetpoint', (newValue, oldValue) => {
             this.thermoAutoSchedules?.log.info(`Subscribe occupiedHeatingSetpoint called with: ${newValue / 100} (old value: ${oldValue / 100})`);
         }, this.thermoAutoSchedules.log);
-        this.thermoAutoSchedules?.subscribeAttribute(Thermostat.id, 'occupiedCoolingSetpoint', (newValue, oldValue) => {
+        this.thermoAutoSchedules?.subscribeAttribute(Thermostat, 'occupiedCoolingSetpoint', (newValue, oldValue) => {
             this.thermoAutoSchedules?.log.info(`Subscribe occupiedCoolingSetpoint called with: ${newValue / 100} (old value: ${oldValue / 100})`);
         }, this.thermoAutoSchedules.log);
-        this.thermoAutoSchedules?.subscribeAttribute(Thermostat.id, 'activeScheduleHandle', (newValue, oldValue) => {
+        this.thermoAutoSchedules?.subscribeAttribute(Thermostat, 'activeScheduleHandle', (newValue, oldValue) => {
             this.thermoAutoSchedules?.log.info(`Subscribe activeScheduleHandle called with: ${newValue ? `0x${Buffer.from(newValue).toString('hex')}` : 'null'} (old value: ${oldValue ? `0x${Buffer.from(oldValue).toString('hex')}` : 'null'})`);
         }, this.thermoAutoSchedules.log);
-        this.thermoAutoSchedules?.subscribeAttribute(Thermostat.id, 'schedules', (newValue, oldValue) => {
+        this.thermoAutoSchedules?.subscribeAttribute(Thermostat, 'schedules', (newValue, oldValue) => {
             this.thermoAutoSchedules?.log.info(`Subscribe schedules called with: ${debugStringify(newValue)} (old value: ${debugStringify(oldValue)})`);
         }, this.thermoAutoSchedules.log);
         this.thermoHeat = new MatterbridgeEndpoint([thermostat, bridgedNode, powerSource], { id: 'Thermostat (Heat)' }, this.config.debug)
@@ -1366,7 +1360,7 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             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(Thermostat.id, 'occupiedHeatingSetpoint', (value) => {
+        this.thermoHeat?.subscribeAttribute(Thermostat, 'occupiedHeatingSetpoint', (value) => {
             this.thermoHeat?.log.info('Subscribe occupiedHeatingSetpoint called with:', value / 100);
         }, this.thermoHeat.log);
         this.thermoCool = new MatterbridgeEndpoint([thermostat, bridgedNode, powerSource], { id: 'Thermostat (Cool)' }, this.config.debug)
@@ -1386,7 +1380,7 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             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(Thermostat.id, 'occupiedCoolingSetpoint', (value) => {
+        this.thermoCool?.subscribeAttribute(Thermostat, 'occupiedCoolingSetpoint', (value) => {
             this.thermoCool?.log.info('Subscribe occupiedCoolingSetpoint called with:', value / 100);
         }, this.thermoCool.log);
         this.airPurifier = new MatterbridgeEndpoint([airPurifier, bridgedNode, powerSource], { id: 'Air purifier' }, this.config.debug)
@@ -1411,10 +1405,10 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         this.airPurifier?.addCommandHandler('identify', ({ request: { identifyTime } }) => {
             this.airPurifier?.log.info(`Command identify called identifyTime:${identifyTime}`);
         });
-        this.airPurifier?.subscribeAttribute(FanControl.id, 'fanMode', (newValue, oldValue, context) => {
+        this.airPurifier?.subscribeAttribute(FanControl, 'fanMode', (newValue, oldValue, context) => {
             this.airPurifier?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
         }, this.airPurifier.log);
-        this.airPurifier?.subscribeAttribute(FanControl.id, 'percentSetting', (newValue, oldValue, context) => void (async () => {
+        this.airPurifier?.subscribeAttribute(FanControl, 'percentSetting', (newValue, oldValue, context) => void (async () => {
             this.airPurifier?.log.info(`Percent setting changed from ${oldValue} to ${newValue} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
             if (context.fabric === undefined)
                 return;
@@ -1941,10 +1935,10 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             await this.airConditioner?.setAttribute(RelativeHumidityMeasurement.id, 'measuredValue', null, this.airConditioner?.log);
             await this.airConditioner?.setAttribute(FanControl.id, 'percentSetting', 0, this.airConditioner?.log);
         });
-        this.airConditioner?.subscribeAttribute(FanControl.id, 'fanMode', (newValue, oldValue, context) => {
+        this.airConditioner?.subscribeAttribute(FanControl, 'fanMode', (newValue, oldValue, context) => {
             this.airConditioner?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
         }, this.airConditioner?.log);
-        this.airConditioner?.subscribeAttribute(FanControl.id, 'percentSetting', (newValue, oldValue, context) => void (async () => {
+        this.airConditioner?.subscribeAttribute(FanControl, 'percentSetting', (newValue, oldValue, context) => void (async () => {
             this.airConditioner?.log.info(`Percent setting changed from ${oldValue} to ${newValue} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
             if (context.fabric === undefined)
                 return;
@@ -2564,18 +2558,18 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         if (this.config.useInterval) {
             this.addInterval(async () => {
                 let mode = this.fanDefault?.getAttribute(FanControl, 'fanMode', this.fanDefault.log);
-                let value = this.fanDefault?.getAttribute(FanControl, 'percentCurrent', this.fanDefault.log);
-                if (isValidNumber(mode, FanControl.FanMode.Off, FanControl.FanMode.Auto) && mode === FanControl.FanMode.Auto && isValidNumber(value, 0, 100)) {
-                    value = value + 10 >= 100 ? 0 : value + 10;
-                    await this.fanDefault?.setAttribute(FanControl, 'percentCurrent', value, this.fanDefault.log);
-                    this.fanDefault?.log.info(`Set fan percentCurrent to ${value}`);
+                let current = this.fanDefault?.getAttribute(FanControl, 'percentCurrent', this.fanDefault.log);
+                if (isValidNumber(mode, FanControl.FanMode.Off, FanControl.FanMode.Auto) && mode === FanControl.FanMode.Auto && isValidNumber(current, 0, 100)) {
+                    current = current + 10 >= 100 ? 0 : current + 10;
+                    await this.fanDefault?.setAttribute(FanControl, 'percentCurrent', current, this.fanDefault.log);
+                    this.fanDefault?.log.info(`Set fan percentCurrent to ${current}`);
                 }
                 mode = this.fanComplete?.getAttribute(FanControl, 'fanMode', this.fanComplete.log);
-                value = this.fanComplete?.getAttribute(FanControl, 'percentCurrent', this.fanComplete.log);
-                if (isValidNumber(mode, FanControl.FanMode.Off, FanControl.FanMode.Auto) && mode === FanControl.FanMode.Auto && isValidNumber(value, 0, 100)) {
-                    value = value + 10 >= 100 ? 0 : value + 10;
-                    await this.fanComplete?.setAttribute(FanControl, 'percentCurrent', value, this.fanComplete.log);
-                    this.fanComplete?.log.info(`Set fan percentCurrent to ${value}`);
+                current = this.fanComplete?.getAttribute(FanControl, 'percentCurrent', this.fanComplete.log);
+                if (isValidNumber(mode, FanControl.FanMode.Off, FanControl.FanMode.Auto) && mode === FanControl.FanMode.Auto && isValidNumber(current, 0, 100)) {
+                    current = current + 10 >= 100 ? 0 : current + 10;
+                    await this.fanComplete?.setAttribute(FanControl, 'percentCurrent', current, this.fanComplete.log);
+                    this.fanComplete?.log.info(`Set fan percentCurrent to ${current}`);
                 }
             }, 60 * 1000 + 700);
         }
@@ -2699,14 +2693,14 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             return undefined;
         this.setSelectDevice(device.serialNumber, device.deviceName, undefined, 'hub');
         if (this.validateDevice(device.deviceName)) {
-            device.softwareVersion = Number.parseInt(this.version.replace(/\D/g, ''));
+            device.softwareVersion = parseVersionString(this.version);
             device.softwareVersionString = this.version === '' ? 'Unknown' : this.version;
-            device.hardwareVersion = Number.parseInt(this.matterbridge.matterbridgeVersion.replace(/\D/g, ''));
+            device.hardwareVersion = parseVersionString(this.matterbridge.matterbridgeVersion);
             device.hardwareVersionString = this.matterbridge.matterbridgeVersion;
             device.softwareVersion = isValidNumber(device.softwareVersion, 0, UINT32_MAX) ? device.softwareVersion : undefined;
-            device.softwareVersionString = isValidString(device.softwareVersionString) ? device.softwareVersionString.slice(0, 64) : undefined;
+            device.softwareVersionString = isValidString(device.softwareVersionString, 1) ? device.softwareVersionString.slice(0, 64) : undefined;
             device.hardwareVersion = isValidNumber(device.hardwareVersion, 0, UINT16_MAX) ? device.hardwareVersion : undefined;
-            device.hardwareVersionString = isValidString(device.hardwareVersionString) ? device.hardwareVersionString.slice(0, 64) : undefined;
+            device.hardwareVersionString = isValidString(device.hardwareVersionString, 1) ? device.hardwareVersionString.slice(0, 64) : undefined;
             const options = device.getClusterServerOptions(BridgedDeviceBasicInformation.id);
             if (options) {
                 options.softwareVersion = device.softwareVersion ?? 1;
@@ -2714,17 +2708,6 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
                 options.hardwareVersion = device.hardwareVersion ?? 1;
                 options.hardwareVersionString = device.hardwareVersionString ?? '1.0.0';
             }
-            if (device.mode === undefined && !device.deviceTypes.has(bridgedNode.code)) {
-                device.deviceTypes.set(bridgedNode.code, bridgedNode);
-                const options = device.getClusterServerOptions(Descriptor);
-                const deviceTypeList = options?.deviceTypeList;
-                if (isDeviceTypeList(deviceTypeList)) {
-                    if (!deviceTypeList.find((dt) => dt.deviceType === bridgedNode.code)) {
-                        deviceTypeList.push({ deviceType: bridgedNode.code, revision: bridgedNode.revision });
-                    }
-                }
-                device.createDefaultBridgedDeviceBasicInformationClusterServer(device.deviceName, device.serialNumber, device.vendorId, device.vendorName, device.productName, device.softwareVersion, device.softwareVersionString, device.hardwareVersion, device.hardwareVersionString);
-            }
             await this.registerDevice(device);
             return device;
         }

package/npm-shrinkwrap.json

@@ -1,16 +1,16 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "3.0.3-dev-20260829-d83e6fe",
+  "version": "3.0.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge-example-dynamic-platform",
-      "version": "3.0.3-dev-20260829-d83e6fe",
+      "version": "3.0.3",
       "license": "Apache-2.0",
       "dependencies": {
-        "node-ansi-logger": "3.3.0",
-        "node-persist-manager": "2.1.0"
+        "node-ansi-logger": "3.3.1",
+        "node-persist-manager": "2.1.1"
       },
       "engines": {
         "node": ">=20.19.0 <21.0.0 || >=22.13.0 <23.0.0 || >=24.0.0 <25.0.0 || >=26.0.0 <27.0.0"
@@ -21,9 +21,9 @@
       }
     },
     "node_modules/node-ansi-logger": {
-      "version": "3.3.0",
-      "resolved": "https://registry.npmjs.org/node-ansi-logger/-/node-ansi-logger-3.3.0.tgz",
-      "integrity": "sha512-ZW77lbZkA8h3r2HA2rcE5RjTIcwRDNB072RkZVyimGQpmEorJT8ajZ7UDhkHGoh0JRrCJL0iUKBE8q4oU8MHMg==",
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/node-ansi-logger/-/node-ansi-logger-3.3.1.tgz",
+      "integrity": "sha512-JjkQHtVKgyd5Ua4AkYCFsZZiUYMrPsj/S9k2VY8/FjYuFJFRjDawsuxMwaThhWu4oU7zwuqvDG2uoDnjUyApVw==",
       "hasShrinkwrap": true,
       "license": "Apache-2.0",
       "engines": {
@@ -35,9 +35,9 @@
       }
     },
     "node_modules/node-persist-manager": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/node-persist-manager/-/node-persist-manager-2.1.0.tgz",
-      "integrity": "sha512-LJze/Fcd8LijM4OMPnp0AQ+Z1e9mFMkjOEDw08xHA2HSRd2+N5s0uyH5ogYmXPC68f0sc4GrdKMpAcsHuO3PKA==",
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/node-persist-manager/-/node-persist-manager-2.1.1.tgz",
+      "integrity": "sha512-cAqF2spTnzDSAQeORHy/OYdD1VROGZ6UiLjmq/gVxQ4EglB0Ro0QX83U+xHEh2G6b7HTvGFqjS/R9LTOGkcayw==",
       "hasShrinkwrap": true,
       "license": "Apache-2.0",
       "dependencies": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "3.0.3-dev-20260829-d83e6fe",
+  "version": "3.0.3",
   "description": "Matterbridge dynamic plugin",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",
@@ -68,7 +68,7 @@
     "*.schema.json"
   ],
   "dependencies": {
-    "node-ansi-logger": "3.3.0",
-    "node-persist-manager": "2.1.0"
+    "node-ansi-logger": "3.3.1",
+    "node-persist-manager": "2.1.1"
   }
 }