matterbridge 3.0.5-dev-20250607-353b662 → 3.0.5

package/dist/matterbridgeEndpoint.js

@@ -1,10 +1,36 @@
+/**
+ * This file contains the class MatterbridgeEndpoint that extends the Endpoint class from the Matter.js library.
+ *
+ * @file matterbridgeEndpoint.ts
+ * @author Luca Liguori
+ * @date 2024-10-01
+ * @version 2.0.0
+ *
+ * Copyright 2024, 2025, 2026 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. *
+ */
+// AnsiLogger module
 import { AnsiLogger, CYAN, YELLOW, db, debugStringify, hk, or, zb } from './logger/export.js';
+// Matterbridge
 import { bridgedNode } from './matterbridgeDeviceTypes.js';
 import { isValidNumber, isValidObject, isValidString } from './utils/export.js';
 import { MatterbridgeServer, MatterbridgeServerDevice, MatterbridgeIdentifyServer, MatterbridgeOnOffServer, MatterbridgeLevelControlServer, MatterbridgeColorControlServer, MatterbridgeLiftWindowCoveringServer, MatterbridgeLiftTiltWindowCoveringServer, MatterbridgeThermostatServer, MatterbridgeFanControlServer, MatterbridgeDoorLockServer, MatterbridgeModeSelectServer, MatterbridgeValveConfigurationAndControlServer, MatterbridgeSmokeCoAlarmServer, MatterbridgeBooleanStateConfigurationServer, MatterbridgeSwitchServer, MatterbridgeOperationalStateServer, MatterbridgeDeviceEnergyManagementModeServer, } from './matterbridgeBehaviors.js';
 import { addClusterServers, addFixedLabel, addOptionalClusterServers, addRequiredClusterServers, addUserLabel, createUniqueId, getBehavior, getBehaviourTypesFromClusterClientIds, getBehaviourTypesFromClusterServerIds, getDefaultOperationalStateClusterServer, getDefaultFlowMeasurementClusterServer, getDefaultIlluminanceMeasurementClusterServer, getDefaultPressureMeasurementClusterServer, getDefaultRelativeHumidityMeasurementClusterServer, getDefaultTemperatureMeasurementClusterServer, getDefaultOccupancySensingClusterServer, lowercaseFirstLetter, updateAttribute, getClusterId, getAttributeId, setAttribute, getAttribute, checkNotLatinCharacters, generateUniqueId, subscribeAttribute, invokeBehaviorCommand, triggerEvent, } from './matterbridgeEndpointHelpers.js';
+// @matter
 import { Endpoint, Lifecycle, MutableEndpoint, NamedHandler, SupportedBehaviors, UINT16_MAX, UINT32_MAX, VendorId } from '@matter/main';
 import { getClusterNameById, MeasurementType } from '@matter/main/types';
+// @matter clusters
 import { Descriptor } from '@matter/main/clusters/descriptor';
 import { PowerSource } from '@matter/main/clusters/power-source';
 import { BridgedDeviceBasicInformation } from '@matter/main/clusters/bridged-device-basic-information';
@@ -31,6 +57,7 @@ import { ThermostatUserInterfaceConfiguration } from '@matter/main/clusters/ther
 import { OperationalState } from '@matter/main/clusters/operational-state';
 import { DeviceEnergyManagement } from '@matter/main/clusters/device-energy-management';
 import { DeviceEnergyManagementMode } from '@matter/main/clusters/device-energy-management-mode';
+// @matter behaviors
 import { DescriptorServer } from '@matter/main/behaviors/descriptor';
 import { PowerSourceServer } from '@matter/main/behaviors/power-source';
 import { BridgedDeviceBasicInformationServer } from '@matter/main/behaviors/bridged-device-basic-information';
