matterbridge 3.4.1-dev-20251130-17ef5f4 → 3.4.1-dev-20251130-cfb291e

package/CHANGELOG.md

@@ -34,7 +34,7 @@ Advantages:
 - [matterbridge.io]: Updated website https://matterbridge.io with all guides.
 - [matterbridge]: Added addVirtualEndpoint() to match Matterbridge thread module.
 - [BroadcastServer]: Backport BroadcastServer v.2.0.0 from Matterbridge thread module.
-- [MatterbridgePrefix]: Added worker thread to get global node_modules.
+- [MatterbridgePrefix]: Added worker **thread** to get global node_modules.
 - [PluginManager]: Improved the resolve method to resolve automatically also in the plugin directory Usefull for developing with DevContainer.
 
 ### Changed
@@ -44,6 +44,7 @@ Advantages:
 - [frontend]: Bumped `frontend` version to 3.3.2.
 - [platform]: Bumped MatterbridgePlatform v.1.5.0.
 - [thread]: Bump BroadcastServer to v1.0.4.
+- [updates]: The update availability check now starts after 5 minutes and each 12 hours. It can also be triggered from the frontend.
 
 ### Fixed
 

package/README-SERVICE-LOCAL.md

@@ -20,6 +20,8 @@
 
 The advantage of this setup is that the global node_modules are private for the user and sudo is not required.
 
+This configuration uses a private separate npm cache.
+
 The service runs rootless like the current user.
 
 The storage position is compatible with the traditional setup (~/Matterbridge ~/.matterbridge ~/.mattercert).
@@ -30,18 +32,30 @@ This will create the required directories if they don't exist
 
 ```bash
 cd ~
-sudo systemctl stop matterbridge                                                        # ✅ Safe precaution if matterbridge was already running with the traditional setup
-sudo npm uninstall matterbridge -g                                                      # ✅ We need to uninstall from the global node_modules
-mkdir -p ~/Matterbridge ~/.matterbridge ~/.mattercert ~/.npm-global                     # ✅ Creates all needed dirs
-chown -R $USER:$USER ~/Matterbridge ~/.matterbridge ~/.mattercert ~/.npm-global         # ✅ Ensures ownership
-chmod -R 755 ~/Matterbridge ~/.matterbridge ~/.mattercert ~/.npm-global                 # ✅ Secure permissions
-NPM_CONFIG_PREFIX=~/.npm-global npm install matterbridge --omit=dev --verbose --global  # ✅ Install matterbridge in the local global node_modules, no sudo
-sudo ln -sf /home/$USER/.npm-global/bin/matterbridge /usr/local/bin/matterbridge        # ✅ Create a link to matterbridge bin
-sudo ln -sf /home/$USER/.npm-global/bin/mb_mdns /usr/local/bin/mb_mdns                  # ✅ Create a link to mb_mdns bin
-sudo ln -sf /home/$USER/.npm-global/bin/mb_coap /usr/local/bin/mb_coap                  # ✅ Create a link to mb_coap bin
-hash -r                                                                                 # ✅ Clear bash command cache as a precaution
-which matterbridge                                                                      # ✅ Check it
-matterbridge --version                                                                  # ✅ Will output the matterbridge version
+# ✅ Safe precaution if matterbridge was already running with the traditional setup
+sudo systemctl stop matterbridge
+# ✅ We need to uninstall from the global node_modules
+sudo npm uninstall matterbridge -g
+# ✅ Creates all needed dirs
+mkdir -p ~/Matterbridge ~/.matterbridge ~/.mattercert ~/.npm-global ~/.npm-cache
+# ✅ Ensures ownership
+chown -R $USER:$USER ~/Matterbridge ~/.matterbridge ~/.mattercert ~/.npm-global ~/.npm-cache
+# ✅ Secure permissions
+chmod -R 755 ~/Matterbridge ~/.matterbridge ~/.mattercert ~/.npm-global ~/.npm-cache
+# ✅ Install matterbridge in the local global node_modules, with the local cache and no sudo
+npm install matterbridge --omit=dev --verbose --global --prefix=~/.npm-global --cache=~/.npm-cache
+# ✅ Create a link to matterbridge bin
+sudo ln -sf /home/$USER/.npm-global/bin/matterbridge /usr/local/bin/matterbridge
+# ✅ Create a link to mb_mdns bin
+sudo ln -sf /home/$USER/.npm-global/bin/mb_mdns /usr/local/bin/mb_mdns
+# ✅ Create a link to mb_coap bin
+sudo ln -sf /home/$USER/.npm-global/bin/mb_coap /usr/local/bin/mb_coap
+# ✅ Clear bash command cache as a precaution
+hash -r
+# ✅ Check which matterbridge
+which matterbridge
+# ✅ Will output the matterbridge version
+matterbridge --version
 ```
 
 ### Then create a systemctl configuration file for Matterbridge
