matterbridge 3.0.8-dev-20250626-1445fbd → 3.0.8-dev-20250626-50aa686

package/CHANGELOG.md

@@ -21,8 +21,8 @@ If you like this project and find it useful, please consider giving it a star on
 - [ESLint]: Added the plugins `eslint-plugin-promise`, `eslint-plugin-jsdoc`, and `@vitest/eslint-plugin`.
 - [Vitest]: Added Vitest for TypeScript project testing. It will replace Jest, which does not work correctly with ESM module mocks.
 - [JSDoc]: Added missing JSDoc comments, including `@param` and `@returns` tags.
-- [MatterbridgeEndpoint]: Add MatterbridgeEndpoint serverMode='server'
-- [MatterbridgeEndpoint]: Add MatterbridgeEndpoint serverMode='matter'
+- [MatterbridgeEndpoint]: Add MatterbridgeEndpoint mode='server'. It allows to advertise a single device like an autonomous device with its server node to be paired.
+- [MatterbridgeEndpoint]: Add MatterbridgeEndpoint mode='matter'. It allows to add a single device to the Matterbridge server node next to the aggregator. The device is not bridged.
 
 ### Changed
 
@@ -31,6 +31,7 @@ If you like this project and find it useful, please consider giving it a star on
 - [storage]: Bumped `node-storage-manager` to 2.0.0.
 - [logger]: Bumped `node-ansi-logger` to 3.1.1.
 - [matter.js]: Updated to 0.15.0-alpha.0-20250625-c7634df96.
+- [matter.js]: Updated to 0.15.0-alpha.0-20250626-fc3a84ce9.
 
 ### Fixed
 

package/README-DEV.md

@@ -28,6 +28,14 @@ The Matterbridge Plugin Template has an already configured Jest / Vitest test un
 
 It also has a workflow configured to run on push and pull request that build, lint and test the plugin on node 20, 22 and 24 with ubuntu, macOS and windows.
 
+## Dev Container
+
+Using a Dev Container provides a fully isolated, reproducible, and pre-configured development environment. This ensures that all contributors have the same tools, extensions, and dependencies, eliminating "works on my machine" issues. It also makes onboarding new developers fast and hassle-free, as everything needed is set up automatically.
+
+For improved efficiency, the setup uses named Docker volumes for `node_modules`. This means dependencies are installed only once and persist across container rebuilds, making installs and rebuilds much faster than with bind mounts or ephemeral volumes.
+
+Since Dev Container doesn't run in network mode 'host', it is not possible to pair Mattebridge running inside the Dev Container.
+
 ## Guidelines on imports/exports
 
 Matterbridge exports from:
@@ -239,7 +247,26 @@ It can be useful to call this method from onShutdown() if you don't want to keep
 
 ## MatterbridgeEndpoint api
 
-Work in progress...
+You create a device with a new instance of MatterbridgeEndpoint(definition: DeviceTypeDefinition | AtLeastOne<DeviceTypeDefinition>, options: MatterbridgeEndpointOptions = {}, debug: boolean = false).
+
+- @param {DeviceTypeDefinition | AtLeastOne<DeviceTypeDefinition>} definition - The DeviceTypeDefinition(s) of the endpoint.
+- @param {MatterbridgeEndpointOptions} [options] - The options for the device.
+- @param {boolean} [debug] - Debug flag.
+
+```typescript
+    const device = new MatterbridgeEndpoint([contactSensor, powerSource], { uniqueStorageKey: 'Eve door', mode: 'matter' }, this.config.debug as boolean)
+      .createDefaultIdentifyClusterServer()
+      .createDefaultBasicInformationClusterServer('My contact sensor', '0123456789')
+      .createDefaultBooleanStateClusterServer(true)
+      .createDefaultPowerSourceReplaceableBatteryClusterServer(75)
+      .addRequiredClusterServers(); // Always better to call it at the end of the chain to add all the not already created but required clusters.
+```
+
+In the above example we create a contact sensor device type with also a power source device type feature replaceble battery.
+
+All device types are defined in src\matterbridgeDeviceTypes.ts and taken from the 'Matter-1.4-Device-Library-Specification.pdf'.
+
+All default cluster helpers are available as methods of MatterbridgeEndpoint.
 
 # Contribution Guidelines
 

package/README.md

