@matterbridge/core 3.5.3 → 3.5.4-dev-20260211-c4f9359

package/dist/matterbridgeAccessoryPlatform.d.ts

@@ -1,49 +1,7 @@
-/**
- * This file contains the class MatterbridgeAccessoryPlatform.
- *
- * @file matterbridgeAccessoryPlatform.ts
- * @author Luca Liguori
- * @created 2023-12-29
- * @version 1.0.6
- * @license Apache-2.0
- *
- * 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 { AnsiLogger } from 'node-ansi-logger';
 import type { PlatformConfig, PlatformMatterbridge } from '@matterbridge/types';
 import { MatterbridgePlatform } from './matterbridgePlatform.js';
-/**
- * Type guard to check whether a value is a MatterbridgeAccessoryPlatform instance.
- *
- * @param {unknown} value - the value to check
- * @returns { value is MatterbridgeAccessoryPlatform } - true if the value is a MatterbridgeAccessoryPlatform instance
- */
 export declare function isMatterbridgeAccessoryPlatform(value: unknown): value is MatterbridgeAccessoryPlatform;
-/**
- * Represents a Matterbridge accessory platform.
- *
- * This class extends the MatterbridgePlatform class.
- */
 export declare class MatterbridgeAccessoryPlatform extends MatterbridgePlatform {
-    /**
-     * Creates an instance of MatterbridgeAccessoryPlatform.
-     *
-     * @param {PlatformMatterbridge} matterbridge - The PlatformMatterbridge instance.
-     * @param {AnsiLogger} log - The logger instance.
-     * @param {PlatformConfig} config - The platform configuration.
-     */
     constructor(matterbridge: PlatformMatterbridge, log: AnsiLogger, config: PlatformConfig);
 }
-//# sourceMappingURL=matterbridgeAccessoryPlatform.d.ts.map

package/dist/matterbridgeAccessoryPlatform.js

@@ -1,71 +1,22 @@
-/**
- * This file contains the class MatterbridgeAccessoryPlatform.
- *
- * @file matterbridgeAccessoryPlatform.ts
- * @author Luca Liguori
- * @created 2023-12-29
- * @version 1.0.6
- * @license Apache-2.0
- *
- * 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.
- */
-// eslint-disable-next-line no-console
 if (process.argv.includes('--loader') || process.argv.includes('-loader'))
     console.log('\u001B[32mMatterbridgeAccessoryPlatform loaded.\u001B[40;0m');
-// Matterbridge
 import { MatterbridgePlatform } from './matterbridgePlatform.js';
-// Module-private brand
 const MATTERBRIDGE_ACCESSORY_PLATFORM_BRAND = Symbol('MatterbridgeAccessoryPlatform.brand');
-/**
- * Type guard to check whether a value is a MatterbridgeAccessoryPlatform instance.
- *
- * @param {unknown} value - the value to check
- * @returns { value is MatterbridgeAccessoryPlatform } - true if the value is a MatterbridgeAccessoryPlatform instance
- */
 export function isMatterbridgeAccessoryPlatform(value) {
     if (!value || typeof value !== 'object')
         return false;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const v = value;
-    // 1. Brand: must be branded by *this* module instance.
     if (v[MATTERBRIDGE_ACCESSORY_PLATFORM_BRAND] !== true)
         return false;
-    // 2. instanceof: strengthen guarantee when there aren't multiple copies of the package.
     if (!(v instanceof MatterbridgeAccessoryPlatform))
         return false;
-    // 3. Shape checks: basic sanity for API surface.
     if (typeof v.name !== 'string' || typeof v.type !== 'string' || typeof v.version !== 'string' || typeof v.config !== 'object')
         return false;
     return true;
 }
