matterbridge 3.0.0-edge.8 → 3.0.1-dev-20250430-a3ea2b7

package/dist/frontend.js

@@ -11,7 +11,7 @@ import { AnsiLogger, stringify, debugStringify, CYAN, db, er, nf, rs, UNDERLINE,
 import { createZip, deepCopy, isValidArray, isValidNumber, isValidObject, isValidString } from './utils/export.js';
 import { plg } from './matterbridgeTypes.js';
 import { hasParameter } from './utils/export.js';
-import { BridgedDeviceBasicInformation } from '@matter/main/clusters';
+import { BridgedDeviceBasicInformation, PowerSource } from '@matter/main/clusters';
 export const WS_ID_LOG = 0;
 export const WS_ID_REFRESH_NEEDED = 1;
 export const WS_ID_RESTART_NEEDED = 2;
@@ -369,27 +369,55 @@ export class Frontend {
             });
             res.json(data);
         });
-        this.expressApp.get('/api/view-log', async (req, res) => {
-            this.log.debug('The frontend sent /api/log');
+        this.expressApp.get('/api/view-mblog', async (req, res) => {
+            this.log.debug('The frontend sent /api/view-mblog');
             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');
+                this.log.error(`Error reading matterbridge log file ${this.matterbridge.matterbrideLoggerFile}: ${error instanceof Error ? error.message : error}`);
+                res.status(500).send('Error reading matterbridge log file. Please enable the matterbridge log on file in the settings.');
+            }
+        });
+        this.expressApp.get('/api/view-mjlog', async (req, res) => {
+            this.log.debug('The frontend sent /api/view-mjlog');
+            try {
+                const data = await fs.readFile(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterLoggerFile), 'utf8');
+                res.type('text/plain');
+                res.send(data);
+            }
+            catch (error) {
+                this.log.error(`Error reading matter log file ${this.matterbridge.matterLoggerFile}: ${error instanceof Error ? error.message : error}`);
+                res.status(500).send('Error reading matter log file. Please enable the matter log on file in the settings.');
+            }
+        });
+        this.expressApp.get('/api/shellyviewsystemlog', async (req, res) => {
+            this.log.debug('The frontend sent /api/shellyviewsystemlog');
+            try {
+                const data = await fs.readFile(path.join(this.matterbridge.matterbridgeDirectory, 'shelly.log'), 'utf8');
+                res.type('text/plain');
+                res.send(data);
+            }
+            catch (error) {
+                this.log.error(`Error reading shelly log file ${this.matterbridge.matterbrideLoggerFile}: ${error instanceof Error ? error.message : error}`);
+                res.status(500).send('Error reading shelly log file. Please create the shelly system log before loading it.');
             }
         });
         this.expressApp.get('/api/download-mblog', async (req, res) => {
-            this.log.debug('The frontend sent /api/download-mblog');
+            this.log.debug(`The frontend sent /api/download-mblog ${path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterbrideLoggerFile)}`);
             try {
                 await fs.access(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterbrideLoggerFile), fs.constants.F_OK);
+                const data = await fs.readFile(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterbrideLoggerFile), 'utf8');
+                await fs.writeFile(path.join(os.tmpdir(), this.matterbridge.matterbrideLoggerFile), data, 'utf-8');
             }
             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');
+                await fs.writeFile(path.join(os.tmpdir(), this.matterbridge.matterbrideLoggerFile), 'Enable the matterbridge log on file in the settings to download the matterbridge log.', 'utf-8');
+                this.log.debug(`Error in /api/download-mblog: ${error instanceof Error ? error.message : error}`);
             }
-            res.download(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterbrideLoggerFile), 'matterbridge.log', (error) => {
+            res.type('text/plain');
+            res.download(path.join(os.tmpdir(), 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');
@@ -397,14 +425,18 @@ export class Frontend {
             });
         });
         this.expressApp.get('/api/download-mjlog', async (req, res) => {
-            this.log.debug('The frontend sent /api/download-mjlog');
+            this.log.debug(`The frontend sent /api/download-mjlog ${path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterbrideLoggerFile)}`);
             try {
                 await fs.access(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterLoggerFile), fs.constants.F_OK);
+                const data = await fs.readFile(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterLoggerFile), 'utf8');
+                await fs.writeFile(path.join(os.tmpdir(), this.matterbridge.matterLoggerFile), data, 'utf-8');
             }
             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');
+                await fs.writeFile(path.join(os.tmpdir(), this.matterbridge.matterLoggerFile), 'Enable the matter log on file in the settings to download the matter log.', 'utf-8');
+                this.log.debug(`Error in /api/download-mblog: ${error instanceof Error ? error.message : error}`);
             }
