matterbridge 1.2.16 → 1.2.18

package/dist/matterbridge.js

@@ -22,7 +22,7 @@
  */
 import { MatterbridgeDevice } from './matterbridgeDevice.js';
 import { NodeStorageManager } from 'node-persist-manager';
-import { AnsiLogger, BRIGHT, RESET, UNDERLINE, UNDERLINEOFF, YELLOW, db, debugStringify, stringify, er, nf, rs, wr, RED, GREEN } from 'node-ansi-logger';
+import { AnsiLogger, BRIGHT, RESET, UNDERLINE, UNDERLINEOFF, YELLOW, db, debugStringify, stringify, er, nf, rs, wr, RED, GREEN, zb } from 'node-ansi-logger';
 import { fileURLToPath, pathToFileURL } from 'url';
 import { promises as fs } from 'fs';
 import { exec, spawn } from 'child_process';
@@ -42,7 +42,7 @@ import { ManualPairingCodeCodec, QrCodeSchema } from '@project-chip/matter-node.
 import { StorageBackendDisk, StorageBackendJsonFile, StorageManager } from '@project-chip/matter-node.js/storage';
 import { requireMinNodeVersion, getParameter, getIntParameter, hasParameter } from '@project-chip/matter-node.js/util';
 import { CryptoNode } from '@project-chip/matter-node.js/crypto';
-import { somfytahoma_config, somfytahoma_schema, zigbee2mqtt_config, zigbee2mqtt_schema } from './defaultConfigSchema.js';
+import { shelly_config, shelly_schema, somfytahoma_config, somfytahoma_schema, zigbee2mqtt_config, zigbee2mqtt_schema } from './defaultConfigSchema.js';
 const plg = '\u001B[38;5;33m';
 const dev = '\u001B[38;5;79m';
 const typ = '\u001B[38;5;207m';
