matterbridge 3.3.0-dev-20251004-43d8106 → 3.3.1-dev-20251007-4e5eaac

package/CHANGELOG.md

@@ -23,7 +23,35 @@ Advantages:
 - isolation between threads;
 - individual plugin isolation in childbridge mode;
 
-## [3.3.0] - Not released
+## [3.3.1] - Not released
+
+### Breaking Changes
+
+- [frontend]: When a plugin is first installed, it will not be anymore started to allow to configure it before restarting.
+- [index]: Removed old plugin api compatibility since it was changed one year ago.
+
+### Added
+
+- [network]: Added getInterfaceDetails() function.
+- [network]: Added getInterfaceName() function.
+- [network]: Optimized code.
+- [matterbridge]: Added SharedMatterbridge readonly type.
+- [thread]: Add BroadcastServer to frontend plugins and devices.
+
+### Changed
+
+- [package]: Updated dependencies.
+- [matterbridge]: Removed matterbridgeInformation. It will be recreated when the frontend requires it.
+- [frontend]: Bumped `frontend` version to 3.2.1.
+- [frontend]: Refactored InstallProgressDialog.
+- [spawn]: Refactored spawnCommand for compatibility with InstallProgressDialog.
+- [matter.js]: Bumped `matter.js` to 0.15.5. Thanks matter.js!
+
+<a href="https://www.buymeacoffee.com/luligugithub">
+  <img src="bmc-button.svg" alt="Buy me a coffee" width="80">
+</a>
+
+## [3.3.0] - 2025-10-03
 
 ### Development Breaking Changes Notice
 
@@ -98,8 +126,6 @@ In this phase (matterbridge `3.4.x`) all plugins will not build and will not run
 - [package]: Updated dependencies.
 - [frontend]: General improvements and small bug fixes.
 
-### Fixed
-
 <a href="https://www.buymeacoffee.com/luligugithub">
   <img src="bmc-button.svg" alt="Buy me a coffee" width="80">
 </a>

package/README.md

@@ -78,10 +78,14 @@ After follow the guidelines for the [Docker configurations](README-DOCKER.md).
 
 I suggest using Docker for its simplicity.
 
-Since as stated in the Matter specifications "Matter aims to build a universal IPv6-based communication protocol for smart home devices", ipv6 should be enabled in the network.
+Since Matter is designed as "a universal IPv6-based communication protocol for smart home devices" (per the Matter specifications), **IPv6 must be enabled on your local network (LAN)**.
+
+**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 and firewall blocking the communications between the controllers and Matterbridge.
 
+To pair matterbridge, you need a matter enabled controller (Apple Home, Smart Things, Google Home, Alexa, Hose Assistant etc.).
+
 ## Installation
 
 Follow these steps to install Matterbridge:
@@ -574,3 +578,7 @@ Click on the badge below to get started:
 </a>
 
 Thank you for your support!
+
+# Licensing
+
+Matterbridge is licensed under the [Apache License 2.0](./LICENSE).

package/dist/broadcastServer.js

