matterbridge 3.3.6 → 3.3.7-dev-20251102-c85d574

package/dist/devices/oven.js

@@ -1,49 +1,13 @@
-/**
- * @description This file contains the Oven class.
- * @file src/devices/oven.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/types/clusters/mode-base';
 import { OvenMode } from '@matter/types/clusters/oven-mode';
 import { OperationalState } from '@matter/types/clusters/operational-state';
 import { OvenModeServer } from '@matter/node/behaviors/oven-mode';
 import { OvenCavityOperationalStateServer } from '@matter/node/behaviors/oven-cavity-operational-state';
-// Matterbridge
 import { oven, powerSource, temperatureControlledCabinetHeater } from '../matterbridgeDeviceTypes.js';
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
 import { MatterbridgeServer } from '../matterbridgeBehaviors.js';
 import { createLevelTemperatureControlClusterServer } from './temperatureControl.js';
 export class Oven extends MatterbridgeEndpoint {
-    /**
-     * Creates an instance of the Oven class.
-     *
-     * @param {string} name - The name of the oven.
-     * @param {string} serial - The serial number of the oven.
-     *
-     * @remarks
-     * 13.9 An oven represents a device that contains one or more cabinets, and optionally a single cooktop,
-     * that are all capable of heating food. Examples of consumer products implementing this device type
-     * include ovens, wall ovens, convection ovens, etc.
-     * An oven is always defined via endpoint composition.
-     * - Use `addCabinet` to add one or more cabinets to the oven.
-     */
     constructor(name, serial) {
         super([oven, powerSource], { uniqueStorageKey: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` }, true);
         this.createDefaultIdentifyClusterServer();
@@ -51,25 +15,6 @@ export class Oven extends MatterbridgeEndpoint {
         this.createDefaultPowerSourceWiredClusterServer();
         this.addFixedLabel('composed', 'Oven');
     }
-    /**
-     * Adds a Temperature Controlled Cabinet Heater to the oven.
-     *
-     * @param {string} name - The name of the cabinet.
-     * @param {Semtag[]} tagList - The tagList associated with the cabinet.
-     * @param {number} currentMode - The current mode of the cabinet. Defaults to 2 (which corresponds to 'Convection').
-     * @param {OvenMode.ModeOption[]} supportedModes - The supported modes of the cabinet. Defaults to a set of common oven modes.
-     * @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 list of supported temperature levels for the cabinet. Defaults to ['Defrost', '180°', '190°', '200°', '250°', '300°'].
-     * @param {OperationalState.OperationalStateEnum} operationalState - The initial operational state of the cabinet. Defaults to Stopped.
-     * @param {number} [currentPhase] - Optional: the current phase of the cabinet.
-     * @param {string[]} [phaseList] - Optional: the list of phases for the cabinet.
-     *
-     * @returns {MatterbridgeEndpoint} The MatterbridgeEndpoint instance representing the cabinet.
-     *
-     * @remarks
-     * 13.4.1 A Temperature Controlled Cabinet Heater is a device that provides a heated space for warming food.
-     * It is typically installed within an oven and can be used in conjunction with other heating elements.
-     */
     addCabinet(name, tagList, currentMode = 2, supportedModes = [
         { label: 'Bake', mode: 1, modeTags: [{ value: OvenMode.ModeTag.Bake }] },
         { label: 'Convection', mode: 2, modeTags: [{ value: OvenMode.ModeTag.Convection }] },
@@ -91,19 +36,6 @@ export class Oven extends MatterbridgeEndpoint {
         this.createDefaultOvenCavityOperationalStateClusterServer(cabinet, operationalState, currentPhase, phaseList);
         return cabinet;
     }
-    /**
-     * Creates a default OvenMode Cluster Server.
-     *
-     * @param {MatterbridgeEndpoint} endpoint - The Matterbridge endpoint instance.
-     * @param {number} currentMode - The current mode of the oven.
-     * @param {OvenMode.ModeOption[]} supportedModes - The supported modes of the oven.
-     *
-     * @returns {MatterbridgeEndpoint} The current MatterbridgeEndpoint instance for chaining.
-     *
-     * @remarks
-     * - supportedModes is a fixed attribute. It cannot be changed at runtime.
-     * - currentMode persists across reboots.
-     */
     createDefaultOvenModeClusterServer(endpoint, currentMode, supportedModes) {
         endpoint.behaviors.require(MatterbridgeOvenModeServer, {
             supportedModes,
@@ -111,20 +43,6 @@ export class Oven extends MatterbridgeEndpoint {
         });
         return endpoint;
     }
-    /**
-     * Creates a default Oven Cavity Operational State Cluster Server.
-     *
-     * @param {MatterbridgeEndpoint} endpoint - The Matterbridge endpoint instance.
-     * @param {OperationalState.OperationalStateEnum} operationalState - The initial operational state.
-     * @param {number} [currentPhase] - The current phase of the oven cavity.
-     * @param {string[]} [phaseList] - The list of phases for the oven cavity.
-     *
-     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
-     *
-     * @remarks
-     * For this derived cluster, only these pre-defined strings may be used in the PhaseList attribute:
-     * "pre-heating", "pre-heated", and "cooling down".
-     */
     createDefaultOvenCavityOperationalStateClusterServer(endpoint, operationalState = OperationalState.OperationalStateEnum.Stopped, currentPhase, phaseList) {
         endpoint.behaviors.require(MatterbridgeOvenCavityOperationalStateServer, {
             phaseList: phaseList || null,
@@ -140,7 +58,6 @@ export class Oven extends MatterbridgeEndpoint {
         return endpoint;
     }
 }
-// Server for OvenMode
 export class MatterbridgeOvenModeServer extends OvenModeServer {
     initialize() {
         const device = this.endpoint.stateOf(MatterbridgeServer);
@@ -160,7 +77,6 @@ export class MatterbridgeOvenModeServer extends OvenModeServer {
         }
     }
 }
-// Server for OvenCavityOperationalState
 export class MatterbridgeOvenCavityOperationalStateServer extends OvenCavityOperationalStateServer {
     initialize() {
         const device = this.endpoint.stateOf(MatterbridgeServer);
@@ -187,4 +103,3 @@ export class MatterbridgeOvenCavityOperationalStateServer extends OvenCavityOper
         };
     }
 }
-//# sourceMappingURL=oven.js.map

package/dist/devices/refrigerator.js

@@ -1,48 +1,12 @@
-/**
- * @description This file contains the Refrigerator class.
- * @file src/devices/refrigerator.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/types/clusters/mode-base';
 import { RefrigeratorAndTemperatureControlledCabinetMode } from '@matter/types/clusters/refrigerator-and-temperature-controlled-cabinet-mode';
 import { RefrigeratorAndTemperatureControlledCabinetModeServer } from '@matter/node/behaviors/refrigerator-and-temperature-controlled-cabinet-mode';
 import { RefrigeratorAlarmServer } from '@matter/node/behaviors/refrigerator-alarm';
-// Matterbridge
 import { powerSource, refrigerator, temperatureControlledCabinetCooler } from '../matterbridgeDeviceTypes.js';
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
 import { MatterbridgeServer } from '../matterbridgeBehaviors.js';
 import { createLevelTemperatureControlClusterServer } from './temperatureControl.js';
 export class Refrigerator extends MatterbridgeEndpoint {
-    /**
-     * Creates an instance of the Refrigerator class.
-     *
-     * @param {string} name - The name of the refrigerator.
-     * @param {string} serial - The serial number of the refrigerator.
-     *
-     * @remarks
-     * 13.2 A refrigerator represents a device that contains one or more cabinets that are capable of chilling or
-     * freezing food. Examples of consumer products that MAY make use of this device type include refrigerators,
-     * freezers, and wine coolers.
-     * A refrigerator is always defined via endpoint composition.
-     * - Use `addCabinet` to add one or more cabinets to the refrigerator.
-     */
     constructor(name, serial) {
         super([refrigerator, powerSource], { uniqueStorageKey: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` }, true);
         this.createDefaultIdentifyClusterServer();
@@ -50,35 +14,6 @@ export class Refrigerator extends MatterbridgeEndpoint {
         this.createDefaultPowerSourceWiredClusterServer();
         this.addFixedLabel('composed', 'Refrigerator');
     }
-    /**
-     * Adds a Level Temperature Controlled Cabinet Cooler to the refrigerator.
-     *
-     * @param {string} name - The name of the cabinet.
-     * @param {Semtag[]} tagList - The tagList associated with the cabinet.
-     * @param {number} currentMode - The current mode of the cabinet. Defaults to 1 (which corresponds to 'Auto').
-     * @param {RefrigeratorAndTemperatureControlledCabinetMode.ModeOption[]} supportedModes - The supported modes for the cabinet. Defaults to 'Auto', 'RapidCool', and 'RapidFreeze'.
-     * @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 cabinet. Defaults to ['Level 1', 'Level 2', 'Level 3', 'Level 4', 'Level 5'].
-     * @param {number} currentTemperature - The current temperature of the cabinet in degrees Celsius. Defaults to 1000 (which corresponds to 10.00 degrees Celsius).
-     *
-     * @returns {MatterbridgeEndpoint} The MatterbridgeEndpoint instance representing the cabinet.
-     *
-     * @remarks
-     * 13.4.1 A Temperature Controlled Cabinet Cooler is a device that provides a cooled space for chilling food.
-     * It is typically installed within a refrigerator.
-     *
-     * Example usage with specific namespace tags:
-     * ```
-     *  refrigerator.addCabinet('Refrigerator Top', [
-     *    { mfgCode: null, namespaceId: PositionTag.Top.namespaceId, tag: PositionTag.Top.tag, label: 'Refrigerator Top' },
-     *    { mfgCode: null, namespaceId: RefrigeratorTag.Refrigerator.namespaceId, tag: RefrigeratorTag.Refrigerator.tag, label: RefrigeratorTag.Refrigerator.label },
-     *  ]);
-     *  refrigerator.addCabinet('Freezer Bottom', [
-     *    { mfgCode: null, namespaceId: PositionTag.Bottom.namespaceId, tag: PositionTag.Bottom.tag, label: 'Freezer Bottom' },
-     *    { mfgCode: null, namespaceId: RefrigeratorTag.Freezer.namespaceId, tag: RefrigeratorTag.Freezer.tag, label: RefrigeratorTag.Freezer.label },
-     *  ]);
-     * ```
-     */
     addCabinet(name, tagList, currentMode = 1, supportedModes = [
         { label: 'Auto', mode: 1, modeTags: [{ value: RefrigeratorAndTemperatureControlledCabinetMode.ModeTag.Auto }] },
         { label: 'RapidCool', mode: 2, modeTags: [{ value: RefrigeratorAndTemperatureControlledCabinetMode.ModeTag.RapidCool }] },
@@ -93,19 +28,6 @@ export class Refrigerator extends MatterbridgeEndpoint {
         cabinet.createDefaultTemperatureMeasurementClusterServer(currentTemperature);
         return cabinet;
     }
-    /**
-     * Creates a default RefrigeratorAndTemperatureControlledCabinetMode Cluster Server.
-     *
-     * @param {MatterbridgeEndpoint} endpoint - The Matterbridge endpoint instance.
-     * @param {number} currentMode - The current mode of the oven.
-     * @param {RefrigeratorAndTemperatureControlledCabinetMode.ModeOption[]} supportedModes - The supported modes for the refrigerator and temperature controlled cabinet.
-     *
-     * @returns {MatterbridgeEndpoint} The current MatterbridgeEndpoint instance for chaining.
-     *
-     * @remarks
-     * - supportedModes is a fixed attribute. It cannot be changed at runtime.
-     * - currentMode persists across reboots.
-     */
     createDefaultRefrigeratorAndTemperatureControlledCabinetModeClusterServer(endpoint, currentMode, supportedModes) {
         endpoint.behaviors.require(MatterbridgeRefrigeratorAndTemperatureControlledCabinetModeServer, {
             supportedModes,
@@ -113,14 +35,6 @@ export class Refrigerator extends MatterbridgeEndpoint {
         });
         return endpoint;
     }
-    /**
-     * Creates a default RefrigeratorAlarm Cluster Server.
-     *
-     * @param {MatterbridgeEndpoint} endpoint - The Matterbridge endpoint instance.
-     * @param {boolean} doorOpen - Indicates if the refrigerator door is open.
-     *
-     * @returns {MatterbridgeEndpoint} The updated MatterbridgeEndpoint instance.
-     */
     createDefaultRefrigeratorAlarmClusterServer(endpoint, doorOpen = false) {
         endpoint.behaviors.require(RefrigeratorAlarmServer, {
             mask: { doorOpen: true },
@@ -129,13 +43,6 @@ export class Refrigerator extends MatterbridgeEndpoint {
         });
         return endpoint;
     }
-    /**
-     * Sets the door open state for a specific cabinet.
-     *
-     * @param {string} cabinetName - The name of the cabinet.
-     * @param {boolean} doorOpen - Indicates if the door is open.
-     * @returns {MatterbridgeEndpoint | undefined} The updated MatterbridgeEndpoint instance or undefined if not found.
-     */
     async setDoorOpenState(cabinetName, doorOpen) {
         const endpoint = this.getChildEndpointByName(cabinetName);
         if (endpoint) {
@@ -143,13 +50,6 @@ export class Refrigerator extends MatterbridgeEndpoint {
             return endpoint;
         }
     }
-    /**
-     * Triggers the notify event for door open state on a specific cabinet.
-     *
-     * @param {string} cabinetName - The name of the cabinet.
-     * @param {boolean} doorOpen - Indicates if the door is open.
-     * @returns {MatterbridgeEndpoint | undefined} The updated MatterbridgeEndpoint instance or undefined if not found.
-     */
     async triggerDoorOpenState(cabinetName, doorOpen) {
         const endpoint = this.getChildEndpointByName(cabinetName);
         if (endpoint) {
@@ -163,7 +63,6 @@ export class Refrigerator extends MatterbridgeEndpoint {
         }
     }
 }
-// Server for RefrigeratorAndTemperatureControlledCabinetMode
 export class MatterbridgeRefrigeratorAndTemperatureControlledCabinetModeServer extends RefrigeratorAndTemperatureControlledCabinetModeServer {
     initialize() {
         const device = this.endpoint.stateOf(MatterbridgeServer);
@@ -183,4 +82,3 @@ export class MatterbridgeRefrigeratorAndTemperatureControlledCabinetModeServer e
         }
     }
 }
-//# sourceMappingURL=refrigerator.js.map

package/dist/devices/roboticVacuumCleaner.js

@@ -1,26 +1,3 @@
-/**
- * @description This file contains the RoboticVacuumCleaner class.
- * @file src/devices/roboticVacuumCleaner.ts
- * @author Luca Liguori
- * @created 2025-05-01
- * @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.
- */
-// Matter.js
 import { AreaNamespaceTag } from '@matter/node';
 import { PowerSource } from '@matter/types/clusters/power-source';
 import { RvcRunMode } from '@matter/types/clusters/rvc-run-mode';
@@ -32,30 +9,10 @@ import { OperationalState } from '@matter/types/clusters/operational-state';
 import { RvcRunModeServer } from '@matter/node/behaviors/rvc-run-mode';
 import { RvcOperationalStateServer } from '@matter/node/behaviors/rvc-operational-state';
 import { RvcCleanModeServer } from '@matter/node/behaviors/rvc-clean-mode';
-// Matterbridge
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
 import { powerSource, roboticVacuumCleaner } from '../matterbridgeDeviceTypes.js';
 import { MatterbridgeServer, MatterbridgeServiceAreaServer } from '../matterbridgeBehaviors.js';
 export class RoboticVacuumCleaner extends MatterbridgeEndpoint {
-    /**
-     * Creates an instance of the RoboticVacuumCleaner class.
-     *
-     * @param {string} name - The name of the robotic vacuum cleaner.
-     * @param {string} serial - The serial number of the robotic vacuum cleaner.
-     * @param {'server' | 'matter' | undefined} [mode] - The mode of the robotic vacuum cleaner. Defaults to undefined. Use 'server' or 'matter' if you want Apple Home compatibility.
-     * @param {number} [currentRunMode] - The current run mode of the robotic vacuum cleaner. Defaults to 1 (Idle).
-     * @param {RvcRunMode.ModeOption[]} [supportedRunModes] - The supported run modes for the robotic vacuum cleaner. Defaults to a predefined set of modes.
-     * @param {number} [currentCleanMode] - The current clean mode of the robotic vacuum cleaner. Defaults to 1 (Vacuum).
-     * @param {RvcCleanMode.ModeOption[]} [supportedCleanModes] - The supported clean modes for the robotic vacuum cleaner. Defaults to a predefined set of modes.
-     * @param {number | null} [currentPhase] - The current phase of the robotic vacuum cleaner. Defaults to null.
-     * @param {string[] | null} [phaseList] - The list of phases for the robotic vacuum cleaner. Defaults to null.
-     * @param {RvcOperationalState.OperationalState} [operationalState] - The current operational state of the robotic vacuum cleaner. Defaults to Docked.
-     * @param {RvcOperationalState.OperationalStateStruct[]} [operationalStateList] - The list of operational states for the robotic vacuum cleaner. Defaults to a predefined set of states.
-     * @param {ServiceArea.Area[]} [supportedAreas] - The supported areas for the robotic vacuum cleaner. Defaults to a predefined set of areas.
-     * @param {number[]} [selectedAreas] - The selected areas for the robotic vacuum cleaner. Defaults to an empty array (all areas allowed).
-     * @param {number} [currentArea] - The current area of the robotic vacuum cleaner. Defaults to 1 (Living).
-     * @param {ServiceArea.Map[]} [supportedMaps] - The supported maps for the robotic vacuum cleaner. Defaults to empty list.
-     */
     constructor(name, serial, mode = undefined, currentRunMode, supportedRunModes, currentCleanMode, supportedCleanModes, currentPhase = null, phaseList = null, operationalState, operationalStateList, supportedAreas, selectedAreas, currentArea, supportedMaps) {
         super([roboticVacuumCleaner, powerSource], { uniqueStorageKey: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}`, mode }, true);
         this.createDefaultIdentifyClusterServer()
@@ -66,17 +23,6 @@ export class RoboticVacuumCleaner extends MatterbridgeEndpoint {
             .createDefaultRvcOperationalStateClusterServer(phaseList, currentPhase, operationalStateList, operationalState)
             .createDefaultServiceAreaClusterServer(supportedAreas, selectedAreas, currentArea, supportedMaps);
     }
-    /**
-     * Creates a default RvcRunMode Cluster Server.
-     *
-     * @param {number} [currentMode] - The current mode of the RvcRunMode cluster. Defaults to 1 (Idle).
-     * @param {RvcRunMode.ModeOption[]} [supportedModes] - The supported modes for the RvcRunMode cluster. Defaults to a predefined set of modes.
-     *
-     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
-     *
-     * @remarks
-     * - supportedModes is a fixed attribute that defines the run modes available for the robotic vacuum cleaner.
-     */
     createDefaultRvcRunModeClusterServer(currentMode, supportedModes) {
         this.behaviors.require(MatterbridgeRvcRunModeServer, {
             supportedModes: supportedModes ?? [
@@ -89,17 +35,6 @@ export class RoboticVacuumCleaner extends MatterbridgeEndpoint {
         });
         return this;
     }
-    /**
-     * Creates a default RvcCleanMode Cluster Server.
-     *
-     * @param {number} [currentMode] - The current mode of the RvcCleanMode cluster. Defaults to 1 (Vacuum).
-     * @param {RvcCleanMode.ModeOption[]} [supportedModes] - The supported modes for the RvcCleanMode cluster. Defaults to a predefined set of modes.
-     *
-     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
-     *
-     * @remarks
-     * - supportedModes is a fixed attribute that defines the clean modes available for the robotic vacuum cleaner.
-     */
     createDefaultRvcCleanModeClusterServer(currentMode, supportedModes) {
         this.behaviors.require(MatterbridgeRvcCleanModeServer, {
             supportedModes: supportedModes ?? [
@@ -111,15 +46,6 @@ export class RoboticVacuumCleaner extends MatterbridgeEndpoint {
         });
         return this;
     }
-    /**
-     * Creates a default ServiceArea Cluster Server.
-     *
-     * @param {ServiceArea.Area[]} [supportedAreas] - The supported areas for the ServiceArea cluster. Defaults to a predefined set of areas.
-     * @param {number[]} [selectedAreas] - The selected areas for the ServiceArea cluster. Defaults to an empty array (all areas allowed).
-     * @param {number} [currentArea] - The current areaId (not the index in the array!) of the ServiceArea cluster. Defaults to 1 (Living).
-     * @param {ServiceArea.Map[]} [supportedMaps] - The supported maps for the robotic vacuum cleaner. Defaults empty list.
-     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
-     */
     createDefaultServiceAreaClusterServer(supportedAreas, selectedAreas, currentArea, supportedMaps) {
         this.behaviors.require(MatterbridgeServiceAreaServer.with(ServiceArea.Feature.Maps), {
             supportedAreas: supportedAreas ?? [
@@ -144,28 +70,13 @@ export class RoboticVacuumCleaner extends MatterbridgeEndpoint {
                     areaInfo: { locationInfo: { locationName: 'Bathroom', floorNumber: 1, areaType: AreaNamespaceTag.Bathroom.tag }, landmarkInfo: null },
                 },
             ],
-            selectedAreas: selectedAreas ?? [], // Indicates the set of areas where the device SHOULD attempt to operate. If this attribute is empty, the device is not constrained to operate in any specific areas.
-            currentArea: currentArea ?? 1, // If not null, the value of this attribute shall match the AreaID field of an entry on the SupportedAreas attribute’s list. A null value indicates that the device is currently unable to provide this information.
-            supportedMaps: supportedMaps ?? [], // If empty, that indicates that the device is currently unable to provide this information
-            /**
-             * Indicates the estimated Epoch time for completing operating at the area indicated by the CurrentArea attribute, in seconds. A value of 0 means that the operation has completed.
-             * When this attribute is null, that represents that there is no time currently defined until operation completion.
-             * This attribute SHALL be null if the CurrentArea attribute is null.
-             */
+            selectedAreas: selectedAreas ?? [],
+            currentArea: currentArea ?? 1,
+            supportedMaps: supportedMaps ?? [],
             estimatedEndTime: null,
         });
         return this;
     }
-    /**
-     * Creates a default RvcOperationalState Cluster Server.
-     *
-     * @param {string[] | null} [phaseList] - The list of phases for the RvcOperationalState cluster. Defaults to null.
-     * @param {number | null} [currentPhase] - The current phase (the index of the phaseList) of the RvcOperationalState cluster. Defaults to null.
-     * @param {RvcOperationalState.OperationalStateStruct[]} [operationalStateList] - The list of operational states for the RvcOperationalState cluster. Defaults to a predefined set of states.
-     * @param {RvcOperationalState.OperationalState} [operationalState] - The current operationalStateId of the RvcOperationalState cluster. Defaults to Docked.
-     * @param {RvcOperationalState.ErrorStateStruct} [operationalError] - The current operational error of the RvcOperationalState cluster. Defaults to NoError.
-     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
-     */
     createDefaultRvcOperationalStateClusterServer(phaseList = null, currentPhase = null, operationalStateList, operationalState, operationalError) {
         this.behaviors.require(MatterbridgeRvcOperationalStateServer, {
             phaseList,
@@ -175,9 +86,9 @@ export class RoboticVacuumCleaner extends MatterbridgeEndpoint {
                 { operationalStateId: RvcOperationalState.OperationalState.Running, operationalStateLabel: 'Running' },
                 { operationalStateId: RvcOperationalState.OperationalState.Paused, operationalStateLabel: 'Paused' },
                 { operationalStateId: RvcOperationalState.OperationalState.Error, operationalStateLabel: 'Error' },
-                { operationalStateId: RvcOperationalState.OperationalState.SeekingCharger, operationalStateLabel: 'SeekingCharger' }, // Y RVC Pause Compatibility N RVC Resume Compatibility
-                { operationalStateId: RvcOperationalState.OperationalState.Charging, operationalStateLabel: 'Charging' }, // N RVC Pause Compatibility Y RVC Resume Compatibility
-                { operationalStateId: RvcOperationalState.OperationalState.Docked, operationalStateLabel: 'Docked' }, // N RVC Pause Compatibility Y RVC Resume Compatibility
+                { operationalStateId: RvcOperationalState.OperationalState.SeekingCharger, operationalStateLabel: 'SeekingCharger' },
+                { operationalStateId: RvcOperationalState.OperationalState.Charging, operationalStateLabel: 'Charging' },
+                { operationalStateId: RvcOperationalState.OperationalState.Docked, operationalStateLabel: 'Docked' },
             ],
             operationalState: operationalState ?? RvcOperationalState.OperationalState.Docked,
             operationalError: operationalError ?? { errorStateId: RvcOperationalState.ErrorState.NoError, errorStateLabel: 'No Error', errorStateDetails: 'Fully operational' },
@@ -232,7 +143,7 @@ export class MatterbridgeRvcOperationalStateServer extends RvcOperationalStateSe
         device.log.info(`Pause (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
         device.commandHandler.executeHandler('pause', { request: {}, cluster: RvcOperationalStateServer.id, attributes: this.state, endpoint: this.endpoint });
         device.log.debug('MatterbridgeRvcOperationalStateServer: pause called setting operational state to Paused and currentMode to Idle');
-        this.agent.get(MatterbridgeRvcRunModeServer).state.currentMode = 1; // RvcRunMode.ModeTag.Idle
+        this.agent.get(MatterbridgeRvcRunModeServer).state.currentMode = 1;
         this.state.operationalState = RvcOperationalState.OperationalState.Paused;
         this.state.operationalError = { errorStateId: RvcOperationalState.ErrorState.NoError, errorStateLabel: 'No Error', errorStateDetails: 'Fully operational' };
         return {
@@ -244,7 +155,7 @@ export class MatterbridgeRvcOperationalStateServer extends RvcOperationalStateSe
         device.log.info(`Resume (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
         device.commandHandler.executeHandler('resume', { request: {}, cluster: RvcOperationalStateServer.id, attributes: this.state, endpoint: this.endpoint });
         device.log.debug('MatterbridgeRvcOperationalStateServer: resume called setting operational state to Running and currentMode to Cleaning');
-        this.agent.get(MatterbridgeRvcRunModeServer).state.currentMode = 2; // RvcRunMode.ModeTag.Cleaning
+        this.agent.get(MatterbridgeRvcRunModeServer).state.currentMode = 2;
         this.state.operationalState = RvcOperationalState.OperationalState.Running;
         this.state.operationalError = { errorStateId: RvcOperationalState.ErrorState.NoError, errorStateLabel: 'No Error', errorStateDetails: 'Fully operational' };
         return {
@@ -252,12 +163,11 @@ export class MatterbridgeRvcOperationalStateServer extends RvcOperationalStateSe
         };
     }
     goHome() {
-        // const device = this.agent.get(MatterbridgeServer).state.deviceCommand;
         const device = this.endpoint.stateOf(MatterbridgeServer);
         device.log.info(`GoHome (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
         device.commandHandler.executeHandler('goHome', { request: {}, cluster: RvcOperationalStateServer.id, attributes: this.state, endpoint: this.endpoint });
         device.log.debug('MatterbridgeRvcOperationalStateServer: goHome called setting operational state to Docked and currentMode to Idle');
-        this.agent.get(MatterbridgeRvcRunModeServer).state.currentMode = 1; // RvcRunMode.ModeTag.Idle
+        this.agent.get(MatterbridgeRvcRunModeServer).state.currentMode = 1;
         this.state.operationalState = RvcOperationalState.OperationalState.Docked;
         this.state.operationalError = { errorStateId: RvcOperationalState.ErrorState.NoError, errorStateLabel: 'No Error', errorStateDetails: 'Fully operational' };
         return {
@@ -265,4 +175,3 @@ export class MatterbridgeRvcOperationalStateServer extends RvcOperationalStateSe
         };
     }
 }
-//# sourceMappingURL=roboticVacuumCleaner.js.map

package/dist/devices/solarPower.js

@@ -1,45 +1,8 @@
-/**
- * @description This file contains the SolarPower class.
- * @file src/devices/solarPower.ts
- * @author Luca Liguori
- * @contributor Ludovic BOUÉ
- * @created 2025-06-14
- * @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';
-// Matterbridge
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
 import { deviceEnergyManagement, electricalSensor, solarPower, powerSource } from '../matterbridgeDeviceTypes.js';
 export class SolarPower extends MatterbridgeEndpoint {
-    /**
-     * Creates an instance of the SolarPower class.
-     *
-     * @param {string} name - The name of the SolarPower.
-     * @param {string} serial - The serial number of the SolarPower.
-     * @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} 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.
-     */
     constructor(name, serial, voltage = null, current = null, power = null, energyExported = null, absMinPower = 0, absMaxPower = 0) {
         super([solarPower, powerSource, electricalSensor, deviceEnergyManagement], {
             tagList: [{ mfgCode: null, namespaceId: PowerSourceTag.Solar.namespaceId, tag: PowerSourceTag.Solar.tag, label: null }],
@@ -56,4 +19,3 @@ export class SolarPower extends MatterbridgeEndpoint {
             .addRequiredClusterServers();
     }
 }
-//# sourceMappingURL=solarPower.js.map

package/dist/devices/speaker.js

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