matterbridge 3.3.7-dev-20251108-f254812 → 3.3.7

package/CHANGELOG.md

@@ -28,7 +28,7 @@ Advantages:
 - individual plugin isolation in childbridge mode;
 - ability to update the plugin in childbridge mode without restarting matterbridge;
 
-## [3.3.7] - 2025-11-07
+## [3.3.7] - 2025-11-08
 
 ### Breaking Changes
 
@@ -37,7 +37,7 @@ Advantages:
 ### Added
 
 - [matterbridge]: Added a first check for plugin existence (docker pull or Hass add-on rebuild) and reinstall it before parsing the plugin. The error messages have been removed.
-- [service]: Added [configuration](README-SERVICE-OPT.md) to run matterbridge as a daemon with systemctl (Linux only) and with private global node_modules (user matterbridge and no sudo required).
+- [service]: Added [configuration](README-SERVICE-OPT.md) to run matterbridge as a daemon with systemctl (Linux only), private global node_modules, user/group matterbridge and no sudo required.
 
 ### Changed
 

package/README-SERVICE-OPT.md

@@ -20,14 +20,16 @@
 
 The advantage of this setup is that the global node_modules are private for matterbridge and sudo is not required.
 
-The service runs with user matterbridge and the system has full protection.
+The service runs with group and user matterbridge and the system has full protection.
 
 The storage position is **not compatible** with the traditional setup (~/Matterbridge ~/.matterbridge ~/.mattercert).
 
 ### 1 - Create the matterbridge user and group
 
 ```bash
+# ✅ Create the matterbridge group
 sudo groupadd --system matterbridge 2>/dev/null || true
+# ✅ Create the matterbridge user
 sudo useradd  --system \
   --home-dir /opt/matterbridge \
   --shell /usr/sbin/nologin \
@@ -42,10 +44,10 @@ This will create the required directories if they don't exist
 ```bash
 cd ~
 # ✅ Safe precaution if matterbridge was already running with the traditional setup
-sudo systemctl stop matterbridge
-# ✅ We need to uninstall from the global node_modules
-sudo npm uninstall matterbridge -g
-# ✅ Creates all needed dirs
+sudo systemctl stop matterbridge 2>/dev/null || true
+# ✅ Safe precaution we need to uninstall from the global node_modules
+sudo npm uninstall matterbridge -g 2>/dev/null || true
+# ✅ Creates all required directories
 sudo mkdir -p /opt/matterbridge /opt/matterbridge/Matterbridge /opt/matterbridge/.matterbridge /opt/matterbridge/.mattercert /opt/matterbridge/.npm-global
 # ✅ Ensures ownership
 sudo chown -R matterbridge:matterbridge /opt/matterbridge /opt/matterbridge/Matterbridge /opt/matterbridge/.matterbridge /opt/matterbridge/.mattercert /opt/matterbridge/.npm-global
@@ -55,7 +57,7 @@ sudo chmod -R 755 /opt/matterbridge /opt/matterbridge/Matterbridge /opt/matterbr
 sudo -u matterbridge mkdir -p /opt/matterbridge/.npm-global/bin
 # ✅ Install matterbridge in the private global node_modules
 sudo -u matterbridge NPM_CONFIG_PREFIX=/opt/matterbridge/.npm-global npm install matterbridge --omit=dev --verbose --global
-# ✅ Create a link to matterbridge bin
+# ✅ Create a link to matterbridge bins
 sudo ln -sf /opt/matterbridge/.npm-global/bin/matterbridge /usr/bin/matterbridge
 sudo ln -sf /opt/matterbridge/.npm-global/bin/mb_mdns /usr/bin/mb_mdns
 sudo ln -sf /opt/matterbridge/.npm-global/bin/mb_coap /usr/bin/mb_coap
@@ -69,7 +71,21 @@ matterbridge --version
 
 The storage position is **not compatible** with the traditional setup (~/Matterbridge ~/.matterbridge ~/.mattercert).
 
