appium-ios-remotexpc 0.21.2 → 0.23.0

package/build/src/lib/apple-tv/tunnel/tunnel-service.js

@@ -0,0 +1,357 @@
+import { util } from '@appium/support';
+import { lookup } from 'node:dns/promises';
+import * as tls from 'node:tls';
+import { BonjourDiscovery } from '../../bonjour/bonjour-discovery.js';
+import { getLogger } from '../../logger.js';
+import { DEFAULT_PAIRING_CONFIG } from '../constants.js';
+import { decryptChaCha20Poly1305, encryptChaCha20Poly1305, } from '../encryption/index.js';
+import { PairingError } from '../errors.js';
+import { NetworkClient } from '../network/index.js';
+import { PairVerificationProtocol } from '../pairing-protocol/index.js';
+import { PairingStorage } from '../storage/pairing-storage.js';
+const appleTVLog = getLogger('AppleTVTunnelService');
+export class TunnelService {
+    networkClient;
+    keys;
+    sequenceNumber;
+    static log = getLogger('TunnelService');
+    encryptedSequenceNumber = 0;
+    constructor(networkClient, keys, sequenceNumber) {
+        this.networkClient = networkClient;
+        this.keys = keys;
+        this.sequenceNumber = sequenceNumber;
+    }
+    async createTcpListener() {
+        TunnelService.log.debug('Creating TCP listener (Encrypted Request)');
+        const request = {
+            request: {
+                _0: {
+                    createListener: {
+                        key: this.keys.encryptionKey.toString('base64'),
+                        peerConnectionsInfo: [
+                            {
+                                owningPID: process.pid,
+                                owningProcessName: 'CoreDeviceService',
+                            },
+                        ],
+                        transportProtocolType: 'tcp',
+                    },
+                },
+            },
+        };
+        const nonce = Buffer.alloc(12);
+        nonce.writeBigUInt64LE(BigInt(this.encryptedSequenceNumber), 0);
+        const requestJson = JSON.stringify(request);
+        const encrypted = encryptChaCha20Poly1305({
+            plaintext: Buffer.from(requestJson, 'utf8'),
+            key: this.keys.clientEncryptionKey,
+            nonce,
+        });
+        const encryptedPayload = {
+            message: {
+                streamEncrypted: {
+                    _0: encrypted.toString('base64'),
+                },
+            },
+            originatedBy: 'host',
+            sequenceNumber: this.sequenceNumber++,
+        };
+        await this.networkClient.sendPacket(encryptedPayload);
+        this.encryptedSequenceNumber++;
+        const response = await this.networkClient.receiveResponse();
+        const encryptedData = response.message?.streamEncrypted?._0;
+        if (!encryptedData) {
+            throw new PairingError('Failed to receive encrypted response from device', 'ENCRYPTED_RESPONSE_MISSING', { response });
+        }
+        const responseNonce = Buffer.alloc(12);
+        responseNonce.writeBigUInt64LE(BigInt(this.encryptedSequenceNumber - 1), 0);
+        const decrypted = decryptChaCha20Poly1305({
+            ciphertext: Buffer.from(encryptedData, 'base64'),
+            key: this.keys.serverEncryptionKey,
+            nonce: responseNonce,
+        });
+        const responseJson = JSON.parse(decrypted.toString('utf8'));
+        const createListenerResponse = responseJson?.response?._1?.createListener;
+        if (!createListenerResponse?.port) {
+            TunnelService.log.error('Invalid createListener response:', responseJson);
+            throw new PairingError('TCP listener creation failed: missing port in response', 'LISTENER_PORT_MISSING', { response: responseJson });
+        }
+        TunnelService.log.debug(`TCP Listener created on port: ${createListenerResponse.port}`);
+        return createListenerResponse;
+    }
+    async createTlsPskConnection(hostname, port) {
+        TunnelService.log.debug(`Creating TLS-PSK connection to ${hostname}:${port}`);
+        return new Promise((resolve, reject) => {
+            const options = {
+                host: hostname,
+                port,
+                pskCallback: (hint) => {
+                    TunnelService.log.debug(`PSK callback invoked with hint: ${hint}`);
+                    return {
+                        psk: this.keys.encryptionKey,
+                        identity: '',
+                    };
+                },
+                ciphers: 'PSK-AES256-CBC-SHA:PSK-AES128-CBC-SHA:PSK-3DES-EDE-CBC-SHA:PSK-RC4-SHA:PSK',
+                secureProtocol: 'TLSv1_2_method',
+                // SECURITY NOTE: Disabling certificate validation is intentional and safe in this context.
+                // This connection uses TLS-PSK (Pre-Shared Key) authentication, where the pre-shared key
+                // itself provides mutual authentication between client and server. Traditional X.509
+                // certificate validation is not used in PSK-based TLS connections. The encryption key
+                // was securely established during the pairing process (which involves PIN verification),
+                // and this key authenticates both parties. This is the standard approach for Apple TV's
+                // RemoteXPC protocol and should NOT be changed to use certificate validation.
+                rejectUnauthorized: false,
+                checkServerIdentity: () => undefined,
+            };
+            const socket = tls.connect(options, () => {
+                TunnelService.log.debug('TLS-PSK connection established');
+                resolve(socket);
+            });
+            socket.on('error', (error) => {
+                TunnelService.log.error('TLS-PSK connection error:', error);
+                if (error.message?.includes('no shared cipher') ||
+                    error.code === 'ECONNRESET') {
+                    TunnelService.log.error('PSK ciphers may not be available in your Node.js build');
+                    TunnelService.log.error('You may need to:');
+                    TunnelService.log.error('1. Use Node.js compiled with PSK-enabled OpenSSL');
+                    TunnelService.log.error('2. Use a Python subprocess for the TLS-PSK connection');
+                    TunnelService.log.error('3. Use a native module like node-openssl');
+                }
+                reject(error);
+            });
+            socket.on('secureConnect', () => {
+                TunnelService.log.debug('Secure connection event fired');
+            });
+            socket.on('tlsClientError', (error) => {
+                TunnelService.log.error('TLS client error:', error);
+            });
+        });
+    }
+    getSequenceNumber() {
+        return this.sequenceNumber;
+    }
+}
+/**
+ * High-level service for establishing Apple TV tunnels.
+ * Orchestrates device discovery, pairing verification, and tunnel creation.
+ */
+export class AppleTVTunnelService {
+    networkClient;
+    storage;
+    sequenceNumber = 0;
+    constructor() {
+        this.networkClient = new NetworkClient(DEFAULT_PAIRING_CONFIG);
+        this.storage = new PairingStorage(DEFAULT_PAIRING_CONFIG);
+    }
+    disconnect() {
+        this.networkClient.disconnect();
+    }
+    async startTunnel(deviceId, specificDeviceIdentifier) {
+        const devices = await this.discoverDevices();
+        this.logDiscoveredDevices(devices);
+        const devicesToProcess = this.selectDevicesToProcess(devices, specificDeviceIdentifier);
+        const identifiersToTry = await this.validateAndGetPairRecords(deviceId);
+        const failedAttempts = [];
+        for (const device of devicesToProcess) {
+            for (const identifier of identifiersToTry) {
+                appleTVLog.debug(`\n--- Attempting connection with pair record: ${identifier} ---`);
+                appleTVLog.debug(`Device: ${device.ip}:${device.port}`);
+                const pairRecord = await this.storage.load(identifier);
+                if (!pairRecord) {
+                    appleTVLog.debug(`Failed to load pair record for ${identifier}`);
+                    failedAttempts.push({
+                        identifier,
+                        error: 'Failed to load pair record',
+                    });
+                    continue;
+                }
+                const result = await this.attemptDeviceConnection(device, identifier, pairRecord, failedAttempts);
+                if (result) {
+                    return result;
+                }
+            }
+        }
+        this.logFailureSummary(failedAttempts);
+        throw new Error('Failed to establish tunnel with any pair record. All authentication attempts failed.');
+    }
+    /**
+     * Logs information about discovered devices
+     */
+    logDiscoveredDevices(devices) {
+        appleTVLog.debug('Step 1: Device Discovery success');
+        appleTVLog.debug(`Found ${util.pluralize('device', devices.length, true)} via Bonjour`);
+        if (devices.length > 0) {
+            appleTVLog.info('\nDiscovered Apple TV devices:');
+            devices.forEach((device, index) => {
+                appleTVLog.info(`  ${index + 1}. Identifier: ${device.identifier}`);
+                appleTVLog.info(`     Name: ${device.name}`);
+                appleTVLog.info(`     IP: ${device.ip}:${device.port}`);
+                appleTVLog.info(`     Model: ${device.model}`);
+                appleTVLog.info(`     Version: ${device.version}`);
+            });
+        }
+    }
+    /**
+     * Selects devices to process based on the specific device identifier
+     */
+    selectDevicesToProcess(devices, specificDeviceIdentifier) {
+        if (!specificDeviceIdentifier) {
+            return devices;
+        }
+        const filteredDevices = devices.filter((device) => device.identifier === specificDeviceIdentifier);
+        if (filteredDevices.length === 0) {
+            appleTVLog.error(`\nDevice with identifier ${specificDeviceIdentifier} not found in discovered devices.`);
+            appleTVLog.error('Available devices:');
+            devices.forEach((device) => {
+                appleTVLog.error(`  - ${device.identifier} (${device.name})`);
+            });
+            throw new Error(`Device with identifier ${specificDeviceIdentifier} not found. Please check available devices above.`);
+        }
+        appleTVLog.info(`\nFiltered to specific device: ${specificDeviceIdentifier}`);
+        return filteredDevices;
+    }
+    /**
+     * Validates pair records and returns the list of identifiers to try
+     */
+    async validateAndGetPairRecords(deviceId) {
+        const availableDeviceIds = await this.storage.getAvailableDeviceIds();
+        if (availableDeviceIds.length === 0) {
+            throw new Error('No pair records found');
+        }
+        if (deviceId && !availableDeviceIds.includes(deviceId)) {
+            throw new Error(`No pair record found for specified device ${deviceId}`);
+        }
+        return deviceId ? [deviceId] : availableDeviceIds;
+    }
+    /**
+     * Attempts to establish a connection with a device using a specific pair record
+     */
+    async attemptDeviceConnection(device, identifier, pairRecord, failedAttempts) {
+        try {
+            this.sequenceNumber = 0;
+            await this.networkClient.connect(device.ip, device.port);
+            try {
+                await this.performHandshake();
+                const keys = await this.performPairVerification(pairRecord, identifier);
+                appleTVLog.info(`✅ Successfully verified with pair record: ${identifier}`);
+                const listenerInfo = await this.createTcpListener(keys);
+                this.networkClient.disconnect();
+                const tlsSocket = await this.createTlsPskConnection(device.ip, listenerInfo.port, keys);
+                appleTVLog.debug('Step 6: Tunnel Establishment success');
+                appleTVLog.info(`🔑 Using pair record: ${identifier}`);
+                appleTVLog.info(`📱 Connected to device: ${device.identifier} (${device.name})`);
+                appleTVLog.info(`   IP: ${device.ip}:${device.port}`);
+                return { socket: tlsSocket, device };
+            }
+            catch (error) {
+                const errorMessage = error.message || String(error);
+                appleTVLog.debug(`❌ Failed with pair record ${identifier}: ${errorMessage}`);
+                failedAttempts.push({ identifier, error: errorMessage });
+                this.networkClient.disconnect();
+                await new Promise((resolve) => setTimeout(resolve, 500));
+            }
+        }
+        catch (connectionError) {
+            const errorMessage = connectionError.message || String(connectionError);
+            appleTVLog.debug(`Failed to connect to ${device.ip}:${device.port}: ${errorMessage}`);
+            failedAttempts.push({
+                identifier,
+                error: `Connection failed: ${errorMessage}`,
+            });
+            this.networkClient.disconnect();
+        }
+        return null;
+    }
+    /**
+     * Logs a summary of all failed connection attempts
+     */
+    logFailureSummary(failedAttempts) {
+        appleTVLog.error('\n=== Pair Record Verification Summary ===');
+        appleTVLog.error(`Total pair records tried: ${failedAttempts.length}`);
+        failedAttempts.forEach(({ identifier, error }) => {
+            appleTVLog.error(`  - ${identifier}: ${error}`);
+        });
+        appleTVLog.error('=======================================\n');
+    }
+    async discoverDevices() {
+        const discovery = new BonjourDiscovery();
+        await discovery.startBrowsing('_remotepairing._tcp', 'local');
+        await new Promise((resolve) => setTimeout(resolve, DEFAULT_PAIRING_CONFIG.discoveryTimeout));
+        const services = discovery.getDiscoveredServices();
+        const devices = [];
+        for (const service of services) {
+            try {
+                const resolved = await discovery.resolveService(service.name, '_remotepairing._tcp', 'local');
+                if (resolved.hostname && resolved.port) {
+                    const ipResult = await lookup(resolved.hostname.endsWith('.')
+                        ? resolved.hostname.slice(0, -1)
+                        : resolved.hostname, { family: 4 });
+                    devices.push({
+                        name: resolved.name,
+                        identifier: resolved.txtRecord?.identifier || resolved.name,
+                        hostname: resolved.hostname,
+                        ip: ipResult.address,
+                        port: resolved.port,
+                        model: resolved.txtRecord?.model || '',
+                        version: resolved.txtRecord?.ver || '',
+                        minVersion: resolved.txtRecord?.minVer || '17',
+                    });
+                }
+            }
+            catch (err) {
+                appleTVLog.debug(`Failed to resolve service ${service.name}: ${err}`);
+            }
+        }
+        discovery.stopBrowsing();
+        if (devices.length === 0) {
+            throw new Error('No devices found via Bonjour discovery');
+        }
+        return devices;
+    }
+    async performHandshake() {
+        const handshakePayload = {
+            message: {
+                plain: {
+                    _0: {
+                        request: {
+                            _0: {
+                                handshake: {
+                                    _0: {
+                                        hostOptions: { attemptPairVerify: true },
+                                        wireProtocolVersion: 19,
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            originatedBy: 'host',
+            sequenceNumber: this.sequenceNumber++,
+        };
+        await this.networkClient.sendPacket(handshakePayload);
+        await this.networkClient.receiveResponse();
+        appleTVLog.debug('Step 2: Initial Connection & Handshake success');
+    }
+    async performPairVerification(pairRecord, deviceId) {
+        appleTVLog.debug('Step 3: Pair Verification (4-step process)');
+        const verificationProtocol = new PairVerificationProtocol(this.networkClient);
+        verificationProtocol.setSequenceNumber(this.sequenceNumber);
+        const keys = await verificationProtocol.verify(pairRecord, deviceId);
+        this.sequenceNumber = verificationProtocol.getSequenceNumber();
+        appleTVLog.debug('Step 4: Main Encryption Key Derivation success');
+        return keys;
+    }
+    async createTcpListener(keys) {
+        appleTVLog.debug('Step 5: TCP Listener Creation (Encrypted Request)');
+        const tunnelService = new TunnelService(this.networkClient, keys, this.sequenceNumber);
+        const listenerInfo = await tunnelService.createTcpListener();
+        this.sequenceNumber = tunnelService.getSequenceNumber();
+        return listenerInfo;
+    }
+    async createTlsPskConnection(hostname, port, keys) {
+        const tunnelService = new TunnelService(this.networkClient, keys, this.sequenceNumber);
+        return tunnelService.createTlsPskConnection(hostname, port);
+    }
+}

package/build/src/lib/apple-tv/tunnel/types.d.ts

@@ -0,0 +1,22 @@
+import type * as tls from 'node:tls';
+export interface TcpListenerInfo {
+    port: number;
+    serviceName: string;
+    devicePublicKey: string;
+}
+/**
+ * Extended TLS connection options that include PSK (Pre-Shared Key) callback support.
+ * This interface extends the standard Node.js TLS ConnectionOptions to add PSK authentication.
+ */
+export interface TlsPskConnectionOptions extends tls.ConnectionOptions {
+    /**
+     * Callback function invoked during TLS handshake to provide PSK credentials.
+     * @param hint - Optional hint from the server about which PSK identity to use
+     * @returns Object containing the pre-shared key and identity string
+     */
+    pskCallback?: (hint: string | null) => {
+        psk: Buffer;
+        identity: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/build/src/lib/apple-tv/tunnel/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/tunnel/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,UAAU,CAAC;AAErC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,GAAG,CAAC,iBAAiB;IACpE;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK;QACrC,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH"}

package/build/src/lib/apple-tv/tunnel/types.js

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

package/build/src/lib/bonjour/bonjour-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bonjour-discovery.d.ts","sourceRoot":"","sources":["../../../../src/lib/bonjour/bonjour-discovery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAkB3C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,KAAK,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;CACzB,CAAC,CAAC;AAwXH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,cAAc,CAAC,CAAe;IACtC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA0C;IAE9E;;OAEG;IACG,aAAa,CACjB,WAAW,GAAE,MAA+C,EAC5D,MAAM,GAAE,MAA+B,GACtC,OAAO,CAAC,IAAI,CAAC;IAgBhB;;OAEG;IACH,YAAY,IAAI,IAAI;IAQpB;;OAEG;IACH,qBAAqB,IAAI,cAAc,EAAE;IAIzC;;OAEG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAA+C,EAC5D,MAAM,GAAE,MAA+B,GACtC,OAAO,CAAC,cAAc,CAAC;IAoB1B;;OAEG;IACG,4BAA4B,CAChC,SAAS,GAAE,MAA2C,GACrD,OAAO,CAAC,aAAa,EAAE,CAAC;IAqB3B;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAsBzC;;OAEG;YACW,kBAAkB;IA4BhC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAuBhC;;OAEG;YACW,kBAAkB;IAuBhC;;OAEG;IACH,OAAO,CAAC,OAAO;CAMhB"}
+{"version":3,"file":"bonjour-discovery.d.ts","sourceRoot":"","sources":["../../../../src/lib/bonjour/bonjour-discovery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAkB3C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,KAAK,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;CACzB,CAAC,CAAC;AAwXH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,cAAc,CAAC,CAAe;IACtC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA0C;IAE9E;;OAEG;IACG,aAAa,CACjB,WAAW,GAAE,MAA+C,EAC5D,MAAM,GAAE,MAA+B,GACtC,OAAO,CAAC,IAAI,CAAC;IAgBhB;;OAEG;IACH,YAAY,IAAI,IAAI;IAQpB;;OAEG;IACH,qBAAqB,IAAI,cAAc,EAAE;IAIzC;;OAEG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAA+C,EAC5D,MAAM,GAAE,MAA+B,GACtC,OAAO,CAAC,cAAc,CAAC;IAkB1B;;OAEG;IACG,4BAA4B,CAChC,SAAS,GAAE,MAA2C,GACrD,OAAO,CAAC,aAAa,EAAE,CAAC;IAqB3B;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAsBzC;;OAEG;YACW,kBAAkB;IA4BhC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAuBhC;;OAEG;YACW,kBAAkB;IAuBhC;;OAEG;IACH,OAAO,CAAC,OAAO;CAMhB"}

package/build/src/lib/bonjour/bonjour-discovery.js

@@ -310,7 +310,7 @@ export class BonjourDiscovery extends EventEmitter {
             log.warn('Already discovering services');
             return;
         }
-        log.info(`Starting Bonjour discovery for ${serviceType}.${domain}`);
+        log.info('Starting Bonjour discovery');
         try {
             await this.initializeBrowsing(serviceType, domain);
         }
@@ -339,7 +339,7 @@ export class BonjourDiscovery extends EventEmitter {
      * Resolve a specific service to get detailed information
      */
     async resolveService(serviceName, serviceType = BONJOUR_SERVICE_TYPES.APPLE_TV_PAIRING, domain = BONJOUR_DEFAULT_DOMAIN) {
-        log.info(`[ServiceResolver] Resolving service: ${serviceName}.${serviceType}.${domain}`);
+        log.info(`[ServiceResolver] Resolving service: ${serviceName}`);
         const service = await executeDnsSdCommand([DNS_SD_COMMANDS.RESOLVE, serviceName, serviceType, domain], BONJOUR_TIMEOUTS.SERVICE_RESOLUTION, (output) => parseResolveOutput(output, serviceName, serviceType, domain), `Service resolution timeout for ${serviceName}`);
         if (!service) {
             throw new Error(`Failed to resolve service ${serviceName}`);
@@ -374,7 +374,7 @@ export class BonjourDiscovery extends EventEmitter {
                 case DNS_SD_ACTIONS.ADD:
                     this._discoveredServices.set(service.name, service);
                     this.emit('serviceAdded', service);
-                    log.info(`Discovered service: ${service.name}`);
+                    log.debug(`Discovered service: ${service.name}`);
                     break;
                 case DNS_SD_ACTIONS.REMOVE:
                     this._discoveredServices.delete(service.name);

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

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

package/build/src/lib/plist/length-based-splitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"length-based-splitter.d.ts","sourceRoot":"","sources":["../../../../src/lib/plist/length-based-splitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AA2B3D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,SAAS,CAAkB;IAEnC;;;OAGG;gBACS,OAAO,GAAE,0BAA+B;IAkBpD;;OAEG;IACH,QAAQ,IAAI,IAAI;IAUhB,UAAU,CACR,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,iBAAiB,GAC1B,IAAI;IA6CP;;OAEG;IACH,OAAO,CAAC,cAAc;IA+CtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAsG1B"}
+{"version":3,"file":"length-based-splitter.d.ts","sourceRoot":"","sources":["../../../../src/lib/plist/length-based-splitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AA2B3D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,SAAS,CAAkB;IAEnC;;;OAGG;gBACS,OAAO,GAAE,0BAA+B;IAkBpD;;OAEG;IACH,QAAQ,IAAI,IAAI;IAUhB,UAAU,CACR,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,iBAAiB,GAC1B,IAAI;IAsCP;;OAEG;IACH,OAAO,CAAC,cAAc;IA+CtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAuF1B"}

package/build/src/lib/plist/length-based-splitter.js

@@ -55,8 +55,6 @@ export class LengthBasedSplitter extends Transform {
         try {
             // Add the new chunk to our buffer
             this.buffer = Buffer.concat([this.buffer, chunk]);
-            // Check if this is XML data or binary plist before doing any other processing
-            const bufferString = this.buffer.toString(UTF8_ENCODING, 0, Math.min(MAX_PREVIEW_LENGTH, this.buffer.length));
             // Check for binary plist format (bplist00 or Ibplist00)
             if (this.buffer.length >= BINARY_PLIST_HEADER_LENGTH) {
                 const possibleBplistHeader = this.buffer.toString(UTF8_ENCODING, 0, BINARY_PLIST_HEADER_LENGTH);
@@ -157,17 +155,12 @@ export class LengthBasedSplitter extends Transform {
                         messageLength = alternateLength;
                     }
                     else {
-                        // If length is still invalid, check if this might actually be XML
-                        const suspiciousData = this.buffer.toString(UTF8_ENCODING, 0, Math.min(MAX_PREVIEW_LENGTH, this.buffer.length));
                         // Invalid length - skip one byte and try again
                         this.buffer = this.buffer.slice(1);
                         continue;
                     }
                 }
                 else {
-                    // For non-4-byte length fields, just use the original approach
-                    // If length is invalid, check if this might actually be XML
-                    const suspiciousData = this.buffer.toString(UTF8_ENCODING, 0, Math.min(MAX_PREVIEW_LENGTH, this.buffer.length));
                     // Invalid length - skip one byte and try again
                     this.buffer = this.buffer.slice(1);
                     continue;

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

@@ -67,4 +67,5 @@ declare class TunnelManagerService {
 export declare const TunnelManager: TunnelManagerService;
 export { PacketStreamClient } from './packet-stream-client.js';
 export { PacketStreamServer } from './packet-stream-server.js';
+export type { TunnelConnection };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/tunnel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAGrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAsB7E;;;GAGG;AACH,cAAM,oBAAoB;IAExB,OAAO,CAAC,cAAc,CAA+C;IAErE;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAKtC;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAM5B;;;;;;OAMG;IACG,yBAAyB,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,CAAC;IA2C/B;;;;;;OAMG;IACG,SAAS,CAAC,mBAAmB,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmD1E;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAU5D;;;;;OAKG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC1D;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAatC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAGnC;AAGD,eAAO,MAAM,aAAa,sBAA6B,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/tunnel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAGrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAc7E;;;GAGG;AACH,cAAM,oBAAoB;IAExB,OAAO,CAAC,cAAc,CAA+C;IAErE;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAKtC;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAM5B;;;;;;OAMG;IACG,yBAAyB,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,CAAC;IA2C/B;;;;;;OAMG;IACG,SAAS,CAAC,mBAAmB,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmD1E;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAU5D;;;;;OAKG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC1D;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAatC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAGnC;AAGD,eAAO,MAAM,aAAa,sBAA6B,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/build/src/lib/tunnel/packet-stream-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"packet-stream-server.d.ts","sourceRoot":"","sources":["../../../../src/lib/tunnel/packet-stream-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAetC;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAKtC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,cAAc,CAA+B;gBAExB,IAAI,EAAE,MAAM;IAIzC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,iBAAiB,IAAI,cAAc,GAAG,IAAI;IAI1C;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,aAAa;CAItB"}
+{"version":3,"file":"packet-stream-server.d.ts","sourceRoot":"","sources":["../../../../src/lib/tunnel/packet-stream-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAOtC;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAKtC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,cAAc,CAA+B;gBAExB,IAAI,EAAE,MAAM;IAIzC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,iBAAiB,IAAI,cAAc,GAAG,IAAI;IAI1C;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,aAAa;CAItB"}

package/build/src/lib/tunnel/tunnel-registry-server.d.ts

@@ -1,4 +1,5 @@
 import type { TunnelRegistry } from '../types.js';
+export declare const DEFAULT_TUNNEL_REGISTRY_PORT = 42314;
 /**
  * Tunnel Registry Server - provides API endpoints for tunnel registry operations
  */

package/build/src/lib/tunnel/tunnel-registry-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tunnel-registry-server.d.ts","sourceRoot":"","sources":["../../../../src/lib/tunnel/tunnel-registry-server.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,aAAa,CAAC;AAuDvE;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,CAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,cAAc,CAAC;IACpC,OAAO,CAAC,QAAQ,CAOd;IAEF;;;;OAIG;gBACS,WAAW,EAAE,cAAc,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM;IAKjE;;OAEG;IACH,OAAO,KAAK,OAAO,GAElB;IAED;;OAEG;IACH,OAAO,KAAK,QAAQ,GAOnB;IAED;;OAEG;IACH,OAAO,KAAK,YAAY,GAKvB;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B;;OAEG;YACW,aAAa;IA6D3B;;OAEG;YACW,aAAa;IAY3B;;OAEG;YACW,eAAe;IAwB7B;;OAEG;YACW,mBAAmB;IAgCjC;;OAEG;YACW,YAAY;IAqD1B;;OAEG;YACW,YAAY;CAmB3B;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,cAAc,GAAG,SAAS,EACvC,IAAI,GAAE,MAAqC,GAC1C,OAAO,CAAC,oBAAoB,CAAC,CAI/B"}
+{"version":3,"file":"tunnel-registry-server.d.ts","sourceRoot":"","sources":["../../../../src/lib/tunnel/tunnel-registry-server.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,aAAa,CAAC;AAGvE,eAAO,MAAM,4BAA4B,QAAQ,CAAC;AAoDlD;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,CAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,cAAc,CAAC;IACpC,OAAO,CAAC,QAAQ,CAOd;IAEF;;;;OAIG;gBACS,WAAW,EAAE,cAAc,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM;IAKjE;;OAEG;IACH,OAAO,KAAK,OAAO,GAElB;IAED;;OAEG;IACH,OAAO,KAAK,QAAQ,GAOnB;IAED;;OAEG;IACH,OAAO,KAAK,YAAY,GAKvB;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B;;OAEG;YACW,aAAa;IA6D3B;;OAEG;YACW,aAAa;IAY3B;;OAEG;YACW,eAAe;IAwB7B;;OAEG;YACW,mBAAmB;IAgCjC;;OAEG;YACW,YAAY;IAqD1B;;OAEG;YACW,YAAY;CAmB3B;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,cAAc,GAAG,SAAS,EACvC,IAAI,GAAE,MAAqC,GAC1C,OAAO,CAAC,oBAAoB,CAAC,CAI/B"}

package/build/src/lib/tunnel/tunnel-registry-server.js

@@ -2,7 +2,7 @@ import * as http from 'node:http';
 import { URL } from 'node:url';
 import { getLogger } from '../logger.js';
 // Constants
-const DEFAULT_TUNNEL_REGISTRY_PORT = 42314;
+export const DEFAULT_TUNNEL_REGISTRY_PORT = 42314;
 const API_BASE_PATH = '/remotexpc/tunnels';
 // Logger instance
 const log = getLogger('TunnelRegistryServer');

package/build/src/lib/types.d.ts

@@ -1322,4 +1322,63 @@ export interface MisagentServiceWithConnection {
     misagentService: MisagentService;
     remoteXPC: RemoteXpcConnection;
 }
+/**
+ * Options for pulling crash reports from device to local
+ */
+export interface CrashReportsPullOptions {
+    /**
+     * If true, deletes crash reports from the remote device after pulling to local.
+     * @default false
+     */
+    erase?: boolean;
+    /**
+     * Glob pattern to filter crash reports (e.g., '*.ips', 'Siri*', '**\/*.crash')
+     */
+    match?: string;
+}
+/**
+ * CrashReportsService provides an API to manage crash reports on iOS devices
+ */
+export interface CrashReportsService extends BaseService {
+    /**
+     * List files and folders in the crash report's directory
+     *
+     * Crash reports are primarily stored as .ips files, which contain detailed information about
+     * app crashes, including stack traces, thread states, and device information.
+     * In addition to .ips files, the crash reports directory may contain:
+     * - Sysdiagnose tarballs (comprehensive system diagnostic archives)
+     * - Special directories like /Retired, /Cloud, /Assistant, etc.
+     *
+     * For details on the .ips file format, see:
+     * https://developer.apple.com/documentation/xcode/analyzing-a-crash-report
+     *
+     * @param dirPath Path to list, defaults to "/"
+     * @param depth Listing depth: 1 for immediate children, -1 for infinite
+     * @returns List of file paths (e.g., .ips files, sysdiagnose tarballs, directories like /Retired, /Cloud, etc.)
+     */
+    ls(dirPath?: string, depth?: number): Promise<string[]>;
+    /**
+     * Pull crash reports from device to local machine
+     * @param out Local directory path
+     * @param entry Remote path on device, defaults to "/"
+     * @param options Pull options (erase, match pattern)
+     */
+    pull(out: string, entry?: string, options?: CrashReportsPullOptions): Promise<void>;
+    /**
+     * Clear all crash reports from the device
+     */
+    clear(): Promise<void>;
+    /**
+     * Flush pending crash reports into CrashReports directory
+     */
+    flush(): Promise<void>;
+    /**
+     * Close the service and release resources
+     */
+    close(): void;
+}
+export interface CrashReportsServiceWithConnection {
+    crashReportsService: CrashReportsService;
+    remoteXPC: RemoteXpcConnection;
+}
 //# sourceMappingURL=types.d.ts.map