matterbridge 1.6.1 → 1.6.3-dev.1

package/dist/matterbridgeDevice.js

@@ -20,179 +20,19 @@
  * See the License for the specific language governing permissions and
  * limitations under the License. *
  */
-import { ActionsCluster, AirQuality, AirQualityCluster, BasicInformationCluster, BooleanState, BooleanStateCluster, BooleanStateConfiguration, BooleanStateConfigurationCluster, BridgedDeviceBasicInformation, BridgedDeviceBasicInformationCluster, CarbonDioxideConcentrationMeasurement, CarbonDioxideConcentrationMeasurementCluster, CarbonMonoxideConcentrationMeasurement, CarbonMonoxideConcentrationMeasurementCluster, ClusterServer, ColorControl, ColorControlCluster, ConcentrationMeasurement, DeviceEnergyManagement, DeviceEnergyManagementCluster, DeviceEnergyManagementMode, DeviceEnergyManagementModeCluster, DoorLock, DoorLockCluster, ElectricalEnergyMeasurement, ElectricalEnergyMeasurementCluster, ElectricalPowerMeasurement, ElectricalPowerMeasurementCluster, FanControl, FanControlCluster, FixedLabelCluster, FlowMeasurement, FlowMeasurementCluster, FormaldehydeConcentrationMeasurement, FormaldehydeConcentrationMeasurementCluster, Groups, GroupsCluster, GroupsClusterHandler, Identify, IdentifyCluster, IlluminanceMeasurement, IlluminanceMeasurementCluster, LevelControl, LevelControlCluster, MeasurementType, ModeSelectCluster, NitrogenDioxideConcentrationMeasurement, NitrogenDioxideConcentrationMeasurementCluster, OccupancySensing, OccupancySensingCluster, OnOff, OnOffCluster, OzoneConcentrationMeasurement, OzoneConcentrationMeasurementCluster, Pm10ConcentrationMeasurement, Pm10ConcentrationMeasurementCluster, Pm1ConcentrationMeasurement, Pm1ConcentrationMeasurementCluster, Pm25ConcentrationMeasurement, Pm25ConcentrationMeasurementCluster, PowerSource, PowerSourceCluster, PowerSourceConfigurationCluster, PowerTopology, PowerTopologyCluster, PressureMeasurement, PressureMeasurementCluster, RadonConcentrationMeasurement, RadonConcentrationMeasurementCluster, RelativeHumidityMeasurement, RelativeHumidityMeasurementCluster, SmokeCoAlarm, SmokeCoAlarmCluster, Switch, SwitchCluster, TemperatureMeasurement, TemperatureMeasurementCluster, Thermostat, ThermostatCluster, ThreadNetworkDiagnostics, ThreadNetworkDiagnosticsCluster, TimeSynchronization, TimeSynchronizationCluster, TotalVolatileOrganicCompoundsConcentrationMeasurement, TotalVolatileOrganicCompoundsConcentrationMeasurementCluster, WindowCovering, WindowCoveringCluster, getClusterNameById, } from '@project-chip/matter-node.js/cluster';
-import { Specification } from '@project-chip/matter-node.js/model';
-import { EndpointNumber, VendorId } from '@project-chip/matter-node.js/datatype';
-import { Device, DeviceClasses, DeviceTypeDefinition, Endpoint } from '@project-chip/matter-node.js/device';
-import { extendPublicHandlerMethods } from '@project-chip/matter-node.js/util';
-import { AnsiLogger, CYAN, YELLOW, db, debugStringify, hk, or, zb } from 'node-ansi-logger';
+// @matter
+import { AirQuality, AirQualityCluster, BasicInformationCluster, BooleanState, BooleanStateCluster, BooleanStateConfiguration, BooleanStateConfigurationCluster, BridgedDeviceBasicInformationCluster, CarbonDioxideConcentrationMeasurement, CarbonDioxideConcentrationMeasurementCluster, CarbonMonoxideConcentrationMeasurement, CarbonMonoxideConcentrationMeasurementCluster, ColorControl, ColorControlCluster, ConcentrationMeasurement, Descriptor, DescriptorCluster, DeviceEnergyManagement, DeviceEnergyManagementCluster, DeviceEnergyManagementMode, DeviceEnergyManagementModeCluster, DoorLock, DoorLockCluster, ElectricalEnergyMeasurement, ElectricalEnergyMeasurementCluster, ElectricalPowerMeasurement, ElectricalPowerMeasurementCluster, FanControl, FanControlCluster, FlowMeasurement, FlowMeasurementCluster, FormaldehydeConcentrationMeasurement, FormaldehydeConcentrationMeasurementCluster, Groups, GroupsCluster, Identify, IdentifyCluster, IlluminanceMeasurement, IlluminanceMeasurementCluster, LevelControl, LevelControlCluster, ModeSelectCluster, NitrogenDioxideConcentrationMeasurement, NitrogenDioxideConcentrationMeasurementCluster, OccupancySensing, OccupancySensingCluster, OnOff, OnOffCluster, OzoneConcentrationMeasurement, OzoneConcentrationMeasurementCluster, Pm10ConcentrationMeasurement, Pm10ConcentrationMeasurementCluster, Pm1ConcentrationMeasurement, Pm1ConcentrationMeasurementCluster, Pm25ConcentrationMeasurement, Pm25ConcentrationMeasurementCluster, PowerSource, PowerSourceCluster, PowerSourceConfigurationCluster, PowerTopology, PowerTopologyCluster, PressureMeasurement, PressureMeasurementCluster, RadonConcentrationMeasurement, RadonConcentrationMeasurementCluster, RelativeHumidityMeasurement, RelativeHumidityMeasurementCluster, SmokeCoAlarm, SmokeCoAlarmCluster, Switch, SwitchCluster, TemperatureMeasurement, TemperatureMeasurementCluster, Thermostat, ThermostatCluster, ThreadNetworkDiagnostics, ThreadNetworkDiagnosticsCluster, TimeSynchronization, TimeSynchronizationCluster, TotalVolatileOrganicCompoundsConcentrationMeasurement, TotalVolatileOrganicCompoundsConcentrationMeasurementCluster, WindowCovering, WindowCoveringCluster, } from '@matter/main/clusters';
+import { Specification } from '@matter/main/model';
+import { EndpointNumber, extendPublicHandlerMethods, VendorId } from '@matter/main';
+import { MeasurementType, getClusterNameById } from '@matter/main/types';
+// @project-chip
+import { Device, Endpoint } from '@project-chip/matter.js/device';
+import { GroupsClusterHandler, ClusterServer } from '@project-chip/matter.js/cluster';
+// AnsiLogger module
+import { AnsiLogger, CYAN, YELLOW, db, hk, or, zb, debugStringify } from 'node-ansi-logger';
+// Node.js modules
 import { createHash } from 'crypto';