@@ -0,0 +1,73 @@
+import { EventEmitter } from 'node:events';
+import { BroadcastChannel } from 'node:worker_threads';
+import { debugStringify } from 'node-ansi-logger';
+export class BroadcastServer extends EventEmitter {
+    name;
+    log;
+    channel;
+    broadcastChannel;
+    constructor(name, log, channel = 'broadcast-channel') {
+        super();
+        this.name = name;
+        this.log = log;
+        this.channel = channel;
+        this.broadcastChannel = new BroadcastChannel(this.channel);
+        this.broadcastChannel.onmessage = this.broadcastMessageHandler.bind(this);
+    }
+    close() {
+        this.broadcastChannel.onmessage = null;
+        this.broadcastChannel.close();
+    }
+    getUniqueId() {
+        return Math.floor(Math.random() * (999999 - 100000 + 1)) + 100000;
+    }
+    isWorkerRequest(msg, type) {
+        return typeof msg === 'object' && msg !== null && 'id' in msg && 'type' in msg && msg.type === type && !('response' in msg) && 'src' in msg && 'dst' in msg;
+    }
+    isWorkerResponse(msg, type) {
+        return typeof msg === 'object' && msg !== null && 'id' in msg && 'type' in msg && msg.type === type && 'response' in msg && 'src' in msg && 'dst' in msg;
+    }
+    broadcastMessageHandler(event) {
+        const data = event.data;
+        this.log.debug(`*Received broadcast message: ${debugStringify(data)}`);
+        this.emit('broadcast_message', data);
+    }
+    request(message) {
+        if (message.id === undefined) {
+            message.id = this.getUniqueId();
+        }
+        if (!this.isWorkerRequest(message, message.type)) {
+            this.log.error(`Invalid request message format for broadcast: ${debugStringify(message)}`);
+            return;
+        }
+        this.log.debug(`*Broadcasting message: ${debugStringify(message)}`);
+        this.broadcastChannel.postMessage(message);
+    }
+    respond(message) {
+        if (!this.isWorkerResponse(message, message.type)) {
+            this.log.error(`Invalid response message format for broadcast: ${debugStringify(message)}`);
+            return;
+        }
+        this.log.debug(`*Broadcasting message: ${debugStringify(message)}`);
+        this.broadcastChannel.postMessage(message);
+    }
+    async fetch(message) {
+        this.log.debug(`*Fetching message: ${debugStringify(message)}`);
+        return new Promise((resolve, reject) => {
+            const responseHandler = (msg) => {
+                if (this.isWorkerResponse(msg, message.type) && msg.id === message.id) {
+                    clearTimeout(timeoutId);
+                    this.off('broadcast_message', responseHandler);
+                    this.log.debug(`*Fetch response: ${debugStringify(msg)}`);
+                    resolve(msg);
+                }
+            };
+            this.on('broadcast_message', responseHandler);
+            this.request(message);
+            const timeoutId = setTimeout(() => {
+                this.off('broadcast_message', responseHandler);
+                reject(new Error(`Fetch timeout after 100ms for message id ${message.id}`));
+            }, 100);
+        });
+    }
+}

package/dist/broadcastServerTypes.js

@@ -0,0 +1 @@
+export {};

package/dist/deviceManager.js

@@ -1,13 +1,52 @@
-import { AnsiLogger, BLUE, er } from 'node-ansi-logger';
+import { AnsiLogger, BLUE, CYAN, db, debugStringify, er, wr } from 'node-ansi-logger';
 import { dev } from './matterbridgeTypes.js';
+import { BroadcastServer } from './broadcastServer.js';
 export class DeviceManager {
     _devices = new Map();
-    matterbridge;
     log;
-    constructor(matterbridge) {
-        this.matterbridge = matterbridge;
-        this.log = new AnsiLogger({ logName: 'DeviceManager', logTimestampFormat: 4, logLevel: matterbridge.log.logLevel });
+    server;
+    constructor() {
+        this.log = new AnsiLogger({ logName: 'DeviceManager', logTimestampFormat: 4, logLevel: "info" });
         this.log.debug('Matterbridge device manager starting...');
+        this.server = new BroadcastServer('devices', this.log);
+        this.server.on('broadcast_message', this.msgHandler.bind(this));
+        this.log.debug('Matterbridge device manager started');
+    }
+    destroy() {
+        this.server.close();
+    }
+    async msgHandler(msg) {
+        if (!this.server.isWorkerRequest(msg, msg.type))
+            return;
+        if (!msg.id || (msg.dst !== 'all' && msg.dst !== 'devices'))
+            return;
+        this.log.debug(`**Received request message ${CYAN}${msg.type}${db} from ${CYAN}${msg.src}${db}: ${debugStringify(msg)}${db}`);
+        switch (msg.type) {
+            case 'devices_length':
+                this.server.respond({ ...msg, id: msg.id, response: { length: this.length } });
+                break;
+            case 'devices_size':
+                this.server.respond({ ...msg, id: msg.id, response: { size: this.size } });
+                break;
+            case 'devices_has':
+                this.server.respond({ ...msg, id: msg.id, response: { has: this.has(msg.params.uniqueId) } });
+                break;
+            case 'devices_get':
+                this.server.respond({ ...msg, id: msg.id, response: { device: this.get(msg.params.uniqueId) } });
+                break;
+            case 'devices_set':
+                this.server.respond({ ...msg, id: msg.id, response: { device: this.set(msg.params.device) } });
+                break;
+            case 'devices_remove':
+                this.server.respond({ ...msg, id: msg.id, response: { success: this.remove(msg.params.device) } });
+                break;
+            case 'devices_clear':
+                this.clear();
+                this.server.respond({ ...msg, id: msg.id, response: { success: true } });
+                break;
+            default:
+                this.log.warn(`Unknown broadcast message ${CYAN}${msg.type}${wr} from ${CYAN}${msg.src}${wr}`);
+        }
     }
     get length() {
         return this._devices.size;