@matterbridge/core 3.5.3 → 3.5.4-dev-20260211-520e349

package/dist/deviceManager.js

@@ -1,41 +1,9 @@
-/**
- * This file contains the DeviceManager class.
- *
- * @file devices.ts
- * @author Luca Liguori
- * @created 2024-07-26
- * @version 1.1.2
- * @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 } from 'node-ansi-logger';
-// @matterbridge
 import { hasParameter } from '@matterbridge/utils';
 import { dev } from '@matterbridge/types';
 import { BroadcastServer } from '@matterbridge/thread';
-/**
- * Converts a MatterbridgeEndpoint to a BaseDevice.
- *
- * @param {MatterbridgeEndpoint} device The MatterbridgeEndpoint to convert.
- * @returns {BaseDevice} The converted BaseDevice.
- */
 export function toBaseDevice(device) {
     return {
-        // MatterbridgeEndpoint properties
         mode: device.mode,
         plugin: device.plugin,
         configUrl: device.configUrl,
@@ -55,25 +23,18 @@ export function toBaseDevice(device) {
         originalId: device.originalId,
         name: device.name,
         deviceType: device.deviceType,
-        // Endpoint properties
         number: device.number,
         id: device.id,
     };
 }
-/**
- * Manages Matterbridge devices.
- */
 export class DeviceManager {
     _devices = new Map();
     log;
     server;
     debug = hasParameter('debug') || hasParameter('verbose');
     verbose = hasParameter('verbose');
-    /**
-     * 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));
@@ -129,47 +90,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`);
@@ -178,13 +110,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`);
@@ -192,59 +117,27 @@ 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();
     }
-    /**
-     * Converts a MatterbridgeEndpoint to a BaseDevice.
-     *
-     * @param {MatterbridgeEndpoint} device The MatterbridgeEndpoint to convert.
-     * @returns {BaseDevice} The converted BaseDevice.
-     */
     toBaseDevice(device) {
         return toBaseDevice(device);
     }
-    /**
-     * Gets an array of all devices.
-     *
-     * @returns {MatterbridgeEndpoint[]} An array of all devices.
-     */
     array() {
         return Array.from(this._devices.values());
     }
-    /**
-     * Gets a base array of all devices suitable for serialization.
-     *
-     * @param {string} [pluginName] - Optional plugin name to filter devices.
-     * @returns {ApiDevices[]} A base array of all devices.
-     */
     baseArray(pluginName) {
         const devices = [];
         for (const device of Array.from(this._devices.values())) {
-            // Filter by pluginName if provided
             if (pluginName && pluginName !== device.plugin)
                 continue;
             devices.push(this.toBaseDevice(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;
@@ -258,13 +151,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.d.ts

@@ -1,98 +1,23 @@
-/**
- * @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.
- */
 import { ThermostatUserInterfaceConfiguration } from '@matter/types/clusters/thermostat-user-interface-configuration';
 import { FanControl } from '@matter/types/clusters/fan-control';
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
-/**
- * Options for configuring an {@link AirConditioner} instance.
- *
- * All temperatures in °C. Typical valid range 0–50 unless otherwise noted.
- */
 export interface AirConditionerOptions {
-    /** Local ambient temperature (°C). Default 23. */
     localTemperature?: number;
-    /** Occupied heating setpoint (°C). Default 21. */
     occupiedHeatingSetpoint?: number;
-    /** Occupied cooling setpoint (°C). Default 25. */
     occupiedCoolingSetpoint?: number;
-    /** Minimum setpoint dead band (°C). Default 1. */
     minSetpointDeadBand?: number;
-    /** Minimum heat setpoint limit (°C). Default 0. */
     minHeatSetpointLimit?: number;
-    /** Maximum heat setpoint limit (°C). Default 50. */
     maxHeatSetpointLimit?: number;
-    /** Minimum cool setpoint limit (°C). Default 0. */
     minCoolSetpointLimit?: number;
-    /** Maximum cool setpoint limit (°C). Default 50. */
     maxCoolSetpointLimit?: number;
-    /** Temperature display mode. Default Celsius. */
     temperatureDisplayMode?: ThermostatUserInterfaceConfiguration.TemperatureDisplayMode;
-    /** Keypad lockout mode. Default NoLockout. */
     keypadLockout?: ThermostatUserInterfaceConfiguration.KeypadLockout;
-    /** Schedule programming visibility. Default ScheduleProgrammingPermitted. */
     scheduleProgrammingVisibility?: ThermostatUserInterfaceConfiguration.ScheduleProgrammingVisibility;
-    /** Fan mode. Default Off. */
     fanMode?: FanControl.FanMode;
-    /** Fan mode sequence. Default OffLowMedHighAuto. */
     fanModeSequence?: FanControl.FanModeSequence;
-    /** Target fan percent setting (0–100). Default 0. */
     percentSetting?: number;
-    /** Current fan percent (0–100). Default 0. */
     percentCurrent?: number;
 }
 export declare 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: string, serial: string, options?: AirConditionerOptions);
 }
-//# sourceMappingURL=airConditioner.d.ts.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/types/clusters/thermostat-user-interface-configuration';
 import { FanControl } from '@matter/types/clusters/fan-control';
-// Matterbridge
 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], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` });
@@ -71,4 +15,3 @@ export class AirConditioner extends MatterbridgeEndpoint {
         this.createDefaultFanControlClusterServer(fanMode, fanModeSequence, percentSetting, percentCurrent);
     }
 }
-//# sourceMappingURL=airConditioner.js.map

package/dist/devices/basicVideoPlayer.d.ts

@@ -1,73 +1,16 @@
-/**
- * @description This file contains the BasicVideoPlayer class.
- * @file src/devices/basicVideoPlayer.ts
- * @author Luca Liguori
- * @created 2026-01-25
- * @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.
- */
 import { MaybePromise } from '@matter/general';
 import { MediaPlayback } from '@matter/types/clusters/media-playback';
 import { KeypadInput } from '@matter/types/clusters/keypad-input';
 import { MediaPlaybackServer } from '@matter/node/behaviors/media-playback';
 import { KeypadInputServer } from '@matter/node/behaviors/keypad-input';
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
-/**
- * Options for configuring an {@link AirConditioner} instance.
- *
- * All temperatures in °C. Typical valid range 0–50 unless otherwise noted.
- */
 export interface BasicVideoPlayerOptions {
-    /** Device state */
     onOff?: boolean;
     playbackState?: MediaPlayback.PlaybackState;
 }
 export declare class BasicVideoPlayer extends MatterbridgeEndpoint {
-    /**
-     * Creates an instance of the BasicVideoPlayer class.
-     *
-     * A Video Player (either Basic or Casting) represents a device that is able to play media to a physical
-     * output or to a display screen which is part of the device.
-     *
-     * @param {string} name - The name of the video player.
-     * @param {string} serial - The serial number of the video player.
-     * @param {BasicVideoPlayerOptions} [options] - Optional configuration values. Missing fields use defaults.
-     *
-     * Options defaults:
-     *  - onOff: false
-     *  - playbackState: NotPlaying
-     *
-     * @returns {BasicVideoPlayer} The BasicVideoPlayer instance.
-     *
-     * @remarks Not supported by Google Home.
-     */
     constructor(name: string, serial: string, options?: BasicVideoPlayerOptions);
-    /**
-     * Creates a default Media Playback Cluster Server.
-     *
-     * @param {MediaPlayback.PlaybackState} currentState - The current state of the video player.
-     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
-     */
     createDefaultMediaPlaybackClusterServer(currentState: MediaPlayback.PlaybackState): this;
-    /**
-     * Creates a default Keypad Input Cluster Server.
-     *
-     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
-     */
     createDefaultKeypadInputClusterServer(): this;
 }
 export declare class MatterbridgeMediaPlaybackServer extends MediaPlaybackServer {
@@ -85,4 +28,3 @@ export declare class MatterbridgeKeypadInputServer extends KeypadInputServer {
     initialize(): void;
     sendKey(request: KeypadInput.SendKeyRequest): MaybePromise<KeypadInput.SendKeyResponse>;
 }
-//# sourceMappingURL=basicVideoPlayer.d.ts.map

package/dist/devices/basicVideoPlayer.js

@@ -1,52 +1,11 @@
-/**
- * @description This file contains the BasicVideoPlayer class.
- * @file src/devices/basicVideoPlayer.ts
- * @author Luca Liguori
- * @created 2026-01-25
- * @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.
- */
 import { MediaPlayback } from '@matter/types/clusters/media-playback';
 import { KeypadInput } from '@matter/types/clusters/keypad-input';
 import { MediaPlaybackServer } from '@matter/node/behaviors/media-playback';
 import { KeypadInputServer } from '@matter/node/behaviors/keypad-input';
-// Matterbridge
 import { basicVideoPlayer, powerSource } from '../matterbridgeDeviceTypes.js';
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
 import { MatterbridgeOnOffServer, MatterbridgeServer } from '../matterbridgeBehaviors.js';
 export class BasicVideoPlayer extends MatterbridgeEndpoint {
-    /**
-     * Creates an instance of the BasicVideoPlayer class.
-     *
-     * A Video Player (either Basic or Casting) represents a device that is able to play media to a physical
-     * output or to a display screen which is part of the device.
-     *
-     * @param {string} name - The name of the video player.
-     * @param {string} serial - The serial number of the video player.
-     * @param {BasicVideoPlayerOptions} [options] - Optional configuration values. Missing fields use defaults.
-     *
-     * Options defaults:
-     *  - onOff: false
-     *  - playbackState: NotPlaying
-     *
-     * @returns {BasicVideoPlayer} The BasicVideoPlayer instance.
-     *
-     * @remarks Not supported by Google Home.
-     */
     constructor(name, serial, options = {}) {
         const { onOff = false, playbackState = MediaPlayback.PlaybackState.NotPlaying } = options;
         super([basicVideoPlayer, powerSource], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` });
@@ -56,12 +15,6 @@ export class BasicVideoPlayer extends MatterbridgeEndpoint {
         this.createDefaultMediaPlaybackClusterServer(playbackState);
         this.createDefaultKeypadInputClusterServer();
     }
-    /**
-     * Creates a default Media Playback Cluster Server.
-     *
-     * @param {MediaPlayback.PlaybackState} currentState - The current state of the video player.
-     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
-     */
     createDefaultMediaPlaybackClusterServer(currentState) {
         this.behaviors.require(MatterbridgeMediaPlaybackServer.enable({
             commands: { next: true, previous: true, skipForward: true, skipBackward: true },
@@ -70,15 +23,8 @@ export class BasicVideoPlayer extends MatterbridgeEndpoint {
         });
         return this;
     }
-    /**
-     * Creates a default Keypad Input Cluster Server.
-     *
-     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
-     */
     createDefaultKeypadInputClusterServer() {
-        this.behaviors.require(MatterbridgeKeypadInputServer, {
-        // No attributes to initialize
-        });
+        this.behaviors.require(MatterbridgeKeypadInputServer, {});
         return this;
     }
 }
@@ -152,4 +98,3 @@ export class MatterbridgeKeypadInputServer extends KeypadInputServer {
         return { status: KeypadInput.Status.Success };
     }
 }
-//# sourceMappingURL=basicVideoPlayer.js.map

package/dist/devices/batteryStorage.d.ts

@@ -1,48 +1,5 @@
-/**
- * @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.
- */
 import { PowerSource } from '@matter/types/clusters/power-source';
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
 export declare 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: string, serial: string, batPercentRemaining?: number, batChargeLevel?: PowerSource.BatChargeLevel, voltage?: number | bigint | null, current?: number | bigint | null, power?: number | bigint | null, energyImported?: number | bigint | null, energyExported?: number | bigint | null, absMinPower?: number, absMaxPower?: number);
 }
-//# sourceMappingURL=batteryStorage.d.ts.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/node';
 import { DeviceEnergyManagement } from '@matter/types/clusters/device-energy-management';
 import { PowerSource } from '@matter/types/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(' ', '')}` });
         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