matterbridge 3.0.3-dev-20250521-42f79f6 → 3.0.4-dev-20250525-c88cf84

package/CHANGELOG.md

@@ -8,6 +8,27 @@ If you like this project and find it useful, please consider giving it a star on
   <img src="bmc-button.svg" alt="Buy me a coffee" width="120">
 </a>
 
+## [3.0.4] - 2025-05-??
+
+### Added
+
+- [jsdoc]: Improved jsdoc for cluster helpers.
+- [cover]: Added createDefaultTiltWindowCoveringClusterServer().
+
+### Changed
+
+- [legacy]: Removed legacy matter.js EndpointServer and logEndpoint that will be removed in matter.js 0.14.0. For developers: if you need to log the endpoint the call is Logger.get('LogEndpoint').info(endpoint).
+- [package]: Updated dependencies.
+- [package]: Updated multer package to 2.0.0.
+
+### Fixed
+
+- [virtualDevice]: Fixed possible vulnerability in the length of the nodeLabel.
+
+<a href="https://www.buymeacoffee.com/luligugithub">
+  <img src="bmc-button.svg" alt="Buy me a coffee" width="80">
+</a>
+
 ## [3.0.3] - 2025-05-19
 
 ### New plugins
@@ -23,10 +44,10 @@ AEG RX 9 / Electrolux Pure i9 robot vacuum plugin for Matterbridge.
 
 ### Added
 
