matterbridge 3.1.4-dev-20250717-d36e252 → 3.1.4

package/dist/deviceManager.js

@@ -1,26 +1,87 @@
+/**
+ * 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, er } from 'node-ansi-logger';
 import { dev } from './matterbridgeTypes.js';
+/**
+ * Manages Matterbridge devices.
+ */
 export class DeviceManager {
     _devices = new Map();
     matterbridge;
     log;
+    /**
+     * Creates an instance of DeviceManager.
+     *
+     * @param {Matterbridge} matterbridge - The Matterbridge instance.
+     */
     constructor(matterbridge) {
         this.matterbridge = matterbridge;
-        this.log = new AnsiLogger({ logName: 'DeviceManager', logTimestampFormat: 4, logLevel: matterbridge.log.logLevel });
+        this.log = new AnsiLogger({ logName: 'DeviceManager', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: matterbridge.log.logLevel });
         this.log.debug('Matterbridge device manager starting...');
     }
+    /**
+     * 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`);
@@ -29,6 +90,13 @@ 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`);
@@ -36,15 +104,34 @@ 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());
     }
+    /**
+     * 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;
@@ -58,7 +145,13 @@ 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/deviceManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceManager.js","sourceRoot":"","sources":["../src/deviceManager.ts"],"names":[],"mappings":"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"}

package/dist/devices/batteryStorage.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @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/main/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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batteryStorage.d.ts","sourceRoot":"","sources":["../../src/devices/batteryStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAGjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGlE,qBAAa,cAAe,SAAQ,oBAAoB;IACtD;;;;;;;;;;;;;;;;;;OAkBG;gBAED,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,mBAAmB,GAAE,MAAY,EACjC,cAAc,GAAE,WAAW,CAAC,cAA8C,EAC1E,OAAO,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EACtC,OAAO,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EACtC,KAAK,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EACpC,cAAc,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EAC7C,cAAc,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EAC7C,WAAW,GAAE,MAAU,EACvB,WAAW,GAAE,MAAU;CA0B1B"}

package/dist/devices/batteryStorage.js

@@ -1,9 +1,53 @@
+/**
+ * @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()
@@ -14,10 +58,12 @@ 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)
+            .createDefaultPowerSourceRechargeableBatteryClusterServer(batPercentRemaining, batChargeLevel, 24_000) // Battery voltage in mV (24V).
             .addRequiredClusterServers();
         this.addChildDeviceType('GridPowerSource', powerSource, {
             tagList: [{ mfgCode: null, namespaceId: PowerSourceTag.Grid.namespaceId, tag: PowerSourceTag.Grid.tag, label: null }],
@@ -26,3 +72,4 @@ export class BatteryStorage extends MatterbridgeEndpoint {
             .addRequiredClusterServers();
     }
 }
+//# sourceMappingURL=batteryStorage.js.map

package/dist/devices/batteryStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batteryStorage.js","sourceRoot":"","sources":["../../src/devices/batteryStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,UAAU;AACV,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAe;AACf,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEtH,MAAM,OAAO,cAAe,SAAQ,oBAAoB;IACtD;;;;;;;;;;;;;;;;;;OAkBG;IACH,YACE,IAAY,EACZ,MAAc,EACd,sBAA8B,GAAG,EACjC,iBAA6C,WAAW,CAAC,cAAc,CAAC,EAAE,EAC1E,UAAkC,IAAI,EACtC,UAAkC,IAAI,EACtC,QAAgC,IAAI,EACpC,iBAAyC,IAAI,EAC7C,iBAAyC,IAAI,EAC7C,cAAsB,CAAC,EACvB,cAAsB,CAAC;QAEvB,KAAK,CAAC,CAAC,cAAc,EAAE,gBAAgB,EAAE,sBAAsB,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAC7I,IAAI,CAAC,kCAAkC,EAAE;aACtC,0CAA0C,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,0BAA0B,CAAC;aACpH,uCAAuC,EAAE;aACzC,oDAAoD,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC;aAC7E,qDAAqD,CAAC,cAAc,EAAE,cAAc,CAAC;aACrF,gDAAgD,CAAC,sBAAsB,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE,sBAAsB,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC;aACvK,oDAAoD,EAAE;aACtD,yBAAyB,EAAE,CAAC;QAE/B,2IAA2I;QAC3I,yDAAyD;QACzD,IAAI,CAAC,kBAAkB,CAAC,oBAAoB,EAAE,WAAW,EAAE;YACzD,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SAC5H,CAAC;aACC,wDAAwD,CAAC,mBAAmB,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,+BAA+B;aACrI,yBAAyB,EAAE,CAAC;QAE/B,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,EAAE,WAAW,EAAE;YACtD,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SACtH,CAAC;aACC,0CAA0C,EAAE;aAC5C,yBAAyB,EAAE,CAAC;IACjC,CAAC;CACF"}

package/dist/devices/evse.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @description This file contains the Evse class.
+ * @file src/devices/energy-evse.ts
+ * @author Luca Liguori
+ * @contributor Ludovic BOUÉ
+ * @created 2025-05-27
+ * @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 { MaybePromise } from '@matter/main';
+import { EnergyEvseServer } from '@matter/main/behaviors/energy-evse';
+import { EnergyEvseModeServer } from '@matter/main/behaviors/energy-evse-mode';
+import { EnergyEvse, EnergyEvseMode } from '@matter/main/clusters';
+import { ModeBase } from '@matter/main/clusters/mode-base';
+import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
+export declare class Evse extends MatterbridgeEndpoint {
+    /**
+     * Creates an instance of the EVSE class.
+     *
+     * @param {string} name - The name of the EVSE.
+     * @param {string} serial - The serial number of the EVSE.
+     * @param {number} [currentMode] - The current mode of the EnergyEvseMode cluster. Defaults to mode 1 (EnergyEvseMode.ModeTag.Manual).
+     * @param {EnergyEvseMode.ModeOption[]} [supportedModes] - The supported modes for the EnergyEvseMode cluster. This is a fixed attribute that defaults to a predefined set of EnergyEvseMode cluster modes.
+     * @param {EnergyEvse.State} [state] - The current state of the EVSE. Defaults to NotPluggedIn.
+     * @param {EnergyEvse.SupplyState} [supplyState] - The supply state of the EVSE. Defaults to Disabled.
+     * @param {EnergyEvse.FaultState} [faultState] - The fault state of the EVSE. Defaults to NoError.
+     * @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: string, serial: string, currentMode?: number, supportedModes?: EnergyEvseMode.ModeOption[], state?: EnergyEvse.State, supplyState?: EnergyEvse.SupplyState, faultState?: EnergyEvse.FaultState, voltage?: number | bigint | null, current?: number | bigint | null, power?: number | bigint | null, energy?: number | bigint | null, absMinPower?: number, absMaxPower?: number);
+    /**
+     * Creates a default EnergyEvseServer Cluster Server.
+     *
+     * @param {EnergyEvse.State} [state] - The initial state of the EnergyEvse cluster. Defaults to EnergyEvse.State.NotPluggedIn.
+     * @param {EnergyEvse.SupplyState} [supplyState] - The initial supply state of the EnergyEvse cluster. Defaults to EnergyEvse.SupplyState.ChargingEnabled.
+     * @param {EnergyEvse.FaultState} [faultState] - The initial fault state of the EnergyEvse cluster. Defaults to EnergyEvse.FaultState.NoError.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
+    createDefaultEnergyEvseClusterServer(state?: EnergyEvse.State, supplyState?: EnergyEvse.SupplyState, faultState?: EnergyEvse.FaultState): this;
+    /**
+     * Creates a default EnergyEvseMode Cluster Server.
+     *
+     * @param {number} [currentMode] - The current mode of the EnergyEvseMode cluster. Defaults to mode 1 (EnergyEvseMode.ModeTag.Manual).
+     * @param {EnergyEvseMode.ModeOption[]} [supportedModes] - The supported modes for the EnergyEvseMode cluster. Defaults all EnergyEvseMode cluster modes.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
+    createDefaultEnergyEvseModeClusterServer(currentMode?: number, supportedModes?: EnergyEvseMode.ModeOption[]): this;
+}
+export declare class MatterbridgeEnergyEvseServer extends EnergyEvseServer {
+    disable(): MaybePromise;
+    enableCharging(request: EnergyEvse.EnableChargingRequest): MaybePromise;
+}
+export declare class MatterbridgeEnergyEvseModeServer extends EnergyEvseModeServer {
+    changeToMode(request: ModeBase.ChangeToModeRequest): MaybePromise<ModeBase.ChangeToModeResponse>;
+}
+//# sourceMappingURL=evse.d.ts.map

package/dist/devices/evse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evse.d.ts","sourceRoot":"","sources":["../../src/devices/evse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAIlE,qBAAa,IAAK,SAAQ,oBAAoB;IAC5C;;;;;;;;;;;;;;;;OAgBG;gBAED,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,cAAc,CAAC,UAAU,EAAE,EAC5C,KAAK,CAAC,EAAE,UAAU,CAAC,KAAK,EACxB,WAAW,CAAC,EAAE,UAAU,CAAC,WAAW,EACpC,UAAU,CAAC,EAAE,UAAU,CAAC,UAAU,EAClC,OAAO,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EACtC,OAAO,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EACtC,KAAK,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EACpC,MAAM,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EACrC,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM;IAgBtB;;;;;;;OAOG;IACH,oCAAoC,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI;IAiB9I;;;;;;;OAOG;IACH,wCAAwC,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc,CAAC,UAAU,EAAE,GAAG,IAAI;CAYnH;AAED,qBAAa,4BAA6B,SAAQ,gBAAgB;IACvD,OAAO,IAAI,YAAY;IAavB,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,qBAAqB,GAAG,YAAY;CAgBjF;AAED,qBAAa,gCAAiC,SAAQ,oBAAoB;IAC/D,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,mBAAmB,GAAG,YAAY,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CAa1G"}

package/dist/devices/evse.js

@@ -1,12 +1,53 @@
+/**
+ * @description This file contains the Evse class.
+ * @file src/devices/energy-evse.ts
+ * @author Luca Liguori
+ * @contributor Ludovic BOUÉ
+ * @created 2025-05-27
+ * @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 { EnergyEvseServer } from '@matter/main/behaviors/energy-evse';
 import { EnergyEvseModeServer } from '@matter/main/behaviors/energy-evse-mode';
 import { EnergyEvse, EnergyEvseMode } from '@matter/main/clusters';
 import { DeviceEnergyManagement } from '@matter/main/clusters/device-energy-management';
 import { ModeBase } from '@matter/main/clusters/mode-base';
+// Matterbridge
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
 import { MatterbridgeServer } from '../matterbridgeBehaviors.js';
 import { deviceEnergyManagement, electricalSensor, evse, powerSource } from '../matterbridgeDeviceTypes.js';
 export class Evse extends MatterbridgeEndpoint {
+    /**
+     * Creates an instance of the EVSE class.
+     *
+     * @param {string} name - The name of the EVSE.
+     * @param {string} serial - The serial number of the EVSE.
+     * @param {number} [currentMode] - The current mode of the EnergyEvseMode cluster. Defaults to mode 1 (EnergyEvseMode.ModeTag.Manual).
+     * @param {EnergyEvseMode.ModeOption[]} [supportedModes] - The supported modes for the EnergyEvseMode cluster. This is a fixed attribute that defaults to a predefined set of EnergyEvseMode cluster modes.
+     * @param {EnergyEvse.State} [state] - The current state of the EVSE. Defaults to NotPluggedIn.
+     * @param {EnergyEvse.SupplyState} [supplyState] - The supply state of the EVSE. Defaults to Disabled.
+     * @param {EnergyEvse.FaultState} [faultState] - The fault state of the EVSE. Defaults to NoError.
+     * @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, currentMode, supportedModes, state, supplyState, faultState, voltage = null, current = null, power = null, energy = null, absMinPower, absMaxPower) {
         super([evse, powerSource, electricalSensor, deviceEnergyManagement], { uniqueStorageKey: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` }, true);
         this.createDefaultIdentifyClusterServer()
@@ -21,30 +62,47 @@ export class Evse extends MatterbridgeEndpoint {
             .createDefaultEnergyEvseModeClusterServer(currentMode, supportedModes)
             .addRequiredClusterServers();
     }
+    /**
+     * Creates a default EnergyEvseServer Cluster Server.
+     *
+     * @param {EnergyEvse.State} [state] - The initial state of the EnergyEvse cluster. Defaults to EnergyEvse.State.NotPluggedIn.
+     * @param {EnergyEvse.SupplyState} [supplyState] - The initial supply state of the EnergyEvse cluster. Defaults to EnergyEvse.SupplyState.ChargingEnabled.
+     * @param {EnergyEvse.FaultState} [faultState] - The initial fault state of the EnergyEvse cluster. Defaults to EnergyEvse.FaultState.NoError.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultEnergyEvseClusterServer(state, supplyState, faultState) {
         this.behaviors.require(MatterbridgeEnergyEvseServer, {
             state: state !== undefined ? state : EnergyEvse.State.NotPluggedIn,
             supplyState: supplyState !== undefined ? supplyState : EnergyEvse.SupplyState.ChargingEnabled,
             faultState: faultState !== undefined ? faultState : EnergyEvse.FaultState.NoError,
-            chargingEnabledUntil: null,
-            circuitCapacity: 32_000,
-            minimumChargeCurrent: 6_000,
-            maximumChargeCurrent: 32_000,
-            userMaximumChargeCurrent: 32_000,
-            sessionId: null,
-            sessionDuration: null,
-            sessionEnergyCharged: null,
+            chargingEnabledUntil: null, // Persistent attribute. A null value indicates the EVSE is always enabled for charging.
+            circuitCapacity: 32_000, // Persistent attribute in mA. 32A in mA.
+            minimumChargeCurrent: 6_000, // Persistent attribute in mA. 6A in mA.
+            maximumChargeCurrent: 32_000, // Persistent attribute in mA. 32A in mA.
+            userMaximumChargeCurrent: 32_000, // Persistent attribute in mA. 32A in mA.
+            sessionId: null, // Persistent attribute
+            sessionDuration: null, // Persistent attribute
+            sessionEnergyCharged: null, // Persistent attribute
         });
         return this;
     }
+    /**
+     * Creates a default EnergyEvseMode Cluster Server.
+     *
+     * @param {number} [currentMode] - The current mode of the EnergyEvseMode cluster. Defaults to mode 1 (EnergyEvseMode.ModeTag.Manual).
+     * @param {EnergyEvseMode.ModeOption[]} [supportedModes] - The supported modes for the EnergyEvseMode cluster. Defaults all EnergyEvseMode cluster modes.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultEnergyEvseModeClusterServer(currentMode, supportedModes) {
         this.behaviors.require(MatterbridgeEnergyEvseModeServer, {
             supportedModes: supportedModes ?? [
                 { label: 'On demand', mode: 1, modeTags: [{ value: EnergyEvseMode.ModeTag.Manual }] },
                 { label: 'Scheduled', mode: 2, modeTags: [{ value: EnergyEvseMode.ModeTag.TimeOfUse }] },
                 { label: 'Solar charging', mode: 3, modeTags: [{ value: EnergyEvseMode.ModeTag.SolarCharging }] },
-            ],
-            currentMode: currentMode ?? 1,
+                // { label: 'Home to vehicle and Vehicle to home', mode: 4, modeTags: [{ value: EnergyEvseMode.ModeTag.V2X }] }, // This mode is not valid in charging only EVSEs
+            ], // FixedAttribute
+            currentMode: currentMode ?? 1, // Persistent attribute
         });
         return this;
     }
@@ -60,6 +118,8 @@ export class MatterbridgeEnergyEvseServer extends EnergyEvseServer {
             this.state.state = EnergyEvse.State.PluggedInDemand;
         }
         this.state.chargingEnabledUntil = 0;
+        // super.disable();
+        // disable is not implemented in matter.js
     }
     enableCharging(request) {
         const device = this.endpoint.stateOf(MatterbridgeServer);
@@ -73,6 +133,9 @@ export class MatterbridgeEnergyEvseServer extends EnergyEvseServer {
         this.state.chargingEnabledUntil = request.chargingEnabledUntil;
         this.state.minimumChargeCurrent = request.minimumChargeCurrent;
         this.state.maximumChargeCurrent = request.maximumChargeCurrent;
+        // The implementation should also stop the charging session at the required time and update the sessionId, sessionDuration, and sessionEnergyCharged attributes if needed.
+        // super.enableCharging();
+        // enableCharging is not implemented in matter.js
     }
 }
 export class MatterbridgeEnergyEvseModeServer extends EnergyEvseModeServer {
@@ -90,3 +153,4 @@ export class MatterbridgeEnergyEvseModeServer extends EnergyEvseModeServer {
         return { status: ModeBase.ModeChangeStatus.Success, statusText: 'Success' };
     }
 }
+//# sourceMappingURL=evse.js.map

package/dist/devices/evse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evse.js","sourceRoot":"","sources":["../../src/devices/evse.ts"],"names":[],"mappings":"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"}

package/dist/devices/export.d.ts

@@ -0,0 +1,9 @@
+export * from './roboticVacuumCleaner.js';
+export * from './laundryWasher.js';
+export * from './laundryDryer.js';
+export * from './waterHeater.js';
+export * from './evse.js';
+export * from './solarPower.js';
+export * from './batteryStorage.js';
+export * from './heatPump.js';
+//# sourceMappingURL=export.d.ts.map

package/dist/devices/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/devices/export.ts"],"names":[],"mappings":"AACA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC"}

package/dist/devices/export.js

@@ -1,3 +1,4 @@
+// Single class device types
 export * from './roboticVacuumCleaner.js';
 export * from './laundryWasher.js';
 export * from './laundryDryer.js';
@@ -6,3 +7,4 @@ export * from './evse.js';
 export * from './solarPower.js';
 export * from './batteryStorage.js';
 export * from './heatPump.js';
+//# sourceMappingURL=export.js.map

package/dist/devices/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/devices/export.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC"}

package/dist/devices/heatPump.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @description This file contains the HeatPump class.
+ * @file src/devices/heatPump.ts
+ * @author Luca Liguori
+ * @created 2025-06-29
+ * @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 { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
+export declare class HeatPump extends MatterbridgeEndpoint {
+    /**
+     * Creates an instance of the HeatPump class.
+     *
+     * @param {string} name - The name of the HeatPump.
+     * @param {string} serial - The serial number of the HeatPump.
+     * @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} [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
+     * - The HeatPump includes clusters for power source, electrical power measurement, electrical energy measurement, and device energy management.
+     * - It also includes child devices for flow temperature, return temperature, and a thermostat.
+     * - The flow and return temperature sensors are set to default values of 45.00°C and 35.00°C respectively.
+     * - The heating only thermostat is set up with a default temperature setpoint of 21.00°C.
+     * - The device energy management cluster is set to `esaType` as `SpaceHeating`, `esaCanGenerate` as `false`, and `esaState` as `Online`.
+     * - The absolute minimum and maximum power values can be set to indicate the range of power consumption for the heat pump.
+     */
+    constructor(name: string, serial: string, voltage?: number | bigint | null, current?: number | bigint | null, power?: number | bigint | null, energyImported?: number | bigint | null, absMinPower?: number, absMaxPower?: number);
+}
+//# sourceMappingURL=heatPump.d.ts.map

package/dist/devices/heatPump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heatPump.d.ts","sourceRoot":"","sources":["../../src/devices/heatPump.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAOH,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGlE,qBAAa,QAAS,SAAQ,oBAAoB;IAChD;;;;;;;;;;;;;;;;;;;OAmBG;gBAED,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EACtC,OAAO,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EACtC,KAAK,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EACpC,cAAc,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EAC7C,WAAW,GAAE,MAAU,EACvB,WAAW,GAAE,MAAU;CAyC1B"}