matterbridge 3.3.3 → 3.3.4-dev-20251020-4d2dd49

package/dist/cliHistory.js

@@ -1,86 +1,17 @@
-/**
- * This file contains the CLI history page generator.
- *
- * @file cliHistory.ts
- * @author Luca Liguori
- * @created 2025-10-09
- * @version 1.0.1
- * @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.
- */
-// eslint-disable-next-line no-console
 if (process.argv.includes('--loader') || process.argv.includes('-loader'))
     console.log('\u001B[32mCli history loaded.\u001B[40;0m');
 import { writeFileSync } from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
-// History for 8h at 1 sample each 10 seconds = 2880 entries
-export const historySize = 2880;
-export let historyIndex = 0;
-/**
- * Sets the history index.
- *
- * @param {number} index - The new history index.
- */
-export function setHistoryIndex(index) {
-    if (!Number.isFinite(index) || !Number.isSafeInteger(index)) {
-        throw new TypeError('historyIndex must be a finite, safe integer.');
-    }
-    if (index < 0 || index >= historySize) {
-        throw new RangeError(`historyIndex must be between 0 and ${historySize - 1}.`);
-    }
-    historyIndex = index;
-}
-export const history = Array.from({ length: historySize }, () => ({
-    timestamp: 0,
-    cpu: 0,
-    peakCpu: 0,
-    processCpu: 0,
-    peakProcessCpu: 0,
-    rss: 0,
-    peakRss: 0,
-    heapUsed: 0,
-    peakHeapUsed: 0,
-    heapTotal: 0,
-    peakHeapTotal: 0,
-    external: 0,
-    peakExternal: 0,
-    arrayBuffers: 0,
-    peakArrayBuffers: 0,
-}));
-/**
- * Generates a static HTML dashboard displaying CPU and memory history.
- *
- * @param {GenerateHistoryPageOptions} [options] - Optional configuration for output path, page title, and refresh interval.
- *
- * @returns {string | undefined} The absolute path to the generated HTML file, or undefined if no samples exist.
- */
+import { Tracker } from './utils/tracker.js';
 export function generateHistoryPage(options = {}) {
     const pageTitle = options.pageTitle ?? 'Matterbridge CPU & Memory History';
     const hostname = options.hostname ?? os.hostname();
     const outputPath = path.resolve(options.outputPath ?? path.join(process.cwd(), 'history.html'));
-    const bufferLength = history.length;
-    if (bufferLength === 0) {
-        return undefined;
-    }
-    const startIndex = ((Math.trunc(historyIndex) % bufferLength) + bufferLength) % bufferLength;
     const normalizedHistory = [];
-    for (let offset = 0; offset < bufferLength; offset += 1) {
-        const index = (startIndex + offset) % bufferLength;
-        const entry = history[index];
+    for (let offset = 0; offset < Tracker.historySize; offset += 1) {
+        const index = (Tracker.historyIndex + offset) % Tracker.historySize;
+        const entry = Tracker.history[index];
         if (!entry || entry.timestamp === 0)
             continue;
         normalizedHistory.push(entry);
@@ -88,7 +19,7 @@ export function generateHistoryPage(options = {}) {
     if (normalizedHistory.length === 0) {
         return undefined;
     }
-    const peakCpu = Math.max(...normalizedHistory.map((entry) => entry.peakCpu ?? entry.cpu));
+    const peakOsCpu = Math.max(...normalizedHistory.map((entry) => entry.peakOsCpu ?? entry.osCpu));
     const peakProcessCpu = Math.max(...normalizedHistory.map((entry) => entry.peakProcessCpu ?? entry.processCpu));
     const peakRss = Math.max(...normalizedHistory.map((entry) => entry.peakRss ?? entry.rss));
     const peakHeapUsed = Math.max(...normalizedHistory.map((entry) => entry.peakHeapUsed ?? entry.heapUsed));
@@ -100,7 +31,7 @@ export function generateHistoryPage(options = {}) {
     const summary = {
         entries: normalizedHistory.length,
         timeRange: `${new Date(firstTimestamp).toLocaleString()} → ${new Date(lastTimestamp).toLocaleString()}`,
-        peakCpu,
+        peakOsCpu,
         peakProcessCpu,
         peakRss,
         peakHeapUsed,
@@ -332,7 +263,7 @@ export function generateHistoryPage(options = {}) {
       const summaryEntries = [
         { label: 'Samples', value: SUMMARY_DATA.entries.toLocaleString() },
         { label: 'Time Range', value: SUMMARY_DATA.timeRange },
-        { label: 'Host CPU Peak', value: SUMMARY_DATA.peakCpu.toFixed(2) + ' %' },
+        { label: 'Host CPU Peak', value: SUMMARY_DATA.peakOsCpu.toFixed(2) + ' %' },
         { label: 'Process CPU Peak', value: SUMMARY_DATA.peakProcessCpu.toFixed(2) + ' %' },
         { label: 'RSS Peak', value: formatBytes(SUMMARY_DATA.peakRss) },
         { label: 'Heap Used Peak', value: formatBytes(SUMMARY_DATA.peakHeapUsed) },
@@ -353,8 +284,8 @@ export function generateHistoryPage(options = {}) {
         const row = document.createElement('tr');
         const cells = [
           new Date(entry.timestamp).toLocaleString(),
-          entry.cpu.toFixed(2),
-          entry.peakCpu.toFixed(2),
+          entry.osCpu.toFixed(2),
+          entry.peakOsCpu.toFixed(2),
           (Number.isFinite(entry.processCpu) ? entry.processCpu : 0).toFixed(2),
           (
             Number.isFinite(entry.peakProcessCpu)
@@ -379,16 +310,12 @@ export function generateHistoryPage(options = {}) {
       });
 
       const cpuPeakValue = HISTORY_DATA.reduce(function (acc, entry) {
-        return Math.max(acc, Number.isFinite(entry.peakCpu) ? entry.peakCpu : 0, Number.isFinite(entry.cpu) ? entry.cpu : 0);
+        return Math.max(acc, Number.isFinite(entry.peakOsCpu) ? entry.peakOsCpu : 0, Number.isFinite(entry.osCpu) ? entry.osCpu : 0);
       }, 0);
       const cpuMaxYAxis = cpuPeakValue > 0 ? cpuPeakValue * 1.05 : undefined;
 
       const processCpuPeakValue = HISTORY_DATA.reduce(function (acc, entry) {
-        return Math.max(
-          acc,
-          Number.isFinite(entry.peakProcessCpu) ? entry.peakProcessCpu : 0,
-          Number.isFinite(entry.processCpu) ? entry.processCpu : 0
-        );
+        return Math.max(acc, Number.isFinite(entry.peakProcessCpu) ? entry.peakProcessCpu : 0, Number.isFinite(entry.processCpu) ? entry.processCpu : 0);
       }, 0);
       const processCpuMaxYAxis = processCpuPeakValue > 0 ? processCpuPeakValue * 1.05 : undefined;
       const useProcessCpuDecimals = (processCpuMaxYAxis ?? 0) <= 3;
@@ -455,14 +382,14 @@ export function generateHistoryPage(options = {}) {
               {
                 label: 'Host CPU %',
                 values: HISTORY_DATA.map(function (entry) {
-                  return Number.isFinite(entry.cpu) ? Number(entry.cpu.toFixed(2)) : 0;
+                  return Number.isFinite(entry.osCpu) ? Number(entry.osCpu.toFixed(2)) : 0;
                 }),
                 color: '#38bdf8',
                 fill: 'rgba(56, 189, 248, 0.18)',
                 markPeaks: true,
                 markerPeakValues: HISTORY_DATA.map(function (entry) {
-                  if (Number.isFinite(entry.peakCpu)) return entry.peakCpu;
-                  if (Number.isFinite(entry.cpu)) return entry.cpu;
+                  if (Number.isFinite(entry.peakOsCpu)) return entry.peakOsCpu;
+                  if (Number.isFinite(entry.osCpu)) return entry.osCpu;
                   return Number.NEGATIVE_INFINITY;
                 }),
                 markerRadius: 2.5
@@ -470,7 +397,7 @@ export function generateHistoryPage(options = {}) {
               {
                 label: 'Host Peak CPU %',
                 values: HISTORY_DATA.map(function (entry) {
-                  return Number.isFinite(entry.peakCpu) ? Number(entry.peakCpu.toFixed(2)) : 0;
+                  return Number.isFinite(entry.peakOsCpu) ? Number(entry.peakOsCpu.toFixed(2)) : 0;
                 }),
                 color: '#facc15',
                 dashed: [6, 4]
@@ -856,13 +783,6 @@ export function generateHistoryPage(options = {}) {
     writeFileSync(outputPath, html, { encoding: 'utf-8' });
     return outputPath;
 }
-/**
- * Escapes HTML special characters to prevent breaking embedded markup.
- *
- * @param {string} input - The string to escape.
- * @returns {string} The escaped string safe for HTML contexts.
- */
 function escapeHtml(input) {
     return input.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;');
 }
-//# sourceMappingURL=cliHistory.js.map

package/dist/clusters/export.js

@@ -1,3 +1 @@
 export {};
-// Nothing to export right now, but this file is here to make it easier to add exports in the future
-//# sourceMappingURL=export.js.map

package/dist/defaultConfigSchema.js

@@ -1,26 +1,3 @@
-/**
- * This file contains the default config for the plugins.
- *
- * @file defaultConfigSchema.ts
- * @author Luca Liguori
- * @created 2024-05-07
- * @version 1.0.1
- * @license Apache-2.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.
- */
 export const zigbee2mqtt_config = {
     name: 'matterbridge-zigbee2mqtt',
     type: 'DynamicPlatform',
@@ -82,4 +59,3 @@ export const shelly_config = {
     debugWs: false,
     unregisterOnShutdown: false,
 };
-//# sourceMappingURL=defaultConfigSchema.js.map

package/dist/deviceManager.js

@@ -1,43 +1,13 @@
-/**
- * This file contains the DeviceManager class.
- *
- * @file devices.ts
- * @author Luca Liguori
- * @created 2024-07-26
- * @version 1.0.11
- * @license Apache-2.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, BLUE, CYAN, db, debugStringify, er, wr } from 'node-ansi-logger';
 import { dev } from './matterbridgeTypes.js';
 import { BroadcastServer } from './broadcastServer.js';
 import { hasParameter } from './utils/commandLine.js';
-/**
- * Manages Matterbridge devices.
- */
 export class DeviceManager {
     _devices = new Map();
     log;
     server;
-    /**
-     * Creates an instance of DeviceManager.
-     */
     constructor() {
-        this.log = new AnsiLogger({ logName: 'DeviceManager', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: hasParameter('debug') ? "debug" /* LogLevel.DEBUG */ : "info" /* LogLevel.INFO */ });
+        this.log = new AnsiLogger({ logName: 'DeviceManager', logTimestampFormat: 4, logLevel: hasParameter('debug') ? "debug" : "info" });
         this.log.debug('Matterbridge device manager starting...');
         this.server = new BroadcastServer('devices', this.log);
         this.server.on('broadcast_message', this.msgHandler.bind(this));
@@ -77,47 +47,18 @@ export class DeviceManager {
             }
         }
     }
-    /**
-     * Gets the number of devices.
-     *
-     * @returns {number} The number of devices.
-     */
     get length() {
         return this._devices.size;
     }
-    /**
-     * Gets the number of devices.
-     *
-     * @returns {number} The number of devices.
-     */
     get size() {
         return this._devices.size;
     }
-    /**
-     * Checks if a device with the specified unique ID exists.
-     *
-     * @param {string} uniqueId - The unique ID of the device.
-     * @returns {boolean} True if the device exists, false otherwise.
-     */
     has(uniqueId) {
         return this._devices.has(uniqueId);
     }
-    /**
-     * Gets a device by its unique ID.
-     *
-     * @param {string} uniqueId - The unique ID of the device.
-     * @returns {MatterbridgeEndpoint | undefined} The device, or undefined if not found.
-     */
     get(uniqueId) {
         return this._devices.get(uniqueId);
     }
-    /**
-     * Adds a device to the manager.
-     *
-     * @param {MatterbridgeEndpoint} device - The device to add.
-     * @returns {MatterbridgeEndpoint} The added device.
-     * @throws {Error} If the device does not have a unique ID.
-     */
     set(device) {
         if (!device.uniqueId)
             throw new Error(`The device ${dev}${device.deviceName}${er} has not been initialized: uniqueId is required`);
@@ -126,13 +67,6 @@ export class DeviceManager {
         this._devices.set(device.uniqueId, device);
         return device;
     }
-    /**
-     * Removes a device from the manager.
-     *
-     * @param {MatterbridgeEndpoint} device - The device to remove.
-     * @returns {boolean} True if the device was removed, false otherwise.
-     * @throws {Error} If the device does not have a unique ID.
-     */
     remove(device) {
         if (!device.uniqueId)
             throw new Error(`The device ${dev}${device.deviceName}${er} has not been initialized: uniqueId is required`);
@@ -140,66 +74,15 @@ export class DeviceManager {
             this.log.error(`The device ${dev}${device.deviceName}${er} with uniqueId ${BLUE}${device.uniqueId}${er} serialNumber ${BLUE}${device.serialNumber}${er} is not registered in the device manager`);
         return this._devices.delete(device.uniqueId);
     }
-    /**
-     * Clears all devices from the manager.
-     */
     clear() {
         this._devices.clear();
     }
-    /**
-     * Gets an array of all devices.
-     *
-     * @returns {MatterbridgeEndpoint[]} An array of all devices.
-     */
     array() {
         return Array.from(this._devices.values());
     }
-    /**
-     * Gets an array of all devices suitable for serialization.
-     *
-     * @param {string} [pluginName] - Optional plugin name to filter devices (not used currently).
-     * @returns {ApiDevices[]} An array of all devices.
-     */
-    /*
-    baseArray(pluginName?: string): ApiDevices[] {
-      const devices: ApiDevices[] = [];
-      for (const device of this.matterbridge.devices.array()) {
-        // Filter by pluginName if provided
-        if (pluginName && pluginName !== device.plugin) continue;
-        // Check if the device has the required properties
-        if (!device.plugin || !device.deviceType || !device.name || !device.deviceName || !device.serialNumber || !device.uniqueId || !device.lifecycle.isReady) continue;
-        devices.push({
-          pluginName: device.plugin,
-          type: device.name + ' (0x' + device.deviceType.toString(16).padStart(4, '0') + ')',
-          endpoint: device.number,
-          name: device.deviceName,
-          serial: device.serialNumber,
-          productUrl: device.productUrl,
-          configUrl: device.configUrl,
-          uniqueId: device.uniqueId,
-          reachable: this.getReachability(device),
-          powerSource: this.getPowerSource(device),
-          matter: device.mode === 'server' && device.serverNode ? this.matterbridge.getServerNodeData(device.serverNode) : undefined,
-          cluster: this.getClusterTextFromDevice(device),
-        });
-      }
-      return devices;
-    }
-    */
-    /**
-     * Iterates over all devices.
-     *
-     * @returns {IterableIterator<MatterbridgeEndpoint>} An iterator for the devices.
-     */
     [Symbol.iterator]() {
         return this._devices.values();
     }
-    /**
-     * Asynchronously iterates over each device and calls the provided callback function.
-     *
-     * @param {(device: MatterbridgeEndpoint) => Promise<void>} callback - The callback function to call with each device.
-     * @returns {Promise<void>} A promise that resolves when all callbacks have been called.
-     */
     async forEach(callback) {
         if (this.size === 0)
             return;
@@ -213,13 +96,7 @@ export class DeviceManager {
         });
         await Promise.all(tasks);
     }
-    /**
-     * Sets the log level.
-     *
-     * @param {LogLevel} logLevel - The log level to set.
-     */
     set logLevel(logLevel) {
         this.log.logLevel = logLevel;
     }
 }
-//# sourceMappingURL=deviceManager.js.map

package/dist/devices/airConditioner.js

@@ -1,64 +1,8 @@
-/**
- * @description This file contains the AirConditioner class.
- * @file src/devices/airConditioner.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.
- */
-// Imports from @matter
 import { ThermostatUserInterfaceConfiguration } from '@matter/main/clusters/thermostat-user-interface-configuration';
-// Matterbridge
 import { FanControl } from '@matter/main/clusters/fan-control';
 import { airConditioner, powerSource } from '../matterbridgeDeviceTypes.js';
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
 export class AirConditioner extends MatterbridgeEndpoint {
-    /**
-     * Creates an instance of the AirConditioner class.
-     *
-     * A Room Air Conditioner is a device which at a minimum is capable of being turned on and off and of controlling the temperature in the living space.
-     * A Room Air Conditioner MAY also support additional capabilities via endpoint composition.
-     * The DF (Dead Front) feature is required for the On/Off cluster in this device type.
-     *
-     * @param {string} name - The name of the air conditioner.
-     * @param {string} serial - The serial number of the air conditioner.
-     * @param {AirConditionerOptions} [options] - Optional configuration values. Missing fields use defaults.
-     *
-     * Options defaults:
-     *  - localTemperature: 23
-     *  - occupiedHeatingSetpoint: 21
-     *  - occupiedCoolingSetpoint: 25
-     *  - minSetpointDeadBand: 1
-     *  - minHeatSetpointLimit: 0
-     *  - maxHeatSetpointLimit: 50
-     *  - minCoolSetpointLimit: 0
-     *  - maxCoolSetpointLimit: 50
-     *  - temperatureDisplayMode: Celsius
-     *  - keypadLockout: NoLockout
-     *  - scheduleProgrammingVisibility: ScheduleProgrammingPermitted
-     *  - fanMode: Off
-     *  - fanModeSequence: OffLowMedHighAuto
-     *  - percentSetting: 0
-     *  - percentCurrent: 0
-     *
-     * @returns {AirConditioner} The AirConditioner instance.
-     *
-     * @remarks Not supported by Google Home.
-     */
     constructor(name, serial, options = {}) {
         const { localTemperature = 23, occupiedHeatingSetpoint = 21, occupiedCoolingSetpoint = 25, minSetpointDeadBand = 1, minHeatSetpointLimit = 0, maxHeatSetpointLimit = 50, minCoolSetpointLimit = 0, maxCoolSetpointLimit = 50, temperatureDisplayMode = ThermostatUserInterfaceConfiguration.TemperatureDisplayMode.Celsius, keypadLockout = ThermostatUserInterfaceConfiguration.KeypadLockout.NoLockout, scheduleProgrammingVisibility = ThermostatUserInterfaceConfiguration.ScheduleProgrammingVisibility.ScheduleProgrammingPermitted, fanMode = FanControl.FanMode.Off, fanModeSequence = FanControl.FanModeSequence.OffLowMedHighAuto, percentSetting = 0, percentCurrent = 0, } = options;
         super([airConditioner, powerSource], { uniqueStorageKey: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` }, true);
@@ -71,4 +15,3 @@ export class AirConditioner extends MatterbridgeEndpoint {
         this.createDefaultFanControlClusterServer(fanMode, fanModeSequence, percentSetting, percentCurrent);
     }
 }
-//# sourceMappingURL=airConditioner.js.map

package/dist/devices/batteryStorage.js

@@ -1,53 +1,9 @@
-/**
- * @description This file contains the BatteryStorage class.
- * @file src/devices/batteryStorage.ts
- * @author Luca Liguori
- * @contributor Ludovic BOUÉ
- * @created 2025-06-20
- * @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
 import { PowerSourceTag } from '@matter/main';
 import { DeviceEnergyManagement } from '@matter/main/clusters/device-energy-management';
 import { PowerSource } from '@matter/main/clusters/power-source';
-// Matterbridge
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
 import { deviceEnergyManagement, electricalSensor, batteryStorage, powerSource } from '../matterbridgeDeviceTypes.js';
 export class BatteryStorage extends MatterbridgeEndpoint {
-    /**
-     * Creates an instance of the BatteryStorage class.
-     *
-     * @param {string} name - The name of the BatteryStorage.
-     * @param {string} serial - The serial number of the BatteryStorage.
-     * @param {number} [batPercentRemaining] - The percentage of battery remaining, defaults to `100` if not provided.
-     * @param {PowerSource.BatChargeLevel} [batChargeLevel] - The battery charge level (default: PowerSource.BatChargeLevel.Ok).
-     * @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} energyImported - The total production value in mW/h.
-     * @param {number} energyExported - The total production value in mW/h.
-     * @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.
-     *
-     * @remarks
-     * - A battery storage inverter that can charge its battery at a maximum power of 2000W and can
-     * discharge the battery at a maximum power of 3000W, would have a absMinPower: -3000W, absMaxPower: 2000W.
-     */
     constructor(name, serial, batPercentRemaining = 100, batChargeLevel = PowerSource.BatChargeLevel.Ok, voltage = null, current = null, power = null, energyImported = null, energyExported = null, absMinPower = 0, absMaxPower = 0) {
         super([batteryStorage, electricalSensor, deviceEnergyManagement], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` }, true);
         this.createDefaultIdentifyClusterServer()
@@ -58,12 +14,10 @@ export class BatteryStorage extends MatterbridgeEndpoint {
             .createDefaultDeviceEnergyManagementClusterServer(DeviceEnergyManagement.EsaType.BatteryStorage, true, DeviceEnergyManagement.EsaState.Online, absMinPower, absMaxPower)
             .createDefaultDeviceEnergyManagementModeClusterServer()
             .addRequiredClusterServers();
-        // Add separate PowerSource child devices cause in matter.js the PowerSource cluster is not supported with both features Wired and Battery.
-        // Probably this is also an error in the specification...
         this.addChildDeviceType('BatteryPowerSource', powerSource, {
             tagList: [{ mfgCode: null, namespaceId: PowerSourceTag.Battery.namespaceId, tag: PowerSourceTag.Battery.tag, label: null }],
         })
-            .createDefaultPowerSourceRechargeableBatteryClusterServer(batPercentRemaining, batChargeLevel, 24_000) // Battery voltage in mV (24V).
+            .createDefaultPowerSourceRechargeableBatteryClusterServer(batPercentRemaining, batChargeLevel, 24_000)
             .addRequiredClusterServers();
         this.addChildDeviceType('GridPowerSource', powerSource, {
             tagList: [{ mfgCode: null, namespaceId: PowerSourceTag.Grid.namespaceId, tag: PowerSourceTag.Grid.tag, label: null }],
@@ -72,4 +26,3 @@ export class BatteryStorage extends MatterbridgeEndpoint {
             .addRequiredClusterServers();
     }
 }
-//# sourceMappingURL=batteryStorage.js.map

package/dist/devices/cooktop.js

@@ -1,45 +1,7 @@
-/**
- * @description This file contains the Cooktop class.
- * @file src/devices/cooktop.ts
- * @author Luca Liguori
- * @created 2025-05-25
- * @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.
- */
-// Matterbridge
 import { cookSurface, cooktop, powerSource } from '../matterbridgeDeviceTypes.js';
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
 import { createLevelTemperatureControlClusterServer } from './temperatureControl.js';
 export class Cooktop extends MatterbridgeEndpoint {
-    /**
-     * Creates an instance of the Cooktop class.
-     *
-     * @param {string} name - The name of the cooktop.
-     * @param {string} serial - The serial number of the cooktop.
-     *
-     * @remarks
-     * 13.8 A cooktop is a cooking surface that heats food either by transferring currents from an electromagnetic
-     * field located below the glass surface directly to the magnetic induction cookware placed
-     * above or through traditional gas or electric burners.
-     *
-     * 13.8.4 A Cooktop SHALL be composed of zero or more endpoints with the Cook Surface device type.
-     * An Cooktop is always defined via endpoint composition.
-     * - Use `addSurface` to add one or more surfaces to the cooktop.
-     */
     constructor(name, serial) {
         super([cooktop, powerSource], { uniqueStorageKey: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` }, true);
         this.createDefaultIdentifyClusterServer();
@@ -48,22 +10,6 @@ export class Cooktop extends MatterbridgeEndpoint {
         this.createOffOnlyOnOffClusterServer(true);
         this.addFixedLabel('composed', 'Cooktop');
     }
-    /**
-     * Adds a surface to the cooktop.
-     *
-     * @param {string} name - The name of the surface.
-     * @param {Semtag[]} tagList - The tagList associated with the surface.
-     * @param {number} selectedTemperatureLevel - The selected temperature level as an index of the supportedTemperatureLevels array. Defaults to 2 (which corresponds to 'Level 3').
-     * @param {string[]} supportedTemperatureLevels - The list of supported temperature levels for the surface. Defaults to ['Level 1', 'Level 2', 'Level 3', 'Level 4', 'Level 5'].
-     *
-     * @returns {MatterbridgeEndpoint} The MatterbridgeEndpoint instance representing the surface.
-     *
-     * @remarks
-     * 13.7 A Cook Surface device type represents a heating object on a cooktop or other similar device. It
-     * SHALL only be used when composed as part of another device type.
-     *
-     * The OnOff cluster is off only mandatory for all Cook Surface devices!
-     */
     addSurface(name, tagList, selectedTemperatureLevel = 2, supportedTemperatureLevels = ['Level 1', 'Level 2', 'Level 3', 'Level 4', 'Level 5']) {
         const surface = this.addChildDeviceType(name, cookSurface, { tagList }, true);
         surface.log.logName = name;
@@ -73,4 +19,3 @@ export class Cooktop extends MatterbridgeEndpoint {
         return surface;
     }
 }
-//# sourceMappingURL=cooktop.js.map