matterbridge 1.6.5-dev.3 → 1.6.5

package/dist/matterbridgeDevice.js

@@ -1,15 +1,41 @@
+/**
+ * This file contains the class MatterbridgeDevice.
+ *
+ * @file matterbridgeDevice.ts
+ * @author Luca Liguori
+ * @date 2023-12-29
+ * @version 2.0.0
+ *
+ * Copyright 2023, 2024, 2025 Luca Liguori.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License. *
+ */
+// @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 } 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';
 import { bridgedNode } from './matterbridgeDeviceTypes.js';
 export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     static bridgeMode = '';
-    static logLevel = "info";
+    static logLevel = "info" /* LogLevel.INFO */;
     log;
     plugin = undefined;
     serialNumber = undefined;
@@ -23,6 +49,13 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     softwareVersionString = undefined;
     hardwareVersion = undefined;
     hardwareVersionString = undefined;
+    /**
+     * Create a Matterbridge device.
+     * @constructor
+     * @param {DeviceTypeDefinition | AtLeastOne<DeviceTypeDefinition>} definition - The DeviceTypeDefinition of the device.
+     * @param {EndpointOptions} [options={}] - The options for the device.
+     * @param {boolean} [debug=false] - The debug level for the device.
+     */
     constructor(definition, options = {}, debug = false) {
         let firstDefinition;
         if (Array.isArray(definition))
@@ -30,7 +63,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         else
             firstDefinition = definition;
         super(firstDefinition, options);
-        this.log = new AnsiLogger({ logName: 'MatterbridgeDevice', logTimestampFormat: 4, logLevel: debug === true ? "debug" : MatterbridgeDevice.logLevel });
+        this.log = new AnsiLogger({ logName: 'MatterbridgeDevice', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: debug === true ? "debug" /* LogLevel.DEBUG */ : MatterbridgeDevice.logLevel });
         this.log.debug(`new MatterbridgeDevice with deviceType: ${zb}${firstDefinition.code}${db}-${zb}${firstDefinition.name}${db}`);
         if (Array.isArray(definition)) {
             definition.forEach((deviceType) => {
@@ -40,12 +73,28 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         else
             this.addDeviceType(firstDefinition);
     }
+    /**
+     * Loads asyncronously an instance of the MatterbridgeDevice class.
+     *
+     * @param {DeviceTypeDefinition | AtLeastOne<DeviceTypeDefinition>} definition - The DeviceTypeDefinition of the device.
+     * @param {EndpointOptions} [options={}] - The options for the device.
+     * @param {boolean} [debug=false] - The debug level for the device.
+     * @returns {Promise<MatterbridgeDevice>} A Promise of MatterbridgeDevice instance.
+     */
     static async loadInstance(definition, options = {}, debug = false) {
         return new MatterbridgeDevice(definition, options, debug);
     }
+    // Present in new API but not here
     get maybeNumber() {
         return this.number;
     }
+    /**
+     * Adds a device type to the list of device types of the MatterbridgeDevice endpoint.
+     * If the device type is not already present in the list, it will be added.
+     *
+     * @param {DeviceTypeDefinition} deviceType - The device type to add.
+     * @returns {MatterbridgeDevice} The MatterbridgeDevice instance.
+     */
     addDeviceType(deviceType) {
         const deviceTypes = this.getDeviceTypes();
         if (!deviceTypes.includes(deviceType)) {
@@ -55,6 +104,13 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         }
         return this;
     }
+    /**
+     * Adds one or more device types with the required cluster servers and the specified cluster servers.
+     *
+     * @param {AtLeastOne<DeviceTypeDefinition>} deviceTypes - The device types to add.
+     * @param {ClusterId[]} includeServerList - The list of cluster IDs to include.
+     * @returns {MatterbridgeDevice} The MatterbridgeDevice instance.
+     */
     addDeviceTypeWithClusterServer(deviceTypes, includeServerList = []) {
         this.log.debug('addDeviceTypeWithClusterServer:');
         deviceTypes.forEach((deviceType) => {
@@ -76,6 +132,18 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         this.addClusterServerFromList(this, includeServerList);
         return this;
     }
+    /**
+     * Adds a child endpoint with the specified device types and options.
+     * If the child endpoint is not already present, it will be created and added.
+     * If the child endpoint is already present, the device types will be added to the existing child endpoint.
+     *
+     * @param {string} endpointName - The name of the new endpoint to add.
+     * @param {AtLeastOne<DeviceTypeDefinition>} deviceTypes - The device types to add.
+     * @param {MatterbridgeEndpointOptions} [options={}] - The options for the endpoint.
+     * @param {boolean} [debug=false] - Whether to enable debug logging.
+     * @returns {MatterbridgeDevice} - The child endpoint that was found or added.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     addChildDeviceType(endpointName, deviceTypes, options = {}, debug = false) {
         this.log.debug(`addChildDeviceType: ${CYAN}${endpointName}${db}`);
         let child = this.getChildEndpoints().find((endpoint) => endpoint.uniqueStorageKey === endpointName);
@@ -100,6 +168,19 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         child.setDeviceTypes(childDeviceTypes);
         return child;
     }
+    /**
+     * Adds a child endpoint with one or more device types with the required cluster servers and the specified cluster servers.
+     * If the child endpoint is not already present in the childEndpoints, it will be added.
+     * If the child endpoint is already present in the childEndpoints, the device types and cluster servers will be added to the existing child endpoint.
+     *
+     * @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 {EndpointOptions} [options={}] - The options for the device.
+     * @param {boolean} [debug=false] - Whether to enable debug logging.
+     * @returns {MatterbridgeDevice} - The child endpoint that was found or added.
+     */
+    // 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);
@@ -132,6 +213,12 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         this.addClusterServerFromList(child, includeServerList);
         return child;
     }
+    /**
+     * Adds the required cluster servers (only if they are not present) for the device types of the specified endpoint.
+     *
+     * @param {Endpoint} endpoint - The endpoint to add the required cluster servers to.
+     * @returns {Endpoint} The updated endpoint with the required cluster servers added.
+     */
     addRequiredClusterServers(endpoint) {
         const requiredServerList = [];
         this.log.debug(`addRequiredClusterServer for ${CYAN}${endpoint.name}${db}`);
@@ -148,6 +235,12 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         this.addClusterServerFromList(endpoint, requiredServerList);
         return endpoint;
     }
+    /**
+     * Adds the optional cluster servers (only if they are not present) for the device types of the specified endpoint.
+     *
+     * @param {Endpoint} endpoint - The endpoint to add the required cluster servers to.
+     * @returns {Endpoint} The updated endpoint with the required cluster servers added.
+     */
     addOptionalClusterServers(endpoint) {
         const optionalServerList = [];
         this.log.debug(`addRequiredClusterServer for ${CYAN}${endpoint.name}${db}`);
@@ -164,11 +257,19 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         this.addClusterServerFromList(endpoint, optionalServerList);
         return endpoint;
     }
+    /**
+     * Adds cluster servers to the specified endpoint based on the provided server list.
+     *
+     * @param {Endpoint} endpoint - The endpoint to add cluster servers to.
+     * @param {ClusterId[]} includeServerList - The list of cluster IDs to include.
+     * @returns {Endpoint} The updated endpoint with the cluster servers added.
+     */
     addClusterServerFromList(endpoint, includeServerList) {
         if (includeServerList.includes(Identify.Cluster.id))
             endpoint.addClusterServer(this.getDefaultIdentifyClusterServer());
         if (includeServerList.includes(Groups.Cluster.id))
             endpoint.addClusterServer(this.getDefaultGroupsClusterServer());
+        // if (includeServerList.includes(ScenesManagement.Cluster.id)) endpoint.addClusterServer(this.getDefaultScenesClusterServer());
         if (includeServerList.includes(OnOff.Cluster.id))
             endpoint.addClusterServer(this.getDefaultOnOffClusterServer());
         if (includeServerList.includes(LevelControl.Cluster.id))
@@ -241,9 +342,25 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             endpoint.addClusterServer(this.getDefaultDeviceEnergyManagementModeClusterServer());
         return endpoint;
     }
+    /**
+     * Retrieves a child endpoint by its name.
+     *
+     * @param {string} endpointName - The name of the endpoint to retrieve.
+     * @returns {Endpoint | undefined} The child endpoint with the specified name, or undefined if not found.
+     */
     getChildEndpointByName(endpointName) {
         return this.getChildEndpoints().find((endpoint) => endpoint.uniqueStorageKey === endpointName);
     }
+    /**
+     * Retrieves the value of the specified attribute from the given endpoint and cluster.
+     *
+     * @param {ClusterId} clusterId - The ID of the cluster to retrieve the attribute from.
+     * @param {string} attribute - The name of the attribute to retrieve.
+     * @param {AnsiLogger} [log] - Optional logger for error and info messages.
+     * @param {Endpoint} [endpoint] - Optional the child endpoint to retrieve the attribute from.
+     * @returns {any} The value of the attribute, or undefined if the attribute is not found.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     getAttribute(clusterId, attribute, log, endpoint) {
         if (!endpoint)
             endpoint = this;
@@ -257,15 +374,28 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             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`]) {
             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
         const getter = clusterServer[`get${capitalizedAttributeName}Attribute`];
         const value = getter();
         log?.info(`${db}Get endpoint ${or}${endpoint.name}:${endpoint.number}${db} attribute ${hk}${clusterServer.name}.${capitalizedAttributeName}${db} value ${YELLOW}${typeof value === 'object' ? debugStringify(value) : value}${db}`);
         return value;
     }
+    /**
+     * Sets the value of an attribute on a cluster server endpoint.
+     *
+     * @param {ClusterId} clusterId - The ID of the cluster.
+     * @param {string} attribute - The name of the attribute.
+     * @param {any} value - The value to set for the attribute.
+     * @param {AnsiLogger} [log] - (Optional) The logger to use for logging errors and information.
+     * @param {Endpoint} [endpoint] - (Optional) The endpoint to set the attribute on. If not provided, the attribute will be set on the current endpoint.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     setAttribute(clusterId, attribute, value, log, endpoint) {
         if (!endpoint)
             endpoint = this;
@@ -279,15 +409,21 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             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`]) {
             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
         const getter = clusterServer[`get${capitalizedAttributeName}Attribute`];
+        // Find the setter method
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         if (!clusterServer[`set${capitalizedAttributeName}Attribute`]) {
             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
         const setter = clusterServer[`set${capitalizedAttributeName}Attribute`];
         const oldValue = getter();
         setter(value);
@@ -296,6 +432,17 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             `to ${YELLOW}${typeof value === 'object' ? debugStringify(value) : value}${db}`);
         return true;
     }
+    /**
+     * Subscribes to an attribute on a cluster.
+     *
+     * @param {ClusterId} clusterId - The ID of the cluster.
+     * @param {string} attribute - The name of the attribute to subscribe to.
+     * @param {(newValue: any, oldValue: any) => void} listener - A callback function that will be called when the attribute value changes.
+     * @param {AnsiLogger} log - (Optional) An AnsiLogger instance for logging errors and information.
+     * @param {Endpoint} endpoint - (Optional) The endpoint to subscribe the attribute on. If not provided, the current endpoint will be used.
+     * @returns A boolean indicating whether the subscription was successful.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     subscribeAttribute(clusterId, attribute, listener, log, endpoint) {
         if (!endpoint)
             endpoint = this;
@@ -309,15 +456,28 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             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`]) {
             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
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-empty-object-type
         const subscribe = clusterServer[`subscribe${capitalizedAttributeName}Attribute`];
         subscribe(listener);
         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;
@@ -333,20 +493,43 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             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();
@@ -362,6 +545,12 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             partsList: [...descriptor.attributes.partsList.getLocal()],
         }, {}, {}));
     }
+    /**
+     * Serializes the Matterbridge device into a serialized object.
+     *
+     * @param pluginName - The name of the plugin.
+     * @returns The serialized Matterbridge device object.
+     */
     serialize() {
         if (!this.serialNumber || !this.deviceName || !this.uniqueId)
             return;
@@ -386,6 +575,11 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         });
         return serialized;
     }
+    /**
+     * Deserializes the device into a serialized object.
+     *
+     * @returns The deserialized MatterbridgeDevice.
+     */
     static deserialize(serializedDevice) {
         const device = new MatterbridgeDevice(serializedDevice.deviceTypes);
         device.serialNumber = serializedDevice.serialNumber;
@@ -401,6 +595,9 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         }
         return device;
     }
+    /**
+     * Get a default IdentifyCluster server.
+     */
     getDefaultIdentifyClusterServer(identifyTime = 0, identifyType = Identify.IdentifyType.None) {
         return ClusterServer(IdentifyCluster, {
             identifyTime,
@@ -416,28 +613,88 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             },
         });
     }