-// Matter 1.2 and 1.3 device types
-export const airQualitySensor = DeviceTypeDefinition({
-    name: 'MA-airQualitySensor',
-    code: 0x002c,
-    deviceClass: DeviceClasses.Simple,
-    revision: 1,
-    requiredServerClusters: [Identify.Cluster.id, AirQuality.Cluster.id],
-    optionalServerClusters: [
-        TemperatureMeasurement.Cluster.id,
-        RelativeHumidityMeasurement.Cluster.id,
-        CarbonMonoxideConcentrationMeasurement.Cluster.id,
-        CarbonDioxideConcentrationMeasurement.Cluster.id,
-        NitrogenDioxideConcentrationMeasurement.Cluster.id,
-        OzoneConcentrationMeasurement.Cluster.id,
-        FormaldehydeConcentrationMeasurement.Cluster.id,
-        Pm1ConcentrationMeasurement.Cluster.id,
-        Pm25ConcentrationMeasurement.Cluster.id,
-        Pm10ConcentrationMeasurement.Cluster.id,
-        RadonConcentrationMeasurement.Cluster.id,
-        TotalVolatileOrganicCompoundsConcentrationMeasurement.Cluster.id,
-    ],
-});
-export const waterFreezeDetector = DeviceTypeDefinition({
-    name: 'MA-waterFreezeDetector',
-    code: 0x0041,
-    deviceClass: DeviceClasses.Simple,
-    revision: 1,
-    requiredServerClusters: [Identify.Cluster.id, BooleanState.Cluster.id],
-    optionalServerClusters: [BooleanStateConfiguration.Cluster.id],
-});
-export const waterLeakDetector = DeviceTypeDefinition({
-    name: 'MA-waterLeakDetector',
-    code: 0x0043,
-    deviceClass: DeviceClasses.Simple,
-    revision: 1,
-    requiredServerClusters: [Identify.Cluster.id, BooleanState.Cluster.id],
-    optionalServerClusters: [BooleanStateConfiguration.Cluster.id],
-});
-export const rainSensor = DeviceTypeDefinition({
-    name: 'MA-rainSensor',
-    code: 0x0044,
-    deviceClass: DeviceClasses.Simple,
-    revision: 1,
-    requiredServerClusters: [Identify.Cluster.id, BooleanState.Cluster.id],
-    optionalServerClusters: [BooleanStateConfiguration.Cluster.id],
-});
-export const smokeCoAlarm = DeviceTypeDefinition({
-    name: 'MA-smokeCoAlarm',
-    code: 0x0076,
-    deviceClass: DeviceClasses.Simple,
-    revision: 1,
-    requiredServerClusters: [Identify.Cluster.id, SmokeCoAlarm.Cluster.id],
-    optionalServerClusters: [Groups.Cluster.id, TemperatureMeasurement.Cluster.id, RelativeHumidityMeasurement.Cluster.id, CarbonMonoxideConcentrationMeasurement.Cluster.id],
-});
-export const electricalSensor = DeviceTypeDefinition({
-    name: 'MA-electricalSensor',
-    code: 0x0510,
-    deviceClass: DeviceClasses.Utility,
-    revision: 1,
-    requiredServerClusters: [PowerTopology.Cluster.id],
-    optionalServerClusters: [ElectricalPowerMeasurement.Cluster.id, ElectricalEnergyMeasurement.Cluster.id],
-});
-export const deviceEnergyManagement = DeviceTypeDefinition({
-    name: 'MA-deviceEnergyManagement',
-    code: 0x050d,
-    deviceClass: DeviceClasses.Utility,
-    revision: 1,
-    requiredServerClusters: [DeviceEnergyManagement.Cluster.id, DeviceEnergyManagementMode.Cluster.id],
-    optionalServerClusters: [],
-});
-export const bridge = DeviceTypeDefinition({
-    name: 'MA-aggregator',
-    code: 0x000e,
-    deviceClass: DeviceClasses.Dynamic,
-    revision: 1,
-    optionalServerClusters: [ActionsCluster.id],
-});
-export const powerSource = DeviceTypeDefinition({
-    name: 'MA-powerSource',
-    code: 0x0011,
-    deviceClass: DeviceClasses.Utility,
-    revision: 1,
-    requiredServerClusters: [PowerSource.Cluster.id],
-    optionalServerClusters: [],
-});
-export const bridgedNode = DeviceTypeDefinition({
-    name: 'MA-bridgedNode',
-    code: 0x0013,
-    deviceClass: DeviceClasses.Utility,
-    revision: 2,
-    requiredServerClusters: [BridgedDeviceBasicInformation.Cluster.id],
-    optionalServerClusters: [PowerSource.Cluster.id],
-});
-export const genericSwitch = DeviceTypeDefinition({
-    name: 'MA-genericswitch',
-    code: 0x000f,
-    deviceClass: DeviceClasses.Simple,
-    revision: 1,
-    requiredServerClusters: [IdentifyCluster.id, SwitchCluster.id],
-    optionalServerClusters: [FixedLabelCluster.id],
-});
-export const onOffLight = DeviceTypeDefinition({
-    name: 'MA-onofflight',
-    code: 0x0100,
-    deviceClass: DeviceClasses.Simple,
-    revision: 2,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id],
-    optionalServerClusters: [LevelControl.Cluster.id, ColorControl.Cluster.id],
-});
-export const dimmableLight = DeviceTypeDefinition({
-    name: 'MA-dimmablelight',
-    code: 0x0101,
-    deviceClass: DeviceClasses.Simple,
-    revision: 2,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id, LevelControl.Cluster.id],
-    optionalServerClusters: [ColorControl.Cluster.id],
-});
-export const colorTemperatureLight = DeviceTypeDefinition({
-    name: 'MA-colortemperaturelight',
-    code: 0x010c,
-    deviceClass: DeviceClasses.Simple,
-    revision: 2,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id, LevelControl.Cluster.id, ColorControl.Cluster.id],
-    optionalServerClusters: [],
-});
-export const onOffOutlet = DeviceTypeDefinition({
-    name: 'MA-onoffpluginunit',
-    code: 0x010a,
-    deviceClass: DeviceClasses.Simple,
-    revision: 2,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id],
-    optionalServerClusters: [LevelControl.Cluster.id],
-});
-export const dimmableOutlet = DeviceTypeDefinition({
-    name: 'MA-dimmablepluginunit',
-    code: 0x010b,
-    deviceClass: DeviceClasses.Simple,
-    revision: 2,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id, LevelControl.Cluster.id],
-    optionalServerClusters: [],
-});
-// Custom device types: switch without ClientClusters
-export const onOffSwitch = DeviceTypeDefinition({
-    name: 'MA-onoffswitch',
-    code: 0x0103,
-    deviceClass: DeviceClasses.Simple,
-    revision: 2,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id],
-    optionalServerClusters: [LevelControl.Cluster.id, ColorControl.Cluster.id],
-});
-export const dimmableSwitch = DeviceTypeDefinition({
-    name: 'MA-dimmableswitch',
-    code: 0x0104,
-    deviceClass: DeviceClasses.Simple,
-    revision: 2,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id, LevelControl.Cluster.id],
-    optionalServerClusters: [ColorControl.Cluster.id],
-});
-export const colorTemperatureSwitch = DeviceTypeDefinition({
-    name: 'MA-colortemperatureswitch',
-    code: 0x0105,
-    deviceClass: DeviceClasses.Simple,
-    revision: 2,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id, LevelControl.Cluster.id, ColorControl.Cluster.id],
-    optionalServerClusters: [],
-});
+import { bridgedNode } from './matterbridgeDeviceTypes.js';
 export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     static bridgeMode = '';
     static logLevel = "info" /* LogLevel.INFO */;
