matterbridge 3.1.4-dev-20250717-d36e252 → 3.1.5-dev-20250718-054cd80

package/CHANGELOG.md

@@ -8,6 +8,26 @@ If you like this project and find it useful, please consider giving it a star on
   <img src="bmc-button.svg" alt="Buy me a coffee" width="120">
 </a>
 
+## [3.1.5] - 2025-07-??
+
+### Added
+
+- [error]: Added error logging functions and corresponding tests.
+- [frontend]: Improved test units on Matterbridge class (total coverage 99%).
+
+### Changed
+
+- [matterbridge]: Refactored initialization of DeviceManager and PluginManager
+- [pluginManager]: Refactored PluginManager removing unused install/uninstall methods
+- [pluginManager]: Added loading of default plugin config when a plugin is added the first time. It must be a file in the package root named '[PLUGIN-NAME].config.json'.
+- [readme-dev]: Added [documentation](README-DEV.md) for default plugin config and schema files.
+
+### Fixed
+
+<a href="https://www.buymeacoffee.com/luligugithub">
+  <img src="bmc-button.svg" alt="Buy me a coffee" width="80">
+</a>
+
 ## [3.1.4] - 2025-07-16
 
 ### Added

package/README-DEV.md

@@ -298,6 +298,65 @@ The mode=`server` property of MatterbridgeEndpointOptions, allows to create an i
 
 The mode=`matter` property of MatterbridgeEndpointOptions, allows to create a (not bridged) Matter device that is added to the Matterbridge server node alongside the aggregator.
 
+## Plugin config file
+
+Each plugin has a minimal default config file injected by Matterbridge when it is loaded:
+
+```typescript
+{
+  name: plugin.name, // i.e. matterbridge-test
+  type: plugin.type, // i.e. AccessoryPlatform or DynamicPlatform (on the first run is AnyPlatform cause it is still unknown)
+  debug: false,
+  unregisterOnShutdown: false
+}
+```
+
+It is possible to add a different default config file to be loaded the first time the user installs the plugin.
+
+Matterbridge (only on the first load of the plugin and if a config file is not already present in the .matterbridge directory) looks for the default config file in the root of the plugin package. The file must be named '[PLUGIN-NAME].config.json' (i.e. 'matterbridge-test.config.json').
+
+In all subsequent loads the config file is loaded from the '.matterbridge' directory.
+
+## Plugin schema file
+
+Each plugin has a minimal default schema file injected by Matterbridge when it is loaded:
+
+```typescript
+{
+  title: plugin.description,
+  description: plugin.name + ' v. ' + plugin.version + ' by ' + plugin.author,
+  type: 'object',
+  properties: {
+    name: {
+      description: 'Plugin name',
+      type: 'string',
+      readOnly: true,
+    },
+    type: {
+      description: 'Plugin type',
+      type: 'string',
+      readOnly: true,
+    },
+    debug: {
+      description: 'Enable the debug for the plugin (development only)',
+      type: 'boolean',
+      default: false,
+    },
+    unregisterOnShutdown: {
+      description: 'Unregister all devices on shutdown (development only)',
+      type: 'boolean',
+      default: false,
+    },
+  },
+}
+```
+
+It is possible to add a different default schema file.
+
+The schema file is loaded from the root of the plugin package. The file must be named '[PLUGIN-NAME].schema.json' (i.e. 'matterbridge-test.schema.json').
+
+The properties of the schema file shall correspond to the properties of the config file.
+
 # Contribution Guidelines
 
 Thank you for your interest in contributing to my project!

package/dist/matterbridge.js

@@ -10,7 +10,7 @@ import { DeviceCommissioner, FabricAction, MdnsService, PaseClient } from '@matt
 import { AggregatorEndpoint } from '@matter/main/endpoints';
 import { BasicInformationServer } from '@matter/main/behaviors/basic-information';
 import { BridgedDeviceBasicInformationServer } from '@matter/main/behaviors/bridged-device-basic-information';
-import { getParameter, getIntParameter, hasParameter, copyDirectory, withTimeout, waiter, isValidString, parseVersionString, isValidNumber, createDirectory } from './utils/export.js';
+import { getParameter, getIntParameter, hasParameter, copyDirectory, withTimeout, waiter, isValidString, parseVersionString, isValidNumber, createDirectory, wait } from './utils/export.js';
 import { dev, plg, typ } from './matterbridgeTypes.js';
 import { PluginManager } from './pluginManager.js';
 import { DeviceManager } from './deviceManager.js';
