matterbridge 3.3.8-dev-20251115-ca5ff21 → 3.3.8

package/dist/devices/laundryWasher.js

@@ -1,13 +1,59 @@
+/**
+ * @description This file contains the LaundryWasher class.
+ * @file src/devices/laundryWasher.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 { LaundryWasherControls } from '@matter/types/clusters/laundry-washer-controls';
 import { LaundryWasherMode } from '@matter/types/clusters/laundry-washer-mode';
 import { ModeBase } from '@matter/types/clusters/mode-base';
 import { LaundryWasherModeServer } from '@matter/node/behaviors/laundry-washer-mode';
 import { LaundryWasherControlsServer } from '@matter/node/behaviors/laundry-washer-controls';
+// Matterbridge
 import { laundryWasher, powerSource } from '../matterbridgeDeviceTypes.js';
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
 import { MatterbridgeOnOffServer, MatterbridgeServer } from '../matterbridgeBehaviors.js';
 import { createLevelTemperatureControlClusterServer, createNumberTemperatureControlClusterServer } from './temperatureControl.js';
 export class LaundryWasher extends MatterbridgeEndpoint {
+    /**
+     * Creates an instance of the LaundryWasher class.
+     *
+     * @param {string} name - The name of the laundry washer.
+     * @param {string} serial - The serial number of the laundry washer.
+     * @param {number} [currentMode] - The current mode of the laundry washer. Defaults to 2 (Normal mode). Dead Front OnOff Cluster will set this to 2 when turned off. Persistent attribute.
+     * @param {LaundryWasherMode.ModeOption[]} [supportedModes] - The supported modes of the laundry washer. Defaults to a set of common modes (which include Delicate, Normal, Heavy, and Whites). Fixed attribute.
+     * @param {number} [spinSpeedCurrent] - The current spin speed as index of the spinSpeeds array. Defaults to 2 (which corresponds to '1200').
+     * @param {string[]} [spinSpeeds] - The supported spin speeds. Defaults to ['400', '800', '1200', '1600'].
+     * @param {LaundryWasherControls.NumberOfRinses} [numberOfRinses] - The number of rinses. Defaults to LaundryWasherControls.NumberOfRinses.Normal (which corresponds to 1 rinse).
+     * @param {LaundryWasherControls.NumberOfRinses[]} [supportedRinses] - The supported rinses. Defaults to [NumberOfRinses.None, NumberOfRinses.Normal, NumberOfRinses.Max, NumberOfRinses.Extra].
+     * @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, spinSpeedCurrent, spinSpeeds, numberOfRinses, supportedRinses, selectedTemperatureLevel, supportedTemperatureLevels, temperatureSetpoint, minTemperature, maxTemperature, step, operationalState) {
         super([laundryWasher, powerSource], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` });
         this.createDefaultIdentifyClusterServer();
@@ -22,6 +68,14 @@ export class LaundryWasher extends MatterbridgeEndpoint {
             createLevelTemperatureControlClusterServer(this, selectedTemperatureLevel, supportedTemperatureLevels);
         this.createDefaultOperationalStateClusterServer(operationalState);
     }
+    /**
+     * Creates a default Laundry Washer Mode Cluster Server.
+     *
+     * @param {number} currentMode - The current mode of the laundry washer. Defaults to 2 (Normal mode). Dead Front OnOff Cluster will set this to 2 when turned off. Persistent attribute.
+     * @param {LaundryWasherMode.ModeOption[]} supportedModes - The supported modes of the laundry washer. Defaults to a set of common modes (which include Delicate, Normal, Heavy, and Whites). Fixed attribute.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultLaundryWasherModeClusterServer(currentMode = 2, supportedModes = [
         { label: 'Delicate', mode: 1, modeTags: [{ value: LaundryWasherMode.ModeTag.Delicate }] },
         { label: 'Normal', mode: 2, modeTags: [{ value: LaundryWasherMode.ModeTag.Normal }] },
@@ -29,17 +83,27 @@ export class LaundryWasher extends MatterbridgeEndpoint {
         { label: 'Whites', mode: 4, modeTags: [{ value: LaundryWasherMode.ModeTag.Whites }] },
     ]) {
         this.behaviors.require(MatterbridgeLaundryWasherModeServer, {
-            supportedModes,
-            currentMode,
+            supportedModes, // Fixed attribute.
+            currentMode, // Persistent attribute.
         });
         return this;
     }
+    /**
+     * Creates a Laundry Washer Controls Cluster Server with feature Spin for selecting the spin speed and feature Rinse for selecting the number of rinses.
+     *
+     * @param {number} spinSpeedCurrent - The current spin speed as index of the spinSpeeds array. Default to 2 (which corresponds to '1200').
+     * @param {string[]} spinSpeeds - The supported spin speeds. Default to ['400', '800', '1200', '1600'].
+     * @param {LaundryWasherControls.NumberOfRinses} numberOfRinses - The number of rinses. Default to LaundryWasherControls.NumberOfRinses.Normal (which corresponds to 1 rinse).
+     * @param {LaundryWasherControls.NumberOfRinses[]} supportedRinses - The supported rinses. Default to [NumberOfRinses.None, NumberOfRinses.Normal, NumberOfRinses.Max, NumberOfRinses.Extra].
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
     createDefaultLaundryWasherControlsClusterServer(spinSpeedCurrent = 2, spinSpeeds = ['400', '800', '1200', '1600'], numberOfRinses = LaundryWasherControls.NumberOfRinses.Normal, supportedRinses = [LaundryWasherControls.NumberOfRinses.None, LaundryWasherControls.NumberOfRinses.Normal, LaundryWasherControls.NumberOfRinses.Max, LaundryWasherControls.NumberOfRinses.Extra]) {
         this.behaviors.require(LaundryWasherControlsServer.with(LaundryWasherControls.Feature.Spin, LaundryWasherControls.Feature.Rinse), {
             spinSpeeds,
-            spinSpeedCurrent,
+            spinSpeedCurrent, // Writable and nullable
             supportedRinses,
-            numberOfRinses,
+            numberOfRinses, // Writable
         });
         return this;
     }
@@ -50,6 +114,7 @@ export class MatterbridgeLaundryWasherModeServer extends LaundryWasherModeServer
         device.log.info(`MatterbridgeLaundryWasherModeServer initialized: currentMode is ${this.state.currentMode}`);
         this.reactTo(this.agent.get(MatterbridgeOnOffServer).events.onOff$Changed, this.handleOnOffChange);
     }
+    // Dead Front OnOff Cluster
     handleOnOffChange(onOff) {
         const device = this.endpoint.stateOf(MatterbridgeServer);
         device.log.info(`HandleOnOffChange (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
@@ -74,3 +139,4 @@ export class MatterbridgeLaundryWasherModeServer extends LaundryWasherModeServer
         }
     }
 }
+//# sourceMappingURL=laundryWasher.js.map

package/dist/devices/laundryWasher.js.map

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

package/dist/devices/microwaveOven.d.ts

@@ -0,0 +1,168 @@
+/**
+ * @description This file contains the MicrowaveOven class.
+ * @file src/devices/microwaveOven.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/general';
+import { MicrowaveOvenMode } from '@matter/types/clusters/microwave-oven-mode';
+import { MicrowaveOvenControl } from '@matter/types/clusters/microwave-oven-control';
+import { MicrowaveOvenControlServer } from '@matter/node/behaviors/microwave-oven-control';
+import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
+export declare class MicrowaveOven extends MatterbridgeEndpoint {
+    /**
+     * Creates an instance of the MicrowaveOven class.
+     *
+     * @param {string} name - The name of the microwave oven.
+     * @param {string} serial - The serial number of the microwave oven.
+     * @param {number} currentMode - The current mode of the microwave oven. Default is 1 = Auto.
+     * @param {MicrowaveOvenMode.ModeOption[]} supportedModes - The supported modes of the microwave oven. Default is an array of all modes.
+     * @param {number} selectedWattIndex - The selected wattage index. Default is 5 (600W).
+     * @param {number[]} supportedWatts - The supported wattages. Default is an array of all standard microwave wattages.
+     * @param {number} cookTime - The initial cook time in seconds. Default is 60 seconds.
+     * @param {number} maxCookTime - The maximum cook time in seconds. Default is 3600 seconds (1 hour).
+     *
+     * @remarks
+     * - 8.12. Microwave Oven Mode Cluster
+     * - Exactly one entry in the SupportedModes attribute SHALL include the Normal mode tag in the ModeTags field.
+     * - The Normal and Defrost mode tags are mutually exclusive and SHALL NOT both be used together in a mode’s ModeTags.
+     */
+    constructor(name: string, serial: string, currentMode?: number, supportedModes?: MicrowaveOvenMode.ModeOption[], selectedWattIndex?: number, supportedWatts?: number[], cookTime?: number, // 1 minute
+    maxCookTime?: number);
+    /**
+     * Creates a default MicrowaveOvenMode Cluster Server.
+     * There is no changeToMode command in the spec, so this is not implemented.
+     * The Microwave is controlled by the MicrowaveOvenControl cluster.
+     *
+     * @param {number} currentMode - The current mode of the oven.
+     * @param {MicrowaveOvenMode.ModeOption[]} supportedModes - The supported modes.
+     *
+     * @returns {MatterbridgeEndpoint} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks
+     * - 8.12. Microwave Oven Mode Cluster
+     * - the supported modes are fixed and cannot be changed at runtime.
+     * - the current mode is persistent among reboots.
+     * - Exactly one entry in the SupportedModes attribute SHALL include the Normal mode tag in the ModeTags field.
+     * - The Normal and Defrost mode tags are mutually exclusive and SHALL NOT both be used together in a mode’s ModeTags.
+     */
+    createDefaultMicrowaveOvenModeClusterServer(currentMode: number, supportedModes: MicrowaveOvenMode.ModeOption[]): this;
+    /**
+     * Creates a default MicrowaveOvenControl Cluster Server.
+     *
+     * @param {number} selectedWattIndex - The selected watt index.
+     * @param {number[]} supportedWatts - The supported watt values.
+     * @param {number} cookTime - The initial cook time.
+     * @param {number} maxCookTime - The maximum cook time.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks
+     * - 8.13. Microwave Oven Control Cluster
+     * - the supported watt values are fixed and cannot be changed at runtime.
+     * - the maxCookTime is a fixed attribute and cannot be changed at runtime.
+     */
+    createDefaultMicrowaveOvenControlClusterServer(selectedWattIndex: number, supportedWatts: number[], cookTime: number, maxCookTime: number): this;
+}
+declare const MatterbridgeMicrowaveOvenControlServer_base: import("@matter/node").ClusterBehavior.Type<import("@matter/types").ClusterComposer.WithFeatures<import("@matter/types").ClusterType.Of<{
+    readonly id: 95;
+    readonly name: "MicrowaveOvenControl";
+    readonly revision: 1;
+    readonly features: {
+        readonly powerAsNumber: import("@matter/types").BitFlag;
+        readonly powerInWatts: import("@matter/types").BitFlag;
+        readonly powerNumberLimits: import("@matter/types").BitFlag;
+    };
+    readonly attributes: {
+        readonly cookTime: import("@matter/types").Attribute<number, any>;
+        readonly maxCookTime: import("@matter/types").FixedAttribute<number, any>;
+        readonly wattRating: import("@matter/types").OptionalFixedAttribute<number, any>;
+    };
+    readonly commands: {
+        readonly setCookingParameters: import("@matter/types").Command<import("@matter/types").TypeFromFields<{
+            cookMode: import("@matter/types").OptionalFieldType<number>;
+            cookTime: import("@matter/types").OptionalFieldType<number>;
+            powerSetting: import("@matter/types").OptionalFieldType<number>;
+            wattSettingIndex: import("@matter/types").OptionalFieldType<number>;
+            startAfterSetting: import("@matter/types").OptionalFieldType<boolean>;
+        }>, void, any>;
+        readonly addMoreTime: import("@matter/types").OptionalCommand<import("@matter/types").TypeFromFields<{
+            timeToAdd: import("@matter/types").FieldType<number>;
+        }>, void, any>;
+    };
+    readonly extensions: readonly [{
+        readonly flags: {
+            readonly powerAsNumber: true;
+        };
+        readonly component: {
+            readonly attributes: {
+                readonly powerSetting: import("@matter/types").Attribute<number, any>;
+            };
+        };
+    }, {
+        readonly flags: {
+            readonly powerNumberLimits: true;
+        };
+        readonly component: {
+            readonly attributes: {
+                readonly minPower: import("@matter/types").FixedAttribute<number, any>;
+                readonly maxPower: import("@matter/types").FixedAttribute<number, any>;
+                readonly powerStep: import("@matter/types").FixedAttribute<number, any>;
+            };
+        };
+    }, {
+        readonly flags: {
+            readonly powerInWatts: true;
+        };
+        readonly component: {
+            readonly attributes: {
+                readonly supportedWatts: import("@matter/types").FixedAttribute<number[], any>;
+                readonly selectedWattIndex: import("@matter/types").Attribute<number, any>;
+            };
+        };
+    }, {
+        readonly flags: {
+            readonly powerNumberLimits: true;
+            readonly powerAsNumber: false;
+        };
+        readonly component: false;
+    }, {
+        readonly flags: {
+            readonly powerAsNumber: true;
+            readonly powerInWatts: true;
+        };
+        readonly component: false;
+    }, {
+        readonly flags: {
+            readonly powerAsNumber: false;
+            readonly powerInWatts: false;
+        };
+        readonly component: false;
+    }];
+}>, readonly [MicrowaveOvenControl.Feature.PowerInWatts]>, typeof MicrowaveOvenControlServer, import("@matter/node/behaviors/microwave-oven-control").MicrowaveOvenControlInterface>;
+/**
+ * Matterbridge Microwave Oven Control Server
+ */
+export declare class MatterbridgeMicrowaveOvenControlServer extends MatterbridgeMicrowaveOvenControlServer_base {
+    initialize(): void;
+    setCookingParameters(request: MicrowaveOvenControl.SetCookingParametersRequest): MaybePromise;
+    addMoreTime(request: MicrowaveOvenControl.AddMoreTimeRequest): MaybePromise;
+}
+export {};
+//# sourceMappingURL=microwaveOven.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"microwaveOven.d.ts","sourceRoot":"","sources":["../../src/devices/microwaveOven.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAK3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGlE,qBAAa,aAAc,SAAQ,oBAAoB;IACrD;;;;;;;;;;;;;;;;OAgBG;gBAED,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,MAAU,EACvB,cAAc,GAAE,iBAAiB,CAAC,UAAU,EAQ3C,EACD,iBAAiB,GAAE,MAAU,EAC7B,cAAc,GAAE,MAAM,EAAwD,EAC9E,QAAQ,GAAE,MAAW,EAAE,WAAW;IAClC,WAAW,GAAE,MAAa;IAW5B;;;;;;;;;;;;;;;;OAgBG;IACH,2CAA2C,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,iBAAiB,CAAC,UAAU,EAAE,GAAG,IAAI;IAQtH;;;;;;;;;;;;;;OAcG;IACH,8CAA8C,CAAC,iBAAiB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;CASjJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED;;GAEG;AACH,qBAAa,sCAAuC,SAAQ,2CAA0E;IAC3H,UAAU;IAMV,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,CAAC,2BAA2B,GAAG,YAAY;IA0C7F,WAAW,CAAC,OAAO,EAAE,oBAAoB,CAAC,kBAAkB,GAAG,YAAY;CAWrF"}

