matterbridge 3.5.2 → 3.5.3-dev-20260202-e19e9b6

package/CHANGELOG.md

@@ -33,7 +33,7 @@ The project will evolve to a multi-threaded architecture (the CLI will become th
 
 - ✅ check updates;
 - npm install;
-- ✅ get the global node_modules directory;
+- ✅ check the global node_modules directory;
 
 Advantages:
 
@@ -42,6 +42,35 @@ Advantages:
 - individual plugin isolation in childbridge mode;
 - ability to update the plugin in childbridge mode without restarting matterbridge;
 
+## [3.5.3] - Dev branch
+
+### Breaking Changes
+
+- [docker]: Updated latest and dev docker images to use node:24-trixie-slim as base.
+
+### Added
+
+- [docker]: Added workflow, scripts and dockerfile to build the s6-rc-base base image used by the Matterbridge Home Assistant Application.
+- [frontend]: Added title render to the config editor and allow ui properties in 'oneOf', 'anyOf', 'allOf'. Thanks RinDevJunior (https://github.com/Luligu/matterbridge/pull/495).
+- [frontend]: Added SearchPluginsDialog in Install plugins panel on the home page.
+- [publish]: Migrate to trusted publishing / OIDC.
+
+### Changed
+
+- [package]: Updated dependencies.
+- [workflows]: Updated all workflows to use Node.js 24.
+- [readme]: Updated readme files to clarify which Node.js version should be installed.
+- [docker]: Updated readme file to clarify which base image is used.
+- [matter.js]: Bump to matter.j v. 0.16.8.
+- [frontend]: Bumped `frontend` version to v. 3.4.4.
+- [frontend]: Updated `frontend` dependencies.
+
+### Fixed
+
+- [publish]: Updated publish.yml to trigger the correct docker-buildx-latest.yml.
+
+<a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="80"></a>
+
 ## [3.5.2] - 2026-01-31
 
 ### Added

package/README-DOCKER.md

@@ -20,9 +20,9 @@
 
 The Matterbridge Docker images (multi-arch manifest list for **linux/amd64** and **linux/arm64**) are published on [**Docker Hub**](https://hub.docker.com/r/luligu/matterbridge). If you use them, please consider starring the project on [**Docker Hub**](https://hub.docker.com/r/luligu/matterbridge).
 
-The image (tag **latest**) includes Matterbridge and all official plugins, using the latest release published on npm. It is based on `node:22-bookworm-slim`. Since all official plugins are included, you can select and add a plugin without installing anything.
+The image (tag **latest**) includes Matterbridge and all official plugins, using the latest release published on npm. It is based on `node:24-trixie-slim`. Since all official plugins are included, you can select and add a plugin without installing anything.
 
-The image (tag **dev**) includes Matterbridge and all official plugins from the latest push on GitHub. It is based on `node:22-bookworm-slim`. Since all official plugins are included, you can select and add a plugin without installing anything. Note: if you update to the latest **dev** from the frontend, you will override the GitHub version with the latest **dev** published on npm.
+The image (tag **dev**) includes Matterbridge and all official plugins from the latest push on GitHub. It is based on `node:24-trixie-slim`. Since all official plugins are included, you can select and add a plugin without installing anything. Note: if you update to the latest **dev** from the frontend, you will override the GitHub version with the latest **dev** published on npm. The frontend shows if you are currently running the GitHub release or the latest or dev npm release.
 
 The image (tag **ubuntu**) includes only Matterbridge, using the latest release published on npm. This image (**for test and development only**) is based on `ubuntu:latest` with Node.js 24 from NodeSource. Plugins are not included in the image; they will be installed on first run. This image preinstalls `bluetooth`, `build-essential`, and `python` packages (useful for plugins that require native builds).
 

package/README.md

@@ -71,16 +71,21 @@ https://blog.adafruit.com/2025/11/03/matterbridge-a-matter-plugin-manager/
 
 To run Matterbridge, you need either a [Node.js](https://nodejs.org/en) environment or [Docker](https://docs.docker.com/get-started/get-docker/) installed on your system.
 
-If you don't have Node.js already install, please use this method to install it on a debian device: https://github.com/nodesource/distributions.
-The supported versions of node are 20, 22 and 24. Please install Node.js 22 LTS. Don't use Node.js Current but always the Node.js LTS.
-Node.js 23, like all odd-numbered versions, is not supported.
-Nvm is not a good choice and should not be used for production.
+If you don't have Node.js already installed, please use this method to install it on a Debian system: https://github.com/nodesource/distributions.
 
-If you don't have Docker already install, please use this method to install it on a debian device: https://docs.docker.com/engine/install.
+The supported versions of Node.js are 20, 22, and 24. Please **install Node.js 24 LTS**. Don't use Node.js Current; always use the Node.js LTS releases.
 
-If you don't have Docker already install, please use this method to install it on a Windows or macOS: https://docs.docker.com/get-started/introduction/get-docker-desktop/.
+Node.js 25, like all odd-numbered versions, is not supported.
 
-After follow the guidelines for the [Docker configurations](README-DOCKER.md).
+To verify which Node.js version is currently LTS (Active), check [Node.js Releases](https://nodejs.org/en/about/previous-releases).
+
+**Nvm is not a good choice and should not be used for production**.
+
+If you don't have Docker already installed, please use this method to install it on a Debian system: https://docs.docker.com/engine/install.
+
+If you don't have Docker already installed, please use this method to install it on Windows or macOS: https://docs.docker.com/get-started/introduction/get-docker-desktop/.
+
+After that, follow the guidelines for the [Docker configurations](README-DOCKER.md).
 
 I suggest using Docker for its simplicity.
 
@@ -88,9 +93,9 @@ Since Matter is designed as "a universal IPv6-based communication protocol for s
 
 **Important:** You only need IPv6 on your local network - it doesn't matter if your internet provider doesn't provide IPv6 on the internet side (WAN).
 
-Avoid using VLAN, VM and firewall blocking the communications between the controllers and Matterbridge.
+Avoid VLANs, VMs, and firewalls that block communication between the controllers and Matterbridge.
 
-To pair matterbridge, you need a matter enabled controller (Apple Home, Smart Things, Google Home, Alexa, Home Assistant etc.).
+To pair Matterbridge, you need a Matter-enabled controller (Apple Home, SmartThings, Google Home, Alexa, Home Assistant, etc.).
 
 ## Installation
 

package/dist/broadcastServer.d.ts

@@ -1,35 +1,9 @@
-/**
- * This file contains the BroadcastServer class.
- *
- * @file broadcastServer.ts
- * @author Luca Liguori
- * @created 2025-10-05
- * @version 2.0.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.
- */
 import { EventEmitter } from 'node:events';
 import { type AnsiLogger } from 'node-ansi-logger';
 import type { WorkerMessage, WorkerMessageRequest, WorkerMessageRequestAny, WorkerMessageResponse, WorkerMessageResponseSuccess, WorkerMessageTypes, WorkerSrcType } from './broadcastServerTypes.js';
 interface BroadcastServerEvents {
     'broadcast_message': [msg: WorkerMessage];
 }
-/**
- * BroadcastServer class to handle broadcast messages between workers with BroadcastChannel.
- */
 export declare class BroadcastServer extends EventEmitter<BroadcastServerEvents> {
     readonly name: WorkerSrcType;
     private readonly log;
@@ -38,107 +12,18 @@ export declare class BroadcastServer extends EventEmitter<BroadcastServerEvents>
     private closed;
     private readonly debug;
     private readonly verbose;
-    /**
-     * Creates an instance of BroadcastServer.
-     *
-     * @param {string} name - The name of the broadcast server.
-     * @param {AnsiLogger} log - The logger instance to use for logging.
-     * @param {string} channel - The channel name for the broadcast. Default is 'broadcast-channel'.
-     */
     constructor(name: WorkerSrcType, log: AnsiLogger, channel?: string);
-    /**
-     * Closes the broadcast channel.
-     *
-     * @returns {void}
-     */
     close(): void;
-    /**
-     * Handles incoming broadcast messages.
-     *
-     * @param {MessageEvent} event - The message event containing the broadcast message.
-     * @returns {void}
-     */
     private broadcastMessageHandler;
-    /**
-     * Handles incoming broadcast error messages.
-     *
-     * @param {MessageEvent} event - The message event containing the broadcast message.
-     * @returns {void}
-     */
     private broadcastMessageErrorHandler;
-    /**
-     * Generate a pseudo-random identifier between 100,000,000 and 999,999,999.
-     *
-     * @returns {number} A nine-digit identifier.
-     */
     getUniqueId(): number;
-    /**
-     * Type guard to verify a value matches the WorkerMessageRequest structure.
-     *
-     * @param {unknown} value Value to test.
-     * @returns {value is WorkerMessageRequest} True when the value looks like a request message.
-     */
     isWorkerRequest(value: unknown): value is WorkerMessageRequest;
-    /**
-     * Type guard to verify a value matches a specific WorkerMessageRequest structure.
-     *
-     * @param {unknown} value Value to test.
-     * @param {K} type Worker message type to match.
-     * @returns {value is WorkerMessageRequest<K>} True when the value looks like a request message of the requested type.
-     */
     isWorkerRequestOfType<K extends keyof WorkerMessageTypes>(value: unknown, type: K): value is WorkerMessageRequest<K>;
-    /**
-     * Type guard to verify a value matches the WorkerMessageResponse structure.
-     *
-     * @param {unknown} value Value to test.
-     * @returns {value is WorkerMessageResponse} True when the value looks like a response message.
-     */
     isWorkerResponse(value: unknown): value is WorkerMessageResponse;
-    /**
-     * Type guard to verify a value matches a specific WorkerMessageResponse structure.
-     *
-     * @param {unknown} value Value to test.
-     * @param {K} type Worker message type to match.
-     * @returns {value is WorkerMessageResponse<K>} True when the value looks like a response message of the requested type.
-     */
     isWorkerResponseOfType<K extends keyof WorkerMessageTypes>(value: unknown, type: K): value is WorkerMessageResponse<K>;
-    /**
-     * Broadcast a message to all workers.
-     *
-     * @param {WorkerMessage} message - The message to broadcast.
-     * @returns {void}
-     *
-     * @remarks No checks are performed on the message structure.
-     */
     broadcast(message: WorkerMessage): void;
-    /**
-     * Send a request message from the worker implementation.
-     *
-     * @template K
-     * @param {WorkerMessageRequest<K>} message The request message to send.
-     * @returns {void}
-     */
     request<K extends keyof WorkerMessageTypes>(message: WorkerMessageRequest<K>): void;
-    /**
-     * Send a response message from the worker implementation.
-     * It also calculates the elapsed time since the request was sent and swaps the source and destination fields.
-     *
-     * @template K
-     * @param {WorkerMessageResponse<K>} message The response message to send.
-     * @returns {void}
-     */
     respond<K extends keyof WorkerMessageTypes>(message: WorkerMessageResponse<K>): void;
-    /**
-     * Fetch data from a worker.
-     * It broadcasts a request message and waits for a valid response with the same id.
-     *
-     * @template K
-     * @param {WorkerMessageRequest<K>} message - The typed request message to fetch.
-     * @param {number} timeout - The timeout in milliseconds to wait for a response. Default is 250ms.
-     * @returns {Promise<WorkerMessageResponseSuccess<K>>} A promise that resolves with the successful response from the worker or rejects on timeout.
-     * @throws {Error} If the fetch operation times out after 250ms or if an error response is received or if the response is malformed.
-     */
     fetch<T extends WorkerMessageRequestAny, K extends Extract<keyof WorkerMessageTypes, T['type']>>(message: T, timeout?: number): Promise<WorkerMessageResponseSuccess<K>>;
 }
 export {};
-//# sourceMappingURL=broadcastServer.d.ts.map

package/dist/broadcastServer.js

@@ -1,36 +1,9 @@
-/**
- * This file contains the BroadcastServer class.
- *
- * @file broadcastServer.ts
- * @author Luca Liguori
- * @created 2025-10-05
- * @version 2.0.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.
- */
-// eslint-disable-next-line no-console
 if (process.argv.includes('--loader') || process.argv.includes('-loader'))
     console.log('\u001B[32mBroadcastServer loaded.\u001B[40;0m');
 import { EventEmitter } from 'node:events';
 import { BroadcastChannel } from 'node:worker_threads';
 import { CYAN, db, debugStringify, er } from 'node-ansi-logger';
 import { hasParameter, logError } from '@matterbridge/utils';
-/**
- * BroadcastServer class to handle broadcast messages between workers with BroadcastChannel.
- */
 export class BroadcastServer extends EventEmitter {
     name;
     log;
@@ -39,40 +12,21 @@ export class BroadcastServer extends EventEmitter {
     closed = false;
     debug = hasParameter('debug') || hasParameter('verbose');
     verbose = hasParameter('verbose');
-    /**
-     * Creates an instance of BroadcastServer.
-     *
-     * @param {string} name - The name of the broadcast server.
-     * @param {AnsiLogger} log - The logger instance to use for logging.
-     * @param {string} channel - The channel name for the broadcast. Default is 'broadcast-channel'.
-     */
     constructor(name, log, channel = 'broadcast-channel') {
         super();
         this.name = name;
         this.log = log;
         this.channel = channel;
         this.broadcastChannel = new BroadcastChannel(this.channel);
-        // this.broadcastChannel.unref();
         this.broadcastChannel.onmessage = this.broadcastMessageHandler.bind(this);
         this.broadcastChannel.onmessageerror = this.broadcastMessageErrorHandler.bind(this);
     }
-    /**
-     * Closes the broadcast channel.
-     *
-     * @returns {void}
-     */
     close() {
         this.broadcastChannel.onmessage = null;
         this.broadcastChannel.onmessageerror = null;
         this.broadcastChannel.close();
         this.closed = true;
     }
-    /**
-     * Handles incoming broadcast messages.
-     *
-     * @param {MessageEvent} event - The message event containing the broadcast message.
-     * @returns {void}
-     */
     broadcastMessageHandler(event) {
         const msg = event.data;
         if (msg.dst === this.name || msg.dst === 'all') {
@@ -85,30 +39,13 @@ export class BroadcastServer extends EventEmitter {
                 this.log.debug(`Server ${CYAN}${this.name}${db} received unrelated broadcast message: ${debugStringify(msg)}`);
         }
     }
-    /**
-     * Handles incoming broadcast error messages.
-     *
-     * @param {MessageEvent} event - The message event containing the broadcast message.
-     * @returns {void}
-     */
     broadcastMessageErrorHandler(event) {
         const msg = event.data;
         this.log.error(`Server ${CYAN}${this.name}${db} received message error: ${debugStringify(msg)}`);
     }
-    /**
-     * Generate a pseudo-random identifier between 100,000,000 and 999,999,999.
-     *
-     * @returns {number} A nine-digit identifier.
-     */
     getUniqueId() {
         return Math.floor(Math.random() * 900000000) + 100000000;
     }
-    /**
-     * Type guard to verify a value matches the WorkerMessageRequest structure.
-     *
-     * @param {unknown} value Value to test.
-     * @returns {value is WorkerMessageRequest} True when the value looks like a request message.
-     */
     isWorkerRequest(value) {
         if (typeof value !== 'object' || value === null) {
             return false;
@@ -119,22 +56,9 @@ export class BroadcastServer extends EventEmitter {
         }
         return message.result === undefined && message.error === undefined;
     }
-    /**
-     * Type guard to verify a value matches a specific WorkerMessageRequest structure.
-     *
-     * @param {unknown} value Value to test.
-     * @param {K} type Worker message type to match.
-     * @returns {value is WorkerMessageRequest<K>} True when the value looks like a request message of the requested type.
-     */
     isWorkerRequestOfType(value, type) {
         return this.isWorkerRequest(value) && value.type === type;
     }
-    /**
-     * Type guard to verify a value matches the WorkerMessageResponse structure.
-     *
-     * @param {unknown} value Value to test.
-     * @returns {value is WorkerMessageResponse} True when the value looks like a response message.
-     */
     isWorkerResponse(value) {
         if (typeof value !== 'object' || value === null) {
             return false;
@@ -147,24 +71,9 @@ export class BroadcastServer extends EventEmitter {
         const hasResult = message.result !== undefined;
         return hasError !== hasResult;
     }
-    /**
-     * Type guard to verify a value matches a specific WorkerMessageResponse structure.
-     *
-     * @param {unknown} value Value to test.
-     * @param {K} type Worker message type to match.
-     * @returns {value is WorkerMessageResponse<K>} True when the value looks like a response message of the requested type.
-     */
     isWorkerResponseOfType(value, type) {
         return this.isWorkerResponse(value) && value.type === type;
     }
-    /**
-     * Broadcast a message to all workers.
-     *
-     * @param {WorkerMessage} message - The message to broadcast.
-     * @returns {void}
-     *
-     * @remarks No checks are performed on the message structure.
-     */
     broadcast(message) {
         if (this.closed) {
             this.log.error('Broadcast channel is closed');
@@ -186,13 +95,6 @@ export class BroadcastServer extends EventEmitter {
             logError(this.log, `Failed to broadcast message ${debugStringify(message)}${er}`, error);
         }
     }
-    /**
-     * Send a request message from the worker implementation.
-     *
-     * @template K
-     * @param {WorkerMessageRequest<K>} message The request message to send.
-     * @returns {void}
-     */
     request(message) {
         if (this.closed) {
             this.log.error('Broadcast channel is closed');
@@ -218,14 +120,6 @@ export class BroadcastServer extends EventEmitter {
             logError(this.log, `Failed to broadcast request message ${debugStringify(message)}${er}`, error);
         }
     }
-    /**
-     * Send a response message from the worker implementation.
-     * It also calculates the elapsed time since the request was sent and swaps the source and destination fields.
-     *
-     * @template K
-     * @param {WorkerMessageResponse<K>} message The response message to send.
-     * @returns {void}
-     */
     respond(message) {
         if (this.closed) {
             this.log.error('Broadcast channel is closed');
@@ -254,16 +148,6 @@ export class BroadcastServer extends EventEmitter {
             logError(this.log, `Failed to broadcast response message ${debugStringify(message)}${er}`, error);
         }
     }
-    /**
-     * Fetch data from a worker.
-     * It broadcasts a request message and waits for a valid response with the same id.
-     *
-     * @template K
-     * @param {WorkerMessageRequest<K>} message - The typed request message to fetch.
-     * @param {number} timeout - The timeout in milliseconds to wait for a response. Default is 250ms.
-     * @returns {Promise<WorkerMessageResponseSuccess<K>>} A promise that resolves with the successful response from the worker or rejects on timeout.
-     * @throws {Error} If the fetch operation times out after 250ms or if an error response is received or if the response is malformed.
-     */
     async fetch(message, timeout = 250) {
         if (this.closed) {
             return Promise.reject(new Error('Broadcast channel is closed'));
@@ -304,4 +188,3 @@ export class BroadcastServer extends EventEmitter {
         });
     }
 }
-//# sourceMappingURL=broadcastServer.js.map

package/dist/broadcastServerTypes.d.ts

@@ -1,36 +1,10 @@
-/**
- * This file contains the BroadcastServer types.
- *
- * @file broadcastServerTypes.ts
- * @author Luca Liguori
- * @created 2025-10-05
- * @version 2.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 { LogLevel } from 'node-ansi-logger';
 import { EndpointNumber } from '@matter/types/datatype';
 import type { RefreshRequiredChanged, WsMessageBroadcast } from './frontendTypes.js';
 import type { PlatformConfig, PlatformMatterbridge, PlatformSchema } from './matterbridgePlatformTypes.js';
 import type { ApiMatter, ApiPlugin, BaseDevice, Plugin, SharedMatterbridge, StoragePlugin } from './matterbridgeTypes.js';
-/** Types of worker source */
 export type WorkerSrcType = 'manager' | 'matterbridge' | 'plugins' | 'devices' | 'frontend' | 'matter' | 'platform' | 'spawn' | 'updates';
-/** Types of worker destination */
 export type WorkerDstType = 'manager' | 'matterbridge' | 'plugins' | 'devices' | 'frontend' | 'matter' | 'platform' | 'spawn' | 'updates' | 'all';
-/** Normalized message request structure */
 type NormalizeRequest<T> = T extends {
     params: infer P;
 } ? ([P] extends [undefined] ? {
@@ -38,7 +12,6 @@ type NormalizeRequest<T> = T extends {
 } : {
     params: P;
 }) : Record<never, never>;
-/** Message request structure with id, timestamp, src and dst */
 type WorkerMessageRequestMap = {
     [K in keyof WorkerMessageTypes]: {
         type: K;
@@ -48,21 +21,16 @@ type WorkerMessageRequestMap = {
         dst: WorkerDstType;
     } & NormalizeRequest<WorkerMessageTypes[K]['request']>;
 };
-/** Message request structure with id, timestamp, src and dst */
 export type WorkerMessageRequest<K extends keyof WorkerMessageTypes = keyof WorkerMessageTypes> = WorkerMessageRequestMap[K];
-/** Normalized message response success structure that guarantees a successful result */
 type NormalizeResponseSuccess<T> = T & {
     error?: never;
 };
-/** Normalized message response error structure that guarantees an error-only payload */
 type NormalizeResponseError<T> = {
     error: string;
 } & {
     [K in keyof T]?: never;
 };
-/** Normalized message response structure */
 type NormalizeResponse<T> = NormalizeResponseSuccess<T> | NormalizeResponseError<T>;
-/** Message response structure with id, timestamp, elapsed, src and dst */
 type WorkerMessageResponseMap = {
     [K in keyof WorkerMessageTypes]: {
         type: K;
@@ -73,9 +41,7 @@ type WorkerMessageResponseMap = {
         dst: WorkerDstType;
     } & NormalizeResponse<WorkerMessageTypes[K]['response']>;
 };
-/** Message response structure with id, timestamp, elapsed, src and dst */
 export type WorkerMessageResponse<K extends keyof WorkerMessageTypes = keyof WorkerMessageTypes> = WorkerMessageResponseMap[K];
-/** Message response success structure that guarantees a successful result */
 type WorkerMessageResponseSuccessMap = {
     [K in keyof WorkerMessageTypes]: {
         type: K;
@@ -86,9 +52,7 @@ type WorkerMessageResponseSuccessMap = {
         dst: WorkerDstType;
     } & NormalizeResponseSuccess<WorkerMessageTypes[K]['response']>;
 };
-/** Message response success structure that guarantees a successful result */
 export type WorkerMessageResponseSuccess<K extends keyof WorkerMessageTypes = keyof WorkerMessageTypes> = WorkerMessageResponseSuccessMap[K];
-/** Message response error structure */
 type WorkerMessageResponseErrorMap = {
     [K in keyof WorkerMessageTypes]: {
         type: K;
@@ -99,17 +63,11 @@ type WorkerMessageResponseErrorMap = {
         dst: WorkerDstType;
     } & NormalizeResponseError<WorkerMessageTypes[K]['response']>;
 };
-/** Message response error structure */
 export type WorkerMessageResponseError<K extends keyof WorkerMessageTypes = keyof WorkerMessageTypes> = WorkerMessageResponseErrorMap[K];
-/** Convenience alias for any worker request */
 export type WorkerMessageRequestAny = WorkerMessageRequest<keyof WorkerMessageTypes>;
-/** Resolve a successful response type based on the originating request */
 export type WorkerMessageResponseSuccessForRequest<T extends WorkerMessageRequestAny> = WorkerMessageResponseSuccess<Extract<keyof WorkerMessageTypes, T['type']>>;
-/** Resolve an error response type based on the originating request */
 export type WorkerMessageResponseErrorForRequest<T extends WorkerMessageRequestAny> = WorkerMessageResponseError<Extract<keyof WorkerMessageTypes, T['type']>>;
-/** Union type for WorkerMessageRequest and WorkerMessageResponse */
 export type WorkerMessage<K extends keyof WorkerMessageTypes = keyof WorkerMessageTypes> = WorkerMessageRequest<K> | WorkerMessageResponse<K> | WorkerMessageResponseSuccess<K> | WorkerMessageResponseError<K>;
-/** Map of all worker message types with their request and response structures */
 export type WorkerMessageTypes = {
     'jest': {
         request: {
@@ -860,4 +818,3 @@ export type WorkerMessageTypes = {
     };
 };
 export {};
-//# sourceMappingURL=broadcastServerTypes.d.ts.map

package/dist/broadcastServerTypes.js

@@ -1,25 +1 @@
-/**
- * This file contains the BroadcastServer types.
- *
- * @file broadcastServerTypes.ts
- * @author Luca Liguori
- * @created 2025-10-05
- * @version 2.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.
- */
 export {};
-//# sourceMappingURL=broadcastServerTypes.js.map

package/dist/checkUpdates.d.ts

@@ -1,84 +1,9 @@
-/**
- * This file contains the check updates functions.
- *
- * @file checkUpdates.ts
- * @author Luca Liguori
- * @created 2025-02-24
- * @version 2.0.1
- * @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 { AnsiLogger } from 'node-ansi-logger';
 import { ApiPlugin, SharedMatterbridge } from './matterbridgeTypes.js';
 import { BroadcastServer } from './broadcastServer.js';
-/**
- * Checks for updates for Matterbridge and its plugins.
- * If the 'shelly' parameter is present, also checks for Shelly updates.
- *
- * @param {SharedMatterbridge} matterbridge - The Matterbridge instance.
- * @returns {Promise<void>} A promise that resolves when the update checks are complete.
- */
 export declare function checkUpdates(matterbridge: SharedMatterbridge): Promise<void>;
-/**
- * Checks for updates and logs from https://matterbridge.io/.
- * If the update check fails, logs a warning message.
- *
- * @param {SharedMatterbridge} matterbridge - The Matterbridge instance.
- * @param {AnsiLogger} log - The logger instance.
- * @param {BroadcastServer} server - The broadcast server instance.
- */
 export declare function checkUpdatesAndLog(matterbridge: SharedMatterbridge, log: AnsiLogger, server: BroadcastServer): Promise<void>;
-/**
- * Retrieves the latest version of Matterbridge and updates the matterbridgeLatestVersion property.
- * If there is an error retrieving the latest version, logs an error message.
- *
- * @param {SharedMatterbridge} matterbridge - The Matterbridge instance.
- * @param {AnsiLogger} log - The logger instance.
- * @param {BroadcastServer} server - The broadcast server instance.
- * @returns {Promise<string | undefined>} A promise that resolves when the latest version is retrieved.
- */
 export declare function getMatterbridgeLatestVersion(matterbridge: SharedMatterbridge, log: AnsiLogger, server: BroadcastServer): Promise<string | undefined>;
-/**
- * Retrieves the latest dev version of Matterbridge and updates the matterbridgeDevVersion property.
- * If there is an error retrieving the latest version, logs an error message.
- *
- * @param {SharedMatterbridge} matterbridge - The Matterbridge instance.
- * @param {AnsiLogger} log - The logger instance.
- * @param {BroadcastServer} server - The broadcast server instance.
- * @returns {Promise<string | undefined>} A promise that resolves when the latest dev version is retrieved.
- */
 export declare function getMatterbridgeDevVersion(matterbridge: SharedMatterbridge, log: AnsiLogger, server: BroadcastServer): Promise<string | undefined>;
-/**
- * Retrieves the latest version of a plugin and updates the plugin's latestVersion property.
- * If there is an error retrieving the latest version, logs an error message.
- *
- * @param {AnsiLogger} log - The logger instance.
- * @param {BroadcastServer} server - The broadcast server instance.
- * @param {ApiPlugin} plugin - The plugin for which to retrieve the latest version.
- * @returns {Promise<string | undefined>} A promise that resolves when the latest version is retrieved.
- */
 export declare function getPluginLatestVersion(log: AnsiLogger, server: BroadcastServer, plugin: ApiPlugin): Promise<string | undefined>;
-/**
- * Retrieves the latest dev version of a plugin and updates the plugin's devVersion property.
- * If there is an error retrieving the latest version, logs an error message.
- *
- * @param {AnsiLogger} log - The logger instance.
- * @param {BroadcastServer} server - The broadcast server instance.
- * @param {ApiPlugin} plugin - The plugin for which to retrieve the latest version.
- * @returns {Promise<string | undefined>} A promise that resolves when the latest dev version is retrieved.
- */
 export declare function getPluginDevVersion(log: AnsiLogger, server: BroadcastServer, plugin: ApiPlugin): Promise<string | undefined>;
-//# sourceMappingURL=checkUpdates.d.ts.map