@matterbridge/core 3.10.10-dev-20260917-9fdf275 → 3.10.10-dev-20260917-332fed8

package/dist/cli.js

@@ -180,6 +180,7 @@ function help() {
       --fixed_delay [seconds]: set a fixed delay in seconds before starting Matterbridge (default 120)
       --no-ansi:               disable ANSI color output in the logs
       --reset-sessions:        reset sessions and resumption records on shutdown (use only if your controller has issue reconnecting on restart)
+      --configuration-version: increment by one the configuration version of all the server nodes when they go online (add a value to set it instead, i.e. --configuration-version 5)
   `);
     process.exit(0);
 }

package/dist/demoDevices.js

@@ -160,6 +160,7 @@ export async function createDemoDevices(matterbridge) {
         author: 'https://github.com/Luligu',
         enabled: false,
         private: true,
+        configurationVersion: 1,
         registeredDevices: 0,
         configJson: demoPluginConfig,
         schemaJson: demoPluginSchema,

package/dist/frontend.js

@@ -1268,6 +1268,7 @@ export class Frontend extends EventEmitter {
                 name: plugin.name,
                 version: plugin.version,
                 private: plugin.private,
+                configurationVersion: plugin.configurationVersion,
                 description: plugin.description,
                 author: plugin.author,
                 homepage: plugin.homepage,

package/dist/matterNode.js

@@ -19,7 +19,7 @@ import { copyDirectory } from '@matterbridge/utils/copy-dir';
 import { getErrorMessage, inspectError } from '@matterbridge/utils/error';
 import { logModuleLoaded } from '@matterbridge/utils/loader';
 import { isValidInteger, isValidString, parseVersionString } from '@matterbridge/utils/validate';
-import { wait, withTimeout } from '@matterbridge/utils/wait';
+import { fireAndForget, wait, withTimeout } from '@matterbridge/utils/wait';
 import { AnsiLogger, BLUE, CYAN, db, debugStringify, er, nf, or, zb } from 'node-ansi-logger';
 import { NodeStorageManager } from 'node-persist-manager';
 import { toBaseDevice } from './deviceManager.js';
@@ -490,6 +490,13 @@ export class MatterNode extends EventEmitter {
         });
         serverNode.lifecycle.online.on(() => {
             this.log.notice(`Server node for ${storeId} is online`);
+            this.log.info(`Configuration version for server node ${storeId} is ${serverNode.state.basicInformation.configurationVersion}`);
+            if (hasParameter('configuration-version')) {
+                let configurationVersion = getIntParameter('configuration-version') ?? serverNode.state.basicInformation.configurationVersion + 1;
+                configurationVersion = Math.min(Math.max(configurationVersion, 1), UINT32_MAX);
+                fireAndForget(serverNode.setStateOf(BasicInformationServer, { configurationVersion }), this.log, `Failed to set configuration version for server node ${storeId}`);
+                this.log.notice(`Configuration version for server node ${storeId} is now ${configurationVersion}`);
+            }
             if (!serverNode.lifecycle.isCommissioned) {
                 this.log.notice(`Server node for ${storeId} is not commissioned. Pair to commission ...`);
                 this.advertisingNodes.set(storeId, Date.now());
@@ -640,7 +647,7 @@ export class MatterNode extends EventEmitter {
         if (!plugin.locked) {
             plugin.locked = true;
             this.log.debug(`Creating dynamic plugin ${plg}${plugin.name}${db} server node...`);
-            this.matterStorageContext = await this.createServerNodeContext(plugin.name, plugin.description, this.aggregatorDeviceType, this.aggregatorVendorId, this.aggregatorVendorName, this.aggregatorProductId, this.aggregatorProductName, undefined, undefined, parseVersionString(this.matterbridge.matterbridgeVersion), this.matterbridge.matterbridgeVersion, parseVersionString(this.matterbridge.systemInformation.osRelease), this.matterbridge.systemInformation.osRelease, plugin.description, plugin.homepage ?? 'https://matterbridge.io', 1);
+            this.matterStorageContext = await this.createServerNodeContext(plugin.name, plugin.description, this.aggregatorDeviceType, this.aggregatorVendorId, this.aggregatorVendorName, this.aggregatorProductId, this.aggregatorProductName, undefined, undefined, parseVersionString(this.matterbridge.matterbridgeVersion), this.matterbridge.matterbridgeVersion, parseVersionString(this.matterbridge.systemInformation.osRelease), this.matterbridge.systemInformation.osRelease, plugin.description, plugin.homepage ?? 'https://matterbridge.io', plugin.configurationVersion);
             this.serverNode = await this.createServerNode(this.port ? this.port++ : undefined, this.passcode ? this.passcode++ : undefined, this.discriminator ? this.discriminator++ : undefined);
             this.log.debug(`Creating dynamic plugin ${plg}${plugin.name}${db} aggregator node...`);
             this.aggregatorNode = await this.createAggregatorNode();

package/dist/matterbridge.js

@@ -1248,6 +1248,10 @@ export class Matterbridge extends EventEmitter {
         this.log.info('Unregistering all devices and shutting down...');
         if (this.serverNode)
             await this.serverNode.setStateOf(BasicInformationServer, { configurationVersion: this.serverNode.state.basicInformation.configurationVersion + 1 });
+        for (const device of this.devices.array()) {
+            if (device.serverNode)
+                await device.serverNode.setStateOf(BasicInformationServer, { configurationVersion: device.serverNode.state.basicInformation.configurationVersion + 1 });
+        }
         for (const plugin of this.plugins.array()) {
             if (plugin.error || !plugin.enabled)
                 continue;
@@ -1965,6 +1969,13 @@ export class Matterbridge extends EventEmitter {
         });
         serverNode.lifecycle.online.on(() => {
             this.log.notice(`Server node for ${storeId} is online`);
+            this.log.info(`Configuration version for server node ${storeId} is ${serverNode.state.basicInformation.configurationVersion}`);
+            if (hasParameter('configuration-version')) {
+                let configurationVersion = getIntParameter('configuration-version') ?? serverNode.state.basicInformation.configurationVersion + 1;
+                configurationVersion = Math.min(Math.max(configurationVersion, 1), UINT32_MAX);
+                fireAndForget(serverNode.setStateOf(BasicInformationServer, { configurationVersion }), this.log, `Failed to set configuration version for server node ${storeId}`);
+                this.log.notice(`Configuration version for server node ${storeId} is now ${configurationVersion}`);
+            }
             if (serverNode.lifecycle.isCommissioned) {
                 this.log.notice(`Server node for ${storeId} is already commissioned.`);
                 this.advertisingNodes.delete(storeId);
@@ -2076,7 +2087,7 @@ export class Matterbridge extends EventEmitter {
         if (!plugin.locked) {
             plugin.locked = true;
             this.log.debug(`Creating dynamic plugin ${plg}${plugin.name}${db} server node...`);
-            plugin.storageContext = await this.createServerNodeContext(plugin.name, plugin.description, this.aggregatorDeviceType, this.aggregatorVendorId, this.aggregatorVendorName, this.aggregatorProductId, this.aggregatorProductName, undefined, undefined, parseVersionString(this.matterbridgeVersion), this.matterbridgeVersion, parseVersionString(this.systemInformation.osRelease), this.systemInformation.osRelease, plugin.description, plugin.homepage ?? 'https://matterbridge.io', 1);
+            plugin.storageContext = await this.createServerNodeContext(plugin.name, plugin.description, this.aggregatorDeviceType, this.aggregatorVendorId, this.aggregatorVendorName, this.aggregatorProductId, this.aggregatorProductName, undefined, undefined, parseVersionString(this.matterbridgeVersion), this.matterbridgeVersion, parseVersionString(this.systemInformation.osRelease), this.systemInformation.osRelease, plugin.description, plugin.homepage ?? 'https://matterbridge.io', plugin.configurationVersion);
             plugin.serverNode = await this.createServerNode(plugin.storageContext, this.port ? this.port++ : undefined, this.passcode ? this.passcode++ : undefined, this.discriminator ? this.discriminator++ : undefined);
             this.log.debug(`Creating dynamic plugin ${plg}${plugin.name}${db} aggregator node...`);
             plugin.aggregatorNode = await this.createAggregatorNode(plugin.storageContext);

package/dist/pluginManager.js

@@ -357,6 +357,7 @@ export class PluginManager extends EventEmitter {
             author: plugin.author,
             enabled: plugin.enabled,
             private: plugin.private,
+            configurationVersion: plugin.configurationVersion,
         };
     }
     toApiPlugin(plugin) {
@@ -368,6 +369,7 @@ export class PluginManager extends EventEmitter {
             path: plugin.path,
             type: plugin.type,
             private: plugin.private,
+            configurationVersion: plugin.configurationVersion,
             latestVersion: plugin.latestVersion,
             devVersion: plugin.devVersion,
             homepage: plugin.homepage,
@@ -432,7 +434,7 @@ export class PluginManager extends EventEmitter {
         }
         const pluginsArray = await this.matterbridge.nodeContext.get('plugins', []);
         for (const plugin of pluginsArray)
-            this._plugins.set(plugin.name, { ...plugin, private: plugin.private ?? false });
+            this._plugins.set(plugin.name, { ...plugin, private: plugin.private ?? false, configurationVersion: plugin.configurationVersion ?? 1 });
         this.log.debug(`Loaded ${BLUE}${pluginsArray.length}${db} plugins from storage`);
         return pluginsArray;
     }
@@ -454,6 +456,7 @@ export class PluginManager extends EventEmitter {
                 enabled: plugin.enabled,
                 private: plugin.private,
                 tarballPath: plugin.tarballPath,
+                configurationVersion: plugin.configurationVersion,
             });
         }
         await this.matterbridge.nodeContext.set('plugins', plugins);
@@ -823,6 +826,7 @@ export class PluginManager extends EventEmitter {
                 type: 'AnyPlatform',
                 version: packageJson.version,
                 private: packageJson.private || false,
+                configurationVersion: 1,
                 description: packageJson.description,
                 author: this.getAuthor(packageJson),
                 homepage: this.getHomepage(packageJson),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matterbridge/core",
-  "version": "3.10.10-dev-20260917-9fdf275",
+  "version": "3.10.10-dev-20260917-332fed8",
   "description": "Matterbridge core library",
   "author": "https://github.com/Luligu",
   "homepage": "https://matterbridge.io/",
@@ -136,10 +136,10 @@
   },
   "dependencies": {
     "@matter/main": "0.17.9",
-    "@matterbridge/dgram": "3.10.10-dev-20260917-9fdf275",
-    "@matterbridge/thread": "3.10.10-dev-20260917-9fdf275",
-    "@matterbridge/types": "3.10.10-dev-20260917-9fdf275",
-    "@matterbridge/utils": "3.10.10-dev-20260917-9fdf275",
+    "@matterbridge/dgram": "3.10.10-dev-20260917-332fed8",
+    "@matterbridge/thread": "3.10.10-dev-20260917-332fed8",
+    "@matterbridge/types": "3.10.10-dev-20260917-332fed8",
+    "@matterbridge/utils": "3.10.10-dev-20260917-332fed8",
     "escape-html": "1.0.3",
     "express": "5.2.1",
     "express-rate-limit": "8.7.0",