@@ -67,7 +94,7 @@ import { ThermostatUserInterfaceConfigurationServer } from '@matter/main/behavio
 import { DeviceEnergyManagementServer } from '@matter/main/behaviors/device-energy-management';
 export class MatterbridgeEndpoint extends Endpoint {
     static bridgeMode = '';
-    static logLevel = "info";
+    static logLevel = "info" /* LogLevel.INFO */;
     log;
     plugin = undefined;
     configUrl = undefined;
@@ -83,14 +110,25 @@ export class MatterbridgeEndpoint extends Endpoint {
     hardwareVersion = undefined;
     hardwareVersionString = undefined;
     productUrl = 'https://www.npmjs.com/package/matterbridge';
+    // The first device type of the endpoint
     name = undefined;
     deviceType;
     uniqueStorageKey = undefined;
     tagList = undefined;
+    // Maps matter deviceTypes
     deviceTypes = new Map();
+    // Command handler
     commandHandler = new NamedHandler();
+    /**
+     * Represents a MatterbridgeEndpoint.
+     * @constructor
+     * @param {DeviceTypeDefinition | AtLeastOne<DeviceTypeDefinition>} definition - The DeviceTypeDefinition(s) of the endpoint.
+     * @param {MatterbridgeEndpointOptions} [options={}] - The options for the device.
+     * @param {boolean} [debug=false] - Debug flag.
+     */
     constructor(definition, options = {}, debug = false) {
         let deviceTypeList = [];
+        // Get the first DeviceTypeDefinition
         let firstDefinition;
         if (Array.isArray(definition)) {
             firstDefinition = definition[0];
@@ -103,6 +141,7 @@ export class MatterbridgeEndpoint extends Endpoint {
             firstDefinition = definition;
             deviceTypeList = [{ deviceType: firstDefinition.code, revision: firstDefinition.revision }];
         }
+        // Convert the first DeviceTypeDefinition to an EndpointType.Options
         const deviceTypeDefinitionV8 = {
             name: firstDefinition.name.replace('-', '_'),
             deviceType: firstDefinition.code,
@@ -121,9 +160,11 @@ export class MatterbridgeEndpoint extends Endpoint {
             behaviors: options.tagList ? SupportedBehaviors(DescriptorServer.with(Descriptor.Feature.TagList)) : {},
         };
         const endpointV8 = MutableEndpoint(deviceTypeDefinitionV8);
+        // Check if the uniqueStorageKey is valid
         if (options.uniqueStorageKey && checkNotLatinCharacters(options.uniqueStorageKey)) {
             options.uniqueStorageKey = generateUniqueId(options.uniqueStorageKey);
         }
+        // Convert the options to an Endpoint.Options
         const optionsV8 = {
             id: options.uniqueStorageKey?.replace(/[ .]/g, ''),
             number: options.endpointId,
@@ -141,16 +182,40 @@ export class MatterbridgeEndpoint extends Endpoint {
         }
         else
             this.deviceTypes.set(firstDefinition.code, firstDefinition);
-        this.log = new AnsiLogger({ logName: options.uniqueStorageKey ?? 'MatterbridgeEndpoint', logTimestampFormat: 4, logLevel: debug === true ? "debug" : MatterbridgeEndpoint.logLevel });
+        // console.log('MatterbridgeEndpoint.option', options);
+        // console.log('MatterbridgeEndpoint.endpointV8', endpointV8);
+        // console.log('MatterbridgeEndpoint.optionsV8', optionsV8);
+        // Create the logger
+        this.log = new AnsiLogger({ logName: options.uniqueStorageKey ?? 'MatterbridgeEndpoint', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: debug === true ? "debug" /* LogLevel.DEBUG */ : MatterbridgeEndpoint.logLevel });
         this.log.debug(`${YELLOW}new${db} MatterbridgeEndpoint: ${zb}${'0x' + firstDefinition.code.toString(16).padStart(4, '0')}${db}-${zb}${firstDefinition.name}${db} id: ${CYAN}${options.uniqueStorageKey}${db} number: ${CYAN}${options.endpointId}${db} taglist: ${CYAN}${options.tagList ? debugStringify(options.tagList) : 'undefined'}${db}`);
+        // Add MatterbridgeBehavior with MatterbridgeBehaviorDevice
         this.behaviors.require(MatterbridgeServer, { deviceCommand: new MatterbridgeServerDevice(this.log, this.commandHandler, undefined) });
     }
+    /**
+     * Loads an instance of the MatterbridgeEndpoint class.
+     *
+     * @param {DeviceTypeDefinition | AtLeastOne<DeviceTypeDefinition>} definition - The DeviceTypeDefinition(s) of the device.
+     * @param {MatterbridgeEndpointOptions} [options={}] - The options for the device.
+     * @param {boolean} [debug=false] - Debug flag.
+     * @returns {Promise<MatterbridgeEndpoint>} MatterbridgeEndpoint instance.
+     */
     static async loadInstance(definition, options = {}, debug = false) {
         return new MatterbridgeEndpoint(definition, options, debug);
     }
+    /**
+     * Get all the device types of this endpoint.
+     *
+     * @returns {DeviceTypeDefinition[]} The device types of this endpoint.
+     */
     getDeviceTypes() {
         return Array.from(this.deviceTypes.values());
     }
+    /**
+     * Checks if the provided cluster server is supported by this endpoint.
+     *
+     * @param {Behavior.Type | ClusterType | ClusterId | string} cluster - The cluster to check.
+     * @returns {boolean} True if the cluster server is supported, false otherwise.
+     */
     hasClusterServer(cluster) {
         const behavior = getBehavior(this, cluster);
         if (behavior)
@@ -158,6 +223,13 @@ export class MatterbridgeEndpoint extends Endpoint {
         else
             return false;
     }
+    /**
+     * Checks if the provided attribute server is supported for a given cluster of this endpoint.
+     *
+     * @param {Behavior.Type | ClusterType | ClusterId | string} cluster - The cluster to check.
+     * @param {string} attribute - The attribute name to check.
+     * @returns {boolean} True if the attribute server is supported, false otherwise.
+     */
     hasAttributeServer(cluster, attribute) {
         const behavior = getBehavior(this, cluster);
         if (!behavior || !this.behaviors.supported[behavior.id])
@@ -166,82 +238,228 @@ export class MatterbridgeEndpoint extends Endpoint {
         const defaults = this.behaviors.defaultsFor(behavior);
         return lowercaseFirstLetter(attribute) in options || lowercaseFirstLetter(attribute) in defaults;
     }
+    /**
+     * Retrieves the initial options for the provided cluster server.
+     *
+     * @param {Behavior.Type | ClusterType | ClusterId | string} cluster - The cluster to get options for.
+     * @returns {Record<string, boolean | number | bigint | string | object | null> | undefined} The options for the provided cluster server, or undefined if the cluster is not supported.
+     */
     getClusterServerOptions(cluster) {
         const behavior = getBehavior(this, cluster);
         if (!behavior)
             return undefined;
         return this.behaviors.optionsFor(behavior);
     }
+    /**
+     * Retrieves the value of the provided attribute from the given cluster.
+     *
+     * @param {Behavior.Type | ClusterType | ClusterId | string} cluster - 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.
+     * @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(cluster, attribute, log) {
         return getAttribute(this, cluster, attribute, log);
     }
+    /**
+     * Sets the value of an attribute on a cluster server.
+     *
+     * @param {Behavior.Type | ClusterType | ClusterId | string} clusterId - The ID of the cluster.
+     * @param {string} attribute - The name of the attribute.
+     * @param {boolean | number | bigint | string | object | null} value - The value to set for the attribute.
+     * @param {AnsiLogger} [log] - (Optional) The logger to use for logging errors and information.
+     * @returns {Promise<boolean>} - A promise that resolves to a boolean indicating whether the attribute was successfully set.
+     */
     async setAttribute(clusterId, attribute, value, log) {
         return await setAttribute(this, clusterId, attribute, value, log);
     }
+    /**
+     * Update the value of an attribute on a cluster server only if the value is different.
+     *
+     * @param {Behavior.Type | ClusterType | ClusterId | string} cluster - The cluster to set the attribute on.
+     * @param {string} attribute - The name of the attribute.
+     * @param {boolean | number | bigint | string | object | null} value - The value to set for the attribute.
+     * @param {AnsiLogger} [log] - (Optional) The logger to use for logging the update. Errors are logged to the endpoint logger.
+     * @returns {Promise<boolean>} - A promise that resolves to a boolean indicating whether the attribute was successfully set.
+     */
     async updateAttribute(cluster, attribute, value, log) {
         return await updateAttribute(this, cluster, attribute, value, log);
     }
+    /**
+     * Subscribes to the provided attribute on a cluster.
+     *
+     * @param {Behavior.Type | ClusterType | ClusterId | string} cluster - The cluster to subscribe the attribute to.
+     * @param {string} attribute - The name of the attribute to subscribe to.
+     * @param {(newValue: any, oldValue: any, context: ActionContext) => void} listener - A callback function that will be called when the attribute value changes. When context.offline === true then the change is locally generated and not from the controller.
+     * @param {AnsiLogger} [log] - Optional logger for logging errors and information.
+     * @returns {Promise<boolean>} - A boolean indicating whether the subscription was successful.
+     *
+     * @remarks The listener function (cannot be async) will receive three parameters:
+     * - `newValue`: The new value of the attribute.
+     * - `oldValue`: The old value of the attribute.
+     * - `context`: The action context, which includes information about the action that triggered the change. When context.offline === true then the change is locally generated and not from the controller.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async subscribeAttribute(cluster, attribute, listener, log) {
         return await subscribeAttribute(this, cluster, attribute, listener, log);
     }
+    /**
+     * Triggers an event on the specified cluster.
+     * @param {ClusterId} cluster - The ID of the cluster.
+     * @param {string} event - The name of the event to trigger.
+     * @param {Record<string, boolean | number | bigint | string | object | undefined | null>} payload - The payload to pass to the event.
+     * @param {AnsiLogger} [log] - Optional logger for logging information.
+     * @returns {Promise<boolean>} - A promise that resolves to a boolean indicating whether the event was successfully triggered.
+     */
     async triggerEvent(cluster, event, payload, log) {
         return await triggerEvent(this, cluster, event, payload, log);
     }
+    /**
+     * Adds cluster servers from the provided server list.
+     *
+     * @param {ClusterId[]} serverList - The list of cluster IDs to add.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     addClusterServers(serverList) {
         addClusterServers(this, serverList);
         return this;
     }
+    /**
+     * Adds a fixed label to the FixedLabel cluster. If the cluster server is not present, it will be added.
+     *
+     * @param {string} label - The label to add.
+     * @param {string} value - The value of the label.
+     * @returns {Promise<this>} The current MatterbridgeEndpoint instance for chaining.
+     */
     async addFixedLabel(label, value) {
         await addFixedLabel(this, label, value);
         return this;
     }
+    /**
+     * Adds a user label to the UserLabel cluster. If the cluster server is not present, it will be added.
+     *
+     * @param {string} label - The label to add.
+     * @param {string} value - The value of the label.
+     * @returns {Promise<this>} The current MatterbridgeEndpoint instance for chaining.
+     */
     async addUserLabel(label, value) {
         await addUserLabel(this, label, value);
         return this;
     }
+    /**
+     * Adds a command handler for the specified command.
+     *
+     * @param {keyof MatterbridgeEndpointCommands} command - The command to add the handler for.
+     * @param {HandlerFunction} handler - The handler function to execute when the command is received.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     addCommandHandler(command, handler) {
         this.commandHandler.addHandler(command, handler);
         return this;
     }
+    /**
+     * Execute the command handler for the specified command. Used ONLY in Jest tests.
+     *
+     * @param {keyof MatterbridgeEndpointCommands} command - The command to execute.
+     * @param {Record<string, boolean | number | bigint | string | object | null>} [request] - The optional request to pass to the handler function.
+     *
+     * @deprecated Used ONLY in Jest tests.
+     */
     async executeCommandHandler(command, request) {
         await this.commandHandler.executeHandler(command, { request });
     }
+    /**
+     * Invokes a behavior command on the specified cluster. Used ONLY in Jest tests.
+     *
+     * @param {Behavior.Type | ClusterType | ClusterId | string} cluster - The cluster to invoke the command on.
+     * @param {string} command - The command to invoke.
+     * @param {Record<string, boolean | number | bigint | string | object | null>} [params] - The optional parameters to pass to the command.
+     *
+     * @deprecated Used ONLY in Jest tests.
+     */
     async invokeBehaviorCommand(cluster, command, params) {
         await invokeBehaviorCommand(this, cluster, command, params);
     }
+    /**
+     * Adds the required cluster servers (only if they are not present) for the device types of the specified endpoint.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     addRequiredClusterServers() {
         addRequiredClusterServers(this);
         return this;
     }
+    /**
+     * Adds the optional cluster servers (only if they are not present) for the device types of the specified endpoint.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     addOptionalClusterServers() {
         addOptionalClusterServers(this);
         return this;
     }
+    /**
+     * Retrieves all cluster servers.
+     *
+     * @returns {Behavior.Type[]} An array of all cluster servers.
+     */
     getAllClusterServers() {
         return Object.values(this.behaviors.supported);
     }
+    /**
+     * Retrieves the names of all cluster servers.
+     *
+     * @returns {string[]} An array of all cluster server names.
+     */
     getAllClusterServerNames() {
         return Object.keys(this.behaviors.supported);
     }
+    /**
+     * Iterates over each attribute of each cluster server of the device state and calls the provided callback function.
+     *
+     * @param {Function} callback - The callback function to call with the cluster name, cluster id, attribute name, attribute id and attribute value.
+     */
     forEachAttribute(callback) {
         if (!this.lifecycle.isReady || this.construction.status !== Lifecycle.Status.Active)
             return;
         for (const [clusterName, clusterAttributes] of Object.entries(this.state)) {
+            // Skip if the key / cluster name is a number, cause they are double indexed.
             if (!isNaN(Number(clusterName)))
                 continue;
             for (const [attributeName, attributeValue] of Object.entries(clusterAttributes)) {
+                // Skip if the behavior has no associated cluster (i.e. matterbridge server)
                 const clusterId = getClusterId(this, clusterName);
                 if (clusterId === undefined) {
+                    // this.log.debug(`***forEachAttribute: cluster ${clusterName} not found`);
                     continue;
                 }
+                // Skip if the attribute is not present in the ClusterBehavior.Type. Also skip if the attribute it is an internal state.
                 const attributeId = getAttributeId(this, clusterName, attributeName);
                 if (attributeId === undefined) {
+                    // this.log.debug(`***forEachAttribute: attribute ${clusterName}.${attributeName} not found`);
                     continue;
                 }
                 callback(clusterName, clusterId, attributeName, attributeId, attributeValue);
             }
         }
     }
+    /**
+     * 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 existing child endpoint will be returned.
+     *
+     * @param {string} endpointName - The name of the new endpoint to add.
+     * @param {DeviceTypeDefinition | AtLeastOne<DeviceTypeDefinition>} definition - The device types to add.
+     * @param {MatterbridgeEndpointOptions} [options={}] - The options for the endpoint.
+     * @param {boolean} [debug=false] - Whether to enable debug logging.
+     * @returns {MatterbridgeEndpoint} - The child endpoint that was found or added.
+     *
+     * @example
+     * ```typescript
+     * const endpoint = device.addChildDeviceType('Temperature', [temperatureSensor], { tagList: [{ mfgCode: null, namespaceId: LocationTag.Indoor.namespaceId, tag: LocationTag.Indoor.tag, label: null }] }, true);
+     * ```
+     */
     addChildDeviceType(endpointName, definition, options = {}, debug = false) {
         this.log.debug(`addChildDeviceType: ${CYAN}${endpointName}${db}`);
         let alreadyAdded = false;
@@ -281,6 +499,23 @@ export class MatterbridgeEndpoint extends Endpoint {
         }
         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 {DeviceTypeDefinition | AtLeastOne<DeviceTypeDefinition>} definition - The device types to add.
+     * @param {ClusterId[]} [serverList=[]] - The list of cluster IDs to include.
+     * @param {MatterbridgeEndpointOptions} [options={}] - The options for the device.
+     * @param {boolean} [debug=false] - Whether to enable debug logging.
+     * @returns {MatterbridgeEndpoint} - The child endpoint that was found or added.
+     *
+     * @example
+     * ```typescript
+     * const endpoint = device.addChildDeviceTypeWithClusterServer('Temperature', [temperatureSensor], [], { tagList: [{ mfgCode: null, namespaceId: LocationTag.Indoor.namespaceId, tag: LocationTag.Indoor.tag, label: null }] }, true);
+     * ```
+     */
     addChildDeviceTypeWithClusterServer(endpointName, definition, serverList = [], options = {}, debug = false) {
         this.log.debug(`addChildDeviceTypeWithClusterServer: ${CYAN}${endpointName}${db}`);
         let alreadyAdded = false;
@@ -343,15 +578,38 @@ export class MatterbridgeEndpoint extends Endpoint {
         }
         return child;
     }
+    /**
+     * 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.parts.find((part) => part.id === endpointName);
     }
+    /**
+     * Retrieves a child endpoint by its EndpointNumber.
+     *
+     * @param {EndpointNumber} endpointNumber - The EndpointNumber of the endpoint to retrieve.
+     * @returns {MatterbridgeEndpoint | undefined} The child endpoint with the specified EndpointNumber, or undefined if not found.
+     */
     getChildEndpoint(endpointNumber) {
         return this.parts.find((part) => part.number === endpointNumber);
     }
+    /**
+     * Get all the child endpoints of this endpoint.
+     *
+     * @returns {MatterbridgeEndpoint[]} The child endpoints.
+     */
     getChildEndpoints() {
         return Array.from(this.parts);
     }
+    /**
+     * Serializes the Matterbridge device into a serialized object.
+     *
+     * @param pluginName - The name of the plugin.
+     * @returns The serialized Matterbridge device object.
+     */
     static serialize(device) {
         if (!device.serialNumber || !device.deviceName || !device.uniqueId)
             return;
@@ -374,9 +632,15 @@ export class MatterbridgeEndpoint extends Endpoint {
                 serialized.clusterServersId.push(BridgedDeviceBasicInformation.Cluster.id);
             if (behaviorName === 'powerSource')
                 serialized.clusterServersId.push(PowerSource.Cluster.id);
+            // serialized.clusterServersId.push(this.behaviors.supported[behaviorName]cluster.id);
         });
         return serialized;
     }
+    /**
+     * Deserializes the device into a serialized object.
+     *
+     * @returns The deserialized MatterbridgeDevice.
+     */
     static deserialize(serializedDevice) {
         const device = new MatterbridgeEndpoint(serializedDevice.deviceTypes, { uniqueStorageKey: serializedDevice.endpointName, endpointId: serializedDevice.endpoint }, false);
         device.plugin = serializedDevice.pluginName;
@@ -392,9 +656,16 @@ export class MatterbridgeEndpoint extends Endpoint {
                 device.createDefaultBridgedDeviceBasicInformationClusterServer(serializedDevice.deviceName, serializedDevice.serialNumber, serializedDevice.vendorId ?? 0xfff1, serializedDevice.vendorName ?? 'Matterbridge', serializedDevice.productName ?? 'Matterbridge device');
             else if (clusterId === PowerSource.Cluster.id)
                 device.createDefaultPowerSourceWiredClusterServer();
+            // else addClusterServerFromList(device, [clusterId]);
         }
         return device;
     }
+    /**
+     * Creates a default power source wired cluster server.
+     *
+     * @param wiredCurrentType - The type of wired current (default: PowerSource.WiredCurrentType.Ac)
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultPowerSourceWiredClusterServer(wiredCurrentType = PowerSource.WiredCurrentType.Ac) {
         this.behaviors.require(PowerSourceServer.with(PowerSource.Feature.Wired), {
             wiredCurrentType,
@@ -405,6 +676,16 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * 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).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultPowerSourceReplaceableBatteryClusterServer(batPercentRemaining = 100, batChargeLevel = PowerSource.BatChargeLevel.Ok, batVoltage = 1500, batReplacementDescription = 'Battery type', batQuantity = 1) {
         this.behaviors.require(PowerSourceServer.with(PowerSource.Feature.Battery, PowerSource.Feature.Replaceable), {
             status: PowerSource.PowerSourceStatus.Active,
@@ -422,6 +703,14 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * 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).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultPowerSourceRechargeableBatteryClusterServer(batPercentRemaining = 100, batChargeLevel = PowerSource.BatChargeLevel.Ok, batVoltage = 1500) {
         this.behaviors.require(PowerSourceServer.with(PowerSource.Feature.Battery, PowerSource.Feature.Rechargeable), {
             status: PowerSource.PowerSourceStatus.Active,
@@ -440,6 +729,21 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Setup the default Basic Information Cluster Server attributes for the server node.
+     *
+     * @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'.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultBasicInformationClusterServer(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;
@@ -463,6 +767,22 @@ export class MatterbridgeEndpoint extends Endpoint {
         }
         return this;
     }
+    /**
+     * Creates a default BridgedDeviceBasicInformationClusterServer for the aggregator endpoints.
+     *
+     * @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'.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks The bridgedNode device type must be added to the deviceTypeList of the Descriptor cluster.
+     */
     createDefaultBridgedDeviceBasicInformationClusterServer(deviceName, serialNumber, vendorId, vendorName, productName, softwareVersion = 1, softwareVersionString = '1.0.0', hardwareVersion = 1, hardwareVersionString = '1.0.0') {
         this.log.logName = deviceName;
         this.deviceName = deviceName;
@@ -479,7 +799,7 @@ export class MatterbridgeEndpoint extends Endpoint {
         this.behaviors.require(BridgedDeviceBasicInformationServer.enable({
             events: { leave: true, reachableChanged: true },
         }), {
-            vendorId: vendorId !== undefined ? VendorId(vendorId) : undefined,
+            vendorId: vendorId !== undefined ? VendorId(vendorId) : undefined, // 4874
             vendorName: vendorName.slice(0, 32),
             productName: productName.slice(0, 32),
             productUrl: this.productUrl.slice(0, 256),
@@ -495,6 +815,13 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default identify cluster server with the specified identify time and type.
+     *
+     * @param {number} [identifyTime=0] - The time to identify the server. Defaults to 0.
+     * @param {Identify.IdentifyType} [identifyType=Identify.IdentifyType.None] - The type of identification. Defaults to Identify.IdentifyType.None.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultIdentifyClusterServer(identifyTime = 0, identifyType = Identify.IdentifyType.None) {
         this.behaviors.require(MatterbridgeIdentifyServer, {
             identifyTime,
@@ -502,14 +829,34 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default groups cluster server.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultGroupsClusterServer() {
         this.behaviors.require(GroupsServer);
         return this;
     }
+    /**
+     * Creates a default scenes management cluster server.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks The scenes management cluster server is still provisional and so not yet implemented.
+     */
     createDefaultScenesClusterServer() {
         this.behaviors.require(ScenesManagementServer);
         return this;
     }
+    /**
+     * Creates a default OnOff cluster server for light devices with feature Lighting.
+     *
+     * @param {boolean} [onOff=false] - The initial state of the OnOff cluster.
+     * @param {boolean} [globalSceneControl=false] - The global scene control state.
+     * @param {number} [onTime=0] - The on time value.
+     * @param {number} [offWaitTime=0] - The off wait time value.
+     * @param {OnOff.StartUpOnOff | null} [startUpOnOff=null] - The start-up OnOff state. Null means previous state.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultOnOffClusterServer(onOff = false, globalSceneControl = false, onTime = 0, offWaitTime = 0, startUpOnOff = null) {
         this.behaviors.require(MatterbridgeOnOffServer.with(OnOff.Feature.Lighting), {
             onOff,
@@ -520,24 +867,52 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates an OnOff cluster server without features.
+     *
+     * @param {boolean} [onOff=false] - The initial state of the OnOff cluster.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createOnOffClusterServer(onOff = false) {
         this.behaviors.require(MatterbridgeOnOffServer, {
             onOff,
         });
         return this;
     }
+    /**
+     * Creates a DeadFront OnOff cluster server with feature DeadFrontBehavior.
+     *
+     * @param {boolean} [onOff=false] - The initial state of the OnOff cluster.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDeadFrontOnOffClusterServer(onOff = false) {
         this.behaviors.require(MatterbridgeOnOffServer.with(OnOff.Feature.DeadFrontBehavior), {
             onOff,
         });
         return this;
     }
+    /**
+     * Creates an OffOnly OnOff cluster server with feature OffOnly.
+     *
+     * @param {boolean} [onOff=false] - The initial state of the OnOff cluster.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createOffOnlyOnOffClusterServer(onOff = false) {
         this.behaviors.require(MatterbridgeOnOffServer.with(OnOff.Feature.OffOnly), {
             onOff,
         });
         return this;
     }
+    /**
+     * Creates a default level control cluster server for light devices with feature OnOff and Lighting.
+     *
+     * @param {number} [currentLevel=254] - The current level (default: 254).
+     * @param {number} [minLevel=1] - The minimum level (default: 1).
+     * @param {number} [maxLevel=254] - The maximum level (default: 254).
+     * @param {number | null} [onLevel=null] - The on level (default: null).
+     * @param {number | null} [startUpCurrentLevel=null] - The startUp on level (default: null).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultLevelControlClusterServer(currentLevel = 254, minLevel = 1, maxLevel = 254, onLevel = null, startUpCurrentLevel = null) {
         this.behaviors.require(MatterbridgeLevelControlServer.with(LevelControl.Feature.OnOff, LevelControl.Feature.Lighting), {
             currentLevel,
@@ -553,6 +928,13 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a level control cluster server without features.
+     *
+     * @param {number} [currentLevel=254] - The current level (default: 254).
+     * @param {number | null} [onLevel=null] - The on level (default: null).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createLevelControlClusterServer(currentLevel = 254, onLevel = null) {
         this.behaviors.require(MatterbridgeLevelControlServer, {
             currentLevel,
@@ -564,6 +946,25 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default color control cluster server with features Xy, HueSaturation and ColorTemperature.
+     *
+     * @param currentX - The current X value (range 0-65279).
+     * @param currentY - The current Y value (range 0-65279).
+     * @param currentHue - The current hue value (range: 0-254).
+     * @param currentSaturation - The current saturation value (range: 0-254).
+     * @param colorTemperatureMireds - The color temperature in mireds (default range 147-500).
+     * @param colorTempPhysicalMinMireds - The physical minimum color temperature in mireds (default range 147).
+     * @param colorTempPhysicalMaxMireds - The physical maximum color temperature in mireds (default range 500).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks colorMode and enhancedColorMode persist across restarts.
+     * @remarks currentHue and currentSaturation persist across restarts.
+     * @remarks currentX and currentY persist across restarts.
+     * @remarks colorTemperatureMireds persists across restarts.
+     * @remarks startUpColorTemperatureMireds persists across restarts.
+     * @remarks coupleColorTempToLevelMinMireds persists across restarts.
+     */
     createDefaultColorControlClusterServer(currentX = 0, currentY = 0, currentHue = 0, currentSaturation = 0, colorTemperatureMireds = 500, colorTempPhysicalMinMireds = 147, colorTempPhysicalMaxMireds = 500) {
         this.behaviors.require(MatterbridgeColorControlServer.with(ColorControl.Feature.Xy, ColorControl.Feature.HueSaturation, ColorControl.Feature.ColorTemperature), {
             colorMode: ColorControl.ColorMode.CurrentHueAndCurrentSaturation,
@@ -586,6 +987,25 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a Xy color control cluster server with feature Xy and ColorTemperature.
+     *
+     * @param currentX - The current X value.
+     * @param currentY - The current Y 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.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks
+     * From zigbee to matter = Math.max(Math.min(Math.round(x * 65536), 65279), 0)
+     *
+     * @remarks colorMode and enhancedColorMode persist across restarts.
+     * @remarks currentX and currentY persist across restarts.
+     * @remarks colorTemperatureMireds persists across restarts.
+     * @remarks startUpColorTemperatureMireds persists across restarts.
+     * @remarks coupleColorTempToLevelMinMireds persists across restarts.
+     */
     createXyColorControlClusterServer(currentX = 0, currentY = 0, colorTemperatureMireds = 500, colorTempPhysicalMinMireds = 147, colorTempPhysicalMaxMireds = 500) {
         this.behaviors.require(MatterbridgeColorControlServer.with(ColorControl.Feature.Xy, ColorControl.Feature.ColorTemperature), {
             colorMode: ColorControl.ColorMode.CurrentXAndCurrentY,
@@ -606,6 +1026,22 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default hue and saturation control cluster server with feature HueSaturation and ColorTemperature.
+     *
+     * @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.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks colorMode and enhancedColorMode persist across restarts.
+     * @remarks currentHue and currentSaturation persist across restarts.
+     * @remarks colorTemperatureMireds persists across restarts.
+     * @remarks startUpColorTemperatureMireds persists across restarts.
+     * @remarks coupleColorTempToLevelMinMireds persists across restarts.
+     */
     createHsColorControlClusterServer(currentHue = 0, currentSaturation = 0, colorTemperatureMireds = 500, colorTempPhysicalMinMireds = 147, colorTempPhysicalMaxMireds = 500) {
         this.behaviors.require(MatterbridgeColorControlServer.with(ColorControl.Feature.HueSaturation, ColorControl.Feature.ColorTemperature), {
             colorMode: ColorControl.ColorMode.CurrentHueAndCurrentSaturation,
@@ -626,6 +1062,20 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a color temperature color control cluster server with feature ColorTemperature.
+     * This cluster server is used for devices that only support color temperature control.
+     *
+     * @param colorTemperatureMireds - The color temperature in mireds. Defaults to 250.
+     * @param colorTempPhysicalMinMireds - The physical minimum color temperature in mireds. Defaults to 147.
+     * @param colorTempPhysicalMaxMireds - The physical maximum color temperature in mireds. Defaults to 500.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks colorMode and enhancedColorMode persist across restarts.
+     * @remarks colorTemperatureMireds persists across restarts.
+     * @remarks startUpColorTemperatureMireds persists across restarts.
+     * @remarks coupleColorTempToLevelMinMireds persists across restarts.
+     */
     createCtColorControlClusterServer(colorTemperatureMireds = 250, colorTempPhysicalMinMireds = 147, colorTempPhysicalMaxMireds = 500) {
         this.behaviors.require(MatterbridgeColorControlServer.with(ColorControl.Feature.ColorTemperature), {
             colorMode: ColorControl.ColorMode.ColorTemperatureMireds,
@@ -644,15 +1094,34 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Configures the color control mode for the device.
+     *
+     * @param {ColorControl.ColorMode} colorMode - The color mode to set.
+     *
+     * @remarks colorMode and enhancedColorMode persist across restarts.
+     */
     async configureColorControlMode(colorMode) {
         if (isValidNumber(colorMode, ColorControl.ColorMode.CurrentHueAndCurrentSaturation, ColorControl.ColorMode.ColorTemperatureMireds)) {
             await this.setAttribute(ColorControl.Cluster.id, 'colorMode', colorMode, this.log);
             await this.setAttribute(ColorControl.Cluster.id, 'enhancedColorMode', colorMode, this.log);
         }
     }
+    /**
+     * Creates a default window covering cluster server with feature Lift and PositionAwareLift.
+     *
+     * @param {number} positionPercent100ths - The position percentage in 100ths (0-10000). Defaults to 0. Matter uses 10000 = fully closed 0 = fully opened.
+     * @param {WindowCovering.WindowCoveringType} type - The type of window covering (default: WindowCovering.WindowCoveringType.Rollershade). Must support feature Lift.
+     * @param {WindowCovering.EndProductType} endProductType - The end product type (default: WindowCovering.EndProductType.RollerShade). Must support feature Lift.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks mode attributes is writable and persists across restarts.
+     * currentPositionLiftPercent100ths persists across restarts.
+     * configStatus attributes persists across restarts.
+     */
     createDefaultWindowCoveringClusterServer(positionPercent100ths, type = WindowCovering.WindowCoveringType.Rollershade, endProductType = WindowCovering.EndProductType.RollerShade) {
         this.behaviors.require(MatterbridgeLiftWindowCoveringServer.with(WindowCovering.Feature.Lift, WindowCovering.Feature.PositionAwareLift), {
-            type,
+            type, // Must support feature Lift
             numberOfActuationsLift: 0,
             configStatus: {
                 operational: true,
@@ -660,20 +1129,33 @@ export class MatterbridgeEndpoint extends Endpoint {
                 liftMovementReversed: false,
                 liftPositionAware: true,
                 tiltPositionAware: false,
-                liftEncoderControlled: false,
-                tiltEncoderControlled: false,
+                liftEncoderControlled: false, // 0 = Timer Controlled 1 = Encoder Controlled
+                tiltEncoderControlled: false, // 0 = Timer Controlled 1 = Encoder Controlled
             },
             operationalStatus: { global: WindowCovering.MovementStatus.Stopped, lift: WindowCovering.MovementStatus.Stopped, tilt: WindowCovering.MovementStatus.Stopped },
-            endProductType,
+            endProductType, // Must support feature Lift
             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
         });
         return this;
     }
+    /**
+     * Creates a default window covering cluster server with features Lift, PositionAwareLift, Tilt, PositionAwareTilt.
+     *
+     * @param {number} positionLiftPercent100ths - The lift position percentage in 100ths (0-10000). Defaults to 0. Matter uses 10000 = fully closed 0 = fully opened.
+     * @param {number} positionTiltPercent100ths - The tilt position percentage in 100ths (0-10000). Defaults to 0. Matter uses 10000 = fully closed 0 = fully opened.
+     * @param {WindowCovering.WindowCoveringType} type - The type of window covering (default: WindowCovering.WindowCoveringType.TiltBlindLift). Must support features Lift and Tilt.
+     * @param {WindowCovering.EndProductType} endProductType - The end product type (default: WindowCovering.EndProductType.InteriorBlind). Must support features Lift and Tilt.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks mode attributes is writable and persists across restarts.
+     * currentPositionTiltPercent100ths persists across restarts.
+     * configStatus attributes persists across restarts.
+     */
     createDefaultLiftTiltWindowCoveringClusterServer(positionLiftPercent100ths, positionTiltPercent100ths, type = WindowCovering.WindowCoveringType.TiltBlindLift, endProductType = WindowCovering.EndProductType.InteriorBlind) {
         this.behaviors.require(MatterbridgeLiftTiltWindowCoveringServer.with(WindowCovering.Feature.Lift, WindowCovering.Feature.PositionAwareLift, WindowCovering.Feature.Tilt, WindowCovering.Feature.PositionAwareTilt), {
-            type,
+            type, // Must support features Lift and Tilt
             numberOfActuationsLift: 0,
             numberOfActuationsTilt: 0,
             configStatus: {
@@ -682,19 +1164,23 @@ export class MatterbridgeEndpoint extends Endpoint {
                 liftMovementReversed: false,
                 liftPositionAware: true,
                 tiltPositionAware: true,
-                liftEncoderControlled: false,
-                tiltEncoderControlled: false,
+                liftEncoderControlled: false, // 0 = Timer Controlled 1 = Encoder Controlled
+                tiltEncoderControlled: false, // 0 = Timer Controlled 1 = Encoder Controlled
             },
             operationalStatus: { global: WindowCovering.MovementStatus.Stopped, lift: WindowCovering.MovementStatus.Stopped, tilt: WindowCovering.MovementStatus.Stopped },
-            endProductType,
+            endProductType, // Must support features Lift and Tilt
             mode: { motorDirectionReversed: false, calibrationMode: false, maintenanceMode: false, ledFeedback: false },
-            targetPositionLiftPercent100ths: positionLiftPercent100ths ?? 0,
-            currentPositionLiftPercent100ths: positionLiftPercent100ths ?? 0,
-            targetPositionTiltPercent100ths: positionTiltPercent100ths ?? 0,
-            currentPositionTiltPercent100ths: positionTiltPercent100ths ?? 0,
+            targetPositionLiftPercent100ths: positionLiftPercent100ths ?? 0, // 0 Fully open 10000 fully closed
+            currentPositionLiftPercent100ths: positionLiftPercent100ths ?? 0, // 0 Fully open 10000 fully closed
+            targetPositionTiltPercent100ths: positionTiltPercent100ths ?? 0, // 0 Fully open 10000 fully closed
+            currentPositionTiltPercent100ths: positionTiltPercent100ths ?? 0, // 0 Fully open 10000 fully closed
         });
         return this;
     }
+    /**
+     * Sets the window covering lift target position as the current position and stops the movement.
+     *
+     */
     async setWindowCoveringTargetAsCurrentAndStopped() {
         const position = this.getAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', this.log);
         if (isValidNumber(position, 0, 10000)) {
@@ -714,6 +1200,12 @@ export class MatterbridgeEndpoint extends Endpoint {
             this.log.debug(`Set WindowCovering currentPositionTiltPercent100ths and targetPositionTiltPercent100ths to ${position} and operationalStatus to Stopped.`);
         }
     }
+    /**
+     * Sets the lift current and target position and the 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.
+     */
     async setWindowCoveringCurrentTargetStatus(current, target, status) {
         await this.setAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', current, this.log);
         await this.setAttribute(WindowCovering.Cluster.id, 'targetPositionLiftPercent100ths', target, this.log);
@@ -724,6 +1216,10 @@ export class MatterbridgeEndpoint extends Endpoint {
         }, this.log);
         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.
+     */
     async setWindowCoveringStatus(status) {
         await this.setAttribute(WindowCovering.Cluster.id, 'operationalStatus', {
             global: status,
@@ -732,6 +1228,11 @@ export class MatterbridgeEndpoint extends Endpoint {
         }, this.log);
         this.log.debug(`Set WindowCovering operationalStatus: ${status}`);
     }
+    /**
+     * Retrieves the status of the window covering.
+     *
+     * @returns The global operational status of the window covering or undefined.
+     */
     getWindowCoveringStatus() {
         const status = this.getAttribute(WindowCovering.Cluster.id, 'operationalStatus', this.log);
         if (isValidObject(status, 3) && 'global' in status && typeof status.global === 'number') {
@@ -739,6 +1240,12 @@ export class MatterbridgeEndpoint extends Endpoint {
             return status.global;
         }
     }
+    /**
+     * Sets the lift target and current position of the window covering.
+     *
+     * @param {number} liftPosition - The position to set, specified as a number.
+     * @param {number} [tiltPosition] - The tilt position to set, specified as a number.
+     */
     async setWindowCoveringTargetAndCurrentPosition(liftPosition, tiltPosition) {
         await this.setAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', liftPosition, this.log);
         await this.setAttribute(WindowCovering.Cluster.id, 'targetPositionLiftPercent100ths', liftPosition, this.log);
@@ -749,31 +1256,56 @@ export class MatterbridgeEndpoint extends Endpoint {
             this.log.debug(`Set WindowCovering currentPositionTiltPercent100ths: ${tiltPosition} and targetPositionTiltPercent100ths: ${tiltPosition}.`);
         }
     }
+    /**
+     * Creates a default thermostat cluster server with features Heating, Cooling and AutoMode.
+     *
+     * @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 {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultThermostatClusterServer(localTemperature = 23, occupiedHeatingSetpoint = 21, occupiedCoolingSetpoint = 25, minSetpointDeadBand = 1, minHeatSetpointLimit = 0, maxHeatSetpointLimit = 50, minCoolSetpointLimit = 0, maxCoolSetpointLimit = 50) {
         this.behaviors.require(MatterbridgeThermostatServer.with(Thermostat.Feature.Heating, Thermostat.Feature.Cooling, Thermostat.Feature.AutoMode), {
             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,
         });
         return this;
     }
+    /**
+     * Creates a default heating thermostat cluster server with feature Heating.
+     * @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 {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultHeatingThermostatClusterServer(localTemperature = 23, occupiedHeatingSetpoint = 21, minHeatSetpointLimit = 0, maxHeatSetpointLimit = 50) {
         this.behaviors.require(MatterbridgeThermostatServer.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,
@@ -782,11 +1314,20 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default cooling thermostat cluster server with feature Cooling.
+     * @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 {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultCoolingThermostatClusterServer(localTemperature = 23, occupiedCoolingSetpoint = 25, minCoolSetpointLimit = 0, maxCoolSetpointLimit = 50) {
         this.behaviors.require(MatterbridgeThermostatServer.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,
@@ -795,6 +1336,15 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default thermostat user interface configuration cluster server.
+     *
+     * @remarks
+     * The default values are:
+     * - temperatureDisplayMode: ThermostatUserInterfaceConfiguration.TemperatureDisplayMode.Celsius (writeble).
+     * - keypadLockout: ThermostatUserInterfaceConfiguration.KeypadLockout.NoLockout (writeble).
+     * - scheduleProgrammingVisibility: ThermostatUserInterfaceConfiguration.ScheduleProgrammingVisibility.ScheduleProgrammingPermitted (writeble).
+     */
     createDefaultThermostatUserInterfaceConfigurationClusterServer() {
         this.behaviors.require(ThermostatUserInterfaceConfigurationServer, {
             temperatureDisplayMode: ThermostatUserInterfaceConfiguration.TemperatureDisplayMode.Celsius,
@@ -803,6 +1353,17 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default fan control cluster server with features MultiSpeed, Auto, and Step.
+     *
+     * @param {FanControl.FanMode} [fanMode=FanControl.FanMode.Off] - The fan mode to set. Defaults to `FanControl.FanMode.Off`.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks
+     * fanmode is writable and persists across reboots.
+     * percentSetting is writable.
+     * speedSetting is writable.
+     */
     createDefaultFanControlClusterServer(fanMode = FanControl.FanMode.Off) {
         this.behaviors.require(MatterbridgeFanControlServer.with(FanControl.Feature.MultiSpeed, FanControl.Feature.Auto, FanControl.Feature.Step), {
             fanMode,
@@ -815,6 +1376,16 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a base fan control cluster server without features.
+     *
+     * @param {FanControl.FanMode} [fanMode=FanControl.FanMode.Off] - The fan mode to set. Defaults to `FanControl.FanMode.Off`.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks
+     * fanmode is writable and persists across reboots.
+     * percentSetting is writable.
+     */
     createBaseFanControlClusterServer(fanMode = FanControl.FanMode.Off) {
         this.behaviors.require(FanControlServer, {
             fanMode,
@@ -824,39 +1395,81 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default HEPA Filter Monitoring Cluster Server with features Condition and ReplacementProductList.
+     * It supports ResourceMonitoring.Feature.Condition and ResourceMonitoring.Feature.ReplacementProductList.
+     *
+     * @param {ResourceMonitoring.ChangeIndication} changeIndication - The initial change indication. Default is ResourceMonitoring.ChangeIndication.Ok.
+     * @param {boolean | undefined} inPlaceIndicator - The in-place indicator. Default is undefined.
+     * @param {number | undefined} lastChangedTime - The last changed time (EpochS). Default is undefined.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultHepaFilterMonitoringClusterServer(changeIndication = ResourceMonitoring.ChangeIndication.Ok, inPlaceIndicator = undefined, lastChangedTime = undefined) {
         this.behaviors.require(HepaFilterMonitoringServer.with(ResourceMonitoring.Feature.Condition, ResourceMonitoring.Feature.ReplacementProductList), {
-            condition: 100,
-            degradationDirection: ResourceMonitoring.DegradationDirection.Down,
+            condition: 100, // Feature.Condition
+            degradationDirection: ResourceMonitoring.DegradationDirection.Down, // Feature.Condition
             changeIndication,
             inPlaceIndicator,
             lastChangedTime,
-            replacementProductList: [],
+            replacementProductList: [], // Feature.ReplacementProductList
         });
         return this;
     }
+    /**
+     * Creates a default Activated Carbon Filter Monitoring Cluster Server with features Condition and ReplacementProductList.
+     *
+     * @param {ResourceMonitoring.ChangeIndication} changeIndication - The initial change indication. Default is ResourceMonitoring.ChangeIndication.Ok.
+     * @param {boolean | undefined} inPlaceIndicator - The in-place indicator. Default is undefined.
+     * @param {number | undefined} lastChangedTime - The last changed time (EpochS). Default is undefined.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultActivatedCarbonFilterMonitoringClusterServer(changeIndication = ResourceMonitoring.ChangeIndication.Ok, inPlaceIndicator = undefined, lastChangedTime = undefined) {
         this.behaviors.require(ActivatedCarbonFilterMonitoringServer.with(ResourceMonitoring.Feature.Condition, ResourceMonitoring.Feature.ReplacementProductList), {
-            condition: 100,
-            degradationDirection: ResourceMonitoring.DegradationDirection.Down,
+            condition: 100, // Feature.Condition
+            degradationDirection: ResourceMonitoring.DegradationDirection.Down, // Feature.Condition
             changeIndication,
             inPlaceIndicator,
             lastChangedTime,
-            replacementProductList: [],
+            replacementProductList: [], // Feature.ReplacementProductList
         });
         return this;
     }
+    /**
+     * Creates a default door lock cluster server.
+     *
+     * @param {DoorLock.LockState} [lockState=DoorLock.LockState.Locked] - The initial state of the lock (default: Locked).
+     * @param {DoorLock.LockType} [lockType=DoorLock.LockType.DeadBolt] - The type of the lock (default: DeadBolt).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks
+     * All operating modes NOT supported by a lock SHALL be set to one. The value of the OperatingMode enumeration defines the related bit to be set.
+     */
     createDefaultDoorLockClusterServer(lockState = DoorLock.LockState.Locked, lockType = DoorLock.LockType.DeadBolt) {
         this.behaviors.require(MatterbridgeDoorLockServer.enable({ events: { doorLockAlarm: true, lockOperation: true, lockOperationError: true } }), {
             lockState,
             lockType,
             actuatorEnabled: false,
             operatingMode: DoorLock.OperatingMode.Normal,
+            // Special case of inverted bitmap: add also alwaysSet = 2047
             supportedOperatingModes: { normal: false, vacation: true, privacy: true, noRemoteLockUnlock: true, passage: true, alwaysSet: 2047 },
             alarmMask: { lockJammed: false, lockFactoryReset: false, lockRadioPowerCycled: false, wrongCodeEntryLimit: false, frontEscutcheonRemoved: false, doorForcedOpen: false },
         });
         return this;
     }
+    /**
+     * Creates a default Mode Select cluster server.
+     *
+     * @param {string} description - The description of the mode select cluster.
+     * @param {ModeSelect.ModeOption[]} supportedModes - The list of supported modes.
+     * @param {number} [currentMode=0] - The current mode (default: 0).
+     * @param {number} [startUpMode=0] - The startup mode (default: 0).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks
+     * endpoint.createDefaultModeSelectClusterServer('Night mode', [{ label: 'Led ON', mode: 0, semanticTags: [] }, { label: 'Led OFF', mode: 1, semanticTags: [] }], 0, 0);
+     */
     createDefaultModeSelectClusterServer(description, supportedModes, currentMode = 0, startUpMode = 0) {
         this.behaviors.require(MatterbridgeModeSelectServer, {
             description: description,
@@ -867,6 +1480,13 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates the default Valve Configuration And Control cluster server with features Level.
+     *
+     * @param {ValveConfigurationAndControl.ValveState} [valveState=ValveConfigurationAndControl.ValveState.Closed] - The valve state to set. Defaults to `ValveConfigurationAndControl.ValveState.Closed`.
+     * @param {number} [valveLevel=0] - The valve level to set. Defaults to 0.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultValveConfigurationAndControlClusterServer(valveState = ValveConfigurationAndControl.ValveState.Closed, valveLevel = 0) {
         this.behaviors.require(MatterbridgeValveConfigurationAndControlServer.with(ValveConfigurationAndControl.Feature.Level), {
             currentState: valveState,
@@ -882,6 +1502,12 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates the default PumpConfigurationAndControl cluster server with features ConstantSpeed.
+     *
+     * @param {PumpConfigurationAndControl.OperationMode} [pumpMode=PumpConfigurationAndControl.OperationMode.Normal] - The pump mode to set. Defaults to `PumpConfigurationAndControl.OperationMode.Normal`.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultPumpConfigurationAndControlClusterServer(pumpMode = PumpConfigurationAndControl.OperationMode.Normal) {
         this.behaviors.require(PumpConfigurationAndControlServer.with(PumpConfigurationAndControl.Feature.ConstantSpeed), {
             minConstSpeed: null,
@@ -896,6 +1522,13 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates the default SmokeCOAlarm Cluster Server with features SmokeAlarm and CoAlarm.
+     *
+     * @param {SmokeCoAlarm.AlarmState} smokeState - The state of the smoke alarm. Defaults to SmokeCoAlarm.AlarmState.Normal.
+     * @param {SmokeCoAlarm.AlarmState} coState - The state of the CO alarm. Defaults to SmokeCoAlarm.AlarmState.Normal.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultSmokeCOAlarmClusterServer(smokeState = SmokeCoAlarm.AlarmState.Normal, coState = SmokeCoAlarm.AlarmState.Normal) {
         this.behaviors.require(MatterbridgeSmokeCoAlarmServer.with(SmokeCoAlarm.Feature.SmokeAlarm, SmokeCoAlarm.Feature.CoAlarm).enable({
             events: { smokeAlarm: true, interconnectSmokeAlarm: false, coAlarm: true, interconnectCoAlarm: false, lowBattery: true, hardwareFault: true, endOfService: true, selfTestComplete: true, alarmMuted: true, muteEnded: true, allClear: true },
@@ -911,6 +1544,12 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a smoke only SmokeCOAlarm Cluster Server with features SmokeAlarm.
+     *
+     * @param {SmokeCoAlarm.AlarmState} smokeState - The state of the smoke alarm. Defaults to SmokeCoAlarm.AlarmState.Normal.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createSmokeOnlySmokeCOAlarmClusterServer(smokeState = SmokeCoAlarm.AlarmState.Normal) {
         this.behaviors.require(MatterbridgeSmokeCoAlarmServer.with(SmokeCoAlarm.Feature.SmokeAlarm).enable({
             events: { smokeAlarm: true, interconnectSmokeAlarm: false, coAlarm: false, interconnectCoAlarm: false, lowBattery: true, hardwareFault: true, endOfService: true, selfTestComplete: true, alarmMuted: true, muteEnded: true, allClear: true },
@@ -925,6 +1564,12 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a co only SmokeCOAlarm Cluster Server with features CoAlarm.
+     *
+     * @param {SmokeCoAlarm.AlarmState} coState - The state of the CO alarm. Defaults to SmokeCoAlarm.AlarmState.Normal.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createCoOnlySmokeCOAlarmClusterServer(coState = SmokeCoAlarm.AlarmState.Normal) {
         this.behaviors.require(MatterbridgeSmokeCoAlarmServer.with(SmokeCoAlarm.Feature.CoAlarm).enable({
             events: { smokeAlarm: false, interconnectSmokeAlarm: false, coAlarm: true, interconnectCoAlarm: false, lowBattery: true, hardwareFault: true, endOfService: true, selfTestComplete: true, alarmMuted: true, muteEnded: true, allClear: true },
@@ -939,6 +1584,13 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default momentary switch cluster server with features MomentarySwitch, MomentarySwitchRelease, MomentarySwitchLongPress and MomentarySwitchMultiPress.
+     *
+     * @remarks
+     * This method adds a cluster server with default momentary switch features and configuration suitable for (AppleHome) Single Double Long automations.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultSwitchClusterServer() {
         this.behaviors.require(MatterbridgeSwitchServer.with(Switch.Feature.MomentarySwitch, Switch.Feature.MomentarySwitchRelease, Switch.Feature.MomentarySwitchLongPress, Switch.Feature.MomentarySwitchMultiPress).enable({
             events: { initialPress: true, longPress: true, shortRelease: true, longRelease: true, multiPressOngoing: true, multiPressComplete: true },
@@ -949,6 +1601,13 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default latching switch cluster server with features LatchingSwitch.
+     *
+     * @remarks
+     * This method adds a cluster server with default latching switch features and configuration suitable for a latching switch with 2 positions.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultLatchingSwitchClusterServer() {
         this.behaviors.require(SwitchServer.with(Switch.Feature.LatchingSwitch).enable({
             events: { switchLatched: true },
@@ -958,6 +1617,13 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * 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 {boolean} - A boolean indicating whether the event was successfully triggered.
+     */
     async triggerSwitchEvent(event, log) {
         if (this.maybeNumber === undefined) {
             this.log.error(`triggerSwitchEvent ${event} error: Endpoint number not assigned on endpoint ${this.maybeId}:${this.maybeNumber}`);
@@ -1017,10 +1683,30 @@ export class MatterbridgeEndpoint extends Endpoint {
         }
         return true;
     }
+    /**
+     * Creates a default OperationalState Cluster Server.
+     *
+     * @param {OperationalState.OperationalStateEnum} operationalState - The initial operational state.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultOperationalStateClusterServer(operationalState = OperationalState.OperationalStateEnum.Stopped) {
         this.behaviors.require(MatterbridgeOperationalStateServer, getDefaultOperationalStateClusterServer(operationalState));
         return this;
     }
+    /**
+     * Creates a default boolean state cluster server.
+     * The stateChange event is enabled.
+     *
+     * @param {boolean} contact - The state of the cluster. Defaults to true (true = contact).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks
+     * Water Leak Detector: true = leak, false = no leak
+     * Water Freeze Detector: true = freeze, false = no freeze
+     * Rain Sensor: true = rain, false = no rain
+     * Contact Sensor: true = closed or contact, false = open or no contact
+     */
     createDefaultBooleanStateClusterServer(contact) {
         this.behaviors.require(BooleanStateServer.enable({
             events: { stateChange: true },
@@ -1029,6 +1715,23 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default boolean state configuration cluster server to be used with the waterFreezeDetector, waterLeakDetector, and rainSensor device types.
+     *
+     * Features:
+     * - Visual
+     * - Audible
+     * - SensitivityLevel
+     *
+     * @remarks Supports the enableDisableAlarm command.
+     *
+     * @param {boolean} [sensorFault=false] - Optional boolean value indicating the sensor fault state. Defaults to `false` if not provided.
+     * @param {number} [currentSensitivityLevel=0] - The current sensitivity level. Defaults to `0` if not provided.
+     * @param {number} [supportedSensitivityLevels=2] - The number of supported sensitivity levels. Defaults to `2` if not provided (min 2, max 10).
+     * @param {number} [defaultSensitivityLevel=0] - The default sensitivity level. Defaults to `0` if not provided.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     */
     createDefaultBooleanStateConfigurationClusterServer(sensorFault = false, currentSensitivityLevel = 0, supportedSensitivityLevels = 2, defaultSensitivityLevel = 0) {
         this.behaviors.require(MatterbridgeBooleanStateConfigurationServer.with(BooleanStateConfiguration.Feature.Visual, BooleanStateConfiguration.Feature.Audible, BooleanStateConfiguration.Feature.SensitivityLevel).enable({
             events: { alarmsStateChanged: true, sensorFault: true },
@@ -1043,9 +1746,14 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default Device Energy Management Cluster Server with feature PowerForecastReporting. Only needed for an evse device type.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultDeviceEnergyManagementCluster() {
         this.behaviors.require(DeviceEnergyManagementServer.with(DeviceEnergyManagement.Feature.PowerForecastReporting), {
-            forecast: null,
+            forecast: null, // A null value indicates that there is no forecast currently available
             esaType: DeviceEnergyManagement.EsaType.Other,
             esaCanGenerate: false,
             esaState: DeviceEnergyManagement.EsaState.Offline,
@@ -1054,6 +1762,21 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default EnergyManagementMode Cluster Server.
+     *
+     * A few examples of Device Energy Management modes and their mode tags are provided below.
+     *  - For the "No Energy Management (Forecast reporting only)" mode, tags: 0x4000 (NoOptimization).
+     *  - For the "Device Energy Management" mode, tags: 0x4001 (DeviceOptimization).
+     *  - For the "Home Energy Management" mode, tags: 0x4001 (DeviceOptimization), 0x4002 (LocalOptimization).
+     *  - For the "Grid Energy Management" mode, tags: 0x4003 (GridOptimization).
+     *  - For the "Full Energy Management" mode, tags: 0x4001 (DeviceOptimization), 0x4002 (LocalOptimization), 0x4003 (GridOptimization).
+     *
+     * @param {number} [currentMode] - The current mode of the EnergyManagementMode cluster. Defaults to mode 1 (DeviceEnergyManagementMode.ModeTag.NoOptimization).
+     * @param {EnergyManagementMode.ModeOption[]} [supportedModes] - The supported modes for the DeviceEnergyManagementMode cluster. Defaults all cluster modes.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultDeviceEnergyManagementModeCluster(currentMode, supportedModes) {
         this.behaviors.require(MatterbridgeDeviceEnergyManagementModeServer, {
             supportedModes: supportedModes ?? [
@@ -1079,10 +1802,21 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default Power Topology Cluster Server with feature TreeTopology. Only needed for an electricalSensor device type.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultPowerTopologyClusterServer() {
         this.behaviors.require(PowerTopologyServer.with(PowerTopology.Feature.TreeTopology));
         return this;
     }
+    /**
+     * Creates a default Electrical Energy Measurement Cluster Server with features ImportedEnergy, ExportedEnergy, and CumulativeEnergy.
+     *
+     * @param {number} energy - The total consumption value in mW/h.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultElectricalEnergyMeasurementClusterServer(energy = null) {
         this.behaviors.require(ElectricalEnergyMeasurementServer.with(ElectricalEnergyMeasurement.Feature.ImportedEnergy, ElectricalEnergyMeasurement.Feature.ExportedEnergy, ElectricalEnergyMeasurement.Feature.CumulativeEnergy), {
             accuracy: {
@@ -1098,6 +1832,15 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default Electrical Power Measurement Cluster Server with features AlternatingCurrent.
+     *
+     * @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 {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultElectricalPowerMeasurementClusterServer(voltage = null, current = null, power = null, frequency = null) {
         this.behaviors.require(ElectricalPowerMeasurementServer.with(ElectricalPowerMeasurement.Feature.AlternatingCurrent), {
             powerMode: ElectricalPowerMeasurement.PowerMode.Ac,
@@ -1139,36 +1882,113 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default TemperatureMeasurement cluster server.
+     *
+     * @param {number | null} measuredValue - The measured value of the temperature x 100.
+     * @param {number | null} minMeasuredValue - The minimum measured value of the temperature x 100.
+     * @param {number | null} maxMeasuredValue - The maximum measured value of the temperature x 100.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultTemperatureMeasurementClusterServer(measuredValue = null, minMeasuredValue = null, maxMeasuredValue = null) {
         this.behaviors.require(TemperatureMeasurementServer, getDefaultTemperatureMeasurementClusterServer(measuredValue, minMeasuredValue, maxMeasuredValue));
         return this;
     }
+    /**
+     * Creates a default RelativeHumidityMeasurement cluster server.
+     *
+     * @param {number | null} measuredValue - The measured value of the relative humidity x 100.
+     * @param {number | null} minMeasuredValue - The minimum measured value of the relative humidity x 100.
+     * @param {number | null} maxMeasuredValue - The maximum measured value of the relative humidity x 100.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultRelativeHumidityMeasurementClusterServer(measuredValue = null, minMeasuredValue = null, maxMeasuredValue = null) {
         this.behaviors.require(RelativeHumidityMeasurementServer, getDefaultRelativeHumidityMeasurementClusterServer(measuredValue, minMeasuredValue, maxMeasuredValue));
         return this;
     }
+    /**
+     * Creates a default PressureMeasurement cluster server.
+     *
+     * @param {number | null} measuredValue - The measured value for the pressure.
+     * @param {number | null} minMeasuredValue - The minimum measured value for the pressure.
+     * @param {number | null} maxMeasuredValue - The maximum measured value for the pressure.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultPressureMeasurementClusterServer(measuredValue = null, minMeasuredValue = null, maxMeasuredValue = null) {
         this.behaviors.require(PressureMeasurementServer, getDefaultPressureMeasurementClusterServer(measuredValue, minMeasuredValue, maxMeasuredValue));
         return this;
     }
+    /**
+     * Creates a default IlluminanceMeasurement cluster server.
+     *
+     * @param {number | null} measuredValue - The measured value of illuminance.
+     * @param {number | null} minMeasuredValue - The minimum measured value of illuminance.
+     * @param {number | null} maxMeasuredValue - The maximum measured value of illuminance.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remark The default value for the illuminance measurement is null.
+     * This attribute SHALL indicate the illuminance in Lux (symbol lx) as follows:
+     * •  MeasuredValue = 10,000 x log10(illuminance) + 1,
+     *    where 1 lx <= illuminance <= 3.576 Mlx, corresponding to a MeasuredValue in the range 1 to 0xFFFE.
+     * • 0 indicates a value of illuminance that is too low to be measured
+     * • null indicates that the illuminance measurement is invalid.
+     *
+     * @remarks
+     * Lux to matter = Math.round(Math.max(Math.min(10000 * Math.log10(lux), 0xfffe), 0))
+     * Matter to Lux = Math.round(Math.max(Math.pow(10, value / 10000), 0))
+     */
     createDefaultIlluminanceMeasurementClusterServer(measuredValue = null, minMeasuredValue = null, maxMeasuredValue = null) {
         this.behaviors.require(IlluminanceMeasurementServer, getDefaultIlluminanceMeasurementClusterServer(measuredValue, minMeasuredValue, maxMeasuredValue));
         return this;
     }
+    /**
+     * Creates a default FlowMeasurement cluster server.
+     *
+     * @param {number | null} measuredValue - The measured value of the flow in 10 x m3/h.
+     * @param {number | null} minMeasuredValue - The minimum measured value of the flow in 10 x m3/h.
+     * @param {number | null} maxMeasuredValue - The maximum measured value of the flow in 10 x m3/h.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultFlowMeasurementClusterServer(measuredValue = null, minMeasuredValue = null, maxMeasuredValue = null) {
         this.behaviors.require(FlowMeasurementServer, getDefaultFlowMeasurementClusterServer(measuredValue, minMeasuredValue, maxMeasuredValue));
         return this;
     }
+    /**
+     * Creates a default OccupancySensing cluster server with feature PassiveInfrared.
+     *
+     * @param {boolean} occupied - A boolean indicating whether the occupancy is occupied or not. Default is false.
+     * @param {number} holdTime - The hold time in seconds. Default is 30.
+     * @param {number} holdTimeMin - The minimum hold time in seconds. Default is 1.
+     * @param {number} holdTimeMax - The maximum hold time in seconds. Default is 300.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remark The default value for the occupancy sensor type is PIR.
+     */
     createDefaultOccupancySensingClusterServer(occupied = false, holdTime = 30, holdTimeMin = 1, holdTimeMax = 300) {
         this.behaviors.require(OccupancySensingServer.with(OccupancySensing.Feature.PassiveInfrared), getDefaultOccupancySensingClusterServer(occupied, holdTime, holdTimeMin, holdTimeMax));
         return this;
     }
+    /**
+     * Creates a default AirQuality cluster server.
+     *
+     * @param {AirQuality.AirQualityEnum} airQuality The air quality level. Defaults to `AirQuality.AirQualityType.Unknown`.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultAirQualityClusterServer(airQuality = AirQuality.AirQualityEnum.Unknown) {
         this.behaviors.require(AirQualityServer.with(AirQuality.Feature.Fair, AirQuality.Feature.Moderate, AirQuality.Feature.VeryPoor, AirQuality.Feature.ExtremelyPoor), {
             airQuality,
         });
         return this;
     }
+    /**
+     * Creates a default TotalVolatileOrganicCompoundsConcentrationMeasurement cluster server with feature NumericMeasurement.
+     *
+     * @param {number | null} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement (default to ConcentrationMeasurement.MeasurementUnit.Ppm).
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The unit of measurement (default to ConcentrationMeasurement.MeasurementMedium.Air).
+     * @param {number} [uncertainty] - The uncertainty value (optional).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultTvocMeasurementClusterServer(measuredValue = null, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air, uncertainty) {
         this.behaviors.require(TotalVolatileOrganicCompoundsConcentrationMeasurementServer.with(ConcentrationMeasurement.Feature.NumericMeasurement), {
             measuredValue,
@@ -1180,6 +2000,13 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Creates a default TotalVolatileOrganicCompoundsConcentrationMeasurement cluster server with feature LevelIndication.
+  
+    * @param {ConcentrationMeasurement.LevelValue} levelValue - The level value of the measurement (default to ConcentrationMeasurement.LevelValue.Unknown).
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The measurement medium (default to ConcentrationMeasurement.MeasurementMedium.Air).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createLevelTvocMeasurementClusterServer(levelValue = ConcentrationMeasurement.LevelValue.Unknown, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.behaviors.require(TotalVolatileOrganicCompoundsConcentrationMeasurementServer.with(ConcentrationMeasurement.Feature.LevelIndication, ConcentrationMeasurement.Feature.MediumLevel, ConcentrationMeasurement.Feature.CriticalLevel), {
             levelValue,
@@ -1187,6 +2014,14 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Create a default CarbonMonoxideConcentrationMeasurement cluster server with feature NumericMeasurement.
+     *
+     * @param {number | null} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement (default to ConcentrationMeasurement.MeasurementUnit.Ppm).
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The unit of measurement (default to ConcentrationMeasurement.MeasurementMedium.Air).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultCarbonMonoxideConcentrationMeasurementClusterServer(measuredValue = null, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.behaviors.require(CarbonMonoxideConcentrationMeasurementServer.with(ConcentrationMeasurement.Feature.NumericMeasurement), {
             measuredValue,
@@ -1198,6 +2033,14 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Create a default CarbonDioxideConcentrationMeasurement cluster server with feature NumericMeasurement.
+     *
+     * @param {number | null} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement (default to ConcentrationMeasurement.MeasurementUnit.Ppm).
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The unit of measurement (default to ConcentrationMeasurement.MeasurementMedium.Air).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultCarbonDioxideConcentrationMeasurementClusterServer(measuredValue = null, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.behaviors.require(CarbonDioxideConcentrationMeasurementServer.with(ConcentrationMeasurement.Feature.NumericMeasurement), {
             measuredValue,
@@ -1209,6 +2052,14 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Create a default FormaldehydeConcentrationMeasurement cluster server with feature NumericMeasurement.
+     *
+     * @param {number | null} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement (default to ConcentrationMeasurement.MeasurementUnit.Ppm).
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The unit of measurement (default to ConcentrationMeasurement.MeasurementMedium.Air).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultFormaldehydeConcentrationMeasurementClusterServer(measuredValue = null, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.behaviors.require(FormaldehydeConcentrationMeasurementServer.with(ConcentrationMeasurement.Feature.NumericMeasurement), {
             measuredValue,
@@ -1220,6 +2071,14 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Create a default Pm1ConcentrationMeasurement cluster server with feature NumericMeasurement.
+     *
+     * @param {number | null} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement (default to ConcentrationMeasurement.MeasurementUnit.Ppm).
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The unit of measurement (default to ConcentrationMeasurement.MeasurementMedium.Air).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultPm1ConcentrationMeasurementClusterServer(measuredValue = null, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.behaviors.require(Pm1ConcentrationMeasurementServer.with(ConcentrationMeasurement.Feature.NumericMeasurement), {
             measuredValue,
@@ -1231,6 +2090,14 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Create a default Pm25ConcentrationMeasurement cluster server with feature NumericMeasurement.
+     *
+     * @param {number | null} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement (default to ConcentrationMeasurement.MeasurementUnit.Ppm).
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The unit of measurement (default to ConcentrationMeasurement.MeasurementMedium.Air).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultPm25ConcentrationMeasurementClusterServer(measuredValue = null, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.behaviors.require(Pm25ConcentrationMeasurementServer.with(ConcentrationMeasurement.Feature.NumericMeasurement), {
             measuredValue,
@@ -1242,6 +2109,14 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Create a default Pm10ConcentrationMeasurement cluster server with feature NumericMeasurement.
+     *
+     * @param {number | null} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement (default to ConcentrationMeasurement.MeasurementUnit.Ppm).
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The unit of measurement (default to ConcentrationMeasurement.MeasurementMedium.Air).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultPm10ConcentrationMeasurementClusterServer(measuredValue = null, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.behaviors.require(Pm10ConcentrationMeasurementServer.with(ConcentrationMeasurement.Feature.NumericMeasurement), {
             measuredValue,
@@ -1253,6 +2128,14 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Create a default OzoneConcentrationMeasurement cluster server with feature NumericMeasurement.
+     *
+     * @param {number | null} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement (default to ConcentrationMeasurement.MeasurementUnit.Ugm3).
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The unit of measurement (default to ConcentrationMeasurement.MeasurementMedium.Air).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultOzoneConcentrationMeasurementClusterServer(measuredValue = null, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ugm3, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.behaviors.require(OzoneConcentrationMeasurementServer.with(ConcentrationMeasurement.Feature.NumericMeasurement), {
             measuredValue,
@@ -1264,6 +2147,14 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Create a default RadonConcentrationMeasurement cluster server with feature NumericMeasurement.
+     *
+     * @param {number | null} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement (default to ConcentrationMeasurement.MeasurementUnit.Ppm).
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The unit of measurement (default to ConcentrationMeasurement.MeasurementMedium.Air).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultRadonConcentrationMeasurementClusterServer(measuredValue = null, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ppm, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.behaviors.require(RadonConcentrationMeasurementServer.with(ConcentrationMeasurement.Feature.NumericMeasurement), {
             measuredValue,
@@ -1275,6 +2166,14 @@ export class MatterbridgeEndpoint extends Endpoint {
         });
         return this;
     }
+    /**
+     * Create a default NitrogenDioxideConcentrationMeasurement cluster server with feature NumericMeasurement.
+     *
+     * @param {number | null} measuredValue - The measured value of the concentration.
+     * @param {ConcentrationMeasurement.MeasurementUnit} measurementUnit - The unit of measurement (default to ConcentrationMeasurement.MeasurementUnit.Ugm3).
+     * @param {ConcentrationMeasurement.MeasurementMedium} measurementMedium - The unit of measurement (default to ConcentrationMeasurement.MeasurementMedium.Air).
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultNitrogenDioxideConcentrationMeasurementClusterServer(measuredValue = null, measurementUnit = ConcentrationMeasurement.MeasurementUnit.Ugm3, measurementMedium = ConcentrationMeasurement.MeasurementMedium.Air) {
         this.behaviors.require(NitrogenDioxideConcentrationMeasurementServer.with(ConcentrationMeasurement.Feature.NumericMeasurement), {
             measuredValue,
@@ -1287,3 +2186,4 @@ export class MatterbridgeEndpoint extends Endpoint {
         return this;
     }
 }
+//# sourceMappingURL=matterbridgeEndpoint.js.map