matterbridge 3.2.0-dev-20250801-e5ebd91 → 3.2.0

package/dist/matterbridgePlatform.js

@@ -1,29 +1,82 @@
+/**
+ * This file contains the class MatterbridgePlatform.
+ *
+ * @file matterbridgePlatform.ts
+ * @author Luca Liguori
+ * @created 2024-03-21
+ * @version 1.2.1
+ * @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.
+ */
+// Node.js modules
 import path from 'node:path';
+// Node AnsiLogger module
 import { CYAN, db, er, nf, wr } from 'node-ansi-logger';
+// Node Storage module
 import { NodeStorageManager } from 'node-persist-manager';
 import { checkNotLatinCharacters } from './matterbridgeEndpointHelpers.js';
 import { isValidArray, isValidObject, isValidString } from './utils/export.js';
+/**
+ * Represents the base Matterbridge platform. It is extended by the MatterbridgeAccessoryPlatform and MatterbridgeServicePlatform classes.
+ *
+ */
 export class MatterbridgePlatform {
+    /** The Matterbridge instance of this Platform. */
     matterbridge;
+    /** The logger instance for this platform. */
     log;
+    /** The configuration for this platform. */
     config = {};
+    /** The name of the platform. Will be set by the loadPlugin() method using the package.json value. */
     name = '';
+    /** The type of the platform. Will be set by the extending classes. */
     type = '';
+    /** The version of the platform. Will be set by the loadPlugin() method using the package.json value */
     version = '1.0.0';
+    /** Platform node storage manager. */
     storage;
+    /** Platform context storage. */
     context;
+    // Device and entity select in the plugin config UI
     selectDevice = new Map();
     selectEntity = new Map();
+    // Promises for storage
     _contextReady;
     _selectDeviceContextReady;
     _selectEntityContextReady;
+    /** The ready promise for the platform, which resolves when the platform is fully initialized. */
     ready;
+    /** Registered MatterbridgeEndpoint Map by uniqueId */
     _registeredEndpoints = new Map();
+    /** Registered MatterbridgeEndpoint Map by deviceName */
     _registeredEndpointsByName = new Map();
+    /**
+     * Creates an instance of the base MatterbridgePlatform.
+     * It is extended by the MatterbridgeAccessoryPlatform and MatterbridgeServicePlatform classes.
+     * Each plugin must extend the MatterbridgeAccessoryPlatform and MatterbridgeServicePlatform classes.
+     *
+     * @param {Matterbridge} matterbridge - The Matterbridge instance.
+     * @param {AnsiLogger} log - The logger instance.
+     * @param {PlatformConfig} config - The platform configuration.
+     */
     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, 1))
             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)}`);
@@ -34,12 +87,14 @@ 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.log.debug(`Created context for plugin ${this.config.name}`);
             return;
         });
+        // 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', []);
@@ -48,6 +103,7 @@ export class MatterbridgePlatform {
             this.log.debug(`Loaded ${this.selectDevice.size} selectDevice for plugin ${this.config.name}`);
             return;
         });
+        // 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', []);
@@ -56,47 +112,126 @@ export class MatterbridgePlatform {
             this.log.debug(`Loaded ${this.selectEntity.size} selectEntity for plugin ${this.config.name}`);
             return;
         });
+        // 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`);
             return;
         });
     }
+    /**
+     * This method must be overridden in the extended class.
+     * It is called when the platform is started.
+     * Use this method to create the MatterbridgeEndpoints 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. In this case always call super.onConfigure() to save the select and run checkEndpointNumbers().
+     * It is called after the platform has started.
+     * Use this method to perform any configuration of your devices and to override the value of the attributes that are persistent and stored in the
+     * matter storage (i.e. the onOff attribute of the OnOff cluster).
+     */
     async onConfigure() {
         this.log.debug(`Configuring platform ${this.name}`);
+        // Save the selectDevice and selectEntity
         await this.saveSelects();
+        // Check and update the endpoint numbers
         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 you used in the constructor or onStart.
+     *
+     * @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
         await this.saveSelects();
+        // Check and update the endpoint numbers
         await this.checkEndpointNumbers();
+        // Cleanup memory
         this.selectDevice.clear();
         this.selectEntity.clear();
         this._registeredEndpoints.clear();
         this._registeredEndpointsByName.clear();
+        // Close the storage
         await this.context?.close();
         this.context = undefined;
         await this.storage?.close();
     }
