Release 3.10.7

[3.10.7] - 2026-08-28

Development Breaking Changes

• [RoboticVacuumCleaner]: The constructor now accepts a RoboticVacuumCleanerOptions object as its third parameter, consolidating mode, RVC mode, operational-state, service-area, id, number, and tagList configuration. The legacy positional parameter shape remains supported but is deprecated; update calls to new RoboticVacuumCleaner(name, serial, { ...options }).
• [Appliances]: All Chapter 13 appliance constructors now accept an options object for endpoint and initial cluster configuration, including mode, id, number, and tagList. Existing defaults and two-argument name, serial construction are preserved. The following legacy positional configuration signatures remain supported but are deprecated:
  • new LaundryWasher(name, serial, currentMode, ...); use new LaundryWasher(name, serial, { ...options }).
  • new Refrigerator(name, serial, currentMode, ...); use new Refrigerator(name, serial, { ...options }).
  • new Dishwasher(name, serial, currentMode, ...); use new Dishwasher(name, serial, { ...options }).
  • new LaundryDryer(name, serial, currentMode, ...); use new LaundryDryer(name, serial, { ...options }).
  • new ExtractorHood(name, serial, hepaCondition, ...); use new ExtractorHood(name, serial, { ...options }).
  • new MicrowaveOven(name, serial, currentMode, ...); use new MicrowaveOven(name, serial, { ...options }).
  • Refrigerator.addCabinet(name, tagList, ...); use Refrigerator.addCabinet(name, { ...options }).
  • Oven.addCabinet(name, tagList, ...); use Oven.addCabinet(name, { ...options }).
  • Cooktop.addSurface(name, tagList, ...); use Cooktop.addSurface(name, { ...options }).
• [Energy devices]: The Chapter 14 EVSE and energy-device constructors now accept an options object for endpoint and initial cluster configuration, including mode, id, number, and tagList. Existing defaults and two-argument name, serial construction are preserved. The following legacy positional configuration signatures remain supported but are deprecated:
  • new Evse(name, serial, currentMode, ...); use new Evse(name, serial, { ...options }).
  • new WaterHeater(name, serial, waterTemperature, ...); use new WaterHeater(name, serial, { ...options }).
  • new SolarPower(name, serial, voltage, ...); use new SolarPower(name, serial, { ...options }).
  • new BatteryStorage(name, serial, batPercentRemaining, ...); use new BatteryStorage(name, serial, { ...options }).
  • new HeatPump(name, serial, voltage, ...); use new HeatPump(name, serial, { ...options }).

Development News

• [chip]: EnergyEvse endpoint 1401 CHIP conformance is green ✅ for all applicable automated harness tests covering the EnergyEvse cluster.
• [chip]: EnergyEvseMode endpoint 1401 CHIP conformance is green ✅ for the automated harness tests covering the EnergyEvseMode cluster.
• [chip]: Electrical Utility Meter endpoint 1409 CHIP conformance is green ✅ for the automated harness tests covering the MeterIdentification cluster.
• [chip]: Electrical Meter endpoint 14091 CHIP conformance is green ✅ for the automated harness tests covering the CommodityMetering cluster.
• [chip]: Electrical Energy Tariff endpoint 14092 CHIP conformance is green ✅ for all applicable automated harness tests covering the CommodityPrice cluster.
• [chip]: Electrical Energy Tariff endpoint 14092 CHIP conformance is green ✅ for all automated harness tests covering the CommodityTariff cluster.
• [chip]: PowerTopology endpoints 206, 2061, 2062, and 2063 CHIP conformance is green ✅ for all automated harness tests covering the PowerTopology cluster.
• [chip]: MicrowaveOven endpoint 1311 CHIP conformance is green ✅ for all automated harness tests covering the MicrowaveOvenMode and MicrowaveOvenControl clusters.
• [chip]: ExtractorHood endpoint 1310 CHIP conformance is green ✅ for all automated harness tests covering the base FanControl, HepaFilterMonitoring, and ActivatedCarbonFilterMonitoring clusters.
• [chip]: Oven Cabinet endpoint 13091 CHIP conformance is green ✅ for all applicable automated harness tests covering the OvenMode and OvenCavityOperationalState clusters.
• [chip]: Cooktop endpoint 1308 CHIP conformance is green ✅ for all applicable automated harness tests covering the OffOnlyOnOff and FixedLabel clusters.
• [chip]: LaundryDryer endpoint 1306 CHIP conformance is green ✅ for all applicable automated harness tests covering the LaundryDryerControls cluster.
• [chip]: Dishwasher endpoint 1305 CHIP conformance is green ✅ for all applicable automated harness tests covering the DishwasherMode and DishwasherAlarm clusters.
• [chip]: Refrigerator endpoint 1302 CHIP conformance is green ✅ for all applicable automated harness tests covering the RefrigeratorAndTemperatureControlledCabinetMode and RefrigeratorAlarm clusters.
• [chip]: LaundryWasher endpoint 1301 CHIP conformance is green ✅ for the automated harness tests covering the LaundryWasherMode cluster.
• [chip]: RoboticVacuumCleaner endpoint 1201 CHIP conformance is green ✅ for the automated harness tests covering the RvcRunMode cluster.
• [chip]: RoboticVacuumCleaner endpoint 1201 CHIP conformance is green ✅ for the automated harness tests covering the RvcCleanMode cluster.
• [chip]: RoboticVacuumCleaner endpoint 1201 CHIP conformance is green ✅ for the automated harness tests covering the RvcOperationalState cluster.
• [chip]: RoboticVacuumCleaner endpoint 1201 CHIP conformance is green ✅ for the automated harness tests covering the ServiceArea cluster.
• [chip]: ClosureComplete endpoint 8054 CHIP conformance is green ✅ for the automated harness tests covering the ClosureControl cluster.
• [chip]: WaterValve endpoint 506 CHIP conformance is green ✅ for the automated harness tests covering the ValveConfigurationAndControl cluster.
• [chip]: IrrigationSystem endpoint 507 CHIP conformance is green ✅ for the automated harness tests covering the OperationalState cluster.
• [chip]: Pump endpoint 505 CHIP conformance is green ✅ for the automated harness tests covering the PumpConfigurationAndControl cluster.

