matterbridge 3.3.7 → 3.3.8-dev-20251115-920acfc

package/dist/devices/speaker.js

@@ -1,104 +1,26 @@
-/**
- * @description Speaker device class controlling mute (On/Off) and volume level (Level Control).
- * @file src/devices/speaker.ts
- * @author Luca Liguori
- * @created 2025-09-04
- * @version 1.0.0
- * @license Apache-2.0
- *
- * Copyright 2025, 2026, 2027 Luca Liguori.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-// matter clusters
 import { OnOff } from '@matter/types/clusters/on-off';
 import { LevelControl } from '@matter/types/clusters/level-control';
-// matterbridge
 import { speakerDevice } from '../matterbridgeDeviceTypes.js';
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
-/**
- * Represents a Speaker endpoint (Device Type 0x0022) exposing mute (OnOff) and volume (LevelControl).
- *
- * Mapping:
- *  - OnOff TRUE  => audio unmuted
- *  - OnOff FALSE => audio muted
- *  - LevelControl.currentLevel (1..254) => volume (linear map to 0..100%)
- *
- * Edge cases:
- *  - Volume < 1 coerced to 1.
- *  - Volume > 254 coerced to 254.
- *  - Non‑finite volume falls back to 128 (≈ mid level).
- */
 export class Speaker extends MatterbridgeEndpoint {
-    /**
-     * Create Speaker endpoint.
-     *
-     * @param {string} name   Human readable device name.
-     * @param {string} serial Unique serial (used to derive storage key).
-     * @param {boolean} muted Initial muted state (true => unmuted, default true if omitted).
-     * @param {number} volume Initial volume (1..254, coerced; default 128 ≈ 50% if omitted).
-     * @returns {Speaker} New speaker instance.
-     *
-     * @remarks Supported by:
-     * - SmartThings (OnOff mute, LevelControl volume)
-     * - Google Home (OnOff mute, LevelControl volume)
-     */
     constructor(name, serial, muted = false, volume = 128) {
-        // sanitize volume
         if (!Number.isFinite(volume))
             volume = 128;
         if (volume < 1)
             volume = 1;
         if (volume > 254)
             volume = 254;
-        super([speakerDevice], { uniqueStorageKey: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` }, true);
+        super([speakerDevice], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` });
         this.createDefaultBasicInformationClusterServer(name, serial, 0xfff1, 'Matterbridge', 0x8000, 'Matterbridge Speaker');
-        // On/Off used for mute state (TRUE => unmuted) - using no features
         this.createOnOffClusterServer(!muted);
-        // LevelControl for volume - using no features
         this.createLevelControlClusterServer(volume);
     }
-    /**
-     * Set mute state (true => muted / audio off).
-     *
-     * Edge cases:
-     *  - Strict boolean; caller must pass boolean (TS enforces).
-     *
-     * @param {boolean} muted Desired mute state (true => muted, false => unmuted).
-     * @returns {Promise<void>} Resolves when attribute is updated.
-     */
     async setMuted(muted) {
         await this.setAttribute(OnOff.Cluster.id, 'onOff', !muted);
     }
-    /**
-     * Get mute state.
-     *
-     * @returns {boolean} TRUE when muted, FALSE when unmuted.
-     */
     isMuted() {
         return !this.getAttribute(OnOff.Cluster.id, 'onOff');
     }
-    /**
-     * Set volume level (1..254).
-     *
-     * Edge cases:
-     *  - Non‑finite input ignored.
-     *  - <1 coerced to 1.
-     *  - >254 coerced to 254.
-     *
-     * @param {number} level Raw level (1..254 recommended, coerced if outside range).
-     * @returns {Promise<void>} Resolves when attribute is updated.
-     */
     async setVolume(level) {
         if (!Number.isFinite(level))
             return;
@@ -108,13 +30,7 @@ export class Speaker extends MatterbridgeEndpoint {
             level = 254;
         await this.setAttribute(LevelControl.Cluster.id, 'currentLevel', level);
     }
-    /**
-     * Get current volume.
-     *
-     * @returns {number} Current level (1..254).
-     */
     getVolume() {
         return this.getAttribute(LevelControl.Cluster.id, 'currentLevel');
     }
 }
-//# sourceMappingURL=speaker.js.map

package/dist/devices/temperatureControl.js

@@ -1,15 +1,6 @@
 import { TemperatureControl } from '@matter/types/clusters/temperature-control';
 import { TemperatureControlServer } from '@matter/node/behaviors/temperature-control';
 import { MatterbridgeServer } from '../matterbridgeBehaviors.js';
-/**
- * Creates a TemperatureControl Cluster Server with feature TemperatureLevel.
- *
- * @param {MatterbridgeEndpoint} endpoint - The Matterbridge endpoint instance.
- * @param {number} selectedTemperatureLevel - The selected temperature level as an index of the supportedTemperatureLevels array. Defaults to 1 (which corresponds to 'Warm').
- * @param {string[]} supportedTemperatureLevels - The supported temperature levels. Defaults to ['Cold', 'Warm', 'Hot', '30°', '40°', '60°', '80°'].
- *
- * @returns {this} The current MatterbridgeEndpoint instance for chaining.
- */
 export function createLevelTemperatureControlClusterServer(endpoint, selectedTemperatureLevel = 1, supportedTemperatureLevels = ['Cold', 'Warm', 'Hot', '30°', '40°', '60°', '80°']) {
     endpoint.behaviors.require(MatterbridgeLevelTemperatureControlServer.with(TemperatureControl.Feature.TemperatureLevel), {
         selectedTemperatureLevel,
@@ -17,23 +8,12 @@ export function createLevelTemperatureControlClusterServer(endpoint, selectedTem
     });
     return endpoint;
 }
-/**
- * Creates a TemperatureControl Cluster Server with features TemperatureNumber and TemperatureStep.
- *
- * @param {MatterbridgeEndpoint} endpoint - The Matterbridge endpoint instance.
- * @param {number} temperatureSetpoint - The temperature setpoint * 100. Defaults to 40 * 100 (which corresponds to 40°C).
- * @param {number} minTemperature - The minimum temperature * 100. Defaults to 30 * 100 (which corresponds to 30°C). Fixed attribute.
- * @param {number} maxTemperature - The maximum temperature * 100. Defaults to 60 * 100 (which corresponds to 60°C). Fixed attribute.
- * @param {number} [step] - The step size for temperature changes. Defaults to 10 * 100 (which corresponds to 10°C). Fixed attribute.
- *
- * @returns {this} The current MatterbridgeEndpoint instance for chaining.
- */
 export function createNumberTemperatureControlClusterServer(endpoint, temperatureSetpoint = 40 * 100, minTemperature = 30 * 100, maxTemperature = 60 * 100, step = 10 * 100) {
     endpoint.behaviors.require(MatterbridgeNumberTemperatureControlServer.with(TemperatureControl.Feature.TemperatureNumber, TemperatureControl.Feature.TemperatureStep), {
         temperatureSetpoint,
-        minTemperature, // Fixed attribute
-        maxTemperature, // Fixed attribute
-        step, // Fixed attribute
+        minTemperature,
+        maxTemperature,
+        step,
     });
     return endpoint;
 }
@@ -75,4 +55,3 @@ export class MatterbridgeNumberTemperatureControlServer extends TemperatureContr
         }
     }
 }