@@ -5,7 +5,8 @@
 [![Docker Version](https://img.shields.io/docker/v/luligu/matterbridge?label=docker%20version&sort=semver)](https://hub.docker.com/r/luligu/matterbridge)
 [![Docker Pulls](https://img.shields.io/docker/pulls/luligu/matterbridge.svg)](https://hub.docker.com/r/luligu/matterbridge)
 ![Node.js CI](https://github.com/Luligu/matterbridge/actions/workflows/build.yml/badge.svg)
-![Coverage](https://img.shields.io/badge/Jest%20coverage-89%25-brightgreen)
+![CodeQL](https://github.com/Luligu/matterbridge/actions/workflows/codeql.yml/badge.svg)
+[![codecov](https://codecov.io/gh/Luligu/matterbridge/branch/main/graph/badge.svg)](https://codecov.io/gh/Luligu/matterbridge)
 
 [![power by](https://img.shields.io/badge/powered%20by-matter--history-blue)](https://www.npmjs.com/package/matter-history)
 [![power by](https://img.shields.io/badge/powered%20by-node--ansi--logger-blue)](https://www.npmjs.com/package/node-ansi-logger)

package/dist/matterbridge.js

@@ -206,7 +206,7 @@ export class Matterbridge extends EventEmitter {
         }
         if (this.devices !== undefined) {
             for (const device of this.devices.array()) {
-                if (device.serverMode === 'server' && device.serverNode)
+                if (device.mode === 'server' && device.serverNode)
                     servers.push(device.serverNode);
             }
         }
@@ -1082,9 +1082,10 @@ export class Matterbridge extends EventEmitter {
                 }
             }
             for (const device of this.devices.array()) {
-                if (device.serverMode === 'server' && device.serverNode) {
+                if (device.mode === 'server' && device.serverNode) {
                     await this.stopServerNode(device.serverNode);
                     device.serverNode = undefined;
+                    device.serverContext = undefined;
                 }
             }
             this.log.notice('Stopped matter server nodes');
@@ -1181,10 +1182,10 @@ export class Matterbridge extends EventEmitter {
         }
     }
     async createDeviceServerNode(plugin, device) {
-        if (device.serverMode === 'server' && !device.serverNode && device.deviceType && device.deviceName && device.vendorId && device.productId && device.vendorName && device.productName) {
+        if (device.mode === 'server' && !device.serverNode && device.deviceType && device.deviceName && device.vendorId && device.productId && device.vendorName && device.productName) {
             this.log.debug(`Creating device ${plg}${plugin.name}${db}:${dev}${device.deviceName}${db} server node...`);
-            const storageContext = await this.createServerNodeContext(device.deviceName.replace(/[ .]/g, ''), device.deviceName, DeviceTypeId(device.deviceType), device.vendorId, device.vendorName, device.productId, device.productName);
-            device.serverNode = await this.createServerNode(storageContext, this.port ? this.port++ : undefined, this.passcode ? this.passcode++ : undefined, this.discriminator ? this.discriminator++ : undefined);
+            device.serverContext = await this.createServerNodeContext(device.deviceName.replace(/[ .]/g, ''), device.deviceName, DeviceTypeId(device.deviceType), device.vendorId, device.vendorName, device.productId, device.productName);
+            device.serverNode = await this.createServerNode(device.serverContext, 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);
             this.log.debug(`Added ${plg}${plugin.name}${db}:${dev}${device.deviceName}${db} to server node`);
@@ -1256,7 +1257,7 @@ export class Matterbridge extends EventEmitter {
             this.log.debug('Cleared startMatterInterval interval for Matterbridge');
             this.startServerNode(this.serverNode);
             for (const device of this.devices.array()) {
-                if (device.serverMode === 'server' && device.serverNode) {
+                if (device.mode === 'server' && device.serverNode) {
                     this.log.debug(`Starting server node for device ${dev}${device.deviceName}${db} in server mode...`);
                     await this.startServerNode(device.serverNode);
                 }
@@ -1277,13 +1278,15 @@ export class Matterbridge extends EventEmitter {
                     }
                 }
                 this.frontend.wssSendRefreshRequired('plugins');
-            }, 30 * 1000);
+            }, 30 * 1000).unref();
             this.reachabilityTimeout = setTimeout(() => {
                 this.log.info(`Setting reachability to true for ${plg}Matterbridge${db}`);
                 if (this.aggregatorNode)
                     this.setAggregatorReachability(this.aggregatorNode, true);
                 this.frontend.wssSendRefreshRequired('reachability');
-            }, 60 * 1000);
+            }, 60 * 1000).unref();
+            this.emit('bridge_started');
+            this.log.notice('Matterbridge bridge started successfully');
         }, 1000);
     }
     async startChildbridge() {
@@ -1339,7 +1342,7 @@ export class Matterbridge extends EventEmitter {
                     }
                 }
                 this.frontend.wssSendRefreshRequired('plugins');
-            }, 30 * 1000);
+            }, 30 * 1000).unref();
             for (const plugin of this.plugins.array()) {
                 if (!plugin.enabled || plugin.error)
                     continue;
@@ -1365,14 +1368,16 @@ export class Matterbridge extends EventEmitter {
                     if (plugin.type === 'DynamicPlatform' && plugin.aggregatorNode)
                         this.setAggregatorReachability(plugin.aggregatorNode, true);
                     this.frontend.wssSendRefreshRequired('reachability');
-                }, 60 * 1000);
+                }, 60 * 1000).unref();
             }
             for (const device of this.devices.array()) {
-                if (device.serverMode === 'server' && device.serverNode) {
+                if (device.mode === 'server' && device.serverNode) {
                     this.log.debug(`***Starting server node for device ${plg}${device.deviceName}${db} in server mode...`);
                     await this.startServerNode(device.serverNode);
                 }
             }
+            this.emit('childbridge_started');
+            this.log.notice('Matterbridge childbridge started successfully');
         }, 1000);
     }
     async startController() {
@@ -1597,10 +1602,7 @@ export class Matterbridge extends EventEmitter {
             this.frontend.wssSendRefreshRequired('fabrics');
         });
         const sanitizeSessions = (sessions) => {
-            const sanitizedSessions = this.sanitizeSessionInformation(sessions.map((session) => ({
-                ...session,
-                secure: session.name.startsWith('secure'),
-            })));
+            const sanitizedSessions = this.sanitizeSessionInformation(sessions);
             this.log.debug(`Sessions: ${debugStringify(sanitizedSessions)}`);
             if (this.bridgeMode === 'bridge') {
                 this.matterbridgeSessionInformations = sanitizedSessions;
@@ -1702,7 +1704,7 @@ export class Matterbridge extends EventEmitter {
             this.log.error(`Error adding bridged endpoint ${dev}${device.deviceName}${er} (${zb}${device.id}${er}) plugin ${plg}${pluginName}${er} not found`);
             return;
         }
-        if (device.serverMode === 'server') {
+        if (device.mode === 'server') {
             try {
                 this.log.debug(`Creating server node for device ${dev}${device.deviceName}${db} of plugin ${plg}${plugin.name}${db}...`);
                 await this.createDeviceServerNode(plugin, device);
@@ -1715,7 +1717,7 @@ export class Matterbridge extends EventEmitter {
             }
         }
         else if (this.bridgeMode === 'bridge') {
-            if (device.serverMode === 'matter') {
+            if (device.mode === 'matter') {
                 this.log.debug(`Adding matter endpoint ${plg}${pluginName}${db}:${dev}${device.deviceName}${db} to Matterbridge server node...`);
                 if (!this.serverNode) {
                     this.log.error('Server node not found for Matterbridge');
@@ -1774,7 +1776,7 @@ export class Matterbridge extends EventEmitter {
                         this.log.error(`Aggregator node not found for plugin ${plg}${plugin.name}${er}`);
                         return;
                     }
-                    if (device.serverMode === 'matter')
+                    if (device.mode === 'matter')
                         await plugin.serverNode?.add(device);
                     else
                         await plugin.aggregatorNode.add(device);
@@ -1870,8 +1872,8 @@ export class Matterbridge extends EventEmitter {
             };
         });
     }
-    sanitizeSessionInformation(sessionInfo) {
-        return sessionInfo
+    sanitizeSessionInformation(session) {
+        return session
             .filter((session) => session.isPeerActive)
             .map((session) => {
             return {
@@ -1890,7 +1892,6 @@ export class Matterbridge extends EventEmitter {
                     }
                     : undefined,
                 isPeerActive: session.isPeerActive,
-                secure: session.secure,
                 lastInteractionTimestamp: session.lastInteractionTimestamp?.toString(),
                 lastActiveTimestamp: session.lastActiveTimestamp?.toString(),
                 numberOfActiveSubscriptions: session.numberOfActiveSubscriptions,

package/dist/matterbridgeEndpoint.js

@@ -1,4 +1,4 @@
-import { Endpoint, Lifecycle, MutableEndpoint, NamedHandler, SupportedBehaviors, UINT16_MAX, UINT32_MAX, VendorId } from '@matter/main';
+import { Endpoint, Lifecycle, MutableEndpoint, NamedHandler, SupportedBehaviors, UINT16_MAX, UINT32_MAX, VendorId, } from '@matter/main';
 import { getClusterNameById, MeasurementType } from '@matter/main/types';
 import { Descriptor } from '@matter/main/clusters/descriptor';
 import { PowerSource } from '@matter/main/clusters/power-source';
@@ -68,7 +68,8 @@ import { addClusterServers, addFixedLabel, addOptionalClusterServers, addRequire
 export class MatterbridgeEndpoint extends Endpoint {
     static bridgeMode = '';
     static logLevel = "info";
-    serverMode = undefined;
+    mode = undefined;
+    serverContext;
     serverNode;
     log;
     plugin = undefined;
@@ -126,13 +127,23 @@ export class MatterbridgeEndpoint extends Endpoint {
         if (options.uniqueStorageKey && checkNotLatinCharacters(options.uniqueStorageKey)) {
             options.uniqueStorageKey = generateUniqueId(options.uniqueStorageKey);
         }
+        if (options.id && checkNotLatinCharacters(options.id)) {
+            options.id = generateUniqueId(options.id);
+        }
         const optionsV8 = {
             id: options.uniqueStorageKey?.replace(/[ .]/g, ''),
             number: options.endpointId,
             descriptor: options.tagList ? { tagList: options.tagList, deviceTypeList } : { deviceTypeList },
         };
+        if (options.id !== undefined) {
+            optionsV8.id = options.id.replace(/[ .]/g, '');
+        }
+        if (options.number !== undefined) {
+            optionsV8.number = options.number;
+        }
         super(endpointV8, optionsV8);
-        this.uniqueStorageKey = options.uniqueStorageKey;
+        this.mode = options.mode;
+        this.uniqueStorageKey = options.id ? options.id : options.uniqueStorageKey;
         this.name = firstDefinition.name;
         this.deviceType = firstDefinition.code;
         this.tagList = options.tagList;
@@ -442,7 +453,7 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
-    createDefaultBasicInformationClusterServer(deviceName, serialNumber, vendorId, vendorName, productId, productName, 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') {
         this.log.logName = deviceName;
         this.deviceName = deviceName;
         this.serialNumber = serialNumber;
@@ -455,7 +466,7 @@ export class MatterbridgeEndpoint extends Endpoint {
         this.softwareVersionString = softwareVersionString;
         this.hardwareVersion = hardwareVersion;
         this.hardwareVersionString = hardwareVersionString;
-        if (MatterbridgeEndpoint.bridgeMode === 'bridge') {
+        if (MatterbridgeEndpoint.bridgeMode === 'bridge' && this.mode === undefined) {
             const options = this.getClusterServerOptions(Descriptor.Cluster.id);
             if (options) {
                 const deviceTypeList = options.deviceTypeList;
@@ -465,7 +476,7 @@ export class MatterbridgeEndpoint extends Endpoint {
         }
         return this;
     }
-    createDefaultBridgedDeviceBasicInformationClusterServer(deviceName, serialNumber, vendorId, vendorName, productName, 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') {
         this.log.logName = deviceName;
         this.deviceName = deviceName;
         this.serialNumber = serialNumber;

package/npm-shrinkwrap.json

@@ -1,15 +1,15 @@
 {
   "name": "matterbridge",
-  "version": "3.0.8-dev-20250626-1445fbd",
+  "version": "3.0.8-dev-20250626-50aa686",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge",
-      "version": "3.0.8-dev-20250626-1445fbd",
+      "version": "3.0.8-dev-20250626-50aa686",
       "license": "Apache-2.0",
       "dependencies": {
-        "@matter/main": "0.15.0-alpha.0-20250625-c7634df96",
+        "@matter/main": "0.15.0-alpha.0-20250626-fc3a84ce9",
         "archiver": "7.0.1",
         "express": "5.1.0",
         "glob": "11.0.3",
@@ -68,86 +68,86 @@
       }
     },
     "node_modules/@matter/general": {
-      "version": "0.15.0-alpha.0-20250625-c7634df96",
-      "resolved": "https://registry.npmjs.org/@matter/general/-/general-0.15.0-alpha.0-20250625-c7634df96.tgz",
-      "integrity": "sha512-SGs0jerp66b6o8pINI6fpSiPX/S1QlAO8Rr/Rz6usJO3JbS31vnWE5HoDIMMf4EPyyjH+dh5+heASuEBW/K5Hg==",
+      "version": "0.15.0-alpha.0-20250626-fc3a84ce9",
+      "resolved": "https://registry.npmjs.org/@matter/general/-/general-0.15.0-alpha.0-20250626-fc3a84ce9.tgz",
+      "integrity": "sha512-fQwZ8NEEdZIiQXNZXHjmNP7X21OzQw424ukSGWlt+GB7CrfZlF4rsiroeKsRQBFO1L+zCE0LYYe+rlM89IqKKg==",
       "license": "Apache-2.0",
       "dependencies": {
         "@noble/curves": "^1.9.2"
       }
     },
     "node_modules/@matter/main": {
-      "version": "0.15.0-alpha.0-20250625-c7634df96",
-      "resolved": "https://registry.npmjs.org/@matter/main/-/main-0.15.0-alpha.0-20250625-c7634df96.tgz",
-      "integrity": "sha512-9x3HeF2MPR31jZVHpzvTN4BcFynFUvuy1lWfwZgMha+BWEQPAQp3DS77pvuIpPMFyWe8kaKtjWTvSsGOHt+vig==",
+      "version": "0.15.0-alpha.0-20250626-fc3a84ce9",
+      "resolved": "https://registry.npmjs.org/@matter/main/-/main-0.15.0-alpha.0-20250626-fc3a84ce9.tgz",
+      "integrity": "sha512-x9QYTk521l21/ihZTAWz+wE1flyQhYPY/fvM6YPDF6YTfJgd790FT9Ryqk5qVgrui9eVGF3X6i7DrdFkzpTLVw==",
       "license": "Apache-2.0",
       "dependencies": {
-        "@matter/general": "0.15.0-alpha.0-20250625-c7634df96",
-        "@matter/model": "0.15.0-alpha.0-20250625-c7634df96",
-        "@matter/node": "0.15.0-alpha.0-20250625-c7634df96",
-        "@matter/protocol": "0.15.0-alpha.0-20250625-c7634df96",
-        "@matter/types": "0.15.0-alpha.0-20250625-c7634df96"
+        "@matter/general": "0.15.0-alpha.0-20250626-fc3a84ce9",
+        "@matter/model": "0.15.0-alpha.0-20250626-fc3a84ce9",
+        "@matter/node": "0.15.0-alpha.0-20250626-fc3a84ce9",
+        "@matter/protocol": "0.15.0-alpha.0-20250626-fc3a84ce9",
+        "@matter/types": "0.15.0-alpha.0-20250626-fc3a84ce9"
       },
       "optionalDependencies": {
-        "@matter/nodejs": "0.15.0-alpha.0-20250625-c7634df96"
+        "@matter/nodejs": "0.15.0-alpha.0-20250626-fc3a84ce9"
       }
     },
     "node_modules/@matter/model": {
-      "version": "0.15.0-alpha.0-20250625-c7634df96",
-      "resolved": "https://registry.npmjs.org/@matter/model/-/model-0.15.0-alpha.0-20250625-c7634df96.tgz",
-      "integrity": "sha512-QF+R227USkpJhLzt0R/YxiZm34ag3DhfxDfqcxD9Fghf+vIjGjHfXzNeE8It1tbkgmVVRMdqrxFpw2N5EQ63Nw==",
+      "version": "0.15.0-alpha.0-20250626-fc3a84ce9",
+      "resolved": "https://registry.npmjs.org/@matter/model/-/model-0.15.0-alpha.0-20250626-fc3a84ce9.tgz",
+      "integrity": "sha512-MsPhBLOMf+kpzYIHYPp8IO6lf6sbTijzcoCUAq5FLCycuKiqgSQap6mzQKKMMS81FIs/prM5E4dpQQz9aGF6kA==",
       "license": "Apache-2.0",
       "dependencies": {
-        "@matter/general": "0.15.0-alpha.0-20250625-c7634df96"
+        "@matter/general": "0.15.0-alpha.0-20250626-fc3a84ce9"
       }
     },
     "node_modules/@matter/node": {
-      "version": "0.15.0-alpha.0-20250625-c7634df96",
-      "resolved": "https://registry.npmjs.org/@matter/node/-/node-0.15.0-alpha.0-20250625-c7634df96.tgz",
-      "integrity": "sha512-CvpjmpcjSOQOKk5YDg4X4WC4+1mkDDBAbI70vI01wJpV2Y8AByPEtLjLdpTEFcXT/AOSj29ga4sMcGR8cm2V3g==",
+      "version": "0.15.0-alpha.0-20250626-fc3a84ce9",
+      "resolved": "https://registry.npmjs.org/@matter/node/-/node-0.15.0-alpha.0-20250626-fc3a84ce9.tgz",
+      "integrity": "sha512-p0ehfBazBnALPKIplEJHibZ+HmszGDszcgq5bsXLlu9MyEfQ6Y3LZK9+hKEH8pavSaJUbMBfQRn5fEzzAMqn+w==",
       "license": "Apache-2.0",
       "dependencies": {
-        "@matter/general": "0.15.0-alpha.0-20250625-c7634df96",
-        "@matter/model": "0.15.0-alpha.0-20250625-c7634df96",
-        "@matter/protocol": "0.15.0-alpha.0-20250625-c7634df96",
-        "@matter/types": "0.15.0-alpha.0-20250625-c7634df96"
+        "@matter/general": "0.15.0-alpha.0-20250626-fc3a84ce9",
+        "@matter/model": "0.15.0-alpha.0-20250626-fc3a84ce9",
+        "@matter/protocol": "0.15.0-alpha.0-20250626-fc3a84ce9",
+        "@matter/types": "0.15.0-alpha.0-20250626-fc3a84ce9"
       }
     },
     "node_modules/@matter/nodejs": {
-      "version": "0.15.0-alpha.0-20250625-c7634df96",
-      "resolved": "https://registry.npmjs.org/@matter/nodejs/-/nodejs-0.15.0-alpha.0-20250625-c7634df96.tgz",
-      "integrity": "sha512-HZJUh5T04E3zfGw3ZjjkNyMOrXQk5qKZoMS8LI2pwUjHBd1vU2hS28EAXqufELcQ9pvdzUisYbSLWPb2N8B+CA==",
+      "version": "0.15.0-alpha.0-20250626-fc3a84ce9",
+      "resolved": "https://registry.npmjs.org/@matter/nodejs/-/nodejs-0.15.0-alpha.0-20250626-fc3a84ce9.tgz",
+      "integrity": "sha512-zkCATPiq29m+QRHAeK7+RUS2F2cuVhSQVMqTQjtuQyEVMRAx+8aucJB/3AfOYqLX4DfOLUenxYpt9Mm59bQLYQ==",
       "license": "Apache-2.0",
       "optional": true,
       "dependencies": {
-        "@matter/general": "0.15.0-alpha.0-20250625-c7634df96",
-        "@matter/node": "0.15.0-alpha.0-20250625-c7634df96",
-        "@matter/protocol": "0.15.0-alpha.0-20250625-c7634df96",
-        "@matter/types": "0.15.0-alpha.0-20250625-c7634df96"
+        "@matter/general": "0.15.0-alpha.0-20250626-fc3a84ce9",
+        "@matter/node": "0.15.0-alpha.0-20250626-fc3a84ce9",
+        "@matter/protocol": "0.15.0-alpha.0-20250626-fc3a84ce9",
+        "@matter/types": "0.15.0-alpha.0-20250626-fc3a84ce9"
       },
       "engines": {
         "node": ">=18.0.0"
       }
     },
     "node_modules/@matter/protocol": {
-      "version": "0.15.0-alpha.0-20250625-c7634df96",
-      "resolved": "https://registry.npmjs.org/@matter/protocol/-/protocol-0.15.0-alpha.0-20250625-c7634df96.tgz",
-      "integrity": "sha512-YRnbd+nYjp9S3Rjm1V+KnmKoxg8KzZ3nO0tH1weLbn397FldHTDhywyYOielIfQoZshfYxsplBG4xIiE1C8mew==",
+      "version": "0.15.0-alpha.0-20250626-fc3a84ce9",
+      "resolved": "https://registry.npmjs.org/@matter/protocol/-/protocol-0.15.0-alpha.0-20250626-fc3a84ce9.tgz",
+      "integrity": "sha512-82cY1+OXoQQZ7wcApdMipO1n8JBRvryI2+WY0Amy+dPRo7fzd1n0EB2bpoiQ+FZAllrFND31KcaFY5BOR63nvw==",
       "license": "Apache-2.0",
       "dependencies": {
-        "@matter/general": "0.15.0-alpha.0-20250625-c7634df96",
-        "@matter/model": "0.15.0-alpha.0-20250625-c7634df96",
-        "@matter/types": "0.15.0-alpha.0-20250625-c7634df96"
+        "@matter/general": "0.15.0-alpha.0-20250626-fc3a84ce9",
+        "@matter/model": "0.15.0-alpha.0-20250626-fc3a84ce9",
+        "@matter/types": "0.15.0-alpha.0-20250626-fc3a84ce9"
       }
     },
     "node_modules/@matter/types": {
-      "version": "0.15.0-alpha.0-20250625-c7634df96",
-      "resolved": "https://registry.npmjs.org/@matter/types/-/types-0.15.0-alpha.0-20250625-c7634df96.tgz",
-      "integrity": "sha512-PXsCCEit+F++aQR63T0Ya+hA5rrjncYjJyi1dNU7TXm8LDsHd0/wbzXSAmgJoaRY9mbMpFg9idi/6JxKGR+7dw==",
+      "version": "0.15.0-alpha.0-20250626-fc3a84ce9",
+      "resolved": "https://registry.npmjs.org/@matter/types/-/types-0.15.0-alpha.0-20250626-fc3a84ce9.tgz",
+      "integrity": "sha512-cxqOVzCxYk7lH9nuP15sJ2xfF9PfSDMFdv33/gmFTny6y85Yf2ZcTNrVfG5G7vNCL42Sj1edc8BLum8KYM3D8w==",
       "license": "Apache-2.0",
       "dependencies": {
-        "@matter/general": "0.15.0-alpha.0-20250625-c7634df96",
-        "@matter/model": "0.15.0-alpha.0-20250625-c7634df96"
+        "@matter/general": "0.15.0-alpha.0-20250626-fc3a84ce9",
+        "@matter/model": "0.15.0-alpha.0-20250626-fc3a84ce9"
       }
     },
     "node_modules/@noble/curves": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge",
-  "version": "3.0.8-dev-20250626-1445fbd",
+  "version": "3.0.8-dev-20250626-50aa686",
   "description": "Matterbridge plugin manager for Matter",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",
@@ -98,7 +98,7 @@
     }
   },
   "dependencies": {
-    "@matter/main": "0.15.0-alpha.0-20250625-c7634df96",
+    "@matter/main": "0.15.0-alpha.0-20250626-fc3a84ce9",
     "archiver": "7.0.1",
     "express": "5.1.0",
     "glob": "11.0.3",

package/vitest/matterbridge.test.ts

@@ -0,0 +1,208 @@
+import { vi, describe, it, expect, beforeEach, afterEach, MockInstance } from 'vitest';
+import { Matterbridge } from '../src/matterbridge.ts';
+import { AnsiLogger } from 'node-ansi-logger';
+
+// Partial mock for @matter/main, preserving all actual exports except Logger
+vi.mock('@matter/main', async (importOriginal) => {
+  const actual = await importOriginal();
+  return {
+    ...(actual as Record<string, unknown>),
+    Logger: {
+      log: vi.fn(),
+      info: vi.fn(),
+      debug: vi.fn(),
+      warn: vi.fn(),
+      error: vi.fn(),
+      fatal: vi.fn(),
+      addLogger: vi.fn(),
+      setLogger: vi.fn(),
+      removeLogger: vi.fn(),
+      toJSON: vi.fn(() => ''),
+    },
+  };
+});
+
+let loggerLogSpy: MockInstance<typeof AnsiLogger.prototype.log>;
+let consoleLogSpy: MockInstance<typeof console.log>;
+let consoleDebugSpy: MockInstance<typeof console.debug>;
+let consoleInfoSpy: MockInstance<typeof console.info>;
+let consoleWarnSpy: MockInstance<typeof console.warn>;
+let consoleErrorSpy: MockInstance<typeof console.error>;
+const debug = true; // Set to true to enable debug logging
+
+if (!debug) {
+  loggerLogSpy = vi.spyOn(AnsiLogger.prototype, 'log').mockImplementation((level: string, message: string, ...parameters: any[]) => {});
+  consoleLogSpy = vi.spyOn(console, 'log').mockImplementation((...args: any[]) => {});
+  consoleDebugSpy = vi.spyOn(console, 'debug').mockImplementation((...args: any[]) => {});
+  consoleInfoSpy = vi.spyOn(console, 'info').mockImplementation((...args: any[]) => {});
+  consoleWarnSpy = vi.spyOn(console, 'warn').mockImplementation((...args: any[]) => {});
+  consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation((...args: any[]) => {});
+} else {
+  loggerLogSpy = vi.spyOn(AnsiLogger.prototype, 'log');
+  consoleLogSpy = vi.spyOn(console, 'log');
+  consoleDebugSpy = vi.spyOn(console, 'debug');
+  consoleInfoSpy = vi.spyOn(console, 'info');
+  consoleWarnSpy = vi.spyOn(console, 'warn');
+  consoleErrorSpy = vi.spyOn(console, 'error');
+}
+
+describe('Matterbridge', () => {
+  let matterbridge: Matterbridge;
+
+  beforeEach(async () => {
+    matterbridge = await Matterbridge.loadInstance(false);
+    // Set up required properties/mocks
+    matterbridge.log = { debug: vi.fn(), info: vi.fn(), notice: vi.fn(), warn: vi.fn(), error: vi.fn(), fatal: vi.fn() } as any;
+    matterbridge.plugins = { array: () => [], clear: vi.fn(), [Symbol.iterator]: function* () {} } as any;
+    matterbridge.devices = { array: () => [], clear: vi.fn(), [Symbol.iterator]: function* () {} } as any;
+    matterbridge.frontend = {
+      start: vi.fn(),
+      stop: vi.fn(),
+      wssSendRefreshRequired: vi.fn(),
+      wssSendRestartRequired: vi.fn(),
+      wssSendSnackbarMessage: vi.fn(),
+    } as any;
+  });
+
+  afterEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it('should initialize system and matterbridge information', () => {
+    expect(matterbridge.systemInformation).toBeDefined();
+    expect(matterbridge.matterbridgeInformation).toBeDefined();
+  });
+
+  it('should emit initialize_completed after initialize', async () => {
+    const spy = vi.fn();
+    matterbridge.on('initialize_completed', spy);
+    await matterbridge.initialize();
+    expect(spy).toHaveBeenCalled();
+    expect((matterbridge as any)['initialized']).toBe(true);
+  });
+
+  it('should call parseCommandLine during initialize', async () => {
+    const spy = vi.spyOn(matterbridge as any, 'parseCommandLine').mockResolvedValue(undefined);
+    await matterbridge.initialize();
+    expect(spy).toHaveBeenCalled();
+  });
+
+  it('should log system info in logNodeAndSystemInfo', async () => {
+    await (matterbridge as any)['logNodeAndSystemInfo']();
+    expect(matterbridge.log.debug).toHaveBeenCalled();
+  });
+
+  it('should register and deregister process handlers', () => {
+    (matterbridge as any)['registerProcessHandlers']();
+    (matterbridge as any)['deregisterProcessHandlers']();
+    expect(matterbridge.log.error).not.toHaveBeenCalled();
+  });
+
+  it('should call cleanup and emit cleanup events', async () => {
+    (matterbridge as any)['initialized'] = true;
+    (matterbridge as any)['hasCleanupStarted'] = false;
+    const spyStart = vi.fn();
+    const spyComplete = vi.fn();
+    matterbridge.on('cleanup_started', spyStart);
+    matterbridge.on('cleanup_completed', spyComplete);
+    await (matterbridge as any)['cleanup']('test cleanup');
+    expect(spyStart).toHaveBeenCalled();
+    expect(spyComplete).toHaveBeenCalled();
+  });
+
+  it('should not run cleanup if already started', async () => {
+    (matterbridge as any)['initialized'] = true;
+    (matterbridge as any)['hasCleanupStarted'] = true;
+    const debugSpy = matterbridge.log.debug as any;
+    await (matterbridge as any)['cleanup']('test cleanup');
+    expect(debugSpy).toHaveBeenCalledWith('Cleanup already started...');
+  });
+
+  it('should get devices using getDevices()', () => {
+    const fakeDevices = [{ id: 1 }, { id: 2 }];
+    matterbridge.devices.array = vi.fn(() => fakeDevices);
+    expect(matterbridge.getDevices()).toBe(fakeDevices);
+  });
+
+  it('should get plugins using getPlugins()', () => {
+    const fakePlugins = [{ name: 'p1' }, { name: 'p2' }];
+    matterbridge.plugins.array = vi.fn(() => fakePlugins);
+    expect(matterbridge.getPlugins()).toBe(fakePlugins);
+  });
+
+  it('should set log level and propagate to dependencies', async () => {
+    const setLevel = vi.fn();
+    matterbridge.frontend.logLevel = undefined;
+    matterbridge.devices.logLevel = undefined;
+    matterbridge.plugins.logLevel = undefined;
+    (global as any).MatterbridgeEndpoint = { logLevel: undefined };
+    matterbridge.log = { debug: vi.fn() } as any;
+    await matterbridge.setLogLevel(1); // 1 = INFO
+    expect(matterbridge.frontend.logLevel).toBe(1);
+    expect(matterbridge.devices.logLevel).toBe(1);
+    expect(matterbridge.plugins.logLevel).toBe(1);
+    expect(matterbridge.log.debug).toHaveBeenCalled();
+  });
+
+  it('should emit and listen to custom events', () => {
+    const handler = vi.fn();
+    matterbridge.on('online', handler);
+    matterbridge.emit('online', 'nodeid');
+    expect(handler).toHaveBeenCalledWith('nodeid');
+  });
+
+  it('should call destroyInstance and cleanup', async () => {
+    const cleanupSpy = vi.spyOn(matterbridge as any, 'cleanup').mockResolvedValue(undefined);
+    matterbridge.log.info = vi.fn();
+    await matterbridge.destroyInstance();
+    expect(cleanupSpy).toHaveBeenCalled();
+    expect(matterbridge.log.info).toHaveBeenCalledWith(expect.stringContaining('Destroy instance...'));
+  });
+
+  it('should call restartProcess and cleanup', async () => {
+    const cleanupSpy = vi.spyOn(matterbridge as any, 'cleanup').mockResolvedValue(undefined);
+    await matterbridge.restartProcess();
+    expect(cleanupSpy).toHaveBeenCalledWith('restarting...', true);
+  });
+
+  it('should call shutdownProcess and cleanup', async () => {
+    const cleanupSpy = vi.spyOn(matterbridge as any, 'cleanup').mockResolvedValue(undefined);
+    await matterbridge.shutdownProcess();
+    expect(cleanupSpy).toHaveBeenCalledWith('shutting down...', false);
+  });
+
+  it('should call updateProcess and cleanup', async () => {
+    const cleanupSpy = vi.spyOn(matterbridge as any, 'cleanup').mockResolvedValue(undefined);
+    matterbridge.log.info = vi.fn();
+    (matterbridge.frontend as any).wssSendRestartRequired = vi.fn();
+    await matterbridge.updateProcess();
+    expect(cleanupSpy).toHaveBeenCalledWith('updating...', false);
+    expect(matterbridge.log.info).toHaveBeenCalledWith(expect.stringContaining('Updating matterbridge...'));
+    expect((matterbridge.frontend as any).wssSendRestartRequired).toHaveBeenCalled();
+  });
+
+  it('should call unregisterAndShutdownProcess and cleanup', async () => {
+    const cleanupSpy = vi.spyOn(matterbridge as any, 'cleanup').mockResolvedValue(undefined);
+    matterbridge.log.info = vi.fn();
+    matterbridge.plugins = [{ name: 'p1' }];
+    matterbridge.removeAllBridgedEndpoints = vi.fn().mockResolvedValue(undefined);
+    matterbridge.devices.clear = vi.fn();
+    await matterbridge.unregisterAndShutdownProcess();
+    expect(cleanupSpy).toHaveBeenCalledWith('unregistered all devices and shutting down...', false);
+    expect(matterbridge.log.info).toHaveBeenCalledWith(expect.stringContaining('Unregistering all devices and shutting down...'));
+  });
+
+  it('should call shutdownProcessAndReset and cleanup', async () => {
+    const cleanupSpy = vi.spyOn(matterbridge as any, 'cleanup').mockResolvedValue(undefined);
+    await matterbridge.shutdownProcessAndReset();
+    expect(cleanupSpy).toHaveBeenCalledWith('shutting down with reset...', false);
+  });
+
+  it('should call shutdownProcessAndFactoryReset and cleanup', async () => {
+    const cleanupSpy = vi.spyOn(matterbridge as any, 'cleanup').mockResolvedValue(undefined);
+    await matterbridge.shutdownProcessAndFactoryReset();
+    expect(cleanupSpy).toHaveBeenCalledWith('shutting down with factory reset...', false);
+  });
+
+  // Add more tests for all public/protected methods to reach 100% coverage
+});