Added

• [chip]: Add all applicable Matter 1.6 EnergyEvse and EnergyEvseMode tests for endpoint 1401, with dedicated PICS; patch TC_EEVSE_2_2 so its UserMaximumChargeCurrent write targets the configured EVSE endpoint instead of the upstream test's hardcoded endpoint 1.
• [chip]: Add all seven Matter 1.6 Oven Mode and Oven Cavity Operational State tests for Oven Cabinet endpoint 13091 with dedicated PICS and documented applicability and conformance findings.
• [chip]: Add all Matter 1.6 OnOff and Fixed Label tests for Cooktop endpoint 1308 with dedicated PICS; patch the generic OnOff primary and OffOnly tests so their command guards correctly exercise an OffOnly server.
• [chip]: Add the Matter 1.6 Laundry Dryer Controls server test for endpoint 1306 with dedicated PICS; patch its unencodable undefined-enum write while retaining attribute, supported-list, valid-write, readback, and applicable state coverage.
• [chip]: Add all nine Matter 1.6 Dishwasher Mode and Dishwasher Alarm server tests for endpoint 1305, with dedicated PICS and app-pipe mode-transition control.
• [chip]: Add all Refrigerator Mode and Refrigerator Alarm server tests for endpoint 1302, with dedicated PICS and automated door-state/Notify-event control for TC_REFALM_2_2.
• [LaundryWasher]: Add MatterbridgeLaundryWasherControlsServer with Matter 1.6-compliant SpinSpeedCurrent write validation for the Spin and Rinse feature combination.
• [demoDevices]: Add a second Laundry Washer device exposing TemperatureControl with the TemperatureNumber and TemperatureStep features, alongside the existing TemperatureLevel washer.
• [chip]: Add all applicable Laundry Washer server tests for DeadFrontOnOff, LaundryWasherMode, LaundryWasherControls, NumberTemperatureControl, and LevelTemperatureControl, with dedicated PICS files. Patch TC_WASHERCTRL_2_2 to omit its unencodable undefined-enum write while retaining its attribute, supported-list, valid-write, and readback coverage.
• [demoDevices]: Add all Chapter 12 and Chapter 13 device types, including the Robotic Vacuum Cleaner, every appliance device, composed refrigerator/freezer cabinets, four Cook Surface endpoints, and double-oven cabinets.
• [Closure]: Add the optional ventilation, pedestrian, and calibration options to the Closure constructor. Each option defaults to false and enables the corresponding ClosureControl feature when set to true. The Calibration feature also adds the Calibrate command forwarder and conformant Calibrating state behavior.
• [WaterValve]: MatterbridgeValveConfigurationAndControlServer now implements the Matter 1.6 ValveConfigurationAndControl Open/Close state machine (TargetState/TargetLevel/RemainingDuration transitions, fault handling) and can simulate the Open/Close movement duration and RemainingDuration countdown/auto-close, opt-in via the new state.movementDuration/state.autoClose (both disabled by default; automatically enabled under MATTERBRIDGE_CHIP_TEST).
• [WaterValve]: Add the optional movementDuration and autoClose parameters to createDefaultValveConfigurationAndControlClusterServer(), to enable the built-in Open/Close movement and RemainingDuration auto-close simulation for endpoints with no real device implementation managing the valve.
• [IrrigationSystem]: Add the optional movementDuration and autoClose parameters to IrrigationSystem.addZone(), passed through to the zone's ValveConfigurationAndControl cluster server.
• [OperationalState]: MatterbridgeOperationalStateServer now implements the Matter 1.6 OperationalState cluster's Pause/Resume compatibility tables, rejects Start with UnableToStartOrResume from the Error state, and emits t...

