matterbridge 1.4.2 → 1.5.0

package/dist/matterbridge.js

@@ -20,8 +20,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License. *
  */
-import { NodeStorageManager } from 'node-persist-manager';
-import { AnsiLogger, UNDERLINE, UNDERLINEOFF, YELLOW, db, debugStringify, stringify, BRIGHT, RESET, er, nf, rs, wr, RED, GREEN, zb, hk, or, idn, BLUE, CYAN, nt } from 'node-ansi-logger';
+// Node.js modules
 import { fileURLToPath } from 'url';
 import { promises as fs } from 'fs';
 import { exec, spawn } from 'child_process';
@@ -32,19 +31,22 @@ import express from 'express';
 import os from 'os';
 import path from 'path';
 import WebSocket, { WebSocketServer } from 'ws';
+// NodeStorage and AnsiLogger modules
+import { NodeStorageManager } from 'node-persist-manager';
+import { AnsiLogger, UNDERLINE, UNDERLINEOFF, YELLOW, db, debugStringify, stringify, BRIGHT, RESET, er, nf, rs, wr, RED, GREEN, zb, hk, or, idn, BLUE, CYAN, nt } from 'node-ansi-logger';
 // Matterbridge
 import { MatterbridgeDevice } from './matterbridgeDevice.js';
 import { BridgedDeviceBasicInformation, BridgedDeviceBasicInformationCluster } from './cluster/BridgedDeviceBasicInformationCluster.js';
-import { logInterfaces, wait, waiter } from './utils/utils.js';
+import { logInterfaces, wait, waiter, createZip } from './utils/utils.js';
 // @project-chip/matter-node.js
 import { CommissioningController, CommissioningServer, MatterServer } from '@project-chip/matter-node.js';
 import { BasicInformationCluster, ClusterServer, FixedLabelCluster, GeneralCommissioning, PowerSourceCluster, SwitchCluster, ThreadNetworkDiagnosticsCluster, getClusterNameById } from '@project-chip/matter-node.js/cluster';
 import { DeviceTypeId, VendorId } from '@project-chip/matter-node.js/datatype';
 import { Aggregator, DeviceTypes, NodeStateInformation } from '@project-chip/matter-node.js/device';
-import { createFileLogger, Format, Level, Logger } from '@project-chip/matter-node.js/log';
+import { Format, Level, Logger } from '@project-chip/matter-node.js/log';
 import { ManualPairingCodeCodec, QrCodeSchema } from '@project-chip/matter-node.js/schema';
 import { StorageBackendDisk, StorageBackendJsonFile, StorageManager } from '@project-chip/matter-node.js/storage';
-import { requireMinNodeVersion, getParameter, getIntParameter, hasParameter } from '@project-chip/matter-node.js/util';
+import { getParameter, getIntParameter, hasParameter } from '@project-chip/matter-node.js/util';
 import { CryptoNode } from '@project-chip/matter-node.js/crypto';
 import { PluginManager } from './pluginManager.js';
 import { DeviceManager } from './deviceManager.js';