+    /**
+     * Called when the logger level is changed.
+     *
+     * @param {LogLevel} logLevel The new logger level.
+     */
     async onChangeLoggerLevel(logLevel) {
         this.log.debug(`The plugin doesn't override onChangeLoggerLevel. Logger level set to: ${logLevel}`);
     }
+    /**
+     * Called when a plugin config includes an action button or an action button with text field.
+     *
+     * @param {string} action The action triggered by the button in plugin config.
+     * @param {string} value The value of the field of the action button.
+     * @param {string} id The id of the schema associated with the action.
+     * @param {PlatformConfig} formData The changed form data of the plugin.
+     *
+     * @remarks
+     * This method can be overridden in the extended class.
+     *
+     * Use this method to handle the action defined in the plugin schema:
+     * ```json
+     *  "addDevice": {
+     *      "description": "Manually add a device that has not been discovered with mdns:",
+     *      "type": "boolean",
+     *      "buttonText": "ADD",      // The text on the button. This is used when the action doesn't include a text field.
+     *      "buttonField": "ADD",     // The text on the button. This is used when the action includes a text field.
+     *      "buttonClose": false,     // optional, default is false. When true, the dialog will close after the action is sent.
+     *      "buttonSave": false,      // optional, default is false. When true, the dialog will close and trigger the restart required after the action is sent.
+     *      "textPlaceholder": "Enter the device IP address",   // optional: the placeholder text for the text field.
+     *      "default": false
+     *  },
+     * ```
+     */
     async onAction(action, value, id, formData) {
         this.log.debug(`The plugin ${CYAN}${this.name}${db} doesn't override onAction. Received action ${CYAN}${action}${db}${value ? ' with ' + CYAN + value + db : ''} ${id ? ' for schema ' + CYAN + id + db : ''}`, formData);
     }
+    /**
+     * Called when the plugin config has been updated.
+     *
+     * @param {PlatformConfig} config The new plugin config.
+     */
     async onConfigChanged(config) {
         this.log.debug(`The plugin ${CYAN}${config.name}${db} doesn't override onConfigChanged. Received new config.`);
     }
+    /**
+     * Retrieves the devices registered with the platform.
+     *
+     * @returns {MatterbridgeEndpoint[]} The registered devices.
+     */
     getDevices() {
         return Array.from(this._registeredEndpoints.values());
     }
+    /**
+     * Checks 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)) {
@@ -106,12 +241,27 @@ export class MatterbridgePlatform {
         if (device.deviceName && checkNotLatinCharacters(device.deviceName)) {
             this.log.debug(`Device with name ${CYAN}${device.deviceName}${db} has non latin characters.`);
         }
+        /* TODO: Do we need to handle the childbridged mode with DynamicPlatform here if the implementation forgets to call createDefaultBridgedDeviceBasicInformationClusterServer?
+        if (this.matterbridge.bridgeMode === 'childbridge' && this.type === 'DynamicPlatform' && device.mode === undefined) {
+          const options = device.getClusterServerOptions(Descriptor.Cluster.id);
+          if (options) {
+            const deviceTypeList = options.deviceTypeList as { deviceType: number; revision: number }[];
+            deviceTypeList.push({ deviceType: bridgedNode.code, revision: bridgedNode.revision });
+          }
+          device.createDefaultBridgedDeviceBasicInformationClusterServer(deviceName, serialNumber, vendorId, vendorName, productName, softwareVersion, softwareVersionString, hardwareVersion, hardwareVersionString);
+        }
+        */
         await this.matterbridge.addBridgedEndpoint(this.name, device);
         if (device.uniqueId)
             this._registeredEndpoints.set(device.uniqueId, device);
         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)
