matterbridge 3.4.5-dev-20251224-ea793b4 → 3.4.5-dev-20251225-2f72161

package/CHANGELOG.md

@@ -39,6 +39,9 @@ Advantages:
 - [mdns]: Added TXT/SRV/A/AAAA encoders into the Mdns class.
 - [mb_mdns]: Added broadcast parameter to allow advertising when multicast is not available.
 - [mb_mdns]: Added \_matterbridge.\_tcp.local to query and advertise.
+- [mb_mdns]: Added localhost parameter to send unicast messages to localhost.
+- [mb_mdns]: Added unicastIpv4 parameter to send unicast messages.
+- [mb_mdns]: Added unicastIpv6 parameter to send unicast messages.
 
 ### Changed
 

package/dist/dgram/mb_mdns.js

@@ -1,6 +1,7 @@
 import { getIntParameter, getParameter, getStringArrayParameter, hasParameter } from '../utils/commandLine.js';
 import { MDNS_MULTICAST_IPV4_ADDRESS, MDNS_MULTICAST_IPV6_ADDRESS, MDNS_MULTICAST_PORT } from './multicast.js';
 import { Mdns } from './mdns.js';
+import { Unicast } from './unicast.js';
 {
     if (hasParameter('h') || hasParameter('help')) {
         console.log(`Copyright (c) Matterbridge. All rights reserved.\n`);
@@ -15,6 +16,10 @@ Options:
   --ipv6InterfaceAddress <address>          IPv6 address of the network interface to bind to (default: ::).
   --outgoingIpv4InterfaceAddress <address>  Outgoing IPv4 address of the network interface (default first external address).
   --outgoingIpv6InterfaceAddress <address>  Outgoing IPv6 address of the network interface (default first external address).
+  --unicastIpv4 <address>                   Unicast IPv4 address to send mDNS advertisements to (default: disabled).
+  --unicastIpv6 <address>                   Unicast IPv6 address to send mDNS advertisements to (default: disabled).
+  --broadcast                               Enable broadcasting of mDNS advertisements (default: disabled).
+  --localhost                               Enable sending mDNS advertisements to localhost (default: disabled).
   --advertise <interval>                    Enable matterbridge mDNS advertisement each ms (default interval: 10000ms).
   --query <interval>                        Enable common mDNS services query each ms (default interval: 10000ms).
   --filter <string...>                      Filter strings to match in the mDNS record name (default: no filter).
@@ -33,25 +38,31 @@ Examples:
   # Query for mDNS devices every 10s on a specific interface
   mb_mdns --interfaceName eth0 --query
 
-  # Advertise matterbridge._http._tcp.local every 5s with filter
-  mb_mdns --advertise 5000 --filter matterbridge._http._tcp.local
-
-  # Query each 5s and listen for matterbridge._http._tcp.local service records
-  mb_mdns --query 5000 --filter matterbridge._http._tcp.local
+  # Advertise _matterbridge._tcp.local every 5s with filter
+  mb_mdns --advertise 5000 --filter _matterbridge._tcp.local
 
+  # Query each 5s and listen for _matterbridge._tcp.local service records
+  mb_mdns --query 5000 --filter _matterbridge._tcp.local
 `);
         process.exit(0);
     }
     const { default: pkg } = await import('../../package.json', { with: { type: 'json' } });
+    let mdnsIpv4QueryInterval;
+    let mdnsIpv6QueryInterval;
+    let mdnsIpv4AdvertiseInterval;
+    let mdnsIpv6AdvertiseInterval;
     const 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'));
     const mdnsIpv6 = new Mdns('mDNS Server udp6', MDNS_MULTICAST_IPV6_ADDRESS, MDNS_MULTICAST_PORT, 'udp6', true, getParameter('interfaceName'), getParameter('ipv6InterfaceAddress') || '::', getParameter('outgoingIpv6InterfaceAddress'));
+    const unicast = new Unicast('mDNS Unicast Server', 'udp4', true, undefined, 'localhost', MDNS_MULTICAST_PORT);
     if (hasParameter('v') || hasParameter('verbose')) {
         mdnsIpv4.log.logLevel = "debug";
         mdnsIpv6.log.logLevel = "debug";
+        unicast.log.logLevel = "debug";
     }
     else {
         mdnsIpv4.log.logLevel = "info";
         mdnsIpv6.log.logLevel = "info";
+        unicast.log.logLevel = "info";
     }
     mdnsIpv4.listNetworkInterfaces();
     const filters = getStringArrayParameter('filter');
@@ -65,8 +76,13 @@ Examples:
             advertise(mdnsIpv6, 0);
         }
         await new Promise((resolve) => setTimeout(resolve, 250));
+        clearInterval(mdnsIpv4QueryInterval);
+        clearInterval(mdnsIpv6QueryInterval);
+        clearInterval(mdnsIpv4AdvertiseInterval);
+        clearInterval(mdnsIpv6AdvertiseInterval);
         mdnsIpv4.stop();
         mdnsIpv6.stop();
+        unicast.stop();
         await new Promise((resolve) => setTimeout(resolve, 250));
         mdnsIpv4.logDevices();
         mdnsIpv6.logDevices();
@@ -79,6 +95,7 @@ Examples:
             { name: '_matter._tcp.local', type: 12, class: 1, unicastResponse: true },
             { name: '_matterbridge._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: '_services._dns-sd._udp.local', type: 12, class: 1, unicastResponse: true },
         ]);
@@ -131,13 +148,13 @@ Examples:
                 const address = mdns.socketType === 'udp4' ? mdns.getIpv4InterfaceAddress(mdns.interfaceName) : mdns.getIpv6InterfaceAddress(mdns.interfaceName);
                 const mask = mdns.socketType === 'udp4' ? mdns.getNetmask(address) : undefined;
                 const broadcastAddress = mdns.socketType === 'udp4' ? mdns.getIpv4BroadcastAddress(address, mask) : mdns.getIpv6BroadcastAddress();
-                mdns.log.info(`Broadcasting mDNS advertisement for matterbridge service to ${broadcastAddress}...`);
-                mdns.socket.send(response, 0, response.length, mdns.multicastPort, broadcastAddress, (error) => {
+                mdns.log.info(`***Broadcasting mDNS advertisement for matterbridge service to ${broadcastAddress}...`);
+                mdns.socket.send(response, 0, response.length, MDNS_MULTICAST_PORT, broadcastAddress, (error) => {
                     if (error) {
-                        mdns.log.error(`Error broadcasting mDNS advertisement: ${error.message}`);
+                        mdns.log.error(`Error broadcasting mDNS advertisement to ${broadcastAddress}: ${error.message}`);
                     }
                     else {
-                        mdns.log.info(`mDNS advertisement broadcasted successfully to ${broadcastAddress}`);
+                        mdns.log.info(`**mDNS advertisement broadcasted successfully to ${broadcastAddress}`);
                     }
                 });
             }
@@ -145,6 +162,56 @@ Examples:
                 mdns.log.error(`Error broadcasting mDNS advertisement: ${error.message}`);
             }
         }
+        if (mdns.socketType === 'udp4' && hasParameter('localhost')) {
+            try {
+                mdns.log.info(`**Sending mDNS advertisement for matterbridge service to localhost...`);
+                mdns.socket.send(response, 0, response.length, MDNS_MULTICAST_PORT, 'localhost', (error) => {
+                    if (error) {
+                        mdns.log.error(`**Error sending mDNS advertisement to localhost: ${error.message}`);
+                    }
+                    else {
+                        mdns.log.info(`**mDNS advertisement sent successfully to localhost`);
+                    }
+                });
+            }
+            catch (error) {
+                mdns.log.error(`**Error sending mDNS advertisement to localhost: ${error.message}`);
+            }
+        }
+        if (mdns.socketType === 'udp4' && getParameter('unicastIpv4')) {
+            const unicastAddress = getParameter('unicastIpv4');
+            try {
+                mdns.log.info(`**Sending mDNS advertisement for matterbridge service to unicast ${unicastAddress}...`);
+                mdns.socket.send(response, 0, response.length, MDNS_MULTICAST_PORT, unicastAddress, (error) => {
+                    if (error) {
+                        mdns.log.error(`Error sending mDNS advertisement to unicast ${unicastAddress}: ${error.message}`);
+                    }
+                    else {
+                        mdns.log.info(`**mDNS advertisement sent successfully to unicast ${unicastAddress}`);
+                    }
+                });
+            }
+            catch (error) {
+                mdns.log.error(`Error sending mDNS advertisement to unicast ${unicastAddress}: ${error.message}`);
+            }
+        }
+        if (mdns.socketType === 'udp6' && getParameter('unicastIpv6')) {
+            const unicastAddress = getParameter('unicastIpv6');
+            try {
+                mdns.log.info(`**Sending mDNS advertisement for matterbridge service to unicast ${unicastAddress}...`);
+                mdns.socket.send(response, 0, response.length, MDNS_MULTICAST_PORT, unicastAddress, (error) => {
+                    if (error) {
+                        mdns.log.error(`Error sending mDNS advertisement to unicast ${unicastAddress}: ${error.message}`);
+                    }
+                    else {
+                        mdns.log.info(`**mDNS advertisement sent successfully to unicast ${unicastAddress}`);
+                    }
+                });
+            }
+            catch (error) {
+                mdns.log.error(`Error sending mDNS advertisement to unicast ${unicastAddress}: ${error.message}`);
+            }
+        }
     };
     process.on('SIGINT', async () => {
         await cleanupAndLogAndExit();
@@ -154,13 +221,13 @@ Examples:
         mdnsIpv4.log.info(`mdnsIpv4 server ready on ${address.family} ${address.address}:${address.port}`);
         if (hasParameter('advertise')) {
             advertise(mdnsIpv4);
-            setInterval(() => {
+            mdnsIpv4AdvertiseInterval = setInterval(() => {
                 advertise(mdnsIpv4);
             }, getIntParameter('advertise') || 10000).unref();
         }
         if (hasParameter('query')) {
             query(mdnsIpv4);
-            setInterval(() => {
+            mdnsIpv4QueryInterval = setInterval(() => {
                 query(mdnsIpv4);
             }, getIntParameter('query') || 10000).unref();
         }
@@ -170,18 +237,25 @@ Examples:
         mdnsIpv6.log.info(`mdnsIpv6 server ready on ${address.family} ${address.address}:${address.port}`);
         if (hasParameter('advertise')) {
             advertise(mdnsIpv6);
-            setInterval(() => {
+            mdnsIpv6AdvertiseInterval = setInterval(() => {
                 advertise(mdnsIpv6);
             }, getIntParameter('advertise') || 10000).unref();
         }
         if (hasParameter('query')) {
             query(mdnsIpv6);
-            setInterval(() => {
+            mdnsIpv6QueryInterval = setInterval(() => {
                 query(mdnsIpv6);
             }, getIntParameter('query') || 10000).unref();
         }
     });
+    unicast.start();
+    unicast.on('ready', (address) => {
+        unicast.log.info(`**Ready on ${address.family} ${address.address}:${address.port}`);
+    });
+    unicast.on('message', (msg, rinfo) => {
+        unicast.log.info(`**Received message from ${rinfo.address}:${rinfo.port} - ${msg.length} bytes`);
+    });
     setTimeout(async () => {
         await cleanupAndLogAndExit();
-    }, 600000);
+    }, 600000).unref();
 }

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge",
-  "version": "3.4.5-dev-20251224-ea793b4",
+  "version": "3.4.5-dev-20251225-2f72161",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge",
-      "version": "3.4.5-dev-20251224-ea793b4",
+      "version": "3.4.5-dev-20251225-2f72161",
       "license": "Apache-2.0",
       "dependencies": {
         "@matter/main": "0.15.6",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge",
-  "version": "3.4.5-dev-20251224-ea793b4",
+  "version": "3.4.5-dev-20251225-2f72161",
   "description": "Matterbridge plugin manager for Matter",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",