matterbridge 3.5.1-dev-20260121-22e98b4 → 3.5.1-dev-20260123-4fcee18

package/CHANGELOG.md

@@ -35,6 +35,11 @@ Advantages:
 - [mb_mdns]: Added additional mDNS service types for discovery.
 - [workflows]: Added npm registry URL and caching to Node.js setup in workflow files.
 - [workflows]: Added concurrency settings in build.yml to cancel previous runs in GitHub Actions.
+- [preset]: Added Thermostat with preset feature. Thanks Ludovic BOUÉ (https://github.com/Luligu/matterbridge/pull/482).
+- [matter.js]: Bump to matter.j v. 0.16.6.
+- [mb_mdns]: Added --ip-filter params to filter incoming mDns messages by sender ip.
+- [express]: Added a login check for internal express api. Now only /health and /memory are opened. Thanks Rogibaer (https://github.com/Luligu/matterbridge-hass/issues/149).
+- [readme]: Added a section with the data structure and backup/restore guidelines.
 
 ### Changed
 

package/README-DOCKER.md

@@ -18,12 +18,14 @@
 
 ## Run matterbridge with docker and docker compose
 
-The Matterbridge Docker image, which includes a manifest list for the linux/amd64, linux/arm64 and linux/arm/v7 architectures, is published on [**Docker Hub**](https://hub.docker.com/r/luligu/matterbridge).
+The Matterbridge Docker image, which includes a manifest list for the linux/amd64 and linux/arm64 architectures, is published on [**Docker Hub**](https://hub.docker.com/r/luligu/matterbridge).
 
 The image (tag **latest**) includes matterbridge and all official plugins with the latest release (as published on npm). You can just pull the new image and matterbridge with all plugins will be the latest release published on npm.
 
 The image (tag **dev**) includes matterbridge and all plugins with the dev release (as pushed on GitHub). You can just pull the new image and matterbridge with all plugins will be the latest dev release pushed on GitHub. It is possible that the devs are outdated by published latests.
 
+For development and testing see also the [Development Images](README-DOCKER.md#development-images).
+
 You can directly select and add a plugin without installing it.
 
 It is based on node:22-bookworm-slim and integrates the health check.
@@ -240,6 +242,6 @@ sudo systemctl restart docker
 
 On [**Docker Hub**](https://hub.docker.com/r/luligu/matterbridge) are also published **for test and development** the Matterbridge ubuntu and alpine images, which include a manifest list for the linux/amd64, linux/arm64 architectures and are based on node 24.x.
 
-The image (tag **ubuntu**) includes only matterbridge with the latest release (as published on npm). The plugins are not included in the image but they will be reinstalled on the first run.
+The image (tag **ubuntu**) includes only matterbridge with the latest release (as published on npm). The plugins are not included in the image but they will be reinstalled on the first run. This image has preinstalled bluetooth essentials and python (it can be used with plugins that require bluetooth, build-essential and python).
 
 The image (tag **alpine**) includes only matterbridge with the latest release (as published on npm). The plugins are not included in the image but they will be reinstalled on the first run.

package/README.md

@@ -72,11 +72,14 @@ https://blog.adafruit.com/2025/11/03/matterbridge-a-matter-plugin-manager/
 To run Matterbridge, you need either a [Node.js](https://nodejs.org/en) environment or [Docker](https://docs.docker.com/get-started/get-docker/) installed on your system.
 
 If you don't have Node.js already install, please use this method to install it on a debian device: https://github.com/nodesource/distributions.
-The supported versions of node are 20 and 22. Please install Node.js 22 LTS. Don't use Node.js Current but always the Node.js LTS.
+The supported versions of node are 20, 22 and 24. Please install Node.js 22 LTS. Don't use Node.js Current but always the Node.js LTS.
 Node.js 23, like all odd-numbered versions, is not supported.
 Nvm is not a good choice and should not be used for production.
 
 If you don't have Docker already install, please use this method to install it on a debian device: https://docs.docker.com/engine/install.
+
+If you don't have Docker already install, please use this method to install it on a Windows or macOS: https://docs.docker.com/get-started/introduction/get-docker-desktop/.
+
 After follow the guidelines for the [Docker configurations](README-DOCKER.md).
 
 I suggest using Docker for its simplicity.
@@ -159,7 +162,13 @@ Here's how to specify a different port number:
 matterbridge --frontend [port number]
 ```
 
-To use the frontend with ssl see below.
+The frontend binds, by default, to all IPv4 and IPv6 addresses. You can override this and bind to a specific address:
+
+```bash
+matterbridge --bind [address]
+```
+
+To use the frontend with SSL, see below.
 
 From the frontend you can do all operations in an easy way.
 
@@ -548,6 +557,37 @@ So depending on the controller you pair with, you should see 100 for fully close
 
 Some controllers invert the position so you need to verify your controller.
 
+## Data structure
+
+Matterbridge uses three directories. These are the default locations (some advanced setups may change them, so check your configuration):
+
+```text
+~/.matterbridge
+~/Matterbridge
+~/.mattercert
+```
+
+### Backup
+
+From the frontend (three-dots menu), select **Create backup**, then **Download backup** when it is ready.
+The backup file is a standard `.zip` archive.
+
+### Restore
+
+Restore must be done manually because the archive paths depend on your setup.
+
+Make sure Matterbridge is not running. Stop it if needed.
+
+Extract the backup and replace the corresponding directories on your system with the ones from the backup:
+
+```text
+.matterbridge
+Matterbridge
+.mattercert
+```
+
+Ensure permissions are correct for the restored directories.
+
 # Known general issues
 
 ## Session XYZ does not exist or Cannot find a session for ID XYZ
@@ -564,17 +604,13 @@ All issues have been solved from the version 17.5 of the HomePod/AppleTV. Now th
 
 If you have more then one Apple TV or Home Pod, you can herve better results setting to disabled "Automatic Selection" in "Home Setting", "Home Hubs & Bridges". When "Automatic selection" is disabled, select your Apple Tv if you have one or any of your Home Pod. In this way you should not have anymore more then one session for fabric.
 
-### Manufacturer Serial Number and Model
-
-The Home app forgets about them when you restart the node.
-
 ### Appliances
 
 As of version 18.4.x, all Appliances device types are not supported by the Home app. They don't even appear like unsupported accessories.
 
 ### Robot
 
-As of version 18.4.x, the Robot is supported by the Home app only as a single, non-bridged device or if it is the only device in the bridge.
+As of version 18.4.x, the Robot is supported by the Home app only as a single, non-bridged device or if it is the only device in the bridge. Furthermore the device cannot be a composed device. The only device type supported is the rvc.
 
 If a Robot is present alongside other devices in the bridge, the entire bridge becomes unstable in the Home app.
 
@@ -588,7 +624,6 @@ So far is the only controller supporting all Matter 1.2, 1.3 and 1.4 device type
 
 - If HA doesn't show all devices, reload the Matter Server Integration or reboot HA
 - Home Assistant doesn't seem to always react when a device is removed from the bridge: they remain in HA unavailable forever. A full Home Assistant restart solves the problem.
-- Use Apple Home when you have to choose the controller type even if you pair Matterbridge directly with HA.
 
 ## Google Home
 
@@ -598,6 +633,8 @@ If you face a problem changing the brightness check this for the explanation: ht
 
 If you encounter a “Something Went Wrong” screen while commissioning MatterBridge devices in Google Home on Android, it’s due to an Android bug. Android fails to send the country code, which is mandatory under the Matter specification.
 
+There is also a known issue with the thermostat Fahrenheit to Celsius Conversion (https://github.com/Luligu/matterbridge/issues/462).
+
 ### Workaround
 
 Install Google Home on an iPhone and complete the commissioning there. Once set up, the devices will appear and function normally on your Android phone and other Nest devices in your home. By [Artem Kovalov](https://github.com/artemkovalyov).

package/dist/frontend.d.ts

@@ -17,6 +17,7 @@ export declare class Frontend extends EventEmitter<FrontendEvents> {
     private port;
     private listening;
     private storedPassword;
+    private authClients;
     private expressApp;
     private httpServer;
     private httpsServer;
@@ -28,6 +29,9 @@ export declare class Frontend extends EventEmitter<FrontendEvents> {
     destroy(): void;
     private msgHandler;
     set logLevel(logLevel: LogLevel);
+    validateReq(req: import('express').Request<unknown, unknown, unknown, {
+        password?: string;
+    }>, res: import('express').Response): boolean;
     start(port?: number): Promise<void>;
     stop(): Promise<void>;
     private getApiSettings;

package/dist/frontend.js

@@ -22,6 +22,7 @@ export class Frontend extends EventEmitter {
     port = 8283;
     listening = false;
     storedPassword = undefined;
+    authClients = [];
     expressApp;
     httpServer;
     httpsServer;
@@ -130,6 +131,14 @@ export class Frontend extends EventEmitter {
     set logLevel(logLevel) {
         this.log.logLevel = logLevel;
     }
+    validateReq(req, res) {
+        if (req.ip && !this.authClients.includes(req.ip)) {
+            this.log.warn(`Warning blocked unauthorized access request ${req.originalUrl ?? req.url} from ${req.ip}`);
+            res.status(401).json({ error: 'Unauthorized' });
+            return false;
+        }
+        return true;
+    }
     async start(port = 8283) {
         this.port = port;
         this.storedPassword = await this.matterbridge.nodeContext?.get('password', '');
@@ -169,6 +178,7 @@ export class Frontend extends EventEmitter {
                 if (this.webSocketServer?.clients.size === 0) {
                     AnsiLogger.setGlobalCallback(undefined);
                     this.log.debug('All WebSocket clients disconnected. WebSocketServer logger global callback removed');
+                    this.authClients = [];
                 }
             });
             ws.on('error', (error) => {
@@ -228,6 +238,8 @@ export class Frontend extends EventEmitter {
                         return socket.destroy();
                     }
                     this.log.debug(`WebSocket upgrade success host ${url.host} password ${password ? '[redacted]' : '(empty)'}`);
+                    if (req.socket.remoteAddress)
+                        this.authClients.push(req.socket.remoteAddress);
                     this.webSocketServer?.handleUpgrade(req, socket, head, (ws) => {
                         this.webSocketServer?.emit('connection', ws, req);
                     });
@@ -363,6 +375,8 @@ export class Frontend extends EventEmitter {
                         return socket.destroy();
                     }
                     this.log.debug(`WebSocket upgrade success host ${url.host} password ${password ? '[redacted]' : '(empty)'}`);
+                    if (req.socket.remoteAddress)
+                        this.authClients.push(req.socket.remoteAddress);
                     this.webSocketServer?.handleUpgrade(req, socket, head, (ws) => {
                         this.webSocketServer?.emit('connection', ws, req);
                     });
@@ -405,6 +419,8 @@ export class Frontend extends EventEmitter {
             if (this.storedPassword === '' || password === this.storedPassword) {
                 this.log.debug('/api/login password valid');
                 res.json({ valid: true });
+                if (req.ip)
+                    this.authClients.push(req.ip);
             }
             else {
                 this.log.warn('/api/login error wrong password');
@@ -454,18 +470,26 @@ export class Frontend extends EventEmitter {
         });
         this.expressApp.get('/api/settings', express.json(), async (req, res) => {
             this.log.debug('The frontend sent /api/settings');
+            if (!this.validateReq(req, res))
+                return;
             res.json(await this.getApiSettings());
         });
         this.expressApp.get('/api/plugins', async (req, res) => {
             this.log.debug('The frontend sent /api/plugins');
+            if (!this.validateReq(req, res))
+                return;
             res.json(this.matterbridge.hasCleanupStarted ? [] : this.getPlugins());
         });
         this.expressApp.get('/api/devices', async (req, res) => {
             this.log.debug('The frontend sent /api/devices');
+            if (!this.validateReq(req, res))
+                return;
             res.json(this.matterbridge.hasCleanupStarted ? [] : this.getDevices());
         });
         this.expressApp.get('/api/view-mblog', async (req, res) => {
             this.log.debug('The frontend sent /api/view-mblog');
+            if (!this.validateReq(req, res))
+                return;
             try {
                 const fs = await import('node:fs');
                 const data = await fs.promises.readFile(path.join(this.matterbridge.matterbridgeDirectory, MATTERBRIDGE_LOGGER_FILE), 'utf8');
@@ -479,6 +503,8 @@ export class Frontend extends EventEmitter {
         });
         this.expressApp.get('/api/view-mjlog', async (req, res) => {
             this.log.debug('The frontend sent /api/view-mjlog');
+            if (!this.validateReq(req, res))
+                return;
             try {
                 const fs = await import('node:fs');
                 const data = await fs.promises.readFile(path.join(this.matterbridge.matterbridgeDirectory, MATTER_LOGGER_FILE), 'utf8');
@@ -492,6 +518,8 @@ export class Frontend extends EventEmitter {
         });
         this.expressApp.get('/api/view-diagnostic', async (req, res) => {
             this.log.debug('The frontend sent /api/view-diagnostic');
+            if (!this.validateReq(req, res))
+                return;
             await this.generateDiagnostic();
             try {
                 const fs = await import('node:fs');
@@ -506,6 +534,8 @@ export class Frontend extends EventEmitter {
         });
         this.expressApp.get('/api/download-diagnostic', async (req, res) => {
             this.log.debug(`The frontend sent /api/download-diagnostic`);
+            if (!this.validateReq(req, res))
+                return;
             await this.generateDiagnostic();
             try {
                 const fs = await import('node:fs');
@@ -526,6 +556,8 @@ export class Frontend extends EventEmitter {
         });
         this.expressApp.get('/api/viewhistory', async (req, res) => {
             this.log.debug('The frontend sent /api/viewhistory');
+            if (!this.validateReq(req, res))
+                return;
             try {
                 const fs = await import('node:fs');
                 const data = await fs.promises.readFile(path.join(this.matterbridge.matterbridgeDirectory, MATTERBRIDGE_HISTORY_FILE), 'utf8');
@@ -539,6 +571,8 @@ export class Frontend extends EventEmitter {
         });
         this.expressApp.get('/api/downloadhistory', async (req, res) => {
             this.log.debug(`The frontend sent /api/downloadhistory`);
+            if (!this.validateReq(req, res))
+                return;
             try {
                 const fs = await import('node:fs');
                 await fs.promises.access(path.join(this.matterbridge.matterbridgeDirectory, MATTERBRIDGE_HISTORY_FILE), fs.constants.F_OK);
@@ -559,6 +593,8 @@ export class Frontend extends EventEmitter {
         });
         this.expressApp.get('/api/shellyviewsystemlog', async (req, res) => {
             this.log.debug('The frontend sent /api/shellyviewsystemlog');
+            if (!this.validateReq(req, res))
+                return;
             try {
                 const fs = await import('node:fs');
                 const data = await fs.promises.readFile(path.join(this.matterbridge.matterbridgeDirectory, 'shelly.log'), 'utf8');
@@ -572,6 +608,8 @@ export class Frontend extends EventEmitter {
         });
         this.expressApp.get('/api/download-mblog', async (req, res) => {
             this.log.debug(`The frontend sent /api/download-mblog ${path.join(this.matterbridge.matterbridgeDirectory, MATTERBRIDGE_LOGGER_FILE)}`);
+            if (!this.validateReq(req, res))
+                return;
             const fs = await import('node:fs');
             try {
                 await fs.promises.access(path.join(this.matterbridge.matterbridgeDirectory, MATTERBRIDGE_LOGGER_FILE), fs.constants.F_OK);
@@ -592,6 +630,8 @@ export class Frontend extends EventEmitter {
         });
         this.expressApp.get('/api/download-mjlog', async (req, res) => {
             this.log.debug(`The frontend sent /api/download-mjlog ${path.join(this.matterbridge.matterbridgeDirectory, MATTERBRIDGE_LOGGER_FILE)}`);
+            if (!this.validateReq(req, res))
+                return;
             const fs = await import('node:fs');
             try {
                 await fs.promises.access(path.join(this.matterbridge.matterbridgeDirectory, MATTER_LOGGER_FILE), fs.constants.F_OK);
@@ -612,6 +652,8 @@ export class Frontend extends EventEmitter {
         });
         this.expressApp.get('/api/shellydownloadsystemlog', async (req, res) => {
             this.log.debug('The frontend sent /api/shellydownloadsystemlog');
+            if (!this.validateReq(req, res))
+                return;
             const fs = await import('node:fs');
             try {
                 await fs.promises.access(path.join(this.matterbridge.matterbridgeDirectory, 'shelly.log'), fs.constants.F_OK);
@@ -632,6 +674,8 @@ export class Frontend extends EventEmitter {
         });
         this.expressApp.get('/api/download-mbstorage', async (req, res) => {
             this.log.debug('The frontend sent /api/download-mbstorage');
+            if (!this.validateReq(req, res))
+                return;
             await createZip(path.join(os.tmpdir(), `matterbridge.${NODE_STORAGE_DIR}.zip`), path.join(this.matterbridge.matterbridgeDirectory, NODE_STORAGE_DIR));
             res.download(path.join(os.tmpdir(), `matterbridge.${NODE_STORAGE_DIR}.zip`), `matterbridge.${NODE_STORAGE_DIR}.zip`, (error) => {
                 if (error) {
@@ -642,6 +686,8 @@ export class Frontend extends EventEmitter {
         });
         this.expressApp.get('/api/download-mjstorage', async (req, res) => {
             this.log.debug('The frontend sent /api/download-mjstorage');
+            if (!this.validateReq(req, res))
+                return;
             await createZip(path.join(os.tmpdir(), `matterbridge.${MATTER_STORAGE_NAME}.zip`), path.join(this.matterbridge.matterbridgeDirectory, MATTER_STORAGE_NAME));
             res.download(path.join(os.tmpdir(), `matterbridge.${MATTER_STORAGE_NAME}.zip`), `matterbridge.${MATTER_STORAGE_NAME}.zip`, (error) => {
                 if (error) {
@@ -652,6 +698,8 @@ export class Frontend extends EventEmitter {
         });
         this.expressApp.get('/api/download-pluginstorage', async (req, res) => {
             this.log.debug('The frontend sent /api/download-pluginstorage');
+            if (!this.validateReq(req, res))
+                return;
             await createZip(path.join(os.tmpdir(), `matterbridge.pluginstorage.zip`), this.matterbridge.matterbridgePluginDirectory);
             res.download(path.join(os.tmpdir(), `matterbridge.pluginstorage.zip`), `matterbridge.pluginstorage.zip`, (error) => {
                 if (error) {
@@ -662,6 +710,8 @@ export class Frontend extends EventEmitter {
         });
         this.expressApp.get('/api/download-pluginconfig', async (req, res) => {
             this.log.debug('The frontend sent /api/download-pluginconfig');
+            if (!this.validateReq(req, res))
+                return;
             await createZip(path.join(os.tmpdir(), `matterbridge.pluginconfig.zip`), path.relative(process.cwd(), path.join(this.matterbridge.matterbridgeDirectory, '*.config.json')));
             res.download(path.join(os.tmpdir(), `matterbridge.pluginconfig.zip`), `matterbridge.pluginconfig.zip`, (error) => {
                 if (error) {
@@ -672,6 +722,8 @@ export class Frontend extends EventEmitter {
         });
         this.expressApp.get('/api/download-backup', async (req, res) => {
             this.log.debug('The frontend sent /api/download-backup');
+            if (!this.validateReq(req, res))
+                return;
             res.download(path.join(os.tmpdir(), `matterbridge.backup.zip`), `matterbridge.backup.zip`, (error) => {
                 if (error) {
                     this.log.error(`Error downloading file matterbridge.backup.zip: ${error instanceof Error ? error.message : error}`);
@@ -680,6 +732,8 @@ export class Frontend extends EventEmitter {
             });
         });
         this.expressApp.post('/api/uploadpackage', upload.single('file'), async (req, res) => {
+            if (!this.validateReq(req, res))
+                return;
             const { filename } = req.body;
             const file = req.file;
             if (!file || !filename) {
@@ -1434,7 +1488,7 @@ export class Frontend extends EventEmitter {
             else if (data.method === '/api/create-backup') {
                 this.wssSendSnackbarMessage('Creating backup...', 0);
                 this.log.notice(`Creating the backup...`);
-                await createZip(path.join(os.tmpdir(), `matterbridge.backup.zip`), path.join(this.matterbridge.matterbridgeDirectory), path.join(this.matterbridge.matterbridgePluginDirectory));
+                await createZip(path.join(os.tmpdir(), `matterbridge.backup.zip`), path.join(this.matterbridge.matterbridgeDirectory), path.join(this.matterbridge.matterbridgePluginDirectory), path.join(this.matterbridge.matterbridgeCertDirectory));
                 this.log.notice(`Backup ready to be downloaded.`);
                 this.wssSendCloseSnackbarMessage('Creating backup...');
                 this.wssSendSnackbarMessage('Backup ready to be downloaded', 10);

package/dist/jestutils/jestHelpers.js

@@ -519,7 +519,7 @@ export async function startServerNode(name, port, deviceType = bridge.code) {
     expect(aggregator.lifecycle.isPartsReady).toBeTruthy();
     expect(aggregator.lifecycle.hasId).toBeTruthy();
     expect(aggregator.lifecycle.hasNumber).toBeTruthy();
-    await flushAsync();
+    await flushAsync(3, 3, 10);
     return [server, aggregator];
 }
 export async function stopServerNode(server) {
@@ -531,12 +531,7 @@ export async function stopServerNode(server) {
     await server.close();
     expect(server.lifecycle.isReady).toBeFalsy();
     expect(server.lifecycle.isOnline).toBeFalsy();
-    const mdns = environment.get(MdnsService);
-    if (mdns && typeof mdns[Symbol.asyncDispose] === 'function')
-        await mdns[Symbol.asyncDispose]();
-    if (mdns && typeof mdns.close === 'function')
-        await mdns.close();
-    await flushAsync();
+    await flushAsync(3, 3, 10);
 }
 export async function addDevice(owner, device, pause = 10) {
     expect(owner).toBeDefined();

package/dist/matterbridge.js

@@ -1420,19 +1420,30 @@ export class Matterbridge extends EventEmitter {
         this.log.debug(`- nodeLabel: ${await storageContext.get('nodeLabel')}`);
         this.log.debug(`- serialNumber: ${await storageContext.get('serialNumber')}`);
         this.log.debug(`- uniqueId: ${await storageContext.get('uniqueId')}`);
-        this.log.debug(`- softwareVersion: ${await storageContext.get('softwareVersion')} softwareVersionString: ${await storageContext.get('softwareVersionString')}`);
-        this.log.debug(`- hardwareVersion: ${await storageContext.get('hardwareVersion')} hardwareVersionString: ${await storageContext.get('hardwareVersionString')}`);
+        this.log.debug(`- softwareVersion: ${await storageContext.get('softwareVersion')}`);
+        this.log.debug(`- softwareVersionString: ${await storageContext.get('softwareVersionString')}`);
+        this.log.debug(`- hardwareVersion: ${await storageContext.get('hardwareVersion')}`);
+        this.log.debug(`- hardwareVersionString: ${await storageContext.get('hardwareVersionString')}`);
         return storageContext;
     }
     async createServerNode(storageContext, port = 5540, passcode = 20242025, discriminator = 3850) {
         const storeId = await storageContext.get('storeId');
         this.log.notice(`Creating server node for ${storeId} on port ${port} with passcode ${passcode} and discriminator ${discriminator}...`);
+        this.log.debug(`- storeId: ${await storageContext.get('storeId')}`);
         this.log.debug(`- deviceName: ${await storageContext.get('deviceName')}`);
         this.log.debug(`- deviceType: ${await storageContext.get('deviceType')}(0x${(await storageContext.get('deviceType'))?.toString(16).padStart(4, '0')})`);
+        this.log.debug(`- vendorId: ${await storageContext.get('vendorId')}`);
+        this.log.debug(`- vendorName: ${await storageContext.get('vendorName')}`);
+        this.log.debug(`- productId: ${await storageContext.get('productId')}`);
+        this.log.debug(`- productName: ${await storageContext.get('productName')}`);
+        this.log.debug(`- productLabel: ${await storageContext.get('productLabel')}`);
+        this.log.debug(`- nodeLabel: ${await storageContext.get('nodeLabel')}`);
         this.log.debug(`- serialNumber: ${await storageContext.get('serialNumber')}`);
         this.log.debug(`- uniqueId: ${await storageContext.get('uniqueId')}`);
-        this.log.debug(`- softwareVersion: ${await storageContext.get('softwareVersion')} softwareVersionString: ${await storageContext.get('softwareVersionString')}`);
-        this.log.debug(`- hardwareVersion: ${await storageContext.get('hardwareVersion')} hardwareVersionString: ${await storageContext.get('hardwareVersionString')}`);
+        this.log.debug(`- softwareVersion: ${await storageContext.get('softwareVersion')}`);
+        this.log.debug(`- softwareVersionString: ${await storageContext.get('softwareVersionString')}`);
+        this.log.debug(`- hardwareVersion: ${await storageContext.get('hardwareVersion')}`);
+        this.log.debug(`- hardwareVersionString: ${await storageContext.get('hardwareVersionString')}`);
         const serverNode = await ServerNode.create({
             id: storeId,
             environment: this.environment,

package/dist/matterbridgeEndpointHelpers.js

@@ -277,7 +277,7 @@ export async function invokeSubscribeHandler(endpoint, cluster, attribute, newVa
         endpoint.log.error(`invokeSubscribeHandler ${hk}${event}${er} error: cluster ${behaviorId} not found on endpoint ${or}${endpoint.id}${er}:${or}${endpoint.number}${er}`);
         return false;
     }
-    await endpoint.act((agent) => agent[behaviorId].events[event].emit(newValue, oldValue, { ...agent.context, offline: false }));
+    await endpoint.act((agent) => agent[behaviorId].events[event].emit(newValue, oldValue, { ...agent.context, offline: false, fabric: 1 }));
     return true;
 }
 export function addRequiredClusterServers(endpoint) {

package/dist/mb_mdns.js

@@ -18,6 +18,7 @@ Options:
   --advertise <interval>                    Enable matterbridge mDNS advertisement each ms (default interval: 10000ms).
   --query <interval>                        Enable common mDNS services query each ms (default interval: 10000ms).
   --filter <string...>                      Filter strings to match in the mDNS record name (default: no filter).
+  --ip-filter <string...>                   Filter strings to match in the mDNS sender ip address (default: no filter).
   --noIpv4                                  Disable IPv4 mDNS server (default: enabled).
   --noIpv6                                  Disable IPv6 mDNS server (default: enabled).
   --no-timeout                              Disable automatic timeout of 10 minutes. Reflector mode disables timeout automatically.
@@ -35,6 +36,9 @@ Examples:
   # Listen for Matter commissioner and discovery service records on all interfaces
   mb_mdns --filter _matterc._udp _matter._tcp
 
+  # Listen for Matter commissioner and discovery service records on all interfaces from specific ipv4 and ipv6 ips
+  mb_mdns --filter _matterc._udp _matter._tcp --ip-filter 192.168.69.20 fe80::1077:2e0d:2c91:aa90
+
   # Query for mDNS devices every 10s on a specific interface
   mb_mdns --interfaceName eth0 --query
 
@@ -162,6 +166,9 @@ Examples:
         const filters = getStringArrayParameter('filter');
         if (filters)
             mdnsIpv4.filters.push(...filters);
+        const ipFilters = getStringArrayParameter('ip-filter');
+        if (ipFilters)
+            mdnsIpv4.ipFilters.push(...ipFilters);
         mdnsIpv4.on('error', (err) => {
             mdnsIpv4?.log.error(`mDNS udp4 Server error: ${err.message}\n${err.stack}`);
         });
@@ -186,6 +193,9 @@ Examples:
         const filters = getStringArrayParameter('filter');
         if (filters)
             mdnsIpv6.filters.push(...filters);
+        const ipFilters = getStringArrayParameter('ip-filter');
+        if (ipFilters)
+            mdnsIpv6.ipFilters.push(...ipFilters);
         mdnsIpv6.on('error', (err) => {
             mdnsIpv6?.log.error(`mDNS udp6 Server error: ${err.message}\n${err.stack}`);
         });

package/npm-shrinkwrap.json

@@ -1,15 +1,15 @@
 {
   "name": "matterbridge",
-  "version": "3.5.1-dev-20260121-22e98b4",
+  "version": "3.5.1-dev-20260123-4fcee18",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge",
-      "version": "3.5.1-dev-20260121-22e98b4",
+      "version": "3.5.1-dev-20260123-4fcee18",
       "license": "Apache-2.0",
       "dependencies": {
-        "@matter/main": "0.16.5",
+        "@matter/main": "0.16.6",
         "@matterbridge/dgram": "0.0.2",
         "@matterbridge/jest-utils": "0.0.1",
         "@matterbridge/utils": "0.0.1",
@@ -74,86 +74,86 @@
       }
     },
     "node_modules/@matter/general": {
-      "version": "0.16.5",
-      "resolved": "https://registry.npmjs.org/@matter/general/-/general-0.16.5.tgz",
-      "integrity": "sha512-KKTUpE7Gz/yEnMSDWfQzTENZO2vCCw0txGNfAcTT7c5F5nRpBpZDSACNqfJV2x51Hj7EQtSbcJ2+TC580JYsOg==",
+      "version": "0.16.6",
+      "resolved": "https://registry.npmjs.org/@matter/general/-/general-0.16.6.tgz",
+      "integrity": "sha512-MyMLj9MEk6e0J+qjFVxuNxySTy2RcjdtYog7d9xGrWWI1mszCiT61Q5/aE198z+v5+Lca8CX+GDfeoNIT6hdgw==",
       "license": "Apache-2.0",
       "dependencies": {
         "@noble/curves": "^2.0.1"
       }
     },
     "node_modules/@matter/main": {
-      "version": "0.16.5",
-      "resolved": "https://registry.npmjs.org/@matter/main/-/main-0.16.5.tgz",
-      "integrity": "sha512-zb7ipavx+lLphbjmnIKH7pMtPc+wo+UCu0qP839zgo6dLIdVJlXsZT2EnHFA1dQNtIFWvPQfgx9Db/naSn+bAg==",
+      "version": "0.16.6",
+      "resolved": "https://registry.npmjs.org/@matter/main/-/main-0.16.6.tgz",
+      "integrity": "sha512-QTShS4OVEXoDyjI7jeLx35EPNUho8V/RZu971aBoHU3ueIxj4/gPWecN5NBTsmEl2VaCKHnmNaT6z11lNgdIaA==",
       "license": "Apache-2.0",
       "dependencies": {
-        "@matter/general": "0.16.5",
-        "@matter/model": "0.16.5",
-        "@matter/node": "0.16.5",
-        "@matter/protocol": "0.16.5",
-        "@matter/types": "0.16.5"
+        "@matter/general": "0.16.6",
+        "@matter/model": "0.16.6",
+        "@matter/node": "0.16.6",
+        "@matter/protocol": "0.16.6",
+        "@matter/types": "0.16.6"
       },
       "optionalDependencies": {
-        "@matter/nodejs": "0.16.5"
+        "@matter/nodejs": "0.16.6"
       }
     },
     "node_modules/@matter/model": {
-      "version": "0.16.5",
-      "resolved": "https://registry.npmjs.org/@matter/model/-/model-0.16.5.tgz",
-      "integrity": "sha512-kz1ik7ccZHZrZEd9mxtOcVgQs1R2JmdyrszHEZUk9Zaqp7hyWWcmeS9p+8FVVMdUU24oBhDc2WrmjA9WNJsW1A==",
+      "version": "0.16.6",
+      "resolved": "https://registry.npmjs.org/@matter/model/-/model-0.16.6.tgz",
+      "integrity": "sha512-eTLer9EibjA87AKn1Kj/oQv3nabaWJ2Pns3bGCUbgVycgGkLELJQs8TiA2QqorGbH2upTFmYfyaVUoxtMtyHbA==",
       "license": "Apache-2.0",
       "dependencies": {
-        "@matter/general": "0.16.5"
+        "@matter/general": "0.16.6"
       }
     },
     "node_modules/@matter/node": {
-      "version": "0.16.5",
-      "resolved": "https://registry.npmjs.org/@matter/node/-/node-0.16.5.tgz",
-      "integrity": "sha512-c9AVRsrWFBy68VLPUJvsrENOd6aQLAiNyrZ9rfTy/MGIMuQTIzF6az/3CGof8HttHEU/ZItJLn6VZzsH2YCr7A==",
+      "version": "0.16.6",
+      "resolved": "https://registry.npmjs.org/@matter/node/-/node-0.16.6.tgz",
+      "integrity": "sha512-gPmxxX9OG4QnAPHdQsSbs1B/gB5WIrCaTkjp/kqLKCYWuYtFbDQr+PXTWn7SdQZWY/aHZ9/e3xP4VeVd8sk4/A==",
       "license": "Apache-2.0",
       "dependencies": {
-        "@matter/general": "0.16.5",
-        "@matter/model": "0.16.5",
-        "@matter/protocol": "0.16.5",
-        "@matter/types": "0.16.5"
+        "@matter/general": "0.16.6",
+        "@matter/model": "0.16.6",
+        "@matter/protocol": "0.16.6",
+        "@matter/types": "0.16.6"
       }
     },
     "node_modules/@matter/nodejs": {
-      "version": "0.16.5",
-      "resolved": "https://registry.npmjs.org/@matter/nodejs/-/nodejs-0.16.5.tgz",
-      "integrity": "sha512-2ilpEHvqEYZQopbXOO6qB1FZv26b91kBFQySho0mH9yzMwiLqe1SrRQcrVo6vSM3shIEdDfEpT8Z6JsyUyaxdQ==",
+      "version": "0.16.6",
+      "resolved": "https://registry.npmjs.org/@matter/nodejs/-/nodejs-0.16.6.tgz",
+      "integrity": "sha512-r4UgxNWEsOCan315Bne3k1n3KFExBW5k263wGsef6a1GViJdjAAx4IhO6GxXtPH+bPFsjYQO4N7AZ5BCR8Knqw==",
       "license": "Apache-2.0",
       "optional": true,
       "dependencies": {
-        "@matter/general": "0.16.5",
-        "@matter/node": "0.16.5",
-        "@matter/protocol": "0.16.5",
-        "@matter/types": "0.16.5"
+        "@matter/general": "0.16.6",
+        "@matter/node": "0.16.6",
+        "@matter/protocol": "0.16.6",
+        "@matter/types": "0.16.6"
       },
       "engines": {
         "node": ">=20.19.0 <22.0.0 || >=22.13.0"
       }
     },
     "node_modules/@matter/protocol": {
-      "version": "0.16.5",
-      "resolved": "https://registry.npmjs.org/@matter/protocol/-/protocol-0.16.5.tgz",
-      "integrity": "sha512-TtBXeYRWheWHIx7xP1Q9G9KnG2y9x4xuenWZzNlzw/cT5EQcmqgoUm42l5TseUFpGxNiuFhNwRLOzQPQQcdW+A==",
+      "version": "0.16.6",
+      "resolved": "https://registry.npmjs.org/@matter/protocol/-/protocol-0.16.6.tgz",
+      "integrity": "sha512-Mw5F+TZrlcrofsH84Jc1F2tldn0tLRFDVC9s5d1cwUh5196xlSyapuFGKA2TdDgjS7jSZvcMsOutSVUlVtpgqw==",
       "license": "Apache-2.0",
       "dependencies": {
-        "@matter/general": "0.16.5",
-        "@matter/model": "0.16.5",
-        "@matter/types": "0.16.5"
+        "@matter/general": "0.16.6",
+        "@matter/model": "0.16.6",
+        "@matter/types": "0.16.6"
       }
     },
     "node_modules/@matter/types": {
-      "version": "0.16.5",
-      "resolved": "https://registry.npmjs.org/@matter/types/-/types-0.16.5.tgz",
-      "integrity": "sha512-YUnIrRAPzr7qzSdAukOJ7I1pQb47mERDRp7IZPQ4bGKZGuZzsy0eYLWcAyEqzGco+xvaWktTJYI975Qbb2X2zg==",
+      "version": "0.16.6",
+      "resolved": "https://registry.npmjs.org/@matter/types/-/types-0.16.6.tgz",
+      "integrity": "sha512-QUuFNJPKVj4pwudH1dX5UQx+WLGqUq2Gxg5ZMrOidWAl7jElucMJWEwMLVGDfL1vq6XXzGH5oxV2l+mVdcx2mQ==",
       "license": "Apache-2.0",
       "dependencies": {
-        "@matter/general": "0.16.5",
-        "@matter/model": "0.16.5"
+        "@matter/general": "0.16.6",
+        "@matter/model": "0.16.6"
       }
     },
     "node_modules/@matterbridge/dgram": {
@@ -1279,9 +1279,9 @@
       }
     },
     "node_modules/lodash": {
-      "version": "4.17.21",
-      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
-      "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==",
+      "version": "4.17.23",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz",
+      "integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w==",
       "license": "MIT"
     },
     "node_modules/lru-cache": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge",
-  "version": "3.5.1-dev-20260121-22e98b4",
+  "version": "3.5.1-dev-20260123-4fcee18",
   "description": "Matterbridge plugin manager for Matter",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",
@@ -104,7 +104,7 @@
     }
   },
   "dependencies": {
-    "@matter/main": "0.16.5",
+    "@matter/main": "0.16.6",
     "@matterbridge/dgram": "0.0.2",
     "@matterbridge/jest-utils": "0.0.1",
     "@matterbridge/utils": "0.0.1",
@@ -118,12 +118,12 @@
     "ws": "8.19.0"
   },
   "build": {
-    "sha": "e333c4a7e80ef23848f41deb21562ec89e3ab90b",
-    "sha7": "e333c4a",
-    "event": "schedule",
+    "sha": "4fcee18598592191a42c1f07464efd96fbf0288f",
+    "sha7": "4fcee18",
+    "event": "workflow_dispatch",
     "workflow": "Daily Dev Publish to npm",
     "type": "branch",
-    "name": "main",
+    "name": "dev",
     "docker": "false"
   }
 }