matterbridge 3.3.7-dev-20251105-440e549 → 3.3.7-dev-20251108-f254812

package/CHANGELOG.md

@@ -28,17 +28,22 @@ Advantages:
 - individual plugin isolation in childbridge mode;
 - ability to update the plugin in childbridge mode without restarting matterbridge;
 
-## [3.3.7] - 2025-11-??
+## [3.3.7] - 2025-11-07
 
 ### Breaking Changes
 
+- [frontend]: When a plugin is first added, it will not be anymore started to allow to configure it before restarting.
+
 ### Added
 
-- [matterbridge]: Added a first check for plugin existence (docker pull or Hass add-on rebuild) and reinstall it before parsing the plugin.
+- [matterbridge]: Added a first check for plugin existence (docker pull or Hass add-on rebuild) and reinstall it before parsing the plugin. The error messages have been removed.
+- [service]: Added [configuration](README-SERVICE-OPT.md) to run matterbridge as a daemon with systemctl (Linux only) and with private global node_modules (user matterbridge and no sudo required).
 
 ### Changed
 
 - [frontend]: Bumped `frontend` version to 3.3.1.
+- [PluginManager]: Bumped `PluginManager` version to 1.3.0.
+- [DeviceManager]: Bumped `DeviceManager` version to 1.1.0.
 - [frontend]: Readded password dialog when running in Ingress.
 
 ### Fixed

package/README-SERVICE-LOCAL.md

@@ -18,9 +18,9 @@
 
 ## Run matterbridge as a daemon with systemctl (Linux only) with local global node_modules
 
-The advantage of this setup is that the global node_modules are private for matterbridge and sudo is not required.
+The advantage of this setup is that the global node_modules are private for the user and sudo is not required.
 
-The service runs rootless.
+The service runs rootless like the current user.
 
 The storage position is compatible with the traditional setup (~/Matterbridge ~/.matterbridge ~/.mattercert).
 
@@ -37,6 +37,8 @@ chown -R $USER:$USER ~/Matterbridge ~/.matterbridge ~/.mattercert ~/.npm-global
 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

package/README-SERVICE-OPT.md