@@ -52,7 +66,7 @@ Create a systemctl configuration file for Matterbridge
 sudo nano /etc/systemd/system/matterbridge.service
 ```
 
-Add the following to this file, **replacing 4 times (!) USER with your user name** (e.g. WorkingDirectory=/home/pi/Matterbridge, User=pi and Group=pi and Environment="NPM_CONFIG_PREFIX=/home/pi/.npm-global"):
+Add the following to this file, **replacing 5 times (!) USER with your user name** (e.g. WorkingDirectory=/home/pi/Matterbridge, User=pi and Group=pi, Environment="NPM_CONFIG_PREFIX=/home/pi/.npm-global" and Environment="NPM_CONFIG_CACHE=/home/pi/.npm-cache"):
 
 ```
 [Unit]
@@ -63,6 +77,7 @@ Wants=network.target
 [Service]
 Type=simple
 Environment="NPM_CONFIG_PREFIX=/home/<USER>/.npm-global"
+Environment="NPM_CONFIG_CACHE=/home/<USER>/.npm-cache"
 ExecStart=matterbridge --service --nosudo
 WorkingDirectory=/home/<USER>/Matterbridge
 StandardOutput=inherit

package/README-SERVICE-OPT.md

@@ -20,6 +20,8 @@
 
 The advantage of this setup is that the global node_modules are private for matterbridge and sudo is not required.
 
+This configuration uses a private separate npm cache.
+
 The service runs with group and user matterbridge and the system has full protection.
 
 ### Important
@@ -52,15 +54,15 @@ sudo systemctl stop matterbridge 2>/dev/null || true
 # ✅ Safe precaution we need to uninstall from the global node_modules
 sudo npm uninstall matterbridge -g 2>/dev/null || true
 # ✅ Creates all required directories
-sudo mkdir -p /opt/matterbridge /opt/matterbridge/Matterbridge /opt/matterbridge/.matterbridge /opt/matterbridge/.mattercert /opt/matterbridge/.npm-global
+sudo mkdir -p /opt/matterbridge /opt/matterbridge/Matterbridge /opt/matterbridge/.matterbridge /opt/matterbridge/.mattercert /opt/matterbridge/.npm-global /opt/matterbridge/.npm-cache
 # ✅ Ensures ownership
-sudo chown -R matterbridge:matterbridge /opt/matterbridge /opt/matterbridge/Matterbridge /opt/matterbridge/.matterbridge /opt/matterbridge/.mattercert /opt/matterbridge/.npm-global
+sudo chown -R matterbridge:matterbridge /opt/matterbridge /opt/matterbridge/Matterbridge /opt/matterbridge/.matterbridge /opt/matterbridge/.mattercert /opt/matterbridge/.npm-global /opt/matterbridge/.npm-cache
 # ✅ Secure permissions