Release 3.10.6

[3.10.6] - 2026-08-21

Development Breaking Changes

• [devices]: The Speaker constructor now takes a SpeakerOptions object as its third parameter instead of separate muted/volume positional parameters. Update new Speaker(name, serial, muted, volume) calls to new Speaker(name, serial, { muted, volume }). The options object also adds powerSourceType (defaults to 'Wired', added a PowerSource cluster server that previous versions did not create; pass 'None' to omit it), id and number.

Development News

• [chip]: Root endpoint 0 CHIP conformance is green ✅ for the automated harness tests covering the RootNode device type and BasicInformation, PowerSource, AccessControl, GeneralDiagnostics, GroupKeyManagement, OperationalCredentials and GeneralCommissioning clusters.
• [chip]: Aggregator endpoint 1 CHIP conformance is green ✅ for the automated harness tests covering the Aggregator device type.
• [chip]: ElectricalSensor endpoint 206 CHIP conformance is green ✅ for the automated harness tests covering the ElectricalSensor device type and ElectricalPowerMeasurement ElectricalEnergyMeasurement clusters.
• [chip]: DeviceEnergyManagement endpoint 207 CHIP conformance is green ✅ for the automated harness tests covering the DeviceEnergyManagement device type and DeviceEnergyManagement DeviceEnergyManagementMode clusters.
• [chip]: OnOffLight endpoint 401 CHIP conformance is green ✅ for the automated harness tests covering the OnOffLight device type and the OnOff cluster.
• [chip]: DimmableLight endpoint 402 CHIP conformance is green ✅ for the automated harness tests covering the DimmableLight device type and the LevelControl cluster.
• [chip]: ContactSensor endpoint 701 CHIP conformance is green ✅ for the automated harness tests covering the ContactSensor device type and the BooleanState, BooleanStateConfiguration, Identify, PowerSource and BridgedDeviceBasicInformation clusters.
• [chip]: LightSensor endpoint 702 CHIP conformance is green ✅ for the automated harness tests covering the LightSensor device type and the IlluminanceMeasurement cluster.
• [chip]: OccupancySensor endpoint 703 CHIP conformance is green ✅ for the automated harness tests covering the OccupancySensor device type and the OccupancySensing cluster.
• [chip]: TemperatureSensor endpoint 704 CHIP conformance is green ✅ for the automated harness tests covering the TemperatureSensor device type and the TemperatureMeasurement cluster.
• [chip]: PressureSensor endpoint 705 CHIP conformance is green ✅ for the automated harness tests covering the PressureSensor device type and the PressureMeasurement cluster.
• [chip]: FlowSensor endpoint 706 CHIP conformance is green ✅ for the automated harness tests covering the FlowSensor device type and the FlowMeasurement cluster.
• [chip]: HumiditySensor endpoint 707 CHIP conformance is green ✅ for the automated harness tests covering the HumiditySensor device type and the RelativeHumidityMeasurement cluster.
• [chip]: OnOffSensor endpoint 708 CHIP conformance is green ✅ for the automated harness tests covering the OnOffSensor device type.
• [chip]: SmokeCOAlarm endpoints 709, 7091 and 7092 CHIP conformance is green ✅ for the automated harness tests covering the SmokeCOAlarm device type and the SmokeCOAlarm cluster with the complete, smoke-only and CO-only feature sets.
• [chip]: AirQualitySensor endpoint 710 CHIP conformance is green ✅ for the automated harness tests covering the AirQualitySensor device type and the AirQuality, CarbonMonoxideConcentrationMeasurement, CarbonDioxideConcentrationMeasurement, NitrogenDioxideConcentrationMeasurement, OzoneConcentrationMeasurement, FormaldehydeConcentrationMeasurement, Pm1ConcentrationMeasurement, Pm25ConcentrationMeasurement, Pm10ConcentrationMeasurement, RadonConcentrationMeasurement and TotalVolatileOrganicCompoundsConcentrationMeasurement clusters.
• [chip]: WaterFreezeDetector endpoint 711 CHIP conformance is green ✅ for the automated harness tests covering the WaterFreezeDetector device type and the BooleanState and BooleanStateConfiguration clusters.
• [chip]: WaterLeakDetector endpoint 712 CHIP conformance is green ✅ for the automated harness tests covering the WaterLeakDetector device type and the BooleanState and BooleanStateConfiguration clusters.
• [chip]: RainSensor endpoint 713 CHIP conformance is green ✅ for the automated harness tests covering the RainSensor device type and the BooleanState and BooleanStateConfiguration clusters.
• [chip]: SoilSensor endpoint 714 CHIP conformance is green ✅ for the automated harness tests covering the SoilSensor device type and the SoilMeasurement cluster.
• [chip]: FanComplete endpoint 9024 CHIP conformance is green ✅ for the automated harness tests covering the Fan device type and FanControl clusters.
• [chip]: AirPurifier endpoint 903 CHIP conformance is green ✅ for the automated harness tests covering the AirPurifier device type and the HepaFilterMonitoring and ActivatedCarbonFilterMonitoring clusters.
• [electricalSensor]: Add electrical measurement helpers: createImportedElectricalEnergyMeasurementClusterServer() and createExportedElectricalEnergyMeasurementClusterServer(). Used to create import (cunsume) only and export (produce) only electrical sensors.

