Release 3.0.0

## [3.0.0] - 2025-11-08

### Added

- [tvoc]: Added voc_index to the converter. Thanks Funca (#129).
- [cover]: Added check for reverse_direction === 'back' and reverse_direction === true (#121 and #131).
- [test]: Improved test coverage to 85%.

### Changed

- [package]: Updated dependencies.
- [package]: Bumped platform to v.3.0.0.
- [package]: Bumped entity to v.3.3.0.
- [package]: Bumped zigbee to v.3.0.0.
- [package]: Bumped package to automator v.2.0.11.
- [jest]: Bumped jestHelpers to v.1.0.11.
- [package]: Require matterbridge v.3.3.0.
- [package]: Added default config.
- [package]: Added typed ZigbeePlatformConfig.
- [platform]: Updated to new signature PlatformMatterbridge.
- [workflows]: Improved speed on Node CI.
- [workflows]: Use shallow clones and --no-fund --no-audit for faster builds.
- [devcontainer]: Added the plugin name to the container.
- [devcontainer]: Improved performance of first build with shallow clone.

### Fixed

- [platform]: Fixed specific zbminir2 device case for all devices. Thanks subst4nc3 (#126).

<a href="https://www.buymeacoffee.com/luligugithub">
  <img src="bmc-button.svg" alt="Buy me a coffee" width="80">
</a>

Author: Luligu

.github/workflows/build-matterbridge-plugin.yml

@@ -61,7 +61,7 @@ jobs:
         run: npm run lint
 
       - name: Test the plugin
-        run: npm run test
+        run: npm run test -- --forceExit
 
       - name: Build the plugin
         run: npm run build

.github/workflows/codecov.yml

@@ -28,7 +28,7 @@ jobs:
           registry-url: 'https://registry.npmjs.org'
 
       - name: Clone matterbridge repo
-        run: git clone https://github.com/Luligu/matterbridge.git ../matterbridge
+        run: git clone --depth 1 --single-branch --no-tags https://github.com/Luligu/matterbridge.git ../matterbridge
 
       - name: Install matterbridge dependencies
         working-directory: ../matterbridge
@@ -49,7 +49,7 @@ jobs:
         run: npm link matterbridge
 
       - name: Run tests
-        run: npm run test:coverage
+        run: npm run test:coverage -- --forceExit
 
       - name: Upload results to Codecov
         uses: codecov/codecov-action@v5

.github/workflows/publish-matterbridge-plugin-dev-daily-from-dev.yml

@@ -28,7 +28,7 @@ jobs:
         run: npm cache clean --force
 
       - name: Clone matterbridge repo branch dev
-        run: git clone -b dev https://github.com/Luligu/matterbridge.git ../matterbridge
+        run: git clone --depth 1 --single-branch --no-tags -b dev https://github.com/Luligu/matterbridge.git ../matterbridge
 
       - name: Install matterbridge dependencies
         working-directory: ../matterbridge
@@ -49,7 +49,7 @@ jobs:
           npm run lint
           npm run buildProduction
           npm install -g .
-          npm run test
+          npm run test -- --forceExit
           npm pkg delete devDependencies scripts types
           npx shx rm -rf ./node_modules
           npm install --omit=dev

.github/workflows/publish-matterbridge-plugin-dev-daily-from-main.yml

@@ -28,7 +28,7 @@ jobs:
         run: npm cache clean --force
 
       - name: Clone matterbridge repo branch dev
-        run: git clone -b dev https://github.com/Luligu/matterbridge.git ../matterbridge
+        run: git clone --depth 1 --single-branch --no-tags -b dev https://github.com/Luligu/matterbridge.git ../matterbridge
 
       - name: Install matterbridge dependencies
         working-directory: ../matterbridge
@@ -49,7 +49,7 @@ jobs:
           npm run lint
           npm run buildProduction
           npm install -g .
-          npm run test
+          npm run test -- --forceExit
           npm pkg delete devDependencies scripts types
           npx shx rm -rf ./node_modules
           npm install --omit=dev

.github/workflows/publish-matterbridge-plugin.yml

@@ -28,7 +28,7 @@ jobs:
         run: npm -v
 
       - name: Clone matterbridge repo
-        run: git clone https://github.com/Luligu/matterbridge.git ../matterbridge
+        run: git clone --depth 1 --single-branch --no-tags https://github.com/Luligu/matterbridge.git ../matterbridge
 
       - name: Install matterbridge dependencies
         working-directory: ../matterbridge
@@ -52,7 +52,7 @@ jobs:
         run: npm run lint
 
       - name: Test the plugin
-        run: npm run test
+        run: npm run test -- --forceExit
 
       - name: Build the plugin
         run: npm run build

.npmignore

@@ -29,6 +29,7 @@ eslint.config.*
 install-matterbridge-dev.sh
 install-matterbridge-main.sh
 jest.config.*
+jestHelpers.*
 nodemon.json
 prettier.config.*
 TODO.md

CHANGELOG.md

@@ -8,6 +8,39 @@ 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>
 
+## [3.0.0] - 2025-11-08
+
+### Added
+
+- [tvoc]: Added voc_index to the converter. Thanks Funca (https://github.com/Luligu/matterbridge-zigbee2mqtt/issues/129).
+- [cover]: Added check for reverse_direction === 'back' and reverse_direction === true (https://github.com/Luligu/matterbridge-zigbee2mqtt/issues/121 and https://github.com/Luligu/matterbridge-zigbee2mqtt/issues/131).
+- [test]: Improved test coverage to 85%.
+
+### Changed
+
+- [package]: Updated dependencies.
+- [package]: Bumped platform to v.3.0.0.
+- [package]: Bumped entity to v.3.3.0.
+- [package]: Bumped zigbee to v.3.0.0.
+- [package]: Bumped package to automator v.2.0.11.
+- [jest]: Bumped jestHelpers to v.1.0.11.
+- [package]: Require matterbridge v.3.3.0.
+- [package]: Added default config.
+- [package]: Added typed ZigbeePlatformConfig.
+- [platform]: Updated to new signature PlatformMatterbridge.
+- [workflows]: Improved speed on Node CI.
+- [workflows]: Use shallow clones and --no-fund --no-audit for faster builds.
+- [devcontainer]: Added the plugin name to the container.
+- [devcontainer]: Improved performance of first build with shallow clone.
+
+### Fixed
+
+- [platform]: Fixed specific zbminir2 device case for all devices. Thanks subst4nc3 (https://github.com/Luligu/matterbridge-zigbee2mqtt/issues/126).
+
+<a href="https://www.buymeacoffee.com/luligugithub">
+  <img src="bmc-button.svg" alt="Buy me a coffee" width="80">
+</a>
+
 ## [2.8.1] - 2025-10-02
 
 ### Automations and scenes

README.md

@@ -125,6 +125,8 @@ matterbridge
 
 # Config file
 
+All configurations can (and should) be done with the frontend.
+
 If needed you can configure the mqtt host, port, topic, username and password.
 
 If the whiteList is defined only the devices included are exposed to Matter.
@@ -153,15 +155,16 @@ These are the default vules:
 {
   "name": "matterbridge-zigbee2mqtt",
   "type": "DynamicPlatform",
+  "version": "3.0.0",
   "host": "mqtt://localhost",
   "port": 1883,
   "protocolVersion": 5,
   "topic": "zigbee2mqtt",
   "username": "",
   "password": "",
-  "ca": undefined,
-  "cert": undefined,
-  "key": undefined,
+  "ca": "",
+  "cert": "",
+  "key": "",
   "rejectUnauthorized": true,
   "whiteList": [],
   "blackList": [],

matterbridge-zigbee2mqtt.config.json

@@ -0,0 +1,28 @@
+{
+  "name": "matterbridge-zigbee2mqtt",
+  "type": "DynamicPlatform",
+  "version": "3.0.0",
+  "host": "mqtt://localhost",
+  "port": 1883,
+  "protocolVersion": 5,
+  "username": "",
+  "password": "",
+  "ca": "",
+  "rejectUnauthorized": true,
+  "cert": "",
+  "key": "",
+  "topic": "zigbee2mqtt",
+  "zigbeeFrontend": "http://localhost:8080",
+  "whiteList": [],
+  "blackList": [],
+  "switchList": [],
+  "lightList": [],
+  "outletList": [],
+  "featureBlackList": [],
+  "deviceFeatureBlackList": {},
+  "scenesType": "outlet",
+  "scenesPrefix": true,
+  "postfix": "",
+  "debug": false,
+  "unregisterOnShutdown": false
+}