matterbridge 2.2.0 → 2.2.2-dev.1

package/dist/matterbridgeEndpointHelpers.js

@@ -1,15 +1,9 @@
-/* eslint-disable @typescript-eslint/no-unused-vars */
-// Node.js modules
 import { createHash } from 'node:crypto';
-// AnsiLogger module
 import { BLUE, CYAN, db, debugStringify, er, hk, or, YELLOW, zb } from './logger/export.js';
-// Matterbridge
 import { deepCopy, deepEqual, isValidArray } from './utils/export.js';
 import { MatterbridgeIdentifyServer, MatterbridgeOnOffServer, MatterbridgeLevelControlServer, MatterbridgeColorControlServer, MatterbridgeWindowCoveringServer, MatterbridgeThermostatServer, MatterbridgeFanControlServer, MatterbridgeDoorLockServer, MatterbridgeModeSelectServer, MatterbridgeValveConfigurationAndControlServer, MatterbridgeSmokeCoAlarmServer, MatterbridgeBooleanStateConfigurationServer, } from './matterbridgeBehaviors.js';
-// @matter
 import { Lifecycle } from '@matter/main';
 import { getClusterNameById } from '@matter/main/types';
-// @matter clusters
 import { PowerSource } from '@matter/main/clusters/power-source';
 import { UserLabel } from '@matter/main/clusters/user-label';
 import { FixedLabel } from '@matter/main/clusters/fixed-label';
@@ -51,7 +45,6 @@ import { Pm25ConcentrationMeasurement } from '@matter/main/clusters/pm25-concent
 import { Pm10ConcentrationMeasurement } from '@matter/main/clusters/pm10-concentration-measurement';
 import { RadonConcentrationMeasurement } from '@matter/main/clusters/radon-concentration-measurement';
 import { TotalVolatileOrganicCompoundsConcentrationMeasurement } from '@matter/main/clusters/total-volatile-organic-compounds-concentration-measurement';
-// @matter behaviors
 import { PowerSourceServer } from '@matter/main/behaviors/power-source';
 import { UserLabelServer } from '@matter/main/behaviors/user-label';
 import { FixedLabelServer } from '@matter/main/behaviors/fixed-label';