Added

• [electricalUtilityMeter]: Add ElectricalUtilityMeter device class (Electrical Utility Meter device type, superset of Meter Reference Point) with the MeterIdentification cluster.
• [electricalUtilityMeter]: Add addElectricalMeter() to add an Electrical Meter (+ Electrical Sensor) child endpoint with ElectricalPowerMeasurement, ElectricalEnergyMeasurement and CommodityMetering.
• [electricalUtilityMeter]: Add addElectricalEnergyTariff() to add an Electrical Energy Tariff child endpoint with CommodityPrice, CommodityTariff and ElectricalGridConditions.
• [electricalSensor]: Add electrical measurement helpers: createImportedElectricalEnergyMeasurementClusterServer() and createExportedElectricalEnergyMeasurementClusterServer().
• [booleanStateConfiguration]: Add SuppressAlarm command forwarding. The BooleanStateConfiguration cluster is always optional so it needs to be add with createDefaultBooleanStateConfigurationClusterServer().
• [booleanStateConfiguration]: Add automatic AlarmsStateChanged and SensorFault event emission.
• [occupancySensing]: Add MatterbridgeOccupancySensingServer to mirror Matter 1.6 HoldTime with the legacy PIROccupiedToUnoccupiedDelay attribute when both are exposed for backward compatibility.
• [concentrationMeasurement]: Add optional minMeasuredValue and maxMeasuredValue parameters to createDefaultTvocMeasurementClusterServer().
• [frontend]: Add Soil Sensor and On/Off Sensor device icons.
• [frontend]: Add AC/DC current tooltips and full/differentiated battery level bar icons to the Home Devices power column.
• [chip]: Add Chip Test stack.
• [chip]: Add Chip Test pipe.
• [chip]: Add Chip Test TestEventTrigger.

Changed

• [matterbridge]: Bump matterbridge version to v.3.10.6.
• [matterbridge]: Bump @types/node to v.26.2.0.
• [matterbridge]: Bump oxfmt to v.0.63.0.
• [matterbridge]: Bump oxlint to v.1.78.0.
• [core]: Bump ws to v.8.21.3.
• [powerSource]: Change createDefaultPowerSourceBatteryClusterServer() defaults to batPercentRemaining 100 and batVoltage 1500.
• [measurement]: Add optional tolerance parameter to createDefaultTemperatureMeasurementClusterServer(), createDefaultRelativeHumidityMeasurementClusterServer(), createDefaultPressureMeasurementClusterServer(), createDefaultIlluminanceMeasurementClusterServer() and createDefaultFlowMeasurementClusterServer(), and add optional lightSensorType parameter to createDefaultIlluminanceMeasurementClusterServer().
• [thread]: Bump @zip.js/zip.js to v.2.8.49.
• [frontend]: Bump frontend version to v.3.5.8.
• [frontend]: Refactor the Devices Icons and Devices Table views to render all device types consistently, including their clusters.
• [frontend]: Bump @testing-library/jest-dom to v.7.0.1.
• [frontend]: Bump @types/node to v.26.2.0.
• [frontend]: Bump globals to v.17.11.0.
• [frontend]: Bump oxfmt to v.0.63.0.
• [frontend]: Bump oxlint to v.1.78.0.
• [irrigationSystem]: Bump IrrigationSystem to v.1.1.0.
• [fanControl]: Bump MatterbridgeFanControlServer to v.2.0.0 (fully Matter 1.6.0 compliant).

Fixed