-            res.download(path.join(this.matterbridge.matterbridgeDirectory, this.matterbridge.matterLoggerFile), 'matter.log', (error) => {
+            res.type('text/plain');
+            res.download(path.join(os.tmpdir(), 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');
@@ -415,11 +447,15 @@ export class Frontend {
             this.log.debug('The frontend sent /api/shellydownloadsystemlog');
             try {
                 await fs.access(path.join(this.matterbridge.matterbridgeDirectory, 'shelly.log'), fs.constants.F_OK);
+                const data = await fs.readFile(path.join(this.matterbridge.matterbridgeDirectory, 'shelly.log'), 'utf8');
+                await fs.writeFile(path.join(os.tmpdir(), 'shelly.log'), data, 'utf-8');
             }
             catch (error) {
-                fs.appendFile(path.join(this.matterbridge.matterbridgeDirectory, 'shelly.log'), 'Create the Shelly system log before downloading it.');
+                await fs.writeFile(path.join(os.tmpdir(), 'shelly.log'), 'Create the Shelly system log before downloading it.', 'utf-8');
+                this.log.debug(`Error in /api/shellydownloadsystemlog: ${error instanceof Error ? error.message : error}`);
             }
-            res.download(path.join(this.matterbridge.matterbridgeDirectory, 'shelly.log'), 'shelly.log', (error) => {
+            res.type('text/plain');
+            res.download(path.join(os.tmpdir(), 'shelly.log'), 'shelly.log', (error) => {
                 if (error) {
                     this.log.error(`Error downloading Shelly system log file: ${error instanceof Error ? error.message : error}`);
                     res.status(500).send('Error downloading Shelly system log file');
@@ -814,9 +850,8 @@ export class Frontend {
                 res.status(500).send(`Error uploading or installing plugin package ${filename}`);
             }
         });
-        this.expressApp.get('*', (req, res) => {
+        this.expressApp.use((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}`);
@@ -919,6 +954,28 @@ export class Frontend {
             return true;
         return false;
     }
+    getPowerSource(device) {
+        if (!device.lifecycle.isReady || device.construction.status !== Lifecycle.Status.Active)
+            return undefined;
+        const powerSource = (device) => {
+            const featureMap = device.getAttribute(PowerSource.Cluster.id, 'featureMap');
+            if (featureMap.wired) {
+                const wiredCurrentType = device.getAttribute(PowerSource.Cluster.id, 'wiredCurrentType');
+                return ['ac', 'dc'][wiredCurrentType];
+            }
+            if (featureMap.battery) {
+                const batChargeLevel = device.getAttribute(PowerSource.Cluster.id, 'batChargeLevel');
+                return ['ok', 'warning', 'critical'][batChargeLevel];
+            }
+            return;
+        };
+        if (device.hasClusterServer(PowerSource.Cluster.id))
+            return powerSource(device);
+        for (const child of device.getChildEndpoints()) {
+            if (child.hasClusterServer(PowerSource.Cluster.id))
+                return powerSource(child);
+        }
+    }
     getClusterTextFromDevice(device) {
         if (!device.lifecycle.isReady || device.construction.status !== Lifecycle.Status.Active)
             return '';
@@ -958,6 +1015,7 @@ export class Frontend {
                 return '';
         };
         let attributes = '';
+        let supportedModes = [];
         device.forEachAttribute((clusterName, clusterId, attributeName, attributeId, attributeValue) => {
             if (typeof attributeValue === 'undefined')
                 return;
@@ -975,6 +1033,20 @@ export class Frontend {
                 attributes += `Heat to: ${attributeValue / 100}°C `;
             if (clusterName === 'thermostat' && attributeName === 'occupiedCoolingSetpoint' && isValidNumber(attributeValue))
                 attributes += `Cool to: ${attributeValue / 100}°C `;
+            const modeClusters = ['modeSelect', 'rvcRunMode', 'rvcCleanMode', 'laundryWasherMode', 'ovenMode', 'microwaveOvenMode'];
+            if (modeClusters.includes(clusterName) && attributeName === 'supportedModes') {
+                supportedModes = attributeValue;
+            }
+            if (modeClusters.includes(clusterName) && attributeName === 'currentMode') {
+                const supportedMode = supportedModes.find((mode) => mode.mode === attributeValue);
+                if (supportedMode)
+                    attributes += `Mode: ${supportedMode.label} `;
+                else
+                    attributes += `Mode: ${attributeValue} `;
+            }
+            const operationalStateClusters = ['operationalState', 'rvcOperationalState'];
+            if (operationalStateClusters.includes(clusterName) && attributeName === 'operationalState')
+                attributes += `OpState: ${attributeValue} `;
             if (clusterName === 'pumpConfigurationAndControl' && attributeName === 'operationMode')
                 attributes += `Mode: ${attributeValue} `;
             if (clusterName === 'valveConfigurationAndControl' && attributeName === 'currentState')
@@ -1053,6 +1125,7 @@ export class Frontend {
                 changelog: plugin.changelog,
                 funding: plugin.funding,
                 latestVersion: plugin.latestVersion,
+                serialNumber: plugin.serialNumber,
                 locked: plugin.locked,
                 error: plugin.error,
                 enabled: plugin.enabled,
@@ -1244,6 +1317,7 @@ export class Frontend {
                         configUrl: device.configUrl,
                         uniqueId: device.uniqueId,
                         reachable: this.getReachability(device),
+                        powerSource: this.getPowerSource(device),
                         cluster: cluster,
                     });
                 });
@@ -1396,7 +1470,7 @@ export class Frontend {
                     return;
                 }
                 this.log.notice(`Action ${CYAN}${data.params.action}${nt}${data.params.value ? ' with ' + CYAN + data.params.value + nt : ''} for plugin ${CYAN}${plugin.name}${nt}`);
-                plugin.platform?.onAction(data.params.action, data.params.value, data.params.id).catch((error) => {
+                plugin.platform?.onAction(data.params.action, data.params.value, data.params.id, data.params.formData).catch((error) => {
                     this.log.error(`Error in plugin ${plugin.name} action ${data.params.action}: ${error}`);
                 });
             }
@@ -1503,6 +1577,7 @@ export class Frontend {
         message = message.replace(/[\t\n]/g, '');
         message = message.replace(/[\x00-\x1F\x7F]/g, '');
         message = message.replace(/\\"/g, '"');
+        message = message.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
         const maxContinuousLength = 100;
         const keepStartLength = 20;
         const keepEndLength = 20;

package/dist/matterbridge.js

@@ -5,7 +5,7 @@ import EventEmitter from 'node:events';
 import { inspect } from 'node:util';
 import { AnsiLogger, UNDERLINE, UNDERLINEOFF, YELLOW, db, debugStringify, BRIGHT, RESET, er, nf, rs, wr, RED, GREEN, zb, CYAN } from './logger/export.js';
 import { NodeStorageManager } from './storage/export.js';
-import { getParameter, getIntParameter, hasParameter, copyDirectory, withTimeout } from './utils/export.js';
+import { getParameter, getIntParameter, hasParameter, copyDirectory, withTimeout, waiter } from './utils/export.js';
 import { logInterfaces, getGlobalNodeModules } from './utils/network.js';
 import { PluginManager } from './pluginManager.js';
 import { DeviceManager } from './deviceManager.js';
@@ -51,6 +51,8 @@ export class Matterbridge extends EventEmitter {
         globalModulesDirectory: '',
         matterbridgeVersion: '',
         matterbridgeLatestVersion: '',
+        matterbridgeDevVersion: '',
+        matterbridgeSerialNumber: '',
         matterbridgeQrPairingCode: undefined,
         matterbridgeManualPairingCode: undefined,
         matterbridgeFabricInformations: [],
@@ -85,6 +87,7 @@ export class Matterbridge extends EventEmitter {
     globalModulesDirectory = '';
     matterbridgeVersion = '';
     matterbridgeLatestVersion = '';
+    matterbridgeDevVersion = '';
     matterbridgeQrPairingCode = undefined;
     matterbridgeManualPairingCode = undefined;
     matterbridgeFabricInformations = undefined;
@@ -491,6 +494,13 @@ export class Matterbridge extends EventEmitter {
       - nosudo:                force not to use sudo to install or update packages if the internal logic fails
       - norestore:             force not to automatically restore the matterbridge node storage and the matter storage from backup if it is corrupted
       - ssl:                   enable SSL for the frontend and WebSockerServer (certificates in .matterbridge/certs directory cert.pem, key.pem and ca.pem (optional))
+      - vendorId:              override the default vendorId 0xfff1
+      - vendorName:            override the default vendorName "Matterbridge"
+      - productId:             override the default productId 0x8000
+      - productName:           override the default productName "Matterbridge aggregator"
+      - service:               enable the service mode (used in the systemctl configuration file)
+      - docker:                enable the docker mode (used in the Dockerfile to build the docker image)
+      - homedir:               override the home directory (default: os.homedir())
       - add [plugin path]:     register the plugin from the given absolute or relative path
       - add [plugin name]:     register the globally installed plugin with the given name
       - remove [plugin path]:  remove the plugin from the given absolute or relative path
@@ -625,7 +635,7 @@ export class Matterbridge extends EventEmitter {
         this.checkUpdateInterval = setInterval(async () => {
             const { checkUpdates } = await import('./update.js');
             checkUpdates(this);
-        }, 24 * 60 * 60 * 1000).unref();
+        }, 12 * 60 * 60 * 1000).unref();
         if (hasParameter('test')) {
             this.bridgeMode = 'bridge';
             MatterbridgeEndpoint.bridgeMode = 'bridge';
@@ -687,11 +697,15 @@ export class Matterbridge extends EventEmitter {
         process.removeAllListeners('uncaughtException');
         process.removeAllListeners('unhandledRejection');
         this.exceptionHandler = async (error) => {
-            this.log.error('Unhandled Exception detected at:', error.stack || error, rs);
+            const errorMessage = error instanceof Error ? error.message : error;
+            const errorInspect = inspect(error, { depth: 10 });
+            this.log.error(`Unhandled Exception detected: ${errorMessage}\nstack: ${errorInspect}}`);
         };
         process.on('uncaughtException', this.exceptionHandler);
         this.rejectionHandler = async (reason, promise) => {
-            this.log.error('Unhandled Rejection detected at:', promise, 'reason:', reason instanceof Error ? reason.stack : reason, rs);
+            const errorMessage = reason instanceof Error ? reason.message : reason;
+            const errorInspect = inspect(reason, { depth: 10 });
+            this.log.error(`Unhandled Rejection detected: ${promise}\nreason: ${errorMessage}\nstack: ${errorInspect}`);
         };
         process.on('unhandledRejection', this.rejectionHandler);
         this.log.debug(`Registering SIGINT and SIGTERM signal handlers...`);
@@ -1165,6 +1179,7 @@ export class Matterbridge extends EventEmitter {
             plugin.device = device;
             plugin.storageContext = await this.createServerNodeContext(plugin.name, device.deviceName, DeviceTypeId(device.deviceType), device.vendorId, device.vendorName, device.productId, device.productName);
             plugin.serverNode = await this.createServerNode(plugin.storageContext, this.port ? this.port++ : undefined, this.passcode ? this.passcode++ : undefined, this.discriminator ? this.discriminator++ : undefined);
+            plugin.serialNumber = await plugin.storageContext.get('serialNumber', '');
             this.log.debug(`Adding ${plg}${plugin.name}${db}:${dev}${device.deviceName}${db} to ${plg}${plugin.name}${db} server node`);
             await plugin.serverNode.add(device);
             if (start)
@@ -1174,9 +1189,10 @@ export class Matterbridge extends EventEmitter {
     async createDynamicPlugin(plugin, start = false) {
         if (!plugin.locked) {
             plugin.locked = true;
-            plugin.storageContext = await this.createServerNodeContext(plugin.name, 'Matterbridge', bridge.code, this.aggregatorVendorId, 'Matterbridge', this.aggregatorProductId, plugin.description);
+            plugin.storageContext = await this.createServerNodeContext(plugin.name, 'Matterbridge', bridge.code, this.aggregatorVendorId, this.aggregatorVendorName, this.aggregatorProductId, plugin.description);
             plugin.serverNode = await this.createServerNode(plugin.storageContext, this.port ? this.port++ : undefined, this.passcode ? this.passcode++ : undefined, this.discriminator ? this.discriminator++ : undefined);
             plugin.aggregatorNode = await this.createAggregatorNode(plugin.storageContext);
+            plugin.serialNumber = await plugin.storageContext.get('serialNumber', '');
             await plugin.serverNode.add(plugin.aggregatorNode);
             if (start)
                 await this.startServerNode(plugin.serverNode);
@@ -1249,13 +1265,6 @@ export class Matterbridge extends EventEmitter {
     async startChildbridge() {
         if (!this.matterStorageManager)
             throw new Error('No storage manager initialized');
-        for (const plugin of this.plugins) {
-            if (!plugin.enabled)
-                continue;
-            if (plugin.type === 'DynamicPlatform') {
-                await this.createDynamicPlugin(plugin);
-            }
-        }
         await this.startPlugins();
         this.log.debug('Starting start matter interval in childbridge mode...');
         let failCount = 0;
@@ -1358,6 +1367,7 @@ export class Matterbridge extends EventEmitter {
         this.matterStorageManager = await this.matterStorageService.open('Matterbridge');
         this.log.info('Matter node storage manager "Matterbridge" created');
         this.matterbridgeContext = await this.createServerNodeContext('Matterbridge', 'Matterbridge', bridge.code, this.aggregatorVendorId, this.aggregatorVendorName, this.aggregatorProductId, this.aggregatorProductName);
+        this.matterbridgeInformation.matterbridgeSerialNumber = await this.matterbridgeContext.get('serialNumber', '');
         this.log.info('Matter node storage started');
         await this.backupMatterStorage(path.join(this.matterbridgeDirectory, this.matterStorageName), path.join(this.matterbridgeDirectory, this.matterStorageName + '.backup'));
     }
@@ -1368,7 +1378,7 @@ export class Matterbridge extends EventEmitter {
     }
     async stopMatterStorage() {
         this.log.info('Closing matter node storage...');
-        this.matterStorageManager?.close();
+        await this.matterStorageManager?.close();
         this.matterStorageService = undefined;
         this.matterStorageManager = undefined;
         this.matterbridgeContext = undefined;
@@ -1507,6 +1517,8 @@ export class Matterbridge extends EventEmitter {
                     }
                 }
                 setTimeout(() => {
+                    if (serverNode.lifecycle.isCommissioned)
+                        return;
                     if (this.bridgeMode === 'bridge') {
                         this.matterbridgeQrPairingCode = undefined;
                         this.matterbridgeManualPairingCode = undefined;
@@ -1516,10 +1528,12 @@ export class Matterbridge extends EventEmitter {
                         if (plugin) {
                             plugin.qrPairingCode = undefined;
                             plugin.manualPairingCode = undefined;
-                            this.frontend.wssSendRefreshRequired('plugins');
                         }
                     }
+                    this.frontend.wssSendRefreshRequired('plugins');
                     this.frontend.wssSendRefreshRequired('settings');
+                    this.frontend.wssSendRefreshRequired('fabrics');
+                    this.frontend.wssSendRefreshRequired('sessions');
                     this.frontend.wssSendSnackbarMessage(`Advertising on server node for ${storeId} stopped. Restart to commission.`, 0);
                     this.log.notice(`Advertising on server node for ${storeId} stopped. Restart to commission.`);
                 }, 15 * 60 * 1000).unref();
@@ -1651,16 +1665,17 @@ export class Matterbridge extends EventEmitter {
         }
         if (this.bridgeMode === 'bridge') {
             this.log.debug(`Adding bridged endpoint ${plg}${pluginName}${db}:${dev}${device.deviceName}${db} to Matterbridge aggregator node`);
-            if (!this.aggregatorNode)
+            if (!this.aggregatorNode) {
                 this.log.error('Aggregator node not found for Matterbridge');
+                return;
+            }
             try {
-                await this.aggregatorNode?.add(device);
+                await this.aggregatorNode.add(device);
             }
             catch (error) {
-                const errorMessage = error instanceof Error ? error.message : '';
-                const errorStack = error instanceof Error ? error.stack : '';
-                const errorDebug = inspect(error, { depth: 10 });
-                this.log.error(`Error adding bridged endpoint ${dev}${device.deviceName}${er} (${zb}${device.id}${er}) for plugin ${plg}${pluginName}${er}: ${error} ${errorMessage} ${errorStack} ${errorDebug}`);
+                const errorMessage = error instanceof Error ? error.message : error;
+                const errorInspect = inspect(error, { depth: 10 });
+                this.log.error(`Error adding bridged endpoint ${dev}${device.deviceName}${er} (${zb}${device.id}${er}) for plugin ${plg}${pluginName}${er}: ${errorMessage}\nstack: ${errorInspect}`);
                 return;
             }
         }
@@ -1668,29 +1683,34 @@ export class Matterbridge extends EventEmitter {
             if (plugin.type === 'AccessoryPlatform') {
                 try {
                     this.log.debug(`Creating endpoint ${dev}${device.deviceName}${db} for AccessoryPlatform plugin ${plg}${plugin.name}${db} server node`);
+                    if (plugin.serverNode) {
+                        this.log.error(`The plugin ${plg}${plugin.name}${er} has already added a device. Only one device is allowed per AccessoryPlatform plugin.`);
+                        return;
+                    }
                     await this.createAccessoryPlugin(plugin, device);
                 }
                 catch (error) {
-                    const errorMessage = error instanceof Error ? error.message : '';
-                    const errorStack = error instanceof Error ? error.stack : '';
-                    const errorDebug = inspect(error, { depth: 10 });
-                    this.log.error(`Error creating endpoint ${dev}${device.deviceName}${er} (${zb}${device.id}${er}) for AccessoryPlatform plugin ${plg}${pluginName}${er} server node: ${error} ${errorMessage} ${errorStack} ${errorDebug}`);
+                    const errorMessage = error instanceof Error ? error.message : error;
+                    const errorInspect = inspect(error, { depth: 10 });
+                    this.log.error(`Error creating endpoint ${dev}${device.deviceName}${er} (${zb}${device.id}${er}) for AccessoryPlatform plugin ${plg}${pluginName}${er} server node: ${errorMessage}\nstack: ${errorInspect}`);
                     return;
                 }
             }
             if (plugin.type === 'DynamicPlatform') {
-                plugin.locked = true;
-                this.log.debug(`Adding bridged endpoint ${dev}${device.deviceName}${db} for DynamicPlatform plugin ${plg}${plugin.name}${db} aggregator node`);
-                if (!plugin.aggregatorNode)
-                    this.log.error(`Aggregator node not found for plugin ${plg}${plugin.name}${db}`);
                 try {
-                    await plugin.aggregatorNode?.add(device);
+                    this.log.debug(`Adding bridged endpoint ${dev}${device.deviceName}${db} for DynamicPlatform plugin ${plg}${plugin.name}${db} aggregator node`);
+                    await this.createDynamicPlugin(plugin);
+                    await waiter(`createDynamicPlugin(${plugin.name})`, () => plugin.serverNode?.hasParts === true);
+                    if (!plugin.aggregatorNode) {
+                        this.log.error(`Aggregator node not found for plugin ${plg}${plugin.name}${er}`);
+                        return;
+                    }
+                    await plugin.aggregatorNode.add(device);
                 }
                 catch (error) {
-                    const errorMessage = error instanceof Error ? error.message : '';
-                    const errorStack = error instanceof Error ? error.stack : '';
-                    const errorDebug = inspect(error, { depth: 10 });
-                    this.log.error(`Error adding bridged endpoint ${dev}${device.deviceName}${er} (${zb}${device.id}${er}) for DynamicPlatform plugin ${plg}${pluginName}${er} aggregator node: ${error} ${errorMessage} ${errorStack} ${errorDebug}`);
+                    const errorMessage = error instanceof Error ? error.message : error;
+                    const errorInspect = inspect(error, { depth: 10 });
+                    this.log.error(`Error adding bridged endpoint ${dev}${device.deviceName}${er} (${zb}${device.id}${er}) for DynamicPlatform plugin ${plg}${pluginName}${er} aggregator node: ${errorMessage}\nstack: ${errorInspect}`);
                     return;
                 }
             }

package/dist/matterbridgeEndpoint.js

@@ -27,6 +27,7 @@ import { ElectricalEnergyMeasurement } from '@matter/main/clusters/electrical-en
 import { AirQuality } from '@matter/main/clusters/air-quality';
 import { ConcentrationMeasurement } from '@matter/main/clusters/concentration-measurement';
 import { OccupancySensing } from '@matter/main/clusters/occupancy-sensing';
+import { ThermostatUserInterfaceConfiguration } from '@matter/main/clusters/thermostat-user-interface-configuration';
 import { DescriptorServer } from '@matter/main/behaviors/descriptor';
 import { PowerSourceServer } from '@matter/main/behaviors/power-source';
 import { BridgedDeviceBasicInformationServer } from '@matter/main/behaviors/bridged-device-basic-information';
@@ -59,6 +60,7 @@ import { FanControlServer } from '@matter/main/behaviors/fan-control';
 import { ResourceMonitoring } from '@matter/main/clusters/resource-monitoring';
 import { HepaFilterMonitoringServer } from '@matter/main/behaviors/hepa-filter-monitoring';
 import { ActivatedCarbonFilterMonitoringServer } from '@matter/main/behaviors/activated-carbon-filter-monitoring';
+import { ThermostatUserInterfaceConfigurationServer } from '@matter/main/behaviors/thermostat-user-interface-configuration';
 export class MatterbridgeEndpoint extends Endpoint {
     static bridgeMode = '';
     static logLevel = "info";
@@ -760,6 +762,14 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    createDefaultThermostatUserInterfaceConfigurationClusterServer() {
+        this.behaviors.require(ThermostatUserInterfaceConfigurationServer, {
+            temperatureDisplayMode: ThermostatUserInterfaceConfiguration.TemperatureDisplayMode.Celsius,
+            keypadLockout: ThermostatUserInterfaceConfiguration.KeypadLockout.NoLockout,
+            scheduleProgrammingVisibility: ThermostatUserInterfaceConfiguration.ScheduleProgrammingVisibility.ScheduleProgrammingPermitted,
+        });
+        return this;
+    }
     createDefaultFanControlClusterServer(fanMode = FanControl.FanMode.Off) {
         this.behaviors.require(MatterbridgeFanControlServer.with(FanControl.Feature.MultiSpeed, FanControl.Feature.Auto, FanControl.Feature.Step), {
             fanMode,
@@ -782,18 +792,24 @@ export class MatterbridgeEndpoint extends Endpoint {
         return this;
     }
     createDefaultHepaFilterMonitoringClusterServer(changeIndication = ResourceMonitoring.ChangeIndication.Ok, inPlaceIndicator = undefined, lastChangedTime = undefined) {
-        this.behaviors.require(HepaFilterMonitoringServer, {
+        this.behaviors.require(HepaFilterMonitoringServer.with(ResourceMonitoring.Feature.Condition, ResourceMonitoring.Feature.ReplacementProductList), {
+            condition: 100,
+            degradationDirection: ResourceMonitoring.DegradationDirection.Down,
             changeIndication,
             inPlaceIndicator,
             lastChangedTime,
+            replacementProductList: [],
         });
         return this;
     }
     createDefaultActivatedCarbonFilterMonitoringClusterServer(changeIndication = ResourceMonitoring.ChangeIndication.Ok, inPlaceIndicator = undefined, lastChangedTime = undefined) {
-        this.behaviors.require(ActivatedCarbonFilterMonitoringServer, {
+        this.behaviors.require(ActivatedCarbonFilterMonitoringServer.with(ResourceMonitoring.Feature.Condition, ResourceMonitoring.Feature.ReplacementProductList), {
+            condition: 100,
+            degradationDirection: ResourceMonitoring.DegradationDirection.Down,
             changeIndication,
             inPlaceIndicator,
             lastChangedTime,
+            replacementProductList: [],
         });
         return this;
     }

package/dist/matterbridgeEndpointHelpers.js

@@ -399,6 +399,20 @@ export function getAttributeId(endpoint, cluster, attribute) {
             else if (attribute === 'levelValue')
                 return 0xa;
         }
+        if (endpoint.behaviors.supported[lowercaseFirstLetter(cluster)]?.schema?.type === 'OperationalState') {
+            if (attribute === 'phaseList')
+                return 0x0;
+            else if (attribute === 'currentPhase')
+                return 0x1;
+            else if (attribute === 'countdownTime')
+                return 0x2;
+            else if (attribute === 'operationalStateList')
+                return 0x3;
+            else if (attribute === 'operationalState')
+                return 0x4;
+            else if (attribute === 'operationalError')
+                return 0x5;
+        }
         return endpoint.behaviors.supported[lowercaseFirstLetter(cluster)]?.schema?.children?.find((child) => child.name === capitalizeFirstLetter(attribute))?.id;
     }
 }

package/dist/matterbridgePlatform.js

@@ -84,8 +84,8 @@ export class MatterbridgePlatform {
     async onChangeLoggerLevel(logLevel) {
         this.log.debug(`The plugin doesn't override onChangeLoggerLevel. Logger level set to: ${logLevel}`);
     }
-    async onAction(action, value, id) {
-        this.log.debug(`The plugin ${CYAN}${this.name}${db} doesn't override onAction. Received action ${CYAN}${action}${db}${value ? ' with ' + CYAN + value + db : ''} ${id ? ' for schema ' + CYAN + id + db : ''}`);
+    async onAction(action, value, id, formData) {
+        this.log.debug(`The plugin ${CYAN}${this.name}${db} doesn't override onAction. Received action ${CYAN}${action}${db}${value ? ' with ' + CYAN + value + db : ''} ${id ? ' for schema ' + CYAN + id + db : ''}`, formData);
     }
     async onConfigChanged(config) {
         this.log.debug(`The plugin ${CYAN}${config.name}${db} doesn't override onConfigChanged. Received new config.`);

package/dist/update.js

@@ -3,6 +3,7 @@ import { db, nt, wr } from './logger/export.js';
 export async function checkUpdates(matterbridge) {
     const { hasParameter } = await import('./utils/parameter.js');
     getMatterbridgeLatestVersion(matterbridge);
+    getMatterbridgeDevVersion(matterbridge);
     for (const plugin of matterbridge.plugins) {
         getPluginLatestVersion(matterbridge, plugin);
     }
@@ -32,6 +33,23 @@ async function getMatterbridgeLatestVersion(matterbridge) {
         matterbridge.log.warn(`Error getting Matterbridge latest version: ${error.message}`);
     });
 }
+async function getMatterbridgeDevVersion(matterbridge) {
+    const { getNpmPackageVersion } = await import('./utils/network.js');
+    getNpmPackageVersion('matterbridge', 'dev')
+        .then(async (version) => {
+        matterbridge.matterbridgeDevVersion = version;
+        matterbridge.matterbridgeInformation.matterbridgeDevVersion = version;
+        await matterbridge.nodeContext?.set('matterbridgeDevVersion', version);
+        if (matterbridge.matterbridgeVersion.includes('-dev.') && matterbridge.matterbridgeVersion !== version) {
+            matterbridge.log.notice(`Matterbridge@dev is out of date. Current version: ${matterbridge.matterbridgeVersion}. Latest dev version: ${matterbridge.matterbridgeDevVersion}.`);
+            matterbridge.frontend.wssSendRefreshRequired('matterbridgeDevVersion');
+            matterbridge.frontend.wssSendUpdateRequired();
+        }
+    })
+        .catch((error) => {
+        matterbridge.log.warn(`Error getting Matterbridge latest dev version: ${error.message}`);
+    });
+}
 async function getPluginLatestVersion(matterbridge, plugin) {
     const { getNpmPackageVersion } = await import('./utils/network.js');
     getNpmPackageVersion(plugin.name)

package/dist/utils/parameter.js

@@ -1,3 +1,10 @@
+export function hasParameter(name) {
+    const commandArguments = process.argv.slice(2);
+    let markerIncluded = commandArguments.includes(`-${name}`);
+    if (!markerIncluded)
+        markerIncluded = commandArguments.includes(`--${name}`);
+    return markerIncluded;
+}
 import { isValidNumber } from './export.js';
 export function getParameter(name) {
     const commandArguments = process.argv.slice(2);
@@ -8,13 +15,6 @@ export function getParameter(name) {
         return undefined;
     return commandArguments[markerIndex + 1];
 }
-export function hasParameter(name) {
-    const commandArguments = process.argv.slice(2);
-    let markerIncluded = commandArguments.includes(`-${name}`);
-    if (!markerIncluded)
-        markerIncluded = commandArguments.includes(`--${name}`);
-    return markerIncluded;
-}
 export function getIntParameter(name) {
     const value = getParameter(name);
     if (value === undefined)
@@ -24,3 +24,35 @@ export function getIntParameter(name) {
         return undefined;
     return intValue;
 }
+export function getIntArrayParameter(name) {
+    const commandArguments = process.argv.slice(2);
+    let markerIndex = commandArguments.indexOf(`--${name}`);
+    if (markerIndex < 0)
+        markerIndex = commandArguments.indexOf(`-${name}`);
+    if (markerIndex < 0)
+        return undefined;
+    const intValues = [];
+    for (let i = markerIndex + 1; i < commandArguments.length && !commandArguments[i].startsWith('-'); i++) {
+        const intValue = parseInt(commandArguments[i], 10);
+        if (isValidNumber(intValue))
+            intValues.push(intValue);
+    }
+    if (intValues.length === 0)
+        return undefined;
+    return intValues;
+}
+export function getStringArrayParameter(name) {
+    const commandArguments = process.argv.slice(2);
+    let markerIndex = commandArguments.indexOf(`--${name}`);
+    if (markerIndex < 0)
+        markerIndex = commandArguments.indexOf(`-${name}`);
+    if (markerIndex < 0)
+        return undefined;
+    const values = [];
+    for (let i = markerIndex + 1; i < commandArguments.length && !commandArguments[i].startsWith('-'); i++) {
+        values.push(commandArguments[i]);
+    }
+    if (values.length === 0)
+        return undefined;
+    return values;
+}

package/dist/utils/wait.js

@@ -1,6 +1,8 @@
 import { AnsiLogger } from '../logger/export.js';
 const log = new AnsiLogger({ logName: 'MatterbridgeUtils', logTimestampFormat: 4, logLevel: "info" });
 export async function waiter(name, check, exitWithReject = false, resolveTimeout = 5000, resolveInterval = 500, debug = false) {
+    if (check())
+        return true;
     log.logLevel = "debug";
     log.logName = 'Waiter';
     if (debug)