matterbridge 3.5.2 → 3.5.3-dev-20260202-e19e9b6

package/dist/mb_mdns.js

@@ -1,36 +1,9 @@
-/**
- * @description This file contains the bin mb_mdns for the class Mdns.
- * @file src/dgram/mb_mdns.ts
- * @author Luca Liguori
- * @created 2025-07-22
- * @version 1.0.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 os from 'node:os';
-// Net imports
 import { MDNS_MULTICAST_IPV4_ADDRESS, MDNS_MULTICAST_IPV6_ADDRESS, MDNS_MULTICAST_PORT, Mdns } from '@matterbridge/dgram';
-// Utils imports
 import { getIntParameter, getParameter, getStringArrayParameter, hasParameter } from '@matterbridge/utils';
-// istanbul ignore next
 {
     if (hasParameter('h') || hasParameter('help')) {
-        // eslint-disable-next-line no-console
         console.log(`Copyright (c) Matterbridge. All rights reserved. Version 1.0.0.\n`);
-        // eslint-disable-next-line no-console
         console.log(`Usage: mb_mdns [options...]
 
 If no command line is provided, mb_mdns shows all incoming mDNS records on all interfaces (0.0.0.0 and ::).
@@ -75,10 +48,8 @@ Examples:
   # Query each 5s and listen for _matterbridge._tcp.local service records
   mb_mdns --query 5000 --filter _matterbridge._tcp.local
 `);
-        // eslint-disable-next-line n/no-process-exit
         process.exit(0);
     }
-    // Dynamic JSON import (Node >= 20) with import attributes
     const { default: pkg } = await import('../package.json', { with: { type: 'json' } });
     let mdnsIpv4QueryInterval;
     let mdnsIpv6QueryInterval;
@@ -86,9 +57,6 @@ Examples:
     let mdnsIpv6AdvertiseInterval;
     let mdnsIpv4 = undefined;
     let mdnsIpv6 = undefined;
-    /**
-     * Cleanup and log device information before exiting.
-     */
     async function cleanupAndLogAndExit() {
         clearInterval(mdnsIpv4QueryInterval);
         clearInterval(mdnsIpv6QueryInterval);
@@ -96,54 +64,48 @@ Examples:
         clearInterval(mdnsIpv6AdvertiseInterval);
         if (hasParameter('advertise')) {
             if (mdnsIpv4)
-                advertise(mdnsIpv4, 0); // Send goodbye with TTL 0
+                advertise(mdnsIpv4, 0);
             if (mdnsIpv6)
-                advertise(mdnsIpv6, 0); // Send goodbye with TTL 0
+                advertise(mdnsIpv6, 0);
         }
-        await new Promise((resolve) => setTimeout(resolve, 250)); // Wait for 250ms to allow goodbye messages to be sent
+        await new Promise((resolve) => setTimeout(resolve, 250));
         mdnsIpv4?.stop();
         mdnsIpv6?.stop();
         mdnsIpv4?.logDevices();
         mdnsIpv6?.logDevices();
-        await new Promise((resolve) => setTimeout(resolve, 250)); // Wait for 250ms to allow sockets to close
+        await new Promise((resolve) => setTimeout(resolve, 250));
     }
     const query = (mdns) => {
         mdns.log.info('Sending mDNS query for common services...');
         try {
             mdns.sendQuery([
-                { name: '_matterc._udp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_matter._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_matterbridge._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_home-assistant._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_shelly._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_mqtt._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_http._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_googlecast._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_airplay._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_amzn-alexa._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_companion-link._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_hap._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_hap._udp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_ipp._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_ipps._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_meshcop._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_printer._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_raop._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_sleep-proxy._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_ssh._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
-                { name: '_services._dns-sd._udp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
+                { name: '_matterc._udp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_matter._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_matterbridge._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_home-assistant._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_shelly._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_mqtt._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_http._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_googlecast._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_airplay._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_amzn-alexa._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_companion-link._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_hap._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_hap._udp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_ipp._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_ipps._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_meshcop._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_printer._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_raop._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_sleep-proxy._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_ssh._tcp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_services._dns-sd._udp.local', type: 12, class: 1, unicastResponse: true },
             ]);
         }
         catch (error) {
             mdns.log.error(`Error sending mDNS query: ${error.message}`);
         }
     };
-    /**
-     * Sends an mDNS advertisement for the HTTP service over UDP IPv4.
-     *
-     * @param {Mdns} mdns - The Mdns instance to use for sending the advertisement.
-     * @param {number} [ttl] - The time-to-live for the advertisement records. Defaults to 120 seconds. Send 0 for goodbye.
-     */
     const advertise = (mdns, ttl = 120) => {
         mdns.log.info(`Sending mDNS advertisement for matterbridge service with TTL ${ttl ? ttl.toString() : 'goodbye'}...`);
         const httpServiceType = '_http._tcp.local';
@@ -159,25 +121,17 @@ Examples:
         const srvRdata = mdns.encodeSrvRdata(0, 0, port, hostName);
         const txtRdata = mdns.encodeTxtRdata([`version=${pkg.version}`, 'path=/']);
         const answers = [
-            // PTR records for service types and instances
-            { name: '_services._dns-sd._udp.local', rtype: 12 /* DnsRecordType.PTR */, rclass: 1 /* DnsClass.IN */, ttl, rdata: ptrHttpServiceTypeRdata },
-            { name: httpServiceType, rtype: 12 /* DnsRecordType.PTR */, rclass: 1 /* DnsClass.IN */, ttl, rdata: ptrHttpInstanceRdata },
-            { name: '_services._dns-sd._udp.local', rtype: 12 /* DnsRecordType.PTR */, rclass: 1 /* DnsClass.IN */, ttl, rdata: ptrMatterbridgeServiceTypeRdata },
-            { name: matterbridgeServiceType, rtype: 12 /* DnsRecordType.PTR */, rclass: 1 /* DnsClass.IN */, ttl, rdata: ptrMatterbridgeInstanceRdata },
-            // SRV record for the HTTP instance
-            { name: httpInstanceName, rtype: 33 /* DnsRecordType.SRV */, rclass: 1 /* DnsClass.IN */ | 32768 /* DnsClassFlag.FLUSH */, ttl, rdata: srvRdata },
-            // SRV record for the matterbridge instance
-            { name: matterbridgeInstanceName, rtype: 33 /* DnsRecordType.SRV */, rclass: 1 /* DnsClass.IN */ | 32768 /* DnsClassFlag.FLUSH */, ttl, rdata: srvRdata },
-            // TXT record for the HTTP instance
-            { name: httpInstanceName, rtype: 16 /* DnsRecordType.TXT */, rclass: 1 /* DnsClass.IN */ | 32768 /* DnsClassFlag.FLUSH */, ttl, rdata: txtRdata },
-            // TXT record for the matterbridge instance
-            { name: matterbridgeInstanceName, rtype: 16 /* DnsRecordType.TXT */, rclass: 1 /* DnsClass.IN */ | 32768 /* DnsClassFlag.FLUSH */, ttl, rdata: txtRdata },
+            { name: '_services._dns-sd._udp.local', rtype: 12, rclass: 1, ttl, rdata: ptrHttpServiceTypeRdata },
+            { name: httpServiceType, rtype: 12, rclass: 1, ttl, rdata: ptrHttpInstanceRdata },
+            { name: '_services._dns-sd._udp.local', rtype: 12, rclass: 1, ttl, rdata: ptrMatterbridgeServiceTypeRdata },
+            { name: matterbridgeServiceType, rtype: 12, rclass: 1, ttl, rdata: ptrMatterbridgeInstanceRdata },
+            { name: httpInstanceName, rtype: 33, rclass: 1 | 32768, ttl, rdata: srvRdata },
+            { name: matterbridgeInstanceName, rtype: 33, rclass: 1 | 32768, ttl, rdata: srvRdata },
+            { name: httpInstanceName, rtype: 16, rclass: 1 | 32768, ttl, rdata: txtRdata },
+            { name: matterbridgeInstanceName, rtype: 16, rclass: 1 | 32768, ttl, rdata: txtRdata },
         ];
-        // Always attempt to add both A and all AAAA records (best effort), regardless of the socket family.
         const interfaces = os.networkInterfaces();
-        // Use specified interface name if provided
         let interfaceInfos = mdns.interfaceName ? interfaces[mdns.interfaceName] : undefined;
-        // Find the first non-internal IPv4 and IPv6 addresses if interface name is not provided or not found
         if (!interfaceInfos) {
             interfaceInfos = [];
             for (const name of Object.keys(interfaces)) {
@@ -188,15 +142,14 @@ Examples:
                 }
             }
         }
-        // Encode A and AAAA records for all non-internal addresses of the selected interface
         for (const info of interfaceInfos) {
             if (info.family === 'IPv4' && !info.internal) {
                 const ipv4 = info.address;
-                answers.push({ name: hostName, rtype: 1 /* DnsRecordType.A */, rclass: 1 /* DnsClass.IN */ | 32768 /* DnsClassFlag.FLUSH */, ttl, rdata: mdns.encodeA(ipv4) });
+                answers.push({ name: hostName, rtype: 1, rclass: 1 | 32768, ttl, rdata: mdns.encodeA(ipv4) });
             }
             else if (info.family === 'IPv6' && !info.internal) {
                 const ipv6 = info.address;
-                answers.push({ name: hostName, rtype: 28 /* DnsRecordType.AAAA */, rclass: 1 /* DnsClass.IN */ | 32768 /* DnsClassFlag.FLUSH */, ttl, rdata: mdns.encodeAAAA(ipv6) });
+                answers.push({ name: hostName, rtype: 28, rclass: 1 | 32768, ttl, rdata: mdns.encodeAAAA(ipv6) });
             }
         }
         try {
@@ -210,19 +163,15 @@ Examples:
         mdnsIpv4 = new Mdns('mDNS Server udp4', MDNS_MULTICAST_IPV4_ADDRESS, MDNS_MULTICAST_PORT, 'udp4', true, getParameter('interfaceName'), getParameter('ipv4InterfaceAddress') || '0.0.0.0', getParameter('outgoingIpv4InterfaceAddress'));
         if (hasParameter('v') || hasParameter('verbose'))
             mdnsIpv4.listNetworkInterfaces();
-        // Apply filters if any
         const filters = getStringArrayParameter('filter');
         if (filters)
             mdnsIpv4.filters.push(...filters);
-        // Apply ip filters if any
         const ipFilters = getStringArrayParameter('ip-filter');
         if (ipFilters)
             mdnsIpv4.ipFilters.push(...ipFilters);
-        // Handle errors
         mdnsIpv4.on('error', (err) => {
             mdnsIpv4?.log.error(`mDNS udp4 Server error: ${err.message}\n${err.stack}`);
         });
-        // Start the IPv4 mDNS server
         mdnsIpv4.start();
         mdnsIpv4.on('ready', (address) => {
             mdnsIpv4?.socket.setMulticastLoopback(false);
@@ -241,19 +190,15 @@ Examples:
         mdnsIpv6 = new Mdns('mDNS Server udp6', MDNS_MULTICAST_IPV6_ADDRESS, MDNS_MULTICAST_PORT, 'udp6', true, getParameter('interfaceName'), getParameter('ipv6InterfaceAddress') || '::', getParameter('outgoingIpv6InterfaceAddress'));
         if (hasParameter('v') || hasParameter('verbose'))
             mdnsIpv6.listNetworkInterfaces();
-        // Apply filters if any
         const filters = getStringArrayParameter('filter');
         if (filters)
             mdnsIpv6.filters.push(...filters);
-        // Apply ip filters if any
         const ipFilters = getStringArrayParameter('ip-filter');
         if (ipFilters)
             mdnsIpv6.ipFilters.push(...ipFilters);
-        // Handle errors
         mdnsIpv6.on('error', (err) => {
             mdnsIpv6?.log.error(`mDNS udp6 Server error: ${err.message}\n${err.stack}`);
         });
-        // Start the IPv6 mDNS server
         mdnsIpv6.start();
         mdnsIpv6.on('ready', (address) => {
             mdnsIpv6?.socket.setMulticastLoopback(false);
@@ -268,18 +213,15 @@ Examples:
             }
         });
     }
-    // Handle Ctrl+C (SIGINT) and SIGTERM to stop and log devices
     process.on('SIGINT', async () => {
         await cleanupAndLogAndExit();
     });
     process.on('SIGTERM', async () => {
         await cleanupAndLogAndExit();
     });
-    // Exit after a timeout to avoid running indefinitely in test environments
     if (!hasParameter('no-timeout')) {
         setTimeout(async () => {
             await cleanupAndLogAndExit();
-        }, 600000).unref(); // 10 minutes timeout to exit if no activity
+        }, 600000).unref();
     }
 }
