matterbridge 1.7.3 → 2.0.0-edge1

package/dist/frontend.js

@@ -0,0 +1,1377 @@
+/**
+ * This file contains the class Frontend.
+ *
+ * @file frontend.ts
+ * @author Luca Liguori
+ * @date 2025-01-13
+ * @version 1.0.0
+ *
+ * Copyright 2025, 2026, 2027 Luca Liguori.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License. *
+ */
+// @matter
+import { EndpointServer, Logger, LogLevel as MatterLogLevel, LogFormat as MatterLogFormat } from '@matter/main';
+// Node modules
+import { createServer } from 'http';
+import https from 'https';
+import express from 'express';
+import WebSocket, { WebSocketServer } from 'ws';
+import os from 'os';
+import path from 'path';
+import { promises as fs } from 'fs';
+// AnsiLogger module
+import { AnsiLogger, CYAN, db, debugStringify, er, LogLevel, nf, rs, stringify, TimestampFormat, UNDERLINE, UNDERLINEOFF, wr, YELLOW } from 'node-ansi-logger';
+// Matterbridge
+import { createZip, hasParameter, isValidNumber, isValidObject, isValidString } from './utils/utils.js';
+import { plg } from './matterbridgeTypes.js';
+import { MatterbridgeEndpoint } from './matterbridgeEndpoint.js';
+/**
+ * Websocket message ID for logging.
+ * @constant {number}
+ */
+export const WS_ID_LOG = 0;
+/**
+ * Websocket message ID indicating a refresh is needed.
+ * @constant {number}
+ */
+export const WS_ID_REFRESH_NEEDED = 1;
+/**
+ * Websocket message ID indicating a restart is needed.
+ * @constant {number}
+ */
+export const WS_ID_RESTART_NEEDED = 2;
+/**
+ * Initializes the frontend of Matterbridge.
+ *
+ * @param port The port number to run the frontend server on. Default is 8283.
+ */
+export class Frontend {
+    matterbridge;
+    log;
+    port = 8283;
+    initializeError = false;
+    expressApp;
+    httpServer;
+    httpsServer;
+    webSocketServer;
+    constructor(matterbridge) {
+        this.matterbridge = matterbridge;
+        this.log = new AnsiLogger({ logName: 'Frontend', logTimestampFormat: TimestampFormat.TIME_MILLIS, logLevel: hasParameter('debug') ? LogLevel.DEBUG : LogLevel.INFO });
+    }
+    async start(port = 8283) {
+        this.port = port;
+        this.log.debug(`Initializing the frontend ${hasParameter('ssl') ? 'https' : 'http'} server on port ${YELLOW}${this.port}${db}`);
+        // Create the express app that serves the frontend
+        this.expressApp = express();
+        // Log all requests to the server for debugging
+        /*
+        this.expressApp.use((req, res, next) => {
+          this.log.debug(`Received request on expressApp: ${req.method} ${req.url}`);
+          next();
+        });
+        */
+        // Serve static files from '/static' endpoint
+        this.expressApp.use(express.static(path.join(this.matterbridge.rootDirectory, 'frontend/build')));
+        if (!hasParameter('ssl')) {
+            // Create an HTTP server and attach the express app
+            this.httpServer = createServer(this.expressApp);
+            // Listen on the specified port
+            if (hasParameter('ingress')) {
+                this.httpServer.listen(this.port, '0.0.0.0', () => {
+                    this.log.info(`The frontend http server is listening on ${UNDERLINE}http://0.0.0.0:${this.port}${UNDERLINEOFF}${rs}`);
+                });
+            }
+            else {
+                this.httpServer.listen(this.port, () => {
+                    if (this.matterbridge.systemInformation.ipv4Address !== '')
+                        this.log.info(`The frontend http server is listening on ${UNDERLINE}http://${this.matterbridge.systemInformation.ipv4Address}:${this.port}${UNDERLINEOFF}${rs}`);
+                    if (this.matterbridge.systemInformation.ipv6Address !== '')
+                        this.log.info(`The frontend http server is listening on ${UNDERLINE}http://[${this.matterbridge.systemInformation.ipv6Address}]:${this.port}${UNDERLINEOFF}${rs}`);
+                });
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            this.httpServer.on('error', (error) => {
+                this.log.error(`Frontend http server error listening on ${this.port}`);
+                switch (error.code) {
+                    case 'EACCES':
+                        this.log.error(`Port ${this.port} requires elevated privileges`);
+                        break;
+                    case 'EADDRINUSE':
+                        this.log.error(`Port ${this.port} is already in use`);
+                        break;
+                }
+                this.initializeError = true;
+                return;
+            });
+        }
+        else {
+            // Load the SSL certificate, the private key and optionally the CA certificate
+            let cert;
+            try {
+                cert = await fs.readFile(path.join(this.matterbridge.matterbridgeDirectory, 'certs/cert.pem'), 'utf8');
+                this.log.info(`Loaded certificate file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs/cert.pem')}`);
+            }
+            catch (error) {
+                this.log.error(`Error reading certificate file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs/cert.pem')}: ${error}`);
+                return;
+            }
+            let key;
+            try {
+                key = await fs.readFile(path.join(this.matterbridge.matterbridgeDirectory, 'certs/key.pem'), 'utf8');
+                this.log.info(`Loaded key file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs/key.pem')}`);
+            }
+            catch (error) {
+                this.log.error(`Error reading key file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs/key.pem')}: ${error}`);
+                return;
+            }
+            let ca;
+            try {
+                ca = await fs.readFile(path.join(this.matterbridge.matterbridgeDirectory, 'certs/ca.pem'), 'utf8');
+                this.log.info(`Loaded CA certificate file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs/ca.pem')}`);
+            }
+            catch (error) {
+                this.log.info(`CA certificate file ${path.join(this.matterbridge.matterbridgeDirectory, 'certs/ca.pem')} not loaded: ${error}`);
+            }
+            const serverOptions = { cert, key, ca };
+            // Create an HTTPS server with the SSL certificate and private key (ca is optional) and attach the express app
+            this.httpsServer = https.createServer(serverOptions, this.expressApp);
+            // Listen on the specified port
+            if (hasParameter('ingress')) {
+                this.httpsServer.listen(this.port, '0.0.0.0', () => {
+                    this.log.info(`The frontend https server is listening on ${UNDERLINE}https://0.0.0.0:${this.port}${UNDERLINEOFF}${rs}`);
+                });
+            }
+            else {
+                this.httpsServer.listen(this.port, () => {
+                    if (this.matterbridge.systemInformation.ipv4Address !== '')
+                        this.log.info(`The frontend https server is listening on ${UNDERLINE}https://${this.matterbridge.systemInformation.ipv4Address}:${this.port}${UNDERLINEOFF}${rs}`);
+                    if (this.matterbridge.systemInformation.ipv6Address !== '')
+                        this.log.info(`The frontend https server is listening on ${UNDERLINE}https://[${this.matterbridge.systemInformation.ipv6Address}]:${this.port}${UNDERLINEOFF}${rs}`);
+                });
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            this.httpsServer.on('error', (error) => {
+                this.log.error(`Frontend https server error listening on ${this.port}`);
+                switch (error.code) {
+                    case 'EACCES':
+                        this.log.error(`Port ${this.port} requires elevated privileges`);
+                        break;
+                    case 'EADDRINUSE':
+                        this.log.error(`Port ${this.port} is already in use`);
+                        break;
+                }
+                this.initializeError = true;
+                return;
+            });
+        }
+        if (this.initializeError)
+            return;
+        // Createe a WebSocket server and attach it to the http or https server
+        const wssPort = this.port;
+        const wssHost = hasParameter('ssl') ? `wss://${this.matterbridge.systemInformation.ipv4Address}:${wssPort}` : `ws://${this.matterbridge.systemInformation.ipv4Address}:${wssPort}`;
+        this.webSocketServer = new WebSocketServer(hasParameter('ssl') ? { server: this.httpsServer } : { server: this.httpServer });
+        this.webSocketServer.on('connection', (ws, request) => {
+            const clientIp = request.socket.remoteAddress;
+            AnsiLogger.setGlobalCallback(this.wssSendMessage.bind(this), LogLevel.DEBUG);
+            this.log.info(`WebSocketServer client "${clientIp}" connected to Matterbridge`);
+            ws.on('message', (message) => {
+                this.wsMessageHandler(ws, message);
+            });
+            ws.on('ping', () => {
+                this.log.debug('WebSocket client ping');
+                ws.pong();
+            });
+            ws.on('pong', () => {
+                this.log.debug('WebSocket client pong');
+            });
+            ws.on('close', () => {
+                this.log.info('WebSocket client disconnected');
+                if (this.webSocketServer?.clients.size === 0) {
+                    AnsiLogger.setGlobalCallback(undefined);
+                    this.log.debug('All WebSocket clients disconnected. WebSocketServer logger global callback removed');
+                }
+            });
+            ws.on('error', (error) => {
+                this.log.error(`WebSocket client error: ${error}`);
+            });
+        });
+        this.webSocketServer.on('close', () => {
+            this.log.debug(`WebSocketServer closed`);
+        });
+        this.webSocketServer.on('listening', () => {
+            this.log.info(`The WebSocketServer is listening on ${UNDERLINE}${wssHost}${UNDERLINEOFF}${rs}`);
+        });
+        this.webSocketServer.on('error', (ws, error) => {
+            this.log.error(`WebSocketServer error: ${error}`);
+        });
+        // Endpoint to validate login code
+        this.expressApp.post('/api/login', express.json(), async (req, res) => {
+            const { password } = req.body;
+            this.log.debug('The frontend sent /api/login', password);
+            if (!this.matterbridge.nodeContext) {
+                this.log.error('/api/login nodeContext not found');
+                res.json({ valid: false });
+                return;
+            }
+            try {
+                const storedPassword = await this.matterbridge.nodeContext.get('password', '');
+                if (storedPassword === '' || password === storedPassword) {
+                    this.log.debug('/api/login password valid');
+                    res.json({ valid: true });
+                }
+                else {
+                    this.log.warn('/api/login error wrong password');
+                    res.json({ valid: false });
+                }
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            }
+            catch (error) {
+                this.log.error('/api/login error getting password');
+                res.json({ valid: false });
+            }
+        });
+        // Endpoint to provide health check
+        this.expressApp.get('/health', (req, res) => {
+            this.log.debug('Express received /health');
+            const healthStatus = {
+                status: 'ok', // Indicate service is healthy
+                uptime: process.uptime(), // Server uptime in seconds
+                timestamp: new Date().toISOString(), // Current timestamp
+            };
+            res.status(200).json(healthStatus);
+        });
+        // Endpoint to provide settings
+        this.expressApp.get('/api/settings', express.json(), async (req, res) => {
+            this.log.debug('The frontend sent /api/settings');
+            this.matterbridge.matterbridgeInformation.bridgeMode = this.matterbridge.bridgeMode;
+            this.matterbridge.matterbridgeInformation.restartMode = this.matterbridge.restartMode;
+            this.matterbridge.matterbridgeInformation.loggerLevel = this.log.logLevel;
+            this.matterbridge.matterbridgeInformation.matterLoggerLevel = Logger.defaultLogLevel;
+            this.matterbridge.matterbridgeInformation.mattermdnsinterface = (await this.matterbridge.nodeContext?.get('mattermdnsinterface', '')) || '';
+            this.matterbridge.matterbridgeInformation.matteripv4address = (await this.matterbridge.nodeContext?.get('matteripv4address', '')) || '';
+            this.matterbridge.matterbridgeInformation.matteripv6address = (await this.matterbridge.nodeContext?.get('matteripv6address', '')) || '';
+            this.matterbridge.matterbridgeInformation.matterPort = (await this.matterbridge.nodeContext?.get('matterport', 5540)) ?? 5540;
+            this.matterbridge.matterbridgeInformation.matterDiscriminator = await this.matterbridge.nodeContext?.get('matterdiscriminator');
+            this.matterbridge.matterbridgeInformation.matterPasscode = await this.matterbridge.nodeContext?.get('matterpasscode');
+            this.matterbridge.matterbridgeInformation.matterbridgePaired = this.matterbridge.matterbridgePaired;
+            this.matterbridge.matterbridgeInformation.matterbridgeConnected = this.matterbridge.matterbridgeConnected;
+            this.matterbridge.matterbridgeInformation.matterbridgeQrPairingCode = this.matterbridge.matterbridgeQrPairingCode;
+            this.matterbridge.matterbridgeInformation.matterbridgeManualPairingCode = this.matterbridge.matterbridgeManualPairingCode;
+            this.matterbridge.matterbridgeInformation.matterbridgeFabricInformations = this.matterbridge.matterbridgeFabricInformations;
+            this.matterbridge.matterbridgeInformation.matterbridgeSessionInformations = Array.from(this.matterbridge.matterbridgeSessionInformations.values());
+            this.matterbridge.matterbridgeInformation.profile = this.matterbridge.profile;
+            const response = { systemInformation: this.matterbridge.systemInformation, matterbridgeInformation: this.matterbridge.matterbridgeInformation };
+            // this.log.debug('Response:', debugStringify(response));
+            res.json(response);
+        });
+        // Endpoint to provide plugins
+        this.expressApp.get('/api/plugins', async (req, res) => {
+            this.log.debug('The frontend sent /api/plugins');
+            const response = await this.getBaseRegisteredPlugins();
+            // this.log.debug('Response:', debugStringify(response));
+            res.json(response);
+        });
+        // Endpoint to provide devices
+        this.expressApp.get('/api/devices', (req, res) => {
+            this.log.debug('The frontend sent /api/devices');
+            const devices = [];
+            this.matterbridge.devices.forEach(async (device) => {
+                // Check if the device has the required properties
+                if (!device.plugin || !device.name || !device.deviceName || !device.serialNumber || !device.uniqueId)
+                    return;
+                const cluster = this.getClusterTextFromDevice(device);
+                devices.push({
+                    pluginName: device.plugin,
+                    type: device.name + ' (0x' + device.deviceType.toString(16).padStart(4, '0') + ')',
+                    endpoint: device.number,
+                    name: device.deviceName,
+                    serial: device.serialNumber,
+                    productUrl: device.productUrl,
+                    configUrl: device.configUrl,
+                    uniqueId: device.uniqueId,
+                    cluster: cluster,
+                });
+            });
+            // this.log.debug('Response:', debugStringify(data));
+            res.json(devices);
+        });
+        // Endpoint to provide the cluster servers of the devices
+        this.expressApp.get('/api/devices_clusters/:selectedPluginName/:selectedDeviceEndpoint', (req, res) => {
+            const selectedPluginName = req.params.selectedPluginName;
+            const selectedDeviceEndpoint = parseInt(req.params.selectedDeviceEndpoint, 10);
+            this.log.debug(`The frontend sent /api/devices_clusters plugin:${selectedPluginName} endpoint:${selectedDeviceEndpoint}`);
+            if (selectedPluginName === 'none') {
+                res.json([]);
+                return;
+            }
+            const data = [];
+            this.matterbridge.devices.forEach(async (device) => {
+                const pluginName = device.plugin;
+                if (pluginName === selectedPluginName && device.number === selectedDeviceEndpoint) {
+                    const endpointServer = EndpointServer.forEndpoint(device);
+                    const clusterServers = endpointServer.getAllClusterServers();
+                    clusterServers.forEach((clusterServer) => {
+                        Object.entries(clusterServer.attributes).forEach(([key, value]) => {
+                            if (clusterServer.name === 'EveHistory')
+                                return;
+                            let attributeValue;
+                            try {
+                                if (typeof value.getLocal() === 'object')
+                                    attributeValue = stringify(value.getLocal());
+                                else
+                                    attributeValue = value.getLocal().toString();
+                            }
+                            catch (error) {
+                                attributeValue = 'Fabric-Scoped';
+                                this.log.debug(`GetLocal value ${error} in clusterServer: ${clusterServer.name}(${clusterServer.id}) attribute: ${key}(${value.id})`);
+                            }
+                            data.push({
+                                endpoint: device.number ? device.number.toString() : '...',
+                                clusterName: clusterServer.name,
+                                clusterId: '0x' + clusterServer.id.toString(16).padStart(2, '0'),
+                                attributeName: key,
+                                attributeId: '0x' + value.id.toString(16).padStart(2, '0'),
+                                attributeValue,
+                            });
+                        });
+                    });
+                    endpointServer.getChildEndpoints().forEach((childEndpoint) => {
+                        const name = childEndpoint.name;
+                        const clusterServers = childEndpoint.getAllClusterServers();
+                        clusterServers.forEach((clusterServer) => {
+                            Object.entries(clusterServer.attributes).forEach(([key, value]) => {
+                                if (clusterServer.name === 'EveHistory')
+                                    return;
+                                let attributeValue;
+                                try {
+                                    if (typeof value.getLocal() === 'object')
+                                        attributeValue = stringify(value.getLocal());
+                                    else
+                                        attributeValue = value.getLocal().toString();
+                                }
+                                catch (error) {
+                                    attributeValue = 'Fabric-Scoped';
+                                    this.log.debug(`GetLocal error ${error} in clusterServer: ${clusterServer.name}(${clusterServer.id}) attribute: ${key}(${value.id})`);
+                                }
+                                data.push({
+                                    endpoint: (childEndpoint.number ? childEndpoint.number.toString() : '...') + (name ? ' (' + name + ')' : ''),
+                                    clusterName: clusterServer.name,
+                                    clusterId: '0x' + clusterServer.id.toString(16).padStart(2, '0'),
+                                    attributeName: key,
+                                    attributeId: '0x' + value.id.toString(16).padStart(2, '0'),
+                                    attributeValue,
+                                });
+                            });
+                        });
+                    });
+                }
+            });
+            res.json(data);
+        });
+        // Endpoint to view the log
+        this.expressApp.get('/api/view-log', async (req, res) => {
+            this.log.debug('The frontend sent /api/log');
+            try {
+                const data = await fs.readFile(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterbrideLoggerFile), 'utf8');
+                res.type('text/plain');
+                res.send(data);
+            }
+            catch (error) {
+                this.log.error(`Error reading log file ${this.matterbridge.matterbrideLoggerFile}: ${error instanceof Error ? error.message : error}`);
+                res.status(500).send('Error reading log file');
+            }
+        });
+        // Endpoint to download the matterbridge log
+        this.expressApp.get('/api/download-mblog', async (req, res) => {
+            this.log.debug('The frontend sent /api/download-mblog');
+            try {
+                await fs.access(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterbrideLoggerFile), fs.constants.F_OK);
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            }
+            catch (error) {
+                fs.appendFile(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterbrideLoggerFile), 'Enable the log on file in the settings to enable the file logger');
+            }
+            res.download(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterbrideLoggerFile), 'matterbridge.log', (error) => {
+                if (error) {
+                    this.log.error(`Error downloading log file ${this.matterbridge.matterbrideLoggerFile}: ${error instanceof Error ? error.message : error}`);
+                    res.status(500).send('Error downloading the matterbridge log file');
+                }
+            });
+        });
+        // Endpoint to download the matter log
+        this.expressApp.get('/api/download-mjlog', async (req, res) => {
+            this.log.debug('The frontend sent /api/download-mjlog');
+            try {
+                await fs.access(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterLoggerFile), fs.constants.F_OK);
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            }
+            catch (error) {
+                fs.appendFile(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterLoggerFile), 'Enable the log on file in the settings to enable the file logger');
+            }
+            res.download(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterLoggerFile), 'matter.log', (error) => {
+                if (error) {
+                    this.log.error(`Error downloading log file ${this.matterbridge.matterLoggerFile}: ${error instanceof Error ? error.message : error}`);
+                    res.status(500).send('Error downloading the matter log file');
+                }
+            });
+        });
+        // Endpoint to download the matter storage file
+        this.expressApp.get('/api/download-mjstorage', (req, res) => {
+            this.log.debug('The frontend sent /api/download-mjstorage');
+            res.download(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterStorageName), 'matterbridge.json', (error) => {
+                if (error) {
+                    this.log.error(`Error downloading log file ${this.matterbridge.matterStorageName}: ${error instanceof Error ? error.message : error}`);
+                    res.status(500).send('Error downloading the matter storage file');
+                }
+            });
+        });
+        // Endpoint to download the matterbridge storage directory
+        this.expressApp.get('/api/download-mbstorage', async (req, res) => {
+            this.log.debug('The frontend sent /api/download-mbstorage');
+            await createZip(path.join(os.tmpdir(), `matterbridge.${this.matterbridge.nodeStorageName}.zip`), path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.nodeStorageName));
+            res.download(path.join(os.tmpdir(), `matterbridge.${this.matterbridge.nodeStorageName}.zip`), `matterbridge.${this.matterbridge.nodeStorageName}.zip`, (error) => {
+                if (error) {
+                    this.log.error(`Error downloading file ${`matterbridge.${this.matterbridge.nodeStorageName}.zip`}: ${error instanceof Error ? error.message : error}`);
+                    res.status(500).send('Error downloading the matterbridge storage file');
+                }
+            });
+        });
+        // Endpoint to download the matterbridge plugin directory
+        this.expressApp.get('/api/download-pluginstorage', async (req, res) => {
+            this.log.debug('The frontend sent /api/download-pluginstorage');
+            await createZip(path.join(os.tmpdir(), `matterbridge.pluginstorage.zip`), this.matterbridge.matterbridgePluginDirectory);
+            res.download(path.join(os.tmpdir(), `matterbridge.pluginstorage.zip`), `matterbridge.pluginstorage.zip`, (error) => {
+                if (error) {
+                    this.log.error(`Error downloading file matterbridge.pluginstorage.zip: ${error instanceof Error ? error.message : error}`);
+                    res.status(500).send('Error downloading the matterbridge plugin storage file');
+                }
+            });
+        });
+        // Endpoint to download the matterbridge plugin config files
+        this.expressApp.get('/api/download-pluginconfig', async (req, res) => {
+            this.log.debug('The frontend sent /api/download-pluginconfig');
+            await createZip(path.join(os.tmpdir(), `matterbridge.pluginconfig.zip`), path.relative(process.cwd(), path.join(this.matterbridge.matterbridgeDirectory, '*.config.json')));
+            // await createZip(path.join(os.tmpdir(), `matterbridge.pluginconfig.zip`), path.relative(process.cwd(), path.join(this.matterbridge.matterbridgeDirectory, 'certs', '*.*')), path.relative(process.cwd(), path.join(this.matterbridge.matterbridgeDirectory, '*.config.json')));
+            res.download(path.join(os.tmpdir(), `matterbridge.pluginconfig.zip`), `matterbridge.pluginconfig.zip`, (error) => {
+                if (error) {
+                    this.log.error(`Error downloading file matterbridge.pluginstorage.zip: ${error instanceof Error ? error.message : error}`);
+                    res.status(500).send('Error downloading the matterbridge plugin storage file');
+                }
+            });
+        });
+        // Endpoint to download the matterbridge plugin config files
+        this.expressApp.get('/api/download-backup', async (req, res) => {
+            this.log.debug('The frontend sent /api/download-backup');
+            res.download(path.join(os.tmpdir(), `matterbridge.backup.zip`), `matterbridge.backup.zip`, (error) => {
+                if (error) {
+                    this.log.error(`Error downloading file matterbridge.backup.zip: ${error instanceof Error ? error.message : error}`);
+                    res.status(500).send(`Error downloading file matterbridge.backup.zip: ${error instanceof Error ? error.message : error}`);
+                }
+            });
+        });
+        // Endpoint to receive commands
+        this.expressApp.post('/api/command/:command/:param', express.json(), async (req, res) => {
+            const command = req.params.command;
+            let param = req.params.param;
+            this.log.debug(`The frontend sent /api/command/${command}/${param}`);
+            if (!command) {
+                res.status(400).json({ error: 'No command provided' });
+                return;
+            }
+            this.log.debug(`Received frontend command: ${command}:${param}`);
+            // Handle the command setpassword from Settings
+            if (command === 'setpassword') {
+                const password = param.slice(1, -1); // Remove the first and last characters
+                this.log.debug('setpassword', param, password);
+                await this.matterbridge.nodeContext?.set('password', password);
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command setbridgemode from Settings
+            if (command === 'setbridgemode') {
+                this.log.debug(`setbridgemode: ${param}`);
+                this.wssSendRestartRequired();
+                await this.matterbridge.nodeContext?.set('bridgeMode', param);
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command backup from Settings
+            if (command === 'backup') {
+                this.log.notice(`Prepairing the backup...`);
+                await createZip(path.join(os.tmpdir(), `matterbridge.backup.zip`), path.join(this.matterbridge.matterbridgeDirectory), path.join(this.matterbridge.matterbridgePluginDirectory));
+                this.log.notice(`Backup ready to be downloaded.`);
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command setmbloglevel from Settings
+            if (command === 'setmbloglevel') {
+                this.log.debug('Matterbridge log level:', param);
+                if (param === 'Debug') {
+                    this.log.logLevel = LogLevel.DEBUG;
+                }
+                else if (param === 'Info') {
+                    this.log.logLevel = LogLevel.INFO;
+                }
+                else if (param === 'Notice') {
+                    this.log.logLevel = LogLevel.NOTICE;
+                }
+                else if (param === 'Warn') {
+                    this.log.logLevel = LogLevel.WARN;
+                }
+                else if (param === 'Error') {
+                    this.log.logLevel = LogLevel.ERROR;
+                }
+                else if (param === 'Fatal') {
+                    this.log.logLevel = LogLevel.FATAL;
+                }
+                await this.matterbridge.nodeContext?.set('matterbridgeLogLevel', this.log.logLevel);
+                MatterbridgeEndpoint.logLevel = this.log.logLevel;
+                this.matterbridge.plugins.logLevel = this.log.logLevel;
+                for (const plugin of this.matterbridge.plugins) {
+                    if (!plugin.platform || !plugin.platform.config)
+                        continue;
+                    plugin.platform.log.logLevel = plugin.platform.config.debug ? LogLevel.DEBUG : this.log.logLevel;
+                    await plugin.platform.onChangeLoggerLevel(plugin.platform.config.debug ? LogLevel.DEBUG : this.log.logLevel);
+                }
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command setmbloglevel from Settings
+            if (command === 'setmjloglevel') {
+                this.log.debug('Matter.js log level:', param);
+                if (param === 'Debug') {
+                    Logger.defaultLogLevel = MatterLogLevel.DEBUG;
+                }
+                else if (param === 'Info') {
+                    Logger.defaultLogLevel = MatterLogLevel.INFO;
+                }
+                else if (param === 'Notice') {
+                    Logger.defaultLogLevel = MatterLogLevel.NOTICE;
+                }
+                else if (param === 'Warn') {
+                    Logger.defaultLogLevel = MatterLogLevel.WARN;
+                }
+                else if (param === 'Error') {
+                    Logger.defaultLogLevel = MatterLogLevel.ERROR;
+                }
+                else if (param === 'Fatal') {
+                    Logger.defaultLogLevel = MatterLogLevel.FATAL;
+                }
+                await this.matterbridge.nodeContext?.set('matterLogLevel', Logger.defaultLogLevel);
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command setmdnsinterface from Settings
+            if (command === 'setmdnsinterface') {
+                param = param.slice(1, -1); // Remove the first and last characters *mdns*
+                this.matterbridge.matterbridgeInformation.mattermdnsinterface = param;
+                this.log.debug('Matter.js mdns interface:', param === '' ? 'All interfaces' : param);
+                await this.matterbridge.nodeContext?.set('mattermdnsinterface', param);
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command setipv4address from Settings
+            if (command === 'setipv4address') {
+                param = param.slice(1, -1); // Remove the first and last characters *ip*
+                this.matterbridge.matterbridgeInformation.matteripv4address = param;
+                this.log.debug('Matter.js ipv4 address:', param === '' ? 'All ipv4 addresses' : param);
+                await this.matterbridge.nodeContext?.set('matteripv4address', param);
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command setipv6address from Settings
+            if (command === 'setipv6address') {
+                param = param.slice(1, -1); // Remove the first and last characters *ip*
+                this.matterbridge.matterbridgeInformation.matteripv6address = param;
+                this.log.debug('Matter.js ipv6 address:', param === '' ? 'All ipv6 addresses' : param);
+                await this.matterbridge.nodeContext?.set('matteripv6address', param);
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command setmatterport from Settings
+            if (command === 'setmatterport') {
+                const port = Math.min(Math.max(parseInt(param), 5540), 5560);
+                this.matterbridge.matterbridgeInformation.matterPort = port;
+                this.log.debug(`Set matter commissioning port to ${CYAN}${port}${db}`);
+                await this.matterbridge.nodeContext?.set('matterport', port);
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command setmatterdiscriminator from Settings
+            if (command === 'setmatterdiscriminator') {
+                const discriminator = Math.min(Math.max(parseInt(param), 1000), 4095);
+                this.matterbridge.matterbridgeInformation.matterDiscriminator = discriminator;
+                this.log.debug(`Set matter commissioning discriminator to ${CYAN}${discriminator}${db}`);
+                await this.matterbridge.nodeContext?.set('matterdiscriminator', discriminator);
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command setmatterpasscode from Settings
+            if (command === 'setmatterpasscode') {
+                const passcode = Math.min(Math.max(parseInt(param), 10000000), 90000000);
+                this.matterbridge.matterbridgeInformation.matterPasscode = passcode;
+                this.log.debug(`Set matter commissioning passcode to ${CYAN}${passcode}${db}`);
+                await this.matterbridge.nodeContext?.set('matterpasscode', passcode);
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command setmbloglevel from Settings
+            if (command === 'setmblogfile') {
+                this.log.debug('Matterbridge file log:', param);
+                this.matterbridge.matterbridgeInformation.fileLogger = param === 'true';
+                await this.matterbridge.nodeContext?.set('matterbridgeFileLog', param === 'true');
+                // Create the file logger for matterbridge
+                if (param === 'true')
+                    AnsiLogger.setGlobalLogfile(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterbrideLoggerFile), LogLevel.DEBUG, true);
+                else
+                    AnsiLogger.setGlobalLogfile(undefined);
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command setmbloglevel from Settings
+            if (command === 'setmjlogfile') {
+                this.log.debug('Matter file log:', param);
+                this.matterbridge.matterbridgeInformation.matterFileLogger = param === 'true';
+                await this.matterbridge.nodeContext?.set('matterFileLog', param === 'true');
+                if (param === 'true') {
+                    try {
+                        Logger.addLogger('matterfilelogger', await this.matterbridge.createMatterFileLogger(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterLoggerFile), true), {
+                            defaultLogLevel: MatterLogLevel.DEBUG,
+                            logFormat: MatterLogFormat.PLAIN,
+                        });
+                    }
+                    catch (error) {
+                        this.log.debug(`Error adding the matterfilelogger for file ${CYAN}${path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterLoggerFile)}${er}: ${error instanceof Error ? error.message : error}`);
+                    }
+                }
+                else {
+                    try {
+                        Logger.removeLogger('matterfilelogger');
+                    }
+                    catch (error) {
+                        this.log.debug(`Error removing the matterfilelogger for file ${CYAN}${path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterLoggerFile)}${er}: ${error instanceof Error ? error.message : error}`);
+                    }
+                }
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command unregister from Settings
+            if (command === 'unregister') {
+                await this.matterbridge.unregisterAndShutdownProcess();
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command reset from Settings
+            if (command === 'reset') {
+                await this.matterbridge.shutdownProcessAndReset();
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command factoryreset from Settings
+            if (command === 'factoryreset') {
+                await this.matterbridge.shutdownProcessAndFactoryReset();
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command shutdown from Header
+            if (command === 'shutdown') {
+                await this.matterbridge.shutdownProcess();
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command restart from Header
+            if (command === 'restart') {
+                await this.matterbridge.restartProcess();
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command update from Header
+            if (command === 'update') {
+                this.log.info('Updating matterbridge...');
+                try {
+                    await this.matterbridge.spawnCommand('npm', ['install', '-g', 'matterbridge', '--omit=dev', '--verbose']);
+                    this.log.info('Matterbridge has been updated. Full restart required.');
+                    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                }
+                catch (error) {
+                    this.log.error('Error updating matterbridge');
+                }
+                await this.matterbridge.updateProcess();
+                this.wssSendRestartRequired();
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command saveconfig from Home
+            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));
+                if (!this.matterbridge.plugins.has(param)) {
+                    this.log.warn(`Plugin ${plg}${param}${wr} not found in matterbridge`);
+                }
+                else {
+                    const plugin = this.matterbridge.plugins.get(param);
+                    if (!plugin)
+                        return;
+                    this.matterbridge.plugins.saveConfigFromJson(plugin, req.body);
+                }
+                this.wssSendRestartRequired();
+                res.json({ message: 'Command received' });
+                return;
+            }
+            // Handle the command installplugin from Home
+            if (command === 'installplugin') {
+                param = param.replace(/\*/g, '\\');
+                this.log.info(`Installing plugin ${plg}${param}${nf}...`);
+                try {
+                    await this.matterbridge.spawnCommand('npm', ['install', '-g', param, '--omit=dev', '--verbose']);
+                    this.log.info(`Plugin ${plg}${param}${nf} installed. Full restart required.`);
+                    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                }
+                catch (error) {
+                    this.log.error(`Error installing plugin ${plg}${param}${er}`);
+                }
+                this.wssSendRestartRequired();
+                param = param.split('@')[0];
+                // Also add the plugin to matterbridge so no return!
+                if (param === 'matterbridge') {
+                    // If we used the command installplugin to install a dev or a specific version of matterbridge we don't want to add it to matterbridge
+                    res.json({ message: 'Command received' });
+                    return;
+                }
+            }
+            // Handle the command addplugin from Home
+            if (command === 'addplugin' || command === 'installplugin') {
+                param = param.replace(/\*/g, '\\');
+                const plugin = await this.matterbridge.plugins.add(param);
+                if (plugin) {
+                    if (this.matterbridge.bridgeMode === 'childbridge') {
+                        // We don't know now if the plugin is a dynamic platform or an accessory platform so we create the server node and the aggregator node
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        this.matterbridge.createDynamicPlugin(plugin, true);
+                    }
+                    this.matterbridge.plugins.load(plugin, true, 'The plugin has been added', true); // No await do it in the background
+                }
+                res.json({ message: 'Command received' });
+                this.wssSendRefreshRequired();
+                return;
+            }
+            // Handle the command removeplugin from Home
+            if (command === 'removeplugin') {
+                if (!this.matterbridge.plugins.has(param)) {
+                    this.log.warn(`Plugin ${plg}${param}${wr} not found in matterbridge`);
+                }
+                else {
+                    const plugin = this.matterbridge.plugins.get(param);
+                    await this.matterbridge.plugins.shutdown(plugin, 'The plugin has been removed.', true); // This will also close the server node in childbridge mode
+                    await this.matterbridge.plugins.remove(param);
+                }
+                res.json({ message: 'Command received' });
+                this.wssSendRefreshRequired();
+                return;
+            }
+            // Handle the command enableplugin from Home
+            if (command === 'enableplugin') {
+                if (!this.matterbridge.plugins.has(param)) {
+                    this.log.warn(`Plugin ${plg}${param}${wr} not found in matterbridge`);
+                }
+                else {
+                    const plugin = this.matterbridge.plugins.get(param);
+                    if (plugin && !plugin.enabled) {
+                        plugin.locked = undefined;
+                        plugin.error = undefined;
+                        plugin.loaded = undefined;
+                        plugin.started = undefined;
+                        plugin.configured = undefined;
+                        plugin.connected = undefined;
+                        plugin.platform = undefined;
+                        plugin.registeredDevices = undefined;
+                        plugin.addedDevices = undefined;
+                        await this.matterbridge.plugins.enable(param);
+                        if (this.matterbridge.bridgeMode === 'childbridge' && plugin.type === 'DynamicPlatform') {
+                            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                            this.matterbridge.createDynamicPlugin(plugin, true);
+                        }
+                        this.matterbridge.plugins.load(plugin, true, 'The plugin has been enabled', true); // No await do it in the background since the server node is already started
+                    }
+                }
+                res.json({ message: 'Command received' });
+                this.wssSendRefreshRequired();
+                return;
+            }
+            // Handle the command disableplugin from Home
+            if (command === 'disableplugin') {
+                if (!this.matterbridge.plugins.has(param)) {
+                    this.log.warn(`Plugin ${plg}${param}${wr} not found in matterbridge`);
+                }
+                else {
+                    const plugin = this.matterbridge.plugins.get(param);
+                    if (plugin && plugin.enabled) {
+                        await this.matterbridge.plugins.shutdown(plugin, 'The plugin has been disabled.', true); // This will also close the server node in childbridge mode
+                        await this.matterbridge.plugins.disable(param);
+                    }
+                }
+                res.json({ message: 'Command received' });
+                this.wssSendRefreshRequired();
+                return;
+            }
+        });
+        // Fallback for routing (must be the last route)
+        this.expressApp.get('*', (req, res) => {
+            this.log.debug('The frontend sent:', req.url);
+            this.log.debug('Response send file:', path.join(this.matterbridge.rootDirectory, 'frontend/build/index.html'));
+            res.sendFile(path.join(this.matterbridge.rootDirectory, 'frontend/build/index.html'));
+        });
+        this.log.debug(`Frontend initialized on port ${YELLOW}${this.port}${db} static ${UNDERLINE}${path.join(this.matterbridge.rootDirectory, 'frontend/build')}${UNDERLINEOFF}${rs}`);
+    }
+    async stop() {
+        // Close the http server
+        if (this.httpServer) {
+            this.httpServer.close();
+            this.httpServer.removeAllListeners();
+            this.httpServer = undefined;
+            this.log.debug('Frontend http server closed successfully');
+        }
+        // Close the https server
+        if (this.httpsServer) {
+            this.httpsServer.close();
+            this.httpsServer.removeAllListeners();
+            this.httpsServer = undefined;
+            this.log.debug('Frontend https server closed successfully');
+        }
+        // Remove listeners from the express app
+        if (this.expressApp) {
+            this.expressApp.removeAllListeners();
+            this.expressApp = undefined;
+            this.log.debug('Frontend app closed successfully');
+        }
+        // Close the WebSocket server
+        if (this.webSocketServer) {
+            // Close all active connections
+            this.webSocketServer.clients.forEach((client) => {
+                if (client.readyState === WebSocket.OPEN) {
+                    client.close();
+                }
+            });
+            this.webSocketServer.close((error) => {
+                if (error) {
+                    this.log.error(`Error closing WebSocket server: ${error}`);
+                }
+                else {
+                    this.log.debug('WebSocket server closed successfully');
+                }
+            });
+            this.webSocketServer = undefined;
+        }
+    }
+    /**
+     * Retrieves the cluster text description from a given device.
+     * @param {MatterbridgeDevice} device - The MatterbridgeDevice object.
+     * @returns {string} The attributes description of the cluster servers in the device.
+     */
+    getClusterTextFromDevice(device) {
+        const getAttribute = (device, cluster, attribute) => {
+            let value = undefined;
+            Object.entries(device.state)
+                .filter(([clusterName]) => clusterName.toLowerCase() === cluster.toLowerCase())
+                .forEach(([, clusterAttributes]) => {
+                Object.entries(clusterAttributes)
+                    .filter(([attributeName]) => attributeName.toLowerCase() === attribute.toLowerCase())
+                    .forEach(([, attributeValue]) => {
+                    value = attributeValue;
+                });
+            });
+            if (value === undefined)
+                this.log.error(`Cluster ${cluster} or attribute ${attribute} not found in device ${device.deviceName}`);
+            return value;
+        };
+        const getUserLabel = (device) => {
+            const labelList = getAttribute(device, 'userLabel', 'labelList');
+            if (!labelList)
+                return;
+            const composed = labelList.find((entry) => entry.label === 'composed');
+            if (composed)
+                return 'Composed: ' + composed.value;
+            else
+                return '';
+        };
+        const getFixedLabel = (device) => {
+            const labelList = getAttribute(device, 'fixedLabel', 'labelList');
+            if (!labelList)
+                return;
+            const composed = labelList.find((entry) => entry.label === 'composed');
+            if (composed)
+                return 'Composed: ' + composed.value;
+            else
+                return '';
+        };
+        let attributes = '';
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        Object.entries(device.state).forEach(([clusterName, clusterAttributes]) => {
+            Object.entries(clusterAttributes).forEach(([attributeName, attributeValue]) => {
+                // console.log(`Cluster: ${clusterName} Attribute: ${attributeName} Value: ${attributeValue}`);
+                if (clusterName === 'onOff' && attributeName === 'onOff')
+                    attributes += `OnOff: ${attributeValue} `;
+                if (clusterName === 'switch' && attributeName === 'currentPosition')
+                    attributes += `Position: ${attributeValue} `;
+                if (clusterName === 'windowCovering' && attributeName === 'currentPositionLiftPercent100ths')
+                    attributes += `Cover position: ${attributeValue / 100}% `;
+                if (clusterName === 'doorLock' && attributeName === 'lockState')
+                    attributes += `State: ${attributeValue === 1 ? 'Locked' : 'Not locked'} `;
+                if (clusterName === 'thermostat' && attributeName === 'localTemperature')
+                    attributes += `Temperature: ${attributeValue / 100}°C `;
+                if (clusterName === 'thermostat' && attributeName === 'occupiedHeatingSetpoint')
+                    attributes += `Heat to: ${attributeValue / 100}°C `;
+                if (clusterName === 'thermostat' && attributeName === 'occupiedCoolingSetpoint')
+                    attributes += `Cool to: ${attributeValue / 100}°C `;
+                if (clusterName === 'pumpConfigurationAndControl' && attributeName === 'operationMode')
+                    attributes += `Mode: ${attributeValue} `;
+                if (clusterName === 'valveConfigurationAndControl' && attributeName === 'currentState')
+                    attributes += `State: ${attributeValue} `;
+                if (clusterName === 'levelControl' && attributeName === 'currentLevel')
+                    attributes += `Level: ${attributeValue}% `;
+                if (clusterName === 'colorControl' && attributeName === 'colorMode')
+                    attributes += `Mode: ${['HS', 'XY', 'CT'][attributeValue]} `;
+                if (clusterName === 'colorControl' && getAttribute(device, 'colorControl', 'colorMode') === 0 && attributeName === 'currentHue')
+                    attributes += `Hue: ${Math.round(attributeValue)} `;
+                if (clusterName === 'colorControl' && getAttribute(device, 'colorControl', 'colorMode') === 0 && attributeName === 'currentSaturation')
+                    attributes += `Saturation: ${Math.round(attributeValue)} `;
+                if (clusterName === 'colorControl' && getAttribute(device, 'colorControl', 'colorMode') === 1 && attributeName === 'currentX')
+                    attributes += `X: ${Math.round(attributeValue)} `;
+                if (clusterName === 'colorControl' && getAttribute(device, 'colorControl', 'colorMode') === 1 && attributeName === 'currentY')
+                    attributes += `Y: ${Math.round(attributeValue)} `;
+                if (clusterName === 'colorControl' && getAttribute(device, 'colorControl', 'colorMode') === 2 && attributeName === 'colorTemperatureMireds')
+                    attributes += `ColorTemp: ${Math.round(attributeValue)} `;
+                if (clusterName === 'booleanState' && attributeName === 'stateValue')
+                    attributes += `Contact: ${attributeValue} `;
+                if (clusterName === 'booleanStateConfiguration' && attributeName === 'alarmsActive')
+                    attributes += `Active alarms: ${stringify(attributeValue)} `;
+                if (clusterName === 'smokeCoAlarm' && attributeName === 'smokeState')
+                    attributes += `Smoke: ${attributeValue} `;
+                if (clusterName === 'smokeCoAlarm' && attributeName === 'coState')
+                    attributes += `Co: ${attributeValue} `;
+                if (clusterName === 'fanControl' && attributeName === 'fanMode')
+                    attributes += `Mode: ${attributeValue} `;
+                if (clusterName === 'fanControl' && attributeName === 'percentCurrent')
+                    attributes += `Percent: ${attributeValue} `;
+                if (clusterName === 'fanControl' && attributeName === 'speedCurrent')
+                    attributes += `Speed: ${attributeValue} `;
+                if (clusterName === 'occupancySensing' && attributeName === 'occupancy')
+                    attributes += `Occupancy: ${attributeValue.occupied} `;
+                if (clusterName === 'illuminanceMeasurement' && attributeName === 'measuredValue')
+                    attributes += `Illuminance: ${attributeValue} `;
+                if (clusterName === 'airQuality' && attributeName === 'airQuality')
+                    attributes += `Air quality: ${attributeValue} `;
+                if (clusterName === 'tvocMeasurement' && attributeName === 'measuredValue')
+                    attributes += `Voc: ${attributeValue} `;
+                if (clusterName === 'temperatureMeasurement' && attributeName === 'measuredValue')
+                    attributes += `Temperature: ${attributeValue / 100}°C `;
+                if (clusterName === 'relativeHumidityMeasurement' && attributeName === 'measuredValue')
+                    attributes += `Humidity: ${attributeValue / 100}% `;
+                if (clusterName === 'pressureMeasurement' && attributeName === 'measuredValue')
+                    attributes += `Pressure: ${attributeValue} `;
+                if (clusterName === 'flowMeasurement' && attributeName === 'measuredValue')
+                    attributes += `Flow: ${attributeValue} `;
+                if (clusterName === 'fixedLabel' && attributeName === 'labelList')
+                    attributes += `${getFixedLabel(device)} `;
+                if (clusterName === 'userLabel' && attributeName === 'labelList')
+                    attributes += `${getUserLabel(device)} `;
+            });
+        });
+        return attributes.trimStart().trimEnd();
+    }
+    /**
+     * Retrieves the base registered plugins sanitized for res.json().
+     * @returns {BaseRegisteredPlugin[]} A promise that resolves to an array of BaseRegisteredPlugin objects.
+     */
+    async getBaseRegisteredPlugins() {
+        const baseRegisteredPlugins = [];
+        for (const plugin of this.matterbridge.plugins) {
+            baseRegisteredPlugins.push({
+                path: plugin.path,
+                type: plugin.type,
+                name: plugin.name,
+                version: plugin.version,
+                description: plugin.description,
+                author: plugin.author,
+                latestVersion: plugin.latestVersion,
+                locked: plugin.locked,
+                error: plugin.error,
+                enabled: plugin.enabled,
+                loaded: plugin.loaded,
+                started: plugin.started,
+                configured: plugin.configured,
+                paired: plugin.paired,
+                connected: plugin.connected,
+                fabricInformations: plugin.fabricInformations,
+                sessionInformations: plugin.sessionInformations,
+                registeredDevices: plugin.registeredDevices,
+                addedDevices: plugin.addedDevices,
+                qrPairingCode: plugin.qrPairingCode,
+                manualPairingCode: plugin.manualPairingCode,
+                configJson: plugin.configJson,
+                schemaJson: plugin.schemaJson,
+            });
+        }
+        return baseRegisteredPlugins;
+    }
+    /**
+     * Handles incoming websocket messages for the Matterbridge.
+     *
+     * @param {Matterbridge} this - The Matterbridge instance.
+     * @param {WebSocket} client - The websocket client that sent the message.
+     * @param {WebSocket.RawData} message - The raw data of the message received from the client.
+     * @returns {Promise<void>} A promise that resolves when the message has been handled.
+     */
+    async wsMessageHandler(client, message) {
+        let data;
+        try {
+            data = JSON.parse(message.toString());
+            if (!isValidNumber(data.id) || !isValidString(data.dst) || !isValidString(data.src) || !isValidString(data.method) || !isValidObject(data.params) || data.dst !== 'Matterbridge') {
+                this.log.error(`Invalid message from websocket client: ${debugStringify(data)}`);
+                client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Invalid message' }));
+                return;
+            }
+            this.log.debug(`Received message from websocket client: ${debugStringify(data)}`);
+            if (data.method === 'ping') {
+                client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, response: 'pong' }));
+                return;
+            }
+            else if (data.method === '/api/login') {
+                if (!this.matterbridge.nodeContext) {
+                    this.log.error('Login nodeContext not found');
+                    client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Internal error: nodeContext not found' }));
+                    return;
+                }
+                const storedPassword = await this.matterbridge.nodeContext.get('password', '');
+                if (storedPassword === '' || storedPassword === data.params.password) {
+                    this.log.debug('Login password valid');
+                    client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, response: { valid: true } }));
+                    return;
+                }
+                else {
+                    this.log.debug('Error wrong password');
+                    client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Wrong password' }));
+                    return;
+                }
+            }
+            else if (data.method === '/api/install') {
+                if (!isValidString(data.params.packageName, 10)) {
+                    client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Wrong parameter packageName in /api/install' }));
+                    return;
+                }
+                this.matterbridge
+                    .spawnCommand('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 }));
+                })
+                    .catch((error) => {
+                    client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: error instanceof Error ? error.message : error }));
+                });
+                return;
+            }
+            else if (data.method === '/api/uninstall') {
+                if (!isValidString(data.params.packageName, 10)) {
+                    client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Wrong parameter packageName in /api/uninstall' }));
+                    return;
+                }
+                this.matterbridge
+                    .spawnCommand('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 }));
+                })
+                    .catch((error) => {
+                    client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: error instanceof Error ? error.message : error }));
+                });
+                return;
+            }
+            else if (data.method === '/api/restart') {
+                await this.matterbridge.restartProcess();
+                return;
+            }
+            else if (data.method === '/api/shutdown') {
+                await this.matterbridge.shutdownProcess();
+                return;
+            }
+            else if (data.method === '/api/settings') {
+                this.matterbridge.matterbridgeInformation.bridgeMode = this.matterbridge.bridgeMode;
+                this.matterbridge.matterbridgeInformation.restartMode = this.matterbridge.restartMode;
+                this.matterbridge.matterbridgeInformation.loggerLevel = this.log.logLevel;
+                this.matterbridge.matterbridgeInformation.matterLoggerLevel = Logger.defaultLogLevel;
+                this.matterbridge.matterbridgeInformation.mattermdnsinterface = (await this.matterbridge.nodeContext?.get('mattermdnsinterface', '')) || '';
+                this.matterbridge.matterbridgeInformation.matteripv4address = (await this.matterbridge.nodeContext?.get('matteripv4address', '')) || '';
+                this.matterbridge.matterbridgeInformation.matteripv6address = (await this.matterbridge.nodeContext?.get('matteripv6address', '')) || '';
+                this.matterbridge.matterbridgeInformation.matterPort = (await this.matterbridge.nodeContext?.get('matterport', 5540)) ?? 5540;
+                this.matterbridge.matterbridgeInformation.matterDiscriminator = await this.matterbridge.nodeContext?.get('matterdiscriminator');
+                this.matterbridge.matterbridgeInformation.matterPasscode = await this.matterbridge.nodeContext?.get('matterpasscode');
+                this.matterbridge.matterbridgeInformation.matterbridgePaired = this.matterbridge.matterbridgePaired;
+                this.matterbridge.matterbridgeInformation.matterbridgeConnected = this.matterbridge.matterbridgeConnected;
+                this.matterbridge.matterbridgeInformation.matterbridgeQrPairingCode = this.matterbridge.matterbridgeQrPairingCode;
+                this.matterbridge.matterbridgeInformation.matterbridgeManualPairingCode = this.matterbridge.matterbridgeManualPairingCode;
+                this.matterbridge.matterbridgeInformation.matterbridgeFabricInformations = this.matterbridge.matterbridgeFabricInformations;
+                this.matterbridge.matterbridgeInformation.matterbridgeSessionInformations = Array.from(this.matterbridge.matterbridgeSessionInformations.values());
+                this.matterbridge.matterbridgeInformation.profile = this.matterbridge.profile;
+                const response = { systemInformation: this.matterbridge.systemInformation, matterbridgeInformation: this.matterbridge.matterbridgeInformation };
+                client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, response }));
+                return;
+            }
+            else if (data.method === '/api/plugins') {
+                const response = await this.getBaseRegisteredPlugins();
+                client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, response }));
+                return;
+            }
+            else if (data.method === '/api/devices') {
+                const devices = [];
+                this.matterbridge.devices.forEach(async (device) => {
+                    // Filter by pluginName if provided
+                    if (data.params.pluginName && data.params.pluginName !== device.plugin)
+                        return;
+                    // Check if the device has the required properties
+                    if (!device.plugin || !device.name || !device.deviceName || !device.serialNumber || !device.uniqueId)
+                        return;
+                    const cluster = this.getClusterTextFromDevice(device);
+                    devices.push({
+                        pluginName: device.plugin,
+                        type: device.name + ' (0x' + device.deviceType.toString(16).padStart(4, '0') + ')',
+                        endpoint: device.number,
+                        name: device.deviceName,
+                        serial: device.serialNumber,
+                        productUrl: device.productUrl,
+                        configUrl: device.configUrl,
+                        uniqueId: device.uniqueId,
+                        cluster: cluster,
+                    });
+                });
+                client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, response: devices }));
+                return;
+            }
+            else if (data.method === '/api/clusters') {
+                if (!isValidString(data.params.plugin, 10)) {
+                    client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Wrong parameter plugin in /api/clusters' }));
+                    return;
+                }
+                if (!isValidNumber(data.params.endpoint, 1)) {
+                    client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Wrong parameter endpoint in /api/clusters' }));
+                    return;
+                }
+                const clusters = [];
+                let deviceName = '';
+                let serialNumber = '';
+                let deviceTypes = [];
+                this.matterbridge.devices.forEach(async (device) => {
+                    if (data.params.plugin !== device.plugin)
+                        return;
+                    if (data.params.endpoint !== device.number)
+                        return;
+                    deviceName = device.deviceName ?? 'Unknown';
+                    serialNumber = device.serialNumber ?? 'Unknown';
+                    deviceTypes = [];
+                    const endpointServer = EndpointServer.forEndpoint(device);
+                    const clusterServers = endpointServer.getAllClusterServers();
+                    clusterServers.forEach((clusterServer) => {
+                        Object.entries(clusterServer.attributes).forEach(([key, value]) => {
+                            if (clusterServer.name === 'EveHistory')
+                                return;
+                            if (clusterServer.name === 'Descriptor' && key === 'deviceTypeList') {
+                                value.getLocal().forEach((deviceType) => {
+                                    deviceTypes.push(deviceType.deviceType);
+                                });
+                            }
+                            let attributeValue;
+                            let attributeLocalValue;
+                            try {
+                                if (typeof value.getLocal() === 'object')
+                                    attributeValue = stringify(value.getLocal());
+                                else
+                                    attributeValue = value.getLocal().toString();
+                                attributeLocalValue = value.getLocal();
+                            }
+                            catch (error) {
+                                attributeValue = 'Fabric-Scoped';
+                                attributeLocalValue = 'Fabric-Scoped';
+                                this.log.debug(`GetLocal value ${error} in clusterServer: ${clusterServer.name}(${clusterServer.id}) attribute: ${key}(${value.id})`);
+                            }
+                            clusters.push({
+                                endpoint: device.number ? device.number.toString() : '...',
+                                id: 'main',
+                                deviceTypes,
+                                clusterName: clusterServer.name,
+                                clusterId: '0x' + clusterServer.id.toString(16).padStart(2, '0'),
+                                attributeName: key,
+                                attributeId: '0x' + value.id.toString(16).padStart(2, '0'),
+                                attributeValue,
+                                attributeLocalValue,
+                            });
+                        });
+                    });
+                    endpointServer.getChildEndpoints().forEach((childEndpoint) => {
+                        deviceTypes = [];
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        const name = childEndpoint.endpoint?.id;
+                        const clusterServers = childEndpoint.getAllClusterServers();
+                        clusterServers.forEach((clusterServer) => {
+                            Object.entries(clusterServer.attributes).forEach(([key, value]) => {
+                                if (clusterServer.name === 'EveHistory')
+                                    return;
+                                if (clusterServer.name === 'Descriptor' && key === 'deviceTypeList') {
+                                    value.getLocal().forEach((deviceType) => {
+                                        deviceTypes.push(deviceType.deviceType);
+                                    });
+                                }
+                                let attributeValue;
+                                let attributeLocalValue;
+                                try {
+                                    if (typeof value.getLocal() === 'object')
+                                        attributeValue = stringify(value.getLocal());
+                                    else
+                                        attributeValue = value.getLocal().toString();
+                                    attributeLocalValue = value.getLocal();
+                                }
+                                catch (error) {
+                                    attributeValue = 'Fabric-Scoped';
+                                    attributeLocalValue = 'Fabric-Scoped';
+                                    this.log.debug(`GetLocal error ${error} in clusterServer: ${clusterServer.name}(${clusterServer.id}) attribute: ${key}(${value.id})`);
+                                }
+                                clusters.push({
+                                    endpoint: childEndpoint.number ? childEndpoint.number.toString() : '...',
+                                    id: name,
+                                    deviceTypes,
+                                    clusterName: clusterServer.name,
+                                    clusterId: '0x' + clusterServer.id.toString(16).padStart(2, '0'),
+                                    attributeName: key,
+                                    attributeId: '0x' + value.id.toString(16).padStart(2, '0'),
+                                    attributeValue,
+                                    attributeLocalValue,
+                                });
+                            });
+                        });
+                    });
+                });
+                client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, plugin: data.params.plugin, deviceName, serialNumber, endpoint: data.params.endpoint, deviceTypes, response: clusters }));
+                return;
+            }
+            else if (data.method === '/api/select') {
+                if (!isValidString(data.params.plugin, 10)) {
+                    client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Wrong parameter plugin in /api/select' }));
+                    return;
+                }
+                const plugin = this.matterbridge.plugins.get(data.params.plugin);
+                if (!plugin) {
+                    client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Plugin not found in /api/select' }));
+                    return;
+                }
+                const selectDeviceValues = plugin.platform?.selectDevice ? Array.from(plugin.platform.selectDevice.values()).sort((keyA, keyB) => keyA.name.localeCompare(keyB.name)) : [];
+                client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, plugin: data.params.plugin, response: selectDeviceValues }));
+                return;
+            }
+            else if (data.method === '/api/select/entities') {
+                if (!isValidString(data.params.plugin, 10)) {
+                    client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Wrong parameter plugin in /api/select/entities' }));
+                    return;
+                }
+                const plugin = this.matterbridge.plugins.get(data.params.plugin);
+                if (!plugin) {
+                    client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Plugin not found in /api/select/entities' }));
+                    return;
+                }
+                const selectEntityValues = plugin.platform?.selectDevice ? Array.from(plugin.platform.selectEntity.values()).sort((keyA, keyB) => keyA.name.localeCompare(keyB.name)) : [];
+                client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, plugin: data.params.plugin, response: selectEntityValues }));
+                return;
+            }
+            else {
+                this.log.error(`Invalid method from websocket client: ${debugStringify(data)}`);
+                client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Invalid method' }));
+                return;
+            }
+        }
+        catch (error) {
+            this.log.error(`Error parsing message "${message}" from websocket client:`, error instanceof Error ? error.message : error);
+            return;
+        }
+    }
+    /**
+     * Sends a WebSocket message to all connected clients.
+     *
+     * @param {string} level - The logger level of the message: debug info notice warn error fatal...
+     * @param {string} time - The time string of the message
+     * @param {string} name - The logger name of the message
+     * @param {string} message - The content of the message.
+     */
+    wssSendMessage(level, time, name, message) {
+        if (!level || !time || !name || !message)
+            return;
+        // Remove ANSI escape codes from the message
+        // eslint-disable-next-line no-control-regex
+        message = message.replace(/\x1B\[[0-9;]*[m|s|u|K]/g, '');
+        // Remove leading asterisks from the message
+        message = message.replace(/^\*+/, '');
+        // Replace all occurrences of \t and \n
+        message = message.replace(/[\t\n]/g, '');
+        // Remove non-printable characters
+        // eslint-disable-next-line no-control-regex
+        message = message.replace(/[\x00-\x1F\x7F]/g, '');
+        // Replace all occurrences of \" with "
+        message = message.replace(/\\"/g, '"');
+        // Define the maximum allowed length for continuous characters without a space
+        const maxContinuousLength = 100;
+        const keepStartLength = 20;
+        const keepEndLength = 20;
+        // Split the message into words
+        message = message
+            .split(' ')
+            .map((word) => {
+            // If the word length exceeds the max continuous length, insert spaces and truncate
+            if (word.length > maxContinuousLength) {
+                return word.slice(0, keepStartLength) + ' ... ' + word.slice(-keepEndLength);
+            }
+            return word;
+        })
+            .join(' ');
+        // Send the message to all connected clients
+        this.webSocketServer?.clients.forEach((client) => {
+            if (client.readyState === WebSocket.OPEN) {
+                client.send(JSON.stringify({ id: WS_ID_LOG, src: 'Matterbridge', level, time, name, message }));
+            }
+        });
+    }
+    /**
+     * Sends a need to refresh WebSocket message to all connected clients.
+     *
+     */
+    wssSendRefreshRequired() {
+        this.log.debug('Sending a refresh required message to all connected clients');
+        this.matterbridge.matterbridgeInformation.refreshRequired = true;
+        // Send the message to all connected clients
+        this.webSocketServer?.clients.forEach((client) => {
+            if (client.readyState === WebSocket.OPEN) {
+                client.send(JSON.stringify({ id: WS_ID_REFRESH_NEEDED, src: 'Matterbridge', dst: 'Frontend', method: 'refresh_required', params: {} }));
+            }
+        });
+    }
+    /**
+     * Sends a need to restart WebSocket message to all connected clients.
+     *
+     */
+    wssSendRestartRequired() {
+        this.log.debug('Sending a restart required message to all connected clients');
+        this.matterbridge.matterbridgeInformation.restartRequired = true;
+        // Send the message to all connected clients
+        this.webSocketServer?.clients.forEach((client) => {
+            if (client.readyState === WebSocket.OPEN) {
+                client.send(JSON.stringify({ id: WS_ID_RESTART_NEEDED, src: 'Matterbridge', dst: 'Frontend', method: 'restart_required', params: {} }));
+            }
+        });
+    }
+}
+//# sourceMappingURL=frontend.js.map