+    /**
+     * Creates a default IdentifyCluster server.
+     */
     createDefaultIdentifyClusterServer(identifyTime = 0, identifyType = Identify.IdentifyType.None) {
         this.addClusterServer(this.getDefaultIdentifyClusterServer(identifyTime, identifyType));
     }
+    /**
+     * Get a default IdentifyCluster server.
+     */
     getDefaultGroupsClusterServer() {
         return ClusterServer(GroupsCluster, {
             nameSupport: {
                 nameSupport: true,
             },
         }, GroupsClusterHandler());
+        // return createDefaultGroupsClusterServer();
     }
+    /**
+     * Creates a default groups cluster server and adds it to the device.
+     */
     createDefaultGroupsClusterServer() {
         this.addClusterServer(this.getDefaultGroupsClusterServer());
     }
+    /**
+     * Get a default scenes cluster server and adds it to the current instance.
+     * @deprecated This method is deprecated.
+     *
+     */
     getDefaultScenesClusterServer() {
-    }
+        /*
+        return ClusterServer(
+          ScenesCluster,
+          {
+            sceneCount: 0,
+            currentScene: 0,
+            currentGroup: GroupId(0),
+            sceneValid: false,
+            nameSupport: {
+              nameSupport: true,
+            },
+            lastConfiguredBy: null,
+          },
+          {},
+        );
+        */
+    }
+    /**
+     * Creates a default scenes cluster server and adds it to the current instance.
+     * @deprecated This method is deprecated.
+     */
     createDefaultScenesClusterServer() {
-    }
+        /*
+        this.addClusterServer(this.getDefaultScenesClusterServer());
+        */
+    }
+    /**
+     * Creates a unique identifier based on the provided parameters.
+     * @param param1 - The first parameter.
+     * @param param2 - The second parameter.
+     * @param param3 - The third parameter.
+     * @param param4 - The fourth parameter.
+     * @returns A unique identifier generated using the MD5 hash algorithm.
+     */
     createUniqueId(param1, param2, param3, param4) {
         const hash = createHash('md5');
         hash.update(param1 + param2 + param3 + param4);
         return hash.digest('hex');
     }