@@ -97,8 +97,8 @@ export class Matterbridge extends EventEmitter {
     log = new AnsiLogger({ logName: 'Matterbridge', logTimestampFormat: 4, logLevel: hasParameter('debug') ? "debug" : "info" });
     matterbridgeLoggerFile = 'matterbridge' + (getParameter('profile') ? '.' + getParameter('profile') : '') + '.log';
     matterLoggerFile = 'matter' + (getParameter('profile') ? '.' + getParameter('profile') : '') + '.log';
-    plugins;
-    devices;
+    plugins = new PluginManager(this);
+    devices = new DeviceManager(this);
     frontend = new Frontend(this);
     nodeStorageName = 'storage' + (getParameter('profile') ? '.' + getParameter('profile') : '');
     nodeStorage;
@@ -492,10 +492,8 @@ export class Matterbridge extends EventEmitter {
             this.matterbridgeInformation.virtualMode = (await this.nodeContext.get('virtualmode', 'outlet'));
         }
         this.log.debug(`Virtual mode ${this.matterbridgeInformation.virtualMode}.`);
-        this.plugins = new PluginManager(this);
-        await this.plugins.loadFromStorage();
         this.plugins.logLevel = this.log.logLevel;
-        this.devices = new DeviceManager(this);
+        await this.plugins.loadFromStorage();
         this.devices.logLevel = this.log.logLevel;
         for (const plugin of this.plugins) {
             const packageJson = await this.plugins.parse(plugin);
@@ -565,7 +563,8 @@ 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
       - novirtual:             disable the creation of the virtual devices Restart, Update and Reboot Matterbridge
-      - ssl:                   enable SSL for the frontend and WebSockerServer (certificates in .matterbridge/certs directory cert.pem, key.pem and ca.pem (optional))
+      - ssl:                   enable SSL for the frontend and the WebSocketServer (the server will use the certificates and switch to https)
+      - mtls:                  enable mTLS for the frontend and the WebSocketServer (both server and client will use and require the certificates and switch to https)
       - vendorId:              override the default vendorId 0xfff1
       - vendorName:            override the default vendorName "Matterbridge"
       - productId:             override the default productId 0x8000
@@ -984,15 +983,15 @@ export class Matterbridge extends EventEmitter {
         this.frontend.wssSendRestartRequired();
         await this.cleanup('updating...', false);
     }
-    async unregisterAndShutdownProcess() {
+    async unregisterAndShutdownProcess(timeout = 1000) {
         this.log.info('Unregistering all devices and shutting down...');
         for (const plugin of this.plugins) {
             await this.removeAllBridgedEndpoints(plugin.name, 250);
         }
         this.log.debug('Waiting for the MessageExchange to finish...');
-        await new Promise((resolve) => setTimeout(resolve, 1000));
+        await new Promise((resolve) => setTimeout(resolve, timeout));
         this.log.debug('Cleaning up and shutting down...');
-        await this.cleanup('unregistered all devices and shutting down...', false);
+        await this.cleanup('unregistered all devices and shutting down...', false, timeout);
     }
     async shutdownProcessAndReset() {
         await this.cleanup('shutting down with reset...', false);
@@ -1166,7 +1165,7 @@ export class Matterbridge extends EventEmitter {
             this.log.debug(`Added ${plg}${plugin.name}${db}:${dev}${device.deviceName}${db} to server node`);
         }
     }
-    async createAccessoryPlugin(plugin, device, start = false) {
+    async createAccessoryPlugin(plugin, device) {
         if (!plugin.locked && device.deviceType && device.deviceName && device.vendorId && device.productId && device.vendorName && device.productName) {
             plugin.locked = true;
             plugin.device = device;
@@ -1175,8 +1174,6 @@ export class Matterbridge extends EventEmitter {
             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)
-                await this.startServerNode(plugin.serverNode);
         }
     }
     async createDynamicPlugin(plugin) {
@@ -1236,7 +1233,7 @@ export class Matterbridge extends EventEmitter {
                 }
             }
             this.configureTimeout = setTimeout(async () => {
-                for (const plugin of this.plugins) {
+                for (const plugin of this.plugins.array()) {
                     if (!plugin.enabled || !plugin.loaded || !plugin.started || plugin.error)
                         continue;
                     try {
@@ -1262,7 +1259,7 @@ export class Matterbridge extends EventEmitter {
             this.log.notice('Matterbridge bridge started successfully');
         }, 1000);
     }
-    async startChildbridge() {
+    async startChildbridge(delay = 1000) {
         if (!this.matterStorageManager)
             throw new Error('No storage manager initialized');
         await this.startPlugins();
@@ -1270,7 +1267,7 @@ export class Matterbridge extends EventEmitter {
         let failCount = 0;
         this.startMatterInterval = setInterval(async () => {
             let allStarted = true;
-            for (const plugin of this.plugins) {
+            for (const plugin of this.plugins.array()) {
                 if (!plugin.enabled)
                     continue;
                 if (plugin.error) {
@@ -1289,7 +1286,7 @@ export class Matterbridge extends EventEmitter {
                     this.log.debug(`Waiting (failSafeCount=${failCount}/${this.failCountLimit}) for plugin ${plg}${plugin.name}${db} to load (${plugin.loaded}) and start (${plugin.started}) ...`);
                     failCount++;
                     if (failCount > this.failCountLimit) {
-                        this.log.error(`Error waiting for plugin ${plg}${plugin.name}${er} to load and start. Plugin is in error mode.`);
+                        this.log.error(`Error waiting for plugin ${plg}${plugin.name}${er} to load and start. Plugin is in error state.`);
                         plugin.error = true;
                     }
                 }
@@ -1298,10 +1295,11 @@ export class Matterbridge extends EventEmitter {
                 return;
             clearInterval(this.startMatterInterval);
             this.startMatterInterval = undefined;
-            await new Promise((resolve) => setTimeout(resolve, 1000));
+            if (delay > 0)
+                await wait(delay);
             this.log.debug('Cleared startMatterInterval interval in childbridge mode');
             this.configureTimeout = setTimeout(async () => {
-                for (const plugin of this.plugins) {
+                for (const plugin of this.plugins.array()) {
                     if (!plugin.enabled || !plugin.loaded || !plugin.started || plugin.error)
                         continue;
                     try {

package/dist/pluginManager.js

@@ -1,15 +1,14 @@
 import EventEmitter from 'node:events';
 import { AnsiLogger, UNDERLINE, UNDERLINEOFF, BLUE, db, er, nf, nt, rs, wr } from 'node-ansi-logger';
 import { plg, typ } from './matterbridgeTypes.js';
+import { logError } from './utils/error.js';
 export class PluginManager extends EventEmitter {
     _plugins = new Map();
-    nodeContext;
     matterbridge;
     log;
     constructor(matterbridge) {
         super();
         this.matterbridge = matterbridge;
-        this.nodeContext = matterbridge.nodeContext;
         this.log = new AnsiLogger({ logName: 'PluginManager', logTimestampFormat: 4, logLevel: matterbridge.log.logLevel });
         this.log.debug('Matterbridge plugin manager starting...');
     }
@@ -46,7 +45,7 @@ export class PluginManager extends EventEmitter {
                 await callback(plugin);
             }
             catch (err) {
-                this.log.error(`Error processing forEach plugin ${plg}${plugin.name}${er}: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
+                logError(this.log, `Error processing forEach plugin ${plg}${plugin.name}${er}`, err);
             }
         });
         await Promise.all(tasks);
@@ -55,12 +54,18 @@ export class PluginManager extends EventEmitter {
         this.log.logLevel = logLevel;
     }
     async loadFromStorage() {
-        const pluginsArray = await this.nodeContext.get('plugins', []);
+        if (!this.matterbridge.nodeContext) {
+            throw new Error('loadFromStorage: node context is not available.');
+        }
+        const pluginsArray = await this.matterbridge.nodeContext.get('plugins', []);
         for (const plugin of pluginsArray)
             this._plugins.set(plugin.name, plugin);
         return pluginsArray;
     }
     async saveToStorage() {
+        if (!this.matterbridge.nodeContext) {
+            throw new Error('loadFromStorage: node context is not available.');
+        }
         const plugins = [];
         const pluginArrayFromMap = Array.from(this._plugins.values());
         for (const plugin of pluginArrayFromMap) {
@@ -74,7 +79,7 @@ export class PluginManager extends EventEmitter {
                 enabled: plugin.enabled,
             });
         }
-        await this.nodeContext.set('plugins', plugins);
+        await this.matterbridge.nodeContext.set('plugins', plugins);
         this.log.debug(`Saved ${BLUE}${plugins.length}${db} plugins to storage`);
         return plugins.length;
     }
@@ -153,7 +158,7 @@ export class PluginManager extends EventEmitter {
             return packageJsonPath;
         }
         catch (err) {
-            this.log.error(`Failed to resolve plugin path ${plg}${pluginPath}${er}: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
+            logError(this.log, `Failed to resolve plugin path ${plg}${pluginPath}${er}`, err);
             return null;
         }
     }
@@ -286,7 +291,7 @@ export class PluginManager extends EventEmitter {
             return packageJson;
         }
         catch (err) {
-            this.log.error(`Failed to parse package.json of plugin ${plg}${plugin.name}${er}: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
+            logError(this.log, `Failed to parse package.json of plugin ${plg}${plugin.name}${er}`, err);
             plugin.error = true;
             return null;
         }
@@ -322,7 +327,7 @@ export class PluginManager extends EventEmitter {
             return plugin;
         }
         catch (err) {
-            this.log.error(`Failed to parse package.json of plugin ${plg}${nameOrPath}${er}: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
+            logError(this.log, `Failed to parse package.json of plugin ${plg}${nameOrPath}${er}`, err);
             return null;
         }
     }
@@ -357,7 +362,7 @@ export class PluginManager extends EventEmitter {
             return plugin;
         }
         catch (err) {
-            this.log.error(`Failed to parse package.json of plugin ${plg}${nameOrPath}${er}: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
+            logError(this.log, `Failed to parse package.json of plugin ${plg}${nameOrPath}${er}`, err);
             return null;
         }
     }
@@ -392,7 +397,7 @@ export class PluginManager extends EventEmitter {
             return plugin;
         }
         catch (err) {
-            this.log.error(`Failed to parse package.json of plugin ${plg}${nameOrPath}${er}: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
+            logError(this.log, `Failed to parse package.json of plugin ${plg}${nameOrPath}${er}`, err);
             return null;
         }
     }
@@ -427,64 +432,10 @@ export class PluginManager extends EventEmitter {
             return plugin || null;
         }
         catch (err) {
-            this.log.error(`Failed to parse package.json of plugin ${plg}${nameOrPath}${er}: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
+            logError(this.log, `Failed to parse package.json of plugin ${plg}${nameOrPath}${er}`, err);
             return null;
         }
     }
-    async install(name) {
-        const { exec } = await import('node:child_process');
-        await this.uninstall(name);
-        this.log.info(`Installing plugin ${plg}${name}${nf}`);
-        return new Promise((resolve) => {
-            exec(`npm install -g ${name} --omit=dev`, (error, stdout, stderr) => {
-                if (error) {
-                    this.log.error(`Failed to install plugin ${plg}${name}${er}: ${error}`);
-                    this.log.debug(`Failed to install plugin ${plg}${name}${db}: ${stderr}`);
-                    resolve(undefined);
-                }
-                else {
-                    this.log.info(`Installed plugin ${plg}${name}${nf}`);
-                    this.log.debug(`Installed plugin ${plg}${name}${db}: ${stdout}`);
-                    exec(`npm list -g ${name} --depth=0`, (listError, listStdout, listStderr) => {
-                        if (listError) {
-                            this.log.error(`List error: ${listError}`);
-                            resolve(undefined);
-                        }
-                        const lines = listStdout.split('\n');
-                        const versionLine = lines.find((line) => line.includes(`${name}@`));
-                        if (versionLine) {
-                            const version = versionLine.split('@')[1].trim();
-                            this.log.info(`Installed plugin ${plg}${name}@${version}${nf}`);
-                            this.emit('installed', name, version);
-                            resolve(version);
-                        }
-                        else {
-                            resolve(undefined);
-                        }
-                    });
-                }
-            });
-        });
-    }
-    async uninstall(name) {
-        const { exec } = await import('node:child_process');
-        this.log.info(`Uninstalling plugin ${plg}${name}${nf}`);
-        return new Promise((resolve) => {
-            exec(`npm uninstall -g ${name}`, (error, stdout, stderr) => {
-                if (error) {
-                    this.log.error(`Failed to uninstall plugin ${plg}${name}${er}: ${error}`);
-                    this.log.debug(`Failed to uninstall plugin ${plg}${name}${db}: ${stderr}`);
-                    resolve(undefined);
-                }
-                else {
-                    this.log.info(`Uninstalled plugin ${plg}${name}${nf}`);
-                    this.log.debug(`Uninstalled plugin ${plg}${name}${db}: ${stdout}`);
-                    this.emit('uninstalled', name);
-                    resolve(name);
-                }
-            });
-        });
-    }
     async load(plugin, start = false, message = '', configure = false) {
         const { promises } = await import('node:fs');
         const { default: path } = await import('node:path');
@@ -515,7 +466,7 @@ export class PluginManager extends EventEmitter {
                 plugin.schemaJson = await this.loadSchema(plugin);
                 config.name = plugin.name;
                 config.version = packageJson.version;
-                const log = new AnsiLogger({ logName: plugin.description ?? 'No description', logTimestampFormat: 4, logLevel: config.debug ? "debug" : this.matterbridge.log.logLevel });
+                const log = new AnsiLogger({ logName: plugin.description, logTimestampFormat: 4, logLevel: config.debug ? "debug" : this.matterbridge.log.logLevel });
                 const platform = pluginInstance.default(this.matterbridge, log, config);
                 config.type = platform.type;
                 platform.name = packageJson.name;
@@ -549,7 +500,7 @@ export class PluginManager extends EventEmitter {
             }
         }
         catch (err) {
-            this.log.error(`Failed to load plugin ${plg}${plugin.name}${er}: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
+            logError(this.log, `Failed to load plugin ${plg}${plugin.name}${er}`, err);
             plugin.error = true;
         }
         return undefined;
@@ -580,7 +531,7 @@ export class PluginManager extends EventEmitter {
         }
         catch (err) {
             plugin.error = true;
-            this.log.error(`Failed to start plugin ${plg}${plugin.name}${er}: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
+            logError(this.log, `Failed to start plugin ${plg}${plugin.name}${er}`, err);
         }
         return undefined;
     }
@@ -611,7 +562,7 @@ export class PluginManager extends EventEmitter {
         }
         catch (err) {
             plugin.error = true;
-            this.log.error(`Failed to configure plugin ${plg}${plugin.name}${er}: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
+            logError(this.log, `Failed to configure plugin ${plg}${plugin.name}${er}`, err);
         }
         return undefined;
     }
@@ -654,7 +605,7 @@ export class PluginManager extends EventEmitter {
             return plugin;
         }
         catch (err) {
-            this.log.error(`Failed to shut down plugin ${plg}${plugin.name}${er}: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
+            logError(this.log, `Failed to shut down plugin ${plg}${plugin.name}${er}`, err);
         }
         return undefined;
     }
@@ -663,6 +614,7 @@ export class PluginManager extends EventEmitter {
         const { promises } = await import('node:fs');
         const { shelly_config, somfytahoma_config, zigbee2mqtt_config } = await import('./defaultConfigSchema.js');
         const configFile = path.join(this.matterbridge.matterbridgeDirectory, `${plugin.name}.config.json`);
+        const defaultConfigFile = plugin.path.replace('package.json', `${plugin.name}.config.json`);
         try {
             await promises.access(configFile);
             const data = await promises.readFile(configFile, 'utf8');
@@ -679,27 +631,37 @@ export class PluginManager extends EventEmitter {
         catch (err) {
             const nodeErr = err;
             if (nodeErr.code === 'ENOENT') {
+                this.log.debug(`Config file ${configFile} for plugin ${plg}${plugin.name}${db} does not exist, creating new config file...`);
                 let config;
-                if (plugin.name === 'matterbridge-zigbee2mqtt')
-                    config = zigbee2mqtt_config;
-                else if (plugin.name === 'matterbridge-somfy-tahoma')
-                    config = somfytahoma_config;
-                else if (plugin.name === 'matterbridge-shelly')
-                    config = shelly_config;
-                else
-                    config = { name: plugin.name, type: plugin.type, debug: false, unregisterOnShutdown: false };
+                try {
+                    await promises.access(defaultConfigFile);
+                    const data = await promises.readFile(defaultConfigFile, 'utf8');
+                    config = JSON.parse(data);
+                    this.log.debug(`Loaded default config file ${defaultConfigFile} for plugin ${plg}${plugin.name}${db}.`);
+                }
+                catch (_err) {
+                    this.log.debug(`Default config file ${defaultConfigFile} for plugin ${plg}${plugin.name}${db} does not exist, creating new config file...`);
+                    if (plugin.name === 'matterbridge-zigbee2mqtt')
+                        config = zigbee2mqtt_config;
+                    else if (plugin.name === 'matterbridge-somfy-tahoma')
+                        config = somfytahoma_config;
+                    else if (plugin.name === 'matterbridge-shelly')
+                        config = shelly_config;
+                    else
+                        config = { name: plugin.name, type: plugin.type, debug: false, unregisterOnShutdown: false };
+                }
                 try {
                     await promises.writeFile(configFile, JSON.stringify(config, null, 2), 'utf8');
                     this.log.debug(`Created config file ${configFile} for plugin ${plg}${plugin.name}${db}.`);
                     return config;
                 }
                 catch (err) {
-                    this.log.error(`Error creating config file ${configFile} for plugin ${plg}${plugin.name}${er}: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
+                    logError(this.log, `Error creating config file ${configFile} for plugin ${plg}${plugin.name}${er}`, err);
                     return config;
                 }
             }
             else {
-                this.log.error(`Error accessing config file ${configFile} for plugin ${plg}${plugin.name}${er}: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
+                logError(this.log, `Error accessing config file ${configFile} for plugin ${plg}${plugin.name}${er}`, err);
                 return { name: plugin.name, type: plugin.type, debug: false, unregisterOnShutdown: false };
             }
         }
@@ -721,7 +683,7 @@ export class PluginManager extends EventEmitter {
             return Promise.resolve();
         }
         catch (err) {
-            this.log.error(`Error saving config file ${configFile} for plugin ${plg}${plugin.name}${er}: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
+            logError(this.log, `Error saving config file ${configFile} for plugin ${plg}${plugin.name}${er}`, err);
             return Promise.reject(err);
         }
     }
@@ -745,7 +707,7 @@ export class PluginManager extends EventEmitter {
             this.log.debug(`Saved config file ${configFile} for plugin ${plg}${plugin.name}${db}`);
         }
         catch (err) {
-            this.log.error(`Error saving config file ${configFile} for plugin ${plg}${plugin.name}${er}: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
+            logError(this.log, `Error saving config file ${configFile} for plugin ${plg}${plugin.name}${er}`, err);
             return;
         }
     }

package/dist/utils/error.js

@@ -0,0 +1,9 @@
+import { inspect } from 'node:util';
+export function logError(log, message, error) {
+    log.error(`${message}: ${error instanceof Error ? error.message + '\nStack:\n' + error.stack : error}`);
+}
+export function inspectError(log, message, error) {
+    const errorMessage = error instanceof Error ? `${error.message}\n` : '';
+    const inspectedError = inspect(error, { depth: 10, colors: true, showHidden: false });
+    log.error(`${message}: ${errorMessage}${inspectedError}`);
+}

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge",
-  "version": "3.1.4-dev-20250717-d36e252",
+  "version": "3.1.5-dev-20250718-054cd80",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge",
-      "version": "3.1.4-dev-20250717-d36e252",
+      "version": "3.1.5-dev-20250718-054cd80",
       "license": "Apache-2.0",
       "dependencies": {
         "@matter/main": "0.15.1",
@@ -151,9 +151,9 @@
       }
     },
     "node_modules/@noble/curves": {
-      "version": "1.9.2",
-      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.9.2.tgz",
-      "integrity": "sha512-HxngEd2XUcg9xi20JkwlLCtYwfoFw4JGkuZpT+WlsPD4gB/cxkvTD8fSsoAnphGZhFdZYKeQIPCuFlWPm1uE0g==",
+      "version": "1.9.3",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.9.3.tgz",
+      "integrity": "sha512-NiHFh8qtZRREtY0Bpup+xpmLnB0bn9UAtj8CARBc2x1zjpVLDC84u+Bvy2+uaSgA3AmMP9zsacMZT1echgVAdQ==",
       "license": "MIT",
       "dependencies": {
         "@noble/hashes": "1.8.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge",
-  "version": "3.1.4-dev-20250717-d36e252",
+  "version": "3.1.5-dev-20250718-054cd80",
   "description": "Matterbridge plugin manager for Matter",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",