package/dist/devices/microwaveOven.js

@@ -1,12 +1,52 @@
+/**
+ * @description This file contains the MicrowaveOven class.
+ * @file src/devices/microwaveOven.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 { OperationalState } from '@matter/types/clusters/operational-state';
 import { MicrowaveOvenMode } from '@matter/types/clusters/microwave-oven-mode';
 import { MicrowaveOvenControl } from '@matter/types/clusters/microwave-oven-control';
 import { MicrowaveOvenControlServer } from '@matter/node/behaviors/microwave-oven-control';
 import { MicrowaveOvenModeServer } from '@matter/node/behaviors/microwave-oven-mode';
+// Matterbridge
 import { microwaveOven, powerSource } from '../matterbridgeDeviceTypes.js';
 import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
 import { MatterbridgeServer, MatterbridgeOperationalStateServer } from '../matterbridgeBehaviors.js';
 export class MicrowaveOven extends MatterbridgeEndpoint {
+    /**
+     * Creates an instance of the MicrowaveOven class.
+     *
+     * @param {string} name - The name of the microwave oven.
+     * @param {string} serial - The serial number of the microwave oven.
+     * @param {number} currentMode - The current mode of the microwave oven. Default is 1 = Auto.
+     * @param {MicrowaveOvenMode.ModeOption[]} supportedModes - The supported modes of the microwave oven. Default is an array of all modes.
+     * @param {number} selectedWattIndex - The selected wattage index. Default is 5 (600W).
+     * @param {number[]} supportedWatts - The supported wattages. Default is an array of all standard microwave wattages.
+     * @param {number} cookTime - The initial cook time in seconds. Default is 60 seconds.
+     * @param {number} maxCookTime - The maximum cook time in seconds. Default is 3600 seconds (1 hour).
+     *
+     * @remarks
+     * - 8.12. Microwave Oven Mode Cluster
+     * - Exactly one entry in the SupportedModes attribute SHALL include the Normal mode tag in the ModeTags field.
+     * - The Normal and Defrost mode tags are mutually exclusive and SHALL NOT both be used together in a mode’s ModeTags.
+     */
     constructor(name, serial, currentMode = 1, supportedModes = [
         { label: 'Auto', mode: 1, modeTags: [{ value: MicrowaveOvenMode.ModeTag.Auto }] },
         { label: 'Quick', mode: 2, modeTags: [{ value: MicrowaveOvenMode.ModeTag.Quick }] },
@@ -15,7 +55,8 @@ export class MicrowaveOven extends MatterbridgeEndpoint {
         { label: 'Max', mode: 5, modeTags: [{ value: MicrowaveOvenMode.ModeTag.Max }] },
         { label: 'Normal', mode: 6, modeTags: [{ value: MicrowaveOvenMode.ModeTag.Normal }] },
         { label: 'Defrost', mode: 7, modeTags: [{ value: MicrowaveOvenMode.ModeTag.Defrost }] },
-    ], selectedWattIndex = 5, supportedWatts = [100, 200, 300, 400, 500, 600, 700, 800, 900, 1000], cookTime = 60, maxCookTime = 3600) {
+    ], selectedWattIndex = 5, supportedWatts = [100, 200, 300, 400, 500, 600, 700, 800, 900, 1000], cookTime = 60, // 1 minute
+    maxCookTime = 3600) {
         super([microwaveOven, powerSource], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` });
         this.createDefaultIdentifyClusterServer();
         this.createDefaultBasicInformationClusterServer(name, serial, 0xfff1, 'Matterbridge', 0x8000, 'Microwave Oven');
@@ -24,32 +65,69 @@ export class MicrowaveOven extends MatterbridgeEndpoint {
         this.createDefaultMicrowaveOvenModeClusterServer(currentMode, supportedModes);
         this.createDefaultMicrowaveOvenControlClusterServer(selectedWattIndex, supportedWatts, cookTime, maxCookTime);
     }
+    /**
+     * Creates a default MicrowaveOvenMode Cluster Server.
+     * There is no changeToMode command in the spec, so this is not implemented.
+     * The Microwave is controlled by the MicrowaveOvenControl cluster.
+     *
+     * @param {number} currentMode - The current mode of the oven.
+     * @param {MicrowaveOvenMode.ModeOption[]} supportedModes - The supported modes.
+     *
+     * @returns {MatterbridgeEndpoint} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks
+     * - 8.12. Microwave Oven Mode Cluster
+     * - the supported modes are fixed and cannot be changed at runtime.
+     * - the current mode is persistent among reboots.
+     * - Exactly one entry in the SupportedModes attribute SHALL include the Normal mode tag in the ModeTags field.
+     * - The Normal and Defrost mode tags are mutually exclusive and SHALL NOT both be used together in a mode’s ModeTags.
+     */
     createDefaultMicrowaveOvenModeClusterServer(currentMode, supportedModes) {
         this.behaviors.require(MicrowaveOvenModeServer, {
-            supportedModes,
-            currentMode,
+            supportedModes, // Fixed attribute
+            currentMode, // Persistent attribute
         });
         return this;
     }
+    /**
+     * Creates a default MicrowaveOvenControl Cluster Server.
+     *
+     * @param {number} selectedWattIndex - The selected watt index.
+     * @param {number[]} supportedWatts - The supported watt values.
+     * @param {number} cookTime - The initial cook time.
+     * @param {number} maxCookTime - The maximum cook time.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     *
+     * @remarks
+     * - 8.13. Microwave Oven Control Cluster
+     * - the supported watt values are fixed and cannot be changed at runtime.
+     * - the maxCookTime is a fixed attribute and cannot be changed at runtime.
+     */
     createDefaultMicrowaveOvenControlClusterServer(selectedWattIndex, supportedWatts, cookTime, maxCookTime) {
         this.behaviors.require(MatterbridgeMicrowaveOvenControlServer.with(MicrowaveOvenControl.Feature.PowerInWatts), {
-            supportedWatts,
+            supportedWatts, // Fixed attribute
             selectedWattIndex,
             cookTime,
-            maxCookTime,
+            maxCookTime, // Fixed attribute
         });
         return this;
     }
 }
+/**
+ * Matterbridge Microwave Oven Control Server
+ */
 export class MatterbridgeMicrowaveOvenControlServer extends MicrowaveOvenControlServer.with(MicrowaveOvenControl.Feature.PowerInWatts) {
     initialize() {
         const device = this.endpoint.stateOf(MatterbridgeServer);
         device.log.info('MatterbridgeMicrowaveOvenControlServer initialized');
     }
+    // 8.13.6.2. SetCookingParameters Command
     setCookingParameters(request) {
         const device = this.endpoint.stateOf(MatterbridgeServer);
         device.log.info(`MatterbridgeMicrowaveOvenControlServer: setCookingParameters (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
         device.commandHandler.executeHandler('setCookingParameters', { request, cluster: MicrowaveOvenControl.Cluster.id, attributes: this.state, endpoint: this.endpoint });
+        // 8.13.6.2.1. CookMode Field. Default to Normal mode if not present.
         if (request.cookMode !== undefined) {
             device.log.info(`MatterbridgeMicrowaveOvenControlServer: setCookingParameters called setting cookMode to ${request.cookMode}`);
             this.endpoint.setStateOf(MicrowaveOvenModeServer, { currentMode: request.cookMode });
@@ -60,6 +138,7 @@ export class MatterbridgeMicrowaveOvenControlServer extends MicrowaveOvenControl
             const normalMode = supportedModes.find((mode) => mode.modeTags.some((tag) => tag.value === MicrowaveOvenMode.ModeTag.Normal));
             this.endpoint.setStateOf(MicrowaveOvenModeServer, { currentMode: normalMode?.mode });
         }
+        // 8.13.6.2.2. CookTime Field. Default to 30 seconds.
         if (request.cookTime !== undefined && request.cookTime >= 0 && request.cookTime <= this.state.maxCookTime) {
             device.log.info(`MatterbridgeMicrowaveOvenControlServer: setCookingParameters called setting cookTime to ${request.cookTime}`);
             this.state.cookTime = request.cookTime;
@@ -68,6 +147,7 @@ export class MatterbridgeMicrowaveOvenControlServer extends MicrowaveOvenControl
             device.log.info(`MatterbridgeMicrowaveOvenControlServer: setCookingParameters called with no cookTime so set to 30sec.`);
             this.state.cookTime = 30;
         }
+        // 8.13.6.2.4. WattSettingIndex Field. Default the highest Watt setting for the selected CookMode.
         if (request.wattSettingIndex !== undefined && request.wattSettingIndex >= 0 && request.wattSettingIndex < this.state.supportedWatts.length) {
             device.log.info(`MatterbridgeMicrowaveOvenControlServer: setCookingParameters called setting selectedWattIndex to ${request.wattSettingIndex}`);
             this.state.selectedWattIndex = request.wattSettingIndex;
@@ -76,11 +156,13 @@ export class MatterbridgeMicrowaveOvenControlServer extends MicrowaveOvenControl
             device.log.info(`MatterbridgeMicrowaveOvenControlServer: setCookingParameters called with no wattSettingIndex so set to the highest Watt setting for the selected CookMode`);
             this.state.selectedWattIndex = this.state.supportedWatts.length - 1;
         }
+        // 8.13.6.2.5. StartAfterSetting Field. Default to false.
         if (request.startAfterSetting === true) {
             device.log.info(`MatterbridgeMicrowaveOvenControlServer: setCookingParameters called setting startAfterSetting = true`);
             this.endpoint.setStateOf(MatterbridgeOperationalStateServer, { operationalState: OperationalState.OperationalStateEnum.Running });
         }
     }
+    // 8.13.6.3. AddMoreTime Command
     addMoreTime(request) {
         const device = this.endpoint.stateOf(MatterbridgeServer);
         device.log.info(`MatterbridgeMicrowaveOvenControlServer: addMoreTime (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
@@ -94,3 +176,4 @@ export class MatterbridgeMicrowaveOvenControlServer extends MicrowaveOvenControl
         }
     }
 }
+//# sourceMappingURL=microwaveOven.js.map

package/dist/devices/microwaveOven.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"microwaveOven.js","sourceRoot":"","sources":["../../src/devices/microwaveOven.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,eAAe;AACf,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,kCAAkC,EAAE,MAAM,6BAA6B,CAAC;AAErG,MAAM,OAAO,aAAc,SAAQ,oBAAoB;IACrD;;;;;;;;;;;;;;;;OAgBG;IACH,YACE,IAAY,EACZ,MAAc,EACd,cAAsB,CAAC,EACvB,iBAAiD;QAC/C,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE;QACjF,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE;QACnF,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE;QACnF,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE;QAC/E,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE;QAC/E,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE;QACrF,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE;KACxF,EACD,oBAA4B,CAAC,EAC7B,iBAA2B,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,EAC9E,WAAmB,EAAE,EAAE,WAAW;IAClC,cAAsB,IAAI;QAE1B,KAAK,CAAC,CAAC,aAAa,EAAE,WAAW,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,CAAC,CAAC;QACzG,IAAI,CAAC,kCAAkC,EAAE,CAAC;QAC1C,IAAI,CAAC,0CAA0C,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAChH,IAAI,CAAC,0CAA0C,EAAE,CAAC;QAClD,IAAI,CAAC,0CAA0C,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC/F,IAAI,CAAC,2CAA2C,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QAC9E,IAAI,CAAC,8CAA8C,CAAC,iBAAiB,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAChH,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,2CAA2C,CAAC,WAAmB,EAAE,cAA8C;QAC7G,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,uBAAuB,EAAE;YAC9C,cAAc,EAAE,kBAAkB;YAClC,WAAW,EAAE,uBAAuB;SACrC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,8CAA8C,CAAC,iBAAyB,EAAE,cAAwB,EAAE,QAAgB,EAAE,WAAmB;QACvI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,sCAAsC,CAAC,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE;YAC7G,cAAc,EAAE,kBAAkB;YAClC,iBAAiB;YACjB,QAAQ;YACR,WAAW,EAAE,kBAAkB;SAChC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sCAAuC,SAAQ,0BAA0B,CAAC,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,YAAY,CAAC;IAC3H,UAAU;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,yCAAyC;IAChC,oBAAoB,CAAC,OAAyD;QACrF,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,0EAA0E,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,GAAG,CAAC,CAAC;QACjJ,MAAM,CAAC,cAAc,CAAC,cAAc,CAAC,sBAAsB,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAErK,qEAAqE;QACrE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,2FAA2F,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC/H,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,uBAAuB,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvF,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,uGAAuG,CAAC,CAAC;YACzH,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,cAAc,CAAC;YACrF,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YAC9H,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,uBAAuB,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,qDAAqD;QACrD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAC1G,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,2FAA2F,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC/H,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,uGAAuG,CAAC,CAAC;YACzH,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC;QAC3B,CAAC;QAED,kGAAkG;QAClG,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,IAAI,OAAO,CAAC,gBAAgB,IAAI,CAAC,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;YAC3I,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,oGAAoG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;YAChJ,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,2JAA2J,CAAC,CAAC;YAC7K,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;QACtE,CAAC;QAED,yDAAyD;QACzD,IAAI,OAAO,CAAC,iBAAiB,KAAK,IAAI,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,sGAAsG,CAAC,CAAC;YACxH,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,kCAAkC,EAAE,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC;QACpI,CAAC;IACH,CAAC;IAED,gCAAgC;IACvB,WAAW,CAAC,OAAgD;QACnE,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,iEAAiE,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,GAAG,CAAC,CAAC;QACxI,MAAM,CAAC,cAAc,CAAC,cAAc,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5J,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAClI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,kFAAkF,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;YAC7I,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,oFAAoF,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QAC5H,CAAC;IACH,CAAC;CACF"}

package/dist/devices/oven.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @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 { MaybePromise } from '@matter/general';
+import { Semtag } from '@matter/types';
+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';
+import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
+export declare 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: string, serial: string);
+    /**
+     * 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: string, tagList: Semtag[], currentMode?: number, supportedModes?: OvenMode.ModeOption[], selectedTemperatureLevel?: number, supportedTemperatureLevels?: string[], operationalState?: OperationalState.OperationalStateEnum, currentPhase?: number, phaseList?: string[]): MatterbridgeEndpoint;
+    /**
+     * 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: MatterbridgeEndpoint, currentMode: number, supportedModes: OvenMode.ModeOption[]): MatterbridgeEndpoint;
+    /**
+     * 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: MatterbridgeEndpoint, operationalState?: OperationalState.OperationalStateEnum, currentPhase?: number, phaseList?: string[]): MatterbridgeEndpoint;
+}
+export declare class MatterbridgeOvenModeServer extends OvenModeServer {
+    initialize(): void;
+    changeToMode(request: ModeBase.ChangeToModeRequest): MaybePromise<ModeBase.ChangeToModeResponse>;
+}
+export declare class MatterbridgeOvenCavityOperationalStateServer extends OvenCavityOperationalStateServer {
+    initialize(): void;
+    stop(): MaybePromise<OperationalState.OperationalCommandResponse>;
+    start(): MaybePromise<OperationalState.OperationalCommandResponse>;
+}
+//# sourceMappingURL=oven.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oven.d.ts","sourceRoot":"","sources":["../../src/devices/oven.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,gCAAgC,EAAE,MAAM,sDAAsD,CAAC;AAIxG,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAKlE,qBAAa,IAAK,SAAQ,oBAAoB;IAC5C;;;;;;;;;;;;OAYG;gBACS,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAQxC;;;;;;;;;;;;;;;;;;OAkBG;IACH,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EAAE,EACjB,WAAW,GAAE,MAAU,EACvB,cAAc,GAAE,QAAQ,CAAC,UAAU,EAWlC,EACD,wBAAwB,GAAE,MAAU,EACpC,0BAA0B,GAAE,MAAM,EAAwD,EAC1F,gBAAgB,GAAE,gBAAgB,CAAC,oBAAoE,EACvG,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,oBAAoB;IAWvB;;;;;;;;;;;;OAYG;IACH,kCAAkC,CAAC,QAAQ,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC,UAAU,EAAE,GAAG,oBAAoB;IAQpJ;;;;;;;;;;;;;OAaG;IACH,oDAAoD,CAClD,QAAQ,EAAE,oBAAoB,EAC9B,gBAAgB,GAAE,gBAAgB,CAAC,oBAAoE,EACvG,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,oBAAoB;CAUxB;AAGD,qBAAa,0BAA2B,SAAQ,cAAc;IACnD,UAAU;IAIV,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,mBAAmB,GAAG,YAAY,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CAY1G;AAGD,qBAAa,4CAA6C,SAAQ,gCAAgC;IACvF,UAAU;IAOV,IAAI,IAAI,YAAY,CAAC,gBAAgB,CAAC,0BAA0B,CAAC;IAUjE,KAAK,IAAI,YAAY,CAAC,gBAAgB,CAAC,0BAA0B,CAAC;CAS5E"}