@matterbridge/core 3.10.0-dev-20260716-572b03b → 3.10.0-dev-20260716-7f8762c

package/dist/deviceManager.js

@@ -16,11 +16,13 @@ export function toBaseDevice(device) {
         vendorName: device.vendorName,
         productId: device.productId,
         productName: device.productName,
+        productLabel: device.productLabel,
+        productUrl: device.productUrl,
+        configurationVersion: device.configurationVersion,
         softwareVersion: device.softwareVersion,
         softwareVersionString: device.softwareVersionString,
         hardwareVersion: device.hardwareVersion,
         hardwareVersionString: device.hardwareVersionString,
-        productUrl: device.productUrl,
         tagList: device.tagList,
         originalId: device.originalId,
         name: device.name,

package/dist/matterNode.d.ts

@@ -58,7 +58,7 @@ export declare class MatterNode extends EventEmitter<MatterEvents> {
     startMatterStorage(): Promise<void>;
     backupMatterStorage(storageName: string, backupName: string): Promise<void>;
     stopMatterStorage(): Promise<void>;
-    createServerNodeContext(storeId: string, deviceName: string, deviceType: DeviceTypeId, vendorId: VendorId, vendorName: string, productId: number, productName: string, serialNumber?: string, uniqueId?: string): Promise<StorageContext>;
+    createServerNodeContext(storeId: string, deviceName: string, deviceType: DeviceTypeId, vendorId: VendorId, vendorName: string, productId: number, productName: string, serialNumber?: string, uniqueId?: string, softwareVersion?: number, softwareVersionString?: string, hardwareVersion?: number, hardwareVersionString?: string, productLabel?: string, productUrl?: string, configurationVersion?: number): Promise<StorageContext>;
     createServerNode(port?: number, passcode?: number, discriminator?: number): Promise<ServerNode>;
     getServerNodeData(serverNode: ServerNode): ApiMatter;
     startServerNode(timeout?: number): Promise<void>;

package/dist/matterNode.js

@@ -15,7 +15,7 @@ import { getIntParameter, getParameter, hasParameter } from '@matterbridge/utils
 import { copyDirectory } from '@matterbridge/utils/copy-dir';
 import { getErrorMessage, inspectError } from '@matterbridge/utils/error';
 import { logModuleLoaded } from '@matterbridge/utils/loader';
-import { isValidNumber, isValidString, parseVersionString } from '@matterbridge/utils/validate';
+import { isValidInteger, isValidString, parseVersionString } from '@matterbridge/utils/validate';
 import { 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';
@@ -328,7 +328,7 @@ export class MatterNode extends EventEmitter {
         this.log.info('Closed matter node storage');
         this.emit('closed');
     }
-    async createServerNodeContext(storeId, deviceName, deviceType, vendorId, vendorName, productId, productName, serialNumber, uniqueId) {
+    async createServerNodeContext(storeId, deviceName, deviceType, vendorId, vendorName, productId, productName, serialNumber, uniqueId, softwareVersion = 1, softwareVersionString = '1.0.0', hardwareVersion = 1, hardwareVersionString = '1.0.0', productLabel = 'Matter Endpoint', productUrl = 'https://matterbridge.io', configurationVersion = 1) {
         if (!this.matterStorageService) {
             throw new Error('No storage service initialized');
         }
@@ -344,14 +344,16 @@ export class MatterNode extends EventEmitter {
         await storageContext.set('vendorName', vendorName.slice(0, 32));
         await storageContext.set('productId', productId);
         await storageContext.set('productName', productName.slice(0, 32));
-        await storageContext.set('nodeLabel', productName.slice(0, 32));
-        await storageContext.set('productLabel', productName.replace(vendorName, '').trim().slice(0, 32));
+        await storageContext.set('productLabel', productLabel.replace(vendorName, '').trim().slice(0, 64));
+        await storageContext.set('productUrl', isValidString(productUrl, 8, 256) && productUrl.startsWith('https://') ? productUrl : 'https://matterbridge.io');
+        await storageContext.set('nodeLabel', deviceName.slice(0, 32));
         await storageContext.set('serialNumber', await storageContext.get('serialNumber', serialNumber ? serialNumber.slice(0, 32) : 'SN' + random));
         await storageContext.set('uniqueId', await storageContext.get('uniqueId', uniqueId ? uniqueId.slice(0, 32) : 'UI' + random));
-        await storageContext.set('softwareVersion', isValidNumber(parseVersionString(this.matterbridge.matterbridgeVersion), 0, UINT32_MAX) ? parseVersionString(this.matterbridge.matterbridgeVersion) : 1);
-        await storageContext.set('softwareVersionString', isValidString(this.matterbridge.matterbridgeVersion, 5, 64) ? this.matterbridge.matterbridgeVersion : '1.0.0');
-        await storageContext.set('hardwareVersion', isValidNumber(parseVersionString(this.matterbridge.systemInformation.osRelease), 0, UINT16_MAX) ? parseVersionString(this.matterbridge.systemInformation.osRelease) : 1);
-        await storageContext.set('hardwareVersionString', isValidString(this.matterbridge.systemInformation.osRelease, 5, 64) ? this.matterbridge.systemInformation.osRelease : '1.0.0');
+        await storageContext.set('softwareVersion', isValidInteger(softwareVersion, 0, UINT32_MAX) ? softwareVersion : 1);
+        await storageContext.set('softwareVersionString', isValidString(softwareVersionString, 1, 64) ? softwareVersionString : '1.0.0');
+        await storageContext.set('hardwareVersion', isValidInteger(hardwareVersion, 0, UINT16_MAX) ? hardwareVersion : 1);
+        await storageContext.set('hardwareVersionString', isValidString(hardwareVersionString, 1, 64) ? hardwareVersionString : '1.0.0');
+        await storageContext.set('configurationVersion', isValidInteger(configurationVersion, 1, UINT32_MAX) ? configurationVersion : 1);
         this.log.debug(`Created server node storage context "${storeId}.persist" for ${storeId}:`);
         this.log.debug(`- storeId: ${await storageContext.get('storeId')}`);
         this.log.debug(`- deviceName: ${await storageContext.get('deviceName')}`);
@@ -360,14 +362,16 @@ export class MatterNode extends EventEmitter {
         this.log.debug(`- vendorName: ${await storageContext.get('vendorName')}`);
         this.log.debug(`- productId: ${await storageContext.get('productId')}`);
         this.log.debug(`- productName: ${await storageContext.get('productName')}`);
-        this.log.debug(`- nodeLabel: ${await storageContext.get('nodeLabel')}`);
         this.log.debug(`- productLabel: ${await storageContext.get('productLabel')}`);
+        this.log.debug(`- productUrl: ${await storageContext.get('productUrl')}`);
+        this.log.debug(`- nodeLabel: ${await storageContext.get('nodeLabel')}`);
         this.log.debug(`- serialNumber: ${await storageContext.get('serialNumber')}`);
         this.log.debug(`- uniqueId: ${await storageContext.get('uniqueId')}`);
         this.log.debug(`- softwareVersion: ${await storageContext.get('softwareVersion')}`);
         this.log.debug(`- softwareVersionString: ${await storageContext.get('softwareVersionString')}`);
         this.log.debug(`- hardwareVersion: ${await storageContext.get('hardwareVersion')}`);
         this.log.debug(`- hardwareVersionString: ${await storageContext.get('hardwareVersionString')}`);
+        this.log.debug(`- configurationVersion: ${await storageContext.get('configurationVersion')}`);
         return storageContext;
     }
     async createServerNode(port = 5540, passcode = 20252026, discriminator = 3850) {
@@ -376,6 +380,23 @@ export class MatterNode extends EventEmitter {
         }
         const storeId = await this.matterStorageContext.get('storeId');
         this.log.notice(`Creating server node for ${storeId} on port ${port} with passcode ${passcode} and discriminator ${discriminator}...`);
+        this.log.debug(`- storeId: ${await this.matterStorageContext.get('storeId')}`);
+        this.log.debug(`- deviceName: ${await this.matterStorageContext.get('deviceName')}`);
+        this.log.debug(`- deviceType: ${await this.matterStorageContext.get('deviceType')}(0x${(await this.matterStorageContext.get('deviceType'))?.toString(16).padStart(4, '0')})`);
+        this.log.debug(`- vendorId: ${await this.matterStorageContext.get('vendorId')}`);
+        this.log.debug(`- vendorName: ${await this.matterStorageContext.get('vendorName')}`);
+        this.log.debug(`- productId: ${await this.matterStorageContext.get('productId')}`);
+        this.log.debug(`- productName: ${await this.matterStorageContext.get('productName')}`);
+        this.log.debug(`- productLabel: ${await this.matterStorageContext.get('productLabel')}`);
+        this.log.debug(`- productUrl: ${await this.matterStorageContext.get('productUrl')}`);
+        this.log.debug(`- nodeLabel: ${await this.matterStorageContext.get('nodeLabel')}`);
+        this.log.debug(`- serialNumber: ${await this.matterStorageContext.get('serialNumber')}`);
+        this.log.debug(`- uniqueId: ${await this.matterStorageContext.get('uniqueId')}`);
+        this.log.debug(`- softwareVersion: ${await this.matterStorageContext.get('softwareVersion')}`);
+        this.log.debug(`- softwareVersionString: ${await this.matterStorageContext.get('softwareVersionString')}`);
+        this.log.debug(`- hardwareVersion: ${await this.matterStorageContext.get('hardwareVersion')}`);
+        this.log.debug(`- hardwareVersionString: ${await this.matterStorageContext.get('hardwareVersionString')}`);
+        this.log.debug(`- configurationVersion: ${await this.matterStorageContext.get('configurationVersion')}`);
         if (passcode < 0 || passcode > 99999999) {
             this.log.warn(`Invalid passcode ${passcode} for server node ${storeId}. Passcode must be between 0 and 99999999. Generating a random passcode...`);
             passcode = PaseClient.generateRandomPasscode(this.environment.get(Crypto));
@@ -413,6 +434,7 @@ export class MatterNode extends EventEmitter {
                 productId: await this.matterStorageContext.get('productId'),
                 productName: await this.matterStorageContext.get('productName'),
                 productLabel: await this.matterStorageContext.get('productLabel'),
+                productUrl: await this.matterStorageContext.get('productUrl'),
                 nodeLabel: await this.matterStorageContext.get('nodeLabel'),
                 serialNumber: await this.matterStorageContext.get('serialNumber'),
                 uniqueId: await this.matterStorageContext.get('uniqueId'),
@@ -420,6 +442,7 @@ export class MatterNode extends EventEmitter {
                 softwareVersionString: await this.matterStorageContext.get('softwareVersionString'),
                 hardwareVersion: await this.matterStorageContext.get('hardwareVersion'),
                 hardwareVersionString: await this.matterStorageContext.get('hardwareVersionString'),
+                configurationVersion: await this.matterStorageContext.get('configurationVersion'),
                 reachable: true,
             },
         });
@@ -544,7 +567,7 @@ export class MatterNode extends EventEmitter {
     }
     async createMatterbridgeServerNode() {
         this.log.debug(`Creating ${plg}Matterbridge${db} server node...`);
-        this.matterStorageContext = await this.createServerNodeContext('Matterbridge', 'Matterbridge', this.aggregatorDeviceType, this.aggregatorVendorId, this.aggregatorVendorName, this.aggregatorProductId, this.aggregatorProductName, this.aggregatorSerialNumber, this.aggregatorUniqueId);
+        this.matterStorageContext = await this.createServerNodeContext('Matterbridge', 'Matterbridge', this.aggregatorDeviceType, this.aggregatorVendorId, this.aggregatorVendorName, this.aggregatorProductId, this.aggregatorProductName, this.aggregatorSerialNumber, this.aggregatorUniqueId, parseVersionString(this.matterbridge.matterbridgeVersion), this.matterbridge.matterbridgeVersion, parseVersionString(this.matterbridge.systemInformation.osRelease), this.matterbridge.systemInformation.osRelease, 'Matter Bridge', 'https://matterbridge.io', 1);
         this.serverNode = await this.createServerNode(this.port ? this.port++ : undefined, this.passcode ? this.passcode++ : undefined, this.discriminator ? this.discriminator++ : undefined);
         this.aggregatorNode = await this.createAggregatorNode();
         this.log.debug(`Adding ${plg}Matterbridge${db} aggregator node...`);
@@ -565,7 +588,7 @@ export class MatterNode extends EventEmitter {
         if (!plugin.locked && device.deviceType && device.deviceName && device.vendorId && device.vendorName && device.productId && device.productName) {
             plugin.locked = true;
             this.log.debug(`Creating accessory plugin ${plg}${plugin.name}${db} server node...`);
-            this.matterStorageContext = await this.createServerNodeContext(plugin.name, device.deviceName, DeviceTypeId(device.deviceType), VendorId(device.vendorId), device.vendorName, device.productId, device.productName);
+            this.matterStorageContext = await this.createServerNodeContext(plugin.name, device.deviceName, DeviceTypeId(device.deviceType), VendorId(device.vendorId), device.vendorName, device.productId, device.productName, device.serialNumber, device.uniqueId, device.softwareVersion, device.softwareVersionString, device.hardwareVersion, device.hardwareVersionString, device.productLabel, device.productUrl, device.configurationVersion);
             this.serverNode = await this.createServerNode(this.port ? this.port++ : undefined, this.passcode ? this.passcode++ : undefined, this.discriminator ? this.discriminator++ : undefined);
             this.log.debug(`Adding ${plg}${plugin.name}${db}:${dev}${device.deviceName}${db} to ${plg}${plugin.name}${db} server node...`);
             await this.serverNode.add(device);
@@ -586,7 +609,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, 'Matterbridge', this.aggregatorDeviceType, this.aggregatorVendorId, this.aggregatorVendorName, this.aggregatorProductId, plugin.description);
+            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.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();
@@ -608,7 +631,7 @@ export class MatterNode extends EventEmitter {
         }
         if (device.mode === 'server' && device.deviceType && device.deviceName && device.vendorId && device.vendorName && device.productId && device.productName) {
             this.log.debug(`Creating device ${plg}${plugin.name}${db}:${dev}${device.deviceName}${db} server node...`);
-            this.matterStorageContext = await this.createServerNodeContext(device.deviceName.replace(/[ .]/g, ''), device.deviceName, DeviceTypeId(device.deviceType), VendorId(device.vendorId), device.vendorName, device.productId, device.productName);
+            this.matterStorageContext = await this.createServerNodeContext(device.deviceName.replace(/[ .]/g, ''), device.deviceName, DeviceTypeId(device.deviceType), VendorId(device.vendorId), device.vendorName, device.productId, device.productName, device.serialNumber, device.uniqueId, device.softwareVersion, device.softwareVersionString, device.hardwareVersion, device.hardwareVersionString, device.productLabel, device.productUrl, device.configurationVersion);
             this.serverNode = await this.createServerNode(this.port ? this.port++ : undefined, this.passcode ? this.passcode++ : undefined, this.discriminator ? this.discriminator++ : undefined);
             this.log.debug(`Adding ${plg}${plugin.name}${db}:${dev}${device.deviceName}${db} to server node...`);
             await this.serverNode.add(device);

package/dist/matterbridge.js

@@ -22,7 +22,7 @@ import { getErrorMessage, inspectError, logError } from '@matterbridge/utils/err
 import { formatBytes, formatPercent, formatUptime } from '@matterbridge/utils/format';
 import { logModuleLoaded } from '@matterbridge/utils/loader';
 import { excludedInterfaceNamePattern } from '@matterbridge/utils/network';
-import { isValidNumber, isValidObject, isValidString, parseVersionString } from '@matterbridge/utils/validate';
+import { isValidInteger, isValidNumber, isValidObject, isValidString, parseVersionString } from '@matterbridge/utils/validate';
 import { fireAndForget, wait } from '@matterbridge/utils/wait';
 import { AnsiLogger, BLUE, BRIGHT, CYAN, db, debugStringify, er, GREEN, nf, nt, or, RED, RESET, rs, UNDERLINE, UNDERLINEOFF, wr, zb, } from 'node-ansi-logger';
 import { NodeStorageManager } from 'node-persist-manager';
@@ -1751,7 +1751,7 @@ export class Matterbridge extends EventEmitter {
         await createDirectory(path.join(this.matterbridgeDirectory, MATTER_STORAGE_DIR, 'Matterbridge'), `Matter node storage directory for Matterbridge`, this.log);
         this.matterStorageManager = await this.matterStorageService.open('Matterbridge');
         this.log.info('Matter node storage manager "Matterbridge" created');
-        this.matterbridgeContext = await this.createServerNodeContext('Matterbridge', 'Matterbridge', this.aggregatorDeviceType, this.aggregatorVendorId, this.aggregatorVendorName, this.aggregatorProductId, this.aggregatorProductName, this.aggregatorSerialNumber, this.aggregatorUniqueId);
+        this.matterbridgeContext = await this.createServerNodeContext('Matterbridge', 'Matterbridge', this.aggregatorDeviceType, this.aggregatorVendorId, this.aggregatorVendorName, this.aggregatorProductId, this.aggregatorProductName, this.aggregatorSerialNumber, this.aggregatorUniqueId, parseVersionString(this.matterbridgeVersion), this.matterbridgeVersion, parseVersionString(this.systemInformation.osRelease), this.systemInformation.osRelease, 'Matter Bridge', 'https://matterbridge.io', 1);
         this.log.info('Matter node storage started');
         await this.backupMatterStorage(path.join(this.matterbridgeDirectory, MATTER_STORAGE_DIR), path.join(this.matterbridgeDirectory, MATTER_STORAGE_DIR + '.backup'));
     }
@@ -1779,7 +1779,7 @@ export class Matterbridge extends EventEmitter {
         this.controllerContext = undefined;
         this.log.info('Matter node storage closed');
     }
-    async createServerNodeContext(storeId, deviceName, deviceType, vendorId, vendorName, productId, productName, serialNumber, uniqueId) {
+    async createServerNodeContext(storeId, deviceName, deviceType, vendorId, vendorName, productId, productName, serialNumber, uniqueId, softwareVersion = 1, softwareVersionString = '1.0.0', hardwareVersion = 1, hardwareVersionString = '1.0.0', productLabel = 'Matter Endpoint', productUrl = 'https://matterbridge.io', configurationVersion = 1) {
         const { randomBytes } = await import('node:crypto');
         if (!this.matterStorageService)
             throw new Error('No storage service initialized');
@@ -1797,14 +1797,16 @@ export class Matterbridge extends EventEmitter {
         await storageContext.set('vendorName', vendorName.slice(0, 32));
         await storageContext.set('productId', productId);
         await storageContext.set('productName', productName.slice(0, 32));
-        await storageContext.set('productLabel', productName.replace(vendorName, '').trim().slice(0, 32));
+        await storageContext.set('productLabel', productLabel.replace(vendorName, '').trim().slice(0, 64));
+        await storageContext.set('productUrl', isValidString(productUrl, 8, 256) && productUrl.startsWith('https://') ? productUrl : 'https://matterbridge.io');
         await storageContext.set('nodeLabel', deviceName.slice(0, 32));
         await storageContext.set('serialNumber', await storageContext.get('serialNumber', serialNumber ? serialNumber.slice(0, 32) : 'SN' + random));
         await storageContext.set('uniqueId', await storageContext.get('uniqueId', uniqueId ? uniqueId.slice(0, 32) : 'UI' + random));
-        await storageContext.set('softwareVersion', isValidNumber(parseVersionString(this.matterbridgeVersion), 0, UINT32_MAX) ? parseVersionString(this.matterbridgeVersion) : 1);
-        await storageContext.set('softwareVersionString', isValidString(this.matterbridgeVersion, 5, 64) ? this.matterbridgeVersion : '1.0.0');
-        await storageContext.set('hardwareVersion', isValidNumber(parseVersionString(this.systemInformation.osRelease), 0, UINT16_MAX) ? parseVersionString(this.systemInformation.osRelease) : 1);
-        await storageContext.set('hardwareVersionString', isValidString(this.systemInformation.osRelease, 5, 64) ? this.systemInformation.osRelease : '1.0.0');
+        await storageContext.set('softwareVersion', isValidInteger(softwareVersion, 0, UINT32_MAX) ? softwareVersion : 1);
+        await storageContext.set('softwareVersionString', isValidString(softwareVersionString, 1, 64) ? softwareVersionString : '1.0.0');
+        await storageContext.set('hardwareVersion', isValidInteger(hardwareVersion, 0, UINT16_MAX) ? hardwareVersion : 1);
+        await storageContext.set('hardwareVersionString', isValidString(hardwareVersionString, 1, 64) ? hardwareVersionString : '1.0.0');
+        await storageContext.set('configurationVersion', isValidInteger(configurationVersion, 1, UINT32_MAX) ? configurationVersion : 1);
         this.log.debug(`Created server node storage context "${storeId}.persist" for ${storeId}:`);
         this.log.debug(`- storeId: ${await storageContext.get('storeId')}`);
         this.log.debug(`- deviceName: ${await storageContext.get('deviceName')}`);
@@ -1814,6 +1816,7 @@ export class Matterbridge extends EventEmitter {
         this.log.debug(`- productId: ${await storageContext.get('productId')}`);
         this.log.debug(`- productName: ${await storageContext.get('productName')}`);
         this.log.debug(`- productLabel: ${await storageContext.get('productLabel')}`);
+        this.log.debug(`- productUrl: ${await storageContext.get('productUrl')}`);
         this.log.debug(`- nodeLabel: ${await storageContext.get('nodeLabel')}`);
         this.log.debug(`- serialNumber: ${await storageContext.get('serialNumber')}`);
         this.log.debug(`- uniqueId: ${await storageContext.get('uniqueId')}`);
@@ -1821,6 +1824,7 @@ export class Matterbridge extends EventEmitter {
         this.log.debug(`- softwareVersionString: ${await storageContext.get('softwareVersionString')}`);
         this.log.debug(`- hardwareVersion: ${await storageContext.get('hardwareVersion')}`);
         this.log.debug(`- hardwareVersionString: ${await storageContext.get('hardwareVersionString')}`);
+        this.log.debug(`- configurationVersion: ${await storageContext.get('configurationVersion')}`);
         return storageContext;
     }
     async createServerNode(storageContext, port = 5540, passcode = 20242025, discriminator = 3850) {
@@ -1834,6 +1838,7 @@ export class Matterbridge extends EventEmitter {
         this.log.debug(`- productId: ${await storageContext.get('productId')}`);
         this.log.debug(`- productName: ${await storageContext.get('productName')}`);
         this.log.debug(`- productLabel: ${await storageContext.get('productLabel')}`);
+        this.log.debug(`- productUrl: ${await storageContext.get('productUrl')}`);
         this.log.debug(`- nodeLabel: ${await storageContext.get('nodeLabel')}`);
         this.log.debug(`- serialNumber: ${await storageContext.get('serialNumber')}`);
         this.log.debug(`- uniqueId: ${await storageContext.get('uniqueId')}`);
@@ -1841,6 +1846,7 @@ export class Matterbridge extends EventEmitter {
         this.log.debug(`- softwareVersionString: ${await storageContext.get('softwareVersionString')}`);
         this.log.debug(`- hardwareVersion: ${await storageContext.get('hardwareVersion')}`);
         this.log.debug(`- hardwareVersionString: ${await storageContext.get('hardwareVersionString')}`);
+        this.log.debug(`- configurationVersion: ${await storageContext.get('configurationVersion')}`);
         if (passcode < 0 || passcode > 99999999) {
             this.log.warn(`Invalid passcode ${passcode} for server node ${storeId}. Passcode must be between 0 and 99999999. Generating a random passcode...`);
             passcode = PaseClient.generateRandomPasscode(this.environment.get(Crypto));
@@ -1877,12 +1883,14 @@ export class Matterbridge extends EventEmitter {
                 productId: await storageContext.get('productId'),
                 productName: await storageContext.get('productName'),
                 productLabel: await storageContext.get('productLabel'),
+                productUrl: await storageContext.get('productUrl'),
                 serialNumber: await storageContext.get('serialNumber'),
                 uniqueId: await storageContext.get('uniqueId'),
                 softwareVersion: await storageContext.get('softwareVersion'),
                 softwareVersionString: await storageContext.get('softwareVersionString'),
                 hardwareVersion: await storageContext.get('hardwareVersion'),
                 hardwareVersionString: await storageContext.get('hardwareVersionString'),
+                configurationVersion: await storageContext.get('configurationVersion'),
                 reachable: true,
             },
         });
@@ -2002,7 +2010,7 @@ export class Matterbridge extends EventEmitter {
             plugin.locked = true;
             plugin.device = device;
             this.log.debug(`Creating accessory plugin ${plg}${plugin.name}${db} server node...`);
-            plugin.storageContext = await this.createServerNodeContext(plugin.name, device.deviceName, DeviceTypeId(device.deviceType), device.vendorId, device.vendorName, device.productId, device.productName, device.serialNumber, device.uniqueId);
+            plugin.storageContext = await this.createServerNodeContext(plugin.name, device.deviceName, DeviceTypeId(device.deviceType), device.vendorId, device.vendorName, device.productId, device.productName, device.serialNumber, device.uniqueId, device.softwareVersion, device.softwareVersionString, device.hardwareVersion, device.hardwareVersionString, device.productLabel, device.productUrl, device.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(`Adding ${plg}${plugin.name}${db}:${dev}${device.deviceName}${db} to ${plg}${plugin.name}${db} server node...`);
             await plugin.serverNode.add(device);
@@ -2012,7 +2020,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);
+            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.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);
@@ -2030,7 +2038,7 @@ export class Matterbridge extends EventEmitter {
             device.productId &&
             device.productName) {
             this.log.debug(`Creating device ${plg}${plugin.name}${db}:${dev}${device.deviceName}${db} server node...`);
-            const context = await this.createServerNodeContext(device.deviceName.replace(/[ .]/g, ''), device.deviceName, DeviceTypeId(device.deviceType), device.vendorId, device.vendorName, device.productId, device.productName, device.serialNumber, device.uniqueId);
+            const context = await this.createServerNodeContext(device.deviceName.replace(/[ .]/g, ''), device.deviceName, DeviceTypeId(device.deviceType), device.vendorId, device.vendorName, device.productId, device.productName, device.serialNumber, device.uniqueId, device.softwareVersion, device.softwareVersionString, device.hardwareVersion, device.hardwareVersionString, device.productLabel, device.productUrl, device.configurationVersion);
             device.serverNode = await this.createServerNode(context, this.port ? this.port++ : undefined, this.passcode ? this.passcode++ : undefined, this.discriminator ? this.discriminator++ : undefined);
             this.log.debug(`Adding ${plg}${plugin.name}${db}:${dev}${device.deviceName}${db} to server node...`);
             await device.serverNode.add(device);

package/dist/matterbridgeEndpoint.d.ts

@@ -70,11 +70,13 @@ export declare class MatterbridgeEndpoint extends Endpoint {
     vendorName: string | undefined;
     productId: number | undefined;
     productName: string | undefined;
+    productLabel: string | undefined;
+    productUrl: string;
     softwareVersion: number | undefined;
     softwareVersionString: string | undefined;
     hardwareVersion: number | undefined;
     hardwareVersionString: string | undefined;
-    productUrl: string;
+    configurationVersion: number;
     tagList: Semtag[] | undefined;
     originalId: string | undefined;
     name: string | undefined;
@@ -138,8 +140,8 @@ export declare class MatterbridgeEndpoint extends Endpoint {
     createDefaultPowerSourceBatteryClusterServer(batPercentRemaining?: null | number, batChargeLevel?: PowerSource.BatChargeLevel, batVoltage?: null | number, batReplaceability?: PowerSource.BatReplaceability): this;
     createDefaultPowerSourceReplaceableBatteryClusterServer(batPercentRemaining?: number | null, batChargeLevel?: PowerSource.BatChargeLevel, batVoltage?: number | null, batReplacementDescription?: string, batQuantity?: number, batReplaceability?: PowerSource.BatReplaceability): this;
     createDefaultPowerSourceRechargeableBatteryClusterServer(batPercentRemaining?: number | null, batChargeLevel?: PowerSource.BatChargeLevel, batVoltage?: number | null, batReplaceability?: PowerSource.BatReplaceability): this;
-    createDefaultBasicInformationClusterServer(deviceName: string, serialNumber: string, vendorId?: number, vendorName?: string, productId?: number, productName?: string, softwareVersion?: number, softwareVersionString?: string, hardwareVersion?: number, hardwareVersionString?: string): this;
-    createDefaultBridgedDeviceBasicInformationClusterServer(deviceName: string, serialNumber: string, vendorId?: number, vendorName?: string, productName?: string, softwareVersion?: number, softwareVersionString?: string, hardwareVersion?: number, hardwareVersionString?: string): this;
+    createDefaultBasicInformationClusterServer(deviceName: string, serialNumber: string, vendorId?: number, vendorName?: string, productId?: number, productName?: string, softwareVersion?: number, softwareVersionString?: string, hardwareVersion?: number, hardwareVersionString?: string, productLabel?: string, productUrl?: string, configurationVersion?: number): this;
+    createDefaultBridgedDeviceBasicInformationClusterServer(deviceName: string, serialNumber: string, vendorId?: number, vendorName?: string, productName?: string, softwareVersion?: number, softwareVersionString?: string, hardwareVersion?: number, hardwareVersionString?: string, productLabel?: string, productUrl?: string, configurationVersion?: number): this;
     createDefaultPowerTopologyClusterServer(): this;
     createDefaultElectricalEnergyMeasurementClusterServer(energyImported?: number | bigint | null, energyExported?: number | bigint | null): this;
     createDefaultElectricalPowerMeasurementClusterServer(voltage?: number | bigint | null, current?: number | bigint | null, power?: number | bigint | null, frequency?: number | bigint | null): this;

package/dist/matterbridgeEndpoint.js

@@ -32,6 +32,7 @@ import { ThermostatUserInterfaceConfigurationServer } from '@matter/node/behavio
 import { TotalVolatileOrganicCompoundsConcentrationMeasurementServer } from '@matter/node/behaviors/total-volatile-organic-compounds-concentration-measurement';
 import { getClusterNameById } from '@matter/types/cluster';
 import { AirQuality } from '@matter/types/clusters/air-quality';
+import { BasicInformation } from '@matter/types/clusters/basic-information';
 import { BooleanStateConfiguration } from '@matter/types/clusters/boolean-state-configuration';
 import { BridgedDeviceBasicInformation } from '@matter/types/clusters/bridged-device-basic-information';
 import { ColorControl } from '@matter/types/clusters/color-control';
@@ -60,7 +61,7 @@ import { WindowCovering } from '@matter/types/clusters/window-covering';
 import { VendorId } from '@matter/types/datatype';
 import { inspectError } from '@matterbridge/utils/error';
 import { logModuleLoaded } from '@matterbridge/utils/loader';
-import { isValidNumber, isValidObject, isValidString } from '@matterbridge/utils/validate';
+import { isValidInteger, isValidNumber, isValidObject, isValidString } from '@matterbridge/utils/validate';
 import { AnsiLogger, CYAN, db, debugStringify, hk, or, YELLOW, zb } from 'node-ansi-logger';
 import { MatterbridgeActivatedCarbonFilterMonitoringServer } from './behaviors/activatedCarbonFilterMonitoringServer.js';
 import { MatterbridgeBooleanStateConfigurationServer } from './behaviors/booleanStateConfigurationServer.js';
@@ -115,11 +116,13 @@ export class MatterbridgeEndpoint extends Endpoint {
     vendorName = undefined;
     productId = undefined;
     productName = undefined;
+    productLabel = undefined;
+    productUrl = 'https://matterbridge.io';
     softwareVersion = undefined;
     softwareVersionString = undefined;
     hardwareVersion = undefined;
     hardwareVersionString = undefined;
-    productUrl = 'https://www.npmjs.com/package/matterbridge';
+    configurationVersion = 1;
     tagList = undefined;
     originalId = undefined;
     name = undefined;
@@ -468,6 +471,13 @@ export class MatterbridgeEndpoint extends Endpoint {
             uniqueId: device.uniqueId,
             productId: device.productId,
             productName: device.productName,
+            productLabel: device.productLabel,
+            productUrl: device.productUrl,
+            configurationVersion: device.configurationVersion,
+            softwareVersion: device.softwareVersion,
+            softwareVersionString: device.softwareVersionString,
+            hardwareVersion: device.hardwareVersion,
+            hardwareVersionString: device.hardwareVersionString,
             vendorId: device.vendorId,
             vendorName: device.vendorName,
             deviceTypes: Array.from(device.deviceTypes.values()),
@@ -478,6 +488,8 @@ export class MatterbridgeEndpoint extends Endpoint {
         Object.keys(device.behaviors.supported).forEach((behaviorName) => {
             if (behaviorName === 'bridgedDeviceBasicInformation')
                 serialized.clusterServersId.push(BridgedDeviceBasicInformation.id);
+            if (behaviorName === 'basicInformation')
+                serialized.clusterServersId.push(BasicInformation.id);
             if (behaviorName === 'powerSource')
                 serialized.clusterServersId.push(PowerSource.id);
         });
@@ -493,9 +505,18 @@ export class MatterbridgeEndpoint extends Endpoint {
         device.vendorName = serializedDevice.vendorName;
         device.productId = serializedDevice.productId;
         device.productName = serializedDevice.productName;
+        device.productLabel = serializedDevice.productLabel;
+        device.productUrl = serializedDevice.productUrl;
+        device.configurationVersion = serializedDevice.configurationVersion;
+        device.softwareVersion = serializedDevice.softwareVersion;
+        device.softwareVersionString = serializedDevice.softwareVersionString;
+        device.hardwareVersion = serializedDevice.hardwareVersion;
+        device.hardwareVersionString = serializedDevice.hardwareVersionString;
         for (const clusterId of serializedDevice.clusterServersId) {
             if (clusterId === BridgedDeviceBasicInformation.id)
-                device.createDefaultBridgedDeviceBasicInformationClusterServer(serializedDevice.deviceName, serializedDevice.serialNumber, serializedDevice.vendorId ?? 0xfff1, serializedDevice.vendorName ?? 'Matterbridge', serializedDevice.productName ?? 'Matterbridge device');
+                device.createDefaultBridgedDeviceBasicInformationClusterServer(serializedDevice.deviceName, serializedDevice.serialNumber, serializedDevice.vendorId ?? 0xfff1, serializedDevice.vendorName ?? 'Matterbridge', serializedDevice.productName ?? 'Matterbridge device', serializedDevice.softwareVersion, serializedDevice.softwareVersionString, serializedDevice.hardwareVersion, serializedDevice.hardwareVersionString, serializedDevice.productLabel, serializedDevice.productUrl, serializedDevice.configurationVersion);
+            else if (clusterId === BasicInformation.id)
+                device.createDefaultBasicInformationClusterServer(serializedDevice.deviceName, serializedDevice.serialNumber, serializedDevice.vendorId ?? 0xfff1, serializedDevice.vendorName ?? 'Matterbridge', serializedDevice.productId ?? 0x8000, serializedDevice.productName ?? 'Matterbridge device', serializedDevice.softwareVersion, serializedDevice.softwareVersionString, serializedDevice.hardwareVersion, serializedDevice.hardwareVersionString, serializedDevice.productLabel, serializedDevice.productUrl, serializedDevice.configurationVersion);
             else if (clusterId === PowerSource.id)
                 device.createDefaultPowerSourceWiredClusterServer();
         }
@@ -517,49 +538,56 @@ export class MatterbridgeEndpoint extends Endpoint {
         this.behaviors.require(MatterbridgePowerSourceServer.with(PowerSource.Feature.Battery, PowerSource.Feature.Rechargeable), getDefaultPowerSourceRechargeableBatteryClusterServer(batPercentRemaining, batChargeLevel, batVoltage, batReplaceability));
         return this;
     }
-    createDefaultBasicInformationClusterServer(deviceName, serialNumber, vendorId = 0xfff1, vendorName = 'Matterbridge', productId = 0x8000, productName = 'Matterbridge device', softwareVersion = 1, softwareVersionString = '1.0.0', hardwareVersion = 1, hardwareVersionString = '1.0.0') {
+    createDefaultBasicInformationClusterServer(deviceName, serialNumber, vendorId = 0xfff1, vendorName = 'Matterbridge', productId = 0x8000, productName = 'Matterbridge device', softwareVersion = 1, softwareVersionString = '1.0.0', hardwareVersion = 1, hardwareVersionString = '1.0.0', productLabel = 'Matter Endpoint', productUrl = 'https://matterbridge.io', configurationVersion = 1) {
         this.log.logName = deviceName;
         this.deviceName = deviceName;
         this.serialNumber = serialNumber;
         this.uniqueId = createUniqueId(deviceName, serialNumber, vendorName, productName);
         this.productId = productId;
         this.productName = productName;
+        this.productLabel = productLabel;
+        this.productUrl = productUrl;
         this.vendorId = vendorId;
         this.vendorName = vendorName;
         this.softwareVersion = softwareVersion;
         this.softwareVersionString = softwareVersionString;
         this.hardwareVersion = hardwareVersion;
         this.hardwareVersionString = hardwareVersionString;
+        this.configurationVersion = configurationVersion;
         return this;
     }
-    createDefaultBridgedDeviceBasicInformationClusterServer(deviceName, serialNumber, vendorId = 0xfff1, vendorName = 'Matterbridge', productName = 'Matterbridge device', softwareVersion = 1, softwareVersionString = '1.0.0', hardwareVersion = 1, hardwareVersionString = '1.0.0') {
+    createDefaultBridgedDeviceBasicInformationClusterServer(deviceName, serialNumber, vendorId = 0xfff1, vendorName = 'Matterbridge', productName = 'Matterbridge device', softwareVersion = 1, softwareVersionString = '1.0.0', hardwareVersion = 1, hardwareVersionString = '1.0.0', productLabel = 'Matter Bridged Endpoint', productUrl = 'https://matterbridge.io', configurationVersion = 1) {
         this.log.logName = deviceName;
         this.deviceName = deviceName;
         this.serialNumber = serialNumber;
         this.uniqueId = createUniqueId(deviceName, serialNumber, vendorName, productName);
         this.productId = undefined;
         this.productName = productName;
+        this.productLabel = productLabel;
+        this.productUrl = productUrl;
         this.vendorId = vendorId;
         this.vendorName = vendorName;
         this.softwareVersion = softwareVersion;
         this.softwareVersionString = softwareVersionString;
         this.hardwareVersion = hardwareVersion;
         this.hardwareVersionString = hardwareVersionString;
+        this.configurationVersion = configurationVersion;
         this.behaviors.require(BridgedDeviceBasicInformationServer.enable({
             events: { leave: true, reachableChanged: true },
         }), {
             vendorId: VendorId(vendorId),
             vendorName: vendorName.slice(0, 32),
             productName: productName.slice(0, 32),
-            productUrl: this.productUrl.slice(0, 256),
-            productLabel: productName.replace(vendorName, '').trim().slice(0, 64),
+            productLabel: productLabel.replace(vendorName, '').trim().slice(0, 64),
+            productUrl: isValidString(productUrl, 8, 256) && productUrl.startsWith('https://') ? productUrl : 'https://matterbridge.io',
             nodeLabel: deviceName.slice(0, 32),
             serialNumber: serialNumber.slice(0, 32),
             uniqueId: this.uniqueId.slice(0, 32),
-            softwareVersion: isValidNumber(softwareVersion, 0, UINT32_MAX) ? softwareVersion : undefined,
-            softwareVersionString: isValidString(softwareVersionString) ? softwareVersionString.slice(0, 64) : undefined,
-            hardwareVersion: isValidNumber(hardwareVersion, 0, UINT16_MAX) ? hardwareVersion : undefined,
-            hardwareVersionString: isValidString(hardwareVersionString) ? hardwareVersionString.slice(0, 64) : undefined,
+            softwareVersion: isValidInteger(softwareVersion, 0, UINT32_MAX) ? softwareVersion : 1,
+            softwareVersionString: isValidString(softwareVersionString, 1, 64) ? softwareVersionString : '1.0.0',
+            hardwareVersion: isValidInteger(hardwareVersion, 0, UINT16_MAX) ? hardwareVersion : 1,
+            hardwareVersionString: isValidString(hardwareVersionString, 1, 64) ? hardwareVersionString : '1.0.0',
+            configurationVersion: isValidInteger(configurationVersion, 1, UINT32_MAX) ? configurationVersion : 1,
             reachable: true,
         });
         return this;

package/dist/matterbridgeEndpointTypes.d.ts

@@ -9,6 +9,13 @@ export interface SerializedMatterbridgeEndpoint {
     uniqueId: string;
     productId?: number;
     productName?: string;
+    productUrl: string;
+    productLabel?: string;
+    configurationVersion: number;
+    softwareVersion?: number;
+    softwareVersionString?: string;
+    hardwareVersion?: number;
+    hardwareVersionString?: string;
     vendorId?: number;
     vendorName?: string;
     deviceTypes: DeviceTypeDefinition[];

package/dist/matterbridgePlatform.js

@@ -247,7 +247,7 @@ export class MatterbridgePlatform {
             }
             if (!device.hasClusterServer(BridgedDeviceBasicInformation.id)) {
                 this.log.debug(`Device with name ${CYAN}${device.deviceName}${db} has no BridgedDeviceBasicInformation cluster. Adding it...`);
-                device.createDefaultBridgedDeviceBasicInformationClusterServer(device.deviceName, device.serialNumber, device.vendorId, device.vendorName, device.productName, device.softwareVersion, device.softwareVersionString, device.hardwareVersion, device.hardwareVersionString);
+                device.createDefaultBridgedDeviceBasicInformationClusterServer(device.deviceName, device.serialNumber, device.vendorId, device.vendorName, device.productName, device.softwareVersion, device.softwareVersionString, device.hardwareVersion, device.hardwareVersionString, device.productLabel === 'Matter Endpoint' ? 'Matter Bridged Endpoint' : device.productLabel, device.productUrl, device.configurationVersion);
             }
         }
         await this.#addBridgedEndpoint?.(this.name, device);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matterbridge/core",
-  "version": "3.10.0-dev-20260716-572b03b",
+  "version": "3.10.0-dev-20260716-7f8762c",
   "description": "Matterbridge core library",
   "author": "https://github.com/Luligu",
   "homepage": "https://matterbridge.io/",
@@ -132,10 +132,10 @@
   },
   "dependencies": {
     "@matter/main": "0.17.5",
-    "@matterbridge/dgram": "3.10.0-dev-20260716-572b03b",
-    "@matterbridge/thread": "3.10.0-dev-20260716-572b03b",
-    "@matterbridge/types": "3.10.0-dev-20260716-572b03b",
-    "@matterbridge/utils": "3.10.0-dev-20260716-572b03b",
+    "@matterbridge/dgram": "3.10.0-dev-20260716-7f8762c",
+    "@matterbridge/thread": "3.10.0-dev-20260716-7f8762c",
+    "@matterbridge/types": "3.10.0-dev-20260716-7f8762c",
+    "@matterbridge/utils": "3.10.0-dev-20260716-7f8762c",
     "escape-html": "1.0.3",
     "express": "5.2.1",
     "express-rate-limit": "8.5.2",