-You may want to copy the contents to the new directories.
+If you are migrating from the traditional service setup, before removing the old diretories, you may want to copy the contents of ~/Matterbridge ~/.matterbridge ~/.mattercert to the new directories /opt/matterbridge/Matterbridge /opt/matterbridge/.matterbridge /opt/matterbridge/.mattercert.
+
+Copy the old diretories content
+
+```bash
+sudo cp -a ~/Matterbridge/. /opt/matterbridge/Matterbridge/
+sudo cp -a ~/.matterbridge/. /opt/matterbridge/.matterbridge/
+sudo cp -a ~/.mattercert/. /opt/matterbridge/.mattercert/
+```
+
+Remove the old diretories
+
+```bash
+sudo rm -rf ~/Matterbridge ~/.matterbridge ~/.mattercert ~/.npm-global
+```
 
 ### 3 - Create a systemctl configuration file for Matterbridge
 

package/dist/broadcastServer.d.ts

@@ -0,0 +1,115 @@
+/**
+ * This file contains the BroadcastServer class.
+ *
+ * @file broadcastServer.ts
+ * @author Luca Liguori
+ * @created 2025-10-05
+ * @version 1.0.2
+ * @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, WorkerMessageType, WorkerRequest, WorkerResponse, 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;
+    /**
+     * Generates a unique ID with range 100000-999999.
+     *
+     * @returns {number} - A unique ID between 100000 and 999999
+     */
+    getUniqueId(): number;
+    /**
+     * Type guard to check if a message is a request of a specific type.
+     *
+     * @param {unknown} msg - The message to check.
+     * @param {T} type - The type to check against.
+     * @returns {msg is WorkerRequest<T>} True if the message is a request of the specified type.
+     */
+    isWorkerRequest<T extends WorkerMessageType>(msg: unknown, type: T): msg is WorkerRequest<T>;
+    /**
+     * Type guard to check if a message is a response of a specific type.
+     *
+     * @param {unknown} msg - The message to check.
+     * @param {T} type - The type to check against.
+     * @returns {msg is WorkerResponse<T>} True if the message is a response of the specified type.
+     */
+    isWorkerResponse<T extends WorkerMessageType>(msg: unknown, type: T): msg is WorkerResponse<T>;
+    /**
+     * 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.
+     */
+    broadcast(message: WorkerMessage): void;
+    /**
+     * Broadcast a request message to all workers.
+     *
+     * @param {WorkerRequest<T>} message - The typed request message to broadcast.
+     * @returns {void}
+     */
+    request<M extends WorkerRequest<WorkerMessageType>>(message: M): void;
+    /**
+     * Broadcast a response message to all workers.
+     *
+     * @param {WorkerResponse<T>} message - The typed response message to broadcast.
+     * @returns {void}
+     */
+    respond<M extends WorkerResponse<WorkerMessageType>>(message: M): void;
+    /**
+     * Fetch data from a worker.
+     * It broadcasts a request message and waits for a response with the same id.
+     *
+     * @param {WorkerRequest<T>} message - The typed request message to broadcast.
+     * @param {number} timeout - The timeout in milliseconds to wait for a response. Default is 100ms.
+     * @returns {Promise<WorkerResponse<T>>} A promise that resolves with the response from the worker or rejects on timeout.
+     * @throws {Error} If the fetch operation times out after 100ms.
+     */
+    fetch<M extends WorkerRequest<WorkerMessageType>>(message: M, timeout?: number): Promise<WorkerResponse<M['type']>>;
+}
+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,EAAkB,MAAM,kBAAkB,CAAC;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGhI,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;IAOxD;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;;;OAMG;IACH,eAAe,CAAC,CAAC,SAAS,iBAAiB,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,GAAG,IAAI,aAAa,CAAC,CAAC,CAAC;IAI5F;;;;;;OAMG;IACH,gBAAgB,CAAC,CAAC,SAAS,iBAAiB,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,GAAG,IAAI,cAAc,CAAC,CAAC,CAAC;IAI9F;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAM/B;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,aAAa;IAKhC;;;;;OAKG;IACH,OAAO,CAAC,CAAC,SAAS,aAAa,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI;IAerE;;;;;OAKG;IACH,OAAO,CAAC,CAAC,SAAS,cAAc,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI;IAYtE;;;;;;;;OAQG;IACG,KAAK,CAAC,CAAC,SAAS,aAAa,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAE,MAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;CA4B/H"}

package/dist/broadcastServer.js