-- [virtual] Added virtual devices configuration mode in the Matterbridge Settings: 'Disabled', 'Light', 'Outlet', 'Switch', 'Mounted_switch'. Switch is not supported by Alexa. Mounted Switch is not supported by Apple.
-- [deviceTypes] Added evse, waterHeater, solarPower, batteryStorage and heatPump device type.
-- [waterHeater] Added WaterHeater class to create a Water Heater Device Type in one line of code (thanks https://github.com/lboue).
-- [subscribe] Added a third parameter context (provisional implementation: when "context.offline === true" then this is a change coming from the device).
+- [virtual]: Added virtual devices configuration mode in the Matterbridge Settings: 'Disabled', 'Light', 'Outlet', 'Switch', 'Mounted_switch'. Switch is not supported by Alexa. Mounted Switch is not supported by Apple.
+- [deviceTypes]: Added evse, waterHeater, solarPower, batteryStorage and heatPump device type.
+- [waterHeater]: Added WaterHeater class to create a Water Heater Device Type in one line of code (thanks https://github.com/lboue).
+- [subscribe]: Added a third parameter context (provisional implementation: when "context.offline === true" then this is a change coming from the device).
 
 ### Changed
 

package/README.md

@@ -5,7 +5,7 @@
 [![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-85%25-brightgreen)
+![Coverage](https://img.shields.io/badge/Jest%20coverage-86%25-brightgreen)
 
 [![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)
@@ -86,7 +86,7 @@ Follow these steps to install Matterbridge:
 npm install -g matterbridge --omit=dev
 ```
 
-on Linux you may need the necessary permissions:
+on Linux or macOS you may need the necessary permissions:
 
 ```
 sudo npm install -g matterbridge --omit=dev
@@ -142,7 +142,7 @@ Here's how to specify a different port number:
 matterbridge -frontend [port number]
 ```
 
-To use the frontend with ssl place the certificates in the .matterbridge/certs directory: cert.pem, key.pem and ca.pem (optional).
+To use the frontend with ssl see below.
 
 From the frontend you can do all operations in an easy way.
 
@@ -196,7 +196,7 @@ The other Home Assistant Community Add-ons and plugins are not verified to work
   <img src="screenshot/Shelly.svg" alt="Shelly plugin logo" width="100" />
 </a>
 
-Matterbridge shelly plugin allows you to expose all Shelly Gen 1, Gen 2, Gen 3 and BLU devices to Matter.
+Matterbridge shelly plugin allows you to expose all Shelly Gen 1, Gen 2, Gen 3 and Gen 4 and BLU devices to Matter.
 
 Features:
 
@@ -253,7 +253,7 @@ It is the ideal companion of the official [Matterbridge Home Assistant Add-on](h
   <img src="frontend/public/matterbridge.svg" alt="Matterbridge logo" width="100" />
 </a>
 
-Matterbridge Webhooks plugin allows you to expose any webhooks to Matter..
+Matterbridge Webhooks plugin allows you to expose any webhooks to Matter.
 
 ### BTHome
 
@@ -506,12 +506,6 @@ As of version 18.4.x, the Robot is supported by the Home app only as a single, n
 
 If a Robot is present alongside other devices in the bridge, the entire bridge becomes unstable in the Home app.
 
-### Concentration measurements clusters
-
-As of version 18.4.x, all cluster derived from the concentration measurement cluster hang the Home app while pairing and the entire bridge becomes unstable in the Home app.
-
-For example: air quality sensors with TVOC measurement or co sensors with CarbonMonoxide measurement.
-
 ## Home Assistant
 
 So far is the only controller supporting some Matter 1.2, 1.3 and 1.4 device type:
@@ -559,7 +553,7 @@ There is no support for these Matter device types:
 
 In the zigbee2mqtt and shelly plugins select the option to expose
 the switch devices like light or outlet cause they don't show up like switch
-(Matterbridge uses a modified switch device type without client cluster).
+(Matterbridge uses a switch device type without client cluster).
 
 ## SmartThings
 

package/dist/frontend.js

@@ -1,4 +1,5 @@
-import { EndpointServer, Logger, LogLevel as MatterLogLevel, LogFormat as MatterLogFormat, Lifecycle } from '@matter/main';
+import { Logger, LogLevel as MatterLogLevel, LogFormat as MatterLogFormat, Lifecycle } from '@matter/main';
+import { BridgedDeviceBasicInformation, PowerSource } from '@matter/main/clusters';
 import { createServer } from 'node:http';
 import https from 'node:https';
 import os from 'node:os';
@@ -11,7 +12,7 @@ import { AnsiLogger, stringify, debugStringify, CYAN, db, er, nf, rs, UNDERLINE,
 import { createZip, isValidArray, isValidNumber, isValidObject, isValidString, isValidBoolean, withTimeout } from './utils/export.js';
 import { plg } from './matterbridgeTypes.js';
 import { hasParameter } from './utils/export.js';
-import { BridgedDeviceBasicInformation, PowerSource } from '@matter/main/clusters';
+import { capitalizeFirstLetter } from './matterbridgeEndpointHelpers.js';
 export const WS_ID_LOG = 0;
 export const WS_ID_REFRESH_NEEDED = 1;
 export const WS_ID_RESTART_NEEDED = 2;
@@ -569,8 +570,8 @@ export class Frontend {
             return true;
         return false;
     }
-    getPowerSource(device) {
-        if (!device.lifecycle.isReady || device.construction.status !== Lifecycle.Status.Active)
+    getPowerSource(endpoint) {
+        if (!endpoint.lifecycle.isReady || endpoint.construction.status !== Lifecycle.Status.Active)
             return undefined;
         const powerSource = (device) => {
             const featureMap = device.getAttribute(PowerSource.Cluster.id, 'featureMap');
@@ -584,9 +585,9 @@ export class Frontend {
             }
             return;
         };
-        if (device.hasClusterServer(PowerSource.Cluster.id))
-            return powerSource(device);
-        for (const child of device.getChildEndpoints()) {
+        if (endpoint.hasClusterServer(PowerSource.Cluster.id))
+            return powerSource(endpoint);
+        for (const child of endpoint.getChildEndpoints()) {
             if (child.hasClusterServer(PowerSource.Cluster.id))
                 return powerSource(child);
         }
@@ -632,7 +633,7 @@ export class Frontend {
         let attributes = '';
         let supportedModes = [];
         device.forEachAttribute((clusterName, clusterId, attributeName, attributeId, attributeValue) => {
-            if (typeof attributeValue === 'undefined')
+            if (typeof attributeValue === 'undefined' || attributeValue === undefined)
                 return;
             if (clusterName === 'onOff' && attributeName === 'onOff')
                 attributes += `OnOff: ${attributeValue} `;
@@ -787,6 +788,64 @@ export class Frontend {
         });
         return devices;
     }
+    getClusters(pluginName, endpointNumber) {
+        const endpoint = this.matterbridge.devices.array().find((d) => d.plugin === pluginName && d.maybeNumber === endpointNumber);
+        if (!endpoint || !endpoint.plugin || !endpoint.maybeNumber || !endpoint.deviceName || !endpoint.serialNumber) {
+            this.log.error(`getClusters: no device found for plugin ${pluginName} and endpoint number ${endpointNumber}`);
+            return;
+        }
+        const deviceTypes = [];
+        const clusters = [];
+        endpoint.state.descriptor.deviceTypeList.forEach((d) => {
+            deviceTypes.push(d.deviceType);
+        });
+        endpoint.forEachAttribute((clusterName, clusterId, attributeName, attributeId, attributeValue) => {
+            if (typeof attributeValue === 'undefined' || attributeValue === undefined)
+                return;
+            if (clusterName === 'EveHistory' && ['configDataGet', 'configDataSet', 'historyStatus', 'historyEntries', 'historyRequest', 'historySetTime', 'rLoc'].includes(attributeName))
+                return;
+            clusters.push({
+                endpoint: endpoint.number.toString(),
+                id: 'main',
+                deviceTypes,
+                clusterName: capitalizeFirstLetter(clusterName),
+                clusterId: '0x' + clusterId.toString(16).padStart(2, '0'),
+                attributeName,
+                attributeId: '0x' + attributeId.toString(16).padStart(2, '0'),
+                attributeValue: typeof attributeValue === 'object' ? stringify(attributeValue) : attributeValue.toString(),
+                attributeLocalValue: attributeValue,
+            });
+        });
+        const childEndpoints = endpoint.getChildEndpoints();
+        childEndpoints.forEach((childEndpoint) => {
+            if (!childEndpoint.maybeId || !childEndpoint.maybeNumber) {
+                this.log.error(`getClusters: no child endpoint found for plugin ${pluginName} and endpoint number ${endpointNumber}`);
+                return;
+            }
+            const deviceTypes = [];
+            childEndpoint.state.descriptor.deviceTypeList.forEach((d) => {
+                deviceTypes.push(d.deviceType);
+            });
+            childEndpoint.forEachAttribute((clusterName, clusterId, attributeName, attributeId, attributeValue) => {
+                if (typeof attributeValue === 'undefined' || attributeValue === undefined)
+                    return;
+                if (clusterName === 'EveHistory' && ['configDataGet', 'configDataSet', 'historyStatus', 'historyEntries', 'historyRequest', 'historySetTime', 'rLoc'].includes(attributeName))
+                    return;
+                clusters.push({
+                    endpoint: childEndpoint.number.toString(),
+                    id: childEndpoint.maybeId ?? 'null',
+                    deviceTypes,
+                    clusterName: capitalizeFirstLetter(clusterName),
+                    clusterId: '0x' + clusterId.toString(16).padStart(2, '0'),
+                    attributeName,
+                    attributeId: '0x' + attributeId.toString(16).padStart(2, '0'),
+                    attributeValue: typeof attributeValue === 'object' ? stringify(attributeValue) : attributeValue.toString(),
+                    attributeLocalValue: attributeValue,
+                });
+            });
+        });
+        return { plugin: endpoint.plugin, deviceName: endpoint.deviceName, serialNumber: endpoint.serialNumber, endpoint: endpoint.maybeNumber, deviceTypes, clusters };
+    }
     async wsMessageHandler(client, message) {
         let data;
         try {
@@ -1099,102 +1158,24 @@ export class Frontend {
                     client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Wrong parameter endpoint in /api/clusters' }));
                     return;
                 }
-                const clusters = [];
-                let deviceName = '';
-                let serialNumber = '';
-                let deviceTypes = [];
-                this.matterbridge.devices.forEach(async (device) => {
-                    if (data.params.plugin !== device.plugin)
-                        return;
-                    if (data.params.endpoint !== device.number)
-                        return;
-                    deviceName = device.deviceName ?? 'Unknown';
-                    serialNumber = device.serialNumber ?? 'Unknown';
-                    deviceTypes = [];
-                    const endpointServer = EndpointServer.forEndpoint(device);
-                    const clusterServers = endpointServer.getAllClusterServers();
-                    clusterServers.forEach((clusterServer) => {
-                        Object.entries(clusterServer.attributes).forEach(([key, value]) => {
-                            if (clusterServer.name === 'EveHistory') {
-                                if (['configDataGet', 'configDataSet', 'historyStatus', 'historyEntries', 'historyRequest', 'historySetTime', 'rLoc'].includes(key)) {
-                                    return;
-                                }
-                            }
-                            if (clusterServer.name === 'Descriptor' && key === 'deviceTypeList') {
-                                value.getLocal().forEach((deviceType) => {
-                                    deviceTypes.push(deviceType.deviceType);
-                                });
-                            }
-                            let attributeValue;
-                            let attributeLocalValue;
-                            try {
-                                if (typeof value.getLocal() === 'object')
-                                    attributeValue = stringify(value.getLocal());
-                                else
-                                    attributeValue = value.getLocal().toString();
-                                attributeLocalValue = value.getLocal();
-                            }
-                            catch (error) {
-                                attributeValue = 'Fabric-Scoped';
-                                attributeLocalValue = 'Fabric-Scoped';
-                                this.log.debug(`GetLocal value ${error} in clusterServer: ${clusterServer.name}(${clusterServer.id}) attribute: ${key}(${value.id})`);
-                            }
-                            clusters.push({
-                                endpoint: device.number ? device.number.toString() : '...',
-                                id: 'main',
-                                deviceTypes,
-                                clusterName: clusterServer.name,
-                                clusterId: '0x' + clusterServer.id.toString(16).padStart(2, '0'),
-                                attributeName: key,
-                                attributeId: '0x' + value.id.toString(16).padStart(2, '0'),
-                                attributeValue,
-                                attributeLocalValue,
-                            });
-                        });
-                    });
-                    endpointServer.getChildEndpoints().forEach((childEndpoint) => {
-                        deviceTypes = [];
-                        const name = childEndpoint.endpoint?.id;
-                        const clusterServers = childEndpoint.getAllClusterServers();
-                        clusterServers.forEach((clusterServer) => {
-                            Object.entries(clusterServer.attributes).forEach(([key, value]) => {
-                                if (clusterServer.name === 'EveHistory')
-                                    return;
-                                if (clusterServer.name === 'Descriptor' && key === 'deviceTypeList') {
-                                    value.getLocal().forEach((deviceType) => {
-                                        deviceTypes.push(deviceType.deviceType);
-                                    });
-                                }
-                                let attributeValue;
-                                let attributeLocalValue;
-                                try {
-                                    if (typeof value.getLocal() === 'object')
-                                        attributeValue = stringify(value.getLocal());
-                                    else
-                                        attributeValue = value.getLocal().toString();
-                                    attributeLocalValue = value.getLocal();
-                                }
-                                catch (error) {
-                                    attributeValue = 'Fabric-Scoped';
-                                    attributeLocalValue = 'Fabric-Scoped';
-                                    this.log.debug(`GetLocal error ${error} in clusterServer: ${clusterServer.name}(${clusterServer.id}) attribute: ${key}(${value.id})`);
-                                }
-                                clusters.push({
-                                    endpoint: childEndpoint.number ? childEndpoint.number.toString() : '...',
-                                    id: name,
-                                    deviceTypes,
-                                    clusterName: clusterServer.name,
-                                    clusterId: '0x' + clusterServer.id.toString(16).padStart(2, '0'),
-                                    attributeName: key,
-                                    attributeId: '0x' + value.id.toString(16).padStart(2, '0'),
-                                    attributeValue,
-                                    attributeLocalValue,
-                                });
-                            });
-                        });
-                    });
-                });
-                client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, plugin: data.params.plugin, deviceName, serialNumber, endpoint: data.params.endpoint, deviceTypes, response: clusters }));
+                const response = this.getClusters(data.params.plugin, data.params.endpoint);
+                if (response) {
+                    client.send(JSON.stringify({
+                        id: data.id,
+                        method: data.method,
+                        src: 'Matterbridge',
+                        dst: data.src,
+                        plugin: data.params.plugin,
+                        deviceName: response.deviceName,
+                        serialNumber: response.serialNumber,
+                        endpoint: response.endpoint,
+                        deviceTypes: response.deviceTypes,
+                        response: response.clusters,
+                    }));
+                }
+                else {
+                    client.send(JSON.stringify({ id: data.id, method: data.method, src: 'Matterbridge', dst: data.src, error: 'Endpoint not found in /api/clusters' }));
+                }
             }
             else if (data.method === '/api/select' || data.method === '/api/select/devices') {
                 if (!isValidString(data.params.plugin, 10)) {

package/dist/helpers.js

@@ -25,13 +25,19 @@ export async function addVirtualDevice(aggregatorEndpoint, name, type, callback)
     }
     const device = new Endpoint(deviceType, {
         id: name.replaceAll(' ', '') + ':' + type,
-        bridgedDeviceBasicInformation: { nodeLabel: name },
+        bridgedDeviceBasicInformation: { nodeLabel: name.slice(0, 32) },
         onOff: { onOff: false, startUpOnOff: OnOff.StartUpOnOff.Off },
     });
-    device.events.onOff.onOff$Changed.on(async (value) => {
+    device.events.onOff.onOff$Changed.on((value) => {
         if (value) {
-            await device.setStateOf(OnOffBaseServer, { onOff: false });
             callback();
+            process.nextTick(async () => {
+                try {
+                    await device.setStateOf(OnOffBaseServer, { onOff: false });
+                }
+                catch (_error) {
+                }
+            });
         }
     });
     await aggregatorEndpoint.add(device);

package/dist/matter/export.js

@@ -1,4 +1,4 @@
 export * from '@matter/main';
 export { SemanticNamespace, ClosureTag, CompassDirectionTag, CompassLocationTag, DirectionTag, ElectricalMeasurementTag, LaundryTag, LevelTag, LocationTag, NumberTag, PositionTag, PowerSourceTag, RefrigeratorTag, RoomAirConditionerTag, SwitchesTag, } from '@matter/main';
 export { AttributeElement, ClusterElement, ClusterModel, CommandElement, EventElement, FieldElement } from '@matter/main/model';
-export { logEndpoint, MdnsService, Val } from '@matter/main/protocol';
+export { MdnsService, Val } from '@matter/main/protocol';

package/dist/matterbridgeBehaviors.js

@@ -117,6 +117,10 @@ export class MatterbridgeServerDevice {
         this.log.info(`Setting cover lift percentage to ${liftPercent100thsValue} (endpoint ${this.endpointId}.${this.endpointNumber})`);
         this.commandHandler.executeHandler('goToLiftPercentage', { request: { liftPercent100thsValue }, attributes: {}, endpoint: { number: this.endpointNumber, uniqueStorageKey: this.endpointId } });
     }
+    goToTiltPercentage({ tiltPercent100thsValue }) {
+        this.log.info(`Setting cover tilt percentage to ${tiltPercent100thsValue} (endpoint ${this.endpointId}.${this.endpointNumber})`);
+        this.commandHandler.executeHandler('goToTiltPercentage', { request: { tiltPercent100thsValue }, attributes: {}, endpoint: { number: this.endpointNumber, uniqueStorageKey: this.endpointId } });
+    }
     lockDoor() {
         this.log.info(`Locking door (endpoint ${this.endpointId}.${this.endpointNumber})`);
         this.commandHandler.executeHandler('lockDoor', { request: {}, attributes: {}, endpoint: { number: this.endpointNumber, uniqueStorageKey: this.endpointId } });
@@ -281,7 +285,7 @@ export class MatterbridgeColorControlServer extends ColorControlServer.with(Colo
         super.moveToColorTemperature({ optionsOverride, optionsMask, colorTemperatureMireds, transitionTime });
     }
 }
-export class MatterbridgeWindowCoveringServer extends WindowCoveringServer.with(WindowCovering.Feature.Lift, WindowCovering.Feature.PositionAwareLift) {
+export class MatterbridgeLiftWindowCoveringServer extends WindowCoveringServer.with(WindowCovering.Feature.Lift, WindowCovering.Feature.PositionAwareLift) {
     upOrOpen() {
         const device = this.agent.get(MatterbridgeServer).state.deviceCommand;
         device.upOrOpen();
@@ -309,6 +313,40 @@ export class MatterbridgeWindowCoveringServer extends WindowCoveringServer.with(
     async handleMovement(type, reversed, direction, targetPercent100ths) {
     }
 }
+export class MatterbridgeLiftTiltWindowCoveringServer extends WindowCoveringServer.with(WindowCovering.Feature.Lift, WindowCovering.Feature.PositionAwareLift, WindowCovering.Feature.Tilt, WindowCovering.Feature.PositionAwareTilt) {
+    upOrOpen() {
+        const device = this.agent.get(MatterbridgeServer).state.deviceCommand;
+        device.upOrOpen();
+        device.log.debug(`MatterbridgeLiftTiltWindowCoveringServer: upOrOpen called`);
+        super.upOrOpen();
+    }
+    downOrClose() {
+        const device = this.agent.get(MatterbridgeServer).state.deviceCommand;
+        device.downOrClose();
+        device.log.debug(`MatterbridgeLiftTiltWindowCoveringServer: downOrClose called`);
+        super.downOrClose();
+    }
+    stopMotion() {
+        const device = this.agent.get(MatterbridgeServer).state.deviceCommand;
+        device.stopMotion();
+        device.log.debug(`MatterbridgeLiftTiltWindowCoveringServer: stopMotion called`);
+        super.stopMotion();
+    }
+    goToLiftPercentage({ liftPercent100thsValue }) {
+        const device = this.agent.get(MatterbridgeServer).state.deviceCommand;
+        device.goToLiftPercentage({ liftPercent100thsValue });
+        device.log.debug(`MatterbridgeLiftTiltWindowCoveringServer: goToLiftPercentage with ${liftPercent100thsValue}`);
+        super.goToLiftPercentage({ liftPercent100thsValue });
+    }
+    goToTiltPercentage({ tiltPercent100thsValue }) {
+        const device = this.agent.get(MatterbridgeServer).state.deviceCommand;
+        device.goToTiltPercentage({ tiltPercent100thsValue });
+        device.log.debug(`MatterbridgeLiftTiltWindowCoveringServer: goToTiltPercentage with ${tiltPercent100thsValue}`);
+        super.goToTiltPercentage({ tiltPercent100thsValue });
+    }
+    async handleMovement(type, reversed, direction, targetPercent100ths) {
+    }
+}
 export class MatterbridgeDoorLockServer extends DoorLockServer {
     lockDoor() {
         const device = this.agent.get(MatterbridgeServer).state.deviceCommand;

package/dist/matterbridgeEndpoint.js

@@ -1,8 +1,8 @@
-import { AnsiLogger, BLUE, CYAN, YELLOW, db, debugStringify, er, hk, or, zb } from './logger/export.js';
+import { AnsiLogger, CYAN, YELLOW, db, debugStringify, hk, or, zb } from './logger/export.js';
 import { bridgedNode } from './matterbridgeDeviceTypes.js';
 import { isValidNumber, isValidObject, isValidString } from './utils/export.js';
-import { MatterbridgeServer, MatterbridgeServerDevice, MatterbridgeIdentifyServer, MatterbridgeOnOffServer, MatterbridgeLevelControlServer, MatterbridgeColorControlServer, MatterbridgeWindowCoveringServer, MatterbridgeThermostatServer, MatterbridgeFanControlServer, MatterbridgeDoorLockServer, MatterbridgeModeSelectServer, MatterbridgeValveConfigurationAndControlServer, MatterbridgeSmokeCoAlarmServer, MatterbridgeBooleanStateConfigurationServer, MatterbridgeSwitchServer, MatterbridgeOperationalStateServer, } from './matterbridgeBehaviors.js';
-import { addClusterServers, addFixedLabel, addOptionalClusterServers, addRequiredClusterServers, addUserLabel, capitalizeFirstLetter, createUniqueId, getBehavior, getBehaviourTypesFromClusterClientIds, getBehaviourTypesFromClusterServerIds, getDefaultOperationalStateClusterServer, getDefaultFlowMeasurementClusterServer, getDefaultIlluminanceMeasurementClusterServer, getDefaultPressureMeasurementClusterServer, getDefaultRelativeHumidityMeasurementClusterServer, getDefaultTemperatureMeasurementClusterServer, getDefaultOccupancySensingClusterServer, lowercaseFirstLetter, updateAttribute, getClusterId, getAttributeId, setAttribute, getAttribute, checkNotLatinCharacters, generateUniqueId, subscribeAttribute, invokeBehaviorCommand, } from './matterbridgeEndpointHelpers.js';
+import { MatterbridgeServer, MatterbridgeServerDevice, MatterbridgeIdentifyServer, MatterbridgeOnOffServer, MatterbridgeLevelControlServer, MatterbridgeColorControlServer, MatterbridgeLiftWindowCoveringServer, MatterbridgeLiftTiltWindowCoveringServer, MatterbridgeThermostatServer, MatterbridgeFanControlServer, MatterbridgeDoorLockServer, MatterbridgeModeSelectServer, MatterbridgeValveConfigurationAndControlServer, MatterbridgeSmokeCoAlarmServer, MatterbridgeBooleanStateConfigurationServer, MatterbridgeSwitchServer, MatterbridgeOperationalStateServer, } from './matterbridgeBehaviors.js';
+import { addClusterServers, addFixedLabel, addOptionalClusterServers, addRequiredClusterServers, addUserLabel, createUniqueId, getBehavior, getBehaviourTypesFromClusterClientIds, getBehaviourTypesFromClusterServerIds, getDefaultOperationalStateClusterServer, getDefaultFlowMeasurementClusterServer, getDefaultIlluminanceMeasurementClusterServer, getDefaultPressureMeasurementClusterServer, getDefaultRelativeHumidityMeasurementClusterServer, getDefaultTemperatureMeasurementClusterServer, getDefaultOccupancySensingClusterServer, lowercaseFirstLetter, updateAttribute, getClusterId, getAttributeId, setAttribute, getAttribute, checkNotLatinCharacters, generateUniqueId, subscribeAttribute, invokeBehaviorCommand, triggerEvent, } from './matterbridgeEndpointHelpers.js';
 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';
@@ -182,20 +182,8 @@ export class MatterbridgeEndpoint extends Endpoint {
     async subscribeAttribute(cluster, attribute, listener, log) {
         return await subscribeAttribute(this, cluster, attribute, listener, log);
     }
-    async triggerEvent(clusterId, event, payload, log) {
-        const clusterName = lowercaseFirstLetter(getClusterNameById(clusterId));
-        if (this.construction.status !== Lifecycle.Status.Active) {
-            this.log.error(`triggerEvent ${hk}${clusterName}.${event}${er} error: Endpoint ${or}${this.maybeId}${er}:${or}${this.maybeNumber}${er} is in the ${BLUE}${this.construction.status}${er} state`);
-            return false;
-        }
-        const events = this.events;
-        if (!(clusterName in events) || !(event in events[clusterName])) {
-            this.log.error(`triggerEvent ${hk}${event}${er} error: Cluster ${'0x' + clusterId.toString(16).padStart(4, '0')}:${clusterName} not found on endpoint ${or}${this.id}${er}:${or}${this.number}${er}`);
-            return false;
-        }
-        await this.act((agent) => agent[clusterName].events[event].emit(payload, agent.context));
-        log?.info(`${db}Trigger event ${hk}${capitalizeFirstLetter(clusterName)}${db}.${hk}${event}${db} with ${debugStringify(payload)}${db} on endpoint ${or}${this.id}${db}:${or}${this.number}${db} `);
-        return true;
+    async triggerEvent(cluster, event, payload, log) {
+        return await triggerEvent(this, cluster, event, payload, log);
     }
     addClusterServers(serverList) {
         addClusterServers(this, serverList);
@@ -237,6 +225,8 @@ export class MatterbridgeEndpoint extends Endpoint {
         if (!this.lifecycle.isReady || this.construction.status !== Lifecycle.Status.Active)
             return;
         for (const [clusterName, clusterAttributes] of Object.entries(this.state)) {
+            if (!isNaN(Number(clusterName)))
+                continue;
             for (const [attributeName, attributeValue] of Object.entries(clusterAttributes)) {
                 const clusterId = getClusterId(this, clusterName);
                 if (clusterId === undefined) {
@@ -589,8 +579,8 @@ export class MatterbridgeEndpoint extends Endpoint {
             colorTempPhysicalMinMireds,
             colorTempPhysicalMaxMireds,
             coupleColorTempToLevelMinMireds: colorTempPhysicalMinMireds,
-            remainingTime: 0,
             startUpColorTemperatureMireds: null,
+            remainingTime: 0,
         });
         return this;
     }
@@ -634,7 +624,7 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
-    createCtColorControlClusterServer(colorTemperatureMireds = 500, colorTempPhysicalMinMireds = 147, colorTempPhysicalMaxMireds = 500) {
+    createCtColorControlClusterServer(colorTemperatureMireds = 250, colorTempPhysicalMinMireds = 147, colorTempPhysicalMaxMireds = 500) {
         this.behaviors.require(MatterbridgeColorControlServer.with(ColorControl.Feature.ColorTemperature), {
             colorMode: ColorControl.ColorMode.ColorTemperatureMireds,
             enhancedColorMode: ColorControl.EnhancedColorMode.ColorTemperatureMireds,
@@ -647,8 +637,8 @@ export class MatterbridgeEndpoint extends Endpoint {
             colorTempPhysicalMinMireds,
             colorTempPhysicalMaxMireds,
             coupleColorTempToLevelMinMireds: colorTempPhysicalMinMireds,
-            remainingTime: 0,
             startUpColorTemperatureMireds: null,
+            remainingTime: 0,
         });
         return this;
     }
@@ -658,12 +648,13 @@ export class MatterbridgeEndpoint extends Endpoint {
             await this.setAttribute(ColorControl.Cluster.id, 'enhancedColorMode', colorMode, this.log);
         }
     }
-    createDefaultWindowCoveringClusterServer(positionPercent100ths) {
-        this.behaviors.require(MatterbridgeWindowCoveringServer.with(WindowCovering.Feature.Lift, WindowCovering.Feature.PositionAwareLift), {
-            type: WindowCovering.WindowCoveringType.Rollershade,
+    createDefaultWindowCoveringClusterServer(positionPercent100ths, type = WindowCovering.WindowCoveringType.Rollershade, endProductType = WindowCovering.EndProductType.RollerShade) {
+        this.behaviors.require(MatterbridgeLiftWindowCoveringServer.with(WindowCovering.Feature.Lift, WindowCovering.Feature.PositionAwareLift), {
+            type,
+            numberOfActuationsLift: 0,
             configStatus: {
                 operational: true,
-                onlineReserved: true,
+                onlineReserved: false,
                 liftMovementReversed: false,
                 liftPositionAware: true,
                 tiltPositionAware: false,
@@ -671,13 +662,37 @@ export class MatterbridgeEndpoint extends Endpoint {
                 tiltEncoderControlled: false,
             },
             operationalStatus: { global: WindowCovering.MovementStatus.Stopped, lift: WindowCovering.MovementStatus.Stopped, tilt: WindowCovering.MovementStatus.Stopped },
-            endProductType: WindowCovering.EndProductType.RollerShade,
+            endProductType,
             mode: { motorDirectionReversed: false, calibrationMode: false, maintenanceMode: false, ledFeedback: false },
             targetPositionLiftPercent100ths: positionPercent100ths ?? 0,
             currentPositionLiftPercent100ths: positionPercent100ths ?? 0,
         });
         return this;
     }
+    createDefaultLiftTiltWindowCoveringClusterServer(positionLiftPercent100ths, positionTiltPercent100ths, type = WindowCovering.WindowCoveringType.TiltBlindLift, endProductType = WindowCovering.EndProductType.InteriorBlind) {
+        this.behaviors.require(MatterbridgeLiftTiltWindowCoveringServer.with(WindowCovering.Feature.Lift, WindowCovering.Feature.PositionAwareLift, WindowCovering.Feature.Tilt, WindowCovering.Feature.PositionAwareTilt), {
+            type,
+            numberOfActuationsLift: 0,
+            numberOfActuationsTilt: 0,
+            configStatus: {
+                operational: true,
+                onlineReserved: false,
+                liftMovementReversed: false,
+                liftPositionAware: true,
+                tiltPositionAware: true,
+                liftEncoderControlled: false,
+                tiltEncoderControlled: false,
+            },
+            operationalStatus: { global: WindowCovering.MovementStatus.Stopped, lift: WindowCovering.MovementStatus.Stopped, tilt: WindowCovering.MovementStatus.Stopped },
+            endProductType,
+            mode: { motorDirectionReversed: false, calibrationMode: false, maintenanceMode: false, ledFeedback: false },
+            targetPositionLiftPercent100ths: positionLiftPercent100ths ?? 0,
+            currentPositionLiftPercent100ths: positionLiftPercent100ths ?? 0,
+            targetPositionTiltPercent100ths: positionTiltPercent100ths ?? 0,
+            currentPositionTiltPercent100ths: positionTiltPercent100ths ?? 0,
+        });
+        return this;
+    }
     async setWindowCoveringTargetAsCurrentAndStopped() {
         const position = this.getAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', this.log);
         if (isValidNumber(position, 0, 10000)) {
@@ -689,6 +704,13 @@ export class MatterbridgeEndpoint extends Endpoint {
             }, this.log);
         }
         this.log.debug(`Set WindowCovering currentPositionLiftPercent100ths and targetPositionLiftPercent100ths to ${position} and operationalStatus to Stopped.`);
+        if (this.hasAttributeServer(WindowCovering.Cluster.id, 'currentPositionTiltPercent100ths')) {
+            const position = this.getAttribute(WindowCovering.Cluster.id, 'currentPositionTiltPercent100ths', this.log);
+            if (isValidNumber(position, 0, 10000)) {
+                await this.setAttribute(WindowCovering.Cluster.id, 'targetPositionTiltPercent100ths', position, this.log);
+            }
+            this.log.debug(`Set WindowCovering currentPositionTiltPercent100ths and targetPositionTiltPercent100ths to ${position} and operationalStatus to Stopped.`);
+        }
     }
     async setWindowCoveringCurrentTargetStatus(current, target, status) {
         await this.setAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', current, this.log);
@@ -715,10 +737,15 @@ export class MatterbridgeEndpoint extends Endpoint {
             return status.global;
         }
     }
-    async setWindowCoveringTargetAndCurrentPosition(position) {
-        await this.setAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', position, this.log);
-        await this.setAttribute(WindowCovering.Cluster.id, 'targetPositionLiftPercent100ths', position, this.log);
-        this.log.debug(`Set WindowCovering currentPositionLiftPercent100ths: ${position} and targetPositionLiftPercent100ths: ${position}.`);
+    async setWindowCoveringTargetAndCurrentPosition(liftPosition, tiltPosition) {
+        await this.setAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', liftPosition, this.log);
+        await this.setAttribute(WindowCovering.Cluster.id, 'targetPositionLiftPercent100ths', liftPosition, this.log);
+        this.log.debug(`Set WindowCovering currentPositionLiftPercent100ths: ${liftPosition} and targetPositionLiftPercent100ths: ${liftPosition}.`);
+        if (tiltPosition && this.hasAttributeServer(WindowCovering.Cluster.id, 'currentPositionTiltPercent100ths')) {
+            await this.setAttribute(WindowCovering.Cluster.id, 'currentPositionTiltPercent100ths', tiltPosition, this.log);
+            await this.setAttribute(WindowCovering.Cluster.id, 'targetPositionTiltPercent100ths', tiltPosition, this.log);
+            this.log.debug(`Set WindowCovering currentPositionTiltPercent100ths: ${tiltPosition} and targetPositionTiltPercent100ths: ${tiltPosition}.`);
+        }
     }
     createDefaultThermostatClusterServer(localTemperature = 23, occupiedHeatingSetpoint = 21, occupiedCoolingSetpoint = 25, minSetpointDeadBand = 1, minHeatSetpointLimit = 0, maxHeatSetpointLimit = 50, minCoolSetpointLimit = 0, maxCoolSetpointLimit = 50) {
         this.behaviors.require(MatterbridgeThermostatServer.with(Thermostat.Feature.Heating, Thermostat.Feature.Cooling, Thermostat.Feature.AutoMode), {

package/dist/matterbridgeEndpointHelpers.js

@@ -74,7 +74,7 @@ import { TotalVolatileOrganicCompoundsConcentrationMeasurementServer } from '@ma
 import { createHash } from 'node:crypto';
 import { BLUE, CYAN, db, debugStringify, er, hk, or, YELLOW, zb } from 'node-ansi-logger';
 import { deepCopy, deepEqual, isValidArray } from './utils/export.js';
-import { MatterbridgeIdentifyServer, MatterbridgeOnOffServer, MatterbridgeLevelControlServer, MatterbridgeColorControlServer, MatterbridgeWindowCoveringServer, MatterbridgeThermostatServer, MatterbridgeFanControlServer, MatterbridgeDoorLockServer, MatterbridgeModeSelectServer, MatterbridgeValveConfigurationAndControlServer, MatterbridgeSmokeCoAlarmServer, MatterbridgeBooleanStateConfigurationServer, MatterbridgeOperationalStateServer, } from './matterbridgeBehaviors.js';
+import { MatterbridgeIdentifyServer, MatterbridgeOnOffServer, MatterbridgeLevelControlServer, MatterbridgeColorControlServer, MatterbridgeLiftWindowCoveringServer, MatterbridgeThermostatServer, MatterbridgeFanControlServer, MatterbridgeDoorLockServer, MatterbridgeModeSelectServer, MatterbridgeValveConfigurationAndControlServer, MatterbridgeSmokeCoAlarmServer, MatterbridgeBooleanStateConfigurationServer, MatterbridgeOperationalStateServer, } from './matterbridgeBehaviors.js';
 export function capitalizeFirstLetter(name) {
     if (!name)
         return name;
@@ -141,7 +141,7 @@ export function getBehaviourTypeFromClusterServerId(clusterId) {
     if (clusterId === ColorControl.Cluster.id)
         return MatterbridgeColorControlServer;
     if (clusterId === WindowCovering.Cluster.id)
-        return MatterbridgeWindowCoveringServer.with('Lift', 'PositionAwareLift');
+        return MatterbridgeLiftWindowCoveringServer.with('Lift', 'PositionAwareLift');
     if (clusterId === Thermostat.Cluster.id)
         return MatterbridgeThermostatServer.with('AutoMode', 'Heating', 'Cooling');
     if (clusterId === FanControl.Cluster.id)
@@ -383,59 +383,8 @@ export function getClusterId(endpoint, cluster) {
     return endpoint.behaviors.supported[lowercaseFirstLetter(cluster)]?.schema?.id;
 }
 export function getAttributeId(endpoint, cluster, attribute) {
-    if (attribute === 'attributeList')
-        return 0xfffb;
-    else if (attribute === 'featureMap')
-        return 0xfffc;
-    else if (attribute === 'eventList')
-        return 0xfffa;
-    else if (attribute === 'generatedCommandList')
-        return 0xfff8;
-    else if (attribute === 'acceptedCommandList')
-        return 0xfff9;
-    else if (attribute === 'clusterRevision')
-        return 0xfffd;
-    else {
-        if (endpoint.behaviors.supported[lowercaseFirstLetter(cluster)]?.schema?.type === 'ConcentrationMeasurement') {
-            if (attribute === 'measuredValue')
-                return 0x0;
-            else if (attribute === 'minMeasuredValue')
-                return 0x1;
-            else if (attribute === 'maxMeasuredValue')
-                return 0x2;
-            else if (attribute === 'peakMeasuredValue')
-                return 0x3;
-            else if (attribute === 'peakMeasuredValueWindow')
-                return 0x4;
-            else if (attribute === 'averageMeasuredValue')
-                return 0x5;
-            else if (attribute === 'averageMeasuredValueWindow')
-                return 0x6;
-            else if (attribute === 'uncertainty')
-                return 0x7;
-            else if (attribute === 'measurementUnit')
-                return 0x8;
-            else if (attribute === 'measurementMedium')
-                return 0x9;
-            else if (attribute === 'levelValue')
-                return 0xa;
-        }
-        if (endpoint.behaviors.supported[lowercaseFirstLetter(cluster)]?.schema?.type === 'OperationalState') {
-            if (attribute === 'phaseList')
-                return 0x0;
-            else if (attribute === 'currentPhase')
-                return 0x1;
-            else if (attribute === 'countdownTime')
-                return 0x2;
-            else if (attribute === 'operationalStateList')
-                return 0x3;
-            else if (attribute === 'operationalState')
-                return 0x4;
-            else if (attribute === 'operationalError')
-                return 0x5;
-        }
-        return endpoint.behaviors.supported[lowercaseFirstLetter(cluster)]?.schema?.children?.find((child) => child.name === capitalizeFirstLetter(attribute))?.id;
-    }
+    const clusterBehavior = endpoint.behaviors.supported[lowercaseFirstLetter(cluster)];
+    return clusterBehavior?.cluster.attributes[lowercaseFirstLetter(attribute)]?.id;
 }
 export function getAttribute(endpoint, cluster, attribute, log) {
     const clusterName = getBehavior(endpoint, cluster)?.id;
@@ -534,6 +483,25 @@ export async function subscribeAttribute(endpoint, cluster, attribute, listener,
     log?.info(`${db}Subscribed endpoint ${or}${endpoint.id}${db}:${or}${endpoint.number}${db} attribute ${hk}${capitalizeFirstLetter(clusterName)}${db}.${hk}${attribute}${db}`);
     return true;
 }
+export async function triggerEvent(endpoint, cluster, event, payload, log) {
+    const clusterName = getBehavior(endpoint, cluster)?.id;
+    if (!clusterName) {
+        endpoint.log.error(`triggerEvent ${hk}${event}${er} error: cluster not found on endpoint ${or}${endpoint.maybeId}${er}:${or}${endpoint.maybeNumber}${er}`);
+        return false;
+    }
+    if (endpoint.construction.status !== Lifecycle.Status.Active) {
+        endpoint.log.error(`triggerEvent ${hk}${clusterName}.${event}${er} error: Endpoint ${or}${endpoint.maybeId}${er}:${or}${endpoint.maybeNumber}${er} is in the ${BLUE}${endpoint.construction.status}${er} state`);
+        return false;
+    }
+    const events = endpoint.events;
+    if (!(clusterName in events) || !(event in events[clusterName])) {
+        endpoint.log.error(`triggerEvent ${hk}${event}${er} error: cluster ${clusterName} not found on endpoint ${or}${endpoint.id}${er}:${or}${endpoint.number}${er}`);
+        return false;
+    }
+    await endpoint.act((agent) => agent[clusterName].events[event].emit(payload, agent.context));
+    log?.info(`${db}Trigger event ${hk}${capitalizeFirstLetter(clusterName)}${db}.${hk}${event}${db} with ${debugStringify(payload)}${db} on endpoint ${or}${endpoint.id}${db}:${or}${endpoint.number}${db} `);
+    return true;
+}
 export function getDefaultOperationalStateClusterServer(operationalState = OperationalState.OperationalStateEnum.Stopped) {
     return optionsFor(MatterbridgeOperationalStateServer, {
         phaseList: [],

package/npm-shrinkwrap.json

@@ -1,19 +1,19 @@
 {
   "name": "matterbridge",
-  "version": "3.0.3-dev-20250521-42f79f6",
+  "version": "3.0.4-dev-20250525-c88cf84",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge",
-      "version": "3.0.3-dev-20250521-42f79f6",
+      "version": "3.0.4-dev-20250525-c88cf84",
       "license": "Apache-2.0",
       "dependencies": {
         "@matter/main": "0.13.0",
         "archiver": "7.0.1",
         "express": "5.1.0",
         "glob": "11.0.2",
-        "multer": "1.4.5-lts.2",
+        "multer": "2.0.0",
         "node-ansi-logger": "3.0.1",
         "node-persist-manager": "1.0.8",
         "ws": "8.18.2"
@@ -1124,9 +1124,9 @@
       "license": "ISC"
     },
     "node_modules/jackspeak": {
-      "version": "4.1.0",
-      "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-4.1.0.tgz",
-      "integrity": "sha512-9DDdhb5j6cpeitCbvLO7n7J4IxnbM6hoF6O1g4HQ5TfhvvKN8ywDM7668ZhMHRqVmxqhps/F6syWK2KcPxYlkw==",
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-4.1.1.tgz",
+      "integrity": "sha512-zptv57P3GpL+O0I7VdMJNBZCu+BPHVQUk55Ft8/QCJjTVxrnJHuVuX/0Bl2A6/+2oyR/ZMEuFKwmzqqZ/U5nPQ==",
       "license": "BlueOak-1.0.0",
       "dependencies": {
         "@isaacs/cliui": "^8.0.2"
@@ -1280,9 +1280,9 @@
       "license": "MIT"
     },
     "node_modules/multer": {
-      "version": "1.4.5-lts.2",
-      "resolved": "https://registry.npmjs.org/multer/-/multer-1.4.5-lts.2.tgz",
-      "integrity": "sha512-VzGiVigcG9zUAoCNU+xShztrlr1auZOlurXynNvO9GiWD1/mTBbUljOKY+qMeazBqXgRnjzeEgJI/wyjJUHg9A==",
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/multer/-/multer-2.0.0.tgz",
+      "integrity": "sha512-bS8rPZurbAuHGAnApbM9d4h1wSoYqrOqkE+6a64KLMK9yWU7gJXBDDVklKQ3TPi9DRb85cRs6yXaC0+cjxRtRg==",
       "license": "MIT",
       "dependencies": {
         "append-field": "^1.0.0",
@@ -1294,7 +1294,7 @@
         "xtend": "^4.0.0"
       },
       "engines": {
-        "node": ">= 6.0.0"
+        "node": ">= 10.16.0"
       }
     },
     "node_modules/multer/node_modules/media-typer": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge",
-  "version": "3.0.3-dev-20250521-42f79f6",
+  "version": "3.0.4-dev-20250525-c88cf84",
   "description": "Matterbridge plugin manager for Matter",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",
@@ -98,7 +98,7 @@
     "archiver": "7.0.1",
     "express": "5.1.0",
     "glob": "11.0.2",
-    "multer": "1.4.5-lts.2",
+    "multer": "2.0.0",
     "node-ansi-logger": "3.0.1",
     "node-persist-manager": "1.0.8",
     "ws": "8.18.2"