matterbridge 3.4.1-dev-20251130-cfb291e → 3.4.1

package/CHANGELOG.md

@@ -14,12 +14,13 @@ The project will evolve to a multi-threaded architecture (the CLI will become th
 - frontend;
 - plugins;
 - devices;
-- check updates;
-- npm install;
-- ✅ get global node_modules;
 - all plugins in bridge mode;
 - each plugin in childbridge mode;
 
+- check updates;
+- npm install;
+- ✅ get the global node_modules directory;
+
 Advantages:
 
 - real concurrency outside the Node.js main loop;
@@ -27,23 +28,23 @@ Advantages:
 - individual plugin isolation in childbridge mode;
 - ability to update the plugin in childbridge mode without restarting matterbridge;
 
-## [3.4.1] - 2025-11-30
+## [3.4.1] - 2025-12-01
 
 ### Added
 
 - [matterbridge.io]: Updated website https://matterbridge.io with all guides.
 - [matterbridge]: Added addVirtualEndpoint() to match Matterbridge thread module.
 - [BroadcastServer]: Backport BroadcastServer v.2.0.0 from Matterbridge thread module.
-- [MatterbridgePrefix]: Added worker **thread** to get global node_modules.
-- [PluginManager]: Improved the resolve method to resolve automatically also in the plugin directory Usefull for developing with DevContainer.
+- [MatterbridgePrefix]: Added **worker thread** to get the global node_modules.
+- [PluginManager]: Improved the resolve method to resolve automatically also in the plugin directory. Usefull for developing with DevContainer.
 
 ### Changed
 
 - [package]: Updated dependencies.
 - [frontend]: Updated dependencies.
-- [frontend]: Bumped `frontend` version to 3.3.2.
-- [platform]: Bumped MatterbridgePlatform v.1.5.0.
-- [thread]: Bump BroadcastServer to v1.0.4.
+- [frontend]: Bumped `frontend` version to v.3.3.2.
+- [platform]: Bumped `MatterbridgePlatform` v.1.6.0.
+- [thread]: Bump `BroadcastServer` to v.2.0.0.
 - [updates]: The update availability check now starts after 5 minutes and each 12 hours. It can also be triggered from the frontend.
 
 ### Fixed

package/README-SERVICE-OPT.md

@@ -114,6 +114,7 @@ Wants=network.target
 Type=simple
 Environment=NODE_ENV=production
 Environment="NPM_CONFIG_PREFIX=/opt/matterbridge/.npm-global"
+Environment="NPM_CONFIG_CACHE=/opt/matterbridge/.npm-cache"
 ExecStart=matterbridge --service --nosudo
 WorkingDirectory=/opt/matterbridge/Matterbridge
 StandardOutput=inherit

package/dist/broadcastServer.d.ts

@@ -0,0 +1,136 @@
+/**
+ * This file contains the BroadcastServer class.
+ *
+ * @file broadcastServer.ts
+ * @author Luca Liguori
+ * @created 2025-10-05
+ * @version 2.0.0
+ * @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;
+    private readonly channel;
+    private readonly broadcastChannel;
+    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;
+    /**
+     * 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>;
+    /**
+     * Handles incoming broadcast messages.
+     *
+     * @param {MessageEvent} event - The message event containing the broadcast message.
+     * @returns {void}
+     */
+    private broadcastMessageHandler;
+    /**
+     * 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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcastServer.d.ts","sourceRoot":"","sources":["../src/broadcastServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,KAAK,UAAU,EAAgC,MAAM,kBAAkB,CAAC;AAEjF,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAItM,UAAU,qBAAqB;IAC7B,mBAAmB,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY,CAAC,qBAAqB,CAAC;IAapE,QAAQ,CAAC,IAAI,EAAE,aAAa;IAC5B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAd1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoD;IAC1E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IAEnD;;;;;;OAMG;gBAEQ,IAAI,EAAE,aAAa,EACX,GAAG,EAAE,UAAU,EACf,OAAO,GAAE,MAA4B;IAQxD;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;;OAKG;IACH,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB;IAa9D;;;;;;OAMG;IACH,qBAAqB,CAAC,CAAC,SAAS,MAAM,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,IAAI,oBAAoB,CAAC,CAAC,CAAC;IAIpH;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB;IAehE;;;;;;OAMG;IACH,sBAAsB,CAAC,CAAC,SAAS,MAAM,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,IAAI,qBAAqB,CAAC,CAAC,CAAC;IAItH;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAU/B;;;;;;;OAOG;IACH,SAAS,CAAC,OAAO,EAAE,aAAa;IAgBhC;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,SAAS,MAAM,kBAAkB,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,IAAI;IAoBnF;;;;;;;OAOG;IACH,OAAO,CAAC,CAAC,SAAS,MAAM,kBAAkB,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI;IAuBpF;;;;;;;;;OASG;IACG,KAAK,CAAC,CAAC,SAAS,uBAAuB,EAAE,CAAC,SAAS,OAAO,CAAC,MAAM,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAE,MAAY,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC;CAmCpL"}

package/dist/broadcastServer.js

@@ -1,3 +1,27 @@
+/**
+ * This file contains the BroadcastServer class.
+ *
+ * @file broadcastServer.ts
+ * @author Luca Liguori
+ * @created 2025-10-05
+ * @version 2.0.0
+ * @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';
@@ -5,6 +29,9 @@ import { BroadcastChannel } from 'node:worker_threads';
 import { CYAN, db, debugStringify, er } from 'node-ansi-logger';
 import { hasParameter } from './utils/commandLine.js';
 import { logError } from './utils/error.js';
+/**
+ * BroadcastServer class to handle broadcast messages between workers with BroadcastChannel.
+ */
 export class BroadcastServer extends EventEmitter {
     name;
     log;
@@ -12,22 +39,46 @@ export class BroadcastServer extends EventEmitter {
     broadcastChannel;
     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.unref();
         this.broadcastChannel.onmessage = this.broadcastMessageHandler.bind(this);
     }
+    /**
+     * Closes the broadcast channel.
+     *
+     * @returns {void}
+     */
     close() {
+        // @ts-expect-error: wrong type definition in node.d.ts
         this.broadcastChannel.onmessage = null;
         this.broadcastChannel.close();
     }
+    /**
+     * 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;
@@ -38,9 +89,22 @@ 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;
@@ -53,9 +117,22 @@ 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;
     }
+    /**
+     * 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') {
@@ -68,6 +145,14 @@ export class BroadcastServer extends EventEmitter {
                 this.log.debug(`Server ${CYAN}${this.name}${db} received unrelated broadcast message: ${debugStringify(msg)}`);
         }
     }
+    /**
+     * 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 (message.id === undefined) {
             message.id = this.getUniqueId();
@@ -85,6 +170,13 @@ 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 (message.id === undefined) {
             message.id = this.getUniqueId();
@@ -106,6 +198,14 @@ 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 (typeof message.timestamp === 'number') {
             message.elapsed = Date.now() - message.timestamp;
@@ -130,6 +230,16 @@ 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 (message.id === undefined) {
             message.id = this.getUniqueId();
@@ -167,3 +277,4 @@ export class BroadcastServer extends EventEmitter {
         });
     }
 }
+//# sourceMappingURL=broadcastServer.js.map

package/dist/broadcastServer.js.map

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