@@ -1,9 +1,36 @@
+/**
+ * This file contains the BroadcastServer class.
+ *
+ * @file broadcastServer.ts
+ * @author Luca Liguori
+ * @created 2025-10-05
+ * @version 1.0.2
+ * @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 { debugStringify } from 'node-ansi-logger';
 import { hasParameter } from './utils/commandLine.js';
+/**
+ * BroadcastServer class to handle broadcast messages between workers with BroadcastChannel.
+ */
 export class BroadcastServer extends EventEmitter {
     name;
     log;
@@ -11,6 +38,13 @@ 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;
@@ -19,30 +53,72 @@ export class BroadcastServer extends EventEmitter {
         this.broadcastChannel = new BroadcastChannel(this.channel);
         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();
     }
+    /**
+     * Generates a unique ID with range 100000-999999.
+     *
+     * @returns {number} - A unique ID between 100000 and 999999
+     */
     getUniqueId() {
-        return Math.floor(Math.random() * (999999 - 100000 + 1)) + 100000;
+        return Math.floor(Math.random() * (999999 - 100000 + 1)) + 100000; // random int between 100000 and 999999
     }
+    /**
+     * Type guard to check if a message is a request of a specific type.
+     *
+     * @param {unknown} msg - The message to check.
+     * @param {T} type - The type to check against.
+     * @returns {msg is WorkerRequest<T>} True if the message is a request of the specified type.
+     */
     isWorkerRequest(msg, type) {
         return typeof msg === 'object' && msg !== null && 'id' in msg && 'timestamp' in msg && 'type' in msg && msg.type === type && !('response' in msg) && 'src' in msg && 'dst' in msg;
     }
+    /**
+     * Type guard to check if a message is a response of a specific type.
+     *
+     * @param {unknown} msg - The message to check.
+     * @param {T} type - The type to check against.
+     * @returns {msg is WorkerResponse<T>} True if the message is a response of the specified type.
+     */
     isWorkerResponse(msg, type) {
         return typeof msg === 'object' && msg !== null && 'id' in msg && 'timestamp' in msg && 'type' in msg && msg.type === type && 'response' in msg && 'src' in msg && 'dst' in msg;
     }
+    /**
+     * Handles incoming broadcast messages.
+     *
+     * @param {MessageEvent} event - The message event containing the broadcast message.
+     * @returns {void}
+     */
     broadcastMessageHandler(event) {
         const data = event.data;
         if (this.verbose)
             this.log.debug(`Received broadcast message: ${debugStringify(data)}`);
         this.emit('broadcast_message', data);
     }
+    /**
+     * Broadcast a message to all workers.
+     *
+     * @param {WorkerMessage} message - The message to broadcast.
+     */
     broadcast(message) {
         if (this.verbose)
             this.log.debug(`Broadcasting message: ${debugStringify(message)}`);
         this.broadcastChannel.postMessage(message);
     }
+    /**
+     * Broadcast a request message to all workers.
+     *
+     * @param {WorkerRequest<T>} message - The typed request message to broadcast.
+     * @returns {void}
+     */
     request(message) {
         if (message.id === undefined) {
             message.id = this.getUniqueId();
@@ -58,6 +134,12 @@ export class BroadcastServer extends EventEmitter {
             this.log.debug(`Broadcasting request message: ${debugStringify(message)}`);
         this.broadcastChannel.postMessage(message);
     }
+    /**
+     * Broadcast a response message to all workers.
+     *
+     * @param {WorkerResponse<T>} message - The typed response message to broadcast.
+     * @returns {void}
+     */
     respond(message) {
         if (message.timestamp === undefined) {
             message.timestamp = Date.now();
@@ -70,6 +152,15 @@ export class BroadcastServer extends EventEmitter {
             this.log.debug(`Broadcasting response message: ${debugStringify(message)}`);
         this.broadcastChannel.postMessage(message);
     }
+    /**
+     * Fetch data from a worker.
+     * It broadcasts a request message and waits for a response with the same id.
+     *
+     * @param {WorkerRequest<T>} message - The typed request message to broadcast.
+     * @param {number} timeout - The timeout in milliseconds to wait for a response. Default is 100ms.
+     * @returns {Promise<WorkerResponse<T>>} A promise that resolves with the response from the worker or rejects on timeout.
+     * @throws {Error} If the fetch operation times out after 100ms.
+     */
     async fetch(message, timeout = 100) {
         if (message.id === undefined) {
             message.id = this.getUniqueId();
@@ -98,3 +189,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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"}