@matterbridge/core 3.5.3

package/dist/devices/basicVideoPlayer.js

@@ -0,0 +1,155 @@
+/**
+ * @description This file contains the BasicVideoPlayer class.
+ * @file src/devices/basicVideoPlayer.ts
+ * @author Luca Liguori
+ * @created 2026-01-25
+ * @version 1.0.0
+ * @license Apache-2.0
+ *
+ * Copyright 2025, 2026, 2027 Luca Liguori.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { MediaPlayback } from '@matter/types/clusters/media-playback';
+import { KeypadInput } from '@matter/types/clusters/keypad-input';
+import { MediaPlaybackServer } from '@matter/node/behaviors/media-playback';
+import { KeypadInputServer } from '@matter/node/behaviors/keypad-input';
+// Matterbridge
+import { basicVideoPlayer, powerSource } from '../matterbridgeDeviceTypes.js';
+import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
+import { MatterbridgeOnOffServer, MatterbridgeServer } from '../matterbridgeBehaviors.js';
+export class BasicVideoPlayer extends MatterbridgeEndpoint {
+    /**
+     * Creates an instance of the BasicVideoPlayer class.
+     *
+     * A Video Player (either Basic or Casting) represents a device that is able to play media to a physical
+     * output or to a display screen which is part of the device.
+     *
+     * @param {string} name - The name of the video player.
+     * @param {string} serial - The serial number of the video player.
+     * @param {BasicVideoPlayerOptions} [options] - Optional configuration values. Missing fields use defaults.
+     *
+     * Options defaults:
+     *  - onOff: false
+     *  - playbackState: NotPlaying
+     *
+     * @returns {BasicVideoPlayer} The BasicVideoPlayer instance.
+     *
+     * @remarks Not supported by Google Home.
+     */
+    constructor(name, serial, options = {}) {
+        const { onOff = false, playbackState = MediaPlayback.PlaybackState.NotPlaying } = options;
+        super([basicVideoPlayer, powerSource], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` });
+        this.createDefaultBasicInformationClusterServer(name, serial, 0xfff1, 'Matterbridge', 0x8000, 'Matterbridge Basic Video Player');
+        this.createDefaultPowerSourceWiredClusterServer();
+        this.createOnOffClusterServer(onOff);
+        this.createDefaultMediaPlaybackClusterServer(playbackState);
+        this.createDefaultKeypadInputClusterServer();
+    }
+    /**
+     * Creates a default Media Playback Cluster Server.
+     *
+     * @param {MediaPlayback.PlaybackState} currentState - The current state of the video player.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
+    createDefaultMediaPlaybackClusterServer(currentState) {
+        this.behaviors.require(MatterbridgeMediaPlaybackServer.enable({
+            commands: { next: true, previous: true, skipForward: true, skipBackward: true },
+        }), {
+            currentState,
+        });
+        return this;
+    }
+    /**
+     * Creates a default Keypad Input Cluster Server.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
+    createDefaultKeypadInputClusterServer() {
+        this.behaviors.require(MatterbridgeKeypadInputServer, {
+        // No attributes to initialize
+        });
+        return this;
+    }
+}
+export class MatterbridgeMediaPlaybackServer extends MediaPlaybackServer {
+    initialize() {
+        const device = this.endpoint.stateOf(MatterbridgeServer);
+        device.log.info(`MatterbridgeMediaPlaybackServer initialized: currentState is ${this.state.currentState}`);
+        this.reactTo(this.agent.get(MatterbridgeOnOffServer).events.onOff$Changed, this.handleOnOffChange);
+    }
+    handleOnOffChange(_onOff) {
+        this.state.currentState = MediaPlayback.PlaybackState.NotPlaying;
+    }
+    play() {
+        const device = this.endpoint.stateOf(MatterbridgeServer);
+        device.log.info(`Play (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
+        device.commandHandler.executeHandler('play', { request: undefined, cluster: MediaPlaybackServer.id, attributes: this.state, endpoint: this.endpoint });
+        if (this.endpoint.stateOf(MatterbridgeOnOffServer).onOff === true)
+            this.state.currentState = MediaPlayback.PlaybackState.Playing;
+        return { status: MediaPlayback.Status.Success };
+    }
+    pause() {
+        const device = this.endpoint.stateOf(MatterbridgeServer);
+        device.log.info(`Pause (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
+        device.commandHandler.executeHandler('pause', { request: undefined, cluster: MediaPlaybackServer.id, attributes: this.state, endpoint: this.endpoint });
+        if (this.endpoint.stateOf(MatterbridgeOnOffServer).onOff === true)
+            this.state.currentState = MediaPlayback.PlaybackState.Paused;
+        return { status: MediaPlayback.Status.Success };
+    }
+    stop() {
+        const device = this.endpoint.stateOf(MatterbridgeServer);
+        device.log.info(`Stop (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
+        device.commandHandler.executeHandler('stop', { request: undefined, cluster: MediaPlaybackServer.id, attributes: this.state, endpoint: this.endpoint });
+        if (this.endpoint.stateOf(MatterbridgeOnOffServer).onOff === true)
+            this.state.currentState = MediaPlayback.PlaybackState.NotPlaying;
+        return { status: MediaPlayback.Status.Success };
+    }
+    previous() {
+        const device = this.endpoint.stateOf(MatterbridgeServer);
+        device.log.info(`Previous (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
+        device.commandHandler.executeHandler('previous', { request: undefined, cluster: MediaPlaybackServer.id, attributes: this.state, endpoint: this.endpoint });
+        return { status: MediaPlayback.Status.Success };
+    }
+    next() {
+        const device = this.endpoint.stateOf(MatterbridgeServer);
+        device.log.info(`Next (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
+        device.commandHandler.executeHandler('next', { request: undefined, cluster: MediaPlaybackServer.id, attributes: this.state, endpoint: this.endpoint });
+        return { status: MediaPlayback.Status.Success };
+    }
+    skipForward() {
+        const device = this.endpoint.stateOf(MatterbridgeServer);
+        device.log.info(`SkipForward (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
+        device.commandHandler.executeHandler('skipForward', { request: undefined, cluster: MediaPlaybackServer.id, attributes: this.state, endpoint: this.endpoint });
+        return { status: MediaPlayback.Status.Success };
+    }
+    skipBackward() {
+        const device = this.endpoint.stateOf(MatterbridgeServer);
+        device.log.info(`SkipBackward (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
+        device.commandHandler.executeHandler('skipBackward', { request: undefined, cluster: MediaPlaybackServer.id, attributes: this.state, endpoint: this.endpoint });
+        return { status: MediaPlayback.Status.Success };
+    }
+}
+export class MatterbridgeKeypadInputServer extends KeypadInputServer {
+    initialize() {
+        const device = this.endpoint.stateOf(MatterbridgeServer);
+        device.log.info(`MatterbridgeKeypadInputServer initialized`);
+    }
+    sendKey(request) {
+        const device = this.endpoint.stateOf(MatterbridgeServer);
+        device.log.info(`SendKey keyCode ${request.keyCode} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
+        device.commandHandler.executeHandler('sendKey', { request, cluster: KeypadInputServer.id, attributes: this.state, endpoint: this.endpoint });
+        return { status: KeypadInput.Status.Success };
+    }
+}
+//# sourceMappingURL=basicVideoPlayer.js.map

package/dist/devices/basicVideoPlayer.js.map

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

package/dist/devices/batteryStorage.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @description This file contains the BatteryStorage class.
+ * @file src/devices/batteryStorage.ts
+ * @author Luca Liguori
+ * @contributor Ludovic BOUÉ
+ * @created 2025-06-20
+ * @version 1.0.0
+ * @license Apache-2.0
+ *
+ * Copyright 2025, 2026, 2027 Luca Liguori.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { PowerSource } from '@matter/types/clusters/power-source';
+import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
+export declare class BatteryStorage extends MatterbridgeEndpoint {
+    /**
+     * Creates an instance of the BatteryStorage class.
+     *
+     * @param {string} name - The name of the BatteryStorage.
+     * @param {string} serial - The serial number of the BatteryStorage.
+     * @param {number} [batPercentRemaining] - The percentage of battery remaining, defaults to `100` if not provided.
+     * @param {PowerSource.BatChargeLevel} [batChargeLevel] - The battery charge level (default: PowerSource.BatChargeLevel.Ok).
+     * @param {number} voltage - The voltage value in millivolts.
+     * @param {number} current - The current value in milliamperes.
+     * @param {number} power - The power value in milliwatts.
+     * @param {number} energyImported - The total production value in mW/h.
+     * @param {number} energyExported - The total production value in mW/h.
+     * @param {number} [absMinPower] - Indicate the minimum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
+     * @param {number} [absMaxPower] - Indicate the maximum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
+     *
+     * @remarks
+     * - A battery storage inverter that can charge its battery at a maximum power of 2000W and can
+     * discharge the battery at a maximum power of 3000W, would have a absMinPower: -3000W, absMaxPower: 2000W.
+     */
+    constructor(name: string, serial: string, batPercentRemaining?: number, batChargeLevel?: PowerSource.BatChargeLevel, voltage?: number | bigint | null, current?: number | bigint | null, power?: number | bigint | null, energyImported?: number | bigint | null, energyExported?: number | bigint | null, absMinPower?: number, absMaxPower?: number);
+}
+//# sourceMappingURL=batteryStorage.d.ts.map

package/dist/devices/batteryStorage.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,qCAAqC,CAAC;AAGlE,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

@@ -0,0 +1,75 @@
+/**
+ * @description This file contains the BatteryStorage class.
+ * @file src/devices/batteryStorage.ts
+ * @author Luca Liguori
+ * @contributor Ludovic BOUÉ
+ * @created 2025-06-20
+ * @version 1.0.0
+ * @license Apache-2.0
+ *
+ * Copyright 2025, 2026, 2027 Luca Liguori.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// @matter
+import { PowerSourceTag } from '@matter/node';
+import { DeviceEnergyManagement } from '@matter/types/clusters/device-energy-management';
+import { PowerSource } from '@matter/types/clusters/power-source';
+// Matterbridge
+import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
+import { deviceEnergyManagement, electricalSensor, batteryStorage, powerSource } from '../matterbridgeDeviceTypes.js';
+export class BatteryStorage extends MatterbridgeEndpoint {
+    /**
+     * Creates an instance of the BatteryStorage class.
+     *
+     * @param {string} name - The name of the BatteryStorage.
+     * @param {string} serial - The serial number of the BatteryStorage.
+     * @param {number} [batPercentRemaining] - The percentage of battery remaining, defaults to `100` if not provided.
+     * @param {PowerSource.BatChargeLevel} [batChargeLevel] - The battery charge level (default: PowerSource.BatChargeLevel.Ok).
+     * @param {number} voltage - The voltage value in millivolts.
+     * @param {number} current - The current value in milliamperes.
+     * @param {number} power - The power value in milliwatts.
+     * @param {number} energyImported - The total production value in mW/h.
+     * @param {number} energyExported - The total production value in mW/h.
+     * @param {number} [absMinPower] - Indicate the minimum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
+     * @param {number} [absMaxPower] - Indicate the maximum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
+     *
+     * @remarks
+     * - A battery storage inverter that can charge its battery at a maximum power of 2000W and can
+     * discharge the battery at a maximum power of 3000W, would have a absMinPower: -3000W, absMaxPower: 2000W.
+     */
+    constructor(name, serial, batPercentRemaining = 100, batChargeLevel = PowerSource.BatChargeLevel.Ok, voltage = null, current = null, power = null, energyImported = null, energyExported = null, absMinPower = 0, absMaxPower = 0) {
+        super([batteryStorage, electricalSensor, deviceEnergyManagement], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` });
+        this.createDefaultIdentifyClusterServer()
+            .createDefaultBasicInformationClusterServer(name, serial, 0xfff1, 'Matterbridge', 0x8000, 'Matterbridge Solar Power')
+            .createDefaultPowerTopologyClusterServer()
+            .createDefaultElectricalPowerMeasurementClusterServer(voltage, current, power)
+            .createDefaultElectricalEnergyMeasurementClusterServer(energyImported, energyExported)
+            .createDefaultDeviceEnergyManagementClusterServer(DeviceEnergyManagement.EsaType.BatteryStorage, true, DeviceEnergyManagement.EsaState.Online, absMinPower, absMaxPower)
+            .createDefaultDeviceEnergyManagementModeClusterServer()
+            .addRequiredClusterServers();
+        // Add separate PowerSource child devices cause in matter.js the PowerSource cluster is not supported with both features Wired and Battery.
+        // Probably this is also an error in the specification...
+        this.addChildDeviceType('BatteryPowerSource', powerSource, {
+            tagList: [{ mfgCode: null, namespaceId: PowerSourceTag.Battery.namespaceId, tag: PowerSourceTag.Battery.tag, label: null }],
+        })
+            .createDefaultPowerSourceRechargeableBatteryClusterServer(batPercentRemaining, batChargeLevel, 24_000) // Battery voltage in mV (24V).
+            .addRequiredClusterServers();
+        this.addChildDeviceType('GridPowerSource', powerSource, {
+            tagList: [{ mfgCode: null, namespaceId: PowerSourceTag.Grid.namespaceId, tag: PowerSourceTag.Grid.tag, label: null }],
+        })
+            .createDefaultPowerSourceWiredClusterServer()
+            .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,iDAAiD,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAElE,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,CAAC,CAAC;QACvI,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/castingVideoPlayer.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @description This file contains the CastingVideoPlayer class.
+ * @file src/devices/castingVideoPlayer.ts
+ * @author Luca Liguori
+ * @created 2026-01-25
+ * @version 1.0.0
+ * @license Apache-2.0
+ *
+ * Copyright 2025, 2026, 2027 Luca Liguori.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { MediaPlayback } from '@matter/types/clusters/media-playback';
+import { ContentLauncherServer } from '@matter/node/behaviors/content-launcher';
+import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
+/**
+ * Options for configuring an {@link AirConditioner} instance.
+ *
+ * All temperatures in °C. Typical valid range 0–50 unless otherwise noted.
+ */
+export interface CastingVideoPlayerOptions {
+    /** Device state */
+    onOff?: boolean;
+    playbackState?: MediaPlayback.PlaybackState;
+}
+export declare class CastingVideoPlayer extends MatterbridgeEndpoint {
+    /**
+     * Creates an instance of the CastingVideoPlayer class.
+     *
+     * A Video Player (either Basic or Casting) represents a device that is able to play media to a physical
+     * output or to a display screen which is part of the device.
+     *
+     * @param {string} name - The name of the video player.
+     * @param {string} serial - The serial number of the video player.
+     * @param {CastingVideoPlayerOptions} [options] - Optional configuration values. Missing fields use defaults.
+     *
+     * Options defaults:
+     *  - onOff: false
+     *  - playbackState: NotPlaying
+     *
+     * @returns {CastingVideoPlayer} The CastingVideoPlayer instance.
+     *
+     * @remarks Not supported by Google Home.
+     */
+    constructor(name: string, serial: string, options?: CastingVideoPlayerOptions);
+    /**
+     * Creates a default Media Playback Cluster Server.
+     *
+     * @param {MediaPlayback.PlaybackState} currentState - The current state of the video player.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
+    createDefaultMediaPlaybackClusterServer(currentState: MediaPlayback.PlaybackState): this;
+    /**
+     * Creates a default Keypad Input Cluster Server.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
+    createDefaultKeypadInputClusterServer(): this;
+    /**
+     * Creates a default Keypad Input Cluster Server.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
+    createDefaultContentLauncherClusterServer(): this;
+}
+export declare class MatterbridgeContentLauncherServer extends ContentLauncherServer {
+    initialize(): void;
+}
+//# sourceMappingURL=castingVideoPlayer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"castingVideoPlayer.d.ts","sourceRoot":"","sources":["../../src/devices/castingVideoPlayer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAIhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAKlE;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,mBAAmB;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC;CAC7C;AAED,qBAAa,kBAAmB,SAAQ,oBAAoB;IAC1D;;;;;;;;;;;;;;;;;OAiBG;gBACS,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,yBAA8B;IAWjF;;;;;OAKG;IACH,uCAAuC,CAAC,YAAY,EAAE,aAAa,CAAC,aAAa,GAAG,IAAI;IAOxF;;;;OAIG;IACH,qCAAqC,IAAI,IAAI;IAO7C;;;;OAIG;IACH,yCAAyC,IAAI,IAAI;CAMlD;AAED,qBAAa,iCAAkC,SAAQ,qBAAqB;IACjE,UAAU;CAIpB"}

package/dist/devices/castingVideoPlayer.js

@@ -0,0 +1,101 @@
+/**
+ * @description This file contains the CastingVideoPlayer class.
+ * @file src/devices/castingVideoPlayer.ts
+ * @author Luca Liguori
+ * @created 2026-01-25
+ * @version 1.0.0
+ * @license Apache-2.0
+ *
+ * Copyright 2025, 2026, 2027 Luca Liguori.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Imports from @matter
+import { MediaPlayback } from '@matter/types/clusters/media-playback';
+import { ContentLauncherServer } from '@matter/node/behaviors/content-launcher';
+// Matterbridge
+import { castingVideoPlayer, powerSource } from '../matterbridgeDeviceTypes.js';
+import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
+import { MatterbridgeServer } from '../matterbridgeBehaviors.js';
+import { MatterbridgeKeypadInputServer, MatterbridgeMediaPlaybackServer } from './basicVideoPlayer.js';
+export class CastingVideoPlayer extends MatterbridgeEndpoint {
+    /**
+     * Creates an instance of the CastingVideoPlayer class.
+     *
+     * A Video Player (either Basic or Casting) represents a device that is able to play media to a physical
+     * output or to a display screen which is part of the device.
+     *
+     * @param {string} name - The name of the video player.
+     * @param {string} serial - The serial number of the video player.
+     * @param {CastingVideoPlayerOptions} [options] - Optional configuration values. Missing fields use defaults.
+     *
+     * Options defaults:
+     *  - onOff: false
+     *  - playbackState: NotPlaying
+     *
+     * @returns {CastingVideoPlayer} The CastingVideoPlayer instance.
+     *
+     * @remarks Not supported by Google Home.
+     */
+    constructor(name, serial, options = {}) {
+        const { onOff = false, playbackState = MediaPlayback.PlaybackState.NotPlaying } = options;
+        super([castingVideoPlayer, powerSource], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` });
+        this.createDefaultBasicInformationClusterServer(name, serial, 0xfff1, 'Matterbridge', 0x8000, 'Matterbridge Casting Video Player');
+        this.createDefaultPowerSourceWiredClusterServer();
+        this.createOnOffClusterServer(onOff);
+        this.createDefaultMediaPlaybackClusterServer(playbackState);
+        this.createDefaultKeypadInputClusterServer();
+        this.createDefaultContentLauncherClusterServer();
+    }
+    /**
+     * Creates a default Media Playback Cluster Server.
+     *
+     * @param {MediaPlayback.PlaybackState} currentState - The current state of the video player.
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
+    createDefaultMediaPlaybackClusterServer(currentState) {
+        this.behaviors.require(MatterbridgeMediaPlaybackServer, {
+            currentState,
+        });
+        return this;
+    }
+    /**
+     * Creates a default Keypad Input Cluster Server.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
+    createDefaultKeypadInputClusterServer() {
+        this.behaviors.require(MatterbridgeKeypadInputServer, {
+        // No attributes to initialize
+        });
+        return this;
+    }
+    /**
+     * Creates a default Keypad Input Cluster Server.
+     *
+     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
+     */
+    createDefaultContentLauncherClusterServer() {
+        this.behaviors.require(MatterbridgeContentLauncherServer, {
+        // No attributes to initialize
+        });
+        return this;
+    }
+}
+export class MatterbridgeContentLauncherServer extends ContentLauncherServer {
+    initialize() {
+        const device = this.endpoint.stateOf(MatterbridgeServer);
+        device.log.info(`MatterbridgeContentLauncherServer initialized`);
+    }
+}
+//# sourceMappingURL=castingVideoPlayer.js.map

package/dist/devices/castingVideoPlayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"castingVideoPlayer.js","sourceRoot":"","sources":["../../src/devices/castingVideoPlayer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,uBAAuB;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAEhF,eAAe;AACf,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AAavG,MAAM,OAAO,kBAAmB,SAAQ,oBAAoB;IAC1D;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,IAAY,EAAE,MAAc,EAAE,UAAqC,EAAE;QAC/E,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,aAAa,GAAG,aAAa,CAAC,aAAa,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC;QAC1F,KAAK,CAAC,CAAC,kBAAkB,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;QAC9G,IAAI,CAAC,0CAA0C,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,mCAAmC,CAAC,CAAC;QACnI,IAAI,CAAC,0CAA0C,EAAE,CAAC;QAClD,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,uCAAuC,CAAC,aAAa,CAAC,CAAC;QAC5D,IAAI,CAAC,qCAAqC,EAAE,CAAC;QAC7C,IAAI,CAAC,yCAAyC,EAAE,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACH,uCAAuC,CAAC,YAAyC;QAC/E,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,+BAA+B,EAAE;YACtD,YAAY;SACb,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,qCAAqC;QACnC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,6BAA6B,EAAE;QACpD,8BAA8B;SAC/B,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,yCAAyC;QACvC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,iCAAiC,EAAE;QACxD,8BAA8B;SAC/B,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,MAAM,OAAO,iCAAkC,SAAQ,qBAAqB;IACjE,UAAU;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;CACF"}

package/dist/devices/cooktop.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @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 OffOnly feature is required for the On/Off cluster in this device type due to safety requirements.
+     * TemperatureLevel is the only valid temperature control mode.
+     */
+    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;;;;;;;;;;;;;;;;OAgBG;IACH,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EAAE,EACjB,wBAAwB,GAAE,MAAU,EACpC,0BAA0B,GAAE,MAAM,EAA4D,GAC7F,oBAAoB;CAQxB"}

package/dist/devices/cooktop.js

@@ -0,0 +1,77 @@
+/**
+ * @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], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` });
+        this.createDefaultIdentifyClusterServer();
+        this.createDefaultBasicInformationClusterServer(name, serial, 0xfff1, 'Matterbridge', 0x8000, 'Cooktop');
+        this.createDefaultPowerSourceWiredClusterServer();
+        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 OffOnly feature is required for the On/Off cluster in this device type due to safety requirements.
+     * TemperatureLevel is the only valid temperature control mode.
+     */
+    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;
+        createLevelTemperatureControlClusterServer(surface, selectedTemperatureLevel, supportedTemperatureLevels);
+        surface.createDefaultTemperatureMeasurementClusterServer(2000);
+        surface.createOffOnlyOnOffClusterServer(true);
+        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,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACnG,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;;;;;;;;;;;;;;;;OAgBG;IACH,UAAU,CACR,IAAY,EACZ,OAAiB,EACjB,2BAAmC,CAAC,EACpC,6BAAuC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;QAE9F,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"}