matterbridge 3.0.0-edge.10 → 3.0.0-edge.11

package/CHANGELOG.md

@@ -53,18 +53,25 @@ Modified clusters:
 - [endpoint]: Added createDefaultActivatedCarbonFilterMonitoringClusterServer().
 - [deviceTypes]: Added Robotic device type.
 - [deviceTypes]: Added Appliances device types.
+- [frontend]: Added the matterbridge aggregator serialNumber in the QRDiv.
 
 ### Changed
 
-- [package]: Update express to 5.1.0.
-- [package]: Update dependencies.
-- [deviceTypes]: Updated device types to Matter 1.4
+- [package]: Updated package.
+- [package]: Updated express to v5.1.0.
+- [package]: Updated dependencies.
+- [package]: Added tsconfig.jest.json with "isolatedModules": true for ts-jest.
+- [deviceTypes]: Updated device types to Matter 1.4.
+- [clusters]: Updated cluster helpers to Matter 1.4.
 - [matter.js]: Update to 0.13.0-alpha.0-20250405-7fc7db48.
 - [matter.js]: Update to 0.13.0-alpha.0-20250408-c916c7e8.
 - [matter.js]: Update to 0.13.0-alpha.0-20250412-5fad64e7b.
 - [matter.js]: Update to 0.13.0-alpha.0-20250413-d5a27700d.
 - [matter.js]: Update to 0.13.0-alpha.0-20250415-475996bb5.
 - [matter.js]: Update to 0.13.0-alpha.0-20250418-8cfc0b832.
+- [matter.js]: Update to 0.13.0-alpha.0-20250420-9f45e4f77.
+- [help]: Updated cli help screen.
+- [logger]: Improved frontend logger cleaning.
 
 ### Fixed
 

package/README-DEV.md