-sudo chmod -R 755 /opt/matterbridge /opt/matterbridge/Matterbridge /opt/matterbridge/.matterbridge /opt/matterbridge/.mattercert /opt/matterbridge/.npm-global
+sudo chmod -R 755 /opt/matterbridge /opt/matterbridge/Matterbridge /opt/matterbridge/.matterbridge /opt/matterbridge/.mattercert /opt/matterbridge/.npm-global /opt/matterbridge/.npm-cache
 # make sure the “bin” dir exists for global executables
 sudo -u matterbridge mkdir -p /opt/matterbridge/.npm-global/bin
-# ✅ Install matterbridge in the private global node_modules
-sudo -u matterbridge NPM_CONFIG_PREFIX=/opt/matterbridge/.npm-global npm install matterbridge --omit=dev --verbose --global
+# ✅ Install matterbridge in the private global node_modules using the private npm cache
+sudo -u matterbridge NPM_CONFIG_PREFIX=/opt/matterbridge/.npm-global NPM_CONFIG_CACHE=/opt/matterbridge/.npm-cache npm install matterbridge --omit=dev --verbose --global
 # ✅ Create a link to matterbridge bins
 sudo ln -sf /opt/matterbridge/.npm-global/bin/matterbridge /usr/bin/matterbridge
 sudo ln -sf /opt/matterbridge/.npm-global/bin/mb_mdns /usr/bin/mb_mdns

package/dist/broadcastServer.js

