matterbridge 3.0.5-dev-20250609-a5046db → 3.0.6-dev-20250610-56cd483

package/CHANGELOG.md

@@ -8,6 +8,24 @@ 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.0.6] - 2025-06-??
+
+### Added
+
+- [tests] Update Jest test coverage on addBridgedEndpoint and removeBridgedEndpoint.
+
+### Changed
+
+- [package]: Updated dependencies.
+
+### Fixed
+
+- [evse]: Fixed jsdoc on Evse.
+
+<a href="https://www.buymeacoffee.com/luligugithub">
+  <img src="bmc-button.svg" alt="Buy me a coffee" width="80">
+</a>
+
 ## [3.0.5] - 2025-06-07
 
 ### Added

package/README.md

@@ -5,7 +5,7 @@
 [![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)
-![Coverage](https://img.shields.io/badge/Jest%20coverage-86%25-brightgreen)
+![Coverage](https://img.shields.io/badge/Jest%20coverage-88%25-brightgreen)
 
 [![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)

package/dist/frontend.js

@@ -13,6 +13,7 @@ import { createZip, isValidArray, isValidNumber, isValidObject, isValidString, i
 import { plg } from './matterbridgeTypes.js';
 import { hasParameter } from './utils/export.js';
 import { capitalizeFirstLetter } from './matterbridgeEndpointHelpers.js';
+import spawn from './utils/spawn.js';
 export const WS_ID_LOG = 0;
 export const WS_ID_REFRESH_NEEDED = 1;
 export const WS_ID_RESTART_NEEDED = 2;
@@ -423,7 +424,7 @@ export class Frontend {
                 await fs.rename(file.path, filePath);
                 this.log.info(`File ${plg}${filename}${nf} uploaded successfully`);
                 if (filename.endsWith('.tgz')) {
-                    await this.matterbridge.spawnCommand('npm', ['install', '-g', filePath, '--omit=dev', '--verbose']);
+                    await spawn.spawnCommand(this.matterbridge, 'npm', ['install', '-g', filePath, '--omit=dev', '--verbose']);
                     this.log.info(`Plugin package ${plg}${filename}${nf} installed successfully. Full restart required.`);
                     this.wssSendCloseSnackbarMessage(`Installing package ${filename}. Please wait...`);
                     this.wssSendSnackbarMessage(`Installed package ${filename}`, 10, 'success');
@@ -884,8 +885,8 @@ export class Frontend {
                     return;
                 }
                 this.wssSendSnackbarMessage(`Installing package ${data.params.packageName}...`, 0);
-                this.matterbridge
-                    .spawnCommand('npm', ['install', '-g', data.params.packageName, '--omit=dev', '--verbose'])
+                spawn
+                    .spawnCommand(this.matterbridge, 'npm', ['install', '-g', data.params.packageName, '--omit=dev', '--verbose'])
                     .then((response) => {
                     client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, response }));
                     this.wssSendCloseSnackbarMessage(`Installing package ${data.params.packageName}...`);
@@ -938,8 +939,8 @@ export class Frontend {
                     this.wssSendRefreshRequired('devices');
                 }
                 this.wssSendSnackbarMessage(`Uninstalling package ${data.params.packageName}...`, 0);
-                this.matterbridge
-                    .spawnCommand('npm', ['uninstall', '-g', data.params.packageName, '--verbose'])
+                spawn
+                    .spawnCommand(this.matterbridge, 'npm', ['uninstall', '-g', data.params.packageName, '--verbose'])
                     .then((response) => {
                     client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, response }));
                     this.wssSendCloseSnackbarMessage(`Uninstalling package ${data.params.packageName}...`);

package/dist/matterbridge.js

@@ -5,7 +5,7 @@ import EventEmitter from 'node:events';
 import { inspect } from 'node:util';
 import { AnsiLogger, UNDERLINE, UNDERLINEOFF, YELLOW, db, debugStringify, BRIGHT, RESET, er, nf, rs, wr, RED, GREEN, zb, CYAN } from './logger/export.js';
 import { NodeStorageManager } from './storage/export.js';
-import { getParameter, getIntParameter, hasParameter, copyDirectory, withTimeout, waiter, isValidString, parseVersionString, isValidNumber } from './utils/export.js';
+import { getParameter, getIntParameter, hasParameter, copyDirectory, withTimeout, waiter, isValidString, parseVersionString, isValidNumber, createDirectory } from './utils/export.js';
 import { logInterfaces, getGlobalNodeModules } from './utils/network.js';
 import { dev, plg, typ } from './matterbridgeTypes.js';
 import { PluginManager } from './pluginManager.js';
@@ -14,6 +14,7 @@ import { MatterbridgeEndpoint } from './matterbridgeEndpoint.js';
 import { bridge } from './matterbridgeDeviceTypes.js';
 import { Frontend } from './frontend.js';
 import { addVirtualDevices } from './helpers.js';
+import spawn from './utils/spawn.js';
 import { DeviceTypeId, Endpoint, Logger, LogLevel as MatterLogLevel, LogFormat as MatterLogFormat, VendorId, StorageService, Environment, ServerNode, UINT32_MAX, UINT16_MAX, } from '@matter/main';
 import { DeviceCommissioner, FabricAction, MdnsService, PaseClient } from '@matter/main/protocol';
 import { AggregatorEndpoint } from '@matter/main/endpoints';
@@ -116,6 +117,7 @@ export class Matterbridge extends EventEmitter {
     checkUpdateTimeout;
     configureTimeout;
     reachabilityTimeout;
+    endAdvertiseTimeout;
     sigintHandler;
     sigtermHandler;
     exceptionHandler;
@@ -221,18 +223,18 @@ export class Matterbridge extends EventEmitter {
             this.restartMode = 'docker';
         this.homeDirectory = getParameter('homedir') ?? os.homedir();
         this.matterbridgeInformation.homeDirectory = this.homeDirectory;
-        await this.createDirectory(this.homeDirectory, 'Matterbridge Home Directory');
+        await createDirectory(this.homeDirectory, 'Matterbridge Home Directory', this.log);
         this.matterbridgeDirectory = path.join(this.homeDirectory, '.matterbridge');
         this.matterbridgeInformation.matterbridgeDirectory = this.matterbridgeDirectory;
-        await this.createDirectory(this.matterbridgeDirectory, 'Matterbridge Directory');
-        await this.createDirectory(path.join(this.matterbridgeDirectory, 'certs'), 'Matterbridge Frontend Certificate Directory');
-        await this.createDirectory(path.join(this.matterbridgeDirectory, 'uploads'), 'Matterbridge Frontend Uploads Directory');
+        await createDirectory(this.matterbridgeDirectory, 'Matterbridge Directory', this.log);
+        await createDirectory(path.join(this.matterbridgeDirectory, 'certs'), 'Matterbridge Frontend Certificate Directory', this.log);
+        await createDirectory(path.join(this.matterbridgeDirectory, 'uploads'), 'Matterbridge Frontend Uploads Directory', this.log);
         this.matterbridgePluginDirectory = path.join(this.homeDirectory, 'Matterbridge');
         this.matterbridgeInformation.matterbridgePluginDirectory = this.matterbridgePluginDirectory;
-        await this.createDirectory(this.matterbridgePluginDirectory, 'Matterbridge Plugin Directory');
+        await createDirectory(this.matterbridgePluginDirectory, 'Matterbridge Plugin Directory', this.log);
         this.matterbridgeCertDirectory = path.join(this.homeDirectory, '.mattercert');
         this.matterbridgeInformation.matterbridgeCertDirectory = this.matterbridgeCertDirectory;
-        await this.createDirectory(this.matterbridgeCertDirectory, 'Matterbridge Matter Certificate Directory');
+        await createDirectory(this.matterbridgeCertDirectory, 'Matterbridge Matter Certificate Directory', this.log);
         const { fileURLToPath } = await import('node:url');
         const currentFileDirectory = path.dirname(fileURLToPath(import.meta.url));
         this.rootDirectory = path.resolve(currentFileDirectory, '../');
@@ -502,7 +504,7 @@ export class Matterbridge extends EventEmitter {
             if (packageJson === null && !hasParameter('add') && !hasParameter('remove') && !hasParameter('enable') && !hasParameter('disable') && !hasParameter('reset') && !hasParameter('factoryreset')) {
                 this.log.info(`Error parsing plugin ${plg}${plugin.name}${nf}. Trying to reinstall it from npm.`);
                 try {
-                    await this.spawnCommand('npm', ['install', '-g', plugin.name, '--omit=dev', '--verbose']);
+                    await spawn.spawnCommand(this, 'npm', ['install', '-g', plugin.name, '--omit=dev', '--verbose']);
                     this.log.info(`Plugin ${plg}${plugin.name}${nf} reinstalled.`);
                     plugin.error = false;
                 }
@@ -989,7 +991,7 @@ export class Matterbridge extends EventEmitter {
     async updateProcess() {
         this.log.info('Updating matterbridge...');
         try {
-            await this.spawnCommand('npm', ['install', '-g', 'matterbridge', '--omit=dev', '--verbose']);
+            await spawn.spawnCommand(this, 'npm', ['install', '-g', 'matterbridge', '--omit=dev', '--verbose']);
             this.log.info('Matterbridge has been updated. Full restart required.');
         }
         catch (error) {
@@ -1338,19 +1340,6 @@ export class Matterbridge extends EventEmitter {
         }, 1000);
     }
     async startController() {
-        if (!this.matterStorageManager) {
-            this.log.error('No storage manager initialized');
-            await this.cleanup('No storage manager initialized');
-            return;
-        }
-        this.log.info('Creating context: mattercontrollerContext');
-        this.controllerContext = this.matterStorageManager.createContext('mattercontrollerContext');
-        if (!this.controllerContext) {
-            this.log.error('No storage context mattercontrollerContext initialized');
-            await this.cleanup('No storage context mattercontrollerContext initialized');
-            return;
-        }
-        this.log.debug('Starting matterbridge in mode', this.bridgeMode);
     }
     async startMatterStorage() {
         this.log.info(`Starting matter node storage...`);
@@ -1365,8 +1354,13 @@ export class Matterbridge extends EventEmitter {
     }
     async backupMatterStorage(storageName, backupName) {
         this.log.info('Creating matter node storage backup...');
-        await copyDirectory(storageName, backupName);
-        this.log.info('Created matter node storage backup');
+        try {
+            await copyDirectory(storageName, backupName);
+            this.log.info('Created matter node storage backup');
+        }
+        catch (error) {
+            this.log.error(`Error creating matter node storage backup from ${storageName} to ${backupName}:`, error);
+        }
     }
     async stopMatterStorage() {
         this.log.info('Closing matter node storage...');
@@ -1471,7 +1465,10 @@ export class Matterbridge extends EventEmitter {
                 }
             }
         };
-        serverNode.lifecycle.commissioned.on(() => this.log.notice(`Server node for ${storeId} was initially commissioned successfully!`));
+        serverNode.lifecycle.commissioned.on(() => {
+            this.log.notice(`Server node for ${storeId} was initially commissioned successfully!`);
+            clearTimeout(this.endAdvertiseTimeout);
+        });
         serverNode.lifecycle.decommissioned.on(() => this.log.notice(`Server node for ${storeId} was fully decommissioned successfully!`));
         serverNode.lifecycle.online.on(async () => {
             this.log.notice(`Server node for ${storeId} is online`);
@@ -1511,27 +1508,7 @@ export class Matterbridge extends EventEmitter {
                         }
                     }
                 }
-                setTimeout(() => {
-                    if (serverNode.lifecycle.isCommissioned)
-                        return;
-                    if (this.bridgeMode === 'bridge') {
-                        this.matterbridgeQrPairingCode = undefined;
-                        this.matterbridgeManualPairingCode = undefined;
-                    }
-                    if (this.bridgeMode === 'childbridge') {
-                        const plugin = this.plugins.get(storeId);
-                        if (plugin) {
-                            plugin.qrPairingCode = undefined;
-                            plugin.manualPairingCode = undefined;
-                        }
-                    }
-                    this.frontend.wssSendRefreshRequired('plugins');
-                    this.frontend.wssSendRefreshRequired('settings');
-                    this.frontend.wssSendRefreshRequired('fabrics');
-                    this.frontend.wssSendRefreshRequired('sessions');
-                    this.frontend.wssSendSnackbarMessage(`Advertising on server node for ${storeId} stopped. Restart to commission.`, 0);
-                    this.log.notice(`Advertising on server node for ${storeId} stopped. Restart to commission.`);
-                }, 15 * 60 * 1000).unref();
+                this.startEndAdvertiseTimer(serverNode);
             }
             else {
                 this.log.notice(`Server node for ${storeId} is already commissioned. Waiting for controllers to connect ...`);
@@ -1540,6 +1517,7 @@ export class Matterbridge extends EventEmitter {
             this.frontend.wssSendRefreshRequired('plugins');
             this.frontend.wssSendRefreshRequired('settings');
             this.frontend.wssSendSnackbarMessage(`${storeId} is online`, 5, 'success');
+            this.emit('online', storeId);
         });
         serverNode.lifecycle.offline.on(() => {
             this.log.notice(`Server node for ${storeId} is offline`);
@@ -1563,6 +1541,7 @@ export class Matterbridge extends EventEmitter {
             this.frontend.wssSendRefreshRequired('plugins');
             this.frontend.wssSendRefreshRequired('settings');
             this.frontend.wssSendSnackbarMessage(`${storeId} is offline`, 5, 'warning');
+            this.emit('offline', storeId);
         });
         serverNode.events.commissioning.fabricsChanged.on((fabricIndex, fabricAction) => {
             let action = '';
@@ -1615,18 +1594,46 @@ export class Matterbridge extends EventEmitter {
         this.log.info(`Created server node for ${storeId}`);
         return serverNode;
     }
+    startEndAdvertiseTimer(matterServerNode) {
+        if (this.endAdvertiseTimeout) {
+            this.log.debug(`***Clear ${matterServerNode.id} server node end advertise timer`);
+            clearTimeout(this.endAdvertiseTimeout);
+        }
+        this.log.debug(`***Starting ${matterServerNode.id} server node end advertise timer`);
+        this.endAdvertiseTimeout = setTimeout(() => {
+            if (matterServerNode.lifecycle.isCommissioned)
+                return;
+            if (this.bridgeMode === 'bridge') {
+                this.matterbridgeQrPairingCode = undefined;
+                this.matterbridgeManualPairingCode = undefined;
+            }
+            if (this.bridgeMode === 'childbridge') {
+                const plugin = this.plugins.get(matterServerNode.id);
+                if (plugin) {
+                    plugin.qrPairingCode = undefined;
+                    plugin.manualPairingCode = undefined;
+                }
+            }
+            this.frontend.wssSendRefreshRequired('plugins');
+            this.frontend.wssSendRefreshRequired('settings');
+            this.frontend.wssSendRefreshRequired('fabrics');
+            this.frontend.wssSendRefreshRequired('sessions');
+            this.frontend.wssSendSnackbarMessage(`Advertising on server node for ${matterServerNode.id} stopped. Restart to commission.`, 0);
+            this.log.notice(`Advertising on server node for ${matterServerNode.id} stopped. Restart to commission.`);
+        }, 15 * 60 * 1000).unref();
+    }
     async startServerNode(matterServerNode) {
         if (!matterServerNode)
             return;
         this.log.notice(`Starting ${matterServerNode.id} server node`);
         await matterServerNode.start();
     }
-    async stopServerNode(matterServerNode) {
+    async stopServerNode(matterServerNode, timeout = 30000) {
         if (!matterServerNode)
             return;
         this.log.notice(`Closing ${matterServerNode.id} server node`);
         try {
-            await withTimeout(matterServerNode.close(), 30000);
+            await withTimeout(matterServerNode.close(), timeout);
             this.log.info(`Closed ${matterServerNode.id} server node`);
         }
         catch (error) {
@@ -1864,89 +1871,4 @@ export class Matterbridge extends EventEmitter {
         }
         return vendorName;
     };
-    async spawnCommand(command, args = []) {
-        const { spawn } = await import('node:child_process');
-        const cmdLine = command + ' ' + args.join(' ');
-        if (process.platform === 'win32' && command === 'npm') {
-            const argstring = 'npm ' + args.join(' ');
-            args.splice(0, args.length, '/c', argstring);
-            command = 'cmd.exe';
-        }
-        if (hasParameter('sudo') || (process.platform === 'linux' && command === 'npm' && !hasParameter('docker') && !hasParameter('nosudo'))) {
-            args.unshift(command);
-            command = 'sudo';
-        }
-        this.log.debug(`Spawn command ${command} with ${debugStringify(args)}`);
-        return new Promise((resolve, reject) => {
-            const childProcess = spawn(command, args, {
-                stdio: ['inherit', 'pipe', 'pipe'],
-            });
-            childProcess.on('error', (err) => {
-                this.log.error(`Failed to start child process "${cmdLine}": ${err.message}`);
-                reject(err);
-            });
-            childProcess.on('close', (code, signal) => {
-                this.frontend.wssSendMessage('spawn', this.log.now(), 'Matterbridge:spawn', `child process closed with code ${code} and signal ${signal}`);
-                if (code === 0) {
-                    if (cmdLine.startsWith('npm install -g'))
-                        this.log.notice(`Package ${cmdLine.replace('npm install -g ', '').replace('--verbose', '').replace('--omit=dev', '')} installed correctly`);
-                    this.log.debug(`Child process "${cmdLine}" closed with code ${code} and signal ${signal}`);
-                    resolve(true);
-                }
-                else {
-                    this.log.error(`Child process "${cmdLine}" closed with code ${code} and signal ${signal}`);
-                    reject(new Error(`Child process "${cmdLine}" closed with code ${code} and signal ${signal}`));
-                }
-            });
-            childProcess.on('exit', (code, signal) => {
-                this.frontend.wssSendMessage('spawn', this.log.now(), 'Matterbridge:spawn', `child process exited with code ${code} and signal ${signal}`);
-                if (code === 0) {
-                    this.log.debug(`Child process "${cmdLine}" exited with code ${code} and signal ${signal}`);
-                    resolve(true);
-                }
-                else {
-                    this.log.error(`Child process "${cmdLine}" exited with code ${code} and signal ${signal}`);
-                    reject(new Error(`Child process "${cmdLine}" exited with code ${code} and signal ${signal}`));
-                }
-            });
-            childProcess.on('disconnect', () => {
-                this.log.debug(`Child process "${cmdLine}" has been disconnected from the parent`);
-                resolve(true);
-            });
-            if (childProcess.stdout) {
-                childProcess.stdout.on('data', (data) => {
-                    const message = data.toString().trim();
-                    this.log.debug(`Spawn output (stdout): ${message}`);
-                    this.frontend.wssSendMessage('spawn', this.log.now(), 'Matterbridge:spawn', message);
-                });
-            }
-            if (childProcess.stderr) {
-                childProcess.stderr.on('data', (data) => {
-                    const message = data.toString().trim();
-                    this.log.debug(`Spawn verbose (stderr): ${message}`);
-                    this.frontend.wssSendMessage('spawn', this.log.now(), 'Matterbridge:spawn', message);
-                });
-            }
-        });
-    }
-    async createDirectory(path, name) {
-        try {
-            await fs.access(path);
-            this.log.debug(`Directory ${name} already exists at path: ${path}`);
-        }
-        catch (err) {
-            if (err.code === 'ENOENT') {
-                try {
-                    await fs.mkdir(path, { recursive: true });
-                    this.log.info(`Created ${name}: ${path}`);
-                }
-                catch (err) {
-                    this.log.error(`Error creating dir ${name} path ${path}: ${err}`);
-                }
-            }
-            else {
-                this.log.error(`Error accessing dir ${name} path ${path}: ${err}`);
-            }
-        }
-    }
 }

package/dist/pluginManager.js

@@ -750,14 +750,8 @@ export class PluginManager {
             this.log.debug(`Loaded schema file ${schemaFile} for plugin ${plg}${plugin.name}${db}.`);
             return schema;
         }
-        catch (err) {
-            const nodeErr = err;
-            if (nodeErr.code === 'ENOENT') {
-                this.log.debug(`Schema file ${schemaFile} for plugin ${plg}${plugin.name}${db} not found. Loading default schema.`);
-            }
-            else {
-                this.log.debug(`Schema file ${schemaFile} for plugin ${plg}${plugin.name}${db} not found. Loading default schema. Error: ${err instanceof Error ? err.message + '\n' + err.stack : err}`);
-            }
+        catch (_err) {
+            this.log.debug(`Schema file ${schemaFile} for plugin ${plg}${plugin.name}${db} not found. Loading default schema.`);
             return this.getDefaultSchema(plugin);
         }
     }

package/dist/shelly.js

@@ -70,7 +70,7 @@ export async function triggerShellyMainUpdate(matterbridge) {
         matterbridge.log.error(`Error triggering Shelly main update: ${err instanceof Error ? err.message : String(err)}`);
     }
 }
-async function verifyShellyUpdate(matterbridge, api, name) {
+export async function verifyShellyUpdate(matterbridge, api, name) {
     return new Promise((resolve) => {
         const timeout = setTimeout(() => {
             matterbridge.log.error(`${name} check timed out`);

package/dist/utils/copyDirectory.js

@@ -1,5 +1,20 @@
 import { AnsiLogger } from '../logger/export.js';
 export async function copyDirectory(srcDir, destDir) {
+    if (srcDir === '') {
+        throw new Error('Source directory must be specified.');
+    }
+    if (destDir === '') {
+        throw new Error('Destination directory must be specified.');
+    }
+    if (!srcDir) {
+        throw new Error('Source directory must be specified.');
+    }
+    if (!destDir) {
+        throw new Error('Destination directory must be specified.');
+    }
+    if (srcDir === destDir) {
+        throw new Error('Source and destination directories must be different.');
+    }
     const log = new AnsiLogger({ logName: 'Archive', logTimestampFormat: 4, logLevel: "info" });
     const fs = await import('node:fs').then((mod) => mod.promises);
     const path = await import('node:path');

package/dist/utils/createDirectory.js

@@ -0,0 +1,21 @@
+import { promises as fs } from 'node:fs';
+export async function createDirectory(path, name, log) {
+    try {
+        await fs.access(path);
+        log.debug(`Directory ${name} already exists at path: ${path}`);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            try {
+                await fs.mkdir(path, { recursive: true });
+                log.info(`Created ${name}: ${path}`);
+            }
+            catch (err) {
+                log.error(`Error creating dir ${name} path ${path}: ${err}`);
+            }
+        }
+        else {
+            log.error(`Error accessing dir ${name} path ${path}: ${err}`);
+        }
+    }
+}

package/dist/utils/export.js

@@ -5,6 +5,7 @@ export * from './colorUtils.js';
 export * from './deepCopy.js';
 export * from './deepEqual.js';
 export * from './copyDirectory.js';
+export * from './createDirectory.js';
 export * from './createZip.js';
 export * from './wait.js';
 export * from './hex.js';

package/dist/utils/spawn.js

@@ -0,0 +1,68 @@
+import { hasParameter } from './commandLine.js';
+export default {
+    async spawnCommand(matterbridge, command, args) {
+        const { spawn } = await import('node:child_process');
+        const cmdLine = command + ' ' + args.join(' ');
+        if (process.platform === 'win32' && command === 'npm') {
+            const argstring = 'npm ' + args.join(' ');
+            args.splice(0, args.length, '/c', argstring);
+            command = 'cmd.exe';
+        }
+        if (hasParameter('sudo') || (process.platform !== 'win32' && command === 'npm' && !hasParameter('docker') && !hasParameter('nosudo'))) {
+            args.unshift(command);
+            command = 'sudo';
+        }
+        matterbridge.log.debug(`Spawn command ${command} with ${args.join(' ')}`);
+        return new Promise((resolve, reject) => {
+            const childProcess = spawn(command, args, {
+                stdio: ['inherit', 'pipe', 'pipe'],
+            });
+            childProcess.on('error', (err) => {
+                matterbridge.log.error(`Failed to start child process "${cmdLine}": ${err.message}`);
+                reject(err);
+            });
+            childProcess.on('close', (code, signal) => {
+                matterbridge.frontend.wssSendMessage('spawn', matterbridge.log.now(), 'Matterbridge:spawn', `child process closed with code ${code} and signal ${signal}`);
+                if (code === 0) {
+                    if (cmdLine.startsWith('npm install -g'))
+                        matterbridge.log.notice(`Package ${cmdLine.replace('npm install -g ', '').replace('--verbose', '').replace('--omit=dev', '')} installed correctly`);
+                    matterbridge.log.debug(`Child process "${cmdLine}" closed with code ${code} and signal ${signal}`);
+                    resolve(true);
+                }
+                else {
+                    matterbridge.log.error(`Child process "${cmdLine}" closed with code ${code} and signal ${signal}`);
+                    reject(new Error(`Child process "${cmdLine}" closed with code ${code} and signal ${signal}`));
+                }
+            });
+            childProcess.on('exit', (code, signal) => {
+                matterbridge.frontend.wssSendMessage('spawn', matterbridge.log.now(), 'Matterbridge:spawn', `child process exited with code ${code} and signal ${signal}`);
+                if (code === 0) {
+                    matterbridge.log.debug(`Child process "${cmdLine}" exited with code ${code} and signal ${signal}`);
+                    resolve(true);
+                }
+                else {
+                    matterbridge.log.error(`Child process "${cmdLine}" exited with code ${code} and signal ${signal}`);
+                    reject(new Error(`Child process "${cmdLine}" exited with code ${code} and signal ${signal}`));
+                }
+            });
+            childProcess.on('disconnect', () => {
+                matterbridge.log.debug(`Child process "${cmdLine}" has been disconnected from the parent`);
+                resolve(true);
+            });
+            if (childProcess.stdout) {
+                childProcess.stdout.on('data', (data) => {
+                    const message = data.toString().trim();
+                    matterbridge.log.debug(`Spawn output (stdout): ${message}`);
+                    matterbridge.frontend.wssSendMessage('spawn', matterbridge.log.now(), 'Matterbridge:spawn', message);
+                });
+            }
+            if (childProcess.stderr) {
+                childProcess.stderr.on('data', (data) => {
+                    const message = data.toString().trim();
+                    matterbridge.log.debug(`Spawn verbose (stderr): ${message}`);
+                    matterbridge.frontend.wssSendMessage('spawn', matterbridge.log.now(), 'Matterbridge:spawn', message);
+                });
+            }
+        });
+    },
+};

package/dist/utils/wait.js

@@ -18,7 +18,7 @@ export async function waiter(name, check, exitWithReject = false, resolveTimeout
             else
                 resolve(false);
         }, resolveTimeout);
-        const intervalId = setInterval(() => {
+        const intervalId = setInterval(async () => {
             if (check()) {
                 if (debug)
                     log.debug(`Waiter "${name}" finished for true condition...`);
@@ -26,6 +26,7 @@ export async function waiter(name, check, exitWithReject = false, resolveTimeout
                 clearInterval(intervalId);
                 resolve(true);
             }
+            await Promise.resolve();
         }, resolveInterval);
     });
 }

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge",
-  "version": "3.0.5-dev-20250609-a5046db",
+  "version": "3.0.6-dev-20250610-56cd483",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge",
-      "version": "3.0.5-dev-20250609-a5046db",
+      "version": "3.0.6-dev-20250610-56cd483",
       "license": "Apache-2.0",
       "dependencies": {
         "@matter/main": "0.14.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge",
-  "version": "3.0.5-dev-20250609-a5046db",
+  "version": "3.0.6-dev-20250610-56cd483",
   "description": "Matterbridge plugin manager for Matter",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",