@matterbridge/core 3.10.6-dev-20260819-1fbaf31 → 3.10.6-dev-20260820-36b52be

package/dist/behaviors/fanControlServer.js

@@ -3,6 +3,8 @@ import { Status, StatusResponseError } from '@matter/types';
 import { FanControl } from '@matter/types/clusters/fan-control';
 import { getEnumDescription } from '@matterbridge/utils/enum';
 import { MatterbridgeServer } from './matterbridgeServer.js';
+const lookupStepDirection = ['Increase', 'Decrease'];
+const lookupFanMode = ['Off', 'Low', 'Medium', 'High', 'On', 'Auto', 'Auto', 'Smart'];
 const supportedFanModesBySequence = {
     [FanControl.FanModeSequence.OffLowMedHigh]: new Set([FanControl.FanMode.Off, FanControl.FanMode.Low, FanControl.FanMode.Medium, FanControl.FanMode.High]),
     [FanControl.FanModeSequence.OffLowHigh]: new Set([FanControl.FanMode.Off, FanControl.FanMode.Low, FanControl.FanMode.High]),
@@ -67,12 +69,15 @@ export class MatterbridgeFanControlServer extends FanControlServer.with(FanContr
         return result;
     }
     #handleFanModeChanging(fanMode) {
+        const device = this.endpoint.stateOf(MatterbridgeServer);
         if (fanMode === FanControl.FanMode.On) {
             this.state.fanMode = FanControl.FanMode.High;
+            device.log.debug(`handleFanModeChanging fanMode changed to ${lookupFanMode[fanMode]} >>> fanMode ${lookupFanMode[this.state.fanMode]} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
             return;
         }
         if (fanMode === FanControl.FanMode.Smart) {
             this.state.fanMode = this.features.auto ? FanControl.FanMode.Auto : FanControl.FanMode.High;
+            device.log.debug(`handleFanModeChanging fanMode changed to ${lookupFanMode[fanMode]} >>> fanMode ${lookupFanMode[this.state.fanMode]} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
             return;
         }
         if (!supportedFanModesBySequence[this.state.fanModeSequence].has(fanMode)) {
@@ -89,24 +94,33 @@ export class MatterbridgeFanControlServer extends FanControlServer.with(FanContr
                     this.state.speedCurrent = 0;
                 }
             });
+            device.log.debug(`handleFanModeChanging fanMode changed to ${lookupFanMode[fanMode]} >>> percentSetting ${this.state.percentSetting} percentCurrent ${this.state.percentCurrent} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
+            if (this.features.multiSpeed) {
+                device.log.debug(`handleFanModeChanging fanMode changed to ${lookupFanMode[fanMode]} >>> speedSetting ${this.state.speedSetting} speedCurrent ${this.state.speedCurrent} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
+            }
         }
         else if (fanMode === FanControl.FanMode.Auto) {
             this.state.percentSetting = null;
             if (this.features.multiSpeed) {
                 this.state.speedSetting = null;
+                device.log.debug(`handleFanModeChanging fanMode changed to ${lookupFanMode[fanMode]} >>> speedSetting ${this.state.speedSetting} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
             }
+            device.log.debug(`handleFanModeChanging fanMode changed to ${lookupFanMode[fanMode]} >>> percentSetting ${this.state.percentSetting} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
         }
         else {
             const resolved = resolvePercentSettingForFanMode(fanMode, this.state.percentSetting, this.state.fanModeSequence);
             if (resolved !== this.state.percentSetting)
                 this.state.percentSetting = resolved;
+            device.log.debug(`handleFanModeChanging fanMode changed to ${lookupFanMode[fanMode]} >>> percentSetting ${this.state.percentSetting} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
         }
     }
     #handlePercentSettingChanging(percentSetting, oldPercentSetting) {
+        const device = this.endpoint.stateOf(MatterbridgeServer);
         if (percentSetting === null) {
             if (this.state.fanMode === FanControl.FanMode.Auto)
                 return;
             this.state.percentSetting = oldPercentSetting;
+            device.log.debug(`handlePercentSettingChanging percentSetting changed to ${percentSetting} >>> fanMode ${lookupFanMode[this.state.fanMode]} percentSetting ${this.state.percentSetting} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
             return;
         }
         const fanMode = percentSetting === 0 ? FanControl.FanMode.Off : percentToFanMode(percentSetting, this.state.fanModeSequence);
@@ -116,13 +130,16 @@ export class MatterbridgeFanControlServer extends FanControlServer.with(FanContr
             const state = this.state;
             state.speedSetting = speedSettingForPercent(state.speedMax, percentSetting);
         }
+        device.log.debug(`handlePercentSettingChanging percentSetting changed to ${percentSetting} >>> fanMode ${lookupFanMode[this.state.fanMode]} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
     }
     #handleSpeedSettingChanging(speedSetting, oldSpeedSetting) {
+        const device = this.endpoint.stateOf(MatterbridgeServer);
         const state = this.state;
         if (speedSetting === null) {
             if (this.state.fanMode === FanControl.FanMode.Auto)
                 return;
             state.speedSetting = oldSpeedSetting;
+            device.log.debug(`handleSpeedSettingChanging speedSetting changed to ${speedSetting} >>> fanMode ${lookupFanMode[this.state.fanMode]} speedSetting ${state.speedSetting} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
             return;
         }
         const { percentSetting } = this.state;
@@ -134,9 +151,9 @@ export class MatterbridgeFanControlServer extends FanControlServer.with(FanContr
             this.state.fanMode = fanMode;
         if (percent !== this.state.percentSetting)
             this.state.percentSetting = percent;
+        device.log.debug(`handleSpeedSettingChanging speedSetting changed to ${speedSetting} >>> fanMode ${lookupFanMode[this.state.fanMode]} percentSetting ${this.state.percentSetting} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
     }
     async step(request) {
-        const lookupStepDirection = ['Increase', 'Decrease'];
         const device = this.endpoint.stateOf(MatterbridgeServer);
         device.log.info(`Stepping fan with direction ${lookupStepDirection[request.direction]} wrap: ${request.wrap} lowestOff: ${request.lowestOff} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
         await device.commandHandler.executeHandler('FanControl.step', {
@@ -176,7 +193,7 @@ export class MatterbridgeFanControlServer extends FanControlServer.with(FanContr
             const state = this.state;
             state.speedCurrent = speedSettingForPercent(state.speedMax, resolvedPercentSetting);
         }
-        device.log.debug(`MatterbridgeFanControlServer: step applied fanMode ${getEnumDescription(FanControl.FanMode, targetFanMode)}, percentCurrent ${this.state.percentCurrent}` +
+        device.log.debug(`MatterbridgeFanControlServer: step applied fanMode ${lookupFanMode[this.state.fanMode]}, percentCurrent ${this.state.percentCurrent}` +
             (this.features.multiSpeed ? `, speedCurrent ${this.state.speedCurrent}` : ''));
     }
 }

package/dist/cli.js

@@ -141,6 +141,7 @@ function help() {
       --loginterfaces:         log the network interfaces (usefull for finding the name of the interface to use with -mdnsinterface option)
       --logstorage:            log the node storage
       --systemcheck:           perform a system check (check Node.js version and network interfaces)
+      --demo-devices:          create demo devices (only in bridge mode)
 
     Reset Commands:
       --reset:                 remove the commissioning for Matterbridge (bridge mode and childbridge mode). Shutdown Matterbridge before using it!

package/dist/demoDevices.d.ts

@@ -0,0 +1,2 @@
+import type { Matterbridge } from './matterbridge.js';
+export declare function createDemoDevices(matterbridge: Matterbridge): Promise<void>;

package/dist/{chipTestDevices.js → demoDevices.js}

@@ -8,22 +8,22 @@ import { IrrigationSystem } from './devices/irrigationSystem.js';
 import { getSupportedDeviceType } from './matterbridgeDeviceTypes.js';
 import { MatterbridgeEndpoint } from './matterbridgeEndpoint.js';
 import { getSemtag } from './matterbridgeEndpointHelpers.js';
-export async function createChipTestDevices(matterbridge) {
-    if (!process.env.MATTERBRIDGE_DEMO_DEVICES || matterbridge.bridgeMode !== 'bridge' || !matterbridge.aggregatorNode)
+export async function createDemoDevices(matterbridge) {
+    if (matterbridge.bridgeMode !== 'bridge' || !matterbridge.serverNode || !matterbridge.aggregatorNode)
         return;
     const serverNode = matterbridge.serverNode;
     const aggregator = matterbridge.aggregatorNode;
     if (!serverNode || !aggregator) {
-        matterbridge.log.error('CHIP test devices can only be created when the server node and aggregator node are available');
+        matterbridge.log.error('Demo devices can only be created when the server node and aggregator node are available');
         return;
     }
     let ep;
     matterbridge.plugins.set({
-        name: 'matterbridge-chip',
+        name: 'matterbridge-demo-devices',
         path: '',
         type: 'DynamicPlatform',
         version: '1.0.0',
-        description: 'Chip test plugin',
+        description: 'Matterbridge demo devices',
         author: 'Matterbridge',
         enabled: false,
         private: false,
@@ -32,8 +32,8 @@ export async function createChipTestDevices(matterbridge) {
     const registerDevice = async (device, deviceName, serialNumber) => {
         device.createDefaultBridgedDeviceBasicInformationClusterServer(deviceName, serialNumber);
         device.addRequiredClusters();
-        device.plugin = 'matterbridge-chip';
-        await matterbridge.addBridgedEndpoint('matterbridge-chip', device);
+        device.plugin = 'matterbridge-demo-devices';
+        await matterbridge.addBridgedEndpoint('matterbridge-demo-devices', device);
     };
     const bridgedNode = getSupportedDeviceType('BridgedNode');
     const powerSource = getSupportedDeviceType('PowerSource');

package/dist/matterbridge.js

@@ -1569,11 +1569,17 @@ export class Matterbridge extends EventEmitter {
         this.aggregatorNode = await this.createAggregatorNode(this.matterbridgeContext);
         await this.serverNode.add(this.aggregatorNode);
         await addVirtualDevices(this, this.aggregatorNode);
-        if (process.env.MATTERBRIDGE_DEMO_DEVICES) {
-            const { createChipTestDevices } = await import('./chipTestDevices.js');
-            await createChipTestDevices(this);
+        if (process.env.MATTERBRIDGE_DEMO_DEVICES || hasParameter('demo-devices')) {
+            this.log.warn(' *********************************************************************************');
+            this.log.warn(' * MATTERBRIDGE_DEMO_DEVICES environment variable is set. Creating demo devices. *');
+            this.log.warn(' *********************************************************************************');
+            const { createDemoDevices } = await import('./demoDevices.js');
+            await createDemoDevices(this);
         }
         if (process.env.MATTERBRIDGE_CHIP_TEST && fs.existsSync(path.join(path.dirname(fileURLToPath(import.meta.url)), 'chipTests.js'))) {
+            this.log.warn(' ***********************************************************************************');
+            this.log.warn(' * MATTERBRIDGE_CHIP_TEST environment variable is set. Running chip test app pipe. *');
+            this.log.warn(' ***********************************************************************************');
             const { createChipTestAppPipe } = await import('./chipTests.js');
             createChipTestAppPipe(this);
         }
@@ -1888,6 +1894,9 @@ export class Matterbridge extends EventEmitter {
         }
         let rootEndpoint = ServerNode.RootEndpoint.with(PowerSourceServer.with(PowerSource.Feature.Wired));
         if (process.env.MATTERBRIDGE_CHIP_TEST && fs.existsSync(path.join(path.dirname(fileURLToPath(import.meta.url)), 'chipTests.js'))) {
+            this.log.warn(' ****************************************************************************************');
+            this.log.warn(' * MATTERBRIDGE_CHIP_TEST environment variable is set. Running TestEventTrigger server. *');
+            this.log.warn(' ****************************************************************************************');
             const { MatterbridgeGeneralDiagnosticsServer } = await import('./chipTests.js');
             rootEndpoint = rootEndpoint.with(MatterbridgeGeneralDiagnosticsServer);
         }

package/dist/matterbridgeEndpoint.js

@@ -1487,7 +1487,7 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
-    createDefaultBooleanStateConfigurationClusterServer(sensorFault = false, currentSensitivityLevel = 0, supportedSensitivityLevels = 2, defaultSensitivityLevel = 0) {
+    createDefaultBooleanStateConfigurationClusterServer(sensorFault = false, currentSensitivityLevel = 1, supportedSensitivityLevels = 3, defaultSensitivityLevel = 1) {
         this.behaviors.require(MatterbridgeBooleanStateConfigurationServer.with(BooleanStateConfiguration.Feature.Visual, BooleanStateConfiguration.Feature.Audible, BooleanStateConfiguration.Feature.AlarmSuppress, BooleanStateConfiguration.Feature.SensitivityLevel, BooleanStateConfiguration.Feature.FaultEvents).enable({
             events: { alarmsStateChanged: true, sensorFault: true },
         }), {

package/dist/pluginManager.js

@@ -428,7 +428,7 @@ export class PluginManager extends EventEmitter {
     }
     async loadFromStorage() {
         if (!this.matterbridge.nodeContext) {
-            throw new Error('loadFromStorage: node context is not available.');
+            throw new Error('PluginManager.loadFromStorage: node context is not available.');
         }
         const pluginsArray = await this.matterbridge.nodeContext.get('plugins', []);
         for (const plugin of pluginsArray)
@@ -438,11 +438,11 @@ export class PluginManager extends EventEmitter {
     }
     async saveToStorage() {
         if (!this.matterbridge.nodeContext) {
-            throw new Error('loadFromStorage: node context is not available.');
+            throw new Error('PluginManager.saveToStorage: node context is not available.');
         }
         const plugins = [];
         for (const plugin of this.array()) {
-            if (process.env.MATTERBRIDGE_DEMO_DEVICES && plugin.name === 'matterbridge-chip')
+            if (process.env.MATTERBRIDGE_DEMO_DEVICES && plugin.name === 'matterbridge-demo-devices')
                 continue;
             plugins.push({
                 name: plugin.name,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matterbridge/core",
-  "version": "3.10.6-dev-20260819-1fbaf31",
+  "version": "3.10.6-dev-20260820-36b52be",
   "description": "Matterbridge core library",
   "author": "https://github.com/Luligu",
   "homepage": "https://matterbridge.io/",
@@ -132,10 +132,10 @@
   },
   "dependencies": {
     "@matter/main": "0.17.9",
-    "@matterbridge/dgram": "3.10.6-dev-20260819-1fbaf31",
-    "@matterbridge/thread": "3.10.6-dev-20260819-1fbaf31",
-    "@matterbridge/types": "3.10.6-dev-20260819-1fbaf31",
-    "@matterbridge/utils": "3.10.6-dev-20260819-1fbaf31",
+    "@matterbridge/dgram": "3.10.6-dev-20260820-36b52be",
+    "@matterbridge/thread": "3.10.6-dev-20260820-36b52be",
+    "@matterbridge/types": "3.10.6-dev-20260820-36b52be",
+    "@matterbridge/utils": "3.10.6-dev-20260820-36b52be",
     "escape-html": "1.0.3",
     "express": "5.2.1",
     "express-rate-limit": "8.6.2",

package/dist/chipTestDevices.d.ts

@@ -1,2 +0,0 @@
-import type { Matterbridge } from './matterbridge.js';
-export declare function createChipTestDevices(matterbridge: Matterbridge): Promise<void>;