matterbridge 3.1.4 → 3.1.5-dev-20250720-5a0b41e

package/dist/devices/waterHeater.d.ts

@@ -1,111 +0,0 @@
-/**
- * @description This file contains the WaterHeater class.
- * @file src/devices/waterHeater.ts
- * @author Luca Liguori
- * @contributor Ludovic BOUÉ
- * @created 2025-05-18
- * @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/main';
-import { ModeBase } from '@matter/main/clusters/mode-base';
-import { WaterHeaterManagement } from '@matter/main/clusters/water-heater-management';
-import { WaterHeaterMode } from '@matter/main/clusters/water-heater-mode';
-import { WaterHeaterManagementServer } from '@matter/main/behaviors/water-heater-management';
-import { WaterHeaterModeServer } from '@matter/main/behaviors/water-heater-mode';
-import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
-export declare class WaterHeater extends MatterbridgeEndpoint {
-    /**
-     * Creates an instance of the WaterHeater class.
-     *
-     * @param {string} name - The name of the water heater.
-     * @param {string} serial - The serial number of the water heater.
-     * @param {number} [waterTemperature] - The current water temperature. Defaults to 50.
-     * @param {number} [targetWaterTemperature] - The target water temperature. Defaults to 55.
-     * @param {number} [minHeatSetpointLimit] - The minimum heat setpoint limit. Defaults to 20.
-     * @param {number} [maxHeatSetpointLimit] - The maximum heat setpoint limit. Defaults to 80.
-     * @param {{ immersionElement1?: boolean; immersionElement2?: boolean; heatPump?: boolean; boiler?: boolean; other?: boolean }} [heaterTypes] - Indicates the heat sources that the water heater can call on for heating. Defaults to { immersionElement1: true }.
-     * @param {boolean} heaterTypes.immersionElement1 - Indicates if the water heater has an immersion element 1. Defaults to true.
-     * @param {boolean} heaterTypes.immersionElement2 - Indicates if the water heater has an immersion element 2.
-     * @param {boolean} heaterTypes.heatPump - Indicates if the water heater has a heat pump.
-     * @param {boolean} heaterTypes.boiler - Indicates if the water heater has a boiler.
-     * @param {boolean} heaterTypes.other - Indicates if the water heater has other types of heating sources.
-     * @param {number} [tankPercentage] - The current tank percentage of the WaterHeaterManagement cluster. Defaults to 90.
-     * @param {number} [voltage] - The voltage value in millivolts. Defaults to null if not provided.
-     * @param {number} [current] - The current value in milliamperes. Defaults to null if not provided.
-     * @param {number} [power] - The power value in milliwatts. Defaults to null if not provided.
-     * @param {number} [energy] - The total consumption value in mW/h. Defaults to null if not provided.
-     * @param {number} [absMinPower] - Indicate the minimum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
-     * @param {number} [absMaxPower] - Indicate the maximum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
-     */
-    constructor(name: string, serial: string, waterTemperature?: number, targetWaterTemperature?: number, minHeatSetpointLimit?: number, maxHeatSetpointLimit?: number, heaterTypes?: {
-        immersionElement1?: boolean;
-        immersionElement2?: boolean;
-        heatPump?: boolean;
-        boiler?: boolean;
-        other?: boolean;
-    }, tankPercentage?: number, voltage?: number | bigint | null, current?: number | bigint | null, power?: number | bigint | null, energy?: number | bigint | null, absMinPower?: number, absMaxPower?: number);
-    /**
-     * Creates a default WaterHeaterManagement Cluster Server.
-     *
-     * @param {{ immersionElement1?: boolean; immersionElement2?: boolean; heatPump?: boolean; boiler?: boolean; other?: boolean }} [heaterTypes] - Indicates the heat sources that the water heater can call on for heating. Defaults to { immersionElement1: true }.
-     * @param {boolean} heaterTypes.immersionElement1 - Indicates if the water heater has an immersion element 1. Defaults to true.
-     * @param {boolean} heaterTypes.immersionElement2 - Indicates if the water heater has an immersion element 2.
-     * @param {boolean} heaterTypes.heatPump - Indicates if the water heater has a heat pump.
-     * @param {boolean} heaterTypes.boiler - Indicates if the water heater has a boiler.
-     * @param {boolean} heaterTypes.other - Indicates if the water heater has other types of heating sources.
-     * @param {{ immersionElement1?: boolean; immersionElement2?: boolean; heatPump?: boolean; boiler?: boolean; other?: boolean }} [heatDemand] - Indicates if the water heater is heating water. Defaults to all heat sources unset.
-     * @param {boolean} heatDemand.immersionElement1 - Indicates if the water heater is heating water with immersion element 1. Defaults to false.
-     * @param {boolean} heatDemand.immersionElement2 - Indicates if the water heater is heating water with immersion element 2.
-     * @param {boolean} heatDemand.heatPump - Indicates if the water heater is heating water with a heat pump.
-     * @param {boolean} heatDemand.boiler - Indicates if the water heater is heating water with a boiler.
-     * @param {boolean} heatDemand.other - Indicates if the water heater is heating water with other types of heating sources.
-     * @param {number} [tankPercentage] - The current tank percentage of the WaterHeaterManagement cluster. Defaults to 100.
-     * @param {WaterHeaterManagement.BoostState} [boostState] - The current boost state of the WaterHeaterManagement cluster. Defaults to Inactive.
-     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
-     */
-    createDefaultWaterHeaterManagementClusterServer(heaterTypes?: {
-        immersionElement1?: boolean;
-        immersionElement2?: boolean;
-        heatPump?: boolean;
-        boiler?: boolean;
-        other?: boolean;
-    }, heatDemand?: {
-        immersionElement1?: boolean;
-        immersionElement2?: boolean;
-        heatPump?: boolean;
-        boiler?: boolean;
-        other?: boolean;
-    }, tankPercentage?: number, boostState?: WaterHeaterManagement.BoostState): this;
-    /**
-     * Creates a default WaterHeaterMode Cluster Server.
-     *
-     * @param {number} [currentMode] - The current mode of the WaterHeaterMode cluster. Defaults to mode 1 (WaterHeaterMode.ModeTag.Auto).
-     * @param {WaterHeaterMode.ModeOption[]} [supportedModes] - The supported modes for the WaterHeaterMode cluster. Defaults all cluster modes.
-     *
-     * @returns {this} The current MatterbridgeEndpoint instance for chaining.
-     */
-    createDefaultWaterHeaterModeClusterServer(currentMode?: number, supportedModes?: WaterHeaterMode.ModeOption[]): this;
-}
-export declare class MatterbridgeWaterHeaterManagementServer extends WaterHeaterManagementServer {
-    boost(request: WaterHeaterManagement.BoostRequest): MaybePromise;
-    cancelBoost(): MaybePromise;
-}
-export declare class MatterbridgeWaterHeaterModeServer extends WaterHeaterModeServer {
-    changeToMode(request: ModeBase.ChangeToModeRequest): MaybePromise<ModeBase.ChangeToModeResponse>;
-}
-//# sourceMappingURL=waterHeater.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"waterHeater.d.ts","sourceRoot":"","sources":["../../src/devices/waterHeater.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAIjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,qBAAa,WAAY,SAAQ,oBAAoB;IACnD;;;;;;;;;;;;;;;;;;;;;;OAsBG;gBAED,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,gBAAgB,SAAK,EACrB,sBAAsB,SAAK,EAC3B,oBAAoB,SAAK,EACzB,oBAAoB,SAAK,EACzB,WAAW,GAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAgC,EAC9J,cAAc,SAAK,EACnB,OAAO,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EACtC,OAAO,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EACtC,KAAK,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EACpC,MAAM,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EACrC,WAAW,GAAE,MAAU,EACvB,WAAW,GAAE,MAAU;IAgBzB;;;;;;;;;;;;;;;;;;OAkBG;IACH,+CAA+C,CAC7C,WAAW,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EACjI,UAAU,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAChI,cAAc,CAAC,EAAE,MAAM,EACvB,UAAU,CAAC,EAAE,qBAAqB,CAAC,UAAU,GAC5C,IAAI;IAUP;;;;;;;OAOG;IACH,yCAAyC,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,eAAe,CAAC,UAAU,EAAE,GAAG,IAAI;CAqBrH;AAED,qBAAa,uCAAwC,SAAQ,2BAA2B;IAC7E,KAAK,CAAC,OAAO,EAAE,qBAAqB,CAAC,YAAY,GAAG,YAAY;IAWhE,WAAW,IAAI,YAAY;CAUrC;AAED,qBAAa,iCAAkC,SAAQ,qBAAqB;IACjE,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,mBAAmB,GAAG,YAAY,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CAa1G"}