+    /**
+     * Get a default Basic Information Cluster Server.
+     *
+     * @param deviceName - The name of the device.
+     * @param serialNumber - The serial number of the device.
+     * @param vendorId - The vendor ID of the device.
+     * @param vendorName - The vendor name of the device.
+     * @param productId - The product ID of the device.
+     * @param productName - The product name of the device.
+     * @param softwareVersion - The software version of the device. Default is 1.
+     * @param softwareVersionString - The software version string of the device. Default is 'v.1.0.0'.
+     * @param hardwareVersion - The hardware version of the device. Default is 1.
+     * @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;
@@ -477,6 +734,20 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             reachableChanged: true,
         });
     }
+    /**
+     * Creates a default Basic Information Cluster Server.
+     *
+     * @param deviceName - The name of the device.
+     * @param serialNumber - The serial number of the device.
+     * @param vendorId - The vendor ID of the device.
+     * @param vendorName - The vendor name of the device.
+     * @param productId - The product ID of the device.
+     * @param productName - The product name of the device.
+     * @param softwareVersion - The software version of the device. Default is 1.
+     * @param softwareVersionString - The software version string of the device. Default is 'v.1.0.0'.
+     * @param hardwareVersion - The hardware version of the device. Default is 1.
+     * @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') {
         if (MatterbridgeDevice.bridgeMode === 'bridge') {
             this.addDeviceType(bridgedNode);
@@ -485,6 +756,19 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         }
         this.addClusterServer(this.getDefaultBasicInformationClusterServer(deviceName, serialNumber, vendorId, vendorName, productId, productName, softwareVersion, softwareVersionString, hardwareVersion, hardwareVersionString));
     }
+    /**
+     * Get a default BridgedDeviceBasicInformationClusterServer.
+     *
+     * @param deviceName - The name of the device.
+     * @param serialNumber - The serial number of the device.
+     * @param vendorId - The vendor ID of the device.
+     * @param vendorName - The name of the vendor.
+     * @param productName - The name of the product.
+     * @param softwareVersion - The software version of the device. Default is 1.
+     * @param softwareVersionString - The software version string of the device. Default is 'v.1.0.0'.
+     * @param hardwareVersion - The hardware version of the device. Default is 1.
+     * @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;
@@ -499,7 +783,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         this.hardwareVersion = hardwareVersion;
         this.hardwareVersionString = hardwareVersionString;
         return ClusterServer(BridgedDeviceBasicInformationCluster, {
-            vendorId: vendorId !== undefined ? VendorId(vendorId) : undefined,
+            vendorId: vendorId !== undefined ? VendorId(vendorId) : undefined, // 4874
             vendorName: vendorName.slice(0, 32),
             productName: productName.slice(0, 32),
             productLabel: deviceName.slice(0, 64),
@@ -518,12 +802,36 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             reachableChanged: true,
         });
     }
+    /**
+     * Creates a default BridgedDeviceBasicInformationClusterServer.
+     *
+     * @param deviceName - The name of the device.
+     * @param serialNumber - The serial number of the device.
+     * @param vendorId - The vendor ID of the device.
+     * @param vendorName - The name of the vendor.
+     * @param productName - The name of the product.
+     * @param softwareVersion - The software version of the device. Default is 1.
+     * @param softwareVersionString - The software version string of the device. Default is 'v.1.0.0'.
+     * @param hardwareVersion - The hardware version of the device. Default is 1.
+     * @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.addClusterServer(this.getDefaultBridgedDeviceBasicInformationClusterServer(deviceName, serialNumber, vendorId, vendorName, productName, softwareVersion, softwareVersionString, hardwareVersion, hardwareVersionString));
     }
+    /**
+     * Get a default Power Topology Cluster Server.
+     *
+     * @returns {ClusterServer} - The configured Power Topology Cluster Server.
+     */
     getDefaultPowerTopologyClusterServer() {
         return ClusterServer(PowerTopologyCluster.with(PowerTopology.Feature.TreeTopology), {}, {}, {});
     }
+    /**
+     * Get a default Electrical Energy Measurement Cluster Server.
+     *
+     * @param {number} energy - The total consumption value in mW/h.
+     * @returns {ClusterServer} - The configured Electrical Energy Measurement Cluster Server.
+     */
     getDefaultElectricalEnergyMeasurementClusterServer(energy = null) {
         return ClusterServer(ElectricalEnergyMeasurementCluster.with(ElectricalEnergyMeasurement.Feature.ImportedEnergy, ElectricalEnergyMeasurement.Feature.ExportedEnergy, ElectricalEnergyMeasurement.Feature.CumulativeEnergy), {
             accuracy: {
@@ -540,6 +848,15 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             cumulativeEnergyMeasured: true,
         });
     }
+    /**
+     * Get a default Electrical Power Measurement Cluster Server.
+     *
+     * @param {number} voltage - The voltage value in millivolts.
+     * @param {number} current - The current value in milliamperes.
+     * @param {number} power - The power value in milliwatts.
+     * @param {number} frequency - The frequency value in millihertz.
+     * @returns {ClusterServer} - The configured Electrical Power Measurement Cluster Server.
+     */
     getDefaultElectricalPowerMeasurementClusterServer(voltage = null, current = null, power = null, frequency = null) {
         return ClusterServer(ElectricalPowerMeasurementCluster.with(ElectricalPowerMeasurement.Feature.AlternatingCurrent), {
             powerMode: ElectricalPowerMeasurement.PowerMode.Ac,
@@ -580,6 +897,15 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             frequency: frequency,
         }, {}, {});
     }
+    /**
+     * Creates a default Dummy Thread Network Diagnostics Cluster server.
+     * @deprecated This method is deprecated and is only used for testing.
+     *
+     * @remarks
+     * This method adds a cluster server used only to give the networkName to Eve app.
+     *
+     * @returns void
+     */
     createDefaultDummyThreadNetworkDiagnosticsClusterServer() {
         this.addClusterServer(ClusterServer(ThreadNetworkDiagnosticsCluster.with(ThreadNetworkDiagnostics.Feature.PacketCounts, ThreadNetworkDiagnostics.Feature.ErrorCounts), {
             channel: 1,
@@ -607,6 +933,11 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             },
         }, {}));
     }
+    /**
+     * Get a default OnOff cluster server.
+     *
+     * @param onOff - The initial state of the OnOff cluster (default: false).
+     */
     getDefaultOnOffClusterServer(onOff = false) {
         return ClusterServer(OnOffCluster, {
             onOff,
@@ -625,9 +956,22 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             },
         }, {});
     }
+    /**
+     * Creates a default OnOff cluster server.
+     *
+     * @param onOff - The initial state of the OnOff cluster (default: false).
+     */
     createDefaultOnOffClusterServer(onOff = false) {
         this.addClusterServer(this.getDefaultOnOffClusterServer(onOff));
     }
+    /**
+     * Get a default level control cluster server.
+     *
+     * @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 = 254, minLevel = 0, maxLevel = 254, onLevel = null) {
         return ClusterServer(LevelControlCluster.with(LevelControl.Feature.OnOff), {
             currentLevel,
@@ -667,9 +1011,28 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             },
         });
     }
+    /**
+     * Creates a default level control cluster server.
+     *
+     * @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 = 254, minLevel = 0, maxLevel = 254, onLevel = null) {
         this.addClusterServer(this.getDefaultLevelControlClusterServer(currentLevel, minLevel, maxLevel, onLevel));
     }
+    /**
+     * Get a default color control cluster server.
+     *
+     * @param currentX - The current X value.
+     * @param currentY - The current Y value.
+     * @param currentHue - The current hue value.
+     * @param currentSaturation - The current saturation value.
+     * @param colorTemperatureMireds - The color temperature in mireds.
+     * @param colorTempPhysicalMinMireds - The physical minimum color temperature in mireds.
+     * @param colorTempPhysicalMaxMireds - The physical maximum color temperature in mireds.
+     */
     getDefaultColorControlClusterServer(currentX = 0, currentY = 0, currentHue = 0, currentSaturation = 0, colorTemperatureMireds = 500, colorTempPhysicalMinMireds = 147, colorTempPhysicalMaxMireds = 500) {
         return ClusterServer(ColorControlCluster.with(ColorControl.Feature.Xy, ColorControl.Feature.HueSaturation, ColorControl.Feature.ColorTemperature), {
             colorMode: ColorControl.ColorMode.CurrentHueAndCurrentSaturation,
@@ -736,9 +1099,26 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             },
         }, {});
     }
+    /**
+     * Creates a default color control cluster server.
+     *
+     * @param currentX - The current X value.
+     * @param currentY - The current Y value.
+     * @param currentHue - The current hue value.
+     * @param currentSaturation - The current saturation value.
+     * @param colorTemperatureMireds - The color temperature in mireds.
+     * @param colorTempPhysicalMinMireds - The physical minimum color temperature in mireds.
+     * @param colorTempPhysicalMaxMireds - The physical maximum color temperature in mireds.
+     */
     createDefaultColorControlClusterServer(currentX = 0, currentY = 0, currentHue = 0, currentSaturation = 0, colorTemperatureMireds = 500, colorTempPhysicalMinMireds = 147, colorTempPhysicalMaxMireds = 500) {
         this.addClusterServer(this.getDefaultColorControlClusterServer(currentX, currentY, currentHue, currentSaturation, colorTemperatureMireds, colorTempPhysicalMinMireds, colorTempPhysicalMaxMireds));
     }