-/**
- * Represents a Matterbridge accessory platform.
- *
- * This class extends the MatterbridgePlatform class.
- */
 export class MatterbridgeAccessoryPlatform extends MatterbridgePlatform {
-    /**
-     * Creates an instance of MatterbridgeAccessoryPlatform.
-     *
-     * @param {PlatformMatterbridge} matterbridge - The PlatformMatterbridge instance.
-     * @param {AnsiLogger} log - The logger instance.
-     * @param {PlatformConfig} config - The platform configuration.
-     */
     constructor(matterbridge, log, config) {
         super(matterbridge, log, config);
-        // Set the brand
         Object.defineProperty(this, MATTERBRIDGE_ACCESSORY_PLATFORM_BRAND, {
             value: true,
             writable: false,
@@ -77,4 +28,3 @@ export class MatterbridgeAccessoryPlatform extends MatterbridgePlatform {
         this.log.debug(`Matterbridge${this.type} loaded`);
     }
 }
-//# sourceMappingURL=matterbridgeAccessoryPlatform.js.map

package/dist/matterbridgeBehaviors.d.ts

@@ -1,26 +1,3 @@
-/**
- * This file contains the behavior classes of Matterbridge.
- *
- * @file matterbridgeBehaviors.ts
- * @author Luca Liguori
- * @created 2024-11-07
- * @version 1.3.0
- * @license Apache-2.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 { AnsiLogger } from 'node-ansi-logger';
 import { MaybePromise, NamedHandler } from '@matter/general';
 import { Behavior } from '@matter/node';
@@ -2425,4 +2402,3 @@ export declare class MatterbridgeDeviceEnergyManagementModeServer extends Device
     changeToMode(request: ModeBase.ChangeToModeRequest): MaybePromise<ModeBase.ChangeToModeResponse>;
 }
 export {};
-//# sourceMappingURL=matterbridgeBehaviors.d.ts.map

package/dist/matterbridgeBehaviors.js

@@ -1,28 +1,4 @@
-/**
- * This file contains the behavior classes of Matterbridge.
- *
- * @file matterbridgeBehaviors.ts
- * @author Luca Liguori
- * @created 2024-11-07
- * @version 1.3.0
- * @license Apache-2.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 { Behavior } from '@matter/node';
-// @matter clusters
 import { BooleanStateConfiguration } from '@matter/types/clusters/boolean-state-configuration';
 import { ColorControl } from '@matter/types/clusters/color-control';
 import { FanControl } from '@matter/types/clusters/fan-control';
@@ -36,7 +12,6 @@ import { ServiceArea } from '@matter/types/clusters/service-area';
 import { DeviceEnergyManagement } from '@matter/types/clusters/device-energy-management';
 import { ResourceMonitoring } from '@matter/types/clusters/resource-monitoring';
 import { DeviceEnergyManagementMode } from '@matter/types/clusters/device-energy-management-mode';
-// @matter behaviors
 import { IdentifyServer } from '@matter/node/behaviors/identify';
 import { OnOffServer } from '@matter/node/behaviors/on-off';
 import { LevelControlServer } from '@matter/node/behaviors/level-control';
@@ -262,7 +237,6 @@ export class MatterbridgeLiftWindowCoveringServer extends WindowCoveringServer.w
         super.goToLiftPercentage(request);
     }
     async handleMovement(type, reversed, direction, targetPercent100ths) {
-        // Do nothing here, as the device will handle the movement
     }
 }
 export class MatterbridgeLiftTiltWindowCoveringServer extends WindowCoveringServer.with(WindowCovering.Feature.Lift, WindowCovering.Feature.PositionAwareLift, WindowCovering.Feature.Tilt, WindowCovering.Feature.PositionAwareTilt) {
@@ -302,7 +276,6 @@ export class MatterbridgeLiftTiltWindowCoveringServer extends WindowCoveringServ
         super.goToTiltPercentage(request);
     }
     async handleMovement(type, reversed, direction, targetPercent100ths) {
-        // Do nothing here, as the device will handle the movement
     }
 }
 export class MatterbridgeDoorLockServer extends DoorLockServer {
@@ -344,8 +317,6 @@ export class MatterbridgeFanControlServer extends FanControlServer.with(FanContr
                 this.state.percentCurrent = Math.max(this.state.percentCurrent - 10, request.lowestOff ? 0 : 10);
         }
         device.log.debug('Set percentCurrent to:', this.state.percentCurrent);
-        // step is not implemented in matter.js
-        // super.step(request);
     }
 }
 export class MatterbridgeThermostatServer extends ThermostatServer.with(Thermostat.Feature.Cooling, Thermostat.Feature.Heating, Thermostat.Feature.AutoMode) {
@@ -369,10 +340,8 @@ export class MatterbridgeThermostatServer extends ThermostatServer.with(Thermost
             this.state.occupiedCoolingSetpoint = setpoint * 100;
             device.log.debug(`Set occupiedCoolingSetpoint to ${setpoint}`);
         }
-        // super.setpointRaiseLower(request);
     }
 }
-// istanbul ignore next
 export class MatterbridgePresetThermostatServer extends ThermostatServer.with(Thermostat.Feature.Presets, Thermostat.Feature.Cooling, Thermostat.Feature.Heating, Thermostat.Feature.AutoMode) {
     setpointRaiseLower(request) {
         const device = this.endpoint.stateOf(MatterbridgeServer);
@@ -394,14 +363,12 @@ export class MatterbridgePresetThermostatServer extends ThermostatServer.with(Th
             this.state.occupiedCoolingSetpoint = setpoint * 100;
             device.log.debug(`Set occupiedCoolingSetpoint to ${setpoint}`);
         }
-        // super.setpointRaiseLower(request);
     }
     setActivePresetRequest(request) {
         const device = this.endpoint.stateOf(MatterbridgeServer);
         device.log.info(`Setting preset to ${request.presetHandle} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
         device.commandHandler.executeHandler('setActivePresetRequest', { request, cluster: ThermostatServer.id, attributes: this.state, endpoint: this.endpoint });
         device.log.debug(`MatterbridgePresetThermostatServer: setActivePresetRequest called with presetHandle: ${request.presetHandle}`);
-        // super.setActivePresetRequest(request);
     }
 }
 export class MatterbridgeValveConfigurationAndControlServer extends ValveConfigurationAndControlServer.with(ValveConfigurationAndControl.Feature.Level) {
@@ -417,8 +384,6 @@ export class MatterbridgeValveConfigurationAndControlServer extends ValveConfigu
         this.state.openDuration = request.openDuration ?? this.state.defaultOpenDuration;
         if (this.state.openDuration === null)
             this.state.remainingDuration = null;
-        // open is not implemented in matter.js
-        // super.open(request);
     }
     close() {
         const device = this.endpoint.stateOf(MatterbridgeServer);
@@ -431,8 +396,6 @@ export class MatterbridgeValveConfigurationAndControlServer extends ValveConfigu
         this.state.currentLevel = 0;
         this.state.openDuration = null;
         this.state.remainingDuration = null;
-        // close is not implemented in matter.js
-        // super.close();
     }
 }
 export class MatterbridgeSmokeCoAlarmServer extends SmokeCoAlarmServer.with(SmokeCoAlarm.Feature.SmokeAlarm, SmokeCoAlarm.Feature.CoAlarm) {
@@ -441,8 +404,6 @@ export class MatterbridgeSmokeCoAlarmServer extends SmokeCoAlarmServer.with(Smok
         device.log.info(`Testing SmokeCOAlarm (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
         device.commandHandler.executeHandler('selfTestRequest', { request: {}, cluster: SmokeCoAlarmServer.id, attributes: this.state, endpoint: this.endpoint });
         device.log.debug(`MatterbridgeSmokeCoAlarmServer: selfTestRequest called`);
-        // selfTestRequest is not implemented in matter.js
-        // super.selfTestRequest();
     }
 }
 export class MatterbridgeBooleanStateConfigurationServer extends BooleanStateConfigurationServer.with(BooleanStateConfiguration.Feature.Visual, BooleanStateConfiguration.Feature.Audible, BooleanStateConfiguration.Feature.SensitivityLevel) {
@@ -451,13 +412,10 @@ export class MatterbridgeBooleanStateConfigurationServer extends BooleanStateCon
         device.log.info(`Enabling/disabling alarm ${request.alarmsToEnableDisable} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
         device.commandHandler.executeHandler('enableDisableAlarm', { request, cluster: BooleanStateConfigurationServer.id, attributes: this.state, endpoint: this.endpoint });
         device.log.debug(`MatterbridgeBooleanStateConfigurationServer: enableDisableAlarm called`);
-        // enableDisableAlarm is not implemented in matter.js
-        // super.enableDisableAlarm(request);
     }
 }
 export class MatterbridgeSwitchServer extends SwitchServer {
     initialize() {
-        // Do nothing here, as the device will handle the switch logic: we need to convert something like "single" into the appropriate sequence of state changes and events
     }
 }
 export class MatterbridgeOperationalStateServer extends OperationalStateServer {
@@ -466,7 +424,7 @@ export class MatterbridgeOperationalStateServer extends OperationalStateServer {
         device.log.debug('MatterbridgeOperationalStateServer initialized: setting operational state to Stopped');
         this.state.operationalState = OperationalState.OperationalStateEnum.Stopped;
         this.state.operationalError = { errorStateId: OperationalState.ErrorState.NoError, errorStateDetails: 'Fully operational' };
-        super.initialize(); // Error handling logic is handled in matter.js
+        super.initialize();
     }
     pause() {
         const device = this.endpoint.stateOf(MatterbridgeServer);
@@ -475,8 +433,6 @@ export class MatterbridgeOperationalStateServer extends OperationalStateServer {
         device.log.debug('MatterbridgeOperationalStateServer: pause called setting operational state to Paused');
         this.state.operationalState = OperationalState.OperationalStateEnum.Paused;
         this.state.operationalError = { errorStateId: OperationalState.ErrorState.NoError, errorStateDetails: 'Fully operational' };
-        // pause is not implemented in matter.js
-        // return super.pause();
         return {
             commandResponseState: { errorStateId: OperationalState.ErrorState.NoError, errorStateDetails: 'Fully operational' },
         };
@@ -488,8 +444,6 @@ export class MatterbridgeOperationalStateServer extends OperationalStateServer {
         device.log.debug('MatterbridgeOperationalStateServer: stop called setting operational state to Stopped');
         this.state.operationalState = OperationalState.OperationalStateEnum.Stopped;
         this.state.operationalError = { errorStateId: OperationalState.ErrorState.NoError, errorStateDetails: 'Fully operational' };
-        // stop is not implemented in matter.js
-        // return super.stop();
         return {
             commandResponseState: { errorStateId: OperationalState.ErrorState.NoError, errorStateDetails: 'Fully operational' },
         };
@@ -501,8 +455,6 @@ export class MatterbridgeOperationalStateServer extends OperationalStateServer {
         device.log.debug('MatterbridgeOperationalStateServer: start called setting operational state to Running');
         this.state.operationalState = OperationalState.OperationalStateEnum.Running;
         this.state.operationalError = { errorStateId: OperationalState.ErrorState.NoError, errorStateDetails: 'Fully operational' };
-        // start is not implemented in matter.js
-        // return super.start();
         return {
             commandResponseState: { errorStateId: OperationalState.ErrorState.NoError, errorStateDetails: 'Fully operational' },
         };
@@ -514,8 +466,6 @@ export class MatterbridgeOperationalStateServer extends OperationalStateServer {
         device.log.debug('MatterbridgeOperationalStateServer: resume called setting operational state to Running');
         this.state.operationalState = OperationalState.OperationalStateEnum.Running;
         this.state.operationalError = { errorStateId: OperationalState.ErrorState.NoError, errorStateDetails: 'Fully operational' };
-        // resume is not implemented in matter.js
-        // return super.resume();
         return {
             commandResponseState: { errorStateId: OperationalState.ErrorState.NoError, errorStateDetails: 'Fully operational' },
         };
@@ -536,7 +486,6 @@ export class MatterbridgeServiceAreaServer extends ServiceAreaServer {
         this.state.selectedAreas = request.newAreas;
         device.log.debug(`MatterbridgeServiceAreaServer selectAreas called with: ${request.newAreas.map((area) => area.toString()).join(', ')}`);
         return super.selectAreas(request);
-        // return { status: ServiceArea.SelectAreasStatus.Success, statusText: 'Succesfully selected new areas' };
     }
 }
 export class MatterbridgeModeSelectServer extends ModeSelectServer {
@@ -553,8 +502,8 @@ export class MatterbridgeHepaFilterMonitoringServer extends HepaFilterMonitoring
         const device = this.endpoint.stateOf(MatterbridgeServer);
         device.log.info(`Resetting condition (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
         device.commandHandler.executeHandler('resetCondition', { cluster: MatterbridgeHepaFilterMonitoringServer.id, attributes: this.state, endpoint: this.endpoint });
-        this.state.condition = 100; // Reset condition to 100%
-        this.state.lastChangedTime = Math.floor(new Date().getTime() / 1000); // TlvEpochS (seconds since Unix epoch)
+        this.state.condition = 100;
+        this.state.lastChangedTime = Math.floor(new Date().getTime() / 1000);
         device.log.debug(`MatterbridgeHepaFilterMonitoringServer: resetCondition called`);
     }
 }
@@ -563,8 +512,8 @@ export class MatterbridgeActivatedCarbonFilterMonitoringServer extends Activated
         const device = this.endpoint.stateOf(MatterbridgeServer);
         device.log.info(`Resetting condition (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
         device.commandHandler.executeHandler('resetCondition', { cluster: MatterbridgeActivatedCarbonFilterMonitoringServer.id, attributes: this.state, endpoint: this.endpoint });
-        this.state.condition = 100; // Reset condition to 100%
-        this.state.lastChangedTime = Math.floor(new Date().getTime() / 1000); // TlvEpochS (seconds since Unix epoch)
+        this.state.condition = 100;
+        this.state.lastChangedTime = Math.floor(new Date().getTime() / 1000);
         device.log.debug(`MatterbridgeActivatedCarbonFilterMonitoringServer: resetCondition called`);
     }
 }
@@ -574,18 +523,12 @@ export class MatterbridgeDeviceEnergyManagementServer extends DeviceEnergyManage
         device.log.info(`Adjusting power to ${request.power} duration ${request.duration} cause ${request.cause} (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
         device.commandHandler.executeHandler('powerAdjustRequest', { request, cluster: DeviceEnergyManagementServer.id, attributes: this.state, endpoint: this.endpoint });
         device.log.debug(`MatterbridgeDeviceEnergyManagementServer powerAdjustRequest called with power ${request.power} duration ${request.duration} cause ${request.cause}`);
-        // The implementation is responsible for setting the device accordingly with the powerAdjustRequest command
-        // powerAdjustRequest is not implemented in matter.js
-        // return super.powerAdjustRequest();
     }
     cancelPowerAdjustRequest() {
         const device = this.endpoint.stateOf(MatterbridgeServer);
         device.log.info(`Cancelling power adjustment (endpoint ${this.endpoint.maybeId}.${this.endpoint.maybeNumber})`);
         device.commandHandler.executeHandler('cancelPowerAdjustRequest', { cluster: DeviceEnergyManagementServer.id, attributes: this.state, endpoint: this.endpoint });
         device.log.debug(`MatterbridgeDeviceEnergyManagementServer cancelPowerAdjustRequest called`);
-        // The implementation is responsible for setting the device accordingly with the cancelPowerAdjustRequest command
-        // cancelPowerAdjustRequest is not implemented in matter.js
-        // return super.cancelPowerAdjustRequest();
     }
 }
 export class MatterbridgeDeviceEnergyManagementModeServer extends DeviceEnergyManagementModeServer {
@@ -599,7 +542,6 @@ export class MatterbridgeDeviceEnergyManagementModeServer extends DeviceEnergyMa
             return { status: ModeBase.ModeChangeStatus.UnsupportedMode, statusText: 'Unsupported mode' };
         }
         this.state.currentMode = request.newMode;
-        // The implementation is responsible for setting the device accordingly with the new mode if this logic is not enough
         if (supported.modeTags.find((tag) => tag.value === DeviceEnergyManagementMode.ModeTag.NoOptimization)) {
             if (this.endpoint.behaviors.has(DeviceEnergyManagementServer))
                 this.endpoint.setStateOf(DeviceEnergyManagementServer.with(DeviceEnergyManagement.Feature.PowerForecastReporting, DeviceEnergyManagement.Feature.PowerAdjustment), {
@@ -614,7 +556,5 @@ export class MatterbridgeDeviceEnergyManagementModeServer extends DeviceEnergyMa
         }
         device.log.debug(`MatterbridgeDeviceEnergyManagementModeServer changeToMode called with newMode ${request.newMode} => ${supported.label}`);
         return super.changeToMode(request);
-        // return { status: ModeBase.ModeChangeStatus.Success, statusText: 'Success' };
     }
 }
-//# sourceMappingURL=matterbridgeBehaviors.js.map