@@ -18,6 +18,7 @@ export class BroadcastServer extends EventEmitter {
         this.log = log;
         this.channel = channel;
         this.broadcastChannel = new BroadcastChannel(this.channel);
+        this.broadcastChannel.unref();
         this.broadcastChannel.onmessage = this.broadcastMessageHandler.bind(this);
     }
     close() {

package/dist/jestutils/jestHelpers.js

@@ -290,9 +290,10 @@ export async function startMatterbridgeEnvironment(port = 5540) {
     return [server, aggregator];
 }
 export function addMatterbridgePlatform(platform, name) {
+    expect(platform).toBeDefined();
+    platform.setMatterNode?.(matterbridge.addBridgedEndpoint.bind(matterbridge), matterbridge.removeBridgedEndpoint.bind(matterbridge), matterbridge.removeAllBridgedEndpoints.bind(matterbridge), matterbridge.addVirtualEndpoint.bind(matterbridge));
     if (name)
         platform.config.name = name;
-    expect(platform).toBeDefined();
     expect(platform.config.name).toBeDefined();
     expect(platform.config.type).toBeDefined();
     expect(platform.type).toBeDefined();

package/dist/matterbridge.js

@@ -1700,6 +1700,7 @@ export class Matterbridge extends EventEmitter {
             await wait(2000);
     }
     async addVirtualEndpoint(pluginName, name, type, callback) {
+        this.log.debug(`Adding virtual endpoint ${plg}${pluginName}${db}:${dev}${name}${db}...`);
         const plugin = this.plugins.get(pluginName);
         if (!plugin) {
             this.log.error(`Error adding virtual endpoint ${dev}${name}${er} for plugin ${plg}${pluginName}${er}: plugin not found`);

package/dist/matterbridgePlatform.js

@@ -33,6 +33,17 @@ export class MatterbridgePlatform {
     #server;
     #debug = hasParameter('debug') || hasParameter('verbose');
     #verbose = hasParameter('verbose');
+    #addBridgedEndpoint;
+    #removeBridgedEndpoint;
+    #removeAllBridgedEndpoints;
+    #addVirtualEndpoint;
+    setMatterNode = (addBridgedEndpoint, removeBridgedEndpoint, removeAllBridgedEndpoints, addVirtualEndpoint) => {
+        this.#addBridgedEndpoint = addBridgedEndpoint;
+        this.#removeBridgedEndpoint = removeBridgedEndpoint;
+        this.#removeAllBridgedEndpoints = removeAllBridgedEndpoints;
+        this.#addVirtualEndpoint = addVirtualEndpoint;
+        this.setMatterNode = undefined;
+    };
     constructor(matterbridge, log, config) {
         this.matterbridge = matterbridge;
         this.log = log;
@@ -166,7 +177,7 @@ export class MatterbridgePlatform {
         return this.#registeredEndpoints.has(deviceUniqueId);
     }
     async registerVirtualDevice(name, type, callback) {
-        return await this.matterbridge.addVirtualEndpoint(this.name, name, type, callback);
+        return (await this.#addVirtualEndpoint?.(this.name, name, type, callback)) ?? false;
     }
     async registerDevice(device) {
         device.plugin = this.name;
@@ -206,16 +217,16 @@ export class MatterbridgePlatform {
                 device.createDefaultBridgedDeviceBasicInformationClusterServer(device.deviceName, device.serialNumber, device.vendorId, device.vendorName, device.productName, device.softwareVersion, device.softwareVersionString, device.hardwareVersion, device.hardwareVersionString);
             }
         }
-        await this.matterbridge.addBridgedEndpoint(this.name, device);
+        await this.#addBridgedEndpoint?.(this.name, device);
         this.#registeredEndpoints.set(device.uniqueId, device);
     }
     async unregisterDevice(device) {
-        await this.matterbridge.removeBridgedEndpoint(this.name, device);
+        await this.#removeBridgedEndpoint?.(this.name, device);
         if (device.uniqueId)
             this.#registeredEndpoints.delete(device.uniqueId);
     }
     async unregisterAllDevices(delay = 0) {
-        await this.matterbridge.removeAllBridgedEndpoints(this.name, delay);
+        await this.#removeAllBridgedEndpoints?.(this.name, delay);
         this.#registeredEndpoints.clear();
     }
     async saveSelects() {
@@ -291,7 +302,7 @@ export class MatterbridgePlatform {
         }
         return selectEntities;
     }
-    verifyMatterbridgeVersion(requiredVersion) {
+    verifyMatterbridgeVersion(requiredVersion, destroy = true) {
         const compareVersions = (matterbridgeVersion, requiredVersion) => {
             const stripTag = (v) => {
                 const parts = v.split('-');
@@ -311,8 +322,11 @@ export class MatterbridgePlatform {
             }
             return true;
         };
-        if (!compareVersions(this.matterbridge.matterbridgeVersion, requiredVersion))
+        if (!compareVersions(this.matterbridge.matterbridgeVersion, requiredVersion)) {
+            if (destroy)
+                this.destroy();
             return false;
+        }
         return true;
     }
     validateDevice(device, log = true) {

package/dist/pluginManager.js

@@ -816,6 +816,7 @@ export class PluginManager extends EventEmitter {
                 platform.config = config;
                 platform.version = packageJson.version;
                 platform.isLoaded = true;
+                platform.setMatterNode?.(this.matterbridge.addBridgedEndpoint.bind(this.matterbridge), this.matterbridge.removeBridgedEndpoint.bind(this.matterbridge), this.matterbridge.removeAllBridgedEndpoints.bind(this.matterbridge), this.matterbridge.addVirtualEndpoint.bind(this.matterbridge));
                 plugin.name = packageJson.name;
                 plugin.description = packageJson.description ?? 'No description';
                 plugin.version = packageJson.version;

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge",
-  "version": "3.4.1-dev-20251130-17ef5f4",
+  "version": "3.4.1-dev-20251130-cfb291e",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge",
-      "version": "3.4.1-dev-20251130-17ef5f4",
+      "version": "3.4.1-dev-20251130-cfb291e",
       "license": "Apache-2.0",
       "dependencies": {
         "@matter/main": "0.15.6",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge",
-  "version": "3.4.1-dev-20251130-17ef5f4",
+  "version": "3.4.1-dev-20251130-cfb291e",
   "description": "Matterbridge plugin manager for Matter",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",