package/dist/devices/waterHeater.js.map

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

package/dist/frontend.d.ts

@@ -1,304 +0,0 @@
-/**
- * This file contains the class Frontend.
- *
- * @file frontend.ts
- * @author Luca Liguori
- * @created 2025-01-13
- * @version 1.2.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 EventEmitter from 'node:events';
-import { LogLevel } from 'node-ansi-logger';
-import { Matterbridge } from './matterbridge.js';
-/**
- * Websocket message ID for logging.
- *
- * @constant {number}
- */
-export declare const WS_ID_LOG = 0;
-/**
- * Websocket message ID indicating a refresh is needed.
- *
- * @constant {number}
- */
-export declare const WS_ID_REFRESH_NEEDED = 1;
-/**
- * Websocket message ID indicating a restart is needed.
- *
- * @constant {number}
- */
-export declare const WS_ID_RESTART_NEEDED = 2;
-/**
- * Websocket message ID indicating a cpu update.
- *
- * @constant {number}
- */
-export declare const WS_ID_CPU_UPDATE = 3;
-/**
- * Websocket message ID indicating a memory update.
- *
- * @constant {number}
- */
-export declare const WS_ID_MEMORY_UPDATE = 4;
-/**
- * Websocket message ID indicating an uptime update.
- *
- * @constant {number}
- */
-export declare const WS_ID_UPTIME_UPDATE = 5;
-/**
- * Websocket message ID indicating a snackbar message.
- *
- * @constant {number}
- */
-export declare const WS_ID_SNACKBAR = 6;
-/**
- * Websocket message ID indicating matterbridge has un update available.
- *
- * @constant {number}
- */
-export declare const WS_ID_UPDATE_NEEDED = 7;
-/**
- * Websocket message ID indicating a state update.
- *
- * @constant {number}
- */
-export declare const WS_ID_STATEUPDATE = 8;
-/**
- * Websocket message ID indicating to close a permanent snackbar message.
- *
- * @constant {number}
- */
-export declare const WS_ID_CLOSE_SNACKBAR = 9;
-/**
- * Websocket message ID indicating a shelly system update.
- * check:
- * curl -k http://127.0.0.1:8101/api/updates/sys/check
- * perform:
- * curl -k http://127.0.0.1:8101/api/updates/sys/perform
- *
- * @constant {number}
- */
-export declare const WS_ID_SHELLY_SYS_UPDATE = 100;
-/**
- * Websocket message ID indicating a shelly main update.
- * check:
- * curl -k http://127.0.0.1:8101/api/updates/main/check
- * perform:
- * curl -k http://127.0.0.1:8101/api/updates/main/perform
- *
- * @constant {number}
- */
-export declare const WS_ID_SHELLY_MAIN_UPDATE = 101;
-/**
- * Represents the Matterbridge events.
- */
-interface FrontendEvents {
-    server_listening: [protocol: string, port: number, address?: string];
-    server_error: [error: Error];
-    server_stopped: [];
-    websocket_server_listening: [host: string];
-    websocket_server_stopped: [];
-}
-export declare class Frontend extends EventEmitter<FrontendEvents> {
-    private matterbridge;
-    private log;
-    private port;
-    private expressApp;
-    private httpServer;
-    private httpsServer;
-    private webSocketServer;
-    constructor(matterbridge: Matterbridge);
-    set logLevel(logLevel: LogLevel);
-    start(port?: number): Promise<void>;
-    stop(): Promise<void>;
-    private formatMemoryUsage;
-    private formatOsUpTime;
-    /**
-     * Retrieves the api settings data.
-     *
-     * @returns {Promise<{ matterbridgeInformation: MatterbridgeInformation, systemInformation: SystemInformation }>} A promise that resolve in the api settings object.
-     */
-    private getApiSettings;
-    /**
-     * Retrieves the reachable attribute.
-     *
-     * @param {MatterbridgeEndpoint} device - The MatterbridgeEndpoint object.
-     * @returns {boolean} The reachable attribute.
-     */
-    private getReachability;
-    /**
-     * Retrieves the power source attribute.
-     *
-     * @param {MatterbridgeEndpoint} endpoint - The MatterbridgeDevice to retrieve the power source from.
-     * @returns {'ac' | 'dc' | 'ok' | 'warning' | 'critical' | undefined} The power source attribute.
-     */
-    private getPowerSource;
-    /**
-     * Retrieves the commissioned status, matter pairing codes, fabrics and sessions from a given device in server mode.
-     *
-     * @param {MatterbridgeEndpoint} device - The MatterbridgeEndpoint to retrieve the data from.
-     * @returns {ApiDevicesMatter | undefined} An ApiDevicesMatter object or undefined if not found.
-     */
-    private getMatterDataFromDevice;
-    /**
-     * Retrieves the cluster text description from a given device.
-     * The output is a string with the attributes description of the cluster servers in the device to show in the frontend.
-     *
-     * @param {MatterbridgeEndpoint} device - The MatterbridgeEndpoint to retrieve the cluster text from.
-     * @returns {string} The attributes description of the cluster servers in the device.
-     */
-    private getClusterTextFromDevice;
-    /**
-     * Retrieves the base registered plugins sanitized for res.json().
-     *
-     * @returns {BaseRegisteredPlugin[]} An array of BaseRegisteredPlugin.
-     */
-    private getBaseRegisteredPlugins;
-    /**
-     * Retrieves the devices from Matterbridge.
-     *
-     * @param {string} [pluginName] - The name of the plugin to filter devices by.
-     * @returns {Promise<ApiDevices[]>} A promise that resolves to an array of ApiDevices for the frontend.
-     */
-    private getDevices;
-    /**
-     * Retrieves the clusters from a given plugin and endpoint number.
-     *
-     * Response for /api/clusters
-     *
-     * @param {string} pluginName - The name of the plugin.
-     * @param {number} endpointNumber - The endpoint number.
-     * @returns {ApiClustersResponse | undefined} A promise that resolves to the clusters or undefined if not found.
-     */
-    private getClusters;
-    /**
-     * Handles incoming websocket messages for the Matterbridge frontend.
-     *
-     * @param {WebSocket} client - The websocket client that sent the message.
-     * @param {WebSocket.RawData} message - The raw data of the message received from the client.
-     * @returns {Promise<void>} A promise that resolves when the message has been handled.
-     */
-    private wsMessageHandler;
-    /**
-     * Sends a WebSocket log message to all connected clients. The function is called by AnsiLogger.setGlobalCallback.
-     *
-     * @param {string} level - The logger level of the message: debug info notice warn error fatal...
-     * @param {string} time - The time string of the message
-     * @param {string} name - The logger name of the message
-     * @param {string} message - The content of the message.
-     *
-     * @remarks
-     * The function removes ANSI escape codes, leading asterisks, non-printable characters, and replaces all occurrences of \t and \n.
-     * It also replaces all occurrences of \" with " and angle-brackets with &lt; and &gt;.
-     * The function sends the message to all connected clients.
-     */
-    wssSendMessage(level: string, time: string, name: string, message: string): void;
-    /**
-     * Sends a need to refresh WebSocket message to all connected clients.
-     *
-     * @param {string} changed - The changed value. If null, the whole page will be refreshed.
-     * possible values:
-     * - 'matterbridgeLatestVersion'
-     * - 'matterbridgeAdvertise'
-     * - 'online'
-     * - 'offline'
-     * - 'reachability'
-     * - 'settings'
-     * - 'plugins'
-     * - 'pluginsRestart'
-     * - 'devices'
-     * - 'fabrics'
-     * - 'sessions'
-     */
-    wssSendRefreshRequired(changed?: string | null): void;
-    /**
-     * Sends a need to restart WebSocket message to all connected clients.
-     *
-     * @param {boolean} snackbar - If true, a snackbar message will be sent to all connected clients.
-     */
-    wssSendRestartRequired(snackbar?: boolean): void;
-    /**
-     * Sends a need to update WebSocket message to all connected clients.
-     *
-     */
-    wssSendUpdateRequired(): void;
-    /**
-     * Sends a cpu update message to all connected clients.
-     *
-     * @param {number} cpuUsage - The CPU usage percentage to send.
-     */
-    wssSendCpuUpdate(cpuUsage: number): void;
-    /**
-     * Sends a memory update message to all connected clients.
-     *
-     * @param {string} totalMemory - The total memory in bytes.
-     * @param {string} freeMemory - The free memory in bytes.
-     * @param {string} rss - The resident set size in bytes.
-     * @param {string} heapTotal - The total heap memory in bytes.
-     * @param {string} heapUsed - The used heap memory in bytes.
-     * @param {string} external - The external memory in bytes.
-     * @param {string} arrayBuffers - The array buffers memory in bytes.
-     */
-    wssSendMemoryUpdate(totalMemory: string, freeMemory: string, rss: string, heapTotal: string, heapUsed: string, external: string, arrayBuffers: string): void;
-    /**
-     * Sends an uptime update message to all connected clients.
-     *
-     * @param {string} systemUptime - The system uptime in a human-readable format.
-     * @param {string} processUptime - The process uptime in a human-readable format.
-     */
-    wssSendUptimeUpdate(systemUptime: string, processUptime: string): void;
-    /**
-     * Sends an open snackbar message to all connected clients.
-     *
-     * @param {string} message - The message to send.
-     * @param {number} timeout - The timeout in seconds for the snackbar message.
-     * @param {'info' | 'warning' | 'error' | 'success'} severity - The severity of the snackbar message (default info).
-     */
-    wssSendSnackbarMessage(message: string, timeout?: number, severity?: 'info' | 'warning' | 'error' | 'success'): void;
-    /**
-     * Sends a close snackbar message to all connected clients.
-     *
-     * @param {string} message - The message to send.
-     */
-    wssSendCloseSnackbarMessage(message: string): void;
-    /**
-     * Sends an attribute update message to all connected WebSocket clients.
-     *
-     * @param {string | undefined} plugin - The name of the plugin.
-     * @param {string | undefined} serialNumber - The serial number of the device.
-     * @param {string | undefined} uniqueId - The unique identifier of the device.
-     * @param {string} cluster - The cluster name where the attribute belongs.
-     * @param {string} attribute - The name of the attribute that changed.
-     * @param {number | string | boolean} value - The new value of the attribute.
-     *
-     * @remarks
-     * This method logs a debug message and sends a JSON-formatted message to all connected WebSocket clients
-     * with the updated attribute information.
-     */
-    wssSendAttributeChangedMessage(plugin: string | undefined, serialNumber: string | undefined, uniqueId: string | undefined, cluster: string, attribute: string, value: number | string | boolean): void;
-    /**
-     * Sends a message to all connected clients.
-     *
-     * @param {number} id - The message id.
-     * @param {string} method - The message method.
-     * @param {Record<string, string | number | boolean>} params - The message parameters.
-     */
-    wssBroadcastMessage(id: number, method?: string, params?: Record<string, string | number | boolean>): void;
-}
-export {};
-//# sourceMappingURL=frontend.d.ts.map

package/dist/frontend.d.ts.map

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