Releases: Luligu/matterbridge
Releases · Luligu/matterbridge
Release 3.1.8
[3.1.8] - 2025-07-28
Added
- [Jest]: Total coverage 100%.
- [certification]: Improved certification management in pairing.json. Added pemToBuffer function for converting PEM strings to Uint8Array.
- [certification]: Improved certification management in pairing.json. Added extractPrivateKeyRaw function for extrating the raw part of PEM private key to Uint8Array.
- [workflow]: Update permissions and change GitHub token for Docker build triggers.
- [update]: Added support for retrieving and logging plugin development versions.
- [frontend]: Improved test units on Frontend class (total coverage 100%).
- [frontend]: Bump version 2.7.1.
- [frontend]: Added Changelog button that appears in the frontend when a new version is installed and the frontend needs to be updated (page refresh).
- [frontend]: Added restart plugin in childbridge mode.
- [frontend]: Added update to stable and update to dev banner. The update to new appears only if you are on the dev and there is a new dev version.
- [frontend]: Added update to stable and update to dev banner for plugins. The update to new dev appears only if you are on the dev and there is a new dev version.
- [frontend]: Added new menu item for manual update check.
Changed
- [package]: Updated dependencies.
Fixed
- [switch]: Added conditional handling for momentary switch events in MatterbridgeEndpoint for single press only switches.
- [advertise]: Changed the message advertise stopped to work also in childbridge mode.
Release 3.1.7
[3.1.7] - 2025-07-25
Added
- [docker]: Added trigger of Build Docker Image latest from publish.yml.
- [docker]: Added trigger of Build Docker Image dev from publish-dev-daily.yml.
- [docker]: Added on demand trigger for Build Docker Image latest from other plugins workflows.
- [docker]: Added on demand trigger for Build Docker Image dev from other plugins workflows.
- [mdns]: Added bin mb_mdns.
- [coap]: Added bin mb_coap.
- [operationalState]: Improved documentation on createDefaultOperationalStateClusterServer() and added the optional attribute countdownTime. Thanks Ludovic BOUÉ (#363).
- [momentarySwitch]: Added createDefaultMomentarySwitchClusterServer(). It creates a single click only switch. It is supported by the Home app.
- [fixedLabels]: Improved documentation and added character length check.
- [userLabels]: Improved documentation and added character length check.
- [certification]: Improved certification management in pairing.json with new properties.
Changed
- [package]: Updated dependencies.
Release 3.1.6
[3.1.6] - 2025-07-22
Added
- [reset]: Improved "Reset all devices" command in the frontend. It will shutdown all the plugins and recreate the devices with new state and enpoint numbers even if the device is not selected.
- [enpoint]: Enhanced HEPA and Activated Carbon Filter Monitoring Cluster Server methods with additional features and improved default parameters.
- [enpoint]: Added resetCondition Matter command for HEPA and Activated Carbon Filter Monitoring Cluster Server.
- [dishwasher]: Added Dishwasher class and Jest test. It is not supported by the Home app.
- [extractorHood]: Added ExtractorHood class and Jest test. It is not supported by the Home app.
- [fan]: Added the createCompleteFanControlClusterServer() cluster helper that create a fan device with all the features. Thanks Ludovic BOUÉ (#362).
- [docker]: Added logging configuration instructions to docker setup.
Changed
- [package]: Updated dependencies.
Release 3.1.5
[3.1.5] - 2025-07-19
Added
- [error]: Added error logging functions and corresponding tests.
- [matterbridge]: Improved test units on Matterbridge class (total coverage 99%).
- [rvc] Add RVC SupportedMaps Attribute from ServiceArea cluster. Thanks Ludovic BOUÉ (#355).
Changed
- [matterbridge]: Refactored initialization of DeviceManager and PluginManager.
- [pluginManager]: Refactored PluginManager removing unused install/uninstall methods.
- [pluginManager]: Added loading of default plugin config when a plugin is added the first time. It must be a file in the package root named '[PLUGIN-NAME].config.json'.
- [readme-dev]: Added documentation for default plugin config and schema files.
Release 3.1.4
[3.1.4] - 2025-07-16
Added
- [frontend]: Added support for p12 certificates. Add cert.p12 and cert.pass in the '.matterbridge/cert' directory. If both .p12 and cert.pem are present, only the .p12 will be used. See the README.md for more info.
- [frontend]: Added support for p12 certificates with mTLS: both the server and the client must present the correct certificate. Add the parameter '-mtls'. See the README.md for more info.
- [frontend]: Improved test units on Frontend class (total coverage 98%).
Changed
- [package]: Updated dependencies.
- [network]: Refactor network logging to improve clarity and update logging format.
Fixed
- [bin]: Updated matterbridge bin.
Release 3.1.3
[3.1.3] - 2025-07-14
Added
- [endpoint]: Improved jsdoc description on endpoint helpers.
- [endpoint]: Added createDefaultMomentarySwitchClusterServer() cluster helper.
Changed
- [package]: Updated dependencies.
- [vendorId]: Added Shortcut Labs Flic (0x1488).
- [server]: Refactored serverNode event handlers and types.
- [matterbridge]: Removed duplicated properties.
Fixed
- [shutdown]: Fixed error messages from frontend when Matterbridge is shutting down.
Release 3.1.2
[3.1.2] - 2025-07-06
Development Breaking Changes
- [exports]: The single devices (i.e. Rvc, Evse etc...) are only exported from
matterbridge/devices
. Please update your imports to use the new export path. Refer to the documentation for details on imports. - [MatterbridgeEndpoint]: Added the mode property:
server
will make the device indipendent from its plugin. It has its own server node: QRCode, Fabrics and Sessions are visible in the Devices section of the Home page. This is a workaround for the Rvc Apple issue. With mode=server the Rvc (like any other device) can be paired directly to the controller like a native not bridged Matter device. Refer to the documentation for details on using mode.
Added
- [test]: Improved test units on Frontend class (coverage 97%).
Changed
- [package]: Updated dependencies.
Release 3.1.1
[3.1.1] - 2025-07-04
Development Breaking Changes
- [exports]: The single devices (i.e. Rvc, Evse etc...) are only exported from
matterbridge/devices
. Please update your imports to use the new export path. Refer to the documentation for details on imports. - [MatterbridgeEndpoint]: Added the mode property:
server
will make the device indipendent from its plugin. It has its own server node: QRCode, Fabrics and Sessions are visible in the Devices section of the Home page. This is a workaround for the Rvc Apple issue. With mode=server the Rvc (like any other device) can be paired directly to the controller like a native not bridged Matter device.
Added
- [LaundryDryer]: Added LaundryDryer (not supported by the Home app) class and Jest test.
- [DeviceEnergyManagement]: Added MatterbridgeDeviceEnergyManagementServer with power adjustment methods.
- [SolarPower]: Added SolarPower class and Jest test (working on Home Assistant and SmartThings). Thanks Ludovic BOUÉ.
- [BatteryStorage]: Added BatteryStorage class and Jest test (working on Home Assistant and SmartThings). Thanks Ludovic BOUÉ.
- [HeatPump]: Added HeatPump class and Jest test (working on Home Assistant and SmartThings).
- [test]: Improved test units on Frontend class and all Matterbridge classes (coverage 93%).
Changed
- [package]: Updated dependencies.
- [matter.js]: Bumped
matter.js
to 0.15.1 (matter-js/matter.js#2220). Great job matter.js! - [frontend]: Added all esa devices.
- [frontend]: New default values: devices on the home page and icon view on the devices page.
- [imports]: Added dynamic imports to Matterbridge and Frontend classes.
Release 3.1.0
[3.1.0] - 2025-06-28
Added
- [DevContainer]: Added support for the Matterbridge Dev Container with an optimized named volume for
node_modules
. - [GitHub]: Added GitHub issue templates for bug reports and feature requests.
- [Systemd]: Added a systemd service file for Matterbridge in the systemd directory.
- [ESLint]: Refactored ESLint configuration for TypeScript and improved plugin integration.
- [ESLint]: Added the plugins
eslint-plugin-promise
,eslint-plugin-jsdoc
, and@vitest/eslint-plugin
. - [Vitest]: Added Vitest for TypeScript project testing. It will replace Jest, which does not work correctly with ESM module mocks.
- [JSDoc]: Added missing JSDoc comments, including
@param
and@returns
tags. - [MatterbridgeEndpoint]: Add MatterbridgeEndpoint mode='server'. It allows to advertise a single device like an autonomous device with its server node to be paired. The device is not bridged (alpha stage).
- [MatterbridgeEndpoint]: Add MatterbridgeEndpoint mode='matter'. It allows to add a single device to the Matterbridge server node next to the aggregator. The device is not bridged (alpha stage).
- [storage]: Improved error handling of corrupted storage.
- [test]: Improved test units on Matterbridge classes.
Changed
- [package]: Updated package to Automator v. 2.0.0.
- [package]: Updated dependencies.
- [storage]: Bumped
node-storage-manager
to 2.0.0. - [logger]: Bumped
node-ansi-logger
to 3.1.1. - [matter.js]: Bumped
matter.js
to 0.15.0 (matter-js/matter.js#2203). Great job matter.js!
Release 3.0.7
[3.0.7] - 2025-06-21
Breaking Changes
- [devices]: The single devices (i.e. Rvc, Evse etc...) are exported from matterbridge/devices. Please update your imports to use the new export path. Refer to the documentation for details on imports.
Added
- [template]: Added the Matterbridge Plugin Template. It supports Dev Container and Vitest.
- [platform]: Add getDevices() method to retrieve the registered devices in MatterbridgePlatform.
Changed
- [package]: Updated dependencies.
- [package]: Downgrade jest to 29.7.0.
- [energy]: Added parameter for cumulativeEnergyExported to the helper. For solar power device.
- [platform]: Removed long deprecated methods: validateEntityBlackList and validateDeviceWhiteBlackList. Use validateDevice and validateEntity.