-//# sourceMappingURL=temperatureControl.js.map

package/dist/devices/waterHeater.js

@@ -1,26 +1,3 @@
-/**
- * @description This file contains the WaterHeater class.
- * @file src/devices/waterHeater.ts
- * @author Luca Liguori
- * @contributor Ludovic BOUÉ
- * @created 2025-05-18
- * @version 1.1.0
- * @license Apache-2.0
- *
- * Copyright 2025, 2026, 2027 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.
- */
 import { ModeBase } from '@matter/types/clusters/mode-base';
 import { WaterHeaterManagement } from '@matter/types/clusters/water-heater-management';
 import { WaterHeaterMode } from '@matter/types/clusters/water-heater-mode';
@@ -31,31 +8,8 @@ import { MatterbridgeServer } from '../matterbridgeBehaviors.js';
 import { electricalSensor, powerSource, waterHeater } from '../matterbridgeDeviceTypes.js';
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
 export class WaterHeater extends MatterbridgeEndpoint {
-    /**
-     * Creates an instance of the WaterHeater class.
-     *
-     * @param {string} name - The name of the water heater.
-     * @param {string} serial - The serial number of the water heater.
-     * @param {number} [waterTemperature] - The current water temperature. Defaults to 50.
-     * @param {number} [targetWaterTemperature] - The target water temperature. Defaults to 55.
-     * @param {number} [minHeatSetpointLimit] - The minimum heat setpoint limit. Defaults to 20.
-     * @param {number} [maxHeatSetpointLimit] - The maximum heat setpoint limit. Defaults to 80.
-     * @param {{ immersionElement1?: boolean; immersionElement2?: boolean; heatPump?: boolean; boiler?: boolean; other?: boolean }} [heaterTypes] - Indicates the heat sources that the water heater can call on for heating. Defaults to { immersionElement1: true }.
-     * @param {boolean} heaterTypes.immersionElement1 - Indicates if the water heater has an immersion element 1. Defaults to true.
-     * @param {boolean} heaterTypes.immersionElement2 - Indicates if the water heater has an immersion element 2.
-     * @param {boolean} heaterTypes.heatPump - Indicates if the water heater has a heat pump.
-     * @param {boolean} heaterTypes.boiler - Indicates if the water heater has a boiler.
-     * @param {boolean} heaterTypes.other - Indicates if the water heater has other types of heating sources.
-     * @param {number} [tankPercentage] - The current tank percentage of the WaterHeaterManagement cluster. Defaults to 90.
-     * @param {number} [voltage] - The voltage value in millivolts. Defaults to null if not provided.
-     * @param {number} [current] - The current value in milliamperes. Defaults to null if not provided.
-     * @param {number} [power] - The power value in milliwatts. Defaults to null if not provided.
-     * @param {number} [energy] - The total consumption value in mW/h. Defaults to null if not provided.
-     * @param {number} [absMinPower] - Indicate the minimum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
-     * @param {number} [absMaxPower] - Indicate the maximum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
-     */
     constructor(name, serial, waterTemperature = 50, targetWaterTemperature = 55, minHeatSetpointLimit = 20, maxHeatSetpointLimit = 80, heaterTypes = { immersionElement1: true }, tankPercentage = 90, voltage = null, current = null, power = null, energy = null, absMinPower = 0, absMaxPower = 0) {
-        super([waterHeater, powerSource, electricalSensor], { uniqueStorageKey: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` }, true);
+        super([waterHeater, powerSource, electricalSensor], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` });
         this.createDefaultIdentifyClusterServer()
             .createDefaultBasicInformationClusterServer(name, serial, 0xfff1, 'Matterbridge', 0x8000, 'Matterbridge Water Heater')
             .createDefaultPowerSourceWiredClusterServer()
@@ -68,42 +22,15 @@ export class WaterHeater extends MatterbridgeEndpoint {
             .createDefaultDeviceEnergyManagementClusterServer(DeviceEnergyManagement.EsaType.WaterHeating, true, DeviceEnergyManagement.EsaState.Online, absMinPower, absMaxPower)
             .createDefaultDeviceEnergyManagementModeClusterServer();
     }
-    /**
-     * Creates a default WaterHeaterManagement Cluster Server.
-     *
-     * @param {{ immersionElement1?: boolean; immersionElement2?: boolean; heatPump?: boolean; boiler?: boolean; other?: boolean }} [heaterTypes] - Indicates the heat sources that the water heater can call on for heating. Defaults to { immersionElement1: true }.
-     * @param {boolean} heaterTypes.immersionElement1 - Indicates if the water heater has an immersion element 1. Defaults to true.
-     * @param {boolean} heaterTypes.immersionElement2 - Indicates if the water heater has an immersion element 2.
-     * @param {boolean} heaterTypes.heatPump - Indicates if the water heater has a heat pump.
-     * @param {boolean} heaterTypes.boiler - Indicates if the water heater has a boiler.
-     * @param {boolean} heaterTypes.other - Indicates if the water heater has other types of heating sources.
-     * @param {{ immersionElement1?: boolean; immersionElement2?: boolean; heatPump?: boolean; boiler?: boolean; other?: boolean }} [heatDemand] - Indicates if the water heater is heating water. Defaults to all heat sources unset.
-     * @param {boolean} heatDemand.immersionElement1 - Indicates if the water heater is heating water with immersion element 1. Defaults to false.
-     * @param {boolean} heatDemand.immersionElement2 - Indicates if the water heater is heating water with immersion element 2.
-     * @param {boolean} heatDemand.heatPump - Indicates if the water heater is heating water with a heat pump.
-     * @param {boolean} heatDemand.boiler - Indicates if the water heater is heating water with a boiler.
-     * @param {boolean} heatDemand.other - Indicates if the water heater is heating water with other types of heating sources.
-     * @param {number} [tankPercentage] - The current tank percentage of the WaterHeaterManagement cluster. Defaults to 100.
-     * @param {WaterHeaterManagement.BoostState} [boostState] - The current boost state of the WaterHeaterManagement cluster. Defaults to Inactive.
-     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
-     */
     createDefaultWaterHeaterManagementClusterServer(heaterTypes, heatDemand, tankPercentage, boostState) {
         this.behaviors.require(MatterbridgeWaterHeaterManagementServer.with(WaterHeaterManagement.Feature.TankPercent), {
-            heaterTypes: heaterTypes ?? { immersionElement1: true }, // Fixed attribute
+            heaterTypes: heaterTypes ?? { immersionElement1: true },
             heatDemand: heatDemand ?? {},
             tankPercentage: tankPercentage ?? 100,
             boostState: boostState ?? WaterHeaterManagement.BoostState.Inactive,
         });
         return this;
     }
-    /**
-     * Creates a default WaterHeaterMode Cluster Server.
-     *
-     * @param {number} [currentMode] - The current mode of the WaterHeaterMode cluster. Defaults to mode 1 (WaterHeaterMode.ModeTag.Auto).
-     * @param {WaterHeaterMode.ModeOption[]} [supportedModes] - The supported modes for the WaterHeaterMode cluster. Defaults all cluster modes.
-     *
-     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
-     */
     createDefaultWaterHeaterModeClusterServer(currentMode, supportedModes) {
         this.behaviors.require(MatterbridgeWaterHeaterModeServer, {
             supportedModes: supportedModes ?? [
@@ -120,7 +47,7 @@ export class WaterHeater extends MatterbridgeEndpoint {
                 { label: 'Off', mode: 11, modeTags: [{ value: WaterHeaterMode.ModeTag.Off }] },
                 { label: 'Manual', mode: 12, modeTags: [{ value: WaterHeaterMode.ModeTag.Manual }] },
                 { label: 'Timed', mode: 13, modeTags: [{ value: WaterHeaterMode.ModeTag.Timed }] },
-            ], // Fixed attribute
+            ],
             currentMode: currentMode ?? 1,
         });
         return this;
@@ -133,9 +60,6 @@ export class MatterbridgeWaterHeaterManagementServer extends WaterHeaterManageme
         device.commandHandler.executeHandler('boost', { request, cluster: WaterHeaterManagementServer.id, attributes: this.state, endpoint: this.endpoint });
         device.log.debug(`MatterbridgeWaterHeaterManagementServer boost called with: ${JSON.stringify(request)}`);
         this.state.boostState = WaterHeaterManagement.BoostState.Active;
-        // The implementation is responsible for setting the device accordingly with the boostInfo of the boost command
-        // super.boost({ boostInfo });
-        // boost is not implemented in matter.js
     }
     cancelBoost() {
         const device = this.endpoint.stateOf(MatterbridgeServer);
@@ -143,9 +67,6 @@ export class MatterbridgeWaterHeaterManagementServer extends WaterHeaterManageme
         device.commandHandler.executeHandler('cancelBoost', { request: {}, cluster: WaterHeaterManagementServer.id, attributes: this.state, endpoint: this.endpoint });
         device.log.debug(`MatterbridgeWaterHeaterManagementServer cancelBoost called`);
         this.state.boostState = WaterHeaterManagement.BoostState.Inactive;
-        // The implementation is responsible for setting the device accordingly with the cancelBoost command
-        // super.cancelBoost();
-        // cancelBoost is not implemented in matter.js
     }
 }
 export class MatterbridgeWaterHeaterModeServer extends WaterHeaterModeServer {
@@ -163,4 +84,3 @@ export class MatterbridgeWaterHeaterModeServer extends WaterHeaterModeServer {
         return { status: ModeBase.ModeChangeStatus.Success, statusText: 'Success' };
     }
 }
-//# sourceMappingURL=waterHeater.js.map

package/dist/dgram/coap.js

@@ -1,28 +1,4 @@
-/**
- * @description This file contains the class Coap.
- * @file src/dgram/coap.ts
- * @author Luca Liguori
- * @created 2025-03-22
- * @version 1.0.0
- * @license Apache-2.0
- *
- * Copyright 2025, 2026, 2027 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 imports
 import { BLUE, db, GREEN, MAGENTA, nf } from 'node-ansi-logger';
-// Net imports
 import { COAP_MULTICAST_IPV4_ADDRESS, COAP_MULTICAST_PORT, Multicast } from './multicast.js';
 export const COAP_OPTION_URI_PATH = 11;
 export const COIOT_OPTION_DEVID = 3332;
@@ -48,26 +24,16 @@ export class Coap extends Multicast {
             this.log.error(`Error decoding CoAP message: ${error instanceof Error ? error.message : error}`);
         }
     }
-    /**
-     * Decodes a CoAP message from a Buffer.
-     *
-     * @param {Buffer} msg - The Buffer containing the raw CoAP message.
-     * @returns {CoapMessage} A parsed CoAP message object.
-     * @throws {Error} if the message is malformed.
-     */
     decodeCoapMessage(msg) {
-        // A valid CoAP message must have at least 4 bytes for the header.
         if (msg.length < 4) {
             throw new Error('Message too short to be a valid CoAP message');
         }
-        // Parse the 4-byte fixed header.
-        const version = (msg[0] & 0xc0) >> 6; // Bits 7-6: Version
-        const type = (msg[0] & 0x30) >> 4; // Bits 5-4: Type
-        const tokenLength = msg[0] & 0x0f; // Bits 3-0: Token Length
-        const code = msg[1]; // 8-bit Code
-        const messageId = msg.readUInt16BE(2); // 16-bit Message ID
+        const version = (msg[0] & 0xc0) >> 6;
+        const type = (msg[0] & 0x30) >> 4;
+        const tokenLength = msg[0] & 0x0f;
+        const code = msg[1];
+        const messageId = msg.readUInt16BE(2);
         let offset = 4;
-        // Parse token if present.
         let token = Buffer.alloc(0);
         if (tokenLength > 0) {
             if (msg.length < offset + tokenLength) {
@@ -76,20 +42,16 @@ export class Coap extends Multicast {
             token = msg.slice(offset, offset + tokenLength);
             offset += tokenLength;
         }
-        // Parse options.
         const options = [];
         let currentOptionNumber = 0;
         while (offset < msg.length) {
-            // Payload marker: 0xFF indicates the beginning of the payload.
             if (msg[offset] === 0xff) {
-                offset++; // Skip the marker.
+                offset++;
                 break;
             }
-            // Read the option header byte.
             const optionHeader = msg[offset++];
-            let delta = (optionHeader & 0xf0) >> 4; // High nibble: option delta.
-            let length = optionHeader & 0x0f; // Low nibble: option length.
-            // Extended delta handling.
+            let delta = (optionHeader & 0xf0) >> 4;
+            let length = optionHeader & 0x0f;
             if (delta === 13) {
                 if (offset >= msg.length) {
                     throw new Error('Invalid extended option delta');
@@ -106,7 +68,6 @@ export class Coap extends Multicast {
             else if (delta === 15) {
                 throw new Error('Reserved option delta value encountered');
             }
-            // Extended length handling.
             if (length === 13) {
                 if (offset >= msg.length) {
                     throw new Error('Invalid extended option length');
@@ -123,9 +84,7 @@ export class Coap extends Multicast {
             else if (length === 15) {
                 throw new Error('Reserved option length value encountered');
             }
-            // Calculate the actual option number.
             currentOptionNumber += delta;
-            // Ensure that the option's value fits in the remaining message.
             if (offset + length > msg.length) {
                 throw new Error('Option length exceeds message length');
             }
@@ -136,7 +95,6 @@ export class Coap extends Multicast {
                 value: optionValue,
             });
         }
-        // Parse payload if any remains.
         const payload = offset < msg.length ? msg.slice(offset) : undefined;
         return {
             version,
@@ -149,38 +107,23 @@ export class Coap extends Multicast {
             payload,
         };
     }
-    /**
-     * Encodes a CoAP message into a Buffer.
-     *
-     * @param {CoapMessage} msg - The CoAP message to encode.
-     * @returns {Buffer} A Buffer representing the encoded CoAP message.
-     * @throws {Error} if the message is malformed.
-     */
     encodeCoapMessage(msg) {
         const parts = [];
-        // Determine token length (ensure it's consistent with msg.token)
         const token = msg.token || Buffer.alloc(0);
         const tokenLength = token.length;
         if (tokenLength > 8) {
             throw new Error('Token length cannot exceed 8 bytes');
         }
-        // Create header (4 bytes):
-        //   Byte 0: Version (2 bits), Type (2 bits), Token Length (4 bits)
-        //   Byte 1: Code (8 bits)
-        //   Bytes 2-3: Message ID (16 bits)
         const header = Buffer.alloc(4);
         header[0] = ((msg.version & 0x03) << 6) | ((msg.type & 0x03) << 4) | (tokenLength & 0x0f);
         header[1] = msg.code;
         header.writeUInt16BE(msg.messageId, 2);
         parts.push(header);
-        // Append token if present.
         if (tokenLength > 0) {
             parts.push(token);
         }
-        // Sort options by option number in ascending order.
         const sortedOptions = msg.options.slice().sort((a, b) => a.number - b.number);
         let previousOptionNumber = 0;
-        // Encode each option.
         for (const option of sortedOptions) {
             const optionDelta = option.number - previousOptionNumber;
             const optionValueLength = option.value.length;
@@ -188,7 +131,6 @@ export class Coap extends Multicast {
             let deltaExtended = null;
             let lengthNibble;
             let lengthExtended = null;
-            // Determine option delta nibble and extended delta field.
             if (optionDelta < 13) {
                 deltaNibble = optionDelta;
             }
@@ -201,7 +143,6 @@ export class Coap extends Multicast {
                 deltaExtended = Buffer.alloc(2);
                 deltaExtended.writeUInt16BE(optionDelta - 269, 0);
             }
-            // Determine option length nibble and extended length field.
             if (optionValueLength < 13) {
                 lengthNibble = optionValueLength;
             }
@@ -214,42 +155,24 @@ export class Coap extends Multicast {
                 lengthExtended = Buffer.alloc(2);
                 lengthExtended.writeUInt16BE(optionValueLength - 269, 0);
             }
-            // Option header byte: high nibble is delta, low nibble is length.
             const optionHeader = Buffer.alloc(1);
             optionHeader[0] = (deltaNibble << 4) | (lengthNibble & 0x0f);
             parts.push(optionHeader);
-            // Append extended delta if needed.
             if (deltaExtended) {
                 parts.push(deltaExtended);
             }
-            // Append extended length if needed.
             if (lengthExtended) {
                 parts.push(lengthExtended);
             }
-            // Append the option value.
             parts.push(option.value);
-            // Update previous option number.
             previousOptionNumber = option.number;
         }
-        // If a payload is present, add the payload marker (0xFF) followed by the payload.
         if (msg.payload && msg.payload.length > 0) {
-            parts.push(Buffer.from([0xff])); // Payload marker.
+            parts.push(Buffer.from([0xff]));
             parts.push(msg.payload);
         }
         return Buffer.concat(parts);
     }
-    /**
-     * Converts a CoAP message type numeric value to its string representation.
-     *
-     * CoAP message types are:
-     *  - 0: Confirmable (CON)
-     *  - 1: Non-confirmable (NON)
-     *  - 2: Acknowledgement (ACK)
-     *  - 3: Reset (RST)
-     *
-     * @param {number} type - The numeric CoAP message type.
-     * @returns {string} The string representation of the message type.
-     */
     coapTypeToString(type) {
         switch (type) {
             case 0:
@@ -264,37 +187,18 @@ export class Coap extends Multicast {
                 return `Unknown Type (${type})`;
         }
     }
-    /**
-     * Converts a CoAP code numeric value to its string representation.
-     *
-     * The CoAP code is split into a 3-bit class and a 5-bit detail.
-     * For example:
-     *   - 0.01: GET
-     *   - 0.02: POST
-     *   - 0.03: PUT
-     *   - 0.04: DELETE
-     *   - 2.05: Content (success response)
-     *   - 4.04: Not Found (client error)
-     *   - 5.00: Internal Server Error (server error)
-     *
-     * @param {number} code - The numeric CoAP code.
-     * @returns {string} The string representation of the code.
-     */
     coapCodeToString(code) {
-        // Split the code: the upper 3 bits form the class and the lower 5 bits form the detail.
         const cls = code >> 5;
         const detail = code & 0x1f;
         const codeStr = `${cls}.${detail.toString().padStart(2, '0')}`;
         return codeStr;
     }
-    sendRequest(messageId, options, 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    payload, token, address, port) {
+    sendRequest(messageId, options, payload, token, address, port) {
         const coapMessage = {
             version: 1,
-            type: 1, // e.g., Confirmable
+            type: 1,
             tokenLength: token ? Buffer.from(token).length : 0,
-            code: 1, // e.g., GET
+            code: 1,
             messageId,
             token: token ? Buffer.from(token) : Buffer.alloc(0),
             options,
@@ -313,10 +217,6 @@ export class Coap extends Multicast {
                 this.log.info(`Option: COAP_OPTION_URI_PATH => ${GREEN}${option.value}${nf}`);
             }
             else if (option.number === COIOT_OPTION_DEVID) {
-                /*
-                 * First defined option is COIOT_OPTION_GLOBAL_DEVID. This is a global option and must be present in all CoIoT packages with request or payload.
-                 * Its value is a string in format <devtype>#<devid>#<version> for example SHSEN-1#4B3F9E#1 The whole option should be less than 50 bytes.
-                 */
                 const parts = option.value.toString().split('#');
                 const deviceModel = parts[0];
                 const deviceMac = parts[1];
@@ -324,22 +224,10 @@ export class Coap extends Multicast {
                 this.log.info(`Option: COIOT_OPTION_DEVID => ${option.value} => Model: ${GREEN}${deviceModel}${nf}, MAC: ${GREEN}${deviceMac}${nf}, Protocol: ${GREEN}${protocolRevision}${nf}`);
             }
             else if (option.number === COIOT_OPTION_SERIAL) {
-                /*
-                 * This option is mandatory in status response and publishes. It is a uint16_t in network byte order which indicates a change in the status report.
-                 * When a new status report is handled, all payload processing can be skipped if the serial number does not change from the last processed payload.
-                 * The value 0 is reserved and should not be sent. This allows easy initialization in the receiving devices.
-                 */
                 const serial = option.value.readUInt16BE(0);
                 this.log.info(`Option: COIOT_OPTION_SERIAL => 0x${option.value.toString('hex')} => serial: ${GREEN}${serial}${nf}`);
             }
             else if (option.number === COIOT_OPTION_VALIDITY) {
-                /*
-                 * COIOT_OPTION_STATUS_VALIDITY is a uint16_t in network byte order (big endian) that states the maximal time between this and the next status publish.
-                 * This way a device can state its report interval. If a report is not received from this device after the interval has passed the device should be considered offline.
-                 * The LS bit of this option controls how the value is scaled:
-                 * - If the LS bit is 0, the value is number of 1/10 of seconds in the validity period, so 2 is 0.2 seconds, 10 is a second, 600 is a minute, 65534 is 109 minutes and 13 seconds.
-                 * - If the LS bit is 1, the value is number of 4 seconds interval in the whole interval. So 3 is 12 seconds, 11 is 44 seconds and 65535 is more than 3 days.
-                 */
                 const validity = option.value.readUInt16BE(0);
                 let validFor = 0;
                 if ((validity & 0x1) === 0) {
@@ -354,7 +242,7 @@ export class Coap extends Multicast {
                 this.log.info(`Option: ${option.number} - ${option.value
                     .toString('hex')
                     .match(/.{1,2}/g)
-                    ?.join(' ')}`); // Split into pairs of hex characters
+                    ?.join(' ')}`);
         });
         if (msg.payload && msg.payload.length > 0)
             this.log.info(`Payload:`, JSON.parse(msg.payload.toString()), '\n');
@@ -362,4 +250,3 @@ export class Coap extends Multicast {
             this.log.info(`No payload`, '\n');
     }
 }
-//# sourceMappingURL=coap.js.map