matterbridge 1.1.12 → 1.2.1

package/dist/matterbridge.js

@@ -4,7 +4,7 @@
  * @file matterbridge.ts
  * @author Luca Liguori
  * @date 2023-12-29
- * @version 1.1.1
+ * @version 1.2.0
  *
  * Copyright 2023, 2024 Luca Liguori.
  *
@@ -102,20 +102,18 @@ export class Matterbridge extends EventEmitter {
     /**
      * Loads an instance of the Matterbridge class.
      * If an instance already exists, return that instance.
-     * @returns The loaded instance of the Matterbridge class.
+     *
+     * @param initialize - Whether to initialize the Matterbridge instance after loading.
+     * @returns The loaded Matterbridge instance.
      */
     static async loadInstance(initialize = false) {
         if (!Matterbridge.instance) {
             // eslint-disable-next-line no-console
-            console.log('Matterbridge instance does not exists');
+            console.log(wr + 'Matterbridge instance does not exists!', initialize ? 'Initializing...' : 'Not initializing...', rs);
             Matterbridge.instance = new Matterbridge();
             if (initialize)
                 await Matterbridge.instance.initialize();
         }
-        else {
-            // eslint-disable-next-line no-console
-            console.log('Matterbridge instance already exists');
-        }
         return Matterbridge.instance;
     }
     /**
@@ -129,10 +127,6 @@ export class Matterbridge extends EventEmitter {
      * @returns A Promise that resolves when the initialization is complete.
      */
     async initialize() {
-        /*
-        const wtf = await import('wtfnode');
-        wtf.dump();
-        */
         // Display the help
         if (hasParameter('help')) {
             // eslint-disable-next-line no-console
@@ -154,28 +148,19 @@ export class Matterbridge extends EventEmitter {
       - disable [plugin name]: disable the globally installed plugin with the given name\n`);
             process.exit(0);
         }
-        // set Matterbridge logger
+        // Set Matterbridge logger
         if (hasParameter('debug'))
             this.debugEnabled = true;
         this.log = new AnsiLogger({ logName: 'Matterbridge', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logDebug: this.debugEnabled });
         this.log.debug('Matterbridge is starting...');
-        // log system info and create .matterbridge directory
-        await this.logNodeAndSystemInfo();
-        this.log.info(
-        // eslint-disable-next-line max-len
-        `Matterbridge version ${this.matterbridgeVersion} mode ${hasParameter('bridge') ? 'bridge' : ''}${hasParameter('childbridge') ? 'childbridge' : ''} running on ${this.systemInformation.osType} ${this.systemInformation.osRelease} ${this.systemInformation.osPlatform} ${this.systemInformation.osArch}`);
-        // check node version and throw error
-        requireMinNodeVersion(18);
-        // register SIGINT SIGTERM signal handlers
-        this.registerSignalHandlers();
-        // set matter.js logger level and format
-        Logger.defaultLogLevel = this.debugEnabled ? Level.DEBUG : Level.INFO;
-        Logger.format = Format.ANSI;
         // Initialize NodeStorage
+        this.homeDirectory = os.homedir();
+        this.matterbridgeDirectory = path.join(this.homeDirectory, '.matterbridge');
         this.log.debug('Creating node storage manager');
         this.nodeStorage = new NodeStorageManager({ dir: path.join(this.matterbridgeDirectory, 'storage'), logging: false });
         this.log.debug('Creating node storage context for matterbridge');
         this.nodeContext = await this.nodeStorage.createStorage('matterbridge');
+        // Get the plugins from node storage
         this.registeredPlugins = await this.nodeContext.get('plugins', []);
         for (const plugin of this.registeredPlugins) {
             this.log.debug(`Creating node storage context for plugin ${plugin.name}`);
@@ -187,6 +172,43 @@ export class Matterbridge extends EventEmitter {
             await plugin.nodeContext.set('description', plugin.description);
             await plugin.nodeContext.set('author', plugin.author);
         }
+        if (hasParameter('logstorage')) {
+            await this.nodeContext.logStorage();
+            for (const plugin of this.registeredPlugins) {
+                await plugin.nodeContext?.logStorage();
+            }
+        }
+        // Log system info and create .matterbridge directory
+        await this.logNodeAndSystemInfo();
+        this.log.info(
+        // eslint-disable-next-line max-len
+        `Matterbridge version ${this.matterbridgeVersion} mode ${hasParameter('bridge') ? 'bridge' : ''}${hasParameter('childbridge') ? 'childbridge' : ''}${hasParameter('controller') ? 'controller' : ''} running on ${this.systemInformation.osType} ${this.systemInformation.osRelease} ${this.systemInformation.osPlatform} ${this.systemInformation.osArch}`);
+        // Check node version and throw error
+        requireMinNodeVersion(18);
+        // Register SIGINT SIGTERM signal handlers
+        this.registerSignalHandlers();
+        // Set matter.js logger level and format
+        Logger.defaultLogLevel = this.debugEnabled ? Level.DEBUG : Level.INFO;
+        Logger.format = Format.ANSI;
+        // Initialize NodeStorage
+        /*
+        this.log.debug('Creating node storage manager');
+        this.nodeStorage = new NodeStorageManager({ dir: path.join(this.matterbridgeDirectory, 'storage'), logging: false });
+        this.log.debug('Creating node storage context for matterbridge');
+        this.nodeContext = await this.nodeStorage.createStorage('matterbridge');
+        // Get the plugins from node storage
+        this.registeredPlugins = await this.nodeContext.get<RegisteredPlugin[]>('plugins', []);
+        for (const plugin of this.registeredPlugins) {
+          this.log.debug(`Creating node storage context for plugin ${plugin.name}`);
+          plugin.nodeContext = await this.nodeStorage.createStorage(plugin.name);
+          await plugin.nodeContext.set<string>('name', plugin.name);
+          await plugin.nodeContext.set<string>('type', plugin.type);
+          await plugin.nodeContext.set<string>('path', plugin.path);
+          await plugin.nodeContext.set<string>('version', plugin.version);
+          await plugin.nodeContext.set<string>('description', plugin.description);
+          await plugin.nodeContext.set<string>('author', plugin.author);
+        }
+        */
         // Parse command line
         this.parseCommandLine();
     }
@@ -282,12 +304,14 @@ export class Matterbridge extends EventEmitter {
             this.bridgeMode = 'childbridge';
             MatterbridgeDevice.bridgeMode = 'childbridge';
             await this.testStartMatterBridge(); // No await do it asyncronously
+            return;
         }
         if (hasParameter('controller')) {
             this.bridgeMode = 'controller';
             this.log.info('Creating mattercontrollerContext: mattercontrollerContext');
             this.mattercontrollerContext = this.storageManager?.createContext('mattercontrollerContext');
             await this.startMatterBridge();
+            return;
         }
         if (hasParameter('bridge')) {
             this.bridgeMode = 'bridge';
@@ -306,6 +330,7 @@ export class Matterbridge extends EventEmitter {
                 this.loadPlugin(plugin); // No await do it asyncronously
             }
             await this.startMatterBridge();
+            return;
         }
         if (hasParameter('childbridge')) {
             this.bridgeMode = 'childbridge';
@@ -324,8 +349,14 @@ export class Matterbridge extends EventEmitter {
                 this.loadPlugin(plugin, true, 'Matterbridge is starting'); // No await do it asyncronously
             }
             await this.startMatterBridge();
+            return;
         }
     }
+    /**
+     * Resolves the name of a plugin by loading and parsing its package.json file.
+     * @param pluginPath - The path to the plugin or the path to the plugin's package.json file.
+     * @returns The path to the resolved package.json file, or null if the package.json file is not found or does not contain a name.
+     */
     async resolvePluginName(pluginPath) {
         if (!pluginPath.endsWith('package.json'))
             pluginPath = path.join(pluginPath, 'package.json');
@@ -451,14 +482,14 @@ export class Matterbridge extends EventEmitter {
      * Restarts the process by spawning a new process and exiting the current process.
      */
     async restartProcess() {
-        //this.log.info('Restarting still not implemented');
-        //return;
         await this.cleanup('restarting...', true);
         this.hasCleanupStarted = false;
     }
     /**
-     * Performs cleanup operations before shutting down Matterbridge.
-     * @param message - The reason for the cleanup.
+     * Cleans up the Matterbridge instance.
+     * @param message - The cleanup message.
+     * @param restart - Indicates whether to restart the instance after cleanup. Default is `false`.
+     * @returns A promise that resolves when the cleanup is completed.
      */
     async cleanup(message, restart = false) {
         if (!this.hasCleanupStarted) {
@@ -468,10 +499,10 @@ export class Matterbridge extends EventEmitter {
             process.removeAllListeners('SIGTERM');
             // Calling the shutdown functions with a reason
             for (const plugin of this.registeredPlugins) {
-                if (plugin.platform)
+                if (plugin.platform) {
                     await plugin.platform.onShutdown('Matterbridge is closing: ' + message);
-                if (plugin.platform)
-                    await plugin.platform.saveConfig();
+                    await this.savePluginConfig(plugin);
+                }
             }
             // Set reachability to false
             /*
@@ -631,6 +662,12 @@ export class Matterbridge extends EventEmitter {
             this.log.info(`Registered bridged device ${dev}${device.deviceName}${nf} (${dev}${device.name}${nf}) for plugin ${plg}${pluginName}${nf}`);
         }
     }
+    /**
+     * Removes a bridged device from the Matterbridge.
+     * @param pluginName - The name of the plugin.
+     * @param device - The device to be removed.
+     * @returns A Promise that resolves when the device is successfully removed.
+     */
     async removeBridgedDevice(pluginName, device) {
         if (this.bridgeMode === 'bridge' && !this.matterAggregator) {
             this.log.error(`Removing bridged device ${dev}${device.deviceName}${er} (${dev}${device.name}${er}) for plugin ${plg}${pluginName}${er} error: matterAggregator not found`);
@@ -647,12 +684,10 @@ export class Matterbridge extends EventEmitter {
             this.log.error(`Error removing bridged device ${dev}${device.deviceName}${er} (${dev}${device.name}${er}) plugin ${plg}${pluginName}${er} aggregator not found`);
             return;
         }
-        /*
         if (this.bridgeMode === 'childbridge' && !plugin.connected) {
-          this.log.error(`Error removing bridged device ${dev}${device.deviceName}${er} (${dev}${device.name}${er}) plugin ${plg}${pluginName}${er} not connected`);
-          return;
+            this.log.warn(`Error removing bridged device ${dev}${device.deviceName}${wr} (${dev}${device.name}${wr}) plugin ${plg}${pluginName}${wr} not connected`);
+            return;
         }
-        */
         // Register and add the device to matterbridge aggregator in bridge mode
         if (this.bridgeMode === 'bridge') {
             this.matterAggregator.removeBridgedDevice(device);
@@ -662,11 +697,11 @@ export class Matterbridge extends EventEmitter {
                     return;
                 }
             });
+            this.log.info(`Removed bridged device(${plugin.registeredDevices}/${plugin.addedDevices}) ${dev}${device.deviceName}${nf} (${dev}${device.name}${nf}) for plugin ${plg}${pluginName}${nf}`);
             if (plugin.registeredDevices !== undefined)
                 plugin.registeredDevices--;
             if (plugin.addedDevices !== undefined)
                 plugin.addedDevices--;
-            this.log.info(`Removed bridged device(${plugin.registeredDevices}/${plugin.addedDevices}) ${dev}${device.deviceName}${nf} (${dev}${device.name}${nf}) for plugin ${plg}${pluginName}${nf}`);
         }
         // Only register the device in childbridge mode
         if (this.bridgeMode === 'childbridge') {
@@ -830,6 +865,92 @@ export class Matterbridge extends EventEmitter {
         }
         */
     }
+    /**
+     * Loads the configuration for a plugin.
+     * If the configuration file exists, it reads the file and returns the parsed JSON data.
+     * If the configuration file does not exist, it creates a new file with default configuration and returns it.
+     * If any error occurs during file access or creation, it logs an error and rejects the promise with the error.
+     *
+     * @param plugin - The plugin for which to load the configuration.
+     * @returns A promise that resolves to the loaded or created configuration.
+     */
+    async loadPluginConfig(plugin) {
+        const configFile = path.join(this.matterbridgeDirectory, `${plugin.name}.config.json`);
+        try {
+            await fs.access(configFile);
+            const data = await fs.readFile(configFile, 'utf8');
+            this.log.debug(`Config file found: ${configFile}.\nConfig:${rs}\n`, JSON.parse(data));
+            return JSON.parse(data);
+        }
+        catch (err) {
+            if (err instanceof Error) {
+                const nodeErr = err;
+                if (nodeErr.code === 'ENOENT') {
+                    try {
+                        await this.writeFile(configFile, JSON.stringify({ name: plugin.name, type: plugin.type }, null, 2));
+                        this.log.debug(`Created config file: ${configFile}.\nConfig:${rs}\n`, { name: plugin.name, type: plugin.type });
+                        return { name: plugin.name, type: plugin.type };
+                    }
+                    catch (err) {
+                        this.log.error(`Error creating config file ${configFile}: ${err}`);
+                        return Promise.reject(err);
+                    }
+                }
+                else {
+                    this.log.error(`Error accessing config file ${configFile}: ${err}`);
+                    return Promise.reject(err);
+                }
+            }
+            return Promise.reject(err);
+        }
+    }
+    /**
+     * Saves the configuration of a registered plugin.
+     * @param {RegisteredPlugin} plugin - The plugin whose configuration needs to be saved.
+     * @returns {Promise<void>} - A promise that resolves when the configuration is successfully saved.
+     * @throws {Error} - If the plugin's configuration is not found or if there is an error while saving the configuration.
+     */
+    async savePluginConfig(plugin) {
+        if (!plugin.platform?.config) {
+            this.log.error(`Error saving plugin ${plg}${plugin.name}${er} config: config not found`);
+            return Promise.reject(new Error(`Error saving plugin ${plg}${plugin.name}${er} config: config not found`));
+        }
+        const configFile = path.join(this.matterbridgeDirectory, `${plugin.name}.config.json`);
+        try {
+            await this.writeFile(configFile, JSON.stringify(plugin.platform.config, null, 2));
+            this.log.debug(`Saved config file: ${configFile}.\nConfig:${rs}\n`, plugin.platform.config);
+        }
+        catch (err) {
+            this.log.error(`Error saving plugin ${plg}${plugin.name}${er} config: ${err}`);
+            return Promise.reject(err);
+        }
+    }
+    /**
+     * Writes data to a file.
+     *
+     * @param {string} filePath - The path of the file to write to.
+     * @param {string} data - The data to write to the file.
+     * @returns {Promise<void>} - A promise that resolves when the data is successfully written to the file.
+     */
+    async writeFile(filePath, data) {
+        // Write the data to a file
+        await fs
+            .writeFile(`${filePath}`, data, 'utf8')
+            .then(() => {
+            this.log.debug(`Successfully wrote to ${filePath}`);
+        })
+            .catch((error) => {
+            this.log.error(`Error writing to ${filePath}:`, error);
+        });
+    }
+    /**
+     * Starts a plugin.
+     *
+     * @param {RegisteredPlugin} plugin - The plugin to start.
+     * @param {string} [message] - Optional message to pass to the plugin's onStart method.
+     * @param {boolean} [configure=false] - Indicates whether to configure the plugin after starting.
+     * @returns {Promise<void>} A promise that resolves when the plugin is started successfully, or rejects with an error if starting the plugin fails.
+     */
     async startPlugin(plugin, message, configure = false) {
         if (!plugin.loaded || !plugin.platform) {
             this.log.error(`Plugin ${plg}${plugin.name}${er} not loaded or no platform`);
@@ -860,6 +981,12 @@ export class Matterbridge extends EventEmitter {
             return Promise.reject(new Error(`Failed to start plugin ${plg}${plugin.name}${er}: ${err}`));
         }
     }
+    /**
+     * Configures a plugin.
+     *
+     * @param {RegisteredPlugin} plugin - The plugin to configure.
+     * @returns {Promise<void>} A promise that resolves when the plugin is configured successfully, or rejects with an error if configuration fails.
+     */
     async configurePlugin(plugin) {
         if (!plugin.loaded || !plugin.started || !plugin.platform) {
             this.log.error(`Plugin ${plg}${plugin.name}${er} not loaded or not started or not platform`);
@@ -888,6 +1015,14 @@ export class Matterbridge extends EventEmitter {
             return Promise.reject(new Error(`Failed to configure plugin ${plg}${plugin.name}${er}: ${err}`));
         }
     }
+    /**
+     * Loads a plugin and returns the corresponding MatterbridgePlatform instance.
+     * @param plugin - The plugin to load.
+     * @param start - Optional flag indicating whether to start the plugin after loading. Default is false.
+     * @param message - Optional message to pass to the plugin when starting.
+     * @returns A Promise that resolves to the loaded MatterbridgePlatform instance.
+     * @throws An error if the plugin is not enabled, already loaded, or fails to load.
+     */
     async loadPlugin(plugin, start = false, message = '') {
         if (!plugin.enabled) {
             this.log.error(`Plugin ${plg}${plugin.name}${er} not enabled`);
@@ -910,8 +1045,10 @@ export class Matterbridge extends EventEmitter {
             this.log.debug(`Imported plugin ${plg}${plugin.name}${db} from ${pluginUrl.href}`);
             // Call the default export function of the plugin, passing this MatterBridge instance
             if (pluginInstance.default) {
-                const platform = pluginInstance.default(this, new AnsiLogger({ logName: plugin.description, logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logDebug: this.debugEnabled }));
+                const config = await this.loadPluginConfig(plugin);
+                const platform = pluginInstance.default(this, new AnsiLogger({ logName: plugin.description, logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logDebug: this.debugEnabled }), config);
                 platform.name = packageJson.name;
+                platform.config = config;
                 plugin.name = packageJson.name;
                 plugin.description = packageJson.description;
                 plugin.version = packageJson.version;
@@ -922,7 +1059,6 @@ export class Matterbridge extends EventEmitter {
                 plugin.registeredDevices = 0;
                 plugin.addedDevices = 0;
                 await this.nodeContext?.set('plugins', this.getBaseRegisteredPlugins());
-                await platform.loadConfig();
                 this.log.info(`Loaded plugin ${plg}${plugin.name}${db} type ${typ}${platform.type}${db} (entrypoint ${UNDERLINE}${pluginEntry}${UNDERLINEOFF})`);
                 if (start)
                     this.startPlugin(plugin, message); // No await do it asyncronously
@@ -1113,6 +1249,10 @@ export class Matterbridge extends EventEmitter {
             }, 1000);
         }
     }
+    /**
+     * Starts the Matter server.
+     * If the Matter server is not initialized, it logs an error and performs cleanup.
+     */
     async startMatterServer() {
         if (!this.matterServer) {
             this.log.error('No matter server initialized');
@@ -1182,15 +1322,12 @@ export class Matterbridge extends EventEmitter {
         return storageContext;
     }
     /**
-     * Shows the commissioning QR code for a given commissioning server, storage context, and name.
-     * If any of the parameters are missing, the method returns early.
-     * If the commissioning server is not commissioned, it logs the QR code and pairing code.
-     * If the commissioning server is already commissioned, it waits for controllers to connect.
-     * If the bridge mode is 'childbridge', it sets the 'paired' property of the plugin to true.
-     *
-     * @param commissioningServer - The commissioning server to show the QR code for.
-     * @param storageContext - The storage context to store the pairing codes.
-     * @param pluginName - The name of the commissioning server.
+     * Shows the commissioning QR code for a given plugin.
+     * @param {CommissioningServer} commissioningServer - The commissioning server instance.
+     * @param {StorageContext} storageContext - The storage context instance.
+     * @param {NodeStorage} nodeContext - The node storage instance.
+     * @param {string} pluginName - The name of the plugin.
+     * @returns {Promise<void>} - A promise that resolves when the QR code is shown.
      */
     async showCommissioningQRCode(commissioningServer, storageContext, nodeContext, pluginName) {
         if (!commissioningServer || !storageContext || !pluginName)
@@ -1207,6 +1344,8 @@ export class Matterbridge extends EventEmitter {
             if (pluginName !== 'Matterbridge') {
                 const plugin = this.findPlugin(pluginName);
                 if (plugin) {
+                    plugin.qrPairingCode = qrPairingCode;
+                    plugin.manualPairingCode = manualPairingCode;
                     plugin.paired = false;
                 }
             }
@@ -1528,9 +1667,24 @@ export class Matterbridge extends EventEmitter {
         this.matterbridgeInformation.rootDirectory = this.rootDirectory;
         this.log.debug(`Root Directory: ${this.rootDirectory}`);
         // Global node_modules directory
+        /*
         this.globalModulesDirectory = await this.getGlobalNodeModules();
         this.matterbridgeInformation.globalModulesDirectory = this.globalModulesDirectory;
         this.log.debug(`Global node_modules Directory: ${this.globalModulesDirectory}`);
+        */
+        if (this.nodeContext)
+            this.globalModulesDirectory = await this.nodeContext.get('globalModulesDirectory', '');
+        this.log.debug(`Global node_modules Directory: ${this.globalModulesDirectory}`);
+        this.getGlobalNodeModules()
+            .then(async (globalModulesDirectory) => {
+            this.globalModulesDirectory = globalModulesDirectory;
+            this.matterbridgeInformation.globalModulesDirectory = this.globalModulesDirectory;
+            this.log.debug(`Global node_modules Directory: ${this.globalModulesDirectory}`);
+            await this.nodeContext?.set('globalModulesDirectory', this.globalModulesDirectory);
+        })
+            .catch((error) => {
+            this.log.error(`Error getting global node_modules directory: ${error}`);
+        });
         // Create the data directory .matterbridge in the home directory
         this.matterbridgeDirectory = path.join(this.homeDirectory, '.matterbridge');
         this.matterbridgeInformation.matterbridgeDirectory = this.matterbridgeDirectory;
@@ -1584,12 +1738,28 @@ export class Matterbridge extends EventEmitter {
         this.matterbridgeVersion = packageJson.version;
         this.matterbridgeInformation.matterbridgeVersion = this.matterbridgeVersion;
         this.log.debug(`Matterbridge Version: ${this.matterbridgeVersion}`);
+        // Matterbridge latest version
+        /*
         this.matterbridgeLatestVersion = await this.getLatestVersion('matterbridge');
         this.matterbridgeInformation.matterbridgeLatestVersion = this.matterbridgeLatestVersion;
         this.log.debug(`Matterbridge Latest Version: ${this.matterbridgeLatestVersion}`);
-        if (this.matterbridgeVersion !== this.matterbridgeLatestVersion) {
-            this.log.warn(`Matterbridge is out of date. Current version: ${this.matterbridgeVersion}, Latest version: ${this.matterbridgeLatestVersion}`);
-        }
+        */
+        if (this.nodeContext)
+            this.matterbridgeLatestVersion = await this.nodeContext.get('matterbridgeLatestVersion', '');
+        this.log.debug(`Matterbridge Latest Version: ${this.matterbridgeLatestVersion}`);
+        this.getLatestVersion('matterbridge')
+            .then(async (matterbridgeLatestVersion) => {
+            this.matterbridgeLatestVersion = matterbridgeLatestVersion;
+            this.matterbridgeInformation.matterbridgeLatestVersion = this.matterbridgeLatestVersion;
+            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}`);
+            }
+        })
+            .catch((error) => {
+            this.log.error(`Error getting Matterbridge latest version: ${error}`);
+        });
         // Current working directory
         const currentDir = process.cwd();
         this.log.debug(`Current Working Directory: ${currentDir}`);
