matterbridge 3.5.0-dev-20260119-f9ea00e → 3.5.0

package/dist/dgram/mb_mdns.js

@@ -1,9 +1,36 @@
+/**
+ * @description This file contains the bin mb_mdns for the class Mdns.
+ * @file src/dgram/mb_mdns.ts
+ * @author Luca Liguori
+ * @created 2025-07-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';
+// Net imports
 import { MDNS_MULTICAST_IPV4_ADDRESS, MDNS_MULTICAST_IPV6_ADDRESS, MDNS_MULTICAST_PORT, Mdns } from '@matterbridge/dgram';
+// Utils imports
 import { getIntParameter, getParameter, getStringArrayParameter, hasParameter } from '@matterbridge/utils';
+// istanbul ignore next
 {
     if (hasParameter('h') || hasParameter('help')) {
+        // eslint-disable-next-line no-console
         console.log(`Copyright (c) Matterbridge. All rights reserved. Version 1.0.0.\n`);
+        // eslint-disable-next-line no-console
         console.log(`Usage: mb_mdns [options...]
 
 If no command line is provided, mb_mdns shows all incoming mDNS records on all interfaces (0.0.0.0 and ::).
@@ -44,8 +71,10 @@ Examples:
   # Query each 5s and listen for _matterbridge._tcp.local service records
   mb_mdns --query 5000 --filter _matterbridge._tcp.local
 `);
+        // eslint-disable-next-line n/no-process-exit
         process.exit(0);
     }
+    // Dynamic JSON import (Node >= 20) with import attributes
     const { default: pkg } = await import('../../package.json', { with: { type: 'json' } });
     let mdnsIpv4QueryInterval;
     let mdnsIpv6QueryInterval;
@@ -53,6 +82,9 @@ Examples:
     let mdnsIpv6AdvertiseInterval;
     let mdnsIpv4 = undefined;
     let mdnsIpv6 = undefined;
+    /**
+     * Cleanup and log device information before exiting.
+     */
     async function cleanupAndLogAndExit() {
         clearInterval(mdnsIpv4QueryInterval);
         clearInterval(mdnsIpv6QueryInterval);
@@ -60,36 +92,42 @@ Examples:
         clearInterval(mdnsIpv6AdvertiseInterval);
         if (hasParameter('advertise')) {
             if (mdnsIpv4)
-                advertise(mdnsIpv4, 0);
+                advertise(mdnsIpv4, 0); // Send goodbye with TTL 0
             if (mdnsIpv6)
-                advertise(mdnsIpv6, 0);
+                advertise(mdnsIpv6, 0); // Send goodbye with TTL 0
         }
-        await new Promise((resolve) => setTimeout(resolve, 250));
+        await new Promise((resolve) => setTimeout(resolve, 250)); // Wait for 250ms to allow goodbye messages to be sent
         mdnsIpv4?.stop();
         mdnsIpv6?.stop();
         mdnsIpv4?.logDevices();
         mdnsIpv6?.logDevices();
-        await new Promise((resolve) => setTimeout(resolve, 250));
+        await new Promise((resolve) => setTimeout(resolve, 250)); // Wait for 250ms to allow sockets to close
     }
     const query = (mdns) => {
         mdns.log.info('Sending mDNS query for common services...');
         try {
             mdns.sendQuery([
-                { name: '_matterc._udp.local', type: 12, class: 1, unicastResponse: true },
-                { name: '_matter._tcp.local', type: 12, class: 1, unicastResponse: true },
-                { name: '_matterbridge._tcp.local', type: 12, class: 1, unicastResponse: true },
-                { name: '_home-assistant._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: '_googlecast._tcp.local', type: 12, class: 1, unicastResponse: true },
-                { name: '_services._dns-sd._udp.local', type: 12, class: 1, unicastResponse: true },
+                { name: '_matterc._udp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
+                { name: '_matter._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
+                { name: '_matterbridge._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
+                { name: '_home-assistant._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
+                { name: '_shelly._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
+                { name: '_mqtt._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
+                { name: '_http._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
+                { name: '_googlecast._tcp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
+                { name: '_services._dns-sd._udp.local', type: 12 /* DnsRecordType.PTR */, class: 1 /* DnsClass.IN */, unicastResponse: true },
             ]);
         }
         catch (error) {
             mdns.log.error(`Error sending mDNS query: ${error.message}`);
         }
     };
+    /**
+     * Sends an mDNS advertisement for the HTTP service over UDP IPv4.
+     *
+     * @param {Mdns} mdns - The Mdns instance to use for sending the advertisement.
+     * @param {number} [ttl] - The time-to-live for the advertisement records. Defaults to 120 seconds. Send 0 for goodbye.
+     */
     const advertise = (mdns, ttl = 120) => {
         mdns.log.info(`Sending mDNS advertisement for matterbridge service with TTL ${ttl ? ttl.toString() : 'goodbye'}...`);
         const httpServiceType = '_http._tcp.local';
@@ -105,17 +143,25 @@ Examples:
         const srvRdata = mdns.encodeSrvRdata(0, 0, port, hostName);
         const txtRdata = mdns.encodeTxtRdata([`version=${pkg.version}`, 'path=/']);
         const answers = [
-            { name: '_services._dns-sd._udp.local', rtype: 12, rclass: 1, ttl, rdata: ptrHttpServiceTypeRdata },
-            { name: httpServiceType, rtype: 12, rclass: 1, ttl, rdata: ptrHttpInstanceRdata },
-            { name: '_services._dns-sd._udp.local', rtype: 12, rclass: 1, ttl, rdata: ptrMatterbridgeServiceTypeRdata },
-            { name: matterbridgeServiceType, rtype: 12, rclass: 1, ttl, rdata: ptrMatterbridgeInstanceRdata },
-            { name: httpInstanceName, rtype: 33, rclass: 1 | 32768, ttl, rdata: srvRdata },
-            { name: matterbridgeInstanceName, rtype: 33, rclass: 1 | 32768, ttl, rdata: srvRdata },
-            { name: httpInstanceName, rtype: 16, rclass: 1 | 32768, ttl, rdata: txtRdata },
-            { name: matterbridgeInstanceName, rtype: 16, rclass: 1 | 32768, ttl, rdata: txtRdata },
+            // PTR records for service types and instances
+            { name: '_services._dns-sd._udp.local', rtype: 12 /* DnsRecordType.PTR */, rclass: 1 /* DnsClass.IN */, ttl, rdata: ptrHttpServiceTypeRdata },
+            { name: httpServiceType, rtype: 12 /* DnsRecordType.PTR */, rclass: 1 /* DnsClass.IN */, ttl, rdata: ptrHttpInstanceRdata },
+            { name: '_services._dns-sd._udp.local', rtype: 12 /* DnsRecordType.PTR */, rclass: 1 /* DnsClass.IN */, ttl, rdata: ptrMatterbridgeServiceTypeRdata },
+            { name: matterbridgeServiceType, rtype: 12 /* DnsRecordType.PTR */, rclass: 1 /* DnsClass.IN */, ttl, rdata: ptrMatterbridgeInstanceRdata },
+            // SRV record for the HTTP instance
+            { name: httpInstanceName, rtype: 33 /* DnsRecordType.SRV */, rclass: 1 /* DnsClass.IN */ | 32768 /* DnsClassFlag.FLUSH */, ttl, rdata: srvRdata },
+            // SRV record for the matterbridge instance
+            { name: matterbridgeInstanceName, rtype: 33 /* DnsRecordType.SRV */, rclass: 1 /* DnsClass.IN */ | 32768 /* DnsClassFlag.FLUSH */, ttl, rdata: srvRdata },
+            // TXT record for the HTTP instance
+            { name: httpInstanceName, rtype: 16 /* DnsRecordType.TXT */, rclass: 1 /* DnsClass.IN */ | 32768 /* DnsClassFlag.FLUSH */, ttl, rdata: txtRdata },
+            // TXT record for the matterbridge instance
+            { name: matterbridgeInstanceName, rtype: 16 /* DnsRecordType.TXT */, rclass: 1 /* DnsClass.IN */ | 32768 /* DnsClassFlag.FLUSH */, ttl, rdata: txtRdata },
         ];
+        // Always attempt to add both A and all AAAA records (best effort), regardless of the socket family.
         const interfaces = os.networkInterfaces();
+        // Use specified interface name if provided
         let interfaceInfos = mdns.interfaceName ? interfaces[mdns.interfaceName] : undefined;
+        // Find the first non-internal IPv4 and IPv6 addresses if interface name is not provided or not found
         if (!interfaceInfos) {
             interfaceInfos = [];
             for (const name of Object.keys(interfaces)) {
@@ -126,14 +172,15 @@ Examples:
                 }
             }
         }
+        // Encode A and AAAA records for all non-internal addresses of the selected interface
         for (const info of interfaceInfos) {
             if (info.family === 'IPv4' && !info.internal) {
                 const ipv4 = info.address;
-                answers.push({ name: hostName, rtype: 1, rclass: 1 | 32768, ttl, rdata: mdns.encodeA(ipv4) });
+                answers.push({ name: hostName, rtype: 1 /* DnsRecordType.A */, rclass: 1 /* DnsClass.IN */ | 32768 /* DnsClassFlag.FLUSH */, ttl, rdata: mdns.encodeA(ipv4) });
             }
             else if (info.family === 'IPv6' && !info.internal) {
                 const ipv6 = info.address;
-                answers.push({ name: hostName, rtype: 28, rclass: 1 | 32768, ttl, rdata: mdns.encodeAAAA(ipv6) });
+                answers.push({ name: hostName, rtype: 28 /* DnsRecordType.AAAA */, rclass: 1 /* DnsClass.IN */ | 32768 /* DnsClassFlag.FLUSH */, ttl, rdata: mdns.encodeAAAA(ipv6) });
             }
         }
         try {
@@ -147,12 +194,15 @@ Examples:
         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'));
         if (hasParameter('v') || hasParameter('verbose'))
             mdnsIpv4.listNetworkInterfaces();
+        // Apply filters if any
         const filters = getStringArrayParameter('filter');
         if (filters)
             mdnsIpv4.filters.push(...filters);
+        // Handle errors
         mdnsIpv4.on('error', (err) => {
             mdnsIpv4?.log.error(`mDNS udp4 Server error: ${err.message}\n${err.stack}`);
         });
+        // Start the IPv4 mDNS server
         mdnsIpv4.start();
         mdnsIpv4.on('ready', (address) => {
             mdnsIpv4?.socket.setMulticastLoopback(false);
@@ -171,12 +221,15 @@ Examples:
         mdnsIpv6 = new Mdns('mDNS Server udp6', MDNS_MULTICAST_IPV6_ADDRESS, MDNS_MULTICAST_PORT, 'udp6', true, getParameter('interfaceName'), getParameter('ipv6InterfaceAddress') || '::', getParameter('outgoingIpv6InterfaceAddress'));
         if (hasParameter('v') || hasParameter('verbose'))
             mdnsIpv6.listNetworkInterfaces();
+        // Apply filters if any
         const filters = getStringArrayParameter('filter');
         if (filters)
             mdnsIpv6.filters.push(...filters);
+        // Handle errors
         mdnsIpv6.on('error', (err) => {
             mdnsIpv6?.log.error(`mDNS udp6 Server error: ${err.message}\n${err.stack}`);
         });
+        // Start the IPv6 mDNS server
         mdnsIpv6.start();
         mdnsIpv6.on('ready', (address) => {
             mdnsIpv6?.socket.setMulticastLoopback(false);
@@ -191,15 +244,18 @@ Examples:
             }
         });
     }
+    // Handle Ctrl+C (SIGINT) and SIGTERM to stop and log devices
     process.on('SIGINT', async () => {
         await cleanupAndLogAndExit();
     });
     process.on('SIGTERM', async () => {
         await cleanupAndLogAndExit();
     });
+    // Exit after a timeout to avoid running indefinitely in test environments
     if (!hasParameter('no-timeout')) {
         setTimeout(async () => {
             await cleanupAndLogAndExit();
-        }, 600000).unref();
+        }, 600000).unref(); // 10 minutes timeout to exit if no activity
     }
 }
+//# sourceMappingURL=mb_mdns.js.map

package/dist/dgram/mb_mdns.js.map

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

package/dist/dgram/mdns.d.ts

@@ -1,3 +1,25 @@
+/**
+ * @description This file contains the class Mdns.
+ * @file mdns.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 dgram from 'node:dgram';
 import { AnsiLogger } from 'node-ansi-logger';
 import { Multicast } from './multicast.js';
@@ -94,13 +116,13 @@ export declare const enum DnsRecordType {
     DLV = 32769
 }
 export declare const enum DnsClass {
-    IN = 1,
-    CH = 3,
-    HS = 4,
+    IN = 1,// Internet
+    CH = 3,// Chaos
+    HS = 4,// Hesiod
     ANY = 255
 }
 export declare const enum DnsClassFlag {
-    FLUSH = 32768,
+    FLUSH = 32768,// For answers (resource records)
     QU = 32768
 }
 export interface MdnsMessage {
@@ -134,8 +156,26 @@ interface MdnsRecord {
     ttl: number;
     data: string;
 }
+/**
+ * Checks if a given message is an mDNS message.
+ *
+ * @param {Buffer} message - The message buffer to check.
+ * @returns {boolean} True if the message is an mDNS message, false otherwise.
+ */
 export declare function isMdns(message: Buffer): boolean;
+/**
+ * Checks if a given mDNS message is a query.
+ *
+ * @param {Buffer} message - The mDNS message buffer to check.
+ * @returns {boolean} True if the message is a query, false otherwise.
+ */
 export declare function isMdnsQuery(message: Buffer): boolean;
+/**
+ * Checks if a given mDNS message is a query.
+ *
+ * @param {Buffer} message - The mDNS message buffer to check.
+ * @returns {boolean} True if the message is a query, false otherwise.
+ */
 export declare function isMdnsResponse(message: Buffer): boolean;
 export declare class Mdns extends Multicast {
     deviceQueries: Map<string, {
@@ -148,30 +188,143 @@ export declare class Mdns extends Multicast {
         dataPTR?: string;
     }>;
     filters: string[];
+    /**
+     * Creates an instance of the Mdns class.
+     *
+     * @param {string} name - The internal name of the mDNS server for the logs.
+     * @param {string} multicastAddress - The multicast address for mDNS (i.e. 224.0.0.251 for udp4 or ff02::fb for udp6).
+     * @param {number} multicastPort - The port for mDNS (i.e. 5353).
+     * @param {('udp4' | 'udp6')} socketType - The type of socket to create (either 'udp4' or 'udp6').
+     * @param {boolean} [reuseAddr] - Whether to reuse the address. Defaults to true.
+     * @param {string} [interfaceName] - The optional name of the network interface to use.
+     * @param {string} [interfaceAddress] - The optional IP address of the network interface to use.
+     * @param {string} [outgoingInterfaceAddress] - The address of the outgoing network interface.
+     */
     constructor(name: string, multicastAddress: string, multicastPort: number, socketType: 'udp4' | 'udp6', reuseAddr?: boolean | undefined, interfaceName?: string, interfaceAddress?: string, outgoingInterfaceAddress?: string);
     onQuery(rinfo: dgram.RemoteInfo, _query: MdnsMessage): void;
     onResponse(rinfo: dgram.RemoteInfo, _response: MdnsMessage): void;
     onMessage(msg: Buffer, rinfo: dgram.RemoteInfo): void;
+    /**
+     * Decodes an mDNS message, including the header, question section, answer section,
+     * authority section, and additional section.
+     *
+     * @param {Buffer} msg - The raw mDNS message buffer.
+     * @returns {MdnsMessage} An object representing the decoded mDNS message.
+     * @throws {Error} if the message is too short.
+     */
     decodeMdnsMessage(msg: Buffer): MdnsMessage;
+    /**
+     * Decodes a DNS name from a buffer, handling compression.
+     *
+     * @param {Buffer} msg - The full mDNS message buffer.
+     * @param {number} offset - The offset at which the DNS name starts.
+     * @returns {{ name: string; newOffset: number }} An object with the decoded name and the new offset.
+     * @throws {Error} if the offset exceeds the buffer length or too many iterations are performed.
+     */
     decodeDnsName(msg: Buffer, offset: number): {
         name: string;
         newOffset: number;
     };
+    /**
+     * Encodes a domain name into the DNS label format.
+     *
+     * For example, "example.local" becomes:
+     * [7] "example" [5] "local" [0]
+     *
+     * @param {string} name - The domain name to encode.
+     * @returns {Buffer} The encoded domain name as a Buffer.
+     */
     encodeDnsName(name: string): Buffer;
+    /**
+     * Encodes TXT record RDATA.
+     *
+     * In DNS/mDNS, TXT RDATA is a sequence of one or more <character-string>,
+     * each encoded as: [length byte][UTF-8 bytes].
+     *
+     * @param {string[]} txt - Array of TXT entries, e.g. ["key=value", "path=/"].
+     * @returns {Buffer} Encoded TXT RDATA.
+     * @throws {Error} If any entry exceeds 255 bytes.
+     *
+     * @example
+     * const txtRdata = mdns.encodeTxtRdata(['txtvers=1', 'path=/']);
+     * mdns.sendResponse([
+     *   { name: 'example._http._tcp.local', rtype: DnsRecordType.TXT, rclass: DnsClass.IN | DnsClassFlag.FLUSH, ttl: 120, rdata: txtRdata },
+     * ]);
+     */
     encodeTxtRdata(txt: string[]): Buffer;
+    /**
+     * Encodes SRV record RDATA.
+     *
+     * SRV RDATA layout (RFC 2782):
+     * - priority (2 bytes)
+     * - weight   (2 bytes)
+     * - port     (2 bytes)
+     * - target   (DNS name)
+     *
+     * @param {number} priority - SRV priority.
+     * @param {number} weight - SRV weight.
+     * @param {number} port - Service port.
+     * @param {string} target - Target hostname (e.g. "matterbridge.local").
+     * @returns {Buffer} Encoded SRV RDATA.
+     */
     encodeSrvRdata(priority: number, weight: number, port: number, target: string): Buffer;
+    /**
+     * Encodes an IPv4 address for an A record RDATA (4 bytes).
+     *
+     * @param {string} ipv4 - IPv4 address, e.g. "192.168.1.10".
+     * @returns {Buffer} 4-byte buffer.
+     * @throws {Error} If the address is not a valid dotted-quad.
+     */
     encodeA(ipv4: string): Buffer;
+    /**
+     * Encodes an IPv6 address for an AAAA record RDATA (16 bytes).
+     *
+     * Supports the "::" zero-compression form and ignores an optional scope id
+     * suffix (e.g. "fe80::1%12" or "fe80::1%eth0").
+     *
+     * @param {string} ipv6WithOptionalScope - IPv6 address (optionally with scope id).
+     * @returns {Buffer} 16-byte buffer.
+     * @throws {Error} If the address is not a valid IPv6 literal.
+     */
     encodeAAAA(ipv6WithOptionalScope: string): Buffer;
+    /**
+     * Decodes a DNS resource record.
+     *
+     * @param {Buffer} msg - The full mDNS message buffer.
+     * @param {number} offset - The offset at which the resource record starts.
+     * @returns {{ record: MdnsRecord; newOffset: number }} An object containing the decoded record and the new offset.
+     */
     decodeResourceRecord(msg: Buffer, offset: number): {
         record: MdnsRecord;
         newOffset: number;
     };
+    /**
+     * Sends a DNS query with multiple questions.
+     *
+     * @param {Array<{ name: string; type: number; class: number; unicastResponse?: boolean }>} questions - Array of questions
+     * to include in the query.
+     * @returns {Buffer<ArrayBuffer>} The constructed query buffer.
+     *
+     * @remarks
+     * Each question should have a name (e.g., "_http._tcp.local"), type (e.g., DnsRecordType.PTR), class (e.g., DnsClass.IN),
+     * and an optional unicastResponse flag (this will add the DnsClassFlag.QU flag to the query).
+     */
     sendQuery(questions: {
         name: string;
         type: number;
         class: number;
         unicastResponse?: boolean;
     }[]): Buffer<ArrayBuffer>;
+    /**
+     * Constructs an mDNS response packet and sends it to the multicast address and port.
+     *
+     * @param {Array<{ name: string; rtype: number; rclass: number; ttl: number; rdata: Buffer }>} answers - Array of answer records.
+     * @returns {Buffer<ArrayBuffer>} The constructed response buffer.
+     *
+     * @example
+     *   const ptrRdata = mdnsIpv4.encodeDnsName('matterbridge._http._tcp.local');
+     *   mdnsIpv4.sendResponse([{ name: '_http._tcp.local', rtype: DnsRecordType.PTR, rclass: DnsClass.IN, ttl: 120, rdata: ptrRdata }]);
+     */
     sendResponse(answers: {
         name: string;
         rtype: number;
@@ -179,10 +332,40 @@ export declare class Mdns extends Multicast {
         ttl: number;
         rdata: Buffer;
     }[]): Buffer<ArrayBuffer>;
+    /**
+     * Converts a DNS record type numeric value to its string representation.
+     *
+     * @param {number} type - The numeric DNS record type.
+     * @returns {string} The string representation of the record type.
+     */
     dnsTypeToString(type: number): string;
+    /**
+     * Converts a DNS response class numeric value to its string representation.
+     *
+     * @param {number} cls - The numeric DNS class.
+     * @returns {string} The string representation of the DNS class.
+     */
     dnsResponseClassToString(cls: number): string;
+    /**
+     * Converts a DNS question class to a human-readable string.
+     * Adds support for mDNS QU (unicast-response) bit.
+     *
+     * @param {number} cls - The numeric question class.
+     * @returns {string} The string representation, e.g. "IN|QU"
+     */
     dnsQuestionClassToString(cls: number): string;
+    /**
+     * Logs the decoded mDNS message header.
+     *
+     * @param {MdnsMessage} msg - The mDNS message header object.
+     * @param {AnsiLogger} [log] - The logger to use (defaults to this.log).
+     * @param {string} [text] - Optional additional text to include in the log.
+     */
     logMdnsMessage(msg: MdnsMessage, log?: AnsiLogger, text?: string): void;
+    /**
+     * Logs the discovered devices from the mDNS queries and responses.
+     */
     logDevices(): void;
 }
 export {};
+//# sourceMappingURL=mdns.d.ts.map

package/dist/dgram/mdns.d.ts.map

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