matterbridge 3.4.5 → 3.4.6-dev-20251228-76bd627

package/dist/dgram/mdnsReflectorClient.js

@@ -1,28 +1,7 @@
-/**
- * @description This file contains the class MdnsReflectorClient.
- * @file src/dgram/mdnsReflectorClient.ts
- * @author Luca Liguori
- * @created 2025-12-25
- * @version 1.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 { AnsiLogger, BLUE, nt } from 'node-ansi-logger';
+import crypto from 'node:crypto';
+import { AnsiLogger, BLUE, nt, nf } from 'node-ansi-logger';
 import { getStringArrayParameter, hasParameter } from '../utils/commandLine.js';
-import { Mdns } from './mdns.js';
+import { isMdns, isMdnsQuery, Mdns } from './mdns.js';
 import { MDNS_MULTICAST_IPV4_ADDRESS, MDNS_MULTICAST_IPV6_ADDRESS, MDNS_MULTICAST_PORT } from './multicast.js';
 import { Unicast } from './unicast.js';
 import { MDNS_REFLECTOR_ADDRESS, MDNS_REFLECTOR_BIND_ADDRESS_IPV4, MDNS_REFLECTOR_BIND_ADDRESS_IPV6, MDNS_REFLECTOR_HOST_DOCKER, MDNS_REFLECTOR_PORT } from './mdnsReflectorTypes.js';
@@ -30,28 +9,56 @@ export class MdnsReflectorClient {
     verbose = hasParameter('v') || hasParameter('verbose');
     debug = hasParameter('d') || hasParameter('debug') || hasParameter('v') || hasParameter('verbose');
     silent = hasParameter('s') || hasParameter('silent');
-    log = new AnsiLogger({ logName: 'MdnsReflectorClient', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: this.debug ? "debug" /* LogLevel.DEBUG */ : this.silent ? "notice" /* LogLevel.NOTICE */ : "info" /* LogLevel.INFO */ });
+    log = new AnsiLogger({ logName: 'MdnsReflectorClient', logTimestampFormat: 4, logLevel: this.debug ? "debug" : this.silent ? "notice" : "info" });
     mdnsIpv4 = new Mdns('mDNS udp4 Server', MDNS_MULTICAST_IPV4_ADDRESS, MDNS_MULTICAST_PORT, 'udp4', true, undefined, MDNS_REFLECTOR_BIND_ADDRESS_IPV4);
     mdnsIpv6 = new Mdns('mDNS udp6 Server', MDNS_MULTICAST_IPV6_ADDRESS, MDNS_MULTICAST_PORT, 'udp6', true, undefined, MDNS_REFLECTOR_BIND_ADDRESS_IPV6);
     unicastIpv4 = new Unicast('mDNS udp4 Reflector Client', 'udp4', false, undefined, MDNS_REFLECTOR_BIND_ADDRESS_IPV4);
     unicastIpv6 = new Unicast('mDNS udp6 Reflector Client', 'udp6', false, undefined, MDNS_REFLECTOR_BIND_ADDRESS_IPV6);
+    reflectedIpv4 = new Map();
+    reflectedIpv6 = new Map();
+    TTL_MS = 1500;
     constructor() {
         this.log.logNameColor = '\x1b[38;5;97m';
         this.mdnsIpv4.log.logNameColor = '\x1b[38;5;97m';
-        this.mdnsIpv4.log.logLevel = "warn" /* LogLevel.WARN */;
+        if (!this.debug && !this.verbose && !this.silent)
+            this.mdnsIpv4.log.logLevel = "warn";
         this.mdnsIpv6.log.logNameColor = '\x1b[38;5;97m';
-        this.mdnsIpv6.log.logLevel = "warn" /* LogLevel.WARN */;
+        if (!this.debug && !this.verbose && !this.silent)
+            this.mdnsIpv6.log.logLevel = "warn";
         this.unicastIpv4.log.logNameColor = '\x1b[38;5;97m';
-        this.unicastIpv4.log.logLevel = "warn" /* LogLevel.WARN */;
+        if (!this.debug && !this.verbose && !this.silent)
+            this.unicastIpv4.log.logLevel = "warn";
         this.unicastIpv6.log.logNameColor = '\x1b[38;5;97m';
-        this.unicastIpv6.log.logLevel = "warn" /* LogLevel.WARN */;
-        // Apply filters if any
+        if (!this.debug && !this.verbose && !this.silent)
+            this.unicastIpv6.log.logLevel = "warn";
         const filters = getStringArrayParameter('filter');
         if (filters)
             this.mdnsIpv4.filters.push(...filters);
         if (filters)
             this.mdnsIpv6.filters.push(...filters);
     }