@@ -119,11 +269,24 @@ export class MatterbridgePlatform {
         if (device.deviceName)
             this._registeredEndpointsByName.delete(device.deviceName);
     }
+    /**
+     * Unregisters all devices registered with the Matterbridge platform.
+     *
+     * @param {number} [delay] - The delay in milliseconds between removing each bridged endpoint (default: 0).
+     */
     async unregisterAllDevices(delay = 0) {
         await this.matterbridge.removeAllBridgedEndpoints(this.name, delay);
         this._registeredEndpoints.clear();
         this._registeredEndpointsByName.clear();
     }
+    /**
+     * Saves the select devices and entities to storage.
+     *
+     * This method saves the current state of `selectDevice` and `selectEntity` maps to their respective storage.
+     * It logs the number of items being saved and ensures that the storage is properly closed after saving.
+     *
+     * @returns {Promise<void>} A promise that resolves when the save operation is complete.
+     */
     async saveSelects() {
         if (this.storage) {
             this.log.debug(`Saving ${this.selectDevice.size} selectDevice...`);
@@ -136,15 +299,36 @@ export class MatterbridgePlatform {
             await selectEntity.close();
         }
     }
+    /**
+     * Clears all the select device and entity maps.
+     *
+     * @returns {void}
+     */
     async clearSelect() {
         this.selectDevice.clear();
         this.selectEntity.clear();
         await this.saveSelects();
     }
+    /**
+     * Clears the select for a single device.
+     *
+     * @param {string} serial - The serial of the device to clear.
+     * @returns {void}
+     */
     async clearDeviceSelect(serial) {
         this.selectDevice.delete(serial);
         await this.saveSelects();
     }
+    /**
+     * Set the select device in the platform map.
+     *
+     * @param {string} serial - The serial number of the device.
+     * @param {string} name - The name of the device.
+     * @param {string} [configUrl] - The configuration URL of the device.
+     * @param {string} [icon] - The icon of the device: 'wifi', 'ble', 'hub'
+     * @param {Array<{ name: string; description: string; icon?: string }>} [entities] - The entities associated with the device.
+     * @returns {void}
+     */
     setSelectDevice(serial, name, configUrl, icon, entities) {
         const device = this.selectDevice.get(serial);
         if (device) {
@@ -161,6 +345,15 @@ export class MatterbridgePlatform {
             this.selectDevice.set(serial, { serial, name, configUrl, icon, entities });
         }
     }
+    /**
+     * Set the select device entity in the platform map.
+     *
+     * @param {string} serial - The serial number of the device.
+     * @param {string} entityName - The name of the entity.
+     * @param {string} entityDescription - The description of the entity.
+     * @param {string} [entityIcon] - The icon of the entity: 'wifi', 'ble', 'hub', 'component', 'matter'
+     * @returns {void}
+     */
     setSelectDeviceEntity(serial, entityName, entityDescription, entityIcon) {
         const device = this.selectDevice.get(serial);
         if (device) {
@@ -170,6 +363,11 @@ export class MatterbridgePlatform {
                 device.entities.push({ name: entityName, description: entityDescription, icon: entityIcon });
         }
     }
+    /**
+     * Retrieves the select devices from the platform map.
+     *
+     * @returns {{ pluginName: string; serial: string; name: string; configUrl?: string; icon?: string; entities?: { name: string; description: string; icon?: string }[] }[]} The selected devices array.
+     */
     getSelectDevices() {
         const selectDevices = [];
         for (const device of this.selectDevice.values()) {
@@ -177,9 +375,22 @@ export class MatterbridgePlatform {
         }
         return selectDevices;
     }
+    /**
+     * Set the select entity in the platform map.
+     *
+     * @param {string} name - The entity name.
+     * @param {string} description - The entity description.
+     * @param {string} [icon] - The entity icon: 'wifi', 'ble', 'hub', 'component', 'matter'
+     * @returns {void}
+     */
     setSelectEntity(name, description, icon) {
         this.selectEntity.set(name, { name, description, icon });
     }
+    /**
+     * Retrieve the select entities.
+     *
+     * @returns {{ pluginName: string; name: string; description: string; icon?: string }[]} The select entities array.
+     */
     getSelectEntities() {
         const selectEntities = [];
         for (const entity of this.selectEntity.values()) {
@@ -187,6 +398,12 @@ export class MatterbridgePlatform {
         }
         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) => {
@@ -211,6 +428,14 @@ export class MatterbridgePlatform {
             return false;
         return true;
     }
+    /**
+     * 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] - 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];
@@ -240,6 +465,14 @@ export class MatterbridgePlatform {
             this.log.info(`Skipping device ${CYAN}${device.join(', ')}${nf} because not in whitelist`);
         return false;
     }
+    /**
+     * 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] - 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)
@@ -258,6 +491,15 @@ 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;
@@ -298,3 +540,4 @@ export class MatterbridgePlatform {
         return endpointMap.size;
     }
 }
+//# sourceMappingURL=matterbridgePlatform.js.map

package/dist/matterbridgePlatform.js.map

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

package/dist/matterbridgeTypes.d.ts

@@ -0,0 +1,197 @@
+/**
+ * This file contains the types for Matterbridge.
+ *
+ * @file matterbridgeTypes.ts
+ * @author Luca Liguori
+ * @created 2024-07-12
+ * @version 1.0.2
+ * @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 { NodeStorage } from 'node-persist-manager';
+import { LogLevel } from 'node-ansi-logger';
+import { FabricIndex, VendorId, StorageContext, ServerNode, EndpointNumber, Endpoint as EndpointNode } from '@matter/main';
+import { AggregatorEndpoint } from '@matter/main/endpoints/aggregator';
+import { MatterbridgePlatform, PlatformConfig, PlatformSchema } from './matterbridgePlatform.js';
+import { MatterbridgeEndpoint } from './matterbridgeEndpoint.js';
+export declare const plg = "\u001B[38;5;33m";
+export declare const dev = "\u001B[38;5;79m";
+export declare const typ = "\u001B[38;5;207m";
+export interface RegisteredPlugin extends BaseRegisteredPlugin {
+    nodeContext?: NodeStorage;
+    storageContext?: StorageContext;
+    serverNode?: ServerNode<ServerNode.RootEndpoint>;
+    aggregatorNode?: EndpointNode<AggregatorEndpoint>;
+    device?: MatterbridgeEndpoint;
+    platform?: MatterbridgePlatform;
+    reachabilityTimeout?: NodeJS.Timeout;
+}
+export interface BaseRegisteredPlugin {
+    name: string;
+    version: string;
+    description: string;
+    author: string;
+    path: string;
+    type: string;
+    latestVersion?: string;
+    devVersion?: string;
+    serialNumber?: string;
+    homepage?: string;
+    help?: string;
+    changelog?: string;
+    funding?: string;
+    locked?: boolean;
+    error?: boolean;
+    enabled?: boolean;
+    loaded?: boolean;
+    started?: boolean;
+    configured?: boolean;
+    restartRequired?: boolean;
+    registeredDevices?: number;
+    addedDevices?: number;
+    configJson?: PlatformConfig;
+    schemaJson?: PlatformSchema;
+    hasWhiteList?: boolean;
+    hasBlackList?: boolean;
+}
+export interface FrontendRegisteredPlugin extends BaseRegisteredPlugin {
+    paired?: boolean;
+    qrPairingCode?: string;
+    manualPairingCode?: string;
+    fabricInformations?: SanitizedExposedFabricInformation[];
+    sessionInformations?: SanitizedSession[];
+}
+export interface SystemInformation {
+    interfaceName: string;
+    macAddress: string;
+    ipv4Address: string;
+    ipv6Address: string;
+    nodeVersion: string;
+    hostname: string;
+    user: string;
+    osType: string;
+    osRelease: string;
+    osPlatform: string;
+    osArch: string;
+    totalMemory: string;
+    freeMemory: string;
+    systemUptime: string;
+    processUptime: string;
+    cpuUsage: string;
+    rss: string;
+    heapTotal: string;
+    heapUsed: string;
+}
+export interface MatterbridgeInformation {
+    homeDirectory: string;
+    rootDirectory: string;
+    matterbridgeDirectory: string;
+    matterbridgePluginDirectory: string;
+    matterbridgeCertDirectory: string;
+    globalModulesDirectory: string;
+    matterbridgeVersion: string;
+    matterbridgeLatestVersion: string;
+    matterbridgeDevVersion: string;
+    matterbridgeSerialNumber: string;
+    matterbridgeAdvertise: boolean | undefined;
+    matterbridgeEndAdvertise: boolean;
+    matterbridgePaired: boolean | undefined;
+    matterbridgeQrPairingCode: string | undefined;
+    matterbridgeManualPairingCode: string | undefined;
+    matterbridgeFabricInformations: SanitizedExposedFabricInformation[] | undefined;
+    matterbridgeSessionInformations: SanitizedSession[] | undefined;
+    bridgeMode: string;
+    restartMode: string;
+    virtualMode: 'disabled' | 'outlet' | 'light' | 'switch' | 'mounted_switch';
+    readOnly: boolean;
+    shellyBoard: boolean;
+    shellySysUpdate: boolean;
+    shellyMainUpdate: boolean;
+    profile?: string;
+    loggerLevel: LogLevel;
+    fileLogger: boolean;
+    matterLoggerLevel: number;
+    matterFileLogger: boolean;
+    mattermdnsinterface: string | undefined;
+    matteripv4address: string | undefined;
+    matteripv6address: string | undefined;
+    matterPort: number;
+    matterDiscriminator: number | undefined;
+    matterPasscode: number | undefined;
+    restartRequired: boolean;
+    fixedRestartRequired: boolean;
+    updateRequired: boolean;
+}
+export interface SanitizedExposedFabricInformation {
+    fabricIndex: FabricIndex;
+    fabricId: string;
+    nodeId: string;
+    rootNodeId: string;
+    rootVendorId: VendorId;
+    rootVendorName: string;
+    label: string;
+}
+export interface SanitizedSession {
+    name: string;
+    nodeId: string;
+    peerNodeId: string;
+    fabric?: SanitizedExposedFabricInformation;
+    isPeerActive: boolean;
+    lastInteractionTimestamp: string;
+    lastActiveTimestamp: string;
+    numberOfActiveSubscriptions: number;
+}
+export interface ApiDevices {
+    pluginName: string;
+    type: string;
+    endpoint: EndpointNumber | undefined;
+    name: string;
+    serial: string;
+    productUrl: string;
+    configUrl?: string;
+    uniqueId: string;
+    reachable: boolean;
+    powerSource?: 'ac' | 'dc' | 'ok' | 'warning' | 'critical';
+    cluster: string;
+    matter?: ApiDevicesMatter;
+}
+export interface ApiDevicesMatter {
+    commissioned: boolean;
+    fabricInformations?: SanitizedExposedFabricInformation[];
+    sessionInformations?: SanitizedSession[];
+    qrPairingCode?: string;
+    manualPairingCode?: string;
+}
+export interface ApiClustersResponse {
+    plugin: string;
+    deviceName: string;
+    serialNumber: string;
+    endpoint: number;
+    deviceTypes: number[];
+    clusters: ApiClusters[];
+}
+export interface ApiClusters {
+    endpoint: string;
+    id: string;
+    deviceTypes: number[];
+    clusterName: string;
+    clusterId: string;
+    attributeName: string;
+    attributeId: string;
+    attributeValue: string;
+    attributeLocalValue: unknown;
+}
+//# sourceMappingURL=matterbridgeTypes.d.ts.map

package/dist/matterbridgeTypes.d.ts.map

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