• [frontend]: Fix FlowMeasurement unit in the Devices Icon and Table views: the raw measuredValue (10 x m³/h) was shown unconverted and labelled l/h; now divided by 10 and labelled m³/h.
• [frontend]: Apply the trailing-slash normalization of a device configUrl to the path only, so query strings are no longer corrupted (#579). Thanks Sebastian RAFF.
• [thermostat]: Apply thermostat suggestions: AddThermostatSuggestion/RemoveThermostatSuggestion now re-evaluate CurrentThermostatSuggestion, syncing ActivePresetHandle and clearing ThermostatSuggestionNotFollowingReason, and prune expired entries from ThermostatSuggestions. Thanks Ludovic BOUÉ.
• [thermostat]: Cascade Preset removal to ThermostatSuggestions. Thanks Ludovic BOUÉ.

Release 3.10.5

[3.10.5] - 2026-08-14

Development news

• [closure]: Closure device is released for production and fully Matter 1.6.0 compliant (all chip tests pass). So far fully supported by SmartThings and partially by Matter Server dashboard.

Added

• [closureControl]: Refactor MoveTo target-state fallbacks and set the main state to Stopped when the closure is already at the requested target, or Moving otherwise.
• [closureControl]: Add the conformance to specs for MoveTo: reject the command with INVALID_COMMAND when none of Position, Latch, or Speed are present.
• [closureControl]: Add Closure.setState(), Closure.setFullyClosed(), Closure.setFullOpened() and Closure.setPartiallyOpened() helpers.
• [closureControl]: Add Closure.triggerOperationalError(), Closure.triggerMovementCompleted() and Closure.triggerSecureStateChanged() helpers to emit the OperationalError, MovementCompleted and SecureStateChanged ClosureControl events.
• [closureControl]: Add identifyTime, identifyType, and powerSourceType constructor options to Closure.
• [closureDimension]: Use the Matter Auto fallback when SetTarget omits speed.
• [closureDimension]: Add the conformance to specs for Step: reject the command with CONSTRAINT_ERROR when Direction, NumberOfSteps, or Speed are out of range.
• [thermostat]: Add Thermostat.Feature.MatterScheduleConfiguration support with schedule attributes and SetActiveScheduleRequest handling. Thanks Ludovic BOUÉ.
• [thermostat]: Add Thermostat.Feature.ThermostatSuggestions support with suggestion attributes and AddThermostatSuggestion/RemoveThermostatSuggestion handling. Thanks Ludovic BOUÉ.

Changed

• [frontend]: Bump frontend version to v.3.5.7.
• [frontend]: Remove bun version from Header.
• [thermostat]: Align numberOfPresets with the configured preset capacity and the Matter specification minimum. Thanks Ludovic BOUÉ.

Fixed

• [irrigationSystem]: Remove the non-functional singleZone option; single-zone systems must now use addZone like any other zone.
• [microwaveOven]: Use the PowerAsNumber and PowerNumberLimits features instead of PowerInWatts for the MicrowaveOvenControl cluster, and handle the PowerSetting field in SetCookingParameters accordingly.
• [closureDimension]: ClosurePanel and Closure.addPanel() now require a dimensionType ('lift', 'tilt' or 'modulation') and enable the matching Translation/Rotation/Modulation feature, as required by the [PS].b conformance rule when Positioning is supported.
• [thermostat]: Remove the workaround that stripped the AtomicRequest/AtomicResponse commands from acceptedCommandList/generatedCommandList on MatterbridgeThermostatServer; matter.js now handles the atomic-write commands correctly.
• [data-model]: Fix missed namspaces.

Release 3.10.4

[3.10.4] - 2026-08-07

Development changes

• [instructions]: Add CHIP test and plugin frontend agents (Copilot, Claude and Codex) instruction files and update Development Guide.

Development breaking changes

• [onOff]: MatterbridgeOnOffServer now bakes in the Lighting feature, so always use MatterbridgeOnOffServer.with() instead of the bare class for endpoints created without the Lighting feature.

Added

• [frontend]: Add icons for the chapter 16 Camera device types (Camera, FloodlightCamera, VideoDoorbell, Intercom, AudioDoorbell, SnapshotCamera, Chime, CameraController and Doorbell). See matterbridge-example-camera for a fully working and Matter compliant example of chapter 16 device types.
• [matterbridgeEndpoint]: Document AutoMode thermostat deadband limit requirements.
• [onOff]: Implement forward for offWithEffect, onWithRecallGlobalScene and onWithTimedOff commands.
• [levelControl]: Implement forward for move, moveWithOnOff, step, stepWithOnOff, stop and stopWithOnOff commands.
• [colorControl]: Implement forward for moveHue, stepHue, enhancedMoveHue, enhancedStepHue, moveSaturation, stepSaturation, moveColor, stepColor, moveColorTemperature and stepColorTemperature commands.

Changed

• [matterbridge]: Bump matterbridge version to v.3.10.4.
• [matterbridge]: Bump @matter/main to v.0.17.8.
• [matterbridge]: Bump @matter/main to v.0.17.9.
• [matterbridge]: Bump @types/node to v.26.1.2.
• [matterbridge]: Bump marked to v.18.0.9.
• [matterbridge]: Bump oxfmt to v.0.62.0.
• [matterbridge]: Bump oxlint to v.1.77.0.
• [core]: Bump express-rate-limit to v.8.6.2.
• [core]: Bump ws to v.8.21.2.
• [thread]: Bump @zip.js/zip.js to v.2.8.34.
• [frontend]: Bump frontend version to v.3.5.6.
• [frontend]: Bump @rjsf packages to v.6.7.1.
• [frontend]: Bump globals to v.17.9.0.
• [frontend]: Bump jsdom to v.30.0.1.
• [frontend]: Bump vite to v.8.2.1.
• [frontend]: Bump @vitejs/plugin-react to v.6.0.5.
• [frontend]: Bump oxfmt to v.0.62.0.
• [frontend]: Bump oxlint to v.1.77.0.
• [frontend]: Remove from SystemInfoTable node version and show bun version when running with the bun runtime.
• [frontend]: Update MatterbridgeInfoTable and SystemInfoTable.
• [frontend]: Update Setting System info table to show bun version when running with the bun runtime.
• [docs]: Update statistics in index.html for community plugins and downloads.
• [docs]: Update Bun guide.

Fixed

• [AirConditioner]: Use valid default AutoMode thermostat limits for the 1°C deadband.
• [publish]: Wait 1 minute for npm registry propagation before triggering Docker builds.
• [frontend]: Update MbfScreen desktop layout test for jsdom v.30.x computed style behavior.

Release 3.10.3

[3.10.3] - 2026-07-31

Added

• [publish]: Update publish script to allow a re-run.
• [matterbridge]: Add a wired AC PowerSource to server nodes.

Changed

• [matterbridge]: Bump matterbridge version to v.3.10.3.
• [matterbridge]: Update dependencies.
• [matterbridge]: Upgrade package.
• [matterbridge]: Bump @matter/main to v.0.17.7.
• [matterbridge]: Bump oxfmt to v.0.60.0.
• [matterbridge]: Bump oxlint to v.1.75.0.
• [matterbridge]: Bump oxlint-tsgolint to v.7.0.2001.
• [chip-test]: Switch Dockerfile from master to v1.6-branch.
• [frontend]: Bump frontend version to v.3.5.5.
• [frontend]: Update dependencies.
• [frontend]: Ignore for now plugins: matterbridge-camera and matterbridge-webcam.
• [frontend]: Bump react and react-dom to v.19.2.8.
• [frontend]: Bump react-router to v.8.3.0.
• [frontend]: Bump @testing-library/jest-dom to v.7.0.0.
• [frontend]: Bump @vitejs/plugin-react to v.6.0.4.
• [frontend]: Bump oxfmt to v.0.60.0.
• [frontend]: Bump oxlint to v.1.75.0.
• [frontend]: Bump oxlint-tsgolint to v.7.0.2001.
• [helpers]: Add ActiveBatFaults[] to PowerSource Battery helpers.

Fixed

• [frontend]: The Devices page now reloads the contents at restart.

Release 3.10.2

[3.10.2] - 2026-07-24

Added

• [devcontainer]: Add a double Node/Bun Dev Container setup where VS Code lets you choose one profile or the other.
• [devcontainer]: The Bun Dev Container profile builds in a fraction of the time compared to the Node profile, confirming how impressive the Bun runtime is.
• [devcontainer]: Add dedicated .devcontainer/node and .devcontainer/bun profiles with their own Dockerfile, docker-compose, and create/start scripts.
• [devices]: Add tagList support to the ClosureOptions used by the Closure device constructor. Thanks Ludovic BOUÉ.
• [closure]: Add countdownTime, mainState, currentErrorList, overallCurrentState, overallTargetState, and latchControlModes support to the ClosureOptions used by the Closure device constructor.
• [devices]: Add addPanel() to the Closure device and tagList support to ClosurePanelOptions to compose closures with multiple closure panels (e.g. a venetian blind with ClosurePanelTag.Lift and ClosurePanelTag.Tilt panels). Thanks Ludovic BOUÉ.

Changed

• [matterbridge]: Bump matterbridge version to v.3.10.1.
• [matterbridge]: Update dependencies.
• [matterbridge]: Bump @matter/main to v.0.17.6.
• [matterbridge]: Bump oxlint-tsgolint to v.0.25.0.
• [frontend]: Bump frontend version to v.3.5.4.
• [frontend]: Update dependencies.
• [frontend]: Bump @rjsf packages to v.6.7.0.
• [frontend]: Bump vite to v.8.1.5.
• [frontend]: Bump oxlint-tsgolint to v.0.25.0.
• [chip-test]: Update chip-test Dockerfile.

Fixed

• [tags]: Fix ClosureTag export shadowing.
• [frontend]: Local plugins are detected, and both update actions and available-version checks are skipped.

Release 3.10.1

[3.10.1] - 2026-07-24

Added

• [devcontainer]: Add a double Node/Bun Dev Container setup where VS Code lets you choose one profile or the other.
• [devcontainer]: The Bun Dev Container profile builds in a fraction of the time compared to the Node profile, confirming how impressive the Bun runtime is.
• [devcontainer]: Add dedicated .devcontainer/node and .devcontainer/bun profiles with their own Dockerfile, docker-compose, and create/start scripts.
• [devices]: Add tagList support to the ClosureOptions used by the Closure device constructor. Thanks Ludovic BOUÉ.
• [closure]: Add countdownTime, mainState, currentErrorList, overallCurrentState, overallTargetState, and latchControlModes support to the ClosureOptions used by the Closure device constructor.
• [devices]: Add addPanel() to the Closure device and tagList support to ClosurePanelOptions to compose closures with multiple closure panels (e.g. a venetian blind with ClosurePanelTag.Lift and ClosurePanelTag.Tilt panels). Thanks Ludovic BOUÉ.

Changed

• [matterbridge]: Bump matterbridge version to v.3.10.1.
• [matterbridge]: Update dependencies.
• [matterbridge]: Bump @matter/main to v.0.17.6.
• [matterbridge]: Bump oxlint-tsgolint to v.0.25.0.
• [frontend]: Bump frontend version to v.3.5.4.
• [frontend]: Update dependencies.
• [frontend]: Bump @rjsf packages to v.6.7.0.
• [frontend]: Bump vite to v.8.1.5.
• [frontend]: Bump oxlint-tsgolint to v.0.25.0.
• [chip-test]: Update chip-test Dockerfile.

Fixed

• [tags]: Fix ClosureTag export shadowing.
• [frontend]: Local plugins are detected, and both update actions and available-version checks are skipped.

Release 3.10.0

[3.10.0] - 2026-07-17

Breaking changes

• [matter]: Bump matter.js to 0.17.5 and Matter to 1.6.0. See Matter 1.6.0 changes from 1.5.1 for delta from 1.5.1.

Development Breaking changes

• [endpoint]: Add productLabel, productUrl and configurationVersion parameters to the Basic Information creation methods. The default product labels are now Matter Endpoint and Matter Bridged Endpoint, and the default product URL is now https://matterbridge.io.
• [matter]: RainSensor, WaterFreezeDetector and WaterLeakDetector device types now require BooleanState ChangeEvent feature as mandatory.
• [export]: Removed the deprecated matterbridge/jestutils export. Use @matterbridge/jest-utils
  or @matterbridge/vitest-utils instead.
• [endpoint]: Remove the deprecated getChildEndpointByName() helper.
• [device types]: Remove the deprecated device types: onOffOutlet, dimmableOutlet, onOffMountedSwitch, dimmableMountedSwitch, pumpDevice, onOffSwitch, dimmableSwitch, colorTemperatureSwitch, doorLockDevice, coverDevice, thermostatDevice, fanDevice, speakerDevice, airConditioner.
• [tags]: Remove the deprecated tag aliases: AreaNamespaceTag, ClosureTag, CompassDirectionTag, CompassLocationTag, DirectionTag, LandmarkNamespaceTag, LevelTag, LocationTag, NumberTag, PositionTag, RelativePositionTag.
• [servers]: Remove deprecated behavior servers: MatterbridgeEnhancedColorControlServer, MatterbridgePresetThermostatServer, MatterbridgeLiftWindowCoveringServer, MatterbridgeLiftTiltWindowCoveringServer.
• [command handler]: Remove deprecated interface MatterbridgeEndpointCommands.

Added

• [utils]: Add the isValidInteger() validation helper with optional inclusive range checks.
• [endpoint]: Add JSDoc remark refinements to MatterbridgeEndpoint helper methods for clarity.

Changed

• [matterbridge]: Bump matterbridge version to v.3.10.0.
• [matterbridge]: Update dependencies.
• [matterbridge]: Bump @types/node to v.26.1.1.
• [matterbridge]: Bump typescript to v.7.0.2 and remove @typescript/native-preview. Refactor scripts to always use tsc instead of tsgo.
• [matterbridge]: Bump oxfmt to v.0.59.0.
• [matterbridge]: Bump oxlint to v.1.74.0.
• [matterbridge]: Bump oxlint-tsgolint to v.0.24.0.
• [matterbridge]: Bump vitest to v.4.1.10.
• [matterbridge]: Bump marked to v.18.0.6.
• [core]: Bump ws to v.8.21.1.
• [thread]: Bump @zip.js/zip.js to v.2.8.31.
• [typescript]: Update tsconfigs typescript to v.7.0.2.
• [bun]: Update bunfig.toml to install in isolated mode.
• [bun]: Update Dockerfile.bun to install the latest matterbridge version.
• [devcontainer]: Update devcontainer.json to use native toolchain.
• [frontend]: Bump frontend version to v.3.5.3.
• [frontend]: Update dependencies.
• [frontend]: Bump oxfmt to v.0.59.0.
• [frontend]: Bump oxlint to v.1.74.0.
• [behaviors]: Add '@matter/node' export.
• [package]: Replace prettier-ignore with oxfmt-ignore.

Fixed

• [matter]: Use endpoint software and hardware version metadata for accessory and server device Basic Information.
• [endpoint]: Validate that Basic Information product URLs start with https:// and contain at most 256 characters.
• [device manager]: Preserve productLabel and configurationVersion in BaseDevice projections and worker messages.
• [endpoint]: Validate software versions as Matter uint32, hardware versions as Matter uint16, and their version strings as non-empty strings of at most 64 characters.
• [client clusters]: Fix addRequiredClusters, addRequiredClusterClients to log warning only if the cluster client is not already present.

Release 3.9.4

[3.9.4] - 2026-07-10

Added

• [matterbridge]: Add running statistics and improper shutdown detection.
• [matter]: Add Matter 1.6.0 specs and the Matter 1.6.0 changes from 1.5.1 document.
• [docker]: Add the bun-ubuntu-slim base image and build workflow.

Changed

• [matterbridge]: Bump matterbridge version to v.3.9.4.

• [matterbridge]: Update dependencies.

• [matterbridge]: Bump @types/node to v.26.1.0.

• [matterbridge]: Bump @typescript/native-preview to v.7.0.0-dev.20260703.1.

• [matterbridge]: Bump oxfmt to v.0.57.0.

• [matterbridge]: Bump oxlint to v.1.72.0.

• [matterbridge]: Bump oxlint-tsgolint to v.0.24.0.

• [package]: Apply style to all files.

• [service]: Update service configuration example systemd/matterbridge.service.

• [service]: Update service configuration guides.

• [matterbridge]: Bump @matter/main to v.0.17.4.

• [matter]: Update the data model script to support Matter 1.6.0 generation.

• [frontend]: Bump frontend version to v.3.5.2.

• [frontend]: Update dependencies.

Release 3.9.3

[3.9.3] - 2026-07-03

Warning

The Docker run examples did not set a stop timeout. The new matter.js storage lock system needs Matterbridge to shut down cleanly, so without --stop-timeout 60 Docker may kill the container before the lock is released. Docker Compose setups should use stop_grace_period: 60s for the same reason. The docker guide has been updated.

Please update your setup.

Breaking changes

• [frontend]: Stop checking for updates automatically on connection. It is the wrong timing to check for updates when the bridge is restarting.

Added

• [bun]: Add ban test runtime check.
• [bun]: Add ban test workflow.
• [bun]: The bun local docker image now runs from src files. No build is done.
• [utils]: Add writeDiagnostic() in utils package.
• [bun]: Add bunAvailable() in runtimeBun.ts.
• [s6-rc]: Add a timeout-kill of 55 secs to the s6-rc images (same reason as the --stop-timeout 60 in Docker run and Docker compose).

Changed

• [matterbridge]: Bump matterbridge version to v.3.9.3.

• [matterbridge]: Update dependencies.

• [matterbridge]: Bump @matter/main to v.0.17.4-alpha.0-20260627-deac80361. This brings a great memory optimization. Thanks @Apollon77.

• [matterbridge]: Bump @matter/main to v.0.17.4-alpha.0-20260628-67a669f75.

• [workflows]: Update all GitHub Actions to their latest major versions.

• [docker]: Add matterbridge-mqtt to the dev Docker image.

• [docker]: Add --stop-timeout 60 to Docker Desktop examples so Matterbridge has enough time to shut down cleanly before Docker kills the container.

• [oxlint]: Update Oxlint configuration to v.1.0.16.

• [oxlint]: Update Oxfmt configuration to v.1.0.5.

• [readme]: Improve the journald configuration comments in README-SERVICE.md, README-SERVICE-OPT.md and README-SERVICE-LOCAL.md.

• [bun]: Change bun install param from --production to --omit=dev to avoid the frozen lock.

• [thread]: Refactor Docker, npm and GitHub version check timeout handling and warn when Docker Hub rate limits version lookups.

• [typecheck]: Refactor typecheck tsconfig.json.

• [service]: Update service configuration guides.

• [codex]: Update config to v.1.0.1.

• [frontend]: Bump frontend version to v.3.5.1.

• [frontend]: Update dependencies.

Fixed

• [thread]: Add worker-local unhandled rejection and uncaught exception guards, and count failed worker exits as thread errors.
• [docs]: Fix wrong path for the frontend certificates: place certificates in the .matterbridge/certs directory.