@@ -80,6 +80,10 @@ Matterbridge must be linked to the plugin in development only.
     "dev:link": "npm link matterbridge",
     '''
 }
+
+On the machine you use for development you should also have matterbridge installed globally or built locally and linked (npm link from the package root).
+
+ Dev and edge branches of matterbridge are not suitable for developemnt cause they are published for production without types. If you want to develop a plugin using the dev or edge branch of matterbridge, you have to clone the dev or edge branch, build locally and link (npm run deepCleanBuild).
 ```
 
 # \***\*\*\*\*\***

package/README-DOCKER.md

@@ -141,6 +141,15 @@ docker restart matterbridge
 docker logs matterbridge
 ```
 
+### Shows the logs for a time interval
+
+```
+docker logs \
+  --since "2025-04-19T00:00:00" \
+  --until "2025-04-19T00:02:00" \
+  matterbridge
+```
+
 ### Shows the logs real time (tail)
 
 ```

package/dist/cli.js

@@ -189,5 +189,5 @@ process.title = 'matterbridge';
 main().catch((error) => {
     const errorMessage = error instanceof Error ? error.message : error;
     const errorInspect = inspect(error, { depth: 10 });
-    log.error(`Matterbridge.loadInstance() failed with error: ${errorMessage}\n${errorInspect}`);
+    log.error(`Matterbridge.loadInstance() failed with error: ${errorMessage}\nstack: ${errorInspect}`);
 });

package/dist/frontend.js

@@ -1502,6 +1502,7 @@ export class Frontend {
         message = message.replace(/[\t\n]/g, '');
         message = message.replace(/[\x00-\x1F\x7F]/g, '');
         message = message.replace(/\\"/g, '"');
+        message = message.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
         const maxContinuousLength = 100;
         const keepStartLength = 20;
         const keepEndLength = 20;

package/dist/matterbridge.js

@@ -51,6 +51,7 @@ export class Matterbridge extends EventEmitter {
         globalModulesDirectory: '',
         matterbridgeVersion: '',
         matterbridgeLatestVersion: '',
+        matterbridgeSerialNumber: '',
         matterbridgeQrPairingCode: undefined,
         matterbridgeManualPairingCode: undefined,
         matterbridgeFabricInformations: [],
@@ -491,6 +492,13 @@ export class Matterbridge extends EventEmitter {
       - nosudo:                force not to use sudo to install or update packages if the internal logic fails
       - norestore:             force not to automatically restore the matterbridge node storage and the matter storage from backup if it is corrupted
       - ssl:                   enable SSL for the frontend and WebSockerServer (certificates in .matterbridge/certs directory cert.pem, key.pem and ca.pem (optional))
+      - vendorId:              override the default vendorId 0xfff1
+      - vendorName:            override the default vendorName "Matterbridge"
+      - productId:             override the default productId 0x8000
+      - productName:           override the default productName "Matterbridge aggregator"
+      - service:               enable the service mode (used in the systemctl configuration file)
+      - docker:                enable the docker mode (used in the Dockerfile to build the docker image)
+      - homedir:               override the home directory (default: os.homedir())
       - add [plugin path]:     register the plugin from the given absolute or relative path
       - add [plugin name]:     register the globally installed plugin with the given name
       - remove [plugin path]:  remove the plugin from the given absolute or relative path
@@ -687,11 +695,15 @@ export class Matterbridge extends EventEmitter {
         process.removeAllListeners('uncaughtException');
         process.removeAllListeners('unhandledRejection');
         this.exceptionHandler = async (error) => {
-            this.log.error('Unhandled Exception detected at:', error.stack || error, rs);
+            const errorMessage = error instanceof Error ? error.message : error;
+            const errorInspect = inspect(error, { depth: 10 });
+            this.log.error(`Unhandled Exception detected: ${errorMessage}\nstack: ${errorInspect}}`);
         };
         process.on('uncaughtException', this.exceptionHandler);
         this.rejectionHandler = async (reason, promise) => {
-            this.log.error('Unhandled Rejection detected at:', promise, 'reason:', reason instanceof Error ? reason.stack : reason, rs);
+            const errorMessage = reason instanceof Error ? reason.message : reason;
+            const errorInspect = inspect(reason, { depth: 10 });
+            this.log.error(`Unhandled Rejection detected: ${promise}\nreason: ${errorMessage}\nstack: ${errorInspect}`);
         };
         process.on('unhandledRejection', this.rejectionHandler);
         this.log.debug(`Registering SIGINT and SIGTERM signal handlers...`);
@@ -1165,6 +1177,7 @@ export class Matterbridge extends EventEmitter {
             plugin.device = device;
             plugin.storageContext = await this.createServerNodeContext(plugin.name, device.deviceName, DeviceTypeId(device.deviceType), device.vendorId, device.vendorName, device.productId, device.productName);
             plugin.serverNode = await this.createServerNode(plugin.storageContext, this.port ? this.port++ : undefined, this.passcode ? this.passcode++ : undefined, this.discriminator ? this.discriminator++ : undefined);
+            plugin.serialNumber = await plugin.storageContext.get('serialNumber', '');
             this.log.debug(`Adding ${plg}${plugin.name}${db}:${dev}${device.deviceName}${db} to ${plg}${plugin.name}${db} server node`);
             await plugin.serverNode.add(device);
             if (start)
@@ -1177,6 +1190,7 @@ export class Matterbridge extends EventEmitter {
             plugin.storageContext = await this.createServerNodeContext(plugin.name, 'Matterbridge', bridge.code, this.aggregatorVendorId, 'Matterbridge', this.aggregatorProductId, plugin.description);
             plugin.serverNode = await this.createServerNode(plugin.storageContext, this.port ? this.port++ : undefined, this.passcode ? this.passcode++ : undefined, this.discriminator ? this.discriminator++ : undefined);
             plugin.aggregatorNode = await this.createAggregatorNode(plugin.storageContext);
+            plugin.serialNumber = await plugin.storageContext.get('serialNumber', '');
             await plugin.serverNode.add(plugin.aggregatorNode);
             if (start)
                 await this.startServerNode(plugin.serverNode);
@@ -1358,6 +1372,7 @@ export class Matterbridge extends EventEmitter {
         this.matterStorageManager = await this.matterStorageService.open('Matterbridge');
         this.log.info('Matter node storage manager "Matterbridge" created');
         this.matterbridgeContext = await this.createServerNodeContext('Matterbridge', 'Matterbridge', bridge.code, this.aggregatorVendorId, this.aggregatorVendorName, this.aggregatorProductId, this.aggregatorProductName);
+        this.matterbridgeInformation.matterbridgeSerialNumber = await this.matterbridgeContext.get('serialNumber', '');
         this.log.info('Matter node storage started');
         await this.backupMatterStorage(path.join(this.matterbridgeDirectory, this.matterStorageName), path.join(this.matterbridgeDirectory, this.matterStorageName + '.backup'));
     }
@@ -1368,7 +1383,7 @@ export class Matterbridge extends EventEmitter {
     }
     async stopMatterStorage() {
         this.log.info('Closing matter node storage...');
-        this.matterStorageManager?.close();
+        await this.matterStorageManager?.close();
         this.matterStorageService = undefined;
         this.matterStorageManager = undefined;
         this.matterbridgeContext = undefined;
@@ -1661,10 +1676,9 @@ export class Matterbridge extends EventEmitter {
                 await this.aggregatorNode?.add(device);
             }
             catch (error) {
-                const errorMessage = error instanceof Error ? error.message : '';
-                const errorStack = error instanceof Error ? error.stack : '';
-                const errorDebug = inspect(error, { depth: 10 });
-                this.log.error(`Error adding bridged endpoint ${dev}${device.deviceName}${er} (${zb}${device.id}${er}) for plugin ${plg}${pluginName}${er}: ${error} ${errorMessage} ${errorStack} ${errorDebug}`);
+                const errorMessage = error instanceof Error ? error.message : error;
+                const errorInspect = inspect(error, { depth: 10 });
+                this.log.error(`Error adding bridged endpoint ${dev}${device.deviceName}${er} (${zb}${device.id}${er}) for plugin ${plg}${pluginName}${er}: ${errorMessage}\nstack: ${errorInspect}`);
                 return;
             }
         }
@@ -1675,10 +1689,9 @@ export class Matterbridge extends EventEmitter {
                     await this.createAccessoryPlugin(plugin, device);
                 }
                 catch (error) {
-                    const errorMessage = error instanceof Error ? error.message : '';
-                    const errorStack = error instanceof Error ? error.stack : '';
-                    const errorDebug = inspect(error, { depth: 10 });
-                    this.log.error(`Error creating endpoint ${dev}${device.deviceName}${er} (${zb}${device.id}${er}) for AccessoryPlatform plugin ${plg}${pluginName}${er} server node: ${error} ${errorMessage} ${errorStack} ${errorDebug}`);
+                    const errorMessage = error instanceof Error ? error.message : error;
+                    const errorInspect = inspect(error, { depth: 10 });
+                    this.log.error(`Error creating endpoint ${dev}${device.deviceName}${er} (${zb}${device.id}${er}) for AccessoryPlatform plugin ${plg}${pluginName}${er} server node: ${errorMessage}\nstack: ${errorInspect}`);
                     return;
                 }
             }
@@ -1691,10 +1704,9 @@ export class Matterbridge extends EventEmitter {
                     await plugin.aggregatorNode?.add(device);
                 }
                 catch (error) {
-                    const errorMessage = error instanceof Error ? error.message : '';
-                    const errorStack = error instanceof Error ? error.stack : '';
-                    const errorDebug = inspect(error, { depth: 10 });
-                    this.log.error(`Error adding bridged endpoint ${dev}${device.deviceName}${er} (${zb}${device.id}${er}) for DynamicPlatform plugin ${plg}${pluginName}${er} aggregator node: ${error} ${errorMessage} ${errorStack} ${errorDebug}`);
+                    const errorMessage = error instanceof Error ? error.message : error;
+                    const errorInspect = inspect(error, { depth: 10 });
+                    this.log.error(`Error adding bridged endpoint ${dev}${device.deviceName}${er} (${zb}${device.id}${er}) for DynamicPlatform plugin ${plg}${pluginName}${er} aggregator node: ${errorMessage}\nstack: ${errorInspect}`);
                     return;
                 }
             }

package/dist/matterbridgeEndpoint.js

@@ -782,18 +782,24 @@ export class MatterbridgeEndpoint extends Endpoint {
         return this;
     }
     createDefaultHepaFilterMonitoringClusterServer(changeIndication = ResourceMonitoring.ChangeIndication.Ok, inPlaceIndicator = undefined, lastChangedTime = undefined) {
-        this.behaviors.require(HepaFilterMonitoringServer, {
+        this.behaviors.require(HepaFilterMonitoringServer.with(ResourceMonitoring.Feature.Condition, ResourceMonitoring.Feature.ReplacementProductList), {
+            condition: 100,
+            degradationDirection: ResourceMonitoring.DegradationDirection.Down,
             changeIndication,
             inPlaceIndicator,
             lastChangedTime,
+            replacementProductList: [],
         });
         return this;
     }
     createDefaultActivatedCarbonFilterMonitoringClusterServer(changeIndication = ResourceMonitoring.ChangeIndication.Ok, inPlaceIndicator = undefined, lastChangedTime = undefined) {
-        this.behaviors.require(ActivatedCarbonFilterMonitoringServer, {
+        this.behaviors.require(ActivatedCarbonFilterMonitoringServer.with(ResourceMonitoring.Feature.Condition, ResourceMonitoring.Feature.ReplacementProductList), {
+            condition: 100,
+            degradationDirection: ResourceMonitoring.DegradationDirection.Down,
             changeIndication,
             inPlaceIndicator,
             lastChangedTime,
+            replacementProductList: [],
         });
         return this;
     }

package/frontend/build/asset-manifest.json

@@ -1,7 +1,7 @@
 {
   "files": {
     "main.css": "./static/css/main.ea7910e9.css",
-    "main.js": "./static/js/main.ff47208e.js",
+    "main.js": "./static/js/main.eb438c68.js",
     "static/js/453.d855a71b.chunk.js": "./static/js/453.d855a71b.chunk.js",
     "static/media/roboto-latin-700-normal.woff2": "./static/media/roboto-latin-700-normal.c4d6cab43bec89049809.woff2",
     "static/media/roboto-latin-500-normal.woff2": "./static/media/roboto-latin-500-normal.599f66a60bdf974e578e.woff2",
@@ -77,11 +77,11 @@
     "static/media/roboto-greek-ext-300-normal.woff": "./static/media/roboto-greek-ext-300-normal.60729cafbded24073dfb.woff",
     "index.html": "./index.html",
     "main.ea7910e9.css.map": "./static/css/main.ea7910e9.css.map",
-    "main.ff47208e.js.map": "./static/js/main.ff47208e.js.map",
+    "main.eb438c68.js.map": "./static/js/main.eb438c68.js.map",
     "453.d855a71b.chunk.js.map": "./static/js/453.d855a71b.chunk.js.map"
   },
   "entrypoints": [
     "static/css/main.ea7910e9.css",
-    "static/js/main.ff47208e.js"
+    "static/js/main.eb438c68.js"
   ]
 }

package/frontend/build/index.html

@@ -1 +1 @@
-<!doctype html><html lang="en"><head><meta charset="utf-8"/><base href="./"><link rel="icon" href="./matterbridge 32x32.png"/><meta name="viewport" content="width=device-width,initial-scale=1"/><meta name="theme-color" content="#000000"/><title>Matterbridge</title><link rel="manifest" href="./manifest.json"/><script defer="defer" src="./static/js/main.ff47208e.js"></script><link href="./static/css/main.ea7910e9.css" rel="stylesheet"></head><body><noscript>You need to enable JavaScript to run this app.</noscript><div id="root"></div></body></html>
+<!doctype html><html lang="en"><head><meta charset="utf-8"/><base href="./"><link rel="icon" href="./matterbridge 32x32.png"/><meta name="viewport" content="width=device-width,initial-scale=1"/><meta name="theme-color" content="#000000"/><title>Matterbridge</title><link rel="manifest" href="./manifest.json"/><script defer="defer" src="./static/js/main.eb438c68.js"></script><link href="./static/css/main.ea7910e9.css" rel="stylesheet"></head><body><noscript>You need to enable JavaScript to run this app.</noscript><div id="root"></div></body></html>