@@ -93,19 +86,19 @@ export function lowercaseFirstLetter(name) {
 }
 export function checkNotLatinCharacters(deviceName) {
     const nonLatinRegexList = [
-        /[\u0400-\u04FF\u0500-\u052F]/, // Cyrillic
-        /[\u2E80-\u9FFF]/, // CJK (Chinese, Japanese, Korean)
-        /[\uAC00-\uD7AF]/, // Korean Hangul
-        /[\u0600-\u06FF\u0750-\u077F]/, // Arabic, Persian
-        /[\u0590-\u05FF]/, // Hebrew
-        /[\u0900-\u097F]/, // Devanagari (Hindi, Sanskrit)
-        /[\u0E00-\u0E7F]/, // Thai
-        /[\u1200-\u137F]/, // Ethiopic (Amharic, Tigrinya)
+        /[\u0400-\u04FF\u0500-\u052F]/,
+        /[\u2E80-\u9FFF]/,
+        /[\uAC00-\uD7AF]/,
+        /[\u0600-\u06FF\u0750-\u077F]/,
+        /[\u0590-\u05FF]/,
+        /[\u0900-\u097F]/,
+        /[\u0E00-\u0E7F]/,
+        /[\u1200-\u137F]/,
     ];
     return nonLatinRegexList.some((regex) => regex.test(deviceName));
 }
 export function generateUniqueId(deviceName) {
-    return createHash('md5').update(deviceName).digest('hex'); // MD5 hash of the device name
+    return createHash('md5').update(deviceName).digest('hex');
 }
 export function createUniqueId(param1, param2, param3, param4) {
     const hash = createHash('md5');
@@ -113,7 +106,6 @@ export function createUniqueId(param1, param2, param3, param4) {
     return hash.digest('hex');
 }
 export function getBehaviourTypesFromClusterServerIds(clusterServerList) {
-    // Map Server ClusterId to Behavior.Type
     const behaviorTypes = [];
     clusterServerList.forEach((clusterId) => {
         behaviorTypes.push(getBehaviourTypeFromClusterServerId(clusterId));
@@ -121,15 +113,12 @@ export function getBehaviourTypesFromClusterServerIds(clusterServerList) {
     return behaviorTypes;
 }
 export function getBehaviourTypesFromClusterClientIds(clusterClientList) {
-    // Map Client ClusterId to Behavior.Type
     const behaviorTypes = [];
     clusterClientList.forEach((clusterId) => {
-        // behaviorTypes.push(getBehaviourTypeFromClusterClientId(clusterId));
     });
     return behaviorTypes;
 }
 export function getBehaviourTypeFromClusterServerId(clusterId) {
-    // Map ClusterId to Server Behavior.Type
     if (clusterId === PowerSource.Cluster.id)
         return PowerSourceServer.with(PowerSource.Feature.Wired);
     if (clusterId === UserLabel.Cluster.id)
@@ -215,8 +204,6 @@ export function getBehaviourTypeFromClusterServerId(clusterId) {
     return MatterbridgeIdentifyServer;
 }
 export function getBehaviourTypeFromClusterClientId(clusterId) {
-    // Map ClusterId to Client Behavior.Type
-    // return IdentifyClient;
 }
 export function getBehavior(endpoint, cluster) {
     let behavior;
@@ -262,13 +249,6 @@ export function addOptionalClusterServers(endpoint) {
     });
     addClusterServers(endpoint, optionalServerList);
 }
-/**
- * Adds cluster servers to the specified endpoint based on the provided server list.
- *
- * @param {MatterbridgeEndpoint} endpoint - The endpoint to add the cluster servers to.
- * @param {ClusterId[]} serverList - The list of cluster IDs to add.
- * @returns void
- */
 export function addClusterServers(endpoint, serverList) {
     if (serverList.includes(PowerSource.Cluster.id))
         endpoint.createDefaultPowerSourceWiredClusterServer();
@@ -342,16 +322,7 @@ export function addClusterServers(endpoint, serverList) {
         endpoint.createDefaultRadonConcentrationMeasurementClusterServer();
     if (serverList.includes(TotalVolatileOrganicCompoundsConcentrationMeasurement.Cluster.id))
         endpoint.createDefaultTvocMeasurementClusterServer();
-    // if (serverList.includes(DeviceEnergyManagement.Cluster.id)) endpoint.createDefaultDeviceEnergyManagementClusterServer();
-    // if (serverList.includes(DeviceEnergyManagementMode.Cluster.id)) endpoint.createDefaultDeviceEnergyManagementModeClusterServer();
 }
-/**
- * Adds a fixed label to the FixedLabel cluster. The FixedLabel cluster is created if it does not exist.
- *
- * @param {MatterbridgeEndpoint} endpoint - The endpoint to add the cluster servers to.
- * @param {string} label - The label to add.
- * @param {string} value - The value of the label.
- */
 export async function addFixedLabel(endpoint, label, value) {
     if (!endpoint.hasClusterServer(FixedLabel.Cluster.id)) {
         endpoint.log.debug(`addFixedLabel: add cluster ${hk}FixedLabel${db}:${hk}fixedLabel${db} with label ${CYAN}${label}${db} value ${CYAN}${value}${db}`);
@@ -368,13 +339,6 @@ export async function addFixedLabel(endpoint, label, value) {
         await endpoint.setAttribute(FixedLabel.Cluster.id, 'labelList', labelList, endpoint.log);
     }
 }
-/**
- * Adds a user label to the UserLabel cluster. The UserLabel cluster is created if it does not exist.
- *
- * @param {MatterbridgeEndpoint} endpoint - The endpoint to add the cluster servers to.
- * @param {string} label - The label to add.
- * @param {string} value - The value of the label.
- */
 export async function addUserLabel(endpoint, label, value) {
     if (!endpoint.hasClusterServer(UserLabel.Cluster.id)) {
         endpoint.log.debug(`addUserLabel: add cluster ${hk}UserLabel${db}:${hk}userLabel${db} with label ${CYAN}${label}${db} value ${CYAN}${value}${db}`);
@@ -438,16 +402,6 @@ export function getAttributeId(endpoint, cluster, attribute) {
         return endpoint.behaviors.supported[lowercaseFirstLetter(cluster)]?.schema?.children?.find((child) => child.name === capitalizeFirstLetter(attribute))?.id;
     }
 }
-/**
- * Retrieves the value of the provided attribute from the given cluster.
- *
- * @param {MatterbridgeEndpoint} endpoint - The endpoint to retrieve the attribute from.
- * @param {Behavior.Type | ClusterType | ClusterId | string} cluster - The cluster to retrieve the attribute from.
- * @param {string} attribute - The name of the attribute to retrieve.
- * @param {AnsiLogger} [log] - (Optional) The logger to use for logging the retrieve. Errors are logged to the endpoint logger.
- * @returns {any} The value of the attribute, or undefined if the attribute is not found.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function getAttribute(endpoint, cluster, attribute, log) {
     const clusterName = getBehavior(endpoint, cluster)?.id;
     if (!clusterName) {
@@ -470,16 +424,6 @@ export function getAttribute(endpoint, cluster, attribute, log) {
     log?.info(`${db}Get endpoint ${or}${endpoint.id}${db}:${or}${endpoint.number}${db} attribute ${hk}${capitalizeFirstLetter(clusterName)}${db}.${hk}${attribute}${db} value ${YELLOW}${value !== null && typeof value === 'object' ? debugStringify(value) : value}${db}`);
     return value;
 }
-/**
- * Sets the value of an attribute on a cluster server.
- *
- * @param {MatterbridgeEndpoint} endpoint - The endpoint to set the attribute on.
- * @param {Behavior.Type | ClusterType | ClusterId | string} cluster - The cluster to set the attribute on.
- * @param {string} attribute - The name of the attribute.
- * @param {boolean | number | bigint | string | object | null} value - The value to set for the attribute.
- * @param {AnsiLogger} [log] - (Optional) The logger to use for logging the set. Errors are logged to the endpoint logger.
- * @returns {Promise<boolean>} - A promise that resolves to a boolean indicating whether the attribute was successfully set.
- */
 export async function setAttribute(endpoint, cluster, attribute, value, log) {
     const clusterName = getBehavior(endpoint, cluster)?.id;
     if (!clusterName) {
@@ -505,16 +449,6 @@ export async function setAttribute(endpoint, cluster, attribute, value, log) {
         `to ${YELLOW}${value !== null && typeof value === 'object' ? debugStringify(value) : value}${db}`);
     return true;
 }
-/**
- * Sets the value of an attribute on a cluster server.
- *
- * @param {MatterbridgeEndpoint} endpoint - The endpoint to update the attribute on.
- * @param {Behavior.Type | ClusterType | ClusterId | string} cluster - The cluster to update the attribute on.
- * @param {string} attribute - The name of the attribute.
- * @param {boolean | number | bigint | string | object | null} value - The value to set for the attribute.
- * @param {AnsiLogger} [log] - (Optional) The logger to use for logging the update. Errors are logged to the endpoint logger.
- * @returns {Promise<boolean>} - A promise that resolves to a boolean indicating whether the attribute was successfully set.
- */
 export async function updateAttribute(endpoint, cluster, attribute, value, log) {
     const clusterName = getBehavior(endpoint, cluster)?.id;
     if (!clusterName) {
@@ -545,17 +479,6 @@ export async function updateAttribute(endpoint, cluster, attribute, value, log)
         `to ${YELLOW}${value !== null && typeof value === 'object' ? debugStringify(value) : value}${db}`);
     return true;
 }
-/**
- * Subscribes to the provided attribute on a cluster.
- *
- * @param {MatterbridgeEndpoint} endpoint - The endpoint to subscribe the attribute to.
- * @param {Behavior.Type | ClusterType | ClusterId | string} cluster - The cluster to subscribe the attribute to.
- * @param {string} attribute - The name of the attribute to subscribe to.
- * @param {(newValue: any, oldValue: any) => void} listener - A callback function that will be called when the attribute value changes.
- * @param {AnsiLogger} [log] - Optional logger for logging errors and information.
- * @returns {boolean} - A boolean indicating whether the subscription was successful.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export async function subscribeAttribute(endpoint, cluster, attribute, listener, log) {
     const clusterName = getBehavior(endpoint, cluster)?.id;
     if (!clusterName) {
@@ -566,7 +489,6 @@ export async function subscribeAttribute(endpoint, cluster, attribute, listener,
         endpoint.log.debug(`subscribeAttribute ${hk}${clusterName}.${attribute}${db}: Endpoint ${or}${endpoint.maybeId}${db}:${or}${endpoint.maybeNumber}${db} is in the ${BLUE}${endpoint.construction.status}${db} state`);
         await endpoint.construction.ready;
     }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const events = endpoint.events;
     attribute = lowercaseFirstLetter(attribute) + '$Changed';
     if (!(clusterName in events) || !(attribute in events[clusterName])) {
@@ -577,11 +499,6 @@ export async function subscribeAttribute(endpoint, cluster, attribute, listener,
     log?.info(`${db}Subscribed endpoint ${or}${endpoint.id}${db}:${or}${endpoint.number}${db} attribute ${hk}${capitalizeFirstLetter(clusterName)}${db}.${hk}${attribute}${db}`);
     return true;
 }
-/**
- * Get the default TemperatureMeasurement cluster server options.
- *
- * @param {number} measuredValue - The measured value of the temperature x 100.
- */
 export function getDefaultTemperatureMeasurementClusterServer(measuredValue = 0) {
     return optionsFor(TemperatureMeasurementServer, {
         measuredValue,
@@ -590,11 +507,6 @@ export function getDefaultTemperatureMeasurementClusterServer(measuredValue = 0)
         tolerance: 0,
     });
 }
-/**
- * Get the default RelativeHumidityMeasurement cluster server options.
- *
- * @param {number} measuredValue - The measured value of the relative humidity x 100.
- */
 export function getDefaultRelativeHumidityMeasurementClusterServer(measuredValue = 0) {
     return optionsFor(RelativeHumidityMeasurementServer, {
         measuredValue,
@@ -603,11 +515,6 @@ export function getDefaultRelativeHumidityMeasurementClusterServer(measuredValue
         tolerance: 0,
     });
 }
-/**
- * Get the default PressureMeasurement cluster server options.
- *
- * @param {number} measuredValue - The measured value for the pressure.
- */
 export function getDefaultPressureMeasurementClusterServer(measuredValue = 1000) {
     return optionsFor(PressureMeasurementServer, {
         measuredValue,
@@ -616,11 +523,6 @@ export function getDefaultPressureMeasurementClusterServer(measuredValue = 1000)
         tolerance: 0,
     });
 }
-/**
- * Get the default IlluminanceMeasurement cluster server options.
- *
- * @param {number} measuredValue - The measured value of illuminance.
- */
 export function getDefaultIlluminanceMeasurementClusterServer(measuredValue = 0) {
     return optionsFor(IlluminanceMeasurementServer, {
         measuredValue,
@@ -629,11 +531,6 @@ export function getDefaultIlluminanceMeasurementClusterServer(measuredValue = 0)
         tolerance: 0,
     });
 }
-/**
- * Get the default FlowMeasurement cluster server options.
- *
- * @param {number} measuredValue - The measured value of the flow in 10 x m3/h.
- */
 export function getDefaultFlowMeasurementClusterServer(measuredValue = 0) {
     return optionsFor(FlowMeasurementServer, {
         measuredValue,
@@ -642,11 +539,6 @@ export function getDefaultFlowMeasurementClusterServer(measuredValue = 0) {
         tolerance: 0,
     });
 }
-/**
- * Get the default OccupancySensing cluster server options.
- *
- * @param {boolean} occupied - A boolean indicating whether the occupancy is occupied or not. Default is false.
- */
 export function getDefaultOccupancySensingClusterServer(occupied = false) {
     return optionsFor(OccupancySensingServer, {
         occupancy: { occupied },
@@ -655,4 +547,3 @@ export function getDefaultOccupancySensingClusterServer(occupied = false) {
         pirOccupiedToUnoccupiedDelay: 30,
     });
 }
-//# sourceMappingURL=matterbridgeEndpointHelpers.js.map

package/dist/matterbridgePlatform.js

@@ -1,71 +1,30 @@
-/**
- * This file contains the class MatterbridgeAccessoryPlatform.
- *
- * @file matterbridgePlatform.ts
- * @author Luca Liguori
- * @date 2024-03-21
- * @version 1.1.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 { checkNotLatinCharacters } from './matterbridgeEndpointHelpers.js';
 import { isValidArray, isValidObject, isValidString } from './utils/export.js';
-// AnsiLogger module
 import { CYAN, db, er, nf, wr } from './logger/export.js';
-// Storage module
 import { NodeStorageManager } from './storage/export.js';
-// Node.js module
 import path from 'node:path';
-/**
- * Represents the base Matterbridge platform. It is extended by the MatterbridgeAccessoryPlatform and MatterbridgeServicePlatform classes.
- *
- */
 export class MatterbridgePlatform {
     matterbridge;
     log;
     config = {};
-    name = ''; // Will be set by the loadPlugin() method using the package.json value.
-    type = ''; // Will be set by the extending classes.
-    version = '1.0.0'; // Will be set by the loadPlugin() method using the package.json value.
-    // Platform storage
+    name = '';
+    type = '';
+    version = '1.0.0';
     storage;
     context;
-    // Device and entity selection
     selectDevice = new Map();
     selectEntity = new Map();
-    // Promises for storage
     _contextReady;
     _selectDeviceContextReady;
     _selectEntityContextReady;
     ready;
-    // Registered devices
-    _registeredEndpoints = new Map(); // uniqueId, MatterbridgeEndpoint
-    _registeredEndpointsByName = new Map(); // deviceName, MatterbridgeEndpoint
-    // Stored devices
-    _storedDevices = new Map(); // serial, { serial, name }
-    /**
-     * Creates an instance of the base MatterbridgePlatform. It is extended by the MatterbridgeAccessoryPlatform and MatterbridgeServicePlatform classes.
-     * @param {Matterbridge} matterbridge - The Matterbridge instance.
-     * @param {AnsiLogger} log - The logger instance.
-     * @param {PlatformConfig} config - The platform configuration.
-     */
+    _registeredEndpoints = new Map();
+    _registeredEndpointsByName = new Map();
+    _storedDevices = new Map();
     constructor(matterbridge, log, config) {
         this.matterbridge = matterbridge;
         this.log = log;
         this.config = config;
-        // create the NodeStorageManager for the plugin platform
         if (!isValidString(this.config.name) || this.config.name === '')
             throw new Error('Platform: the plugin name is missing or invalid.');
         this.log.debug(`Creating storage for plugin ${this.config.name} in ${path.join(this.matterbridge.matterbridgeDirectory, this.config.name)}`);
@@ -76,14 +35,12 @@ export class MatterbridgePlatform {
             logging: false,
             forgiveParseErrors: true,
         });
-        // create the context storage for the plugin platform
         this.log.debug(`Creating context for plugin ${this.config.name}`);
         this._contextReady = this.storage.createStorage('context').then((context) => {
             this.context = context;
-            this.context.remove('endpointMap'); // Remove the old endpointMap TODO: remove in future versions
+            this.context.remove('endpointMap');
             this.log.debug(`Created context for plugin ${this.config.name}`);
         });
-        // create the selectDevice storage for the plugin platform
         this.log.debug(`Loading selectDevice for plugin ${this.config.name}`);
         this._selectDeviceContextReady = this.storage.createStorage('selectDevice').then(async (context) => {
             const selectDevice = await context.get('selectDevice', []);
@@ -91,7 +48,6 @@ export class MatterbridgePlatform {
                 this.selectDevice.set(device.serial, device);
             this.log.debug(`Loaded ${this.selectDevice.size} selectDevice for plugin ${this.config.name}`);
         });
-        // create the selectEntity storage for the plugin platform
         this.log.debug(`Loading selectEntity for plugin ${this.config.name}`);
         this._selectEntityContextReady = this.storage.createStorage('selectEntity').then(async (context) => {
             const selectEntity = await context.get('selectEntity', []);
@@ -99,82 +55,38 @@ export class MatterbridgePlatform {
                 this.selectEntity.set(entity.name, entity);
             this.log.debug(`Loaded ${this.selectEntity.size} selectEntity for plugin ${this.config.name}`);
         });
-        // Create the `ready` promise for the platform
         this.ready = Promise.all([this._contextReady, this._selectDeviceContextReady, this._selectEntityContextReady]).then(() => {
             this.log.debug(`MatterbridgePlatform for plugin ${this.config.name} is fully initialized`);
         });
     }
-    /**
-     * This method must be overridden in the extended class.
-     * It is called when the platform is started.
-     * Use this method to create the MatterbridgeDevice and call this.registerDevice().
-     * @param {string} [reason] - The reason for starting.
-     * @throws {Error} - Throws an error if the method is not overridden.
-     */
     async onStart(reason) {
         this.log.error('Plugins must override onStart.', reason);
         throw new Error('Plugins must override onStart.');
     }
-    /**
-     * This method can be overridden in the extended class. Call super.onConfigure() to run checkEndpointNumbers().
-     * It is called after the platform has started.
-     * Use this method to perform any configuration of your devices.
-     */
     async onConfigure() {
         this.log.debug(`Configuring platform ${this.name}`);
+        await this.saveSelects();
         await this.checkEndpointNumbers();
     }
-    /**
-     * This method can be overridden in the extended class. In this case always call super.onShutdown() to save the selects, run checkEndpointNumbers() and cleanup memory.
-     * It is called when the platform is shutting down.
-     * Use this method to clean up any resources.
-     * @param {string} [reason] - The reason for shutting down.
-     */
     async onShutdown(reason) {
         this.log.debug(`Shutting down platform ${this.name}`, reason);
-        // Save the selectDevice and selectEntity
-        if (this.storage) {
-            this.log.debug(`Saving ${this.selectDevice.size} selectDevice...`);
-            const selectDevice = await this.storage.createStorage('selectDevice');
-            await selectDevice.set('selectDevice', Array.from(this.selectDevice.values()));
-            await selectDevice.close();
-            this.log.debug(`Saving ${this.selectEntity.size} selectEntity...`);
-            const selectEntity = await this.storage.createStorage('selectEntity');
-            await selectEntity.set('selectEntity', Array.from(this.selectEntity.values()));
-            await selectEntity.close();
-        }
-        // Check and update the endpoint numbers
+        await this.saveSelects();
         await this.checkEndpointNumbers();
-        // Cleanup memory
         this.selectDevice.clear();
         this.selectEntity.clear();
         this._registeredEndpoints.clear();
         this._registeredEndpointsByName.clear();
         this._storedDevices.clear();
-        // Close the storage
         await this.context?.close();
         this.context = undefined;
         await this.storage?.close();
     }
-    /**
-     * Sets the logger level and logs a debug message indicating that the plugin doesn't override this method.
-     * @param {LogLevel} logLevel The new logger level.
-     */
     async onChangeLoggerLevel(logLevel) {
         this.log.debug(`The plugin doesn't override onChangeLoggerLevel. Logger level set to: ${logLevel}`);
     }
-    /**
-     * Check if a device with this name is already registered in the platform.
-     * @param {string} deviceName - The device name to check.
-     * @returns {boolean} True if the device is already registered, false otherwise.
-     */
     hasDeviceName(deviceName) {
         return this._registeredEndpointsByName.has(deviceName);
     }
-    /**
-     * Registers a device with the Matterbridge platform.
-     * @param {MatterbridgeEndpoint} device - The device to register.
-     */
     async registerDevice(device) {
         device.plugin = this.name;
         if (device.deviceName && this._registeredEndpointsByName.has(device.deviceName)) {
@@ -190,10 +102,6 @@ export class MatterbridgePlatform {
         if (device.deviceName)
             this._registeredEndpointsByName.set(device.deviceName, device);
     }
-    /**
-     * Unregisters a device registered with the Matterbridge platform.
-     * @param {MatterbridgeEndpoint} device - The device to unregister.
-     */
     async unregisterDevice(device) {
         await this.matterbridge.removeBridgedEndpoint(this.name, device);
         if (device.uniqueId)
@@ -201,30 +109,70 @@ export class MatterbridgePlatform {
         if (device.deviceName)
             this._registeredEndpointsByName.delete(device.deviceName);
     }
-    /**
-     * Unregisters all devices registered with the Matterbridge platform.
-     */
     async unregisterAllDevices() {
         await this.matterbridge.removeAllBridgedEndpoints(this.name);
         this._registeredEndpoints.clear();
         this._registeredEndpointsByName.clear();
     }
-    /**
-     * Store a device that will not be registered. To be used by the Devices page in the frontend.
-     * @param {string} serial - The serial number of the device to store.
-     * @param {string} name - The name of the device to store.
-     * @param {string} [configUrl] - The URL of the device configuration.
-     * @returns {Promise<void>} A promise that resolves when the device is stored.
-     */
-    async storeDevice(serial, name, configUrl) {
-        this.log.debug(`Stored device with serial ${CYAN}${serial}${db} name ${CYAN}${name}${db}`);
-        this._storedDevices.set(serial, { serial, name, configUrl });
+    async saveSelects() {
+        if (this.storage) {
+            this.log.debug(`Saving ${this.selectDevice.size} selectDevice...`);
+            const selectDevice = await this.storage.createStorage('selectDevice');
+            await selectDevice.set('selectDevice', Array.from(this.selectDevice.values()));
+            await selectDevice.close();
+            this.log.debug(`Saving ${this.selectEntity.size} selectEntity...`);
+            const selectEntity = await this.storage.createStorage('selectEntity');
+            await selectEntity.set('selectEntity', Array.from(this.selectEntity.values()));
+            await selectEntity.close();
+        }
+    }
+    async clearSelect() {
+        this.selectDevice.clear();
+        this.selectEntity.clear();
+        await this.saveSelects();
+    }
+    setSelectDevice(serial, name, configUrl, icon, entities) {
+        const device = this.selectDevice.get(serial);
+        if (device) {
+            device.serial = serial;
+            device.name = name;
+            if (configUrl)
+                device.configUrl = configUrl;
+            if (icon)
+                device.icon = icon;
+            if (entities)
+                device.entities = entities;
+        }
+        else {
+            this.selectDevice.set(serial, { serial, name, configUrl, icon, entities });
+        }
+    }
+    setSelectDeviceEntity(serial, entityName, entityDescription, entityIcon) {
+        const device = this.selectDevice.get(serial);
+        if (device) {
+            if (!device.entities)
+                device.entities = [];
+            if (!device.entities.find((entity) => entity.name === entityName))
+                device.entities.push({ name: entityName, description: entityDescription, icon: entityIcon });
+        }
+    }
+    getSelectDevices() {
+        const selectDevices = [];
+        this.selectDevice.values().forEach((device) => {
+            selectDevices.push({ pluginName: this.name, ...device });
+        });
+        return selectDevices;
+    }
+    setSelectEntity(name, description, icon) {
+        this.selectEntity.set(name, { name, description, icon });
+    }
+    getSelectEntities() {
+        const selectEntities = [];
+        this.selectEntity.values().forEach((entity) => {
+            selectEntities.push({ pluginName: this.name, ...entity });
+        });
+        return selectEntities;
     }
-    /**
-     * Verifies if the Matterbridge version meets the required version.
-     * @param {string} requiredVersion - The required version to compare against.
-     * @returns {boolean} True if the Matterbridge version meets or exceeds the required version, false otherwise.
-     */
     verifyMatterbridgeVersion(requiredVersion) {
         const compareVersions = (matterbridgeVersion, requiredVersion) => {
             const stripTag = (v) => {
@@ -249,21 +197,9 @@ export class MatterbridgePlatform {
             return false;
         return true;
     }
-    /**
-     * @deprecated This method is deprecated and will be removed in future versions. Use validateDevice instead.
-     */
     validateDeviceWhiteBlackList(device, log = true) {
         return this.validateDevice(device, log);
     }
-    /**
-     * Validates if a device is allowed based on the whitelist and blacklist configurations.
-     * The blacklist has priority over the whitelist.
-     *
-     * @param {string | string[]} device - The device name(s) to validate.
-     * @param {boolean} [log=true] - Whether to log the validation result.
-     * @returns {boolean} - Returns true if the device is allowed, false otherwise.
-     *
-     */
     validateDevice(device, log = true) {
         if (!Array.isArray(device))
             device = [device];
@@ -293,21 +229,9 @@ export class MatterbridgePlatform {
             this.log.info(`Skipping device ${CYAN}${device.join(', ')}${nf} because not in whitelist`);
         return false;
     }
-    /**
-     * @deprecated This method is deprecated and will be removed in future versions. Use validateEntity instead.
-     */
     validateEntityBlackList(device, entity, log = true) {
         return this.validateEntity(device, entity, log);
     }
-    /**
-     * Validates if an entity is allowed based on the entity blacklist and device-entity blacklist configurations.
-     *
-     * @param {string} device - The device to which the entity belongs.
-     * @param {string} entity - The entity to validate.
-     * @param {boolean} [log=true] - Whether to log the validation result.
-     * @returns {boolean} - Returns true if the entity is allowed, false otherwise.
-     *
-     */
     validateEntity(device, entity, log = true) {
         if (isValidArray(this.config.entityBlackList, 1) && this.config.entityBlackList.find((e) => e === entity)) {
             if (log)
@@ -326,15 +250,6 @@ export class MatterbridgePlatform {
         }
         return true;
     }
-    /**
-     * Checks and updates the endpoint numbers for Matterbridge devices.
-     *
-     * This method retrieves the list of Matterbridge devices and their child endpoints,
-     * compares their current endpoint numbers with the stored ones, and updates the storage
-     * if there are any changes. It logs the changes and updates the endpoint numbers accordingly.
-     *
-     * @returns {Promise<number>} The size of the updated endpoint map, or -1 if storage is not available.
-     */
     async checkEndpointNumbers() {
         if (!this.storage)
             return -1;
@@ -375,4 +290,3 @@ export class MatterbridgePlatform {
         return endpointMap.size;
     }
 }
-//# sourceMappingURL=matterbridgePlatform.js.map

package/dist/matterbridgeTypes.js

@@ -1,27 +1,3 @@
-/**
- * This file contains the types for Matterbridge.
- *
- * @file matterbridgeTypes.ts
- * @author Luca Liguori
- * @date 2024-07-12
- * @version 1.0.2
- *
- * 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. *
- */
-// Default colors
 export const plg = '\u001B[38;5;33m';
 export const dev = '\u001B[38;5;79m';
 export const typ = '\u001B[38;5;207m';
-//# sourceMappingURL=matterbridgeTypes.js.map