@@ -80,6 +82,8 @@ export class Matterbridge extends EventEmitter {
         globalModulesDirectory: '',
         matterbridgeVersion: '',
         matterbridgeLatestVersion: '',
+        matterbridgeQrPairingCode: undefined,
+        matterbridgeManualPairingCode: undefined,
         matterbridgeFabricInformations: [],
         matterbridgeSessionInformations: [],
         matterbridgePaired: false,
@@ -87,7 +91,9 @@ export class Matterbridge extends EventEmitter {
         bridgeMode: '',
         restartMode: '',
         loggerLevel: "info" /* LogLevel.INFO */,
+        fileLogger: false,
         matterLoggerLevel: Level.INFO,
+        matterFileLogger: false,
     };
     homeDirectory = '';
     rootDirectory = '';
@@ -96,14 +102,14 @@ export class Matterbridge extends EventEmitter {
     globalModulesDirectory = '';
     matterbridgeVersion = '';
     matterbridgeLatestVersion = '';
+    matterbridgeQrPairingCode = undefined;
+    matterbridgeManualPairingCode = undefined;
     matterbridgeFabricInformations = [];
     matterbridgeSessionInformations = [];
     matterbridgePaired = false;
     matterbridgeConnected = false;
     bridgeMode = '';
     restartMode = '';
-    // public debugEnabled = false;
-    // public loggerLevel: LogLevel = LogLevel.INFO;
     profile = getParameter('profile');
     log;
     matterbrideLoggerFile = 'matterbridge' + (getParameter('profile') ? '.' + getParameter('profile') : '') + '.log';
@@ -119,6 +125,7 @@ export class Matterbridge extends EventEmitter {
     hasCleanupStarted = false;
     initialized = false;
     execRunningCount = 0;
+    startMatterInterval;
     cleanupTimeout1;
     cleanupTimeout2;
     checkUpdateInterval;
@@ -208,12 +215,19 @@ export class Matterbridge extends EventEmitter {
         // Set the matterbridge directory
         this.homeDirectory = os.homedir();
         this.matterbridgeDirectory = path.join(this.homeDirectory, '.matterbridge');
-        // Create the file logger for matterbridge
-        if (hasParameter('filelogger'))
-            AnsiLogger.setGlobalLogfile(path.join(this.matterbridgeDirectory, this.matterbrideLoggerFile), "debug" /* LogLevel.DEBUG */, true);
+        // Initialize nodeStorage and nodeContext
+        // this.log.debug(`Creating node storage manager: ${CYAN}${this.nodeStorageName}${db}`);
+        this.nodeStorage = new NodeStorageManager({ dir: path.join(this.matterbridgeDirectory, this.nodeStorageName), writeQueue: false, expiredInterval: undefined, logging: false });
+        // this.log.debug('Creating node storage context for matterbridge');
+        this.nodeContext = await this.nodeStorage.createStorage('matterbridge');
         // Create matterbridge logger
         this.log = new AnsiLogger({ logName: 'Matterbridge', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: "info" /* LogLevel.INFO */ });
-        // Set matterbridge logger level
+        // Create the file logger for matterbridge (context: matterbridgeFileLog)
+        if (hasParameter('filelogger') || (await this.nodeContext.get('matterbridgeFileLog', false))) {
+            AnsiLogger.setGlobalLogfile(path.join(this.matterbridgeDirectory, this.matterbrideLoggerFile), "debug" /* LogLevel.DEBUG */, true);
+            this.matterbridgeInformation.fileLogger = true;
+        }
+        // Set matterbridge logger level (context: matterbridgeLogLevel)
         if (hasParameter('logger')) {
             const level = getParameter('logger');
             if (level === 'debug') {
@@ -240,11 +254,12 @@ export class Matterbridge extends EventEmitter {
             }
         }
         else {
-            this.log.logLevel = "info" /* LogLevel.INFO */;
+            this.log.logLevel = await this.nodeContext.get('matterbridgeLogLevel', "info" /* LogLevel.INFO */);
         }
         MatterbridgeDevice.logLevel = this.log.logLevel;
         this.log.debug('Matterbridge is starting...');
-        // Set matter.js logger level, format and logger
+        this.log.debug(`Matterbridge logLevel: ${this.log.logLevel} fileLoger: ${this.matterbridgeInformation.fileLogger}.`);
+        // Set matter.js logger level, format and logger (context: matterLogLevel)
         if (hasParameter('matterlogger')) {
             const level = getParameter('matterlogger');
             if (level === 'debug') {
@@ -271,28 +286,19 @@ export class Matterbridge extends EventEmitter {
             }
         }
         else {
-            Logger.defaultLogLevel = Level.INFO;
+            Logger.defaultLogLevel = await this.nodeContext.get('matterLogLevel', Level.INFO);
         }
         Logger.format = Format.ANSI;
         Logger.setLogger('default', this.createMatterLogger());
-        // Create the file logger for matter.js
-        if (hasParameter('matterfilelogger')) {
-            try {
-                await fs.unlink(path.join(this.matterbridgeDirectory, this.matterLoggerFile));
-            }
-            catch (error) {
-                this.log.debug(`Error unlinking the log file ${CYAN}${path.join(this.matterbridgeDirectory, this.matterLoggerFile)}${er}: ${error instanceof Error ? error.message : error}`);
-            }
-            Logger.addLogger('filelogger', await createFileLogger(path.join(this.matterbridgeDirectory, this.matterLoggerFile)), {
+        // Create the file logger for matter.js (context: matterFileLog)
+        if (hasParameter('matterfilelogger') || (await this.nodeContext.get('matterFileLog', false))) {
+            this.matterbridgeInformation.matterFileLogger = true;
+            Logger.addLogger('matterfilelogger', await this.createMatterFileLogger(path.join(this.matterbridgeDirectory, this.matterLoggerFile), true), {
                 defaultLogLevel: Level.DEBUG,
                 logFormat: Format.PLAIN,
             });
         }
-        // Initialize nodeStorage and nodeContext
-        this.log.debug(`Creating node storage manager: ${CYAN}${this.nodeStorageName}${db}`);
-        this.nodeStorage = new NodeStorageManager({ dir: path.join(this.matterbridgeDirectory, this.nodeStorageName), writeQueue: false, expiredInterval: undefined, logging: false });
-        this.log.debug('Creating node storage context for matterbridge');
-        this.nodeContext = await this.nodeStorage.createStorage('matterbridge');
+        this.log.debug(`Matter logLevel: ${Logger.defaultLogLevel} fileLoger: ${this.matterbridgeInformation.matterFileLogger}.`);
         // Initialize PluginManager
         this.plugins = new PluginManager(this);
         await this.plugins.loadFromStorage();
@@ -301,8 +307,9 @@ export class Matterbridge extends EventEmitter {
         // Get the plugins from node storage and create the plugins node storage contexts
         for (const plugin of this.plugins) {
             const packageJson = await this.plugins.parse(plugin);
-            if (packageJson === null) {
+            if (packageJson === null && !hasParameter('add')) {
                 // Try to reinstall the plugin from npm (for Docker pull and external plugins)
+                // We don't do this when the add parameter is set because we shut down the process after adding the plugin
                 this.log.info(`Error parsing plugin ${plg}${plugin.name}${nf}. Trying to reinstall it from npm.`);
                 try {
                     await this.spawnCommand('npm', ['install', '-g', plugin.name]);
@@ -327,10 +334,20 @@ export class Matterbridge extends EventEmitter {
         }
         // Log system info and create .matterbridge directory
         await this.logNodeAndSystemInfo();
-        this.log.notice(`Matterbridge version ${this.matterbridgeVersion} ${hasParameter('bridge') ? 'mode bridge' : ''}${hasParameter('childbridge') ? 'mode childbridge' : ''}${hasParameter('controller') ? 'mode controller' : ''} ` +
-            `${this.restartMode !== '' ? 'restart mode ' + this.restartMode + ' ' : ''}running on ${this.systemInformation.osType} ${this.systemInformation.osRelease} ${this.systemInformation.osPlatform} ${this.systemInformation.osArch} `);
+        this.log.notice(`Matterbridge version ${this.matterbridgeVersion} ` +
+            `${hasParameter('bridge') || (!hasParameter('childbridge') && (await this.nodeContext?.get('bridgeMode', '')) === 'bridge') ? 'mode bridge ' : ''}` +
+            `${hasParameter('childbridge') || (!hasParameter('bridge') && (await this.nodeContext?.get('bridgeMode', '')) === 'childbridge') ? 'mode childbridge ' : ''}` +
+            `${hasParameter('controller') ? 'mode controller ' : ''}` +
+            `${this.restartMode !== '' ? 'restart mode ' + this.restartMode + ' ' : ''}` +
+            `running on ${this.systemInformation.osType} (v.${this.systemInformation.osRelease}) platform ${this.systemInformation.osPlatform} arch ${this.systemInformation.osArch}`);
         // Check node version and throw error
-        requireMinNodeVersion(18);
+        const minNodeVersion = 18;
+        const nodeVersion = process.versions.node;
+        const versionMajor = parseInt(nodeVersion.split('.')[0]);
+        if (versionMajor < minNodeVersion) {
+            this.log.error(`Node version ${versionMajor} is not supported. Please upgrade to ${minNodeVersion} or above.`);
+            throw new Error(`Node version ${versionMajor} is not supported. Please upgrade to ${minNodeVersion} or above.`);
+        }
         // Register SIGINT SIGTERM signal handlers
         this.registerSignalHandlers();
         // Parse command line
@@ -351,6 +368,8 @@ export class Matterbridge extends EventEmitter {
       - childbridge:           start Matterbridge in childbridge mode
       - port [port]:           start the commissioning server on the given port (default 5540)
       - mdnsinterface [name]:  set the interface to use for the matter server mdnsInterface (default all interfaces)
+      - ipv4address [address]: set the ipv4 interface address to use for the matter listener (default all interfaces)
+      - ipv6address [address]: set the ipv6 interface address to use for the matter listener (default all interfaces)
       - frontend [port]:       start the frontend on the given port (default 8283)
       - logger:                set the matterbridge logger level: debug | info | notice | warn | error | fatal (default info)
       - matterlogger:          set the matter.js logger level: debug | info | notice | warn | error | fatal (default info)
@@ -511,8 +530,8 @@ export class Matterbridge extends EventEmitter {
             }
         }, 60 * 60 * 1000);
         if (hasParameter('test')) {
-            this.bridgeMode = 'childbridge';
-            MatterbridgeDevice.bridgeMode = 'childbridge';
+            this.bridgeMode = 'bridge';
+            MatterbridgeDevice.bridgeMode = 'bridge';
             await this.startTest();
             return;
         }
@@ -521,7 +540,12 @@ export class Matterbridge extends EventEmitter {
             await this.startController();
             return;
         }
-        if (hasParameter('bridge')) {
+        // Check if the bridge mode is set and start matterbridge in bridge mode if not set
+        if (!hasParameter('bridge') && !hasParameter('childbridge') && (await this.nodeContext?.get('bridgeMode', '')) === '') {
+            this.log.info('Setting default matterbridge start mode to bridge');
+            await this.nodeContext?.set('bridgeMode', 'bridge');
+        }
+        if (hasParameter('bridge') || (!hasParameter('childbridge') && (await this.nodeContext?.get('bridgeMode', '')) === 'bridge')) {
             this.bridgeMode = 'bridge';
             MatterbridgeDevice.bridgeMode = 'bridge';
             if (!this.storageManager)
@@ -562,12 +586,12 @@ export class Matterbridge extends EventEmitter {
                 plugin.addedDevices = undefined;
                 plugin.qrPairingCode = undefined;
                 plugin.manualPairingCode = undefined;
-                this.plugins.load(plugin, true, 'Matterbridge is starting'); // this.loadPlugin(plugin, true, 'Matterbridge is starting'); // No await do it asyncronously
+                this.plugins.load(plugin, true, 'Matterbridge is starting'); // No await do it asyncronously
             }
             await this.startBridge();
             return;
         }
-        if (hasParameter('childbridge')) {
+        if (hasParameter('childbridge') || (!hasParameter('bridge') && (await this.nodeContext?.get('bridgeMode', '')) === 'childbridge')) {
             this.bridgeMode = 'childbridge';
             MatterbridgeDevice.bridgeMode = 'childbridge';
             if (!this.storageManager)
@@ -598,9 +622,9 @@ export class Matterbridge extends EventEmitter {
                 plugin.connected = false;
                 plugin.registeredDevices = undefined;
                 plugin.addedDevices = undefined;
-                plugin.qrPairingCode = (await plugin.nodeContext?.get('qrPairingCode', undefined)) ?? undefined;
-                plugin.manualPairingCode = (await plugin.nodeContext?.get('manualPairingCode', undefined)) ?? undefined;
-                this.plugins.load(plugin, true, 'Matterbridge is starting'); // this.loadPlugin(plugin, true, 'Matterbridge is starting'); // No await do it asyncronously
+                plugin.qrPairingCode = undefined;
+                plugin.manualPairingCode = undefined;
+                this.plugins.load(plugin, true, 'Matterbridge is starting'); // No await do it asyncronously
             }
             await this.startChildbridge();
             return;
@@ -847,7 +871,10 @@ export class Matterbridge extends EventEmitter {
             this.log.debug(`Matterbridge Latest Version: ${this.matterbridgeLatestVersion}`);
             await this.nodeContext?.set('matterbridgeLatestVersion', this.matterbridgeLatestVersion);
             if (this.matterbridgeVersion !== this.matterbridgeLatestVersion) {
-                this.log.warn(`Matterbridge is out of date. Current version: ${this.matterbridgeVersion}, Latest version: ${this.matterbridgeLatestVersion}`);
+                this.log.notice(`Matterbridge is out of date. Current version: ${this.matterbridgeVersion}. Latest version: ${this.matterbridgeLatestVersion}.`);
+            }
+            else {
+                this.log.debug(`Matterbridge is up to date. Current version: ${this.matterbridgeVersion}. Latest version: ${this.matterbridgeLatestVersion}.`);
             }
         })
             .catch((error) => {
@@ -870,15 +897,20 @@ export class Matterbridge extends EventEmitter {
             .then(async (latestVersion) => {
             plugin.latestVersion = latestVersion;
             if (plugin.version !== latestVersion)
-                this.log.warn(`The plugin ${plg}${plugin.name}${wr} is out of date. Current version: ${plugin.version}, Latest version: ${latestVersion}`);
+                this.log.notice(`The plugin ${plg}${plugin.name}${nt} is out of date. Current version: ${plugin.version}. Latest version: ${latestVersion}.`);
             else
-                this.log.info(`The plugin ${plg}${plugin.name}${nf} is up to date. Current version: ${plugin.version}, Latest version: ${latestVersion}`);
+                this.log.debug(`The plugin ${plg}${plugin.name}${db} is up to date. Current version: ${plugin.version}. Latest version: ${latestVersion}.`);
         })
             .catch((error) => {
-            this.log.error(`Error getting ${plugin.name} latest version: ${error.message}`);
+            this.log.error(`Error getting ${plg}${plugin.name}${er} latest version: ${error.message}`);
             // error.stack && this.log.debug(error.stack);
         });
     }
+    /**
+     * Creates a MatterLogger function to show the matter.js log messages in AnsiLogger (for the frontend).
+     *
+     * @returns {Function} The MatterLogger function.
+     */
     createMatterLogger() {
         const matterLogger = new AnsiLogger({ logName: 'Matter', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: "debug" /* LogLevel.DEBUG */ });
         return (_level, formattedLog) => {
@@ -910,6 +942,63 @@ export class Matterbridge extends EventEmitter {
             }
         };
     }
+    /**
+     * Creates a Matter File Logger.
+     *
+     * @param {string} filePath - The path to the log file.
+     * @param {boolean} [unlink=false] - Whether to unlink the log file before creating a new one.
+     * @returns {Function} - A function that logs formatted messages to the log file.
+     */
+    async createMatterFileLogger(filePath, unlink = false) {
+        // 2024-08-21 08:55:19.488 DEBUG InteractionMessenger Sending DataReport chunk with 28 attributes and 0 events: 1004 bytes
+        let fileSize = 0;
+        if (unlink) {
+            try {
+                await fs.unlink(filePath);
+            }
+            catch (error) {
+                this.log.debug(`Error unlinking the log file ${CYAN}${filePath}${db}: ${error instanceof Error ? error.message : error}`);
+            }
+        }
+        return async (_level, formattedLog) => {
+            if (fileSize > 100000000)
+                return;
+            fileSize += formattedLog.length;
+            if (fileSize > 100000000) {
+                await fs.appendFile(filePath, `Logging on file has been stoppped because the file size is greater then 100MB.` + os.EOL);
+                return;
+            }
+            const now = new Date();
+            const timestamp = `${now.getHours().toString().padStart(2, '0')}:${now.getMinutes().toString().padStart(2, '0')}:${now.getSeconds().toString().padStart(2, '0')}.${now.getMilliseconds().toString().padStart(3, '0')}`;
+            const message = formattedLog.slice(24);
+            const parts = message.split(' ');
+            const logger = parts[1];
+            const finalMessage = parts.slice(2).join(' ') + os.EOL;
+            switch (_level) {
+                case Level.DEBUG:
+                    await fs.appendFile(filePath, `[${timestamp}] [${logger}] [debug] ${finalMessage}`);
+                    break;
+                case Level.INFO:
+                    await fs.appendFile(filePath, `[${timestamp}] [${logger}] [info] ${finalMessage}`);
+                    break;
+                case Level.NOTICE:
+                    await fs.appendFile(filePath, `[${timestamp}] [${logger}] [notice] ${finalMessage}`);
+                    break;
+                case Level.WARN:
+                    await fs.appendFile(filePath, `[${timestamp}] [${logger}] [warn] ${finalMessage}`);
+                    break;
+                case Level.ERROR:
+                    await fs.appendFile(filePath, `[${timestamp}] [${logger}] [error] ${finalMessage}`);
+                    break;
+                case Level.FATAL:
+                    await fs.appendFile(filePath, `[${timestamp}] [${logger}] [fatal] ${finalMessage}`);
+                    break;
+                default:
+                    await fs.appendFile(filePath, `[${timestamp}] [${logger}] ${finalMessage}`);
+                    break;
+            }
+        };
+    }
     /**
      * Update matterbridge and cleanup.
      */
@@ -962,11 +1051,18 @@ export class Matterbridge extends EventEmitter {
             this.log.info(message);
             // Deregisters the SIGINT and SIGTERM signal handlers
             this.deregisterSignalHandlers();
+            // Clear the start matter interval
+            if (this.startMatterInterval) {
+                clearInterval(this.startMatterInterval);
+                this.startMatterInterval = undefined;
+                this.log.debug('Start matter interval cleared');
+            }
             // Clear the check update interval
-            if (this.checkUpdateInterval)
+            if (this.checkUpdateInterval) {
                 clearInterval(this.checkUpdateInterval);
-            this.checkUpdateInterval = undefined;
-            this.log.debug('Check update interval cleared');
+                this.checkUpdateInterval = undefined;
+                this.log.debug('Check update interval cleared');
+            }
             // Clear the configure timeout
             if (this.configureTimeout) {
                 clearTimeout(this.configureTimeout);
@@ -1033,6 +1129,14 @@ export class Matterbridge extends EventEmitter {
             await this.stopMatterServer();
             // Closing matter storage
             await this.stopMatterStorage();
+            // Remove the matterfilelogger
+            try {
+                Logger.removeLogger('matterfilelogger');
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            }
+            catch (error) {
+                // this.log.debug(`Error removing the matterfilelogger for file ${CYAN}${path.join(this.matterbridgeDirectory, this.matterLoggerFile)}${er}: ${error instanceof Error ? error.message : error}`);
+            }
             // Serialize registeredDevices
             if (this.nodeStorage && this.nodeContext) {
                 this.log.info('Saving registered devices...');
@@ -1192,8 +1296,10 @@ export class Matterbridge extends EventEmitter {
                 this.log.error(`Error removing bridged device ${dev}${device.deviceName}${er} (${dev}${device.name}${er}) for plugin ${plg}${pluginName}${er}: matterAggregator not found`);
                 return;
             }
-            device.setBridgedDeviceReachability(false);
-            device.getClusterServerById(BridgedDeviceBasicInformation.Cluster.id)?.triggerReachableChangedEvent({ reachableNewValue: false });
+            if (device.number !== undefined) {
+                device.setBridgedDeviceReachability(false);
+                device.getClusterServerById(BridgedDeviceBasicInformation.Cluster.id)?.triggerReachableChangedEvent({ reachableNewValue: false });
+            }
             // device.getClusterServerById(BridgedDeviceBasicInformation.Cluster.id)?.triggerShutDownEvent({});
             // device.getClusterServerById(BridgedDeviceBasicInformation.Cluster.id)?.triggerLeaveEvent({});
             this.matterAggregator?.removeBridgedDevice(device);
@@ -1234,8 +1340,10 @@ export class Matterbridge extends EventEmitter {
                         return;
                     }
                 });
-                device.setBridgedDeviceReachability(false);
-                device.getClusterServerById(BridgedDeviceBasicInformation.Cluster.id)?.triggerReachableChangedEvent({ reachableNewValue: false });
+                if (device.number !== undefined) {
+                    device.setBridgedDeviceReachability(false);
+                    device.getClusterServerById(BridgedDeviceBasicInformation.Cluster.id)?.triggerReachableChangedEvent({ reachableNewValue: false });
+                }
                 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}`);
@@ -1284,13 +1392,14 @@ export class Matterbridge extends EventEmitter {
         // Plugins are configured by a timer when matter server is started and plugin.configured is set to true
         this.log.debug('***Starting startMatterInterval in bridge mode');
         let failCount = 0;
-        const startMatterInterval = setInterval(async () => {
+        this.startMatterInterval = setInterval(async () => {
             for (const plugin of this.plugins) {
                 // new code to not start the bridge if one plugin is in error cause the controllers will delete the devices loosing all the configuration
                 if (!plugin.enabled)
                     continue;
                 if (plugin.error) {
-                    clearInterval(startMatterInterval);
+                    clearInterval(this.startMatterInterval);
+                    this.startMatterInterval = undefined;
                     this.log.debug('***Cleared startMatterInterval interval for Matterbridge for plugin in error state');
                     this.log.error(`The plugin ${plg}${plugin.name}${er} is in error state.`);
                     this.log.error('The bridge will not start until the problem is solved to prevent the controllers from deleting all registered devices.');
@@ -1307,7 +1416,8 @@ export class Matterbridge extends EventEmitter {
                     return;
                 }
             }
-            clearInterval(startMatterInterval);
+            clearInterval(this.startMatterInterval);
+            this.startMatterInterval = undefined;
             this.log.debug('***Cleared startMatterInterval interval for Matterbridge');
             await this.startMatterServer();
             this.log.notice('Matter server started');
@@ -1348,14 +1458,15 @@ export class Matterbridge extends EventEmitter {
         // Plugins are configured by a timer when matter server is started and plugin.configured is set to true
         this.log.debug('***Starting start matter interval in childbridge mode...');
         let failCount = 0;
-        const startMatterInterval = setInterval(async () => {
+        this.startMatterInterval = setInterval(async () => {
             let allStarted = true;
             for (const plugin of this.plugins) {
                 // new code to not start the bridge if one plugin is in error cause the controllers will delete the devices loosing all the configuration
                 if (!plugin.enabled)
                     continue;
                 if (plugin.error) {
-                    clearInterval(startMatterInterval);
+                    clearInterval(this.startMatterInterval);
+                    this.startMatterInterval = undefined;
                     this.log.debug('***Cleared startMatterInterval interval for Matterbridge for plugin in error state');
                     this.log.error(`The plugin ${plg}${plugin.name}${er} is in error state.`);
                     this.log.error('The bridge will not start until the problem is solved to prevent the controllers from deleting all registered devices.');
@@ -1375,7 +1486,8 @@ export class Matterbridge extends EventEmitter {
             }
             if (!allStarted)
                 return;
-            clearInterval(startMatterInterval);
+            clearInterval(this.startMatterInterval);
+            this.startMatterInterval = undefined;
             this.log.debug('***Cleared startMatterInterval interval in childbridge mode');
             await this.startMatterServer();
             this.log.notice('Matter server started');
@@ -1800,8 +1912,8 @@ export class Matterbridge extends EventEmitter {
         this.log.debug(`Creating matter commissioning server for plugin ${plg}${pluginName}${db} with nodeLabel '${productName}' port ${this.port} passcode ${this.passcode} discriminator ${this.discriminator}`);
         const commissioningServer = new CommissioningServer({
             port: this.port++,
-            // listeningAddressIpv4
-            // listeningAddressIpv6
+            listeningAddressIpv4: getParameter('ipv4address'),
+            listeningAddressIpv6: getParameter('ipv6address'),
             passcode: this.passcode,
             discriminator: this.discriminator,
             deviceName,
@@ -2028,16 +2140,15 @@ export class Matterbridge extends EventEmitter {
         }
         if (!commissioningServer.isCommissioned()) {
             const { qrPairingCode, manualPairingCode } = commissioningServer.getPairingCode();
-            await storageContext.set('qrPairingCode', qrPairingCode);
-            await storageContext.set('manualPairingCode', manualPairingCode);
-            await nodeContext.set('qrPairingCode', qrPairingCode);
-            await nodeContext.set('manualPairingCode', manualPairingCode);
             const QrCode = new QrCodeSchema();
             this.log.info(`*The commissioning server on port ${commissioningServer.getPort()} for ${plg}${pluginName}${nf} is not commissioned. Pair it scanning the QR code:\n\n`);
             // eslint-disable-next-line no-console
-            console.log(`${QrCode.encode(qrPairingCode)}\n`);
-            this.log.info(`${plg}${pluginName}${nf}\n\nqrPairingCode: ${qrPairingCode}\n\nManual pairing code: ${manualPairingCode}\n`);
+            if (this.log.logLevel === "debug" /* LogLevel.DEBUG */ || this.log.logLevel === "info" /* LogLevel.INFO */)
+                console.log(`${QrCode.encode(qrPairingCode)}\n`);
+            this.log.info(`${plg}${pluginName}${nf} \n\nqrPairingCode: ${qrPairingCode} \n\nManual pairing code: ${manualPairingCode}\n`);
             if (pluginName === 'Matterbridge') {
+                this.matterbridgeQrPairingCode = qrPairingCode;
+                this.matterbridgeManualPairingCode = manualPairingCode;
                 this.matterbridgeFabricInformations = [];
                 this.matterbridgeSessionInformations = [];
                 this.matterbridgePaired = false;
@@ -2522,40 +2633,21 @@ export class Matterbridge extends EventEmitter {
         // Endpoint to provide settings
         this.expressApp.get('/api/settings', express.json(), async (req, res) => {
             this.log.debug('The frontend sent /api/settings');
-            if (!this.matterbridgeContext) {
-                this.log.error('/api/settings matterbridgeContext not found');
-                res.json({});
-                return;
-            }
-            let qrPairingCode = '';
-            let manualPairingCode = '';
-            try {
-                qrPairingCode = await this.matterbridgeContext.get('qrPairingCode');
-                manualPairingCode = await this.matterbridgeContext.get('manualPairingCode');
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            }
-            catch (error) {
-                if (this.bridgeMode === 'bridge')
-                    this.log.warn('pairingCodes for /api/settings not found');
-            }
             this.matterbridgeInformation.bridgeMode = this.bridgeMode;
             this.matterbridgeInformation.restartMode = this.restartMode;
             this.matterbridgeInformation.loggerLevel = this.log.logLevel;
             this.matterbridgeInformation.matterLoggerLevel = Logger.defaultLogLevel;
             this.matterbridgeInformation.matterbridgePaired = this.matterbridgePaired;
             this.matterbridgeInformation.matterbridgeConnected = this.matterbridgeConnected;
+            this.matterbridgeInformation.matterbridgeQrPairingCode = this.matterbridgeQrPairingCode;
+            this.matterbridgeInformation.matterbridgeManualPairingCode = this.matterbridgeManualPairingCode;
             this.matterbridgeInformation.matterbridgeFabricInformations = this.matterbridgeFabricInformations;
             this.matterbridgeInformation.matterbridgeSessionInformations = this.matterbridgeSessionInformations;
             if (this.profile)
                 this.matterbridgeInformation.profile = this.profile;
-            const response = { wssHost, ssl: hasParameter('ssl'), qrPairingCode, manualPairingCode, systemInformation: this.systemInformation, matterbridgeInformation: this.matterbridgeInformation };
+            // const response = { wssHost, ssl: hasParameter('ssl'), qrPairingCode, manualPairingCode, systemInformation: this.systemInformation, matterbridgeInformation: this.matterbridgeInformation };
+            const response = { wssHost, ssl: hasParameter('ssl'), systemInformation: this.systemInformation, matterbridgeInformation: this.matterbridgeInformation };
             // this.log.debug('Response:', debugStringify(response));
-            /*
-            if (this.webSocketServer && this.webSocketServer.clients.size > 0 && !AnsiLogger.getGlobalCallback()) {
-              AnsiLogger.setGlobalCallback(this.wssSendMessage.bind(this), LogLevel.DEBUG);
-              this.log.debug('WebSocketServer logger global callback added');
-            }
-            */
             res.json(response);
         });
         // Endpoint to provide plugins
@@ -2681,9 +2773,16 @@ export class Matterbridge extends EventEmitter {
                 res.status(500).send('Error reading log file');
             }
         });
-        // Endpoint to download the log
-        this.expressApp.get('/api/download-mblog', (req, res) => {
+        // 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.matterbridgeDirectory, this.matterbrideLoggerFile), fs.constants.F_OK);
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            }
+            catch (error) {
+                fs.appendFile(path.join(this.matterbridgeDirectory, this.matterbrideLoggerFile), 'Enable the log on file in the settings to enable the file logger');
+            }
             res.download(path.join(this.matterbridgeDirectory, this.matterbrideLoggerFile), 'matterbridge.log', (error) => {
                 if (error) {
                     this.log.error(`Error downloading log file ${this.matterbrideLoggerFile}: ${error instanceof Error ? error.message : error}`);
@@ -2691,9 +2790,16 @@ export class Matterbridge extends EventEmitter {
                 }
             });
         });
-        // Endpoint to download the log
-        this.expressApp.get('/api/download-mjlog', (req, res) => {
+        // 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.matterbridgeDirectory, this.matterLoggerFile), fs.constants.F_OK);
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            }
+            catch (error) {
+                fs.appendFile(path.join(this.matterbridgeDirectory, this.matterLoggerFile), 'Enable the log on file in the settings to enable the file logger');
+            }
             res.download(path.join(this.matterbridgeDirectory, this.matterLoggerFile), 'matter.log', (error) => {
                 if (error) {
                     this.log.error(`Error downloading log file ${this.matterLoggerFile}: ${error instanceof Error ? error.message : error}`);
@@ -2701,6 +2807,60 @@ export class Matterbridge extends EventEmitter {
                 }
             });
         });
+        // 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.matterbridgeDirectory, this.matterStorageName), 'matterbridge.json', (error) => {
+                if (error) {
+                    this.log.error(`Error downloading log file ${this.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.nodeStorageName}.zip`), path.join(this.matterbridgeDirectory, this.nodeStorageName));
+            res.download(path.join(os.tmpdir(), `matterbridge.${this.nodeStorageName}.zip`), `matterbridge.${this.nodeStorageName}.zip`, (error) => {
+                if (error) {
+                    this.log.error(`Error downloading file ${`matterbridge.${this.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.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.matterbridgeDirectory, '*.config.json')));
+            // await createZip(path.join(os.tmpdir(), `matterbridge.pluginconfig.zip`), path.relative(process.cwd(), path.join(this.matterbridgeDirectory, 'certs', '*.*')), path.relative(process.cwd(), path.join(this.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;
@@ -2719,6 +2879,21 @@ export class Matterbridge extends EventEmitter {
                 res.json({ message: 'Command received' });
                 return;
             }
+            // Handle the command setbridgemode from Settings
+            if (command === 'setbridgemode') {
+                this.log.debug(`setbridgemode: ${param}`);
+                await this.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.matterbridgeDirectory), path.join(this.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);
@@ -2777,6 +2952,46 @@ export class Matterbridge extends EventEmitter {
                 res.json({ message: 'Command received' });
                 return;
             }
+            // Handle the command setmbloglevel from Settings
+            if (command === 'setmblogfile') {
+                this.log.debug('Matterbridge file log:', param);
+                this.matterbridgeInformation.fileLogger = param === 'true';
+                await this.nodeContext?.set('matterbridgeFileLog', param === 'true');
+                // Create the file logger for matterbridge
+                if (param === 'true')
+                    AnsiLogger.setGlobalLogfile(path.join(this.matterbridgeDirectory, this.matterbrideLoggerFile), "debug" /* 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.matterbridgeInformation.matterFileLogger = param === 'true';
+                await this.nodeContext?.set('matterFileLog', param === 'true');
+                if (param === 'true') {
+                    try {
+                        Logger.addLogger('matterfilelogger', await this.createMatterFileLogger(path.join(this.matterbridgeDirectory, this.matterLoggerFile), true), {
+                            defaultLogLevel: Level.DEBUG,
+                            logFormat: Format.PLAIN,
+                        });
+                    }
+                    catch (error) {
+                        this.log.debug(`Error adding the matterfilelogger for file ${CYAN}${path.join(this.matterbridgeDirectory, this.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.matterbridgeDirectory, this.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.unregisterAndShutdownProcess();