+    fingerprint(buf) {
+        return crypto.createHash('sha1').update(buf).digest('hex');
+    }
+    remember(cache, key, ttlMs) {
+        cache.set(key, Date.now() + ttlMs);
+    }
+    seenRecently(cache, key) {
+        const exp = cache.get(key);
+        if (!exp)
+            return false;
+        if (exp < Date.now()) {
+            cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    prune(cache) {
+        const now = Date.now();
+        for (const [k, exp] of cache)
+            if (exp < now)
+                cache.delete(k);
+    }
     async start() {
         this.log.notice('mDNS Reflector Client starting...');
         this.mdnsIpv4.on('error', (err) => {
@@ -84,21 +91,55 @@ export class MdnsReflectorClient {
             this.unicastIpv6.start();
         });
         await Promise.all(promises);
+        this.mdnsIpv4.socket.setMulticastLoopback(false);
+        this.mdnsIpv6.socket.setMulticastLoopback(false);
         this.mdnsIpv4.on('message', (msg, rinfo) => {
-            this.log.notice(`Sending message from mDNS ipv4 multicast ${BLUE}${rinfo.address}${nt}:${BLUE}${rinfo.port}${nt} to unicast ipv4 reflector`);
+            if (this.seenRecently(this.reflectedIpv4, this.fingerprint(msg))) {
+                this.log.info(`Ignoring recently reflected ${isMdnsQuery(msg) ? 'query' : 'response'} message from mDNS ipv4 multicast ${BLUE}${rinfo.address}${nf}:${BLUE}${rinfo.port}${nf}`);
+                return;
+            }
+            this.log.notice(`Sending ${isMdnsQuery(msg) ? 'query' : 'response'} message from mDNS ipv4 multicast ${BLUE}${rinfo.address}${nt}:${BLUE}${rinfo.port}${nt} to unicast ipv4 reflector`);
             this.unicastIpv4.send(msg, MDNS_REFLECTOR_HOST_DOCKER, MDNS_REFLECTOR_PORT);
             this.unicastIpv4.send(msg, MDNS_REFLECTOR_ADDRESS, MDNS_REFLECTOR_PORT);
         });
         this.mdnsIpv6.on('message', (msg, rinfo) => {
-            this.log.notice(`Sending message from mDNS ipv6 multicast ${BLUE}${rinfo.address}${nt}:${BLUE}${rinfo.port}${nt} to unicast ipv6 reflector`);
+            if (this.seenRecently(this.reflectedIpv6, this.fingerprint(msg))) {
+                this.log.info(`Ignoring recently reflected ${isMdnsQuery(msg) ? 'query' : 'response'} message from mDNS ipv6 multicast ${BLUE}${rinfo.address}${nf}:${BLUE}${rinfo.port}${nf}`);
+                return;
+            }
+            this.log.notice(`Sending ${isMdnsQuery(msg) ? 'query' : 'response'} message from mDNS ipv6 multicast ${BLUE}${rinfo.address}${nt}:${BLUE}${rinfo.port}${nt} to unicast ipv6 reflector`);
             this.unicastIpv6.send(msg, MDNS_REFLECTOR_HOST_DOCKER, MDNS_REFLECTOR_PORT);
             this.unicastIpv6.send(msg, MDNS_REFLECTOR_ADDRESS, MDNS_REFLECTOR_PORT);
         });
         this.unicastIpv4.on('message', (msg, rinfo) => {
-            this.log.notice(`Received message from unicast reflector on ipv4 ${BLUE}${rinfo.address}${nt}:${BLUE}${rinfo.port}${nt}: ${msg.toString()}`);
+            if (isMdns(msg)) {
+                this.remember(this.reflectedIpv4, this.fingerprint(msg), this.TTL_MS);
+                this.prune(this.reflectedIpv4);
+                this.log.notice(`Reflecting ${isMdnsQuery(msg) ? 'query' : 'response'} message from reflector on ipv4 ${BLUE}${rinfo.address}${nt}:${BLUE}${rinfo.port}${nt} to mDNS ipv4 multicast`);
+                this.mdnsIpv4.send(msg, MDNS_MULTICAST_IPV4_ADDRESS, MDNS_MULTICAST_PORT);
+                if (hasParameter('localhost')) {
+                    this.log.notice(`Reflecting ${isMdnsQuery(msg) ? 'query' : 'response'} message from reflector on ipv4 ${BLUE}${rinfo.address}${nt}:${BLUE}${rinfo.port}${nt} to mDNS ipv4 localhost`);
+                    this.mdnsIpv4.send(msg, 'localhost', MDNS_MULTICAST_PORT);
+                }
+            }
+            else {
+                this.log.info(`Received message from unicast reflector on ipv4 ${BLUE}${rinfo.address}${nf}:${BLUE}${rinfo.port}${nf}: ${msg.toString()}`);
+            }
         });
         this.unicastIpv6.on('message', (msg, rinfo) => {
-            this.log.notice(`Received message from unicast reflector on ipv6 ${BLUE}${rinfo.address}${nt}:${BLUE}${rinfo.port}${nt}: ${msg.toString()}`);
+            if (isMdns(msg)) {
+                this.remember(this.reflectedIpv6, this.fingerprint(msg), this.TTL_MS);
+                this.prune(this.reflectedIpv6);
+                this.log.notice(`Reflecting ${isMdnsQuery(msg) ? 'query' : 'response'} message from reflector on ipv6 ${BLUE}${rinfo.address}${nt}:${BLUE}${rinfo.port}${nt} to mDNS ipv6 multicast`);
+                this.mdnsIpv6.send(msg, MDNS_MULTICAST_IPV6_ADDRESS, MDNS_MULTICAST_PORT);
+                if (hasParameter('localhost')) {
+                    this.log.notice(`Reflecting ${isMdnsQuery(msg) ? 'query' : 'response'} message from reflector on ipv6 ${BLUE}${rinfo.address}${nt}:${BLUE}${rinfo.port}${nt} to mDNS ipv6 localhost`);
+                    this.mdnsIpv6.send(msg, 'localhost', MDNS_MULTICAST_PORT);
+                }
+            }
+            else {
+                this.log.info(`Received message from unicast reflector on ipv6 ${BLUE}${rinfo.address}${nf}:${BLUE}${rinfo.port}${nf}: ${msg.toString()}`);
+            }
         });
         this.log.notice('mDNS Reflector Client started.');
     }
@@ -106,19 +147,19 @@ export class MdnsReflectorClient {
         this.log.notice('mDNS Reflector Client stopping...');
         const promises = [];
         promises[0] = new Promise((resolve) => {
-            this.mdnsIpv4.once('closed', () => resolve());
+            this.mdnsIpv4.once('close', () => resolve());
             this.mdnsIpv4.stop();
         });
         promises[1] = new Promise((resolve) => {
-            this.mdnsIpv6.once('closed', () => resolve());
+            this.mdnsIpv6.once('close', () => resolve());
             this.mdnsIpv6.stop();
         });
         promises[2] = new Promise((resolve) => {
-            this.unicastIpv4.once('closed', () => resolve());
+            this.unicastIpv4.once('close', () => resolve());
             this.unicastIpv4.stop();
         });
         promises[3] = new Promise((resolve) => {
-            this.unicastIpv6.once('closed', () => resolve());
+            this.unicastIpv6.once('close', () => resolve());
             this.unicastIpv6.stop();
         });
         await Promise.all(promises);
@@ -129,4 +170,3 @@ export class MdnsReflectorClient {
         this.log.notice('mDNS Reflector Client stopped.');
     }
 }
-//# sourceMappingURL=mdnsReflectorClient.js.map

package/dist/dgram/mdnsReflectorServer.js

@@ -1,29 +1,7 @@
-/**
- * @description This file contains the class MdnsReflectorServer.
- * @file src/dgram/mdnsReflectorServer.ts
- * @author Luca Liguori
- * @created 2025-12-25
- * @version 1.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 os from 'node:os';
 import { AnsiLogger, BLUE, nt } from 'node-ansi-logger';
 import { hasParameter, getStringArrayParameter } from '../utils/commandLine.js';
-import { Mdns } from './mdns.js';
+import { isMdns, isMdnsQuery, isMdnsResponse, Mdns } from './mdns.js';
 import { MDNS_MULTICAST_IPV4_ADDRESS, MDNS_MULTICAST_IPV6_ADDRESS, MDNS_MULTICAST_PORT } from './multicast.js';
 import { Unicast } from './unicast.js';
 import { MDNS_REFLECTOR_BIND_ADDRESS_IPV4, MDNS_REFLECTOR_BIND_ADDRESS_IPV6, MDNS_REFLECTOR_PORT } from './mdnsReflectorTypes.js';
@@ -31,7 +9,7 @@ export class MdnsReflectorServer {
     verbose = hasParameter('v') || hasParameter('verbose');
     debug = hasParameter('d') || hasParameter('debug') || hasParameter('v') || hasParameter('verbose');
     silent = hasParameter('s') || hasParameter('silent');
-    log = new AnsiLogger({ logName: 'MdnsReflectorServer', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: this.debug ? "debug" /* LogLevel.DEBUG */ : this.silent ? "notice" /* LogLevel.NOTICE */ : "info" /* LogLevel.INFO */ });
+    log = new AnsiLogger({ logName: 'MdnsReflectorServer', logTimestampFormat: 4, logLevel: this.debug ? "debug" : this.silent ? "notice" : "info" });
     mdnsIpv4 = new Mdns('mDNS udp4 Server', MDNS_MULTICAST_IPV4_ADDRESS, MDNS_MULTICAST_PORT, 'udp4', true, undefined, MDNS_REFLECTOR_BIND_ADDRESS_IPV4);
     mdnsIpv6 = new Mdns('mDNS udp6 Server', MDNS_MULTICAST_IPV6_ADDRESS, MDNS_MULTICAST_PORT, 'udp6', true, undefined, MDNS_REFLECTOR_BIND_ADDRESS_IPV6);
     unicastIpv4 = new Unicast('mDNS udp4 Reflector Server', 'udp4', true, undefined, MDNS_REFLECTOR_BIND_ADDRESS_IPV4, MDNS_REFLECTOR_PORT);
@@ -41,14 +19,17 @@ export class MdnsReflectorServer {
     constructor() {
         this.log.logNameColor = '\x1b[38;5;115m';
         this.mdnsIpv4.log.logNameColor = '\x1b[38;5;115m';
-        this.mdnsIpv4.log.logLevel = "warn" /* LogLevel.WARN */;
+        if (!this.debug && !this.verbose && !this.silent)
+            this.mdnsIpv4.log.logLevel = "warn";
         this.mdnsIpv6.log.logNameColor = '\x1b[38;5;115m';
-        this.mdnsIpv6.log.logLevel = "warn" /* LogLevel.WARN */;
+        if (!this.debug && !this.verbose && !this.silent)
+            this.mdnsIpv6.log.logLevel = "warn";
         this.unicastIpv4.log.logNameColor = '\x1b[38;5;115m';
-        this.unicastIpv4.log.logLevel = "warn" /* LogLevel.WARN */;
+        if (!this.debug && !this.verbose && !this.silent)
+            this.unicastIpv4.log.logLevel = "warn";
         this.unicastIpv6.log.logNameColor = '\x1b[38;5;115m';
-        this.unicastIpv6.log.logLevel = "warn" /* LogLevel.WARN */;
-        // Apply filters if any
+        if (!this.debug && !this.verbose && !this.silent)
+            this.unicastIpv6.log.logLevel = "warn";
         const filters = getStringArrayParameter('filter');
         if (filters)
             this.mdnsIpv4.filters.push(...filters);
@@ -66,18 +47,7 @@ export class MdnsReflectorServer {
             mdns.log.error(`Error getting broadcast address: ${error.message}`);
         }
     }
-    /**
-     * Decode and upgrade the A and AAAA records from Docker environment to point the host machine.
-     * Matterbridge running inside Docker Desktop containers register mDNS records with the container's IP address,
-     * which is not reachable from outside the Docker network.
-     * To make these services reachable, we need to upgrade the A and AAAA records using the host machine IP addresses.
-     * The reflector server runs on the host, while mDNS advertisements come from containers.
-     *
-     * @param {Buffer<ArrayBufferLike>} msg - The mDNS message buffer.
-     * @returns {Buffer<ArrayBufferLike>} The upgraded mDNS message buffer.
-     */
     upgradeAddress(msg) {
-        // Safety: if it's not even a DNS header, do nothing.
         if (!msg || msg.length < 12)
             return msg;
         const preferredInterfaceName = this.mdnsIpv4.interfaceName ?? this.mdnsIpv6.interfaceName;
@@ -113,7 +83,6 @@ export class MdnsReflectorServer {
         this.log.info(`**UpgradeAddress Host IPv6 for address upgrade: ${hostIpv6List.length > 0 ? hostIpv6List.join(', ') : 'N/A'}`);
         if (!hostIpv4 && hostIpv6List.length === 0)
             return msg;
-        // Copy the message so callers can safely re-use the original buffer.
         const upgradedMsg = Buffer.from(msg);
         const qdCount = upgradedMsg.readUInt16BE(4);
         const anCount = upgradedMsg.readUInt16BE(6);
@@ -121,11 +90,9 @@ export class MdnsReflectorServer {
         const arCount = upgradedMsg.readUInt16BE(10);
         let offset = 12;
         try {
-            // Skip questions
             for (let i = 0; i < qdCount; i++) {
                 const qnameResult = this.mdnsIpv4.decodeDnsName(upgradedMsg, offset);
                 offset = qnameResult.newOffset;
-                // QTYPE + QCLASS
                 offset += 4;
                 if (offset > upgradedMsg.length)
                     return msg;
@@ -141,9 +108,7 @@ export class MdnsReflectorServer {
                         return;
                     const type = upgradedMsg.readUInt16BE(offset);
                     offset += 2;
-                    // class (unused)
                     offset += 2;
-                    // ttl (unused)
                     offset += 4;
                     const rdlength = upgradedMsg.readUInt16BE(offset);
                     offset += 2;
@@ -151,10 +116,10 @@ export class MdnsReflectorServer {
                     const endOfRdata = rdataOffset + rdlength;
                     if (endOfRdata > upgradedMsg.length)
                         return;
-                    if (type === 1 /* DnsRecordType.A */ && rdlength === 4 && hostA) {
+                    if (type === 1 && rdlength === 4 && hostA) {
                         hostA.copy(upgradedMsg, rdataOffset);
                     }
-                    else if (type === 28 /* DnsRecordType.AAAA */ && rdlength === 16 && hostAAAAs.length > 0) {
+                    else if (type === 28 && rdlength === 16 && hostAAAAs.length > 0) {
                         const hostAAAA = hostAAAAs[Math.min(hostAAAAIndex, hostAAAAs.length - 1)];
                         hostAAAA.copy(upgradedMsg, rdataOffset);
                         hostAAAAIndex++;
@@ -162,7 +127,6 @@ export class MdnsReflectorServer {
                     offset = endOfRdata;
                 }
             };
-            // Walk RR sections and patch A/AAAA in-place.
             upgradeResourceRecords(anCount);
             upgradeResourceRecords(nsCount);
             upgradeResourceRecords(arCount);
@@ -217,10 +181,30 @@ export class MdnsReflectorServer {
             this.unicastIpv6.start();
         });
         await Promise.all(promises);
+        this.mdnsIpv4.socket.setMulticastLoopback(false);
+        this.mdnsIpv6.socket.setMulticastLoopback(false);
+        this.mdnsIpv4.on('message', (msg, rinfo) => {
+            if (this.ipv4Clients.size === 0)
+                return;
+            this.log.notice(`Sending ${isMdnsQuery(msg) ? 'query' : 'response'} message from mDNS ipv4 multicast ${BLUE}${rinfo.address}${nt}:${BLUE}${rinfo.port}${nt} to ${this.ipv4Clients.size} ipv4 reflector clients`);
+            for (const client of this.ipv4Clients.values()) {
+                this.unicastIpv4.send(msg, client.address, client.port);
+            }
+        });
+        this.mdnsIpv6.on('message', (msg, rinfo) => {
+            if (this.ipv6Clients.size === 0)
+                return;
+            this.log.notice(`Sending ${isMdnsQuery(msg) ? 'query' : 'response'} message from mDNS ipv6 multicast ${BLUE}${rinfo.address}${nt}:${BLUE}${rinfo.port}${nt} to ${this.ipv6Clients.size} ipv6 reflector clients`);
+            for (const client of this.ipv6Clients.values()) {
+                this.unicastIpv6.send(msg, client.address, client.port);
+            }
+        });
         this.unicastIpv4.on('message', (msg, rinfo) => {
             this.ipv4Clients.set(`${rinfo.address}:${rinfo.port}`, rinfo);
+            if (!isMdns(msg))
+                return;
             this.log.notice(`Reflecting message from unicast client ipv4 ${BLUE}${rinfo.address}${nt}:${BLUE}${rinfo.port}${nt} to mDNS ipv4 multicast`);
-            const upgradedMsg = this.upgradeAddress(msg);
+            const upgradedMsg = isMdnsResponse(msg) ? this.upgradeAddress(msg) : msg;
             this.mdnsIpv4.send(upgradedMsg, MDNS_MULTICAST_IPV4_ADDRESS, MDNS_MULTICAST_PORT);
             if (hasParameter('broadcast')) {
                 const broadcastAddress = this.getBroadcastAddress(this.mdnsIpv4);
@@ -237,8 +221,10 @@ export class MdnsReflectorServer {
         });
         this.unicastIpv6.on('message', (msg, rinfo) => {
             this.ipv6Clients.set(`${rinfo.address}:${rinfo.port}`, rinfo);
+            if (!isMdns(msg))
+                return;
             this.log.notice(`Reflecting message from unicast client ipv6 ${BLUE}${rinfo.address}${nt}:${BLUE}${rinfo.port}${nt} to mDNS ipv6 multicast`);
-            const upgradedMsg = this.upgradeAddress(msg);
+            const upgradedMsg = isMdnsResponse(msg) ? this.upgradeAddress(msg) : msg;
             this.mdnsIpv6.send(upgradedMsg, MDNS_MULTICAST_IPV6_ADDRESS, MDNS_MULTICAST_PORT);
             if (hasParameter('broadcast')) {
                 const broadcastAddress = this.getBroadcastAddress(this.mdnsIpv6);
@@ -265,22 +251,22 @@ export class MdnsReflectorServer {
             this.log.debug(`Notifying ipv6 client ${client.address}:${client.port} about server stopping`);
             this.unicastIpv6.send(Buffer.from('mDNS Reflector Server is stopping'), client.address, client.port);
         }
-        await new Promise((resolve) => setTimeout(resolve, 100)); // Wait a bit to allow messages to be sent
+        await new Promise((resolve) => setTimeout(resolve, 100));
         const promises = [];
         promises[0] = new Promise((resolve) => {
-            this.mdnsIpv4.once('closed', () => resolve());
+            this.mdnsIpv4.once('close', () => resolve());
             this.mdnsIpv4.stop();
         });
         promises[1] = new Promise((resolve) => {
-            this.mdnsIpv6.once('closed', () => resolve());
+            this.mdnsIpv6.once('close', () => resolve());
             this.mdnsIpv6.stop();
         });
         promises[2] = new Promise((resolve) => {
-            this.unicastIpv4.once('closed', () => resolve());
+            this.unicastIpv4.once('close', () => resolve());
             this.unicastIpv4.stop();
         });
         promises[3] = new Promise((resolve) => {
-            this.unicastIpv6.once('closed', () => resolve());
+            this.unicastIpv6.once('close', () => resolve());
             this.unicastIpv6.stop();
         });
         await Promise.all(promises);
@@ -291,4 +277,3 @@ export class MdnsReflectorServer {
         this.log.notice('mDNS Reflector Server stopped.');
     }
 }
-//# sourceMappingURL=mdnsReflectorServer.js.map

package/dist/dgram/mdnsReflectorTypes.js

@@ -1,28 +1,5 @@
-/**
- * @description This file contains the definitions for the mDNS reflector classes.
- * @file src/dgram/mdnsReflectorTypes.ts
- * @author Luca Liguori
- * @created 2025-12-25
- * @version 1.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 const MDNS_REFLECTOR_BIND_ADDRESS_IPV4 = '0.0.0.0';
 export const MDNS_REFLECTOR_BIND_ADDRESS_IPV6 = '::';
-export const MDNS_REFLECTOR_ADDRESS = 'localhost'; // Use 'localhost' to support both IPv4 and IPv6 and to avoid issues in Docker with EPERM
+export const MDNS_REFLECTOR_ADDRESS = 'localhost';
 export const MDNS_REFLECTOR_HOST_DOCKER = 'host.docker.internal';
 export const MDNS_REFLECTOR_PORT = 15353;
-//# sourceMappingURL=mdnsReflectorTypes.js.map

package/dist/dgram/multicast.js

@@ -1,29 +1,5 @@
-/**
- * @description This file contains the class Multicast.
- * @file multicast.ts
- * @author Luca Liguori
- * @created 2025-03-22
- * @version 1.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 os from 'node:os';
-// AnsiLogger imports
 import { BLUE, CYAN, db, RED, YELLOW } from 'node-ansi-logger';
-// Dgram imports
 import { Dgram } from './dgram.js';
 export const MDNS_MULTICAST_IPV4_ADDRESS = '224.0.0.251';
 export const MDNS_MULTICAST_IPV6_ADDRESS = 'ff02::fb';
@@ -31,37 +7,18 @@ export const MDNS_MULTICAST_PORT = 5353;
 export const COAP_MULTICAST_IPV4_ADDRESS = '224.0.1.187';
 export const COAP_MULTICAST_IPV6_ADDRESS = 'ff02::fd';
 export const COAP_MULTICAST_PORT = 5683;
-/**
- * This class implements a multicast dgram socket.
- */
 export class Multicast extends Dgram {
     multicastAddress;
     multicastPort;
     outgoingInterfaceAddress;
     joinedInterfaces = [];
-    /**
-     * Creates an instance of Multicast.
-     *
-     * @param {string} name - The name of the socket.
-     * @param {string} multicastAddress - The multicast address to join.
-     * @param {number} multicastPort - The port number to bind to.
-     * @param {'udp4' | 'udp6'} socketType - The type of the socket (IPv4 or IPv6).
-     * @param {boolean | undefined} reuseAddr - Whether to allow address reuse. Defaults to true.
-     * @param {string} [interfaceName] - The name of the network interface to bind to. If provided, the interfaceAddress will be determined based on this name if not explicitly provided.
-     * @param {string} [interfaceAddress] - The address of the network interface to bind to. If not provided, it will be determined based on the interfaceName.
-     * @param {string} [outgoingInterfaceAddress] - The address of the outgoing network interface. If not provided, it will use the interfaceAddress.
-     */
     constructor(name, multicastAddress, multicastPort, socketType, reuseAddr = true, interfaceName, interfaceAddress, outgoingInterfaceAddress) {
         super(name, socketType, reuseAddr, interfaceName, interfaceAddress);
         this.multicastAddress = multicastAddress;
         this.multicastPort = multicastPort;
         this.outgoingInterfaceAddress = outgoingInterfaceAddress;
     }
-    /**
-     * Starts the dgram multicast socket.
-     */
     start() {
-        // Get the local ipv4 or ipv6 address to bind to.
         if (this.socketType === 'udp4') {
             this.log.debug(`Starting ipv4 dgram multicast socket...`);
             this.interfaceAddress = this.interfaceAddress ?? this.getIpv4InterfaceAddress(this.interfaceName);
@@ -77,11 +34,6 @@ export class Multicast extends Dgram {
             this.emit('bound', address);
         });
     }
-    /**
-     * Event handler for the 'listening' event. This event is emitted when the socket starts listening for datagram messages.
-     *
-     * @param {AddressInfo} [address] - The address info.
-     */
     onListening(address) {
         this.log.debug(`Dgram multicast socket listening on ${BLUE}${address.family}${db} ${BLUE}${address.address}${db}:${BLUE}${address.port}${db}`);
         this.socket.setBroadcast(true);
@@ -92,46 +44,39 @@ export class Multicast extends Dgram {
         this.log.debug(`Dgram multicast socket multicast TTL set to 255`);
         this.socket.setMulticastLoopback(true);
         this.log.debug(`Dgram multicast socket multicast loopback enabled`);
-        // Find the correct network interfaces and join the multicast group on each interface. For IPv6, we will use the scope ID if available. If not available, we will use the Unique Local Address.
         Object.entries(os.networkInterfaces()).forEach(([name, interfaces]) => {
             this.log.debug(`Dgram multicast socket processing interface ${CYAN}${name}${db}`);
             if (!interfaces)
                 return;
             if (this.interfaceName && name !== this.interfaceName)
-                return; // Only process the specified interface
+                return;
             let iface;
             let membershipInterface;
-            // Find the first ipv4 interface
             const ifaceIpv4 = interfaces.find((iface) => iface.family === 'IPv4' && this.socketType === 'udp4');
             if (ifaceIpv4) {
                 iface = ifaceIpv4;
                 membershipInterface = ifaceIpv4.address;
             }
-            // Find the first IPv6 Address
             const ifaceIpv6 = interfaces.find((iface) => iface.family === 'IPv6' && this.socketType === 'udp6');
             if (ifaceIpv6) {
                 iface = ifaceIpv6;
                 membershipInterface = ifaceIpv6.address + (ifaceIpv6.scopeid !== undefined ? (process.platform === 'win32' ? '%' + String(ifaceIpv6.scopeid) : '%' + name) : '');
             }
-            // Find the first Unique Local Address (ULA) IPv6
             const ifaceUla = interfaces.find((iface) => iface.family === 'IPv6' && this.socketType === 'udp6' && iface.address.startsWith('fd'));
             if (ifaceUla) {
                 iface = ifaceUla;
                 membershipInterface = ifaceUla.address + (ifaceUla.scopeid !== undefined ? (process.platform === 'win32' ? '%' + String(ifaceUla.scopeid) : '%' + name) : '');
             }
-            // Find the first Unique Local Address (ULA) IPv6 with prefix length /64 (netmask ffff:ffff:ffff:ffff::)
             const ifaceUla64 = interfaces.find((iface) => iface.family === 'IPv6' && this.socketType === 'udp6' && iface.address.startsWith('fd') && iface.netmask === 'ffff:ffff:ffff:ffff::');
             if (ifaceUla64) {
                 iface = ifaceUla64;
                 membershipInterface = ifaceUla64.address + (ifaceUla64.scopeid !== undefined ? (process.platform === 'win32' ? '%' + String(ifaceUla64.scopeid) : '%' + name) : '');
             }
-            // Find the first Link-local IPv6 Address
             const ifaceLinkLocal = interfaces.find((iface) => iface.family === 'IPv6' && this.socketType === 'udp6' && iface.address.startsWith('fe80'));
             if (ifaceLinkLocal) {
                 iface = ifaceLinkLocal;
                 membershipInterface = ifaceLinkLocal.address + (ifaceLinkLocal.scopeid !== undefined ? (process.platform === 'win32' ? '%' + String(ifaceLinkLocal.scopeid) : '%' + name) : '');
             }
-            // Add the interface address to the multicast group
             if (iface && membershipInterface) {
                 try {
                     this.socket.addMembership(this.multicastAddress, membershipInterface);
@@ -144,11 +89,9 @@ export class Multicast extends Dgram {
             }
         });
         let interfaceAddress = this.outgoingInterfaceAddress || this.interfaceAddress;
-        // If the interfaceAddress is 0.0.0.0, we need to set the default outgoing multicast interface to the first found IPv4 address.
         if (!this.outgoingInterfaceAddress && this.socketType === 'udp4' && this.interfaceAddress === '0.0.0.0') {
             interfaceAddress = this.getIpv4InterfaceAddress(this.interfaceName);
         }
-        // If the interfaceAddress is '::', we need to set the default outgoing multicast interface to '::' + the scope ID.
         if (!this.outgoingInterfaceAddress && this.socketType === 'udp6' && this.interfaceAddress === '::') {
             interfaceAddress = '::' + this.getIpv6ScopeId(this.interfaceName);
         }
@@ -157,9 +100,6 @@ export class Multicast extends Dgram {
         this.log.debug(`Dgram multicast socket multicastInterface set to ${BLUE}${interfaceAddress}${db}`);
         this.emit('ready', address);
     }
-    /**
-     * Stops the dgram multicast socket.
-     */
     stop() {
         this.log.debug('Stopping dgram multicast socket...');
         this.joinedInterfaces.forEach((membershipInterface) => {
@@ -176,4 +116,3 @@ export class Multicast extends Dgram {
         this.log.debug('Stopped dgram multicast socket.');
     }
 }
-//# sourceMappingURL=multicast.js.map