@@ -0,0 +1,168 @@
+# <img src="frontend/public/matterbridge.svg" alt="Matterbridge Logo" width="64px" height="64px">&nbsp;&nbsp;&nbsp;Matterbridge systemd configuration with private global node_modules
+
+[![npm version](https://img.shields.io/npm/v/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
+[![npm downloads](https://img.shields.io/npm/dt/matterbridge.svg)](https://www.npmjs.com/package/matterbridge)
+[![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge?label=docker%20version&sort=semver)](https://hub.docker.com/r/luligu/matterbridge)
+[![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge.svg)](https://hub.docker.com/r/luligu/matterbridge)
+![Node.js CI](https://github.com/Luligu/matterbridge/actions/workflows/build.yml/badge.svg)
+![CodeQL](https://github.com/Luligu/matterbridge/actions/workflows/codeql.yml/badge.svg)
+[![codecov](https://codecov.io/gh/Luligu/matterbridge/branch/main/graph/badge.svg)](https://codecov.io/gh/Luligu/matterbridge)
+
+[![power by](https://img.shields.io/badge/powered%20by-matter--history-blue)](https://www.npmjs.com/package/matter-history)
+[![power by](https://img.shields.io/badge/powered%20by-node--ansi--logger-blue)](https://www.npmjs.com/package/node-ansi-logger)
+[![power by](https://img.shields.io/badge/powered%20by-node--persist--manager-blue)](https://www.npmjs.com/package/node-persist-manager)
+
+---
+
+# Advanced configuration
+
+## Run matterbridge as a daemon with systemctl (Linux only) with user matterbridge and private global node_modules
+
+The advantage of this setup is that the global node_modules are private for matterbridge and sudo is not required.
+
+The service runs with user matterbridge and the system has full protection.
+
+The storage position is **not compatible** with the traditional setup (~/Matterbridge ~/.matterbridge ~/.mattercert).
+
+### 1 - Create the matterbridge user and group
+
+```bash
+sudo groupadd --system matterbridge 2>/dev/null || true
+sudo useradd  --system \
+  --home-dir /opt/matterbridge \
+  --shell /usr/sbin/nologin \
+  --gid matterbridge \
+  matterbridge 2>/dev/null || true
+```
+
+### 2 - Create the Matterbridge directories and set the correct permissions
+
+This will create the required directories if they don't exist
+
+```bash
+cd ~
+# ✅ 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
+sudo mkdir -p /opt/matterbridge /opt/matterbridge/Matterbridge /opt/matterbridge/.matterbridge /opt/matterbridge/.mattercert /opt/matterbridge/.npm-global
+# ✅ Ensures ownership
+sudo chown -R matterbridge:matterbridge /opt/matterbridge /opt/matterbridge/Matterbridge /opt/matterbridge/.matterbridge /opt/matterbridge/.mattercert /opt/matterbridge/.npm-global
+# ✅ Secure permissions
+sudo chmod -R 755 /opt/matterbridge /opt/matterbridge/Matterbridge /opt/matterbridge/.matterbridge /opt/matterbridge/.mattercert /opt/matterbridge/.npm-global
+# 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
+# ✅ Create a link to matterbridge bin
+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
+sudo ln -sf /opt/matterbridge/.npm-global/bin/mb_coap /usr/bin/mb_coap
+# ✅ Clear bash command cache as a precaution
+hash -r
+# ✅ Check if matterbridge is /usr/bin/matterbridge
+which matterbridge
+# ✅ Will output the matterbridge version
+matterbridge --version
+```
+
+The storage position is **not compatible** with the traditional setup (~/Matterbridge ~/.matterbridge ~/.mattercert).
+
+You may want to copy the contents to the new directories.
+
+### 3 - Create a systemctl configuration file for Matterbridge
+
+Create a systemctl configuration file for Matterbridge
+
+```bash
+sudo nano /etc/systemd/system/matterbridge.service
+```
+
+Add the following to this file:
+
+```
+[Unit]
+Description=matterbridge
+After=network.target
+Wants=network.target
+
+[Service]
+Type=simple
+Environment=NODE_ENV=production
+Environment="NPM_CONFIG_PREFIX=/opt/matterbridge/.npm-global"
+ExecStart=matterbridge --service --nosudo
+WorkingDirectory=/opt/matterbridge/Matterbridge
+StandardOutput=inherit
+StandardError=inherit
+Restart=always
+User=matterbridge
+Group=matterbridge
+NoNewPrivileges=true
+PrivateTmp=true
+ProtectSystem=full
+ProtectHome=true
+ReadWritePaths=/opt/matterbridge
+
+[Install]
+WantedBy=multi-user.target
+```
+
+If you use the frontend with **-ssl** -frontend 443 and get an error message: "Port 443 requires elevated privileges",
+add this:
+
+```
+[Service]
+AmbientCapabilities=CAP_NET_BIND_SERVICE
+```
+
+If you use the **matterbridge-bthome** plugin add this:
+
+```
+[Service]
+AmbientCapabilities=CAP_NET_BIND_SERVICE CAP_NET_RAW CAP_NET_ADMIN
+```
+
+Now and if you modify matterbridge.service after, run:
+
+```bash
+sudo systemctl daemon-reload
+sudo systemctl restart matterbridge.service
+sudo systemctl status matterbridge.service
+```
+
+### Start Matterbridge
+
+```bash
+sudo systemctl start matterbridge
+```
+
+### Stop Matterbridge
+
+```bash
+sudo systemctl stop matterbridge
+```
+
+### Show Matterbridge status
+
+```bash
+sudo systemctl status matterbridge.service
+```
+
+### Enable Matterbridge to start automatically on boot
+
+```bash
+sudo systemctl enable matterbridge.service
+```
+
+### Disable Matterbridge from starting automatically on boot
+
+```bash
+sudo systemctl disable matterbridge.service
+```
+
+### View the log of Matterbridge in real time (this will show the log with colors)
+
+```bash
+sudo journalctl -u matterbridge.service -n 1000 -f --output cat
+```

package/README.md

@@ -30,11 +30,11 @@ Matterbridge creates a device that can be paired with any ecosystem, such as App
 
 You don't need a hub or a dedicated new machine.
 
-No complex setup: just copy paste the installation scripts.
+No complex setup: just copy paste the installation scripts (available for Docker, Nginx, Linux systemctl and macOS launchctl).
 
 Matterbridge is lightweight and also runs on slow Linux machines with as little as 512MB of memory.
 
-It also runs perfectly on macOS and Windows.
+It runs perfectly on Linux, macOS and Windows.
 
 If you like this project and find it useful, please consider giving it a star on GitHub at https://github.com/Luligu/matterbridge and sponsoring it.
 
@@ -64,6 +64,8 @@ https://www.matteralpha.com/how-to/how-to-configure-an-open-source-matter-bridge
 
 https://matter-smarthome.de/en/interview/an-alternative-to-the-official-matter-sdk/
 
+https://blog.adafruit.com/2025/11/03/matterbridge-a-matter-plugin-manager/
+
 ## Prerequisites
 
 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.

package/dist/broadcastServer.js

@@ -3,11 +3,14 @@ if (process.argv.includes('--loader') || process.argv.includes('-loader'))
 import { EventEmitter } from 'node:events';
 import { BroadcastChannel } from 'node:worker_threads';
 import { debugStringify } from 'node-ansi-logger';
+import { hasParameter } from './utils/commandLine.js';
 export class BroadcastServer extends EventEmitter {
     name;
     log;
     channel;
     broadcastChannel;
+    debug = hasParameter('debug') || hasParameter('verbose');
+    verbose = hasParameter('verbose');
     constructor(name, log, channel = 'broadcast-channel') {
         super();
         this.name = name;
@@ -31,10 +34,13 @@ export class BroadcastServer extends EventEmitter {
     }
     broadcastMessageHandler(event) {
         const data = event.data;
-        this.log.debug(`Received broadcast message: ${debugStringify(data)}`);
+        if (this.verbose)
+            this.log.debug(`Received broadcast message: ${debugStringify(data)}`);
         this.emit('broadcast_message', data);
     }
     broadcast(message) {
+        if (this.verbose)
+            this.log.debug(`Broadcasting message: ${debugStringify(message)}`);
         this.broadcastChannel.postMessage(message);
     }
     request(message) {
@@ -48,7 +54,8 @@ export class BroadcastServer extends EventEmitter {
             this.log.error(`Invalid request message format for broadcast: ${debugStringify(message)}`);
             return;
         }
-        this.log.debug(`Broadcasting request message: ${debugStringify(message)}`);
+        if (this.verbose)
+            this.log.debug(`Broadcasting request message: ${debugStringify(message)}`);
         this.broadcastChannel.postMessage(message);
     }
     respond(message) {
@@ -59,23 +66,26 @@ export class BroadcastServer extends EventEmitter {
             this.log.error(`Invalid response message format for broadcast: ${debugStringify(message)}`);
             return;
         }
-        this.log.debug(`Broadcasting response message: ${debugStringify(message)}`);
+        if (this.verbose)
+            this.log.debug(`Broadcasting response message: ${debugStringify(message)}`);
         this.broadcastChannel.postMessage(message);
     }
-    async fetch(message) {
+    async fetch(message, timeout = 100) {
         if (message.id === undefined) {
             message.id = this.getUniqueId();
         }
         if (message.timestamp === undefined) {
             message.timestamp = Date.now();
         }
-        this.log.debug(`Fetching message: ${debugStringify(message)}`);
+        if (this.verbose)
+            this.log.debug(`Fetching message: ${debugStringify(message)}`);
         return new Promise((resolve, reject) => {
             const responseHandler = (msg) => {
                 if (this.isWorkerResponse(msg, message.type) && msg.id === message.id) {
                     clearTimeout(timeoutId);
                     this.off('broadcast_message', responseHandler);
-                    this.log.debug(`Fetch response: ${debugStringify(msg)}`);
+                    if (this.verbose)
+                        this.log.debug(`Fetch response: ${debugStringify(msg)}`);
                     resolve(msg);
                 }
             };
@@ -83,8 +93,8 @@ export class BroadcastServer extends EventEmitter {
             this.request(message);
             const timeoutId = setTimeout(() => {
                 this.off('broadcast_message', responseHandler);
-                reject(new Error(`Fetch timeout after 100ms for message id ${message.id}`));
-            }, 100);
+                reject(new Error(`Fetch timeout after ${timeout}ms for message id ${message.id}`));
+            }, timeout);
         });
     }
 }

package/dist/deviceManager.js

@@ -6,6 +6,8 @@ export class DeviceManager {
     _devices = new Map();
     log;
     server;
+    debug = hasParameter('debug') || hasParameter('verbose');
+    verbose = hasParameter('verbose');
     constructor() {
         this.log = new AnsiLogger({ logName: 'DeviceManager', logTimestampFormat: 4, logLevel: hasParameter('debug') ? "debug" : "info" });
         this.log.debug('Matterbridge device manager starting...');
@@ -18,7 +20,8 @@ export class DeviceManager {
     }
     async msgHandler(msg) {
         if (this.server.isWorkerRequest(msg, msg.type) && (msg.dst === 'all' || msg.dst === 'devices')) {
-            this.log.debug(`**Received request message ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}: ${debugStringify(msg)}${db}`);
+            if (this.verbose)
+                this.log.debug(`Received request message ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}: ${debugStringify(msg)}${db}`);
             switch (msg.type) {
                 case 'get_log_level':
                     this.server.respond({ ...msg, response: { success: true, logLevel: this.log.logLevel } });
@@ -49,8 +52,12 @@ export class DeviceManager {
                     this.clear();
                     this.server.respond({ ...msg, response: { success: true } });
                     break;
+                case 'devices_basearray':
+                    this.server.respond({ ...msg, response: { devices: this.baseArray(msg.params.pluginName) } });
+                    break;
                 default:
-                    this.log.debug(`Unknown broadcast message ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}`);
+                    if (this.verbose)
+                        this.log.debug(`Unknown broadcast message ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}`);
             }
         }
     }
@@ -84,9 +91,31 @@ export class DeviceManager {
     clear() {
         this._devices.clear();
     }
+    toBaseDevice(device) {
+        return {
+            pluginName: device.plugin,
+            deviceType: device.deviceType,
+            number: device.maybeNumber,
+            id: device.maybeId,
+            deviceName: device.deviceName,
+            serialNumber: device.serialNumber,
+            uniqueId: device.uniqueId,
+            productUrl: device.productUrl,
+            configUrl: device.configUrl,
+        };
+    }
     array() {
         return Array.from(this._devices.values());
     }
+    baseArray(pluginName) {
+        const devices = [];
+        for (const device of this._devices.values()) {
+            if (pluginName && pluginName !== device.plugin)
+                continue;
+            devices.push(this.toBaseDevice(device));
+        }
+        return devices;
+    }
     [Symbol.iterator]() {
         return this._devices.values();
     }

package/dist/frontend.js

@@ -32,6 +32,8 @@ export class Frontend extends EventEmitter {
     httpsServer;
     webSocketServer;
     server;
+    debug = hasParameter('debug') || hasParameter('verbose');
+    verbose = hasParameter('verbose');
     constructor(matterbridge) {
         super();
         this.matterbridge = matterbridge;
@@ -45,7 +47,8 @@ export class Frontend extends EventEmitter {
     }
     async msgHandler(msg) {
         if (this.server.isWorkerRequest(msg, msg.type) && (msg.dst === 'all' || msg.dst === 'frontend')) {
-            this.log.debug(`Received broadcast request ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}: ${debugStringify(msg)}${db}`);
+            if (this.verbose)
+                this.log.debug(`Received broadcast request ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}: ${debugStringify(msg)}${db}`);
             switch (msg.type) {
                 case 'get_log_level':
                     this.server.respond({ ...msg, response: { success: true, logLevel: this.log.logLevel } });
@@ -87,11 +90,13 @@ export class Frontend extends EventEmitter {
                     this.server.respond({ ...msg, response: { success: true } });
                     break;
                 default:
-                    this.log.debug(`Unknown broadcast request ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}`);
+                    if (this.verbose)
+                        this.log.debug(`Unknown broadcast request ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}`);
             }
         }
         if (this.server.isWorkerResponse(msg, msg.type)) {
-            this.log.debug(`Received broadcast response ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}: ${debugStringify(msg)}${db}`);
+            if (this.verbose)
+                this.log.debug(`Received broadcast response ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}: ${debugStringify(msg)}${db}`);
             switch (msg.type) {
                 case 'get_log_level':
                 case 'set_log_level':
@@ -119,7 +124,8 @@ export class Frontend extends EventEmitter {
                     }
                     break;
                 default:
-                    this.log.debug(`Unknown broadcast response ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}`);
+                    if (this.verbose)
+                        this.log.debug(`Unknown broadcast response ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}`);
             }
         }
     }
@@ -1192,22 +1198,19 @@ export class Frontend extends EventEmitter {
                     this.wssSendSnackbarMessage(`Plugin ${data.params.pluginNameOrPath} not added`, 10, 'error');
                     return;
                 }
+                this.wssSendSnackbarMessage(`Adding plugin ${data.params.pluginNameOrPath}...`, 5);
+                this.log.debug(`Adding plugin ${data.params.pluginNameOrPath}...`);
                 data.params.pluginNameOrPath = data.params.pluginNameOrPath.replace(/@.*$/, '');
-                if (this.matterbridge.plugins.has(data.params.pluginNameOrPath)) {
-                    sendResponse({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: `Plugin ${data.params.pluginNameOrPath} already added` });
-                    this.wssSendSnackbarMessage(`Plugin ${data.params.pluginNameOrPath} already added`, 10, 'warning');
-                    return;
-                }
                 const plugin = await this.matterbridge.plugins.add(data.params.pluginNameOrPath);
                 if (plugin) {
                     sendResponse({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, success: true });
                     this.wssSendSnackbarMessage(`Added plugin ${data.params.pluginNameOrPath}`, 5, 'success');
                     this.matterbridge.plugins
-                        .load(plugin, true, 'The plugin has been added', true)
+                        .load(plugin)
                         .then(() => {
                         this.wssSendRefreshRequired('plugins');
                         this.wssSendRefreshRequired('devices');
-                        this.wssSendSnackbarMessage(`Started plugin ${localData.params.pluginNameOrPath}`, 5, 'success');
+                        this.wssSendSnackbarMessage(`Loaded plugin ${localData.params.pluginNameOrPath}`, 5, 'success');
                         return;
                     })
                         .catch((_error) => {
@@ -1223,6 +1226,8 @@ export class Frontend extends EventEmitter {
                     sendResponse({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Wrong parameter pluginName in /api/removeplugin' });
                     return;
                 }
+                this.wssSendSnackbarMessage(`Removing plugin ${data.params.pluginName}...`, 5);
+                this.log.debug(`Removing plugin ${data.params.pluginName}...`);
                 const plugin = this.matterbridge.plugins.get(data.params.pluginName);
                 await this.matterbridge.plugins.shutdown(plugin, 'The plugin has been removed.', true);
                 await this.matterbridge.plugins.remove(data.params.pluginName);

package/dist/matterbridge.js

@@ -120,6 +120,8 @@ export class Matterbridge extends EventEmitter {
     aggregatorUniqueId = getParameter('uniqueId');
     advertisingNodes = new Map();
     server;
+    debug = hasParameter('debug') || hasParameter('verbose');
+    verbose = hasParameter('verbose');
     constructor() {
         super();
         this.log.logNameColor = '\x1b[38;5;115m';
@@ -131,7 +133,8 @@ export class Matterbridge extends EventEmitter {
     }
     async msgHandler(msg) {
         if (this.server.isWorkerRequest(msg, msg.type) && (msg.dst === 'all' || msg.dst === 'matterbridge')) {
-            this.log.debug(`**Received broadcast request ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}: ${debugStringify(msg)}${db}`);
+            if (this.verbose)
+                this.log.debug(`Received broadcast request ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}: ${debugStringify(msg)}${db}`);
             switch (msg.type) {
                 case 'get_log_level':
                     this.server.respond({ ...msg, response: { success: true, logLevel: this.log.logLevel } });
@@ -141,17 +144,20 @@ export class Matterbridge extends EventEmitter {
                     this.server.respond({ ...msg, response: { success: true, logLevel: this.log.logLevel } });
                     break;
                 default:
-                    this.log.debug(`Unknown broadcast request ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}`);
+                    if (this.verbose)
+                        this.log.debug(`Unknown broadcast request ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}`);
             }
         }
         if (this.server.isWorkerResponse(msg, msg.type)) {
-            this.log.debug(`**Received broadcast response ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}: ${debugStringify(msg)}${db}`);
+            if (this.verbose)
+                this.log.debug(`Received broadcast response ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}: ${debugStringify(msg)}${db}`);
             switch (msg.type) {
                 case 'get_log_level':
                 case 'set_log_level':
                     break;
                 default:
-                    this.log.debug(`Unknown broadcast response ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}`);
+                    if (this.verbose)
+                        this.log.debug(`Unknown broadcast response ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}`);
             }
         }
     }

package/dist/pluginManager.js

@@ -5,10 +5,12 @@ import { inspectError, logError } from './utils/error.js';
 import { hasParameter } from './utils/commandLine.js';
 import { BroadcastServer } from './broadcastServer.js';
 export class PluginManager extends EventEmitter {
-    _plugins = new Map();
     matterbridge;
+    _plugins = new Map();
     log;
     server;
+    debug = hasParameter('debug') || hasParameter('verbose');
+    verbose = hasParameter('verbose');
     constructor(matterbridge) {
         super();
         this.matterbridge = matterbridge;
@@ -23,7 +25,8 @@ export class PluginManager extends EventEmitter {
     }
     async msgHandler(msg) {
         if (this.server.isWorkerRequest(msg, msg.type) && (msg.dst === 'all' || msg.dst === 'plugins')) {
-            this.log.debug(`**Received request message ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}: ${debugStringify(msg)}${db}`);
+            if (this.verbose)
+                this.log.debug(`Received request message ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}: ${debugStringify(msg)}${db}`);
             switch (msg.type) {
                 case 'get_log_level':
                     this.server.respond({ ...msg, response: { success: true, logLevel: this.log.logLevel } });
@@ -42,13 +45,24 @@ export class PluginManager extends EventEmitter {
                     this.server.respond({ ...msg, response: { has: this.has(msg.params.name) } });
                     break;
                 case 'plugins_get':
-                    this.server.respond({ ...msg, response: { plugin: this.get(msg.params.name) } });
+                    {
+                        const plugin = this.get(msg.params.name);
+                        if (plugin) {
+                            this.server.respond({ ...msg, response: { plugin: this.toApiPlugin(plugin) } });
+                        }
+                        else {
+                            this.server.respond({ ...msg, response: { plugin: undefined } });
+                        }
+                    }
                     break;
                 case 'plugins_set':
                     this.server.respond({ ...msg, response: { plugin: this.set(msg.params.plugin) } });
                     break;
-                case 'plugins_baseArray':
-                    this.server.respond({ ...msg, response: { plugins: this.baseArray() } });
+                case 'plugins_storagepluginarray':
+                    this.server.respond({ ...msg, response: { plugins: this.storagePluginArray() } });
+                    break;
+                case 'plugins_apipluginarray':
+                    this.server.respond({ ...msg, response: { plugins: this.apiPluginArray() } });
                     break;
                 case 'plugins_install':
                     this.server.respond({ ...msg, response: { packageName: msg.params.packageName, success: await this.install(msg.params.packageName) } });
@@ -56,8 +70,97 @@ export class PluginManager extends EventEmitter {
                 case 'plugins_uninstall':
                     this.server.respond({ ...msg, response: { packageName: msg.params.packageName, success: await this.uninstall(msg.params.packageName) } });
                     break;
+                case 'plugins_add':
+                    {
+                        const plugin = await this.add(msg.params.nameOrPath);
+                        if (plugin) {
+                            this.server.respond({ ...msg, response: { plugin: this.toApiPlugin(plugin) } });
+                        }
+                        else {
+                            this.server.respond({ ...msg, response: { plugin } });
+                        }
+                    }
+                    break;
+                case 'plugins_remove':
+                    {
+                        const plugin = await this.remove(msg.params.nameOrPath);
+                        if (plugin) {
+                            this.server.respond({ ...msg, response: { plugin: this.toApiPlugin(plugin) } });
+                        }
+                        else {
+                            this.server.respond({ ...msg, response: { plugin } });
+                        }
+                    }
+                    break;
+                case 'plugins_enable':
+                    {
+                        const plugin = await this.enable(msg.params.nameOrPath);
+                        if (plugin) {
+                            this.server.respond({ ...msg, response: { plugin: this.toApiPlugin(plugin) } });
+                        }
+                        else {
+                            this.server.respond({ ...msg, response: { plugin } });
+                        }
+                    }
+                    break;
+                case 'plugins_disable':
+                    {
+                        const plugin = await this.disable(msg.params.nameOrPath);
+                        if (plugin) {
+                            this.server.respond({ ...msg, response: { plugin: this.toApiPlugin(plugin) } });
+                        }
+                        else {
+                            this.server.respond({ ...msg, response: { plugin } });
+                        }
+                    }
+                    break;
+                case 'plugins_load':
+                    {
+                        const platform = await this.load(msg.params.plugin);
+                        if (platform) {
+                            this.server.respond({ ...msg, params: {}, response: { platform: {} } });
+                        }
+                        else {
+                            this.server.respond({ ...msg, response: { platform } });
+                        }
+                    }
+                    break;
+                case 'plugins_start':
+                    {
+                        const plugin = await this.start(msg.params.plugin, msg.params.message, msg.params.configure);
+                        if (plugin) {
+                            this.server.respond({ ...msg, params: {}, response: { plugin: this.toApiPlugin(plugin) } });
+                        }
+                        else {
+                            this.server.respond({ ...msg, response: { plugin } });
+                        }
+                    }
+                    break;
+                case 'plugins_configure':
+                    {
+                        const plugin = await this.configure(msg.params.plugin);
+                        if (plugin) {
+                            this.server.respond({ ...msg, params: {}, response: { plugin: this.toApiPlugin(plugin) } });
+                        }
+                        else {
+                            this.server.respond({ ...msg, response: { plugin } });
+                        }
+                    }
+                    break;
+                case 'plugins_shutdown':
+                    {
+                        const plugin = await this.shutdown(msg.params.plugin, msg.params.reason, msg.params.removeAllDevices, msg.params.force);
+                        if (plugin) {
+                            this.server.respond({ ...msg, params: {}, response: { plugin: this.toApiPlugin(plugin) } });
+                        }
+                        else {
+                            this.server.respond({ ...msg, response: { plugin } });
+                        }
+                    }
+                    break;
                 default:
-                    this.log.debug(`Unknown broadcast message ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}`);
+                    if (this.verbose)
+                        this.log.debug(`Unknown broadcast message ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}`);
             }
         }
     }
@@ -80,41 +183,62 @@ export class PluginManager extends EventEmitter {
     clear() {
         this._plugins.clear();
     }
+    toStoragePlugin(plugin) {
+        return {
+            name: plugin.name,
+            path: plugin.path,
+            type: plugin.type,
+            version: plugin.version,
+            description: plugin.description,
+            author: plugin.author,
+            enabled: plugin.enabled,
+        };
+    }
+    toApiPlugin(plugin) {
+        return {
+            name: plugin.name,
+            version: plugin.version,
+            description: plugin.description,
+            author: plugin.author,
+            path: plugin.path,
+            type: plugin.type,
+            latestVersion: plugin.latestVersion,
+            devVersion: plugin.devVersion,
+            homepage: plugin.homepage,
+            help: plugin.help,
+            changelog: plugin.changelog,
+            funding: plugin.funding,
+            locked: plugin.locked,
+            error: plugin.error,
+            enabled: plugin.enabled,
+            loaded: plugin.loaded,
+            started: plugin.started,
+            configured: plugin.configured,
+            restartRequired: plugin.restartRequired,
+            registeredDevices: plugin.registeredDevices,
+            configJson: plugin.configJson,
+            schemaJson: plugin.schemaJson,
+            hasWhiteList: plugin.hasWhiteList,
+            hasBlackList: plugin.hasBlackList,
+            matter: plugin.serverNode ? this.matterbridge.getServerNodeData(plugin.serverNode) : undefined,
+        };
+    }
     array() {
         return Array.from(this._plugins.values());
     }
-    baseArray() {
-        const basePlugins = [];
+    storagePluginArray() {
+        const storagePlugins = [];
         for (const plugin of this._plugins.values()) {
-            basePlugins.push({
-                name: plugin.name,
-                version: plugin.version,
-                description: plugin.description,
-                author: plugin.author,
-                path: plugin.path,
-                type: plugin.type,
-                latestVersion: plugin.latestVersion,
-                devVersion: plugin.devVersion,
-                homepage: plugin.homepage,
-                help: plugin.help,
-                changelog: plugin.changelog,
-                funding: plugin.funding,
-                locked: plugin.locked,
-                error: plugin.error,
-                enabled: plugin.enabled,
-                loaded: plugin.loaded,
-                started: plugin.started,
-                configured: plugin.configured,
-                restartRequired: plugin.restartRequired,
-                registeredDevices: plugin.registeredDevices,
-                configJson: plugin.configJson,
-                schemaJson: plugin.schemaJson,
-                hasWhiteList: plugin.hasWhiteList,
-                hasBlackList: plugin.hasBlackList,
-                matter: plugin.serverNode ? this.matterbridge.getServerNodeData(plugin.serverNode) : undefined,
-            });
+            storagePlugins.push(this.toStoragePlugin(plugin));
+        }
+        return storagePlugins;
+    }
+    apiPluginArray() {
+        const apiPlugins = [];
+        for (const plugin of this._plugins.values()) {
+            apiPlugins.push(this.toApiPlugin(plugin));
         }
-        return basePlugins;
+        return apiPlugins;
     }
     [Symbol.iterator]() {
         return this._plugins.values();
@@ -244,6 +368,7 @@ export class PluginManager extends EventEmitter {
         }
     }
     async install(packageName) {
+        this.log.debug(`Installing plugin ${plg}${packageName}${db}...`);
         const { spawnCommand } = await import('./utils/spawn.js');
         try {
             await spawnCommand(this.matterbridge, 'npm', ['install', '-g', packageName, '--omit=dev', '--verbose'], 'install', packageName);
@@ -262,14 +387,17 @@ export class PluginManager extends EventEmitter {
                     await this.matterbridge.shutdownProcess();
                 }
             }
+            this.log.debug(`Installed plugin ${plg}${packageName}${db} successfully`);
             return true;
         }
         catch (error) {
             inspectError(this.log, `Failed to install package ${plg}${packageName}${er}`, error);
+            this.log.debug(`Failed to install plugin ${plg}${packageName}${db}`);
             return false;
         }
     }
     async uninstall(packageName) {
+        this.log.debug(`Uninstalling plugin ${plg}${packageName}${db}...`);
         const { spawnCommand } = await import('./utils/spawn.js');
         packageName = packageName.replace(/@.*$/, '');
         if (packageName === 'matterbridge')
@@ -282,10 +410,12 @@ export class PluginManager extends EventEmitter {
                 await this.remove(packageName);
             }
             await spawnCommand(this.matterbridge, 'npm', ['uninstall', '-g', packageName, '--verbose'], 'uninstall', packageName);
+            this.log.debug(`Uninstalled plugin ${plg}${packageName}${db} successfully`);
             return true;
         }
         catch (error) {
             inspectError(this.log, `Failed to uninstall package ${plg}${packageName}${er}`, error);
+            this.log.debug(`Failed to uninstall plugin ${plg}${packageName}${db}`);
             return false;
         }
     }
@@ -346,6 +476,14 @@ export class PluginManager extends EventEmitter {
     }
     async parse(plugin) {
         const { promises } = await import('node:fs');
+        if (typeof plugin === 'string') {
+            const p = this._plugins.get(plugin);
+            if (!p) {
+                this.log.error(`Plugin ${plg}${plugin}${er} not found`);
+                return null;
+            }
+            plugin = p;
+        }
         try {
             this.log.debug(`Parsing package.json of plugin ${plg}${plugin.name}${db}`);
             const packageJson = JSON.parse(await promises.readFile(plugin.path, 'utf8'));
@@ -570,6 +708,14 @@ export class PluginManager extends EventEmitter {
     async load(plugin, start = false, message = '', configure = false) {
         const { promises } = await import('node:fs');
         const { default: path } = await import('node:path');
+        if (typeof plugin === 'string') {
+            const p = this._plugins.get(plugin);
+            if (!p) {
+                this.log.error(`Plugin ${plg}${plugin}${er} not found`);
+                return undefined;
+            }
+            plugin = p;
+        }
         if (!plugin.enabled) {
             this.log.error(`Plugin ${plg}${plugin.name}${er} not enabled`);
             return undefined;
@@ -636,6 +782,14 @@ export class PluginManager extends EventEmitter {
         return undefined;
     }
     async start(plugin, message, configure = false) {
+        if (typeof plugin === 'string') {
+            const p = this._plugins.get(plugin);
+            if (!p) {
+                this.log.error(`Plugin ${plg}${plugin}${er} not found`);
+                return undefined;
+            }
+            plugin = p;
+        }
         if (!plugin.loaded) {
             this.log.error(`Plugin ${plg}${plugin.name}${er} not loaded`);
             return undefined;
@@ -666,6 +820,14 @@ export class PluginManager extends EventEmitter {
         return undefined;
     }
     async configure(plugin) {
+        if (typeof plugin === 'string') {
+            const p = this._plugins.get(plugin);
+            if (!p) {
+                this.log.error(`Plugin ${plg}${plugin}${er} not found`);
+                return undefined;
+            }
+            plugin = p;
+        }
         if (!plugin.loaded) {
             this.log.error(`Plugin ${plg}${plugin.name}${er} not loaded`);
             return undefined;
@@ -697,6 +859,14 @@ export class PluginManager extends EventEmitter {
         return undefined;
     }
     async shutdown(plugin, reason, removeAllDevices = false, force = false) {
+        if (typeof plugin === 'string') {
+            const p = this._plugins.get(plugin);
+            if (!p) {
+                this.log.error(`Plugin ${plg}${plugin}${er} not found`);
+                return undefined;
+            }
+            plugin = p;
+        }
         this.log.debug(`Shutting down plugin ${plg}${plugin.name}${db}`);
         if (!plugin.loaded) {
             this.log.debug(`Plugin ${plg}${plugin.name}${db} not loaded`);

package/frontend/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "frontend",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "frontend",
-      "version": "3.3.0",
+      "version": "3.3.1",
       "dependencies": {
         "@emotion/react": "^11.14.0",
         "@emotion/styled": "^11.14.1",
@@ -33,7 +33,7 @@
         "@typescript-eslint/eslint-plugin": "^8.46.2",
         "@typescript-eslint/parser": "^8.46.2",
         "@vitejs/plugin-react": "^5.1.0",
-        "eslint": "9.38.0",
+        "eslint": "^9.39.1",
         "eslint-config-prettier": "^10.1.8",
         "eslint-plugin-prettier": "^5.5.4",
         "eslint-plugin-react": "^7.37.5",
@@ -1232,7 +1232,7 @@
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
       }
     },
-    "node_modules/@eslint/config-helpers/node_modules/@eslint/core": {
+    "node_modules/@eslint/core": {
       "version": "0.17.0",
       "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.17.0.tgz",
       "integrity": "sha512-yL/sLrpmtDaFEiUj1osRP4TI2MDz1AddJL+jZ7KSqvBuliN4xqYY54IfdN8qD8Toa6g1iloph1fxQNkjOxrrpQ==",
@@ -1245,19 +1245,6 @@
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
       }
     },
-    "node_modules/@eslint/core": {
-      "version": "0.16.0",
-      "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.16.0.tgz",
-      "integrity": "sha512-nmC8/totwobIiFcGkDza3GIKfAw1+hLiYVrh3I1nIomQ8PEr5cxg34jnkmGawul/ep52wGRAcyeDCNtWKSOj4Q==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@types/json-schema": "^7.0.15"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      }
-    },
     "node_modules/@eslint/eslintrc": {
       "version": "3.3.1",
       "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.1.tgz",
@@ -1341,9 +1328,9 @@
       }
     },
     "node_modules/@eslint/js": {
-      "version": "9.38.0",
-      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.38.0.tgz",
-      "integrity": "sha512-UZ1VpFvXf9J06YG9xQBdnzU+kthors6KjhMAl6f4gH4usHyh31rUf2DLGInT8RFYIReYXNSydgPY0V2LuWgl7A==",
+      "version": "9.39.1",
+      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.39.1.tgz",
+      "integrity": "sha512-S26Stp4zCy88tH94QbBv3XCuzRQiZ9yXofEILmglYTh/Ug/a9/umqvgFtYBAo3Lp0nsI/5/qH1CCrbdK3AP1Tw==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -1377,19 +1364,6 @@
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
       }
     },
-    "node_modules/@eslint/plugin-kit/node_modules/@eslint/core": {
-      "version": "0.17.0",
-      "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.17.0.tgz",
-      "integrity": "sha512-yL/sLrpmtDaFEiUj1osRP4TI2MDz1AddJL+jZ7KSqvBuliN4xqYY54IfdN8qD8Toa6g1iloph1fxQNkjOxrrpQ==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@types/json-schema": "^7.0.15"
-      },
-      "engines": {
-        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
-      }
-    },
     "node_modules/@humanfs/core": {
       "version": "0.19.1",
       "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.1.tgz",
@@ -3878,9 +3852,9 @@
       }
     },
     "node_modules/eslint": {
-      "version": "9.38.0",
-      "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.38.0.tgz",
-      "integrity": "sha512-t5aPOpmtJcZcz5UJyY2GbvpDlsK5E8JqRqoKtfiKE3cNh437KIqfJr3A3AKf5k64NPx6d0G3dno6XDY05PqPtw==",
+      "version": "9.39.1",
+      "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.39.1.tgz",
+      "integrity": "sha512-BhHmn2yNOFA9H9JmmIVKJmd288g9hrVRDkdoIgRCRuSySRUHH7r/DI6aAXW9T1WwUuY3DFgrcaqB+deURBLR5g==",
       "dev": true,
       "license": "MIT",
       "peer": true,
@@ -3888,11 +3862,11 @@
         "@eslint-community/eslint-utils": "^4.8.0",
         "@eslint-community/regexpp": "^4.12.1",
         "@eslint/config-array": "^0.21.1",
-        "@eslint/config-helpers": "^0.4.1",
-        "@eslint/core": "^0.16.0",
+        "@eslint/config-helpers": "^0.4.2",
+        "@eslint/core": "^0.17.0",
         "@eslint/eslintrc": "^3.3.1",
-        "@eslint/js": "9.38.0",
-        "@eslint/plugin-kit": "^0.4.0",
+        "@eslint/js": "9.39.1",
+        "@eslint/plugin-kit": "^0.4.1",
         "@humanfs/node": "^0.16.6",
         "@humanwhocodes/module-importer": "^1.0.1",
         "@humanwhocodes/retry": "^0.4.2",
@@ -7766,21 +7740,6 @@
       "dev": true,
       "license": "ISC"
     },
-    "node_modules/yaml": {
-      "version": "2.8.1",
-      "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.8.1.tgz",
-      "integrity": "sha512-lcYcMxX2PO9XMGvAJkJ3OsNMw+/7FKes7/hgerGUYWIoWu5j/+YQqcZr5JnPZWzOsEBgMbSbiSTn/dv/69Mkpw==",
-      "dev": true,
-      "license": "ISC",
-      "optional": true,
-      "peer": true,
-      "bin": {
-        "yaml": "bin.mjs"
-      },
-      "engines": {
-        "node": ">= 14.6"
-      }
-    },
     "node_modules/yocto-queue": {
       "version": "0.1.0",
       "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz",

package/frontend/package.json

@@ -66,7 +66,7 @@
     "@typescript-eslint/eslint-plugin": "^8.46.2",
     "@typescript-eslint/parser": "^8.46.2",
     "@vitejs/plugin-react": "^5.1.0",
-    "eslint": "9.38.0",
+    "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
     "eslint-plugin-react": "^7.37.5",

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge",
-  "version": "3.3.7-dev-20251105-440e549",
+  "version": "3.3.7-dev-20251108-f254812",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge",
-      "version": "3.3.7-dev-20251105-440e549",
+      "version": "3.3.7-dev-20251108-f254812",
       "license": "Apache-2.0",
       "dependencies": {
         "@matter/main": "0.15.6",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge",
-  "version": "3.3.7-dev-20251105-440e549",
+  "version": "3.3.7-dev-20251108-f254812",
   "description": "Matterbridge plugin manager for Matter",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",