appium-ios-remotexpc 2.0.2 → 2.1.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [2.1.0](https://github.com/appium/appium-ios-remotexpc/compare/v2.0.3...v2.1.0) (2026-05-22)
+
+### Features
+
+* Unify dnssd discovery ([#221](https://github.com/appium/appium-ios-remotexpc/issues/221)) ([68470b9](https://github.com/appium/appium-ios-remotexpc/commit/68470b9283b58faf687ddfd4d4c08d523f88781a))
+
+## [2.0.3](https://github.com/appium/appium-ios-remotexpc/compare/v2.0.2...v2.0.3) (2026-05-22)
+
+### Bug Fixes
+
+* Respect local file system limitations while pulling remote files ([#220](https://github.com/appium/appium-ios-remotexpc/issues/220)) ([4aa9491](https://github.com/appium/appium-ios-remotexpc/commit/4aa949169c6763d99aee8fa6b7c6cd4b74f39a82))
+
 ## [2.0.2](https://github.com/appium/appium-ios-remotexpc/compare/v2.0.1...v2.0.2) (2026-05-21)
 
 ### Bug Fixes

package/build/src/lib/discovery/discovery-backend-factory.d.ts

@@ -2,14 +2,9 @@ import type { DiscoveryOptions, IDeviceDiscoveryBackend } from './types.js';
 /**
  * Create the default device discovery backend for the current platform.
  *
- * On macOS we prefer the system `dns-sd` CLI (Bonjour) because Apple's
- * mDNSResponder advertises non-RFC-6335-compliant service names (e.g.
- * `_remotepairing-manual-pairing._tcp`) that pure-JS mDNS libraries reject.
- *
- * Other platforms fall back to the cross-platform `dnssd` library. Note that
- * `dnssd` enforces RFC 6335 (max 15-char service names), so on Linux/Windows
- * it will not see Apple-style long service names; in those environments
- * callers should advertise/discover via a shorter, compliant service type.
+ * Uses a raw mDNS browser on UDP port 5353 so Apple's non-RFC-6335 service
+ * names (e.g. `_remotepairing-manual-pairing._tcp`) work on macOS, Linux,
+ * and Windows without the macOS `dns-sd` CLI or the `dnssd` npm package.
  */
 export declare function createDiscoveryBackend(platform?: NodeJS.Platform, options?: DiscoveryOptions): IDeviceDiscoveryBackend;
 //# sourceMappingURL=discovery-backend-factory.d.ts.map

package/build/src/lib/discovery/discovery-backend-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery-backend-factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/discovery/discovery-backend-factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE5E;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,OAAO,CAAC,EAAE,gBAAgB,GACzB,uBAAuB,CAKzB"}
+{"version":3,"file":"discovery-backend-factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/discovery/discovery-backend-factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE5E;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,OAAO,CAAC,EAAE,gBAAgB,GACzB,uBAAuB,CAGzB"}

package/build/src/lib/discovery/discovery-backend-factory.js

@@ -1,21 +1,13 @@
-import { BonjourDiscoveryBackend } from './bonjour-discovery-backend.js';
-import { DnssdDiscoveryBackend } from './dnssd-discovery-backend.js';
+import { MdnsDiscoveryBackend } from './mdns-discovery-backend.js';
 /**
  * Create the default device discovery backend for the current platform.
  *
- * On macOS we prefer the system `dns-sd` CLI (Bonjour) because Apple's
- * mDNSResponder advertises non-RFC-6335-compliant service names (e.g.
- * `_remotepairing-manual-pairing._tcp`) that pure-JS mDNS libraries reject.
- *
- * Other platforms fall back to the cross-platform `dnssd` library. Note that
- * `dnssd` enforces RFC 6335 (max 15-char service names), so on Linux/Windows
- * it will not see Apple-style long service names; in those environments
- * callers should advertise/discover via a shorter, compliant service type.
+ * Uses a raw mDNS browser on UDP port 5353 so Apple's non-RFC-6335 service
+ * names (e.g. `_remotepairing-manual-pairing._tcp`) work on macOS, Linux,
+ * and Windows without the macOS `dns-sd` CLI or the `dnssd` npm package.
  */
 export function createDiscoveryBackend(platform = process.platform, options) {
-    if (platform === 'darwin') {
-        return new BonjourDiscoveryBackend(options);
-    }
-    return new DnssdDiscoveryBackend(options);
+    void platform;
+    return new MdnsDiscoveryBackend(options);
 }
 //# sourceMappingURL=discovery-backend-factory.js.map

package/build/src/lib/discovery/discovery-backend-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery-backend-factory.js","sourceRoot":"","sources":["../../../../src/lib/discovery/discovery-backend-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAGrE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAA4B,OAAO,CAAC,QAAQ,EAC5C,OAA0B;IAE1B,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"discovery-backend-factory.js","sourceRoot":"","sources":["../../../../src/lib/discovery/discovery-backend-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAA4B,OAAO,CAAC,QAAQ,EAC5C,OAA0B;IAE1B,KAAK,QAAQ,CAAC;IACd,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/build/src/lib/discovery/index.d.ts

@@ -1,6 +1,5 @@
 export { createDiscoveryBackend } from './discovery-backend-factory.js';
-export { BonjourDiscoveryBackend } from './bonjour-discovery-backend.js';
-export { DnssdDiscoveryBackend } from './dnssd-discovery-backend.js';
+export { MdnsDiscoveryBackend } from './mdns-discovery-backend.js';
 export { listDevicectlDeviceRecords } from './devicectl-device-records.js';
 export type { DiscoveredDevice, DiscoveredDeviceMetadata, DiscoveryOptions, IDeviceDiscoveryBackend, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/build/src/lib/discovery/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,YAAY,CAAC"}

package/build/src/lib/discovery/index.js

@@ -1,5 +1,4 @@
 export { createDiscoveryBackend } from './discovery-backend-factory.js';
-export { BonjourDiscoveryBackend } from './bonjour-discovery-backend.js';
-export { DnssdDiscoveryBackend } from './dnssd-discovery-backend.js';
+export { MdnsDiscoveryBackend } from './mdns-discovery-backend.js';
 export { listDevicectlDeviceRecords } from './devicectl-device-records.js';
 //# sourceMappingURL=index.js.map

package/build/src/lib/discovery/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC"}

package/build/src/lib/discovery/mdns-browser.d.ts

@@ -0,0 +1,15 @@
+export interface MdnsServiceInstance {
+    instance: string;
+    host?: string;
+    port?: number;
+    addresses: string[];
+    properties: Record<string, string>;
+}
+/**
+ * Browse a DNS-SD service type on the local link (e.g. `_remotepairing._tcp`).
+ *
+ * Opens raw UDP sockets on port 5353, sends a PTR query, and parses replies
+ * without enforcing RFC 6335 service-name length limits.
+ */
+export declare function browseMdnsService(serviceType: string, domain: string, timeoutMs: number): Promise<MdnsServiceInstance[]>;
+//# sourceMappingURL=mdns-browser.d.ts.map

package/build/src/lib/discovery/mdns-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdns-browser.d.ts","sourceRoot":"","sources":["../../../../src/lib/discovery/mdns-browser.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAaD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAsFhC"}

package/build/src/lib/discovery/mdns-browser.js

@@ -0,0 +1,228 @@
+import { createSocket } from 'node:dgram';
+import { networkInterfaces } from 'node:os';
+import { setTimeout } from 'node:timers';
+import { getLogger } from '../logger.js';
+import { MDNS_MCAST_V4, MDNS_MCAST_V6, MDNS_PORT, QTYPE_A, QTYPE_AAAA, QTYPE_PTR, QTYPE_SRV, QTYPE_TXT, buildQuery, buildServiceTypeFqdn, parseMdnsMessage, } from './mdns-protocol.js';
+const log = getLogger('MdnsBrowser');
+/**
+ * Browse a DNS-SD service type on the local link (e.g. `_remotepairing._tcp`).
+ *
+ * Opens raw UDP sockets on port 5353, sends a PTR query, and parses replies
+ * without enforcing RFC 6335 service-name length limits.
+ */
+export async function browseMdnsService(serviceType, domain, timeoutMs) {
+    const serviceTypeFqdn = buildServiceTypeFqdn(serviceType, domain);
+    const sockets = await openMdnsSockets();
+    const ptrTargets = new Set();
+    const srvMap = new Map();
+    const txtMap = new Map();
+    const hostAddresses = new Map();
+    const recordAddress = (hostName, ip) => {
+        const key = hostName.endsWith('.') ? hostName : `${hostName}.`;
+        const existing = hostAddresses.get(key) ?? [];
+        if (!existing.includes(ip)) {
+            existing.push(ip);
+            hostAddresses.set(key, existing);
+        }
+    };
+    try {
+        const query = buildQuery(serviceTypeFqdn, QTYPE_PTR, false);
+        sendQueryAll(sockets, query);
+        await collectResponses(sockets, timeoutMs, (data) => {
+            let records;
+            try {
+                records = parseMdnsMessage(data);
+            }
+            catch (err) {
+                log.info(`Ignoring malformed mDNS packet (${data.length} octets)`, err);
+                return;
+            }
+            for (const rr of records) {
+                if (rr.type === QTYPE_PTR &&
+                    rr.name === serviceTypeFqdn &&
+                    rr.ptrdname) {
+                    ptrTargets.add(rr.ptrdname);
+                }
+                else if (rr.type === QTYPE_SRV && rr.name) {
+                    addSrvEntry(srvMap, rr.name, {
+                        target: rr.target,
+                        port: rr.port,
+                    });
+                }
+                else if (rr.type === QTYPE_TXT && rr.name) {
+                    txtMap.set(rr.name, rr.txt ?? {});
+                }
+                else if ((rr.type === QTYPE_A || rr.type === QTYPE_AAAA) &&
+                    rr.address &&
+                    rr.name) {
+                    recordAddress(rr.name, rr.address);
+                }
+            }
+        });
+    }
+    finally {
+        for (const handle of sockets) {
+            handle.close();
+        }
+    }
+    const results = [];
+    for (const instance of [...ptrTargets].sort()) {
+        const srvEntries = srvMap.get(instance) ?? [];
+        const properties = txtMap.get(instance) ?? {};
+        if (srvEntries.length === 0) {
+            results.push({
+                instance,
+                properties,
+                addresses: [],
+            });
+            continue;
+        }
+        for (const srv of dedupeSrvEntries(srvEntries)) {
+            const target = srv.target;
+            const host = target && target.endsWith('.') ? target.slice(0, -1) : target;
+            const addresses = target ? (hostAddresses.get(target) ?? []) : [];
+            results.push({
+                instance,
+                host,
+                port: srv.port,
+                addresses,
+                properties,
+            });
+        }
+    }
+    return results;
+}
+async function openMdnsSockets() {
+    const handles = [];
+    const errors = [];
+    try {
+        handles.push(await bindIpv4Socket());
+    }
+    catch (err) {
+        errors.push(err instanceof Error ? err : new Error(String(err)));
+    }
+    try {
+        handles.push(...(await bindIpv6Sockets()));
+    }
+    catch (err) {
+        errors.push(err instanceof Error ? err : new Error(String(err)));
+    }
+    if (handles.length === 0) {
+        const detail = errors.map((e) => e.message).join('; ');
+        throw new Error(`Failed to open mDNS sockets on UDP port ${MDNS_PORT}: ${detail}`);
+    }
+    return handles;
+}
+function bindIpv4Socket() {
+    return new Promise((resolve, reject) => {
+        const socket = createSocket({ type: 'udp4', reuseAddr: true });
+        socket.once('error', reject);
+        socket.bind(MDNS_PORT, '0.0.0.0', () => {
+            socket.removeListener('error', reject);
+            try {
+                socket.addMembership(MDNS_MCAST_V4, '0.0.0.0');
+            }
+            catch (err) {
+                log.debug(`IPv4 multicast membership skipped: ${err}`);
+            }
+            resolve({
+                socket,
+                family: 'ipv4',
+                close: () => socket.close(),
+            });
+        });
+    });
+}
+async function bindIpv6Sockets() {
+    const socket = createSocket({ type: 'udp6', reuseAddr: true });
+    try {
+        await new Promise((resolve, reject) => {
+            socket.once('error', reject);
+            socket.bind(MDNS_PORT, '::', () => {
+                socket.removeListener('error', reject);
+                resolve();
+            });
+        });
+    }
+    catch {
+        socket.close();
+        return [];
+    }
+    for (const entries of Object.values(networkInterfaces())) {
+        for (const entry of entries ?? []) {
+            if (!isIpv6Interface(entry)) {
+                continue;
+            }
+            try {
+                socket.addMembership(MDNS_MCAST_V6, entry.address);
+            }
+            catch {
+                // interface may not support multicast
+            }
+        }
+    }
+    try {
+        socket.addMembership(MDNS_MCAST_V6);
+    }
+    catch {
+        // optional default membership
+    }
+    return [
+        {
+            socket,
+            family: 'ipv6',
+            close: () => socket.close(),
+        },
+    ];
+}
+function isIpv6Interface(entry) {
+    return entry.family === 'IPv6' || entry.family === 6;
+}
+function srvEntryKey(entry) {
+    return `${entry.target ?? ''}:${entry.port ?? 0}`;
+}
+function addSrvEntry(srvMap, instance, entry) {
+    const entries = srvMap.get(instance) ?? [];
+    const key = srvEntryKey(entry);
+    if (entries.some((existing) => srvEntryKey(existing) === key)) {
+        return;
+    }
+    entries.push(entry);
+    srvMap.set(instance, entries);
+}
+function dedupeSrvEntries(entries) {
+    const seen = new Set();
+    const unique = [];
+    for (const entry of entries) {
+        const key = srvEntryKey(entry);
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        unique.push(entry);
+    }
+    return unique;
+}
+function sendQueryAll(handles, packet) {
+    for (const { socket, family } of handles) {
+        if (family !== 'ipv4') {
+            continue;
+        }
+        socket.send(packet, MDNS_PORT, MDNS_MCAST_V4);
+    }
+}
+function collectResponses(handles, timeoutMs, onMessage) {
+    return new Promise((resolve) => {
+        const onData = (chunk) => onMessage(chunk);
+        for (const { socket } of handles) {
+            socket.on('message', onData);
+        }
+        setTimeout(() => {
+            for (const { socket } of handles) {
+                socket.off('message', onData);
+            }
+            resolve();
+        }, timeoutMs);
+    });
+}
+//# sourceMappingURL=mdns-browser.js.map

package/build/src/lib/discovery/mdns-browser.js.map

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

package/build/src/lib/discovery/mdns-discovery-backend.d.ts

@@ -0,0 +1,15 @@
+import { BaseDiscoveryBackend } from './base-discovery-backend.js';
+import type { DiscoveredDevice, DiscoveryOptions } from './types.js';
+/**
+ * Cross-platform discovery via a raw mDNS browser (UDP port 5353).
+ *
+ * Unlike the `dnssd` npm package or strict pure-JS mDNS clients, this path
+ * does not enforce RFC 6335 service-name length limits, so Apple's long
+ * DNS-SD types (e.g. `_remotepairing-manual-pairing._tcp`) work on all
+ * platforms.
+ */
+export declare class MdnsDiscoveryBackend extends BaseDiscoveryBackend {
+    constructor(options?: DiscoveryOptions);
+    protected runDiscovery(timeoutMs: number): Promise<DiscoveredDevice[]>;
+}
+//# sourceMappingURL=mdns-discovery-backend.d.ts.map

package/build/src/lib/discovery/mdns-discovery-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdns-discovery-backend.d.ts","sourceRoot":"","sources":["../../../../src/lib/discovery/mdns-discovery-backend.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AASnE,OAAO,KAAK,EACV,gBAAgB,EAEhB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAIpB;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,oBAAoB;gBAChD,OAAO,CAAC,EAAE,gBAAgB;cAIb,YAAY,CACnC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAiC/B"}

package/build/src/lib/discovery/mdns-discovery-backend.js

@@ -0,0 +1,102 @@
+import { getLogger } from '../logger.js';
+import { BaseDiscoveryBackend } from './base-discovery-backend.js';
+import { DISCOVERY_DEFAULT_TIMEOUT_MS } from './constants.js';
+import { normalizeHostname, resolveIpAddress } from './discovery-utils.js';
+import { browseMdnsService } from './mdns-browser.js';
+import { MDNS_PORT, buildServiceTypeFqdn, decodeDnsSdInstanceName, } from './mdns-protocol.js';
+const log = getLogger('MdnsDiscoveryBackend');
+/**
+ * Cross-platform discovery via a raw mDNS browser (UDP port 5353).
+ *
+ * Unlike the `dnssd` npm package or strict pure-JS mDNS clients, this path
+ * does not enforce RFC 6335 service-name length limits, so Apple's long
+ * DNS-SD types (e.g. `_remotepairing-manual-pairing._tcp`) work on all
+ * platforms.
+ */
+export class MdnsDiscoveryBackend extends BaseDiscoveryBackend {
+    constructor(options) {
+        super(options);
+    }
+    async runDiscovery(timeoutMs) {
+        const browseTimeout = Math.max(timeoutMs, DISCOVERY_DEFAULT_TIMEOUT_MS);
+        let instances;
+        try {
+            instances = await browseMdnsService(this.serviceType, this.domain, browseTimeout);
+        }
+        catch (err) {
+            const message = formatMdnsBrowseError(err);
+            log.warn(message);
+            throw new Error(message, { cause: err });
+        }
+        if (instances.length === 0) {
+            return [];
+        }
+        const settled = await Promise.allSettled(instances.map((instance) => instanceToDevice(instance, this.serviceType, this.domain)));
+        const devices = settled
+            .filter((item) => item.status === 'fulfilled')
+            .map((item) => item.value)
+            .filter((device) => device !== null);
+        return dedupeDiscoveredDevices(devices);
+    }
+}
+function dedupeDiscoveredDevices(devices) {
+    const seen = new Map();
+    for (const device of devices) {
+        const key = `${device.id}:${device.hostname ?? ''}:${device.port ?? 0}`;
+        if (!seen.has(key)) {
+            seen.set(key, device);
+        }
+    }
+    return [...seen.values()];
+}
+async function instanceToDevice(instance, serviceType, domain) {
+    try {
+        const name = extractInstanceName(instance.instance, serviceType, domain);
+        const hostname = normalizeHostname(instance.host);
+        if (!hostname || !instance.port) {
+            return null;
+        }
+        const ipv4 = instance.addresses.find((addr) => !addr.includes(':'));
+        const ip = await resolveIpAddress(hostname, ipv4 ? [ipv4] : instance.addresses);
+        const txt = instance.properties;
+        const identifier = txt.identifier ?? name;
+        const metadata = {
+            identifier,
+            model: txt.model ?? '',
+            version: txt.ver ?? '',
+        };
+        return {
+            id: identifier,
+            name,
+            hostname,
+            ip,
+            port: instance.port,
+            metadata,
+        };
+    }
+    catch (err) {
+        log.warn(`Failed to process mDNS service ${instance.instance}: ${err}`);
+        return null;
+    }
+}
+function extractInstanceName(instanceFqdn, serviceType, domain) {
+    const suffix = buildServiceTypeFqdn(serviceType, domain);
+    const normalized = instanceFqdn.endsWith('.')
+        ? instanceFqdn
+        : `${instanceFqdn}.`;
+    if (normalized.endsWith(suffix)) {
+        const raw = normalized.slice(0, -suffix.length).replace(/\.$/, '');
+        return decodeDnsSdInstanceName(raw);
+    }
+    const firstLabel = normalized.slice(0, -1).split('.')[0] ?? normalized;
+    return decodeDnsSdInstanceName(firstLabel);
+}
+function formatMdnsBrowseError(err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    const base = `mDNS browse failed: ${detail}`;
+    if (typeof process.getuid === 'function' && process.getuid() !== 0) {
+        return `${base}. Binding to UDP port ${MDNS_PORT} may require elevated privileges; try running with sudo.`;
+    }
+    return base;
+}
+//# sourceMappingURL=mdns-discovery-backend.js.map

package/build/src/lib/discovery/mdns-discovery-backend.js.map

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

package/build/src/lib/discovery/mdns-protocol.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Minimal DNS/mDNS packet helpers for raw service browsing.
+ *
+ * No third-party mDNS library and no RFC 6335 service-name length checks, so
+ * Apple's long DNS-SD types work.
+ */
+export declare const MDNS_PORT = 5353;
+export declare const MDNS_MCAST_V4 = "224.0.0.251";
+export declare const MDNS_MCAST_V6 = "ff02::fb";
+export declare const QTYPE_A = 1;
+export declare const QTYPE_PTR = 12;
+export declare const QTYPE_TXT = 16;
+export declare const QTYPE_AAAA = 28;
+export declare const QTYPE_SRV = 33;
+export interface ParsedResourceRecord {
+    name: string;
+    type: number;
+    class: number;
+    ttl: number;
+    ptrdname?: string;
+    priority?: number;
+    weight?: number;
+    port?: number;
+    target?: string;
+    txt?: Record<string, string>;
+    address?: string;
+    raw?: Buffer;
+}
+/** Encode a dotted DNS name as a length-prefixed wire-format name. */
+export declare function encodeName(name: string): Buffer;
+/** Decode a wire-format DNS name starting at `offset`. */
+export declare function decodeName(data: Buffer, offset: number): {
+    name: string;
+    offset: number;
+};
+/** Build a DNS query packet with a single question. */
+export declare function buildQuery(name: string, qtype: number, unicast?: boolean): Buffer;
+/** Parse answer/authority/additional records from an mDNS response packet. */
+export declare function parseMdnsMessage(data: Buffer): ParsedResourceRecord[];
+/**
+ * Decode DNS-SD decimal escape sequences in instance names (e.g. `\032` → space).
+ *
+ * Per RFC 6763, `\DDD` uses three decimal digits for the byte value, not octal.
+ */
+export declare function decodeDnsSdInstanceName(name: string): string;
+/** Build a trailing-dot FQDN from a DNS-SD type and domain (e.g. `local`). */
+export declare function buildServiceTypeFqdn(serviceType: string, domain: string): string;
+//# sourceMappingURL=mdns-protocol.d.ts.map

package/build/src/lib/discovery/mdns-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdns-protocol.d.ts","sourceRoot":"","sources":["../../../../src/lib/discovery/mdns-protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,SAAS,OAAO,CAAC;AAC9B,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAC3C,eAAO,MAAM,aAAa,aAAa,CAAC;AAExC,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,SAAS,KAAK,CAAC;AA+B5B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmB/C;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAwElC;AAED,uDAAuD;AACvD,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,UAAQ,GACd,MAAM,CAaR;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAuBrE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,MAAM,CAMR"}