@@ -478,7 +478,7 @@ export class Matterbridge extends EventEmitter {
             this.log.debug(`Package.json not found at ${packageJsonPath}`);
             this.log.debug(`Trying at ${this.globalModulesDirectory}`);
             packageJsonPath = path.join(this.globalModulesDirectory, pluginPath);
-            //this.log.debug(`Got ${packageJsonPath}`);
+            // this.log.debug(`Got ${packageJsonPath}`);
         }
         try {
             // Load the package.json of the plugin
@@ -760,8 +760,9 @@ export class Matterbridge extends EventEmitter {
                     const serializedRegisteredDevices = [];
                     this.registeredDevices.forEach((registeredDevice) => {
                         const serializedMatterbridgeDevice = registeredDevice.device.serialize(registeredDevice.plugin);
-                        //this.log.info(`- ${serializedMatterbridgeDevice.deviceName}${rs}\n`, serializedMatterbridgeDevice);
-                        serializedRegisteredDevices.push(serializedMatterbridgeDevice);
+                        // this.log.info(`- ${serializedMatterbridgeDevice.deviceName}${rs}\n`, serializedMatterbridgeDevice);
+                        if (serializedMatterbridgeDevice)
+                            serializedRegisteredDevices.push(serializedMatterbridgeDevice);
                     });
                     await this.nodeContext.set('devices', serializedRegisteredDevices);
                     this.log.info('Saved registered devices');
@@ -918,7 +919,7 @@ export class Matterbridge extends EventEmitter {
         if (this.bridgeMode === 'bridge') {
             device.setBridgedDeviceReachability(false);
             device.getClusterServerById(BridgedDeviceBasicInformation.Cluster.id)?.triggerReachableChangedEvent({ reachableNewValue: false });
-            this.matterAggregator.removeBridgedDevice(device);
+            this.matterAggregator?.removeBridgedDevice(device);
             this.registeredDevices.forEach((registeredDevice, index) => {
                 if (registeredDevice.device === device) {
                     this.registeredDevices.splice(index, 1);
@@ -945,7 +946,7 @@ export class Matterbridge extends EventEmitter {
                 });
                 device.setBridgedDeviceReachability(false);
                 device.getClusterServerById(BridgedDeviceBasicInformation.Cluster.id)?.triggerReachableChangedEvent({ reachableNewValue: false });
-                plugin.aggregator.removeBridgedDevice(device);
+                plugin.aggregator?.removeBridgedDevice(device);
             }
             this.log.info(`Removed bridged device(${plugin.registeredDevices}/${plugin.addedDevices}) ${dev}${device.deviceName}${nf} (${dev}${device.name}${nf}) for plugin ${plg}${pluginName}${nf}`);
             if (plugin.registeredDevices !== undefined)
@@ -1051,85 +1052,7 @@ export class Matterbridge extends EventEmitter {
         this.mattercontrollerContext = undefined;
     }
     async testStartMatterBridge() {
-        /*
-        if (!this.storageManager) {
-          this.log.error('No storage manager initialized');
-          await this.cleanup('No storage manager initialized');
-          return;
-        }
-        this.log.debug('Starting matterbridge in mode', this.bridgeMode);
-        this.matterServer = this.createMatterServer(this.storageManager);
-    
-        this.log.debug('***Starting startMatterbridge interval for Matterbridge');
-        let failCount = 0;
-        const startInterval = setInterval(async () => {
-          for (const plugin of this.registeredPlugins) {
-            if (!plugin.enabled) continue;
-            if (!plugin.loaded) {
-              this.log.info(`***Waiting (failSafeCount=${failCount}/30) in startMatterbridge interval for plugin ${plg}${plugin.name}${db} loaded: ${plugin.loaded}...`);
-              failCount++;
-              if (failCount > 30) {
-                this.log.error(`***Failed to load plugin ${plg}${plugin.name}${er}`);
-                plugin.error = true;
-              } else {
-                return;
-              }
-            }
-          }
-          clearInterval(startInterval);
-          this.log.debug('***Cleared startMatterbridge interval for Matterbridge');
-    
-          this.log.debug(`Creating commissioning server context for ${plg}Matterbridge${db}`);
-          this.matterbridgeContext = await this.createCommissioningServerContext('Matterbridge', 'Matterbridge', DeviceTypes.AGGREGATOR.code, 0xfff1, 'Matterbridge', 0x8000, 'Matterbridge Aggregator');
-          if (!this.matterbridgeContext) {
-            this.log.error(`Error creating storage context for ${plg}Matterbridge${er}`);
-            return;
-          }
-          if (!this.nodeContext) {
-            this.log.error(`Node storage context undefined for ${plg}Matterbridge${er}`);
-            return;
-          }
-          await this.matterbridgeContext.set('softwareVersion', 1);
-          await this.matterbridgeContext.set('softwareVersionString', this.matterbridgeVersion);
-          this.log.debug(`Creating commissioning server for ${plg}Matterbridge${db}`);
-          this.commissioningServer = await this.createCommisioningServer(this.matterbridgeContext, 'Matterbridge');
-    
-          this.log.debug(`Creating matter aggregator for ${plg}Matterbridge${db}`);
-          this.matterAggregator = await this.createMatterAggregator(this.matterbridgeContext, 'Matterbridge');
-          this.log.debug('Adding matterbridge aggregator to commissioning server');
-          this.commissioningServer.addDevice(this.matterAggregator);
-    
-          const device = new MatterbridgeDevice(DeviceTypes.CONTACT_SENSOR);
-          device.createDefaultIdentifyClusterServer();
-          device.createDefaultBridgedDeviceBasicInformationClusterServer('Boolean test', '0x89930475', 0x8000, 'Matterbridge', 'Boolean');
-          device.createDefaultBooleanStateClusterServer(true);
-          device.createDefaultPowerSourceReplaceableBatteryClusterServer(75);
-          device.createDefaultPowerSourceConfigurationClusterServer(1);
-    
-          this.log.debug('Adding matterbridge commissioning server to matter server');
-          await this.matterServer?.addCommissioningServer(this.commissioningServer, { uniqueStorageKey: 'Matterbridge' });
-          this.log.debug(`Setting reachability to true for ${plg}Matterbridge${db}`);
-          this.commissioningServer.setReachability(true);
-          this.log.debug('Starting matter server...');
-          await this.startMatterServer();
-          this.log.info('Matter server started');
-          await this.showCommissioningQRCode(this.commissioningServer, this.matterbridgeContext, this.nodeContext, 'Matterbridge');
-    
-          setTimeout(() => {
-            this.matterAggregator?.addBridgedDevice(device);
-            this.log.info('Added device to aggregator');
-          }, 30 * 1000);
-    
-          setInterval(() => {
-            const cluster = device.getClusterServer(BooleanStateCluster);
-            if (!cluster) return;
-            const contact = cluster.getStateValueAttribute();
-            cluster.setStateValueAttribute(!contact);
-            if (cluster.isEventSupportedByName('stateChange')) cluster.triggerStateChangeEvent!({ stateValue: !contact });
-            this.log.info('Set attribute and event for BooleanStateCluster to', !contact);
-          }, 60 * 1000);
-        }, 1000);
-        */
+        // Start the Matterbridge
     }
     /**
      * Loads the schema for a plugin.
@@ -1160,6 +1083,8 @@ export class Matterbridge extends EventEmitter {
                         schema = zigbee2mqtt_schema;
                     else if (plugin.name === 'matterbridge-somfy-tahoma')
                         schema = somfytahoma_schema;
+                    else if (plugin.name === 'matterbridge-shelly')
+                        schema = shelly_schema;
                     else
                         schema = {
                             title: plugin.description,
@@ -1252,6 +1177,8 @@ export class Matterbridge extends EventEmitter {
                         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, unregisterOnShutdown: false };
                     try {
@@ -1421,7 +1348,7 @@ export class Matterbridge extends EventEmitter {
             if (pluginInstance.default) {
                 const config = await this.loadPluginConfig(plugin);
                 const log = new AnsiLogger({ logName: plugin.description, logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logDebug: this.debugEnabled });
-                //log.setCallback(this.wssSendMessage.bind(this));
+                // log.setCallback(this.wssSendMessage.bind(this));
                 const platform = pluginInstance.default(this, log, config);
                 platform.name = packageJson.name;
                 platform.config = config;
@@ -1446,14 +1373,14 @@ export class Matterbridge extends EventEmitter {
                 this.log.error(`Plugin ${plg}${plugin.name}${er} does not provide a default export`);
                 plugin.error = true;
                 return;
-                //return Promise.reject(new Error(`Plugin ${plg}${plugin.name}${er} does not provide a default export`));
+                // return Promise.reject(new Error(`Plugin ${plg}${plugin.name}${er} does not provide a default export`));
             }
         }
         catch (err) {
             this.log.error(`Failed to load plugin ${plg}${plugin.name}${er}: ${err}`);
             plugin.error = true;
             return;
-            //return Promise.reject(new Error(`Failed to load plugin ${plg}${plugin.name}${er}: ${err}`));
+            // return Promise.reject(new Error(`Failed to load plugin ${plg}${plugin.name}${er}: ${err}`));
         }
     }
     /**
@@ -1534,8 +1461,8 @@ export class Matterbridge extends EventEmitter {
             return;
         }
         if (hasParameter('discover')) {
-            //const discover = await this.commissioningController.discoverCommissionableDevices({ productId: 0x8000, deviceType: 0xfff1 });
-            //console.log(discover);
+            // const discover = await this.commissioningController.discoverCommissionableDevices({ productId: 0x8000, deviceType: 0xfff1 });
+            // console.log(discover);
         }
         if (!this.commissioningController.isCommissioned()) {
             this.log.info('***Commissioning controller is not commissioned: use matterbridge -controller -pairingcode [pairingcode] to commission a device');
@@ -1575,7 +1502,7 @@ export class Matterbridge extends EventEmitter {
                     }
                 },
             });
-            //node.logStructure();
+            // node.logStructure();
             // Get the interaction client
             this.log.info('Getting the interaction client');
             const interactionClient = await node.getInteractionClient();
@@ -1678,7 +1605,7 @@ export class Matterbridge extends EventEmitter {
                 this.log.info('Matter server started');
                 await this.showCommissioningQRCode(this.commissioningServer, this.matterbridgeContext, this.nodeContext, 'Matterbridge');
                 // logEndpoint(this.commissioningServer.getRootEndpoint());
-                //if (hasParameter('advertise')) await this.commissioningServer.advertise();
+                // if (hasParameter('advertise')) await this.commissioningServer.advertise();
                 setTimeout(() => {
                     this.log.info(`Setting reachability to true for ${plg}Matterbridge${db}`);
                     if (this.commissioningServer)
@@ -1725,7 +1652,8 @@ export class Matterbridge extends EventEmitter {
                                 plugin.device = registeredDevice.device;
                         }
                         this.log.debug(`Adding commissioning server to matter server for plugin ${plg}${plugin.name}${db}`);
-                        await this.matterServer?.addCommissioningServer(plugin.commissioningServer, { uniqueStorageKey: plugin.name });
+                        if (plugin.commissioningServer)
+                            await this.matterServer?.addCommissioningServer(plugin.commissioningServer, { uniqueStorageKey: plugin.name });
                     }
                     if (plugin.type === 'DynamicPlatform') {
                         this.log.debug(`Creating commissioning server context for ${plg}${plugin.name}${db}`);
@@ -1790,7 +1718,7 @@ export class Matterbridge extends EventEmitter {
                         this.setAggregatorReachability(plugin.aggregator, true);
                 }
                 Logger.defaultLogLevel = this.debugEnabled ? Level.DEBUG : Level.INFO;
-                //clearInterval(startMatterInterval);
+                // clearInterval(startMatterInterval);
             }, 1000);
         }
     }
@@ -1807,7 +1735,7 @@ export class Matterbridge extends EventEmitter {
         this.log.debug('Starting matter server...');
         await this.matterServer.start();
         this.log.debug('Started matter server');
-        //this.commissioningServer?.getRootEndpoint() && logEndpoint(this.commissioningServer?.getRootEndpoint());
+        // this.commissioningServer?.getRootEndpoint() && logEndpoint(this.commissioningServer?.getRootEndpoint());
     }
     /**
      * Imports the commissioning server context for a specific plugin and device.
@@ -1928,7 +1856,13 @@ export class Matterbridge extends EventEmitter {
             await this.nodeContext?.set('plugins', await this.getBaseRegisteredPlugins());
         }
         else {
-            this.log.info(`*The commissioning server on port ${commissioningServer.getPort()} for ${plg}${pluginName}${nf} is already commissioned . Waiting for controllers to connect ...`);
+            this.log.info(`*The commissioning server on port ${commissioningServer.getPort()} for ${plg}${pluginName}${nf} is already commissioned. Waiting for controllers to connect ...`);
+            const fabricInfo = commissioningServer.getCommissionedFabricInformation();
+            if (fabricInfo.length > 0)
+                this.log.info('Commissioned fabric information:');
+            fabricInfo?.forEach((info) => {
+                this.log.info(`- fabric index ${zb}${info.fabricIndex}${nf} id ${zb}${info.fabricId}${nf} vendor ${zb}${info.rootVendorId}${nf} ${this.getVendorIdName(info.rootVendorId)} ${info.label}`);
+            });
             if (pluginName !== 'Matterbridge') {
                 const plugin = this.findPlugin(pluginName);
                 if (plugin) {
@@ -1995,6 +1929,41 @@ export class Matterbridge extends EventEmitter {
         if (basicInformationCluster && basicInformationCluster.triggerReachableChangedEvent)
             basicInformationCluster.triggerReachableChangedEvent({ reachableNewValue: reachable });
     }
+    getVendorIdName = (vendorId) => {
+        if (!vendorId)
+            return '';
+        let vendorName = '';
+        switch (vendorId) {
+            case 4937:
+                vendorName = '(AppleHome)';
+                break;
+            case 4996:
+                vendorName = '(AppleKeyChain)';
+                break;
+            case 4362:
+                vendorName = '(SmartThings)';
+                break;
+            case 4939:
+                vendorName = '(HomeAssistant)';
+                break;
+            case 24582:
+                vendorName = '(GoogleHome)';
+                break;
+            case 4631:
+                vendorName = '(Alexa)';
+                break;
+            case 4701:
+                vendorName = '(Tuya)';
+                break;
+            case 4742:
+                vendorName = '(eWeLink)';
+                break;
+            default:
+                vendorName = '(unknown)';
+                break;
+        }
+        return vendorName;
+    };
     /**
      * Creates a matter commissioning server.
      *
@@ -2003,38 +1972,6 @@ export class Matterbridge extends EventEmitter {
      * @returns {CommissioningServer} The created commissioning server.
      */
     async createCommisioningServer(context, pluginName) {
-        const getVendorIdName = (vendorId) => {
-            if (!vendorId)
-                return '';
-            let vendorName = '';
-            switch (vendorId) {
-                case 4937:
-                    vendorName = '(AppleHome)';
-                    break;
-                case 4996:
-                    vendorName = '(AppleKeyChain)';
-                    break;
-                case 4362:
-                    vendorName = '(SmartThings)';
-                    break;
-                case 4939:
-                    vendorName = '(HomeAssistant)';
-                    break;
-                case 24582:
-                    vendorName = '(GoogleHome)';
-                    break;
-                case 4701:
-                    vendorName = '(Tuya)';
-                    break;
-                case 4742:
-                    vendorName = '(eWeLink)';
-                    break;
-                default:
-                    vendorName = '(unknown)';
-                    break;
-            }
-            return vendorName;
-        };
         this.log.debug(`Creating matter commissioning server for plugin ${plg}${pluginName}${db}`);
         const deviceName = await context.get('deviceName');
         const deviceType = await context.get('deviceType');
@@ -2077,9 +2014,9 @@ export class Matterbridge extends EventEmitter {
                 const info = commissioningServer.getActiveSessionInformation(fabricIndex);
                 let connected = false;
                 info.forEach((session) => {
-                    this.log.info(`*Active session changed on fabric ${fabricIndex} ${session.fabric?.rootVendorId}${getVendorIdName(session.fabric?.rootVendorId)}/${session.fabric?.label} for ${plg}${pluginName}${nf}`, debugStringify(session));
+                    this.log.info(`*Active session changed on fabric ${zb}${fabricIndex}${nf} vendor ${zb}${session.fabric?.rootVendorId}${nf} ${this.getVendorIdName(session.fabric?.rootVendorId)} ${session.fabric?.label} for ${plg}${pluginName}${nf}`, debugStringify(session));
                     if (session.isPeerActive === true && session.secure === true && session.numberOfActiveSubscriptions >= 1) {
-                        this.log.info(`*Controller ${session.fabric?.rootVendorId}${getVendorIdName(session.fabric?.rootVendorId)}/${session.fabric?.label} connected to ${plg}${pluginName}${nf} on session ${session.name}`);
+                        this.log.info(`*Controller ${zb}${session.fabric?.rootVendorId}${nf} ${this.getVendorIdName(session.fabric?.rootVendorId)} ${session.fabric?.label} connected to ${plg}${pluginName}${nf} on session ${session.name}`);
                         connected = true;
                     }
                 });
@@ -2093,7 +2030,7 @@ export class Matterbridge extends EventEmitter {
                     }
                     setTimeout(() => {
                         if (this.bridgeMode === 'bridge') {
-                            //Logger.defaultLogLevel = Level.INFO;
+                            // Logger.defaultLogLevel = Level.INFO;
                             for (const plugin of this.registeredPlugins) {
                                 if (!plugin.enabled || !plugin.loaded || plugin.error)
                                     continue;
@@ -2108,7 +2045,7 @@ export class Matterbridge extends EventEmitter {
                             Logger.defaultLogLevel = this.debugEnabled ? Level.DEBUG : Level.INFO;
                         }
                         if (this.bridgeMode === 'childbridge') {
-                            //Logger.defaultLogLevel = Level.INFO;
+                            // Logger.defaultLogLevel = Level.INFO;
                             const plugin = this.findPlugin(pluginName);
                             if (plugin && plugin.type === 'DynamicPlatform' && plugin.configured !== true) {
                                 for (const registeredDevice of this.registeredDevices) {
@@ -2140,10 +2077,10 @@ export class Matterbridge extends EventEmitter {
                 }
             },
             commissioningChangedCallback: async (fabricIndex) => {
-                const info = commissioningServer.getCommissionedFabricInformation(fabricIndex);
-                this.log.debug(`*Commissioning changed on fabric ${fabricIndex} for ${plg}${pluginName}${nf}`, debugStringify(info));
-                if (info.length === 0) {
-                    this.log.warn(`*Commissioning removed from fabric ${fabricIndex} for ${plg}${pluginName}${wr}. Resetting the commissioning server ...`);
+                const fabricInfo = commissioningServer.getCommissionedFabricInformation(fabricIndex);
+                this.log.debug(`*Commissioning changed on fabric ${zb}${fabricIndex}${nf} for ${plg}${pluginName}${nf}`, debugStringify(fabricInfo));
+                if (commissioningServer.getCommissionedFabricInformation().length === 0) {
+                    this.log.warn(`*Commissioning removed from fabric ${zb}${fabricIndex}${nf} for ${plg}${pluginName}${wr}. Resetting the commissioning server ...`);
                     await commissioningServer.factoryReset();
                     if (pluginName === 'Matterbridge') {
                         await this.matterbridgeContext?.clearAll();
@@ -2609,14 +2546,14 @@ export class Matterbridge extends EventEmitter {
             if (childProcess.stdout) {
                 childProcess.stdout.on('data', (data) => {
                     const message = data.toString().trim();
-                    //this.log.info('\n' + message);
+                    // this.log.info('\n' + message);
                     this.wssSendMessage('Matterbridge:spawn', 'spawn', message);
                 });
             }
             if (childProcess.stderr) {
                 childProcess.stderr.on('data', (data) => {
                     const message = data.toString().trim();
-                    //this.log.debug('\n' + message);
+                    // this.log.debug('\n' + message);
                     this.wssSendMessage('Matterbridge:spawn', 'spawn', message);
                 });
             }
@@ -2650,12 +2587,12 @@ export class Matterbridge extends EventEmitter {
         this.log.debug(`Initializing the frontend on port ${YELLOW}${port}${db} static ${UNDERLINE}${path.join(this.rootDirectory, 'frontend/build')}${UNDERLINEOFF}${rs}`);
         const wssPort = 8284;
         const useHttps = false;
-        //const wssHost = (useHttps ? 'wss://' : 'ws://') + `${os.hostname().toLowerCase()}:${wssPort}`;
+        // const wssHost = (useHttps ? 'wss://' : 'ws://') + `${os.hostname().toLowerCase()}:${wssPort}`;
         const wssHost = (useHttps ? 'wss://' : 'ws://') + `${this.systemInformation.ipv4Address}:${wssPort}`;
         if (!useHttps) {
             // Create a WebSocket server no certificate required
             this.webSocketServer = new WebSocketServer({ port: wssPort });
-            this.log.info(`WebSocket server listening on ${UNDERLINE}${wssHost}${UNDERLINEOFF}${rs}`);
+            // this.log.info(`WebSocket server listening on ${UNDERLINE}${wssHost}${UNDERLINEOFF}${rs}`);
         }
         else {
             // Define the options for HTTPS server
@@ -2682,19 +2619,27 @@ export class Matterbridge extends EventEmitter {
             this.log.debug('WebSocketServer activated logger callback');
             this.wssSendMessage('Matterbridge', 'info', 'WebSocketServer client connected to Matterbridge');
             ws.on('message', (message) => {
-                this.log.info(`WebSocketServer received message => ${message}`);
+                this.log.info(`WebSocket received message => ${message}`);
             });
             ws.on('close', () => {
-                this.log.info('WebSocketServer client disconnected');
+                this.log.info('WebSocket client disconnected');
                 if (this.webSocketServer?.clients.size === 0) {
                     this.log.setGlobalCallback(undefined);
-                    this.log.debug('WebSocketServer deactivated logger callback');
+                    this.log.debug('WebSocket deactivated logger callback');
                 }
             });
             ws.on('error', (error) => {
-                this.log.error(`WebSocketServer error: ${error}`);
+                this.log.error(`WebSocket error: ${error}`);
             });
         });
+        this.webSocketServer.on('error', (ws, error) => {
+            this.log.error(`WebSocketServer error: ${error}`);
+            return;
+        });
+        this.webSocketServer.on('listening', () => {
+            this.log.info(`WebSocketServer is listening on ${UNDERLINE}${wssHost}${UNDERLINEOFF}${rs}`);
+            return;
+        });
         // Serve React build directory
         this.expressApp = express();
         this.expressApp.use(express.static(path.join(this.rootDirectory, 'frontend/build')));
@@ -2735,6 +2680,7 @@ export class Matterbridge extends EventEmitter {
                 if (this.bridgeMode === 'bridge')
                     this.log.error('pairingCode for /api/settings not found');
                 res.json({});
+                return;
             }
             this.matterbridgeInformation.bridgeMode = this.bridgeMode;
             this.matterbridgeInformation.restartMode = this.restartMode;
@@ -2793,7 +2739,7 @@ export class Matterbridge extends EventEmitter {
                         Object.entries(clusterServer.attributes).forEach(([key, value]) => {
                             if (clusterServer.name === 'EveHistory')
                                 return;
-                            //this.log.debug(`***--clusterServer: ${clusterServer.name}(${clusterServer.id}) attribute:${key}(${value.id}) ${value.isFixed} ${value.isWritable} ${value.isWritable}`);
+                            // this.log.debug(`***--clusterServer: ${clusterServer.name}(${clusterServer.id}) attribute:${key}(${value.id}) ${value.isFixed} ${value.isWritable} ${value.isWritable}`);
                             let attributeValue;
                             try {
                                 if (typeof value.getLocal() === 'object')
@@ -2804,7 +2750,7 @@ export class Matterbridge extends EventEmitter {
                             catch (error) {
                                 attributeValue = 'Unavailable';
                                 this.log.debug(`GetLocal value ${error} in clusterServer: ${clusterServer.name}(${clusterServer.id}) attribute: ${key}(${value.id})`);
-                                //console.log(error);
+                                // console.log(error);
                             }
                             data.push({
                                 endpoint: registeredDevice.device.number ? registeredDevice.device.number.toString() : '...',
@@ -2823,7 +2769,7 @@ export class Matterbridge extends EventEmitter {
                             Object.entries(clusterServer.attributes).forEach(([key, value]) => {
                                 if (clusterServer.name === 'EveHistory')
                                     return;
-                                //this.log.debug(`***--clusterServer: ${clusterServer.name}(${clusterServer.id}) attribute:${key}(${value.id}) ${value.isFixed} ${value.isWritable} ${value.isWritable}`);
+                                // this.log.debug(`***--clusterServer: ${clusterServer.name}(${clusterServer.id}) attribute:${key}(${value.id}) ${value.isFixed} ${value.isWritable} ${value.isWritable}`);
                                 let attributeValue;
                                 try {
                                     if (typeof value.getLocal() === 'object')
@@ -2834,7 +2780,7 @@ export class Matterbridge extends EventEmitter {
                                 catch (error) {
                                     attributeValue = 'Unavailable';
                                     this.log.debug(`GetLocal error ${error} in clusterServer: ${clusterServer.name}(${clusterServer.id}) attribute: ${key}(${value.id})`);
-                                    //console.log(error);
+                                    // console.log(error);
                                 }
                                 data.push({
                                     endpoint: (childEndpoint.number ? childEndpoint.number.toString() : '...') + (name ? ' (' + name + ')' : ''),
@@ -2932,7 +2878,7 @@ export class Matterbridge extends EventEmitter {
             if (command === 'saveconfig') {
                 param = param.replace(/\*/g, '\\');
                 this.log.info(`Saving config for plugin ${plg}${param}${nf}...`);
-                //console.log('Req.body:', JSON.stringify(req.body, null, 2));
+                // console.log('Req.body:', JSON.stringify(req.body, null, 2));
                 const plugins = await this.nodeContext?.get('plugins');
                 if (!plugins)
                     return;
@@ -3085,6 +3031,21 @@ export class Matterbridge extends EventEmitter {
             this.expressServer = this.expressApp.listen(port, () => {
                 this.log.info(`The frontend is listening on ${UNDERLINE}http://${this.systemInformation.ipv4Address}:${port}${UNDERLINEOFF}${rs}`);
             });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            this.expressServer.on('error', (error) => {
+                this.log.error(`Frontend error listening on ${UNDERLINE}http://${this.systemInformation.ipv4Address}:${port}${UNDERLINEOFF}${rs}`);
+                switch (error.code) {
+                    case 'EACCES':
+                        this.log.error(`Port ${port} requires elevated privileges`);
+                        break;
+                    case 'EADDRINUSE':
+                        this.log.error(`Port ${port} is already in use`);
+                        break;
+                    default:
+                        this.log.error(`Port ${port} requires elevated privileges`);
+                }
+                process.exit(1);
+            });
         }
         else {
             // SSL certificate and private key paths
@@ -3116,13 +3077,13 @@ export class Matterbridge extends EventEmitter {
             if (composed)
                 return 'Composed: ' + composed.value;
             else
-                return ''; //'FixedLabel: ' + labelList.map((entry) => entry.label + ': ' + entry.value).join(' ');
+                return ''; // 'FixedLabel: ' + labelList.map((entry) => entry.label + ': ' + entry.value).join(' ');
         };
         let attributes = '';
-        //this.log.debug(`getClusterTextFromDevice: ${device.name}`);
+        // this.log.debug(`getClusterTextFromDevice: ${device.name}`);
         const clusterServers = device.getAllClusterServers();
         clusterServers.forEach((clusterServer) => {
-            //this.log.debug(`***--clusterServer: ${clusterServer.id} (${clusterServer.name})`);
+            // this.log.debug(`***--clusterServer: ${clusterServer.id} (${clusterServer.name})`);
             if (clusterServer.name === 'OnOff')
                 attributes += `OnOff: ${clusterServer.getOnOffAttribute()} `;
             if (clusterServer.name === 'Switch')