@@ -1597,6 +1767,11 @@ export class Matterbridge extends EventEmitter {
         const cmdArgs = process.argv.slice(2).join(' ');
         this.log.debug(`Command Line Arguments: ${cmdArgs}`);
     }
+    /**
+     * Retrieves an array of base registered plugins.
+     *
+     * @returns {BaseRegisteredPlugin[]} An array of base registered plugins.
+     */
     getBaseRegisteredPlugins() {
         const baseRegisteredPlugins = this.registeredPlugins.map((plugin) => ({
             path: plugin.path,
@@ -1617,6 +1792,10 @@ export class Matterbridge extends EventEmitter {
         }));
         return baseRegisteredPlugins;
     }
+    /**
+     * Retrieves an array of base registered devices from the registered plugins.
+     * @returns {BaseRegisteredPlugin[]} An array of base registered devices.
+     */
     getBaseRegisteredDevices() {
         const baseRegisteredPlugins = this.registeredPlugins.map((plugin) => ({
             path: plugin.path,
@@ -1648,6 +1827,7 @@ export class Matterbridge extends EventEmitter {
         this.expressApp.get('/api/qr-code', (req, res) => {
             this.log.debug('The frontend sent /api/qr-code');
             if (!this.matterbridgeContext) {
+                this.log.error('/api/qr-code matterbridgeContext not found');
                 res.json([]);
                 return;
             }
@@ -1751,7 +1931,7 @@ export class Matterbridge extends EventEmitter {
         // Endpoint to receive commands
         this.expressApp.post('/api/command/:command/:param', async (req, res) => {
             const command = req.params.command;
-            const param = req.params.param;
+            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' });
@@ -1787,9 +1967,55 @@ export class Matterbridge extends EventEmitter {
             if (command === 'update') {
                 this.log.warn(`The /api/command/${command} is not yet implemented`);
             }
-            // Handle the command addplugin from Header
+            // Handle the command addplugin from Home C:\Users\lligu\GitHub\matterbridge-example-accessory-platform
             if (command === 'addplugin') {
-                this.log.warn(`The /api/command/${command}/${param} is not yet implemented`);
+                param = param.replace(/\*/g, '\\');
+                if (this.registeredPlugins.find((plugin) => plugin.name === param)) {
+                    this.log.warn(`Plugin ${plg}${param}${wr} already added to matterbridge`);
+                    res.json({ message: 'Command received' });
+                    return;
+                }
+                const packageJsonPath = await this.resolvePluginName(param);
+                if (!packageJsonPath) {
+                    this.log.error(`Error resolving plugin ${plg}${param}${er}`);
+                    res.json({ message: 'Command received' });
+                    return;
+                }
+                this.log.debug(`Loading plugin from ${plg}${packageJsonPath}${db}`);
+                try {
+                    // Load the package.json of the plugin
+                    const packageJson = JSON.parse(await fs.readFile(packageJsonPath, 'utf8'));
+                    const plugin = { path: packageJsonPath, type: '', name: packageJson.name, version: packageJson.version, description: packageJson.description, author: packageJson.author, enabled: true };
+                    if (await this.loadPlugin(plugin)) {
+                        this.registeredPlugins.push(plugin);
+                        await this.nodeContext?.set('plugins', this.getBaseRegisteredPlugins());
+                        this.log.info(`Plugin ${plg}${packageJsonPath}${nf} type ${plugin.type} added to matterbridge. Restart required.`);
+                    }
+                    else {
+                        this.log.error(`Error adding plugin ${plg}${packageJsonPath}${er}`);
+                    }
+                }
+                catch (error) {
+                    this.log.error(`Error adding plugin ${plg}${packageJsonPath}${er}`);
+                    res.json({ message: 'Command received' });
+                    return;
+                }
+            }
+            // Handle the command removeplugin from Home
+            if (command === 'removeplugin') {
+                const index = this.registeredPlugins.findIndex((registeredPlugin) => registeredPlugin.name === param);
+                if (index !== -1) {
+                    if (this.registeredPlugins[index].platform) {
+                        await this.registeredPlugins[index].platform?.onShutdown('The plugin has been removed.');
+                        await this.savePluginConfig(this.registeredPlugins[index]);
+                    }
+                    this.registeredPlugins.splice(index, 1);
+                    await this.nodeContext?.set('plugins', this.getBaseRegisteredPlugins());
+                    this.log.info(`Plugin ${plg}${param}${nf} removed from matterbridge`);
+                }
+                else {
+                    this.log.warn(`Plugin ${plg}${param}${wr} not registered in matterbridge`);
+                }
             }
             // Handle the command enableplugin from Home
             if (command === 'enableplugin') {