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

package/CHANGELOG.md

@@ -57,6 +57,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);
@@ -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,12 +1,12 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "3.0.3-dev-20260829-d83e6fe",
+  "version": "3.0.3-dev-20260830-a347a26",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge-example-dynamic-platform",
-      "version": "3.0.3-dev-20260829-d83e6fe",
+      "version": "3.0.3-dev-20260830-a347a26",
       "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-20260829-d83e6fe",
+  "version": "3.0.3-dev-20260830-a347a26",
   "description": "Matterbridge dynamic plugin",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",