matterbridge 1.7.2 → 2.0.0-edge.2

package/dist/matterbridgeAccessoryPlatform.js

@@ -1,37 +1,5 @@
-/**
- * This file contains the class MatterbridgeAccessoryPlatform.
- *
- * @file matterbridgeAccessoryPlatform.ts
- * @author Luca Liguori
- * @date 2023-12-29
- * @version 1.0.5
- *
- * Copyright 2023, 2024, 2025 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 { MatterbridgePlatform } from './matterbridgePlatform.js';
-/**
- * Represents a Matterbridge accessory platform.
- *
- */
 export class MatterbridgeAccessoryPlatform extends MatterbridgePlatform {
-    /**
-     * Creates an instance of MatterbridgeAccessoryPlatform.
-     * @param {Matterbridge} matterbridge - The Matterbridge instance.
-     * @param {AnsiLogger} log - The logger instance.
-     * @param {PlatformConfig} config - The platform configuration.
-     */
     constructor(matterbridge, log, config) {
         super(matterbridge, log, config);
         this.type = 'AccessoryPlatform';
@@ -39,4 +7,3 @@ export class MatterbridgeAccessoryPlatform extends MatterbridgePlatform {
         this.log.debug(`Matterbridge${this.type} loaded`);
     }
 }
-//# sourceMappingURL=matterbridgeAccessoryPlatform.js.map

package/dist/matterbridgeBehaviors.js

@@ -1,37 +1,11 @@
-/**
- * This file contains the class MatterbridgeEndpoint that extends the Endpoint class from the Matter.js library.
- *
- * @file matterbridgeBehaviors.ts
- * @author Luca Liguori
- * @date 2024-11-07
- * @version 1.0.0
- *
- * Copyright 2024, 2025, 2026 Luca Liguori.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License. *
- */
-/* eslint-disable @typescript-eslint/no-namespace */
-/* eslint-disable @typescript-eslint/no-unused-vars */
-/* eslint-disable @typescript-eslint/no-explicit-any */
-// @matter
 import { Behavior } from '@matter/main';
-import { ColorControlServer, DoorLockServer, IdentifyServer, LevelControlServer, WindowCoveringServer, ThermostatServer, FanControlServer, BooleanStateConfigurationServer, } from '@matter/main/behaviors';
-import { BooleanStateConfiguration, ColorControl, FanControl, Thermostat, WindowCovering } from '@matter/main/clusters';
+import { ColorControlServer, DoorLockServer, IdentifyServer, LevelControlServer, WindowCoveringServer, ThermostatServer, FanControlServer, BooleanStateConfigurationServer, ValveConfigurationAndControlServer, } from '@matter/main/behaviors';
+import { BooleanStateConfiguration, ColorControl, FanControl, Thermostat, ValveConfigurationAndControl, WindowCovering } from '@matter/main/clusters';
 import { OnOffServer } from '@matter/node/behaviors/on-off';
 export class MatterbridgeBehaviorDevice {
     log;
     commandHandler;
-    device; // Will be a plugin device
+    device;
     endpointId = undefined;
     endpointNumber = undefined;
     constructor(log, commandHandler, device) {
@@ -129,6 +103,14 @@ export class MatterbridgeBehaviorDevice {
         this.log.info(`Setting setpoint to ${amount} in mode ${mode} (endpoint ${this.endpointId}.${this.endpointNumber})`);
         this.commandHandler.executeHandler('setpointRaiseLower', { request: { mode, amount }, attributes: {}, endpoint: { number: this.endpointNumber, uniqueStorageKey: this.endpointId } });
     }
+    open({ openDuration, targetLevel }) {
+        this.log.info(`Opening valve (endpoint ${this.endpointId}.${this.endpointNumber})`);
+        this.commandHandler.executeHandler('open', { request: { openDuration, targetLevel }, attributes: {}, endpoint: { number: this.endpointNumber, uniqueStorageKey: this.endpointId } });
+    }
+    close() {
+        this.log.info(`Closing valve (endpoint ${this.endpointId}.${this.endpointNumber})`);
+        this.commandHandler.executeHandler('close', { request: {}, attributes: {}, endpoint: { number: this.endpointNumber, uniqueStorageKey: this.endpointId } });
+    }
     enableDisableAlarm({ alarmsToEnableDisable }) {
         this.log.info(`Enabling/disabling alarm ${alarmsToEnableDisable}`);
         this.commandHandler.executeHandler('enableDisableAlarm', { request: { alarmsToEnableDisable }, attributes: {}, endpoint: { number: this.endpointNumber, uniqueStorageKey: this.endpointId } });
@@ -239,7 +221,6 @@ export class MatterbridgeWindowCoveringServer extends WindowCoveringServer.with(
         super.goToLiftPercentage({ liftPercent100thsValue });
     }
     async handleMovement(type, reversed, direction, targetPercent100ths) {
-        // Do nothing here, as the device will handle the movement
     }
 }
 export class MatterbridgeDoorLockServer extends DoorLockServer {
@@ -300,6 +281,18 @@ export class MatterbridgeThermostatServer extends ThermostatServer.with(Thermost
         super.setpointRaiseLower({ mode, amount });
     }
 }
+export class MatterbridgeValveConfigurationAndControlServer extends ValveConfigurationAndControlServer.with(ValveConfigurationAndControl.Feature.Level) {
+    async open({ openDuration, targetLevel }) {
+        const device = this.agent.get(MatterbridgeBehavior).state.deviceCommand;
+        device.open({ openDuration, targetLevel });
+        super.open({ openDuration, targetLevel });
+    }
+    async close() {
+        const device = this.agent.get(MatterbridgeBehavior).state.deviceCommand;
+        device.close();
+        super.close();
+    }
+}
 export class MatterbridgeBooleanStateConfigurationServer extends BooleanStateConfigurationServer.with(BooleanStateConfiguration.Feature.Visual, BooleanStateConfiguration.Feature.Audible, BooleanStateConfiguration.Feature.SensitivityLevel) {
     async enableDisableAlarm({ alarmsToEnableDisable }) {
         const device = this.agent.get(MatterbridgeBehavior).state.deviceCommand;
@@ -307,4 +300,3 @@ export class MatterbridgeBooleanStateConfigurationServer extends BooleanStateCon
         super.enableDisableAlarm({ alarmsToEnableDisable });
     }
 }
-//# sourceMappingURL=matterbridgeBehaviors.js.map

package/dist/matterbridgeDeviceTypes.js

@@ -1,29 +1,5 @@
-/**
- * This file contains the class MatterbridgeDevice.
- *
- * @file matterbridgeDeviceTypes.ts
- * @author Luca Liguori
- * @date 2024-11-08
- * @version 1.0.0
- *
- * Copyright 2024, 2025, 2026 Luca Liguori.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License. *
- */
 import { AirQuality, BooleanState, BooleanStateConfiguration, BridgedDeviceBasicInformation, CarbonDioxideConcentrationMeasurement, CarbonMonoxideConcentrationMeasurement, ColorControl, DeviceEnergyManagement, DeviceEnergyManagementMode, DoorLock, ElectricalEnergyMeasurement, ElectricalPowerMeasurement, EnergyPreference, FanControl, FlowMeasurement, FormaldehydeConcentrationMeasurement, Groups, Identify, IlluminanceMeasurement, LevelControl, ModeSelect, NitrogenDioxideConcentrationMeasurement, OccupancySensing, OnOff, OzoneConcentrationMeasurement, Pm10ConcentrationMeasurement, Pm1ConcentrationMeasurement, Pm25ConcentrationMeasurement, PowerSource, PowerTopology, PressureMeasurement, RadonConcentrationMeasurement, RelativeHumidityMeasurement, SmokeCoAlarm, SwitchCluster, TemperatureMeasurement, Thermostat, ThermostatUserInterfaceConfiguration, TimeSynchronization, TotalVolatileOrganicCompoundsConcentrationMeasurement, WindowCovering, ValveConfigurationAndControl, HepaFilterMonitoring, ActivatedCarbonFilterMonitoring, Actions, FixedLabel, RvcRunMode, RvcOperationalState, RvcCleanMode, ScenesManagement, PumpConfigurationAndControl, } from '@matter/main/clusters';
-// @project-chip
 import { DeviceClasses, DeviceTypeDefinition } from '@project-chip/matter.js/device';
-// Matter 1.0 and 1.1 device types
 export const bridge = DeviceTypeDefinition({
     name: 'MA-aggregator',
     code: 0x000e,
@@ -46,22 +22,6 @@ export const powerSource = DeviceTypeDefinition({
     requiredServerClusters: [PowerSource.Cluster.id],
     optionalServerClusters: [],
 });
-/**
-    2.5.3. Conditions
-    Please see the Base Device Type definition for conformance tags.
-    This device type SHALL only be used for Nodes which have a device type of Bridge.
-  
-    2.5.6. Endpoint Composition
-    • A Bridged Node endpoint SHALL support one of the following composition patterns:
-      ◦ Separate Endpoints: All application device types are supported on separate endpoints, and
-        not on the Bridged Node endpoint. The Bridged Node endpoint’s Descriptor cluster PartsList
-        attribute SHALL indicate a list of all endpoints representing the functionality of the bridged
-        device, including the endpoints supporting the application device types, i.e. the full-family
-        pattern defined in the System Model specification.
-      ◦ One Endpoint: Both the Bridged Node and one or more application device types are sup
-        ported on the same endpoint (following application device type rules). Endpoint composi
-        tion SHALL conform to the application device type(s) definition
- */
 export const bridgedNode = DeviceTypeDefinition({
     name: 'MA-bridgedNode',
     code: 0x0013,
@@ -83,7 +43,7 @@ export const onOffLight = DeviceTypeDefinition({
     code: 0x0100,
     deviceClass: DeviceClasses.Simple,
     revision: 3,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id],
+    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, OnOff.Cluster.id],
     optionalServerClusters: [LevelControl.Cluster.id, ColorControl.Cluster.id],
 });
 export const dimmableLight = DeviceTypeDefinition({
@@ -91,7 +51,7 @@ export const dimmableLight = DeviceTypeDefinition({
     code: 0x0101,
     deviceClass: DeviceClasses.Simple,
     revision: 3,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id, LevelControl.Cluster.id],
+    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, OnOff.Cluster.id, LevelControl.Cluster.id],
     optionalServerClusters: [ColorControl.Cluster.id],
 });
 export const colorTemperatureLight = DeviceTypeDefinition({
@@ -99,7 +59,7 @@ export const colorTemperatureLight = DeviceTypeDefinition({
     code: 0x010c,
     deviceClass: DeviceClasses.Simple,
     revision: 4,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id, LevelControl.Cluster.id, ColorControl.Cluster.id],
+    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, OnOff.Cluster.id, LevelControl.Cluster.id, ColorControl.Cluster.id],
     optionalServerClusters: [],
 });
 export const onOffOutlet = DeviceTypeDefinition({
@@ -107,7 +67,7 @@ export const onOffOutlet = DeviceTypeDefinition({
     code: 0x010a,
     deviceClass: DeviceClasses.Simple,
     revision: 3,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id],
+    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, OnOff.Cluster.id],
     optionalServerClusters: [LevelControl.Cluster.id],
 });
 export const dimmableOutlet = DeviceTypeDefinition({
@@ -115,7 +75,7 @@ export const dimmableOutlet = DeviceTypeDefinition({
     code: 0x010b,
     deviceClass: DeviceClasses.Simple,
     revision: 3,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id, LevelControl.Cluster.id],
+    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, OnOff.Cluster.id, LevelControl.Cluster.id],
     optionalServerClusters: [],
 });
 export const doorLockDevice = DeviceTypeDefinition({
@@ -124,7 +84,7 @@ export const doorLockDevice = DeviceTypeDefinition({
     deviceClass: DeviceClasses.Simple,
     revision: 3,
     requiredServerClusters: [Identify.Cluster.id, DoorLock.Cluster.id],
-    optionalServerClusters: [Groups.Cluster.id /* , Scenes.Cluster.id,*/],
+    optionalServerClusters: [Groups.Cluster.id],
 });
 export const coverDevice = DeviceTypeDefinition({
     name: 'MA-windowCovering',
@@ -132,13 +92,8 @@ export const coverDevice = DeviceTypeDefinition({
     deviceClass: DeviceClasses.Simple,
     revision: 3,
     requiredServerClusters: [Identify.Cluster.id, WindowCovering.Cluster.id],
-    optionalServerClusters: [Groups.Cluster.id /* , Scenes.Cluster.id,*/],
+    optionalServerClusters: [Groups.Cluster.id],
 });
-/**
- *  Remark: it may have a thermostat device type.
- *  Additional device types MAY also be included in device compositions.
- *  The FanControl cluster must have the FanModeSequence attribute.
- */
 export const fanDevice = DeviceTypeDefinition({
     name: 'MA-fan',
     code: 0x2b,
@@ -153,7 +108,7 @@ export const thermostatDevice = DeviceTypeDefinition({
     deviceClass: DeviceClasses.Simple,
     revision: 3,
     requiredServerClusters: [Identify.Cluster.id, Thermostat.Cluster.id],
-    optionalServerClusters: [Groups.Cluster.id /* , Scenes.Cluster.id,*/, ThermostatUserInterfaceConfiguration.Cluster.id, EnergyPreference.Cluster.id, TimeSynchronization.Cluster.id],
+    optionalServerClusters: [Groups.Cluster.id, ThermostatUserInterfaceConfiguration.Cluster.id, EnergyPreference.Cluster.id, TimeSynchronization.Cluster.id],
 });
 export const contactSensor = DeviceTypeDefinition({
     name: 'MA-contactsensor',
@@ -219,34 +174,30 @@ export const roboticVacuumCleaner = DeviceTypeDefinition({
     requiredServerClusters: [Identify.Cluster.id, RvcRunMode.Cluster.id, RvcOperationalState.Cluster.id],
     optionalServerClusters: [RvcCleanMode.Cluster.id],
 });
-// Custom device types without client clusters (not working in Alexa)
 export const onOffSwitch = DeviceTypeDefinition({
     name: 'MA-onoffswitch',
     code: 0x0103,
     deviceClass: DeviceClasses.Simple,
     revision: 3,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id],
+    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, OnOff.Cluster.id],
     optionalServerClusters: [LevelControl.Cluster.id, ColorControl.Cluster.id],
 });
-// Custom device types without client clusters (not working in Alexa)
 export const dimmableSwitch = DeviceTypeDefinition({
     name: 'MA-dimmableswitch',
     code: 0x0104,
     deviceClass: DeviceClasses.Simple,
     revision: 3,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id, LevelControl.Cluster.id],
+    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, OnOff.Cluster.id, LevelControl.Cluster.id],
     optionalServerClusters: [ColorControl.Cluster.id],
 });
-// Custom device types without client clusters (not working in Alexa)
 export const colorTemperatureSwitch = DeviceTypeDefinition({
     name: 'MA-colortemperatureswitch',
     code: 0x0105,
     deviceClass: DeviceClasses.Simple,
     revision: 3,
-    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, /* Scenes.Cluster.id,*/ OnOff.Cluster.id, LevelControl.Cluster.id, ColorControl.Cluster.id],
+    requiredServerClusters: [Identify.Cluster.id, Groups.Cluster.id, OnOff.Cluster.id, LevelControl.Cluster.id, ColorControl.Cluster.id],
     optionalServerClusters: [],
 });
-// Matter 1.2 and 1.3 device types
 export const airQualitySensor = DeviceTypeDefinition({
     name: 'MA-airQualitySensor',
     code: 0x002c,
@@ -292,7 +243,6 @@ export const rainSensor = DeviceTypeDefinition({
     requiredServerClusters: [Identify.Cluster.id, BooleanState.Cluster.id],
     optionalServerClusters: [BooleanStateConfiguration.Cluster.id],
 });
-// Remark: A Smoke CO Alarm device type SHALL support an instance of a Power Source device type on some endpoint.
 export const smokeCoAlarm = DeviceTypeDefinition({
     name: 'MA-smokeCoAlarm',
     code: 0x0076,
@@ -301,12 +251,6 @@ export const smokeCoAlarm = DeviceTypeDefinition({
     requiredServerClusters: [Identify.Cluster.id, SmokeCoAlarm.Cluster.id],
     optionalServerClusters: [Groups.Cluster.id, TemperatureMeasurement.Cluster.id, RelativeHumidityMeasurement.Cluster.id, CarbonMonoxideConcentrationMeasurement.Cluster.id],
 });
-/**
- *  Remark: LevelControl cluster:
- *   0 N/A Pump is stopped,
- *   1–200 Level / 2 (0.5–100.0%) Pump setpoint in percent
- *   201–255 100.0% Pump setpoint is 100.0%
- */
 export const pumpDevice = DeviceTypeDefinition({
     name: 'MA-pump',
     code: 0x303,
@@ -323,10 +267,6 @@ export const waterValve = DeviceTypeDefinition({
     requiredServerClusters: [Identify.Cluster.id, ValveConfigurationAndControl.Cluster.id],
     optionalServerClusters: [FlowMeasurement.Cluster.id],
 });
-/**
- *  Remark: it may have a Thermostat, Temperature Sensor, Humidity Sensor and an Air Quality Sensor device type.
- *  Additional device types MAY also be included in device compositions.
- */
 export const airPurifier = DeviceTypeDefinition({
     name: 'MA-airPurifier',
     code: 0x2d,
@@ -335,16 +275,6 @@ export const airPurifier = DeviceTypeDefinition({
     requiredServerClusters: [Identify.Cluster.id, FanControl.Cluster.id],
     optionalServerClusters: [Groups.Cluster.id, HepaFilterMonitoring.Cluster.id, ActivatedCarbonFilterMonitoring.Cluster.id],
 });
-/**
- *  Remark: it may have a temperature sensor and a humidity sensor device.
- *  Additional device types MAY also be included in device compositions.
- *  The DF (Dead Front) feature is required for the On/Off cluster in this device type:
- *  - Thermostat                      LocalTemperature    null
- *  - Temperature Measurement         MeasuredValue       null
- *  - Relative Humidity Measurement   MeasuredValue       null
- *  - Fan Control                     SpeedSetting        null
- *  - Fan Control                     PercentSetting      null
- */
 export const airConditioner = DeviceTypeDefinition({
     name: 'MA-airConditioner',
     code: 0x72,
@@ -369,4 +299,3 @@ export const deviceEnergyManagement = DeviceTypeDefinition({
     requiredServerClusters: [DeviceEnergyManagement.Cluster.id, DeviceEnergyManagementMode.Cluster.id],
     optionalServerClusters: [],
 });
-//# sourceMappingURL=matterbridgeDeviceTypes.js.map

package/dist/matterbridgeDynamicPlatform.js

@@ -1,37 +1,5 @@
-/**
- * This file contains the class MatterbridgeDynamicPlatform.
- *
- * @file matterbridgeDynamicPlatform.ts
- * @author Luca Liguori
- * @date 2023-12-29
- * @version 1.0.5
- *
- * Copyright 2023, 2024, 2025 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 { MatterbridgePlatform } from './matterbridgePlatform.js';
-/**
- * Represents a dynamic platform for Matterbridge.
- *
- */
 export class MatterbridgeDynamicPlatform extends MatterbridgePlatform {
-    /**
-     * Creates an instance of MatterbridgeDynamicPlatform.
-     * @param {Matterbridge} matterbridge - The Matterbridge instance.
-     * @param {AnsiLogger} log - The logger instance.
-     * @param {PlatformConfig} config - The platform configuration.
-     */
     constructor(matterbridge, log, config) {
         super(matterbridge, log, config);
         this.type = 'DynamicPlatform';
@@ -39,4 +7,3 @@ export class MatterbridgeDynamicPlatform extends MatterbridgePlatform {
         this.log.debug(`Matterbridge${this.type} loaded`);
     }
 }
-//# sourceMappingURL=matterbridgeDynamicPlatform.js.map