matterbridge 3.3.3-dev-20251018-66ae7a4 → 3.3.3

package/dist/devices/airConditioner.js

@@ -1,8 +1,64 @@
+/**
+ * @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);
@@ -15,3 +71,4 @@ export class AirConditioner extends MatterbridgeEndpoint {
         this.createDefaultFanControlClusterServer(fanMode, fanModeSequence, percentSetting, percentCurrent);
     }
 }
+//# sourceMappingURL=airConditioner.js.map

package/dist/devices/airConditioner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"airConditioner.js","sourceRoot":"","sources":["../../src/devices/airConditioner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,uBAAuB;AACvB,OAAO,EAAE,oCAAoC,EAAE,MAAM,+DAA+D,CAAC;AACrH,eAAe;AACf,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAwClE,MAAM,OAAO,cAAe,SAAQ,oBAAoB;IACtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,YAAY,IAAY,EAAE,MAAc,EAAE,UAAiC,EAAE;QAC3E,MAAM,EACJ,gBAAgB,GAAG,EAAE,EACrB,uBAAuB,GAAG,EAAE,EAC5B,uBAAuB,GAAG,EAAE,EAC5B,mBAAmB,GAAG,CAAC,EACvB,oBAAoB,GAAG,CAAC,EACxB,oBAAoB,GAAG,EAAE,EACzB,oBAAoB,GAAG,CAAC,EACxB,oBAAoB,GAAG,EAAE,EACzB,sBAAsB,GAAG,oCAAoC,CAAC,sBAAsB,CAAC,OAAO,EAC5F,aAAa,GAAG,oCAAoC,CAAC,aAAa,CAAC,SAAS,EAC5E,6BAA6B,GAAG,oCAAoC,CAAC,6BAA6B,CAAC,4BAA4B,EAC/H,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAChC,eAAe,GAAG,UAAU,CAAC,eAAe,CAAC,iBAAiB,EAC9D,cAAc,GAAG,CAAC,EAClB,cAAc,GAAG,CAAC,GACnB,GAAG,OAAO,CAAC;QACZ,KAAK,CAAC,CAAC,cAAc,EAAE,WAAW,CAAC,EAAE,EAAE,gBAAgB,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;QAC9H,IAAI,CAAC,kCAAkC,EAAE,CAAC;QAC1C,IAAI,CAAC,0CAA0C,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,8BAA8B,CAAC,CAAC;QAC9H,IAAI,CAAC,0CAA0C,EAAE,CAAC;QAClD,IAAI,CAAC,iCAAiC,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,oCAAoC,CAAC,gBAAgB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,oBAAoB,CAAC,CAAC;QAC3N,IAAI,CAAC,8DAA8D,CAAC,sBAAsB,EAAE,aAAa,EAAE,6BAA6B,CAAC,CAAC;QAC1I,IAAI,CAAC,oCAAoC,CAAC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;IACtG,CAAC;CACF"}

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/cooktop.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @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.
+ */
+import { Semtag } from '@matter/types';
+import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
+export declare 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: string, serial: string);
+    /**
+     * 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: string, tagList: Semtag[], selectedTemperatureLevel?: number, supportedTemperatureLevels?: string[]): MatterbridgeEndpoint;
+}
+//# sourceMappingURL=cooktop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cooktop.d.ts","sourceRoot":"","sources":["../../src/devices/cooktop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAIvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAIlE,qBAAa,OAAQ,SAAQ,oBAAoB;IAC/C;;;;;;;;;;;;;;OAcG;gBACS,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IASxC;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,wBAAwB,GAAE,MAAU,EAAE,0BAA0B,GAAE,MAAM,EAA4D,GAAG,oBAAoB;CAQxM"}

package/dist/devices/cooktop.js

@@ -1,7 +1,45 @@
+/**
+ * @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();
@@ -10,6 +48,22 @@ 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;
@@ -19,3 +73,4 @@ export class Cooktop extends MatterbridgeEndpoint {
         return surface;
     }
 }
+//# sourceMappingURL=cooktop.js.map

package/dist/devices/cooktop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cooktop.js","sourceRoot":"","sources":["../../src/devices/cooktop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,EAAE,0CAA0C,EAAE,MAAM,yBAAyB,CAAC;AAErF,MAAM,OAAO,OAAQ,SAAQ,oBAAoB;IAC/C;;;;;;;;;;;;;;OAcG;IACH,YAAY,IAAY,EAAE,MAAc;QACtC,KAAK,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,EAAE,gBAAgB,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;QACvH,IAAI,CAAC,kCAAkC,EAAE,CAAC;QAC1C,IAAI,CAAC,0CAA0C,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QACzG,IAAI,CAAC,0CAA0C,EAAE,CAAC;QAClD,IAAI,CAAC,+BAA+B,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,IAAY,EAAE,OAAiB,EAAE,2BAAmC,CAAC,EAAE,6BAAuC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;QAC9K,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9E,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,0CAA0C,CAAC,OAAO,EAAE,wBAAwB,EAAE,0BAA0B,CAAC,CAAC;QAC1G,OAAO,CAAC,gDAAgD,CAAC,IAAI,CAAC,CAAC;QAC/D,OAAO,CAAC,+BAA+B,CAAC,IAAI,CAAC,CAAC;QAC9C,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/devices/dishwasher.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @description This file contains the Dishwasher class.
+ * @file src/devices/dishwasher.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.
+ */
+import { MaybePromise } from '@matter/main';
+import { OperationalState } from '@matter/main/clusters/operational-state';
+import { ModeBase } from '@matter/main/clusters/mode-base';
+import { DishwasherModeServer } from '@matter/main/behaviors/dishwasher-mode';
+import { DishwasherMode } from '@matter/main/clusters/dishwasher-mode';
+import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
+export declare class Dishwasher extends MatterbridgeEndpoint {
+    /**
+     * Creates an instance of the DishWasher class.
+     *
+     * @param {string} name - The name of the dish washer.
+     * @param {string} serial - The serial number of the dish washer.
+     * @param {number} [currentMode] - The current mode of the dish washer. Defaults to 2 (Normal mode). Dead Front OnOff Cluster will set this to 2 when turned off. Persistent attribute.
+     * @param {DishwasherMode.ModeOption[]} [supportedModes] - The supported modes of the dish washer. Defaults to a set of common modes (which include Light, Normal, Heavy). Fixed attribute.
+     * @param {number} [selectedTemperatureLevel] - The selected temperature level as an index of the supportedTemperatureLevels array. Defaults to 1 (which corresponds to 'Warm').
+     * @param {string[]} [supportedTemperatureLevels] - The supported temperature levels. Defaults to ['Cold', 'Warm', 'Hot', '30°', '40°', '60°', '80°']. Fixed attribute.
+     * @param {number} [temperatureSetpoint] - The temperature setpoint * 100. Defaults to 40 * 100 (which corresponds to 40°C).
+     * @param {number} [minTemperature] - The minimum temperature * 100. Defaults to 30 * 100 (which corresponds to 30°C). Fixed attribute.
+     * @param {number} [maxTemperature] - The maximum temperature * 100. Defaults to 60 * 100 (which corresponds to 60°C). Fixed attribute.
+     * @param {number} [step] - The step size for temperature changes. Defaults to 10 * 100 (which corresponds to 10°C). Fixed attribute.
+     * @param {OperationalState.OperationalStateEnum} [operationalState] - The operational state of the laundry washer. Defaults to OperationalState.OperationalStateEnum.Off.
+     *
+     * Remarks:
+     * - If `temperatureSetpoint` is provided, the `createNumberTemperatureControlClusterServer` method will be used to create the TemperatureControl Cluster Server with features TemperatureNumber and TemperatureStep.
+     * - If `temperatureSetpoint` is not provided, the `createLevelTemperatureControlClusterServer` method will be used to create the TemperatureControl Cluster Server with feature TemperatureLevel.
+     */
+    constructor(name: string, serial: string, currentMode?: number, supportedModes?: DishwasherMode.ModeOption[], selectedTemperatureLevel?: number, supportedTemperatureLevels?: string[], temperatureSetpoint?: number, minTemperature?: number, maxTemperature?: number, step?: number, operationalState?: OperationalState.OperationalStateEnum);
+    /**
+     * Creates a default Dishwasher Mode Cluster Server.
+     *
+     * @param {number} currentMode - The current mode of the dishwasher. Persistent attribute.
+     * @param {DishwasherMode.ModeOption[]} supportedModes - The supported modes of the dishwasher. Defaults to a set of common modes (Light, Normal, Heavy). Fixed attribute.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
+    createDefaultDishwasherModeClusterServer(currentMode?: number, supportedModes?: DishwasherMode.ModeOption[]): this;
+    /**
+     * Creates a default Dishwasher Alarm Cluster Server.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
+    createDefaultDishwasherAlarmClusterServer(): this;
+}
+export declare class MatterbridgeDishwasherModeServer extends DishwasherModeServer {
+    initialize(): void;
+    protected handleOnOffChange(onOff: boolean): void;
+    changeToMode(request: ModeBase.ChangeToModeRequest): MaybePromise<ModeBase.ChangeToModeResponse>;
+}
+//# sourceMappingURL=dishwasher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dishwasher.d.ts","sourceRoot":"","sources":["../../src/devices/dishwasher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAIvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAKlE,qBAAa,UAAW,SAAQ,oBAAoB;IAClD;;;;;;;;;;;;;;;;;;OAkBG;gBAED,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,cAAc,CAAC,UAAU,EAAE,EAC5C,wBAAwB,CAAC,EAAE,MAAM,EACjC,0BAA0B,CAAC,EAAE,MAAM,EAAE,EACrC,mBAAmB,CAAC,EAAE,MAAM,EAC5B,cAAc,CAAC,EAAE,MAAM,EACvB,cAAc,CAAC,EAAE,MAAM,EACvB,IAAI,CAAC,EAAE,MAAM,EACb,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,oBAAoB;IAc1D;;;;;;;OAOG;IACH,wCAAwC,CACtC,WAAW,GAAE,MAAU,EACvB,cAAc,GAAE,cAAc,CAAC,UAAU,EAIxC,GACA,IAAI;IAQP;;;;OAIG;IACH,yCAAyC,IAAI,IAAI;CAQlD;AAED,qBAAa,gCAAiC,SAAQ,oBAAoB;IAC/D,UAAU;IAQnB,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,OAAO;IAQjC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,mBAAmB,GAAG,YAAY,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CAc1G"}

package/dist/devices/dishwasher.js

@@ -1,12 +1,54 @@
+/**
+ * @description This file contains the Dishwasher class.
+ * @file src/devices/dishwasher.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.
+ */
 import { ModeBase } from '@matter/main/clusters/mode-base';
 import { DishwasherModeServer } from '@matter/main/behaviors/dishwasher-mode';
 import { DishwasherAlarmServer } from '@matter/main/behaviors/dishwasher-alarm';
 import { DishwasherMode } from '@matter/main/clusters/dishwasher-mode';
+// Matterbridge
 import { dishwasher, powerSource } from '../matterbridgeDeviceTypes.js';
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
 import { MatterbridgeOnOffServer, MatterbridgeServer } from '../matterbridgeBehaviors.js';
 import { createLevelTemperatureControlClusterServer, createNumberTemperatureControlClusterServer } from './temperatureControl.js';
 export class Dishwasher extends MatterbridgeEndpoint {
+    /**
+     * Creates an instance of the DishWasher class.
+     *
+     * @param {string} name - The name of the dish washer.
+     * @param {string} serial - The serial number of the dish washer.
+     * @param {number} [currentMode] - The current mode of the dish washer. Defaults to 2 (Normal mode). Dead Front OnOff Cluster will set this to 2 when turned off. Persistent attribute.
+     * @param {DishwasherMode.ModeOption[]} [supportedModes] - The supported modes of the dish washer. Defaults to a set of common modes (which include Light, Normal, Heavy). Fixed attribute.
+     * @param {number} [selectedTemperatureLevel] - The selected temperature level as an index of the supportedTemperatureLevels array. Defaults to 1 (which corresponds to 'Warm').
+     * @param {string[]} [supportedTemperatureLevels] - The supported temperature levels. Defaults to ['Cold', 'Warm', 'Hot', '30°', '40°', '60°', '80°']. Fixed attribute.
+     * @param {number} [temperatureSetpoint] - The temperature setpoint * 100. Defaults to 40 * 100 (which corresponds to 40°C).
+     * @param {number} [minTemperature] - The minimum temperature * 100. Defaults to 30 * 100 (which corresponds to 30°C). Fixed attribute.
+     * @param {number} [maxTemperature] - The maximum temperature * 100. Defaults to 60 * 100 (which corresponds to 60°C). Fixed attribute.
+     * @param {number} [step] - The step size for temperature changes. Defaults to 10 * 100 (which corresponds to 10°C). Fixed attribute.
+     * @param {OperationalState.OperationalStateEnum} [operationalState] - The operational state of the laundry washer. Defaults to OperationalState.OperationalStateEnum.Off.
+     *
+     * Remarks:
+     * - If `temperatureSetpoint` is provided, the `createNumberTemperatureControlClusterServer` method will be used to create the TemperatureControl Cluster Server with features TemperatureNumber and TemperatureStep.
+     * - If `temperatureSetpoint` is not provided, the `createLevelTemperatureControlClusterServer` method will be used to create the TemperatureControl Cluster Server with feature TemperatureLevel.
+     */
     constructor(name, serial, currentMode, supportedModes, selectedTemperatureLevel, supportedTemperatureLevels, temperatureSetpoint, minTemperature, maxTemperature, step, operationalState) {
         super([dishwasher, powerSource], { uniqueStorageKey: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` }, true);
         this.createDefaultIdentifyClusterServer();
@@ -21,6 +63,14 @@ export class Dishwasher extends MatterbridgeEndpoint {
             createLevelTemperatureControlClusterServer(this, selectedTemperatureLevel, supportedTemperatureLevels);
         this.createDefaultOperationalStateClusterServer(operationalState);
     }
+    /**
+     * Creates a default Dishwasher Mode Cluster Server.
+     *
+     * @param {number} currentMode - The current mode of the dishwasher. Persistent attribute.
+     * @param {DishwasherMode.ModeOption[]} supportedModes - The supported modes of the dishwasher. Defaults to a set of common modes (Light, Normal, Heavy). Fixed attribute.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultDishwasherModeClusterServer(currentMode = 2, supportedModes = [
         { label: 'Light', mode: 1, modeTags: [{ value: DishwasherMode.ModeTag.Light }] },
         { label: 'Normal', mode: 2, modeTags: [{ value: DishwasherMode.ModeTag.Normal }] },
@@ -32,6 +82,11 @@ export class Dishwasher extends MatterbridgeEndpoint {
         });
         return this;
     }
+    /**
+     * Creates a default Dishwasher Alarm Cluster Server.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultDishwasherAlarmClusterServer() {
         this.behaviors.require(DishwasherAlarmServer, {
             mask: { inflowError: true, drainError: true, doorError: true, tempTooLow: true, tempTooHigh: true, waterLevelError: true },
@@ -48,6 +103,7 @@ export class MatterbridgeDishwasherModeServer extends DishwasherModeServer {
         this.state.currentMode = 2;
         this.reactTo(this.agent.get(MatterbridgeOnOffServer).events.onOff$Changed, this.handleOnOffChange);
     }
+    // Dead Front OnOff Cluster
     handleOnOffChange(onOff) {
         const device = this.endpoint.stateOf(MatterbridgeServer);
         if (onOff === false) {
@@ -71,3 +127,4 @@ export class MatterbridgeDishwasherModeServer extends DishwasherModeServer {
         }
     }
 }
+//# sourceMappingURL=dishwasher.js.map

package/dist/devices/dishwasher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dishwasher.js","sourceRoot":"","sources":["../../src/devices/dishwasher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE,eAAe;AACf,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAE1F,OAAO,EAAE,0CAA0C,EAAE,2CAA2C,EAAE,MAAM,yBAAyB,CAAC;AAElI,MAAM,OAAO,UAAW,SAAQ,oBAAoB;IAClD;;;;;;;;;;;;;;;;;;OAkBG;IACH,YACE,IAAY,EACZ,MAAc,EACd,WAAoB,EACpB,cAA4C,EAC5C,wBAAiC,EACjC,0BAAqC,EACrC,mBAA4B,EAC5B,cAAuB,EACvB,cAAuB,EACvB,IAAa,EACb,gBAAwD;QAExD,KAAK,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,EAAE,gBAAgB,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;QAC1H,IAAI,CAAC,kCAAkC,EAAE,CAAC;QAC1C,IAAI,CAAC,0CAA0C,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,yBAAyB,CAAC,CAAC;QACzH,IAAI,CAAC,0CAA0C,EAAE,CAAC;QAClD,IAAI,CAAC,iCAAiC,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,wCAAwC,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QAC3E,IAAI,CAAC,yCAAyC,EAAE,CAAC;QACjD,IAAI,mBAAmB;YAAE,2CAA2C,CAAC,IAAI,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;;YACjI,0CAA0C,CAAC,IAAI,EAAE,wBAAwB,EAAE,0BAA0B,CAAC,CAAC;QAC5G,IAAI,CAAC,0CAA0C,CAAC,gBAAgB,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;OAOG;IACH,wCAAwC,CACtC,cAAsB,CAAC,EACvB,iBAA8C;QAC5C,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE;QAChF,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE;QAClF,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE;KACjF;QAED,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,gCAAgC,EAAE;YACvD,cAAc;YACd,WAAW;SACZ,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,yCAAyC;QACvC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,qBAAqB,EAAE;YAC5C,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;YAC1H,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;YACjI,SAAS,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;SAChI,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,MAAM,OAAO,gCAAiC,SAAQ,oBAAoB;IAC/D,UAAU;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,gEAAgE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1G,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACrG,CAAC;IAED,2BAA2B;IACjB,iBAAiB,CAAC,KAAc;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACzD,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;YACjG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAEQ,YAAY,CAAC,OAAqC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,GAAG,CAAC,CAAC;QACjG,MAAM,CAAC,cAAc,CAAC,cAAc,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrJ,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAChH,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,uDAAuD,aAAa,CAAC,IAAI,OAAO,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC;YACvH,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;YACzC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;QAC9E,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,+DAA+D,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YACnG,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;QACzF,CAAC;IACH,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"}