+    /**
+     * Get a Xy color control cluster server.
+     *
+     * @param currentX - The current X value.
+     * @param currentY - The current Y value.
+     */
     getXyColorControlClusterServer(currentX = 0, currentY = 0) {
         return ClusterServer(ColorControlCluster.with(ColorControl.Feature.Xy), {
             colorMode: ColorControl.ColorMode.CurrentXAndCurrentY,
@@ -766,9 +1146,21 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             },
         }, {});
     }
+    /**
+     * Creates a Xy color control cluster server.
+     *
+     * @param currentX - The current X value.
+     * @param currentY - The current Y value.
+     */
     createXyControlClusterServer(currentX = 0, currentY = 0) {
         this.addClusterServer(this.getXyColorControlClusterServer(currentX, currentY));
     }
+    /**
+     * Get a default hue and saturation control cluster server.
+     *
+     * @param currentHue - The current hue value.
+     * @param currentSaturation - The current saturation value.
+     */
     getHsColorControlClusterServer(currentHue = 0, currentSaturation = 0) {
         return ClusterServer(ColorControlCluster.with(ColorControl.Feature.HueSaturation), {
             colorMode: ColorControl.ColorMode.CurrentHueAndCurrentSaturation,
@@ -810,9 +1202,22 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             },
         }, {});
     }
+    /**
+     * Creates a hue and saturation color control cluster server.
+     *
+     * @param currentHue - The current hue value.
+     * @param currentSaturation - The current saturation value.
+     */
     createHsColorControlClusterServer(currentHue = 0, currentSaturation = 0) {
         this.addClusterServer(this.getHsColorControlClusterServer(currentHue, currentSaturation));
     }
+    /**
+     * Get a color temperature color control cluster server.
+     *
+     * @param colorTemperatureMireds - The color temperature in mireds.
+     * @param colorTempPhysicalMinMireds - The physical minimum color temperature in mireds.
+     * @param colorTempPhysicalMaxMireds - The physical maximum color temperature in mireds.
+     */
     getCtColorControlClusterServer(colorTemperatureMireds = 500, colorTempPhysicalMinMireds = 147, colorTempPhysicalMaxMireds = 500) {
         return ClusterServer(ColorControlCluster.with(ColorControl.Feature.ColorTemperature), {
             colorMode: ColorControl.ColorMode.ColorTemperatureMireds,
@@ -841,9 +1246,28 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             },
         }, {});
     }
+    /**
+     * Creates a color temperature color control cluster server.
+     *
+     * @param colorTemperatureMireds - The color temperature in mireds.
+     * @param colorTempPhysicalMinMireds - The physical minimum color temperature in mireds.
+     * @param colorTempPhysicalMaxMireds - The physical maximum color temperature in mireds.
+     */
     createCtColorControlClusterServer(colorTemperatureMireds = 500, colorTempPhysicalMinMireds = 147, colorTempPhysicalMaxMireds = 500) {
         this.addClusterServer(this.getCtColorControlClusterServer(colorTemperatureMireds, colorTempPhysicalMinMireds, colorTempPhysicalMaxMireds));
     }
+    /**
+     * Configures the color control cluster for a device.
+     *
+     * @remark This method must be called only after creating the cluster with getDefaultCompleteColorControlClusterServer or createDefaultCompleteColorControlClusterServer
+     * and before starting the matter server.
+     *
+     * @param {boolean} hueSaturation - A boolean indicating whether the device supports hue and saturation control.
+     * @param {boolean} xy - A boolean indicating whether the device supports XY control.
+     * @param {boolean} colorTemperature - A boolean indicating whether the device supports color temperature control.
+     * @param {ColorControl.ColorMode} colorMode - An optional parameter specifying the color mode of the device.
+     * @param {Endpoint} endpoint - An optional parameter specifying the endpoint to configure. If not provided, the device endpoint will be used.
+     */
     configureColorControlCluster(hueSaturation, xy, colorTemperature, colorMode, endpoint) {
         if (!endpoint)
             endpoint = this;
@@ -854,6 +1278,12 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             endpoint.getClusterServer(ColorControlCluster)?.setEnhancedColorModeAttribute(colorMode);
         }
     }
+    /**
+     * Configures the color control mode for the device.
+     *
+     * @param {ColorControl.ColorMode} colorMode - The color mode to set.
+     * @param {Endpoint} endpoint - The optional endpoint to configure. If not provided, the method will configure the current endpoint.
+     */
     configureColorControlMode(colorMode, endpoint) {
         if (!endpoint)
             endpoint = this;
@@ -862,8 +1292,13 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             endpoint.getClusterServer(ColorControlCluster)?.setEnhancedColorModeAttribute(colorMode);
         }
     }