@@ -201,6 +41,14 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     serialNumber = undefined;
     deviceName = undefined;
     uniqueId = undefined;
+    vendorId = undefined;
+    vendorName = undefined;
+    productId = undefined;
+    productName = undefined;
+    softwareVersion = undefined;
+    softwareVersionString = undefined;
+    hardwareVersion = undefined;
+    hardwareVersionString = undefined;
     /**
      * Create a Matterbridge device.
      * @constructor
@@ -282,14 +130,23 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
      *
      * @param {string} endpointName - The name of the new enpoint to add.
      * @param {AtLeastOne<DeviceTypeDefinition>} deviceTypes - The device types to add.
-     * @param {ClusterId[]} includeServerList - The list of cluster IDs to include.
+     * @param {ClusterId[]} [includeServerList=[]] - The list of cluster IDs to include.
+     * @param {EndpointOptions} [options={}] - The options for the device.
+     * @param {boolean} [debug=false] - Whether to enable debug logging.
      * @returns {Endpoint} - The child endpoint that was found or added.
      */
-    addChildDeviceTypeWithClusterServer(endpointName, deviceTypes, includeServerList = []) {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    addChildDeviceTypeWithClusterServer(endpointName, deviceTypes, includeServerList = [], options = {}, debug = false) {
         this.log.debug(`addChildDeviceTypeWithClusterServer: ${CYAN}${endpointName}${db}`);
         let child = this.getChildEndpoints().find((endpoint) => endpoint.uniqueStorageKey === endpointName);
         if (!child) {
             child = new Endpoint(deviceTypes, { uniqueStorageKey: endpointName });
+            if ('tagList' in options) {
+                for (const tag of options.tagList) {
+                    this.log.debug(`- with tagList: mfgCode ${CYAN}${tag.mfgCode}${db} namespaceId ${CYAN}${tag.namespaceId}${db} tag ${CYAN}${tag.tag}${db} label ${CYAN}${tag.label}${db}`);
+                    this.addTagList(child, tag.mfgCode, tag.namespaceId, tag.tag, tag.label);
+                }
+            }
             this.addChildEndpoint(child);
         }
         deviceTypes.forEach((deviceType) => {
@@ -464,19 +321,18 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             endpoint = this;
         const clusterServer = endpoint.getClusterServerById(clusterId);
         if (!clusterServer) {
-            log?.error(`getAttribute error: Cluster ${clusterId} not found on endpoint ${endpoint.name}:${endpoint.number}`);
+            this.log.error(`getAttribute error: Cluster ${clusterId} not found on endpoint ${endpoint.name}:${endpoint.number}`);
             return undefined;
         }
         const capitalizedAttributeName = attribute.charAt(0).toUpperCase() + attribute.slice(1);
         if (!clusterServer.isAttributeSupportedByName(attribute) && !clusterServer.isAttributeSupportedByName(capitalizedAttributeName)) {
-            if (log)
-                log.error(`getAttribute error: Attribute ${attribute} not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
+            this.log.error(`getAttribute error: Attribute ${attribute} not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
             return undefined;
         }
         // Find the getter method
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         if (!clusterServer[`get${capitalizedAttributeName}Attribute`]) {
-            log?.error(`getAttribute error: Getter get${capitalizedAttributeName}Attribute not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
+            this.log.error(`getAttribute error: Getter get${capitalizedAttributeName}Attribute not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
             return undefined;
         }
         // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-empty-object-type
@@ -500,19 +356,18 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             endpoint = this;
         const clusterServer = endpoint.getClusterServerById(clusterId);
         if (!clusterServer) {
-            log?.error(`setAttribute error: Cluster ${clusterId} not found on endpoint ${endpoint.name}:${endpoint.number}`);
+            this.log.error(`setAttribute error: Cluster ${clusterId} not found on endpoint ${endpoint.name}:${endpoint.number}`);
             return false;
         }
         const capitalizedAttributeName = attribute.charAt(0).toUpperCase() + attribute.slice(1);
         if (!clusterServer.isAttributeSupportedByName(attribute) && !clusterServer.isAttributeSupportedByName(capitalizedAttributeName)) {
-            if (log)
-                log.error(`setAttribute error: Attribute ${attribute} not found on Cluster ${clusterId} on endpoint ${endpoint.name}:${endpoint.number}`);
+            this.log.error(`setAttribute error: Attribute ${attribute} not found on Cluster ${clusterId} on endpoint ${endpoint.name}:${endpoint.number}`);
             return false;
         }
         // Find the getter method
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         if (!clusterServer[`get${capitalizedAttributeName}Attribute`]) {
-            log?.error(`setAttribute error: Getter get${capitalizedAttributeName}Attribute not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
+            this.log.error(`setAttribute error: Getter get${capitalizedAttributeName}Attribute not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
             return false;
         }
         // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-empty-object-type
@@ -520,7 +375,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         // Find the setter method
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         if (!clusterServer[`set${capitalizedAttributeName}Attribute`]) {
-            log?.error(`setAttribute error: Setter set${capitalizedAttributeName}Attribute not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
+            this.log.error(`setAttribute error: Setter set${capitalizedAttributeName}Attribute not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
             return false;
         }
         // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-empty-object-type
@@ -548,19 +403,18 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             endpoint = this;
         const clusterServer = endpoint.getClusterServerById(clusterId);
         if (!clusterServer) {
-            log?.error(`subscribeAttribute error: Cluster ${clusterId} not found on endpoint ${endpoint.name}:${endpoint.number}`);
+            this.log.error(`subscribeAttribute error: Cluster ${clusterId} not found on endpoint ${endpoint.name}:${endpoint.number}`);
             return false;
         }
         const capitalizedAttributeName = attribute.charAt(0).toUpperCase() + attribute.slice(1);
         if (!clusterServer.isAttributeSupportedByName(attribute) && !clusterServer.isAttributeSupportedByName(capitalizedAttributeName)) {
-            if (log)
-                log.error(`subscribeAttribute error: Attribute ${attribute} not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
+            this.log.error(`subscribeAttribute error: Attribute ${attribute} not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
             return false;
         }
         // Find the subscribe method
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         if (!clusterServer[`subscribe${capitalizedAttributeName}Attribute`]) {
-            log?.error(`subscribeAttribute error: subscribe${capitalizedAttributeName}Attribute not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
+            this.log.error(`subscribeAttribute error: subscribe${capitalizedAttributeName}Attribute not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
             return false;
         }
         // Subscribe to the attribute
@@ -570,6 +424,82 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         log?.info(`${db}Subscribe endpoint ${or}${endpoint.name}:${endpoint.number}${db} attribute ${hk}${clusterServer.name}.${capitalizedAttributeName}${db}`);
         return true;
     }
+    /**
+     * Triggers the specified event of the specified cluster from the given endpoint and cluster.
+     *
+     * @param {ClusterId} clusterId - The ID of the cluster to retrieve the event from.
+     * @param {string} event - The name of the event to trigger.
+     * @param {Record<string, any>} payload - The payload of the event to trigger.
+     * @param {AnsiLogger} [log] - Optional logger for error and info messages.
+     * @param {Endpoint} [endpoint] - Optional the child endpoint to retrieve the event from.
+     */
+    triggerEvent(clusterId, event, payload, log, endpoint) {
+        if (!endpoint)
+            endpoint = this;
+        if (!endpoint.number)
+            return;
+        const clusterServer = endpoint.getClusterServerById(clusterId);
+        if (!clusterServer) {
+            this.log.error(`triggerEvent error: Cluster ${clusterId} not found on endpoint ${endpoint.name}:${endpoint.number}`);
+            return;
+        }
+        const capitalizedEventName = event.charAt(0).toUpperCase() + event.slice(1);
+        if (!clusterServer.isEventSupportedByName(event) && !clusterServer.isEventSupportedByName(capitalizedEventName)) {
+            this.log.error(`triggerEvent error: Event ${event} not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
+            return;
+        }
+        // Find the getter method
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        if (!clusterServer[`trigger${capitalizedEventName}Event`]) {
+            this.log.error(`triggerEvent error: Trigger trigger${capitalizedEventName}Event not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
+            return;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-empty-object-type
+        const trigger = clusterServer[`trigger${capitalizedEventName}Event`];
+        trigger(payload);
+        log?.info(`${db}Trigger event ${hk}${clusterServer.name}.${capitalizedEventName}${db} on endpoint ${or}${endpoint.name}:${endpoint.number}${db}`);
+    }
+    /**
+     * Adds a tag to the tag list of the specified endpoint.
+     *
+     * @param {Endpoint} endpoint - The endpoint to add the tag to.
+     * @param {VendorId | null} mfgCode - The manufacturer code.
+     * @param {number} namespaceId - The namespace ID of the tag.
+     * @param {number} tag - The tag number.
+     * @param {string | null} [label=null] - The label for the tag.
+     *
+     * @remarks
+     * This method is used to add a tag to the tag list of a given endpoint.
+     * If the tag list already exists, the new tag is added to the existing list. Otherwise, a new tag list is created with the provided tag.
+     *
+     * Example usage:
+     * ```typescript
+     * this.addTagList(endpoint, null, NumberTag.One.namespaceId, NumberTag.One.tag, 'Label');
+     * this.addTagList(endpoint, null, SwitchesTag.Custom.namespaceId, SwitchesTag.Custom.tag, 'Label');
+     * ```
+     */
+    addTagList(endpoint, mfgCode, namespaceId, tag, label) {
+        const descriptor = endpoint.getClusterServer(DescriptorCluster.with(Descriptor.Feature.TagList));
+        if (!descriptor) {
+            this.log.error(`addTagList: descriptor cluster not found on endpoint ${endpoint.name}:${endpoint.number}`);
+            return;
+        }
+        // tagList: { mfgCode: VendorId | null; namespaceId: number; tag: number; label?: string | null }[] = [];
+        if (descriptor.attributes.tagList) {
+            this.log.debug(`addTagList: adding ${CYAN}tagList${db} mfCode: ${mfgCode}, namespaceId: ${namespaceId}, tag: ${tag}, label: ${label} on endpoint ${endpoint.name}:${endpoint.number}`);
+            const tagList = descriptor.attributes.tagList.getLocal();
+            tagList.push({ mfgCode, namespaceId, tag, label });
+            return;
+        }
+        this.log.debug(`addTagList: creating ${CYAN}tagList${db} mfCode: ${mfgCode}, namespaceId: ${namespaceId}, tag: ${tag}, label: ${label} on endpoint ${endpoint.name}:${endpoint.number}`);
+        endpoint.addClusterServer(ClusterServer(DescriptorCluster.with(Descriptor.Feature.TagList), {
+            tagList: [{ mfgCode, namespaceId, tag, label }],
+            deviceTypeList: [...descriptor.attributes.deviceTypeList.getLocal()],
+            serverList: [...descriptor.attributes.serverList.getLocal()],
+            clientList: [...descriptor.attributes.clientList.getLocal()],
+            partsList: [...descriptor.attributes.partsList.getLocal()],
+        }, {}, {}));
+    }
     /**
      * Serializes the Matterbridge device into a serialized object.
      *
@@ -721,6 +651,18 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
      * @param hardwareVersionString - The hardware version string of the device. Default is 'v.1.0.0'.
      */
     getDefaultBasicInformationClusterServer(deviceName, serialNumber, vendorId, vendorName, productId, productName, softwareVersion = 1, softwareVersionString = '1.0.0', hardwareVersion = 1, hardwareVersionString = '1.0.0') {
+        this.log.logName = deviceName;
+        this.deviceName = deviceName;
+        this.serialNumber = serialNumber;
+        this.uniqueId = this.createUniqueId(deviceName, serialNumber, vendorName, productName);
+        this.productId = productId;
+        this.productName = productName;
+        this.vendorId = vendorId;
+        this.vendorName = vendorName;
+        this.softwareVersion = softwareVersion;
+        this.softwareVersionString = softwareVersionString;
+        this.hardwareVersion = hardwareVersion;
+        this.hardwareVersionString = hardwareVersionString;
         return ClusterServer(BasicInformationCluster, {
             dataModelRevision: 1,
             location: 'XX',
@@ -762,10 +704,8 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
      * @param hardwareVersionString - The hardware version string of the device. Default is 'v.1.0.0'.
      */
     createDefaultBasicInformationClusterServer(deviceName, serialNumber, vendorId, vendorName, productId, productName, softwareVersion = 1, softwareVersionString = '1.0.0', hardwareVersion = 1, hardwareVersionString = '1.0.0') {
-        this.deviceName = deviceName;
-        this.serialNumber = serialNumber;
-        this.uniqueId = this.createUniqueId(deviceName, serialNumber, vendorName, productName);
         if (MatterbridgeDevice.bridgeMode === 'bridge') {
+            this.addDeviceType(bridgedNode);
             this.createDefaultBridgedDeviceBasicInformationClusterServer(deviceName, serialNumber, vendorId, vendorName, productName, softwareVersion, softwareVersionString, hardwareVersion, hardwareVersionString);
             return;
         }
@@ -785,6 +725,18 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
      * @param hardwareVersionString - The hardware version string of the device. Default is 'v.1.0.0'.
      */
     getDefaultBridgedDeviceBasicInformationClusterServer(deviceName, serialNumber, vendorId, vendorName, productName, softwareVersion = 1, softwareVersionString = '1.0.0', hardwareVersion = 1, hardwareVersionString = '1.0.0') {
+        this.log.logName = deviceName;
+        this.deviceName = deviceName;
+        this.serialNumber = serialNumber;
+        this.uniqueId = this.createUniqueId(deviceName, serialNumber, vendorName, productName);
+        this.productId = undefined;
+        this.productName = productName;
+        this.vendorId = vendorId;
+        this.vendorName = vendorName;
+        this.softwareVersion = softwareVersion;
+        this.softwareVersionString = softwareVersionString;
+        this.hardwareVersion = hardwareVersion;
+        this.hardwareVersionString = hardwareVersionString;
         return ClusterServer(BridgedDeviceBasicInformationCluster, {
             vendorId: vendorId !== undefined ? VendorId(vendorId) : undefined, // 4874
             vendorName: vendorName.slice(0, 32),
@@ -819,9 +771,6 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
      * @param hardwareVersionString - The hardware version string of the device. Default is 'v.1.0.0'.
      */
     createDefaultBridgedDeviceBasicInformationClusterServer(deviceName, serialNumber, vendorId, vendorName, productName, softwareVersion = 1, softwareVersionString = '1.0.0', hardwareVersion = 1, hardwareVersionString = '1.0.0') {
-        this.deviceName = deviceName;
-        this.serialNumber = serialNumber;
-        this.uniqueId = this.createUniqueId(deviceName, serialNumber, vendorName, productName);
         this.addClusterServer(this.getDefaultBridgedDeviceBasicInformationClusterServer(deviceName, serialNumber, vendorId, vendorName, productName, softwareVersion, softwareVersionString, hardwareVersion, hardwareVersionString));
     }
     /**
@@ -866,7 +815,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     getDefaultElectricalPowerMeasurementClusterServer(voltage = null, current = null, power = null, frequency = null) {
         return ClusterServer(ElectricalPowerMeasurementCluster.with(ElectricalPowerMeasurement.Feature.AlternatingCurrent), {
             powerMode: ElectricalPowerMeasurement.PowerMode.Ac,
-            numberOfMeasurementTypes: 3,
+            numberOfMeasurementTypes: 4,
             accuracy: [
                 {
                     measurementType: MeasurementType.Voltage,
@@ -973,12 +922,17 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     /**
      * Get a default level control cluster server.
      *
-     * @param currentLevel - The current level (default: 0).
+     * @param currentLevel - The current level (default: 254).
+     * @param minLevel - The minimum level (default: 0).
+     * @param maxLevel - The maximum level (default: 254).
+     * @param onLevel - The on level (default: null).
      */
-    getDefaultLevelControlClusterServer(currentLevel = 0) {
+    getDefaultLevelControlClusterServer(currentLevel = 254, minLevel = 0, maxLevel = 254, onLevel = null) {
         return ClusterServer(LevelControlCluster.with(LevelControl.Feature.OnOff), {
             currentLevel,
-            onLevel: 0,
+            minLevel,
+            maxLevel,
+            onLevel,
             options: {
                 executeIfOff: false,
                 coupleColorTempToLevel: false,
@@ -1015,10 +969,13 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     /**
      * Creates a default level control cluster server.
      *
-     * @param currentLevel - The current level (default: 0).
+     * @param currentLevel - The current level (default: 254).
+     * @param minLevel - The minimum level (default: 0).
+     * @param maxLevel - The maximum level (default: 254).
+     * @param onLevel - The on level (default: null).
      */
-    createDefaultLevelControlClusterServer(currentLevel = 0) {
-        this.addClusterServer(this.getDefaultLevelControlClusterServer(currentLevel));
+    createDefaultLevelControlClusterServer(currentLevel = 254, minLevel = 0, maxLevel = 254, onLevel = null) {
+        this.addClusterServer(this.getDefaultLevelControlClusterServer(currentLevel, minLevel, maxLevel, onLevel));
     }
     /**
      * Get a default color control cluster server.
@@ -1538,7 +1495,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     /**
      * Get a default flow measurement cluster server.
      *
-     * @param measuredValue - The measured value of the temperature.
+     * @param measuredValue - The measured value of the flow in 10 x m/h.
      */
     getDefaultFlowMeasurementClusterServer(measuredValue = 0) {
         return ClusterServer(FlowMeasurementCluster, {
@@ -1551,7 +1508,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     /**
      * Creates a default flow measurement cluster server.
      *
-     * @param measuredValue - The measured value of the temperature.
+     * @param measuredValue - The measured value of the of the flow in 10 x m/h.
      */
     createDefaultFlowMeasurementClusterServer(measuredValue = 0) {
         this.addClusterServer(this.getDefaultFlowMeasurementClusterServer(measuredValue));
@@ -1559,7 +1516,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     /**
      * Get a default temperature measurement cluster server.
      *
-     * @param measuredValue - The measured value of the temperature.
+     * @param measuredValue - The measured value of the temperature x 100.
      */
     getDefaultTemperatureMeasurementClusterServer(measuredValue = 0) {
         return ClusterServer(TemperatureMeasurementCluster, {
@@ -1572,7 +1529,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     /**
      * Creates a default temperature measurement cluster server.
      *
-     * @param measuredValue - The measured value of the temperature.
+     * @param measuredValue - The measured value of the temperature x 100.
      */
     createDefaultTemperatureMeasurementClusterServer(measuredValue = 0) {
         this.addClusterServer(this.getDefaultTemperatureMeasurementClusterServer(measuredValue));
@@ -1580,7 +1537,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     /**
      * Get a default RelativeHumidityMeasurementCluster server.
      *
-     * @param measuredValue - The measured value of the relative humidity.
+     * @param measuredValue - The measured value of the relative humidity x 100.
      */
     getDefaultRelativeHumidityMeasurementClusterServer(measuredValue = 0) {
         return ClusterServer(RelativeHumidityMeasurementCluster, {
@@ -1593,7 +1550,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     /**
      * Creates a default RelativeHumidityMeasurementCluster server.
      *
-     * @param measuredValue - The measured value of the relative humidity.
+     * @param measuredValue - The measured value of the relative humidity x 100.
      */
     createDefaultRelativeHumidityMeasurementClusterServer(measuredValue = 0) {
         this.addClusterServer(this.getDefaultRelativeHumidityMeasurementClusterServer(measuredValue));
@@ -1814,6 +1771,80 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     createDefaultTvocMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.addClusterServer(this.getDefaultTvocMeasurementClusterServer(measuredValue, measurementUnit, measurementMedium));
     }
+    /**
+     * Get a default heating thermostat cluster server with the specified parameters.
+     * @param {number} [localTemperature] - The local temperature value in degrees Celsius. Defaults to 23°.
+     * @param {number} [occupiedHeatingSetpoint] - The occupied heating setpoint value in degrees Celsius. Defaults to 21°.
+     * @param {number} [minHeatSetpointLimit] - The minimum heat setpoint limit value. Defaults to 0°.
+     * @param {number} [maxHeatSetpointLimit] - The maximum heat setpoint limit value. Defaults to 50°.
+     * @returns {ThermostatClusterServer} A default thermostat cluster server configured with the specified parameters.
+     */
+    getDefaultHeatingThermostatClusterServer(localTemperature = 23, occupiedHeatingSetpoint = 21, minHeatSetpointLimit = 0, maxHeatSetpointLimit = 50) {
+        return ClusterServer(ThermostatCluster.with(Thermostat.Feature.Heating), {
+            localTemperature: localTemperature * 100,
+            systemMode: Thermostat.SystemMode.Heat,
+            controlSequenceOfOperation: Thermostat.ControlSequenceOfOperation.HeatingOnly,
+            // Thermostat.Feature.Heating
+            occupiedHeatingSetpoint: occupiedHeatingSetpoint * 100,
+            minHeatSetpointLimit: minHeatSetpointLimit * 100,
+            maxHeatSetpointLimit: maxHeatSetpointLimit * 100,
+            absMinHeatSetpointLimit: minHeatSetpointLimit * 100,
+            absMaxHeatSetpointLimit: maxHeatSetpointLimit * 100,
+        }, {
+            setpointRaiseLower: async ({ request, attributes }) => {
+                this.log.debug('Matter command: setpointRaiseLower', request);
+                await this.commandHandler.executeHandler('setpointRaiseLower', { request, attributes });
+            },
+        }, {});
+    }
+    /**
+     * Creates and adds a default heating thermostat cluster server to the device.
+     *
+     * @param {number} [localTemperature] - The local temperature value in degrees Celsius. Defaults to 23°.
+     * @param {number} [occupiedHeatingSetpoint] - The occupied heating setpoint value in degrees Celsius. Defaults to 21°.
+     * @param {number} [minHeatSetpointLimit] - The minimum heat setpoint limit value. Defaults to 0°.
+     * @param {number} [maxHeatSetpointLimit] - The maximum heat setpoint limit value. Defaults to 50°.
+     */
+    createDefaultHeatingThermostatClusterServer(localTemperature = 23, occupiedHeatingSetpoint = 25, minHeatSetpointLimit = 0, maxHeatSetpointLimit = 50) {
+        this.addClusterServer(this.getDefaultHeatingThermostatClusterServer(localTemperature, occupiedHeatingSetpoint, minHeatSetpointLimit, maxHeatSetpointLimit));
+    }
+    /**
+     * Get a default cooling thermostat cluster server with the specified parameters.
+     * @param {number} [localTemperature] - The local temperature value in degrees Celsius. Defaults to 23°.
+     * @param {number} [occupiedCoolingSetpoint] - The occupied cooling setpoint value in degrees Celsius. Defaults to 25°.
+     * @param {number} [minCoolSetpointLimit] - The minimum cool setpoint limit value. Defaults to 0°.
+     * @param {number} [maxCoolSetpointLimit] - The maximum cool setpoint limit value. Defaults to 50°.
+     * @returns {ThermostatClusterServer} A default thermostat cluster server configured with the specified parameters.
+     */
+    getDefaultCoolingThermostatClusterServer(localTemperature = 23, occupiedCoolingSetpoint = 25, minCoolSetpointLimit = 0, maxCoolSetpointLimit = 50) {
+        return ClusterServer(ThermostatCluster.with(Thermostat.Feature.Cooling), {
+            localTemperature: localTemperature * 100,
+            systemMode: Thermostat.SystemMode.Cool,
+            controlSequenceOfOperation: Thermostat.ControlSequenceOfOperation.CoolingOnly,
+            // Thermostat.Feature.Cooling
+            occupiedCoolingSetpoint: occupiedCoolingSetpoint * 100,
+            minCoolSetpointLimit: minCoolSetpointLimit * 100,
+            maxCoolSetpointLimit: maxCoolSetpointLimit * 100,
+            absMinCoolSetpointLimit: minCoolSetpointLimit * 100,
+            absMaxCoolSetpointLimit: maxCoolSetpointLimit * 100,
+        }, {
+            setpointRaiseLower: async ({ request, attributes }) => {
+                this.log.debug('Matter command: setpointRaiseLower', request);
+                await this.commandHandler.executeHandler('setpointRaiseLower', { request, attributes });
+            },
+        }, {});
+    }
+    /**
+     * Creates and adds a default cooling thermostat cluster server to the device.
+     *
+     * @param {number} [localTemperature] - The local temperature value in degrees Celsius. Defaults to 23°.
+     * @param {number} [occupiedCoolingSetpoint] - The occupied cooling setpoint value in degrees Celsius. Defaults to 25°.
+     * @param {number} [minCoolSetpointLimit] - The minimum cool setpoint limit value. Defaults to 0°.
+     * @param {number} [maxCoolSetpointLimit] - The maximum cool setpoint limit value. Defaults to 50°.
+     */
+    createDefaultCoolingThermostatClusterServer(localTemperature = 23, occupiedCoolingSetpoint = 25, minCoolSetpointLimit = 0, maxCoolSetpointLimit = 50) {
+        this.addClusterServer(this.getDefaultCoolingThermostatClusterServer(localTemperature, occupiedCoolingSetpoint, minCoolSetpointLimit, maxCoolSetpointLimit));
+    }
     /**
      * Get a default thermostat cluster server with the specified parameters.
      *
@@ -1830,19 +1861,22 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     getDefaultThermostatClusterServer(localTemperature = 23, occupiedHeatingSetpoint = 21, occupiedCoolingSetpoint = 25, minSetpointDeadBand = 1, minHeatSetpointLimit = 0, maxHeatSetpointLimit = 50, minCoolSetpointLimit = 0, maxCoolSetpointLimit = 50) {
         return ClusterServer(ThermostatCluster.with(Thermostat.Feature.Heating, Thermostat.Feature.Cooling, Thermostat.Feature.AutoMode), {
             localTemperature: localTemperature * 100,
+            systemMode: Thermostat.SystemMode.Auto,
+            controlSequenceOfOperation: Thermostat.ControlSequenceOfOperation.CoolingAndHeating,
+            // Thermostat.Feature.Heating
             occupiedHeatingSetpoint: occupiedHeatingSetpoint * 100,
-            occupiedCoolingSetpoint: occupiedCoolingSetpoint * 100,
             minHeatSetpointLimit: minHeatSetpointLimit * 100,
             maxHeatSetpointLimit: maxHeatSetpointLimit * 100,
             absMinHeatSetpointLimit: minHeatSetpointLimit * 100,
             absMaxHeatSetpointLimit: maxHeatSetpointLimit * 100,
+            // Thermostat.Feature.Cooling
+            occupiedCoolingSetpoint: occupiedCoolingSetpoint * 100,
             minCoolSetpointLimit: minCoolSetpointLimit * 100,
             maxCoolSetpointLimit: maxCoolSetpointLimit * 100,
             absMinCoolSetpointLimit: minCoolSetpointLimit * 100,
             absMaxCoolSetpointLimit: maxCoolSetpointLimit * 100,
+            // Thermostat.Feature.AutoMode
             minSetpointDeadBand: minSetpointDeadBand * 100,
-            systemMode: Thermostat.SystemMode.Off,
-            controlSequenceOfOperation: Thermostat.ControlSequenceOfOperation.CoolingAndHeating,
             thermostatRunningMode: Thermostat.ThermostatRunningMode.Off,
         }, {
             setpointRaiseLower: async ({ request, attributes }) => {