-//# sourceMappingURL=mb_mdns.js.map

package/dist/pluginManager.d.ts

@@ -1,26 +1,3 @@
-/**
- * This file contains the Plugins class.
- *
- * @file plugins.ts
- * @author Luca Liguori
- * @created 2024-07-14
- * @version 1.3.5
- * @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 EventEmitter from 'node:events';
 import { LogLevel } from 'node-ansi-logger';
 import type { Matterbridge } from './matterbridge.js';
@@ -39,9 +16,6 @@ interface PluginManagerEvents {
     configured: [name: string];
     shutdown: [name: string];
 }
-/**
- * Manages Matterbridge plugins.
- */
 export declare class PluginManager extends EventEmitter<PluginManagerEvents> {
     private readonly matterbridge;
     private readonly _plugins;
@@ -49,325 +23,46 @@ export declare class PluginManager extends EventEmitter<PluginManagerEvents> {
     private readonly server;
     private readonly debug;
     private readonly verbose;
-    /**
-     * Creates an instance of PluginManager.
-     *
-     * @param {Matterbridge} matterbridge - The Matterbridge instance.
-     */
     constructor(matterbridge: Matterbridge);
     destroy(): void;
     private msgHandler;
-    /**
-     * Gets the number of plugins.
-     *
-     * @returns {number} The number of plugins.
-     */
     get length(): number;
-    /**
-     * Gets the number of plugins.
-     *
-     * @returns {number} The number of plugins.
-     */
     get size(): number;
-    /**
-     * Checks if a plugin with the specified name exists.
-     *
-     * @param {string} name - The name of the plugin.
-     * @returns {boolean} True if the plugin exists, false otherwise.
-     */
     has(name: string): boolean;
-    /**
-     * Gets a plugin by its name.
-     *
-     * @param {string} name - The name of the plugin.
-     * @returns {Plugin | undefined} The plugin, or undefined if not found.
-     */
     get(name: string): Plugin | undefined;
-    /**
-     * Adds a plugin to the manager.
-     *
-     * @param {Plugin} plugin - The plugin to add.
-     * @returns {Plugin} The added plugin.
-     */
     set(plugin: Plugin): Plugin;
-    /**
-     * Clears all plugins from the manager.
-     */
     clear(): void;
-    /**
-     * Converts a plugin or API plugin to a storage plugin.
-     *
-     * @param {Plugin | ApiPlugin} plugin - The plugin or API plugin to convert.
-     * @returns {StoragePlugin} The converted storage plugin.
-     */
     private toStoragePlugin;
-    /**
-     * Converts a plugin to an API plugin.
-     *
-     * @param {Plugin} plugin - The plugin to convert.
-     * @returns {ApiPlugin} The converted API plugin.
-     */
     private toApiPlugin;
-    /**
-     * Gets an array of all plugins.
-     *
-     * @returns {Plugin[]} An array of all plugins.
-     */
     array(): Plugin[];
-    /**
-     * Gets a StoragePlugin array of all plugins suitable for serialization.
-     *
-     * @returns {StoragePlugin[]} An array of all plugins.
-     */
     storagePluginArray(): StoragePlugin[];
-    /**
-     * Gets an ApiPlugin array of all plugins suitable for serialization.
-     *
-     * @returns {ApiPlugin[]} An array of all plugins.
-     */
     apiPluginArray(): ApiPlugin[];
-    /**
-     * Gets an iterator for the plugins.
-     *
-     * @returns {IterableIterator<Plugin>} An iterator for the plugins.
-     */
     [Symbol.iterator](): MapIterator<Plugin>;
-    /**
-     * Executes a provided function once for each plugin.
-     *
-     * @param {Function} callback - The function to execute for each plugin.
-     * @returns {Promise<void>}
-     */
     forEach(callback: (plugin: Plugin) => Promise<void>): Promise<void>;
-    /**
-     * Sets the log level for the plugin manager.
-     *
-     * @param {LogLevel} logLevel - The log level to set.
-     */
     set logLevel(logLevel: LogLevel);
-    /**
-     * Loads registered plugins from storage.
-     *
-     * @returns {Promise<StoragePlugin[]>} A promise that resolves to an array of registered plugins.
-     */
     loadFromStorage(): Promise<StoragePlugin[]>;
-    /**
-     * Saves registered plugins to storage.
-     *
-     * @returns {Promise<number>} A promise that resolves to the number of registered plugins.
-     */
     saveToStorage(): Promise<number>;
-    /**
-     * Resolves the name of a plugin by loading and parsing its package.json file.
-     * It will first try to resolve the path as is, then in the global modules directory, and finally in the matterbridge plugin directory.
-     *
-     * @param {string} nameOrPath - The name of the plugin or the path to the plugin's package.json file.
-     * @returns {Promise<string | null>} A promise that resolves to the path of the plugin's package.json file or null if it could not be resolved.
-     */
     resolve(nameOrPath: string): Promise<string | null>;
-    /**
-     * Installs a package globally using npm.
-     *
-     * @param {string} packageName - The name of the package to install.
-     * @returns {Promise<boolean>} A promise that resolves to true if the installation was successful, false otherwise.
-     */
     install(packageName: string): Promise<boolean>;
-    /**
-     * Uninstalls a package globally using npm.
-     *
-     * @param {string} packageName - The name of the package to uninstall.
-     * @returns {Promise<boolean>} A promise that resolves to true if the uninstallation was successful, false otherwise.
-     */
     uninstall(packageName: string): Promise<boolean>;
-    /**
-     * Get the author of a plugin from its package.json.
-     *
-     * @param {Record<string, string | number | Record<string, string | number | object>>} packageJson - The package.json object of the plugin.
-     * @returns {string} The author of the plugin, or 'Unknown author' if not found.
-     */
     getAuthor(packageJson: Record<string, string | number | Record<string, string | number | object>>): string;
-    /**
-     * Get the homepage of a plugin from its package.json.
-     *
-     * @param {Record<string, string | number | Record<string, string | number | object>>} packageJson - The package.json object of the plugin.
-     * @returns {string | undefined} The homepage of the plugin, or undefined if not found.
-     */
     getHomepage(packageJson: Record<string, string | number | Record<string, string | number | object>>): string | undefined;
-    /**
-     * Get the help URL of a plugin from its package.json.
-     *
-     * @param {Record<string, string | number | Record<string, string | number | object>>} packageJson - The package.json object of the plugin.
-     * @returns {string | undefined} The URL to the help page or to the README file, or undefined if not found.
-     */
     getHelp(packageJson: Record<string, string | number | Record<string, string | number | object>>): string | undefined;
-    /**
-     * Get the changelog URL of a plugin from its package.json.
-     *
-     * @param {Record<string, string | number | Record<string, string | number | object>>} packageJson - The package.json object of the plugin.
-     * @returns {string | undefined} The URL to the CHANGELOG file, or undefined if not found.
-     */
     getChangelog(packageJson: Record<string, string | number | Record<string, string | number | object>>): string | undefined;
-    /**
-     * Get the first funding URL(s) of a plugin from its package.json.
-     *
-     * @param {Record<string, any>} packageJson - The package.json object of the plugin.
-     * @returns {string | undefined} The first funding URLs, or undefined if not found.
-     */
     getFunding(packageJson: Record<string, any>): string | undefined;
-    /**
-     * Parses the plugin package.json and returns it.
-     * It will also log warnings and errors for missing or invalid fields.
-     * It will return null if critical errors are found.
-     *
-     * @param {Plugin | PluginName} plugin - The plugin to load the package from.
-     * @returns {Promise<Record<string, string | number | object> | null>} A promise that resolves to the parsed package.json object or null if it could not be parsed.
-     */
     parse(plugin: Plugin | PluginName): Promise<Record<string, string | number | object> | null>;
-    /**
-     * Enables a plugin by its name or path.
-     *
-     * This method enables a plugin by setting its `enabled` property to `true` and saving the updated
-     * plugin information to storage. It first checks if the plugin is already registered in the `_plugins` map.
-     * If not, it attempts to resolve the plugin's `package.json` file to retrieve its name and enable it.
-     *
-     * @param {string} nameOrPath - The name or path of the plugin to enable.
-     * @returns {Promise<Plugin | null>} A promise that resolves to the enabled plugin object, or null if the plugin could not be enabled.
-     */
     enable(nameOrPath: string): Promise<Plugin | null>;
-    /**
-     * Disables a plugin by its name or path.
-     *
-     * This method disables a plugin by setting its `enabled` property to `false` and saving the updated
-     * plugin information to storage. It first checks if the plugin is already registered in the `_plugins` map.
-     * If not, it attempts to resolve the plugin's `package.json` file to retrieve its name and disable it.
-     *
-     * @param {string} nameOrPath - The name or path of the plugin to enable.
-     * @returns {Promise<Plugin | null>} A promise that resolves to the disabled plugin object, or null if the plugin could not be disabled.
-     */
     disable(nameOrPath: string): Promise<Plugin | null>;
-    /**
-     * Removes a plugin by its name or path.
-     *
-     * This method removes a plugin from the `_plugins` map and saves the updated plugin information to storage.
-     * It first checks if the plugin is already registered in the `_plugins` map. If not, it attempts to resolve
-     * the plugin's `package.json` file to retrieve its name and remove it.
-     *
-     * @param {string} nameOrPath - The name or path of the plugin to remove.
-     * @returns {Promise<Plugin | null>} A promise that resolves to the removed plugin object, or null if the plugin could not be removed.
-     */
     remove(nameOrPath: string): Promise<Plugin | null>;
-    /**
-     * Adds a plugin by its name or path.
-     *
-     * This method adds a plugin to the plugins map and saves the updated plugin information to storage.
-     * It first resolves the plugin's `package.json` file to retrieve its details. If the plugin is already
-     * registered, it logs an info message and returns null. Otherwise, it registers the plugin, enables it,
-     * and saves the updated plugin information to storage.
-     *
-     * @param {string} nameOrPath - The name or path of the plugin to add.
-     * @returns {Promise<Plugin | null>} A promise that resolves to the added plugin object, or null if the plugin could not be added.
-     */
     add(nameOrPath: string): Promise<Plugin | null>;
-    /**
-     * Loads a plugin and returns the corresponding MatterbridgePlatform instance.
-     *
-     * @param {Plugin | PluginName} plugin - The plugin to load.
-     * @param {boolean} start - Optional flag indicating whether to start the plugin after loading. Default is false.
-     * @param {string} message - Optional message to pass to the plugin when starting.
-     * @param {boolean} configure - Optional flag indicating whether to configure the plugin after loading. Default is false.
-     * @returns {Promise<MatterbridgePlatform | undefined>} A Promise that resolves to the loaded MatterbridgePlatform instance or undefined.
-     */
     load(plugin: Plugin | PluginName, start?: boolean, message?: string, configure?: boolean): Promise<MatterbridgePlatform | undefined>;
-    /**
-     * Starts a plugin.
-     *
-     * @param {Plugin | PluginName} plugin - The plugin to start.
-     * @param {string} [message] - Optional message to pass to the plugin's onStart method.
-     * @param {boolean} [configure] - Indicates whether to configure the plugin after starting (default false).
-     * @returns {Promise<Plugin | undefined>} A promise that resolves when the plugin is started successfully, or rejects with an error if starting the plugin fails.
-     */
     start(plugin: Plugin | PluginName, message?: string, configure?: boolean): Promise<Plugin | undefined>;
-    /**
-     * Configures a plugin.
-     *
-     * @param {Plugin | PluginName} plugin - The plugin to configure.
-     * @returns {Promise<Plugin | undefined>} A promise that resolves when the plugin is configured successfully, or rejects with an error if configuration fails.
-     */
     configure(plugin: Plugin | PluginName): Promise<Plugin | undefined>;
-    /**
-     * Shuts down a plugin.
-     *
-     * This method shuts down a plugin by calling its `onShutdown` method and resetting its state.
-     * It logs the shutdown process and optionally removes all devices associated with the plugin.
-     *
-     * @param {Plugin | PluginName} plugin - The plugin to shut down.
-     * @param {string} [reason] - The reason for shutting down the plugin.
-     * @param {boolean} [removeAllDevices] - Whether to remove all devices associated with the plugin.
-     * @param {boolean} [force] - Whether to force the shutdown even if the plugin is not loaded or started.
-     * @returns {Promise<Plugin | undefined>} A promise that resolves to the shut down plugin object, or undefined if the shutdown failed.
-     */
     shutdown(plugin: Plugin | PluginName, reason?: string, removeAllDevices?: boolean, force?: boolean): Promise<Plugin | undefined>;
-    /**
-     * Loads the configuration for a plugin.
-     * If the configuration file exists, it reads the file and returns the parsed JSON data.
-     * If the configuration file does not exist, it creates a new file with default configuration and returns it.
-     * If any error occurs during file access or creation, it logs an error and return un empty config.
-     *
-     * @param {Plugin} plugin - The plugin for which to load the configuration.
-     * @returns {Promise<PlatformConfig>} A promise that resolves to the loaded or created configuration.
-     */
     loadConfig(plugin: Plugin): Promise<PlatformConfig>;
-    /**
-     * Saves the configuration of a plugin to a file.
-     *
-     * This method saves the configuration of the specified plugin to a JSON file in the matterbridge directory.
-     * If the plugin's configuration is not found, it logs an error and rejects the promise. If the configuration
-     * is successfully saved, it logs a debug message. If an error occurs during the file write operation, it logs
-     * the error and rejects the promise.
-     *
-     * @param {Plugin} plugin - The plugin whose configuration is to be saved.
-     * @param {boolean} [restartRequired] - Indicates whether a restart is required after saving the configuration.
-     * @returns {Promise<void>} A promise that resolves when the configuration is successfully saved, or rejects if an error occurs.
-     * @throws {Error} If the plugin's configuration is not found.
-     */
     saveConfigFromPlugin(plugin: Plugin, restartRequired?: boolean): Promise<void>;
-    /**
-     * Saves the configuration of a plugin from a JSON object to a file.
-     *
-     * This method saves the provided configuration of the specified plugin to a JSON file in the matterbridge directory.
-     * It first checks if the configuration data is valid by ensuring it contains the correct name and type, and matches
-     * the plugin's name. If the configuration data is invalid, it logs an error and returns. If the configuration is
-     * successfully saved, it updates the plugin's `configJson` property and logs a debug message. If an error occurs
-     * during the file write operation, it logs the error and returns.
-     *
-     * @param {Plugin} plugin - The plugin whose configuration is to be saved.
-     * @param {PlatformConfig} config - The configuration data to be saved.
-     * @param {boolean} [restartRequired] - Indicates whether a restart is required after saving the configuration.
-     * @returns {Promise<void>} A promise that resolves when the configuration is successfully saved, or returns if an error occurs.
-     */
     saveConfigFromJson(plugin: Plugin, config: PlatformConfig, restartRequired?: boolean): Promise<void>;
-    /**
-     * Loads the schema for a plugin.
-     *
-     * This method attempts to load the schema file for the specified plugin. If the schema file is found,
-     * it reads and parses the file, updates the schema's title and description, and logs the process.
-     * If the schema file is not found, it logs the event and loads a default schema for the plugin.
-     *
-     * @param {Plugin} plugin - The plugin whose schema is to be loaded.
-     * @returns {Promise<PlatformSchema>} A promise that resolves to the loaded schema object, or the default schema if the schema file is not found.
-     */
     loadSchema(plugin: Plugin): Promise<PlatformSchema>;
-    /**
-     * Returns the default schema for a plugin.
-     *
-     * This method generates a default schema object for the specified plugin. The schema includes
-     * metadata such as the plugin's title, description, version, and author. It also defines the
-     * properties of the schema, including the plugin's name, type, debug flag, and unregisterOnShutdown flag.
-     *
-     * @param {Plugin} plugin - The plugin for which the default schema is to be generated.
-     * @returns {PlatformSchema} The default schema object for the plugin.
-     */
     getDefaultSchema(plugin: Plugin): PlatformSchema;
 }
 export {};
-//# sourceMappingURL=pluginManager.d.ts.map