+    /**
+     * Get a default window covering cluster server.
+     *
+     * @param positionPercent100ths - The position percentage in 100ths (0-10000). Defaults to 0.
+     */
     getDefaultWindowCoveringClusterServer(positionPercent100ths) {
-        return ClusterServer(WindowCoveringCluster.with(WindowCovering.Feature.Lift, WindowCovering.Feature.PositionAwareLift), {
+        return ClusterServer(WindowCoveringCluster.with(WindowCovering.Feature.Lift, WindowCovering.Feature.PositionAwareLift /* , WindowCovering.Feature.AbsolutePosition*/), {
             type: WindowCovering.WindowCoveringType.Rollershade,
             configStatus: {
                 operational: true,
@@ -877,8 +1312,10 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             operationalStatus: { global: WindowCovering.MovementStatus.Stopped, lift: WindowCovering.MovementStatus.Stopped, tilt: WindowCovering.MovementStatus.Stopped },
             endProductType: WindowCovering.EndProductType.RollerShade,
             mode: { motorDirectionReversed: false, calibrationMode: false, maintenanceMode: false, ledFeedback: false },
-            targetPositionLiftPercent100ths: positionPercent100ths ?? 0,
-            currentPositionLiftPercent100ths: positionPercent100ths ?? 0,
+            targetPositionLiftPercent100ths: positionPercent100ths ?? 0, // 0 Fully open 10000 fully closed
+            currentPositionLiftPercent100ths: positionPercent100ths ?? 0, // 0 Fully open 10000 fully closed
+            // installedClosedLimitLift: 10000,
+            // installedOpenLimitLift: 0,
         }, {
             upOrOpen: async (data) => {
                 this.log.debug('Matter command: upOrOpen');
@@ -899,9 +1336,18 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             },
         }, {});
     }
+    /**
+     * Creates a default window covering cluster server.
+     *
+     * @param positionPercent100ths - The position percentage in 100ths (0-10000). Defaults to 0.
+     */
     createDefaultWindowCoveringClusterServer(positionPercent100ths) {
         this.addClusterServer(this.getDefaultWindowCoveringClusterServer(positionPercent100ths));
     }
+    /**
+     * Sets the window covering target position as the current position and stops the movement.
+     * @param {Endpoint} endpoint - The endpoint on which to set the window covering (default the device endpoint).
+     */
     setWindowCoveringTargetAsCurrentAndStopped(endpoint) {
         if (!endpoint)
             endpoint = this;
@@ -919,6 +1365,13 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             this.log.debug(`Set WindowCovering currentPositionLiftPercent100ths and targetPositionLiftPercent100ths to ${position} and operationalStatus to Stopped.`);
         }
     }
+    /**
+     * Sets the current and target status of a window covering.
+     * @param {number} current - The current position of the window covering.
+     * @param {number} target - The target position of the window covering.
+     * @param {WindowCovering.MovementStatus} status - The movement status of the window covering.
+     * @param {Endpoint} endpoint - The endpoint on which to set the window covering (default the device endpoint).
+     */
     setWindowCoveringCurrentTargetStatus(current, target, status, endpoint) {
         if (!endpoint)
             endpoint = this;
@@ -934,6 +1387,11 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         }
         this.log.debug(`Set WindowCovering currentPositionLiftPercent100ths: ${current}, targetPositionLiftPercent100ths: ${target} and operationalStatus: ${status}.`);
     }
+    /**
+     * Sets the status of the window covering.
+     * @param {WindowCovering.MovementStatus} status - The movement status to set.
+     * @param {Endpoint} endpoint - The endpoint on which to set the window covering (default the device endpoint).
+     */
     setWindowCoveringStatus(status, endpoint) {
         if (!endpoint)
             endpoint = this;
@@ -943,6 +1401,12 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         windowCovering.setOperationalStatusAttribute({ global: status, lift: status, tilt: status });
         this.log.debug(`Set WindowCovering operationalStatus: ${status}`);
     }
+    /**
+     * Retrieves the status of the window covering.
+     * @param {Endpoint} endpoint - The endpoint on which to get the window covering (default the device endpoint).
+     *
+     * @returns The global operational status of the window covering.
+     */
     getWindowCoveringStatus(endpoint) {
         if (!endpoint)
             endpoint = this;
@@ -953,6 +1417,12 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         this.log.debug(`Get WindowCovering operationalStatus: ${status.global}`);
         return status.global;
     }
+    /**
+     * Sets the target and current position of the window covering.
+     *
+     * @param position - The position to set, specified as a number.
+     * @param {Endpoint} endpoint - The endpoint on which to set the window covering (default the device endpoint).
+     */
     setWindowCoveringTargetAndCurrentPosition(position, endpoint) {
         if (!endpoint)
             endpoint = this;
@@ -963,6 +1433,13 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         windowCovering.setTargetPositionLiftPercent100thsAttribute(position);
         this.log.debug(`Set WindowCovering currentPositionLiftPercent100ths: ${position} and targetPositionLiftPercent100ths: ${position}.`);
     }
+    /**
+     * Get a default door lock cluster server.
+     *
+     * @remarks
+     * This method adds a cluster server for a door lock cluster with default settings.
+     *
+     */
     getDefaultDoorLockClusterServer(lockState = DoorLock.LockState.Locked, lockType = DoorLock.LockType.DeadBolt) {
         return ClusterServer(DoorLockCluster, {
             operatingMode: DoorLock.OperatingMode.Normal,
@@ -985,9 +1462,22 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             lockOperationError: true,
         });
     }
+    /**
+     * Creates a default door lock cluster server.
+     *
+     * @remarks
+     * This method adds a cluster server for a door lock cluster with default settings.
+     *
+     */
     createDefaultDoorLockClusterServer(lockState = DoorLock.LockState.Locked, lockType = DoorLock.LockType.DeadBolt) {
         this.addClusterServer(this.getDefaultDoorLockClusterServer(lockState, lockType));
     }
+    /**
+     * Get a default momentary switch cluster server.
+     *
+     * @remarks
+     * This method adds a cluster server with default momentary switch features and configurations suitable for (AppleHome) Single Double Long automations.
+     */
     getDefaultSwitchClusterServer() {
         return ClusterServer(SwitchCluster.with(Switch.Feature.MomentarySwitch, Switch.Feature.MomentarySwitchRelease, Switch.Feature.MomentarySwitchLongPress, Switch.Feature.MomentarySwitchMultiPress), {
             numberOfPositions: 2,
@@ -1002,9 +1492,21 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             multiPressComplete: true,
         });
     }
+    /**
+     * Creates a default momentary switch cluster server.
+     *
+     * @remarks
+     * This method adds a cluster server with default momentary switch features and configurations.
+     */
     createDefaultSwitchClusterServer() {
         this.addClusterServer(this.getDefaultSwitchClusterServer());
     }
+    /**
+     * Get a default latching switch cluster server.
+     *
+     * @remarks
+     * This method adds a cluster server with default latching switch features and configuration.
+     */
     getDefaultLatchingSwitchClusterServer() {
         return ClusterServer(SwitchCluster.with(Switch.Feature.LatchingSwitch), {
             numberOfPositions: 2,
@@ -1013,9 +1515,22 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             switchLatched: true,
         });
     }
+    /**
+     * Creates a default latching switch cluster server.
+     *
+     * @remarks
+     * This method adds a cluster server with default latching switch features and configuration.
+     */
     createDefaultLatchingSwitchClusterServer() {
         this.addClusterServer(this.getDefaultLatchingSwitchClusterServer());
     }
+    /**
+     * Triggers a switch event on the specified endpoint.
+     *
+     * @param {string} event - The type of event to trigger. Possible values are 'Single', 'Double', 'Long' for momentarySwitch and 'Press', 'Release' for latchingSwitch.
+     * @param {Endpoint} endpoint - The endpoint on which to trigger the event (default the device endpoint).
+     * @returns {void}
+     */
     triggerSwitchEvent(event, log, endpoint) {
         if (!endpoint)
             endpoint = this;
@@ -1087,6 +1602,15 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         }
         return true;
     }
+    /**
+     * Retrieves the default mode select cluster server.
+     *
+     * @param description - The description of the cluster server.
+     * @param supportedModes - The supported modes for the cluster server.
+     * @param currentMode - The current mode of the cluster server. Defaults to 0.
+     * @param startUpMode - The startup mode of the cluster server. Defaults to 0.
+     * @returns The default mode select cluster server.
+     */
     getDefaultModeSelectClusterServer(description, supportedModes, currentMode = 0, startUpMode = 0) {
         return ClusterServer(ModeSelectCluster, {
             description: description,
@@ -1101,11 +1625,24 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             },
         });
     }
+    /**
+     * Creates a default mode select cluster server.
+     *
+     * @remarks
+     * This method adds a cluster server for a mode select cluster with default settings.
+     *
+     * @param endpoint - The endpoint to add the cluster server to. Defaults to `this` if not provided.
+     */
     createDefaultModeSelectClusterServer(description, supportedModes, currentMode = 0, startUpMode = 0, endpoint) {
         if (!endpoint)
             endpoint = this;
         endpoint.addClusterServer(this.getDefaultModeSelectClusterServer(description, supportedModes, currentMode, startUpMode));
     }
+    /**
+     * Get a default occupancy sensing cluster server.
+     *
+     * @param occupied - A boolean indicating whether the occupancy is occupied or not. Default is false.
+     */
     getDefaultOccupancySensingClusterServer(occupied = false) {
         return ClusterServer(OccupancySensingCluster, {
             occupancy: { occupied },
@@ -1114,9 +1651,19 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             pirOccupiedToUnoccupiedDelay: 30,
         }, {});
     }
+    /**
+     * Creates a default occupancy sensing cluster server.
+     *
+     * @param occupied - A boolean indicating whether the occupancy is occupied or not. Default is false.
+     */
     createDefaultOccupancySensingClusterServer(occupied = false) {
         this.addClusterServer(this.getDefaultOccupancySensingClusterServer(occupied));
     }
+    /**
+     * Get a default Illuminance Measurement Cluster Server.
+     *
+     * @param measuredValue - The measured value of illuminance.
+     */
     getDefaultIlluminanceMeasurementClusterServer(measuredValue = 0) {
         return ClusterServer(IlluminanceMeasurementCluster, {
             measuredValue,
@@ -1125,9 +1672,19 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             tolerance: 0,
         }, {}, {});
     }
+    /**
+     * Creates a default Illuminance Measurement Cluster Server.
+     *
+     * @param measuredValue - The measured value of illuminance.
+     */
     createDefaultIlluminanceMeasurementClusterServer(measuredValue = 0) {
         this.addClusterServer(this.getDefaultIlluminanceMeasurementClusterServer(measuredValue));
     }
+    /**
+     * Get a default flow measurement cluster server.
+     *
+     * @param measuredValue - The measured value of the flow in 10 x m/h.
+     */
     getDefaultFlowMeasurementClusterServer(measuredValue = 0) {
         return ClusterServer(FlowMeasurementCluster, {
             measuredValue,
@@ -1136,9 +1693,19 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             tolerance: 0,
         }, {}, {});
     }
+    /**
+     * Creates a default flow measurement cluster server.
+     *
+     * @param measuredValue - The measured value of the of the flow in 10 x m/h.
+     */
     createDefaultFlowMeasurementClusterServer(measuredValue = 0) {
         this.addClusterServer(this.getDefaultFlowMeasurementClusterServer(measuredValue));
     }
+    /**
+     * Get a default temperature measurement cluster server.
+     *
+     * @param measuredValue - The measured value of the temperature x 100.
+     */
     getDefaultTemperatureMeasurementClusterServer(measuredValue = 0) {
         return ClusterServer(TemperatureMeasurementCluster, {
             measuredValue,
@@ -1147,9 +1714,19 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             tolerance: 0,
         }, {}, {});
     }
+    /**
+     * Creates a default temperature measurement cluster server.
+     *
+     * @param measuredValue - The measured value of the temperature x 100.
+     */
     createDefaultTemperatureMeasurementClusterServer(measuredValue = 0) {
         this.addClusterServer(this.getDefaultTemperatureMeasurementClusterServer(measuredValue));
     }
+    /**
+     * Get a default RelativeHumidityMeasurementCluster server.
+     *
+     * @param measuredValue - The measured value of the relative humidity x 100.
+     */
     getDefaultRelativeHumidityMeasurementClusterServer(measuredValue = 0) {
         return ClusterServer(RelativeHumidityMeasurementCluster, {
             measuredValue,
@@ -1158,9 +1735,19 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             tolerance: 0,
         }, {}, {});
     }
+    /**
+     * Creates a default RelativeHumidityMeasurementCluster server.
+     *
+     * @param measuredValue - The measured value of the relative humidity x 100.
+     */
     createDefaultRelativeHumidityMeasurementClusterServer(measuredValue = 0) {
         this.addClusterServer(this.getDefaultRelativeHumidityMeasurementClusterServer(measuredValue));
     }
+    /**
+     * Get a default Pressure Measurement Cluster Server.
+     *
+     * @param measuredValue - The measured value for the pressure.
+     */
     getDefaultPressureMeasurementClusterServer(measuredValue = 1000) {
         return ClusterServer(PressureMeasurementCluster, {
             measuredValue,
@@ -1169,19 +1756,39 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             tolerance: 0,
         }, {}, {});
     }
+    /**
+     * Creates a default Pressure Measurement Cluster Server.
+     *
+     * @param measuredValue - The measured value for the pressure.
+     */
     createDefaultPressureMeasurementClusterServer(measuredValue = 1000) {
         this.addClusterServer(this.getDefaultPressureMeasurementClusterServer(measuredValue));
     }
+    /**
+     * Get a default boolean state cluster server.
+     *
+     * @param contact - Optional boolean value indicating the contact state. Defaults to `true` if not provided.
+     */
     getDefaultBooleanStateClusterServer(contact) {
         return ClusterServer(BooleanStateCluster, {
-            stateValue: contact ?? true,
+            stateValue: contact ?? true, // true=contact false=no_contact
         }, {}, {
             stateChange: true,
         });
     }
+    /**
+     * Creates a default boolean state configuration cluster server.
+     *
+     * @param contact - Optional boolean value indicating the contact state. Defaults to `true` if not provided.
+     */
     createDefaultBooleanStateClusterServer(contact) {
         this.addClusterServer(this.getDefaultBooleanStateClusterServer(contact));
     }
+    /**
+     * Get a default boolean state configuration cluster server.
+     *
+     * @param contact - Optional boolean value indicating the sensor fault state. Defaults to `false` if not provided.
+     */
     getDefaultBooleanStateConfigurationClusterServer(sensorFault = false) {
         return ClusterServer(BooleanStateConfigurationCluster.with(BooleanStateConfiguration.Feature.Visual, BooleanStateConfiguration.Feature.Audible, BooleanStateConfiguration.Feature.SensitivityLevel), {
             currentSensitivityLevel: 0,
@@ -1190,6 +1797,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             alarmsActive: { visual: false, audible: false },
             alarmsEnabled: { visual: false, audible: false },
             alarmsSupported: { visual: true, audible: true },
+            // alarmsSuppressed: { visual: false, audible: false },
             sensorFault: { generalFault: sensorFault },
         }, {
             enableDisableAlarm: async ({ request, attributes }) => {
@@ -1201,9 +1809,23 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             sensorFault: true,
         });
     }
+    /**
+     * Creates a default boolean state configuration cluster server.
+     *
+     * @param contact - Optional boolean value indicating the sensor fault state. Defaults to `false` if not provided.
+     */
     createDefaultBooleanStateConfigurationClusterServer(sensorFault = false) {
         this.addClusterServer(this.getDefaultBooleanStateConfigurationClusterServer(sensorFault));
     }
+    /**
+     * Get a default power source replaceable battery cluster server.
+     *
+     * @param batPercentRemaining - The remaining battery percentage (default: 100).
+     * @param batChargeLevel - The battery charge level (default: PowerSource.BatChargeLevel.Ok).
+     * @param batVoltage - The battery voltage (default: 1500).
+     * @param batReplacementDescription - The battery replacement description (default: 'Battery type').
+     * @param batQuantity - The battery quantity (default: 1).
+     */
     getDefaultPowerSourceReplaceableBatteryClusterServer(batPercentRemaining = 100, batChargeLevel = PowerSource.BatChargeLevel.Ok, batVoltage = 1500, batReplacementDescription = 'Battery type', batQuantity = 1) {
         return ClusterServer(PowerSourceCluster.with(PowerSource.Feature.Battery, PowerSource.Feature.Replaceable), {
             status: PowerSource.PowerSourceStatus.Active,
@@ -1220,9 +1842,25 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             endpointList: [],
         }, {}, {});
     }
+    /**
+     * Creates a default power source replaceable battery cluster server.
+     *
+     * @param batPercentRemaining - The remaining battery percentage (default: 100).
+     * @param batChargeLevel - The battery charge level (default: PowerSource.BatChargeLevel.Ok).
+     * @param batVoltage - The battery voltage (default: 1500).
+     * @param batReplacementDescription - The battery replacement description (default: 'Battery type').
+     * @param batQuantity - The battery quantity (default: 1).
+     */
     createDefaultPowerSourceReplaceableBatteryClusterServer(batPercentRemaining = 100, batChargeLevel = PowerSource.BatChargeLevel.Ok, batVoltage = 1500, batReplacementDescription = 'Battery type', batQuantity = 1) {
         this.addClusterServer(this.getDefaultPowerSourceReplaceableBatteryClusterServer(batPercentRemaining, batChargeLevel, batVoltage, batReplacementDescription, batQuantity));
     }
+    /**
+     * Get a default power source rechargeable battery cluster server.
+     *
+     * @param batPercentRemaining - The remaining battery percentage (default: 100).
+     * @param batChargeLevel - The battery charge level (default: PowerSource.BatChargeLevel.Ok).
+     * @param batVoltage - The battery voltage (default: 1500).
+     */
     getDefaultPowerSourceRechargeableBatteryClusterServer(batPercentRemaining = 100, batChargeLevel = PowerSource.BatChargeLevel.Ok, batVoltage = 1500) {
         return ClusterServer(PowerSourceCluster.with(PowerSource.Feature.Battery, PowerSource.Feature.Rechargeable), {
             status: PowerSource.PowerSourceStatus.Active,
@@ -1240,9 +1878,21 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             endpointList: [],
         }, {}, {});
     }
+    /**
+     * Creates a default power source rechargeable battery cluster server.
+     *
+     * @param batPercentRemaining - The remaining battery percentage (default: 100).
+     * @param batChargeLevel - The battery charge level (default: PowerSource.BatChargeLevel.Ok).
+     * @param batVoltage - The battery voltage (default: 1500).
+     */
     createDefaultPowerSourceRechargeableBatteryClusterServer(batPercentRemaining = 100, batChargeLevel = PowerSource.BatChargeLevel.Ok, batVoltage = 1500) {
         this.addClusterServer(this.getDefaultPowerSourceRechargeableBatteryClusterServer(batPercentRemaining, batChargeLevel, batVoltage));
     }
+    /**
+     * Get a default power source wired cluster server.
+     *
+     * @param wiredCurrentType - The type of wired current (default: PowerSource.WiredCurrentType.Ac)
+     */
     getDefaultPowerSourceWiredClusterServer(wiredCurrentType = PowerSource.WiredCurrentType.Ac) {
         return ClusterServer(PowerSourceCluster.with(PowerSource.Feature.Wired), {
             wiredCurrentType,
@@ -1252,22 +1902,45 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             endpointList: [],
         }, {}, {});
     }
+    /**
+     * Creates a default power source wired cluster server.
+     *
+     * @param wiredCurrentType - The type of wired current (default: PowerSource.WiredCurrentType.Ac)
+     */
     createDefaultPowerSourceWiredClusterServer(wiredCurrentType = PowerSource.WiredCurrentType.Ac) {
         this.addClusterServer(this.getDefaultPowerSourceWiredClusterServer(wiredCurrentType));
     }
+    /**
+     * @deprecated This function is deprecated by Matter 1.3 spec and will be removed in a future version.
+     */
     createDefaultPowerSourceConfigurationClusterServer(endpointNumber) {
         this.addClusterServer(ClusterServer(PowerSourceConfigurationCluster, {
             sources: endpointNumber ? [EndpointNumber(endpointNumber)] : [],
         }, {}, {}));
     }
+    /**
+     * Get a default air quality cluster server.
+     *
+     * @param airQuality The air quality type. Defaults to `AirQuality.AirQualityType.Unknown`.
+     */
     getDefaultAirQualityClusterServer(airQuality = AirQuality.AirQualityEnum.Unknown) {
         return ClusterServer(AirQualityCluster.with(AirQuality.Feature.Fair, AirQuality.Feature.Moderate, AirQuality.Feature.VeryPoor, AirQuality.Feature.ExtremelyPoor), {
             airQuality,
         }, {}, {});
     }
+    /**
+     * Creates a default air quality cluster server.
+     *
+     * @param airQuality The air quality type. Defaults to `AirQuality.AirQualityType.Unknown`.
+     */
     createDefaultAirQualityClusterServer(airQuality = AirQuality.AirQualityEnum.Unknown) {
         this.addClusterServer(this.getDefaultAirQualityClusterServer(airQuality));
     }
+    /**
+     * Get a default TVOC measurement cluster server.
+     *
+     * @param measuredValue - The measured value for TVOC.
+     */
     getDefaultTvocMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         return ClusterServer(TotalVolatileOrganicCompoundsConcentrationMeasurementCluster.with('NumericMeasurement'), {
             measuredValue,
@@ -1278,14 +1951,28 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             measurementMedium,
         }, {}, {});
     }
+    /**
+     * Creates a default TVOC measurement cluster server.
+     *
+     * @param measuredValue - The measured value for TVOC.
+     */
     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,
@@ -1298,14 +1985,31 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             },
         }, {});
     }
+    /**
+     * 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,
@@ -1318,24 +2022,48 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             },
         }, {});
     }
+    /**
+     * 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.
+     *
+     * @param {number} [localTemperature=23] - The local temperature value in degrees Celsius. Defaults to 23°.
+     * @param {number} [occupiedHeatingSetpoint=21] - The occupied heating setpoint value in degrees Celsius. Defaults to 21°.
+     * @param {number} [occupiedCoolingSetpoint=25] - The occupied cooling setpoint value in degrees Celsius. Defaults to 25°.
+     * @param {number} [minSetpointDeadBand=1] - The minimum setpoint dead band value. Defaults to 1°.
+     * @param {number} [minHeatSetpointLimit=0] - The minimum heat setpoint limit value. Defaults to 0°.
+     * @param {number} [maxHeatSetpointLimit=50] - The maximum heat setpoint limit value. Defaults to 50°.
+     * @param {number} [minCoolSetpointLimit=0] - The minimum cool setpoint limit value. Defaults to 0°.
+     * @param {number} [maxCoolSetpointLimit=50] - The maximum cool setpoint limit value. Defaults to 50°.
+     * @returns {ThermostatClusterServer} A default thermostat cluster server configured with the specified parameters.
+     */
     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,
             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,
             thermostatRunningMode: Thermostat.ThermostatRunningMode.Off,
         }, {
@@ -1345,9 +2073,24 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             },
         }, {});
     }
+    /**
+     * Creates and adds a default thermostat cluster server to the device.
+     *
+     * @param {number} [localTemperature=23] - The local temperature value in degrees Celsius. Defaults to 23°.
+     * @param {number} [occupiedHeatingSetpoint=21] - The occupied heating setpoint value in degrees Celsius. Defaults to 21°.
+     * @param {number} [occupiedCoolingSetpoint=25] - The occupied cooling setpoint value in degrees Celsius. Defaults to 25°.
+     * @param {number} [minSetpointDeadBand=1] - The minimum setpoint dead band value. Defaults to 1°.
+     * @param {number} [minHeatSetpointLimit=0] - The minimum heat setpoint limit value. Defaults to 0°.
+     * @param {number} [maxHeatSetpointLimit=50] - The maximum heat setpoint limit value. Defaults to 50°.
+     * @param {number} [minCoolSetpointLimit=0] - The minimum cool setpoint limit value. Defaults to 0°.
+     * @param {number} [maxCoolSetpointLimit=50] - The maximum cool setpoint limit value. Defaults to 50°.
+     */
     createDefaultThermostatClusterServer(localTemperature = 23, occupiedHeatingSetpoint = 21, occupiedCoolingSetpoint = 25, minSetpointDeadBand = 1, minHeatSetpointLimit = 0, maxHeatSetpointLimit = 50, minCoolSetpointLimit = 0, maxCoolSetpointLimit = 50) {
         this.addClusterServer(this.getDefaultThermostatClusterServer(localTemperature, occupiedHeatingSetpoint, occupiedCoolingSetpoint, minSetpointDeadBand, minHeatSetpointLimit, maxHeatSetpointLimit, minCoolSetpointLimit, maxCoolSetpointLimit));
     }
+    /**
+     * Get a default dummy time sync cluster server. Only needed to create a thermostat.
+     */
     getDefaultTimeSyncClusterServer() {
         return ClusterServer(TimeSynchronizationCluster.with(TimeSynchronization.Feature.TimeZone), {
             utcTime: null,
@@ -1379,9 +2122,19 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             timeFailure: true,
         });
     }
+    /**
+     * Creates a default dummy time sync cluster server. Only needed to create a thermostat.
+     */
     createDefaultTimeSyncClusterServer() {
         this.addClusterServer(this.getDefaultTimeSyncClusterServer());
     }
+    /**
+     * Returns the default SmokeCOAlarm Cluster Server.
+     *
+     * @param smokeState - The state of the smoke alarm. Defaults to SmokeCoAlarm.AlarmState.Normal.
+     * @param coState - The state of the CO alarm. Defaults to SmokeCoAlarm.AlarmState.Normal.
+     * @returns The default SmokeCOAlarmClusterServer.
+     */
     getDefaultSmokeCOAlarmClusterServer(smokeState = SmokeCoAlarm.AlarmState.Normal, coState = SmokeCoAlarm.AlarmState.Normal) {
         return ClusterServer(SmokeCoAlarmCluster.with(SmokeCoAlarm.Feature.SmokeAlarm, SmokeCoAlarm.Feature.CoAlarm), {
             smokeState,
@@ -1413,9 +2166,24 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             allClear: true,
         });
     }
+    /**
+     * Create the default SmokeCOAlarm Cluster Server.
+     *
+     * @param smokeState - The state of the smoke alarm. Defaults to SmokeCoAlarm.AlarmState.Normal.
+     * @param coState - The state of the CO alarm. Defaults to SmokeCoAlarm.AlarmState.Normal.
+     * @returns The default SmokeCOAlarmClusterServer.
+     */
     createDefaultSmokeCOAlarmClusterServer(smokeState = SmokeCoAlarm.AlarmState.Normal, coState = SmokeCoAlarm.AlarmState.Normal) {
         this.addClusterServer(this.getDefaultSmokeCOAlarmClusterServer(smokeState, coState));
     }
+    /**
+     * Returns the default Carbon Monoxide Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     * @returns {ClusterServer} - The default Carbon Monoxide Concentration Measurement Cluster Server.
+     */
     getDefaultCarbonMonoxideConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         return ClusterServer(CarbonMonoxideConcentrationMeasurementCluster.with('NumericMeasurement'), {
             measuredValue,
@@ -1426,9 +2194,24 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             measurementMedium,
         }, {}, {});
     }
+    /**
+     * Create the default Carbon Monoxide Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     */
     createDefaultCarbonMonoxideConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.addClusterServer(this.getDefaultCarbonMonoxideConcentrationMeasurementClusterServer(measuredValue, measurementUnit, measurementMedium));
     }
+    /**
+     * Returns the default Carbon Dioxide Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     * @returns {ClusterServer} - The default Carbon Monoxide Concentration Measurement Cluster Server.
+     */
     getDefaultCarbonDioxideConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         return ClusterServer(CarbonDioxideConcentrationMeasurementCluster.with('NumericMeasurement'), {
             measuredValue,
@@ -1439,9 +2222,24 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             measurementMedium,
         }, {}, {});
     }
+    /**
+     * Create the default Carbon Dioxide Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     */
     createDefaultCarbonDioxideConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.addClusterServer(this.getDefaultCarbonDioxideConcentrationMeasurementClusterServer(measuredValue, measurementUnit, measurementMedium));
     }
+    /**
+     * Returns the default Formaldehyde Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     * @returns {ClusterServer} - The default Carbon Monoxide Concentration Measurement Cluster Server.
+     */
     getDefaultFormaldehydeConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         return ClusterServer(FormaldehydeConcentrationMeasurementCluster.with('NumericMeasurement'), {
             measuredValue,
@@ -1452,9 +2250,24 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             measurementMedium,
         }, {}, {});
     }
+    /**
+     * Create the default Formaldehyde Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     */
     createDefaultFormaldehydeConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.addClusterServer(this.getDefaultFormaldehydeConcentrationMeasurementClusterServer(measuredValue, measurementUnit, measurementMedium));
     }
+    /**
+     * Returns the default Pm1 Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     * @returns {ClusterServer} - The default Carbon Monoxide Concentration Measurement Cluster Server.
+     */
     getDefaultPm1ConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         return ClusterServer(Pm1ConcentrationMeasurementCluster.with('NumericMeasurement'), {
             measuredValue,
@@ -1465,9 +2278,24 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             measurementMedium,
         }, {}, {});
     }
+    /**
+     * Create the default Pm1 Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     */
     createDefaulPm1ConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.addClusterServer(this.getDefaultPm1ConcentrationMeasurementClusterServer(measuredValue, measurementUnit, measurementMedium));
     }
+    /**
+     * Returns the default Pm25 Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     * @returns {ClusterServer} - The default Carbon Monoxide Concentration Measurement Cluster Server.
+     */
     getDefaultPm25ConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         return ClusterServer(Pm25ConcentrationMeasurementCluster.with('NumericMeasurement'), {
             measuredValue,
@@ -1478,9 +2306,24 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             measurementMedium,
         }, {}, {});
     }
+    /**
+     * Create the default Pm25 Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     */
     createDefaulPm25ConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.addClusterServer(this.getDefaultPm25ConcentrationMeasurementClusterServer(measuredValue, measurementUnit, measurementMedium));
     }
+    /**
+     * Returns the default Pm10 Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     * @returns {ClusterServer} - The default Carbon Monoxide Concentration Measurement Cluster Server.
+     */
     getDefaultPm10ConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         return ClusterServer(Pm10ConcentrationMeasurementCluster.with('NumericMeasurement'), {
             measuredValue,
@@ -1491,9 +2334,24 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             measurementMedium,
         }, {}, {});
     }
+    /**
+     * Create the default Pm10 Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     */
     createDefaulPm10ConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.addClusterServer(this.getDefaultPm10ConcentrationMeasurementClusterServer(measuredValue, measurementUnit, measurementMedium));
     }
+    /**
+     * Returns the default Ozone Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     * @returns {ClusterServer} - The default Carbon Monoxide Concentration Measurement Cluster Server.
+     */
     getDefaultOzoneConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ugm3, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         return ClusterServer(OzoneConcentrationMeasurementCluster.with('NumericMeasurement'), {
             measuredValue,
@@ -1504,9 +2362,24 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             measurementMedium,
         }, {}, {});
     }
+    /**
+     * Create the default Ozone Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     */
     createDefaulOzoneConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ugm3, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.addClusterServer(this.getDefaultOzoneConcentrationMeasurementClusterServer(measuredValue, measurementUnit, measurementMedium));
     }
+    /**
+     * Returns the default Radon Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     * @returns {ClusterServer} - The default Carbon Monoxide Concentration Measurement Cluster Server.
+     */
     getDefaultRadonConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         return ClusterServer(RadonConcentrationMeasurementCluster.with('NumericMeasurement'), {
             measuredValue,
@@ -1517,9 +2390,24 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             measurementMedium,
         }, {}, {});
     }
+    /**
+     * Create the default Radon Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     */
     createDefaulRadonConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.addClusterServer(this.getDefaultRadonConcentrationMeasurementClusterServer(measuredValue, measurementUnit, measurementMedium));
     }
+    /**
+     * Returns the default Nitrogen Dioxide Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     * @returns {ClusterServer} - The default Carbon Monoxide Concentration Measurement Cluster Server.
+     */
     getDefaultNitrogenDioxideConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ugm3, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         return ClusterServer(NitrogenDioxideConcentrationMeasurementCluster.with('NumericMeasurement'), {
             measuredValue,
@@ -1530,9 +2418,22 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             measurementMedium,
         }, {}, {});
     }
+    /**
+     * Create the default Nitrogen Dioxide Concentration Measurement Cluster Server.
+     *
+     * @param {number} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement.
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The medium of measurement.
+     */
     createDefaulNitrogenDioxideConcentrationMeasurementClusterServer(measuredValue = 0, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ugm3, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.addClusterServer(this.getDefaultNitrogenDioxideConcentrationMeasurementClusterServer(measuredValue, measurementUnit, measurementMedium));
     }
+    /**
+     * Returns the default fan control cluster server rev 2.
+     *
+     * @param fanMode The fan mode to set. Defaults to `FanControl.FanMode.Off`.
+     * @returns The default fan control cluster server.
+     */
     getDefaultFanControlClusterServer(fanMode = FanControl.FanMode.Off) {
         return ClusterServer(FanControlCluster.with(FanControl.Feature.MultiSpeed, FanControl.Feature.Auto, FanControl.Feature.Step), {
             fanMode,
@@ -1549,9 +2450,16 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             },
         }, {});
     }
+    /**
+     * Create the default fan control cluster server rev 2.
+     *
+     * @param fanMode The fan mode to set. Defaults to `FanControl.FanMode.Off`.
+     * @returns The default fan control cluster server.
+     */
     createDefaultFanControlClusterServer(fanMode = FanControl.FanMode.Off) {
         this.addClusterServer(this.getDefaultFanControlClusterServer(fanMode));
     }
+    // NOTE Support of Device Energy Management Cluster is provisional.
     getDefaultDeviceEnergyManagementClusterServer() {
         return ClusterServer(DeviceEnergyManagementCluster.with(DeviceEnergyManagement.Feature.Pausable, DeviceEnergyManagement.Feature.PowerForecastReporting, DeviceEnergyManagement.Feature.StateForecastReporting), {
             esaType: DeviceEnergyManagement.EsaType.Other,
@@ -1575,6 +2483,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             resumed: true,
         });
     }
+    // NOTE Support of Device Energy Management Mode Cluster is provisional.
     getDefaultDeviceEnergyManagementModeClusterServer() {
         return ClusterServer(DeviceEnergyManagementModeCluster, {
             supportedModes: [
@@ -1591,3 +2500,4 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         }, {});
     }
 }
+//# sourceMappingURL=matterbridgeDevice.js.map