appium-ios-remotexpc 0.11.0 → 0.13.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [0.13.0](https://github.com/appium/appium-ios-remotexpc/compare/v0.12.0...v0.13.0) (2025-11-07)
+
+### Features
+
+* appletv pairing ([#76](https://github.com/appium/appium-ios-remotexpc/issues/76)) ([f974b12](https://github.com/appium/appium-ios-remotexpc/commit/f974b12f137152421f359f667d60d7e116a89353))
+
+## [0.12.0](https://github.com/appium/appium-ios-remotexpc/compare/v0.11.0...v0.12.0) (2025-11-05)
+
+### Features
+
+* add configurable log levels via LOG_LEVEL env var ([#92](https://github.com/appium/appium-ios-remotexpc/issues/92)) ([0a027a6](https://github.com/appium/appium-ios-remotexpc/commit/0a027a6377462ea0364e6eaf3de5c1321d8094c8))
+
 ## [0.11.0](https://github.com/appium/appium-ios-remotexpc/compare/v0.10.2...v0.11.0) (2025-11-05)
 
 ### Features

package/README.md

@@ -42,6 +42,34 @@ npm install appium-ios-remotexpc
 - **Pair Record Management**: Read and write device pairing records.
 - **Packet Streaming**: Stream packets between host and device for service communication.
 
+## Configuration
+
+### Environment Variables
+
+#### APPIUM_IOS_REMOTEXPC_LOG_LEVEL
+
+Controls the logging verbosity of the library.
+
+- **Default**: `info`
+- **Possible values**: Standard log levels supported by @appium/support logger
+  - `silly` - Most verbose, logs everything
+  - `verbose` - Very detailed logs
+  - `debug` - Detailed debugging information
+  - `info` - General informational messages (default)
+  - `warn` - Warning messages
+  - `error` - Error messages only
+- **Usage**:
+
+```bash
+# Set log level to debug for verbose output
+APPIUM_IOS_REMOTEXPC_LOG_LEVEL=debug npm test
+
+# Set log level to error for minimal output
+APPIUM_IOS_REMOTEXPC_LOG_LEVEL=error node your-script.js
+```
+
+This is particularly useful for debugging issues or reducing log noise in production environments.
+
 ## Architecture Flow
 
 The following diagram illustrates the high-level flow of how the tunnel is created:

package/build/src/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const STRONGBOX_CONTAINER_NAME = "appium-ios-remotexpc";
+//# sourceMappingURL=constants.d.ts.map

package/build/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB,yBAAyB,CAAC"}

package/build/src/constants.js

@@ -0,0 +1,3 @@
+// Global constants used across the appium-ios-remotexpc package
+// Strongbox container name for storing credentials and configuration
+export const STRONGBOX_CONTAINER_NAME = 'appium-ios-remotexpc';

package/build/src/index.d.ts

@@ -1,3 +1,4 @@
+import { STRONGBOX_CONTAINER_NAME } from './constants.js';
 import { createLockdownServiceByUDID } from './lib/lockdown/index.js';
 import { PacketStreamClient, PacketStreamServer, TunnelManager } from './lib/tunnel/index.js';
 import { TunnelRegistryServer, startTunnelRegistryServer } from './lib/tunnel/tunnel-registry-server.js';
@@ -6,5 +7,5 @@ import * as Services from './services.js';
 import { startCoreDeviceProxy } from './services/ios/tunnel-service/index.js';
 export type { DiagnosticsService, MobileImageMounterService, NotificationProxyService, MobileConfigService, PowerAssertionService, PowerAssertionOptions, SpringboardService, WebInspectorService, MisagentService, SyslogService, SocketInfo, TunnelResult, TunnelRegistry, TunnelRegistryEntry, DiagnosticsServiceWithConnection, MobileImageMounterServiceWithConnection, NotificationProxyServiceWithConnection, MobileConfigServiceWithConnection, PowerAssertionServiceWithConnection, SpringboardServiceWithConnection, WebInspectorServiceWithConnection, MisagentServiceWithConnection, } from './lib/types.js';
 export { PowerAssertionType } from './lib/types.js';
-export { createUsbmux, Services, Usbmux, TunnelManager, PacketStreamServer, PacketStreamClient, createLockdownServiceByUDID, startCoreDeviceProxy, TunnelRegistryServer, startTunnelRegistryServer, };
+export { STRONGBOX_CONTAINER_NAME, createUsbmux, Services, Usbmux, TunnelManager, PacketStreamServer, PacketStreamClient, createLockdownServiceByUDID, startCoreDeviceProxy, TunnelRegistryServer, startTunnelRegistryServer, };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E,YAAY,EACV,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,gCAAgC,EAChC,uCAAuC,EACvC,sCAAsC,EACtC,iCAAiC,EACjC,mCAAmC,EACnC,gCAAgC,EAChC,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,GAC1B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E,YAAY,EACV,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,gCAAgC,EAChC,uCAAuC,EACvC,sCAAsC,EACtC,iCAAiC,EACjC,mCAAmC,EACnC,gCAAgC,EAChC,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,GAC1B,CAAC"}

package/build/src/index.js

@@ -1,3 +1,4 @@
+import { STRONGBOX_CONTAINER_NAME } from './constants.js';
 import { createLockdownServiceByUDID } from './lib/lockdown/index.js';
 import { PacketStreamClient, PacketStreamServer, TunnelManager, } from './lib/tunnel/index.js';
 import { TunnelRegistryServer, startTunnelRegistryServer, } from './lib/tunnel/tunnel-registry-server.js';
@@ -5,4 +6,4 @@ import { Usbmux, createUsbmux } from './lib/usbmux/index.js';
 import * as Services from './services.js';
 import { startCoreDeviceProxy } from './services/ios/tunnel-service/index.js';
 export { PowerAssertionType } from './lib/types.js';
-export { createUsbmux, Services, Usbmux, TunnelManager, PacketStreamServer, PacketStreamClient, createLockdownServiceByUDID, startCoreDeviceProxy, TunnelRegistryServer, startTunnelRegistryServer, };
+export { STRONGBOX_CONTAINER_NAME, createUsbmux, Services, Usbmux, TunnelManager, PacketStreamServer, PacketStreamClient, createLockdownServiceByUDID, startCoreDeviceProxy, TunnelRegistryServer, startTunnelRegistryServer, };

package/build/src/lib/apple-tv/constants.d.ts

@@ -2,7 +2,6 @@ export declare const DEFAULT_PAIRING_CONFIG: {
     readonly timeout: 30000;
     readonly discoveryTimeout: 5000;
     readonly maxRetries: 3;
-    readonly pairingDirectory: ".pairing";
 };
 export declare const PairingDataComponentType: {
     readonly METHOD: 0;

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/lib/apple-tv/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,sBAAsB;;;;;CAKzB,CAAC;AAGX,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC3B,CAAC;AAGX,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAG1C,eAAO,MAAM,cAAc,QAc1B,CAAC;AAGF,eAAO,MAAM,aAAa,QAAY,CAAC;AAGvC,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAG3C,eAAO,MAAM,YAAY,eAAe,CAAC;AAGzC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAGxC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAGxC,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAG5C,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAGnC,eAAO,MAAM,WAAW,IAAO,CAAC;AAChC,eAAO,MAAM,WAAW,IAAO,CAAC;AAChC,eAAO,MAAM,YAAY,IAAO,CAAC;AACjC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,oBAAoB,KAAO,CAAC;AACzC,eAAO,MAAM,uBAAuB,KAAO,CAAC;AAC5C,eAAO,MAAM,sBAAsB,KAAO,CAAC;AAC3C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAGxC,eAAO,MAAM,kBAAkB,KAAO,CAAC;AACvC,eAAO,MAAM,mBAAmB,KAAO,CAAC;AACxC,eAAO,MAAM,mBAAmB,KAAO,CAAC;AACxC,eAAO,MAAM,mBAAmB,KAAO,CAAC;AAGxC,eAAO,MAAM,wBAAwB,KAAO,CAAC;AAC7C,eAAO,MAAM,6BAA6B,KAAO,CAAC;AAClD,eAAO,MAAM,8BAA8B,KAAO,CAAC;AACnD,eAAO,MAAM,8BAA8B,KAAO,CAAC;AAGnD,eAAO,MAAM,uBAAuB,MAAO,CAAC;AAC5C,eAAO,MAAM,4BAA4B,MAAO,CAAC;AACjD,eAAO,MAAM,6BAA6B,MAAO,CAAC;AAClD,eAAO,MAAM,6BAA6B,MAAO,CAAC;AAGlD,eAAO,MAAM,uBAAuB,MAAO,CAAC;AAC5C,eAAO,MAAM,4BAA4B,MAAO,CAAC;AAGjD,eAAO,MAAM,sBAAsB,MAAO,CAAC;AAC3C,eAAO,MAAM,2BAA2B,MAAO,CAAC;AAGhD,eAAO,MAAM,gBAAgB,MAAO,CAAC;AACrC,eAAO,MAAM,iBAAiB,QAAS,CAAC;AACxC,eAAO,MAAM,iBAAiB,aAAa,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/lib/apple-tv/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,sBAAsB;;;;CAIzB,CAAC;AAGX,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC3B,CAAC;AAGX,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAG1C,eAAO,MAAM,cAAc,QAc1B,CAAC;AAGF,eAAO,MAAM,aAAa,QAAY,CAAC;AAGvC,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAG3C,eAAO,MAAM,YAAY,eAAe,CAAC;AAGzC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAGxC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAGxC,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAG5C,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAGnC,eAAO,MAAM,WAAW,IAAO,CAAC;AAChC,eAAO,MAAM,WAAW,IAAO,CAAC;AAChC,eAAO,MAAM,YAAY,IAAO,CAAC;AACjC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,oBAAoB,KAAO,CAAC;AACzC,eAAO,MAAM,uBAAuB,KAAO,CAAC;AAC5C,eAAO,MAAM,sBAAsB,KAAO,CAAC;AAC3C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAGxC,eAAO,MAAM,kBAAkB,KAAO,CAAC;AACvC,eAAO,MAAM,mBAAmB,KAAO,CAAC;AACxC,eAAO,MAAM,mBAAmB,KAAO,CAAC;AACxC,eAAO,MAAM,mBAAmB,KAAO,CAAC;AAGxC,eAAO,MAAM,wBAAwB,KAAO,CAAC;AAC7C,eAAO,MAAM,6BAA6B,KAAO,CAAC;AAClD,eAAO,MAAM,8BAA8B,KAAO,CAAC;AACnD,eAAO,MAAM,8BAA8B,KAAO,CAAC;AAGnD,eAAO,MAAM,uBAAuB,MAAO,CAAC;AAC5C,eAAO,MAAM,4BAA4B,MAAO,CAAC;AACjD,eAAO,MAAM,6BAA6B,MAAO,CAAC;AAClD,eAAO,MAAM,6BAA6B,MAAO,CAAC;AAGlD,eAAO,MAAM,uBAAuB,MAAO,CAAC;AAC5C,eAAO,MAAM,4BAA4B,MAAO,CAAC;AAGjD,eAAO,MAAM,sBAAsB,MAAO,CAAC;AAC3C,eAAO,MAAM,2BAA2B,MAAO,CAAC;AAGhD,eAAO,MAAM,gBAAgB,MAAO,CAAC;AACrC,eAAO,MAAM,iBAAiB,QAAS,CAAC;AACxC,eAAO,MAAM,iBAAiB,aAAa,CAAC"}

package/build/src/lib/apple-tv/constants.js

@@ -3,7 +3,6 @@ export const DEFAULT_PAIRING_CONFIG = {
     timeout: 30000,
     discoveryTimeout: 5000,
     maxRetries: 3,
-    pairingDirectory: '.pairing',
 };
 // TLV8 component type identifiers used in pairing data exchange
 export const PairingDataComponentType = {

package/build/src/lib/apple-tv/discovery/device-discovery.d.ts

@@ -0,0 +1,10 @@
+import { type AppleTVDevice } from '../../bonjour/bonjour-discovery.js';
+import type { PairingConfig } from '../types.js';
+/** Discovers Apple TV devices on the local network using Bonjour */
+export declare class DeviceDiscoveryService {
+    private readonly config;
+    private readonly log;
+    constructor(config: PairingConfig);
+    discoverDevices(): Promise<AppleTVDevice[]>;
+}
+//# sourceMappingURL=device-discovery.d.ts.map

package/build/src/lib/apple-tv/discovery/device-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-discovery.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/discovery/device-discovery.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,oEAAoE;AACpE,qBAAa,sBAAsB;IAGrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA8C;gBAErC,MAAM,EAAE,aAAa;IAE5C,eAAe,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;CAkBlD"}

package/build/src/lib/apple-tv/discovery/device-discovery.js

@@ -0,0 +1,22 @@
+import { logger } from '@appium/support';
+import { BonjourDiscovery, } from '../../bonjour/bonjour-discovery.js';
+import { PairingError } from '../errors.js';
+/** Discovers Apple TV devices on the local network using Bonjour */
+export class DeviceDiscoveryService {
+    config;
+    log = logger.getLogger('DeviceDiscoveryService');
+    constructor(config) {
+        this.config = config;
+    }
+    async discoverDevices() {
+        try {
+            const discovery = new BonjourDiscovery();
+            this.log.info(`Discovering Apple TV devices (waiting ${this.config.discoveryTimeout / 1000} seconds)...`);
+            return await discovery.discoverAppleTVDevicesWithIP(this.config.discoveryTimeout);
+        }
+        catch (error) {
+            this.log.error('Device discovery failed:', error);
+            throw new PairingError('Device discovery failed', 'DISCOVERY_ERROR', error);
+        }
+    }
+}

package/build/src/lib/apple-tv/discovery/index.d.ts

@@ -0,0 +1,2 @@
+export { DeviceDiscoveryService } from './device-discovery.js';
+//# sourceMappingURL=index.d.ts.map

package/build/src/lib/apple-tv/discovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}

package/build/src/lib/apple-tv/discovery/index.js

@@ -0,0 +1 @@
+export { DeviceDiscoveryService } from './device-discovery.js';

package/build/src/lib/apple-tv/encryption/chacha20-poly1305.js

@@ -1,7 +1,7 @@
-import { logger } from '@appium/support';
 import { createCipheriv, createDecipheriv } from 'node:crypto';
+import { getLogger } from '../../logger.js';
 import { CryptographyError } from '../errors.js';
-const log = logger.getLogger('ChaCha20Poly1305');
+const log = getLogger('ChaCha20Poly1305');
 /**
  * Encrypts data using ChaCha20-Poly1305 AEAD cipher
  * @param params - Encryption parameters including plaintext, key, nonce, and optional AAD

package/build/src/lib/apple-tv/encryption/ed25519.js

@@ -1,7 +1,7 @@
-import { logger } from '@appium/support';
 import { generateKeyPairSync, sign, } from 'node:crypto';
+import { getLogger } from '../../logger.js';
 import { CryptographyError } from '../errors.js';
-const log = logger.getLogger('Ed25519');
+const log = getLogger('Ed25519');
 const ED25519_PUBLIC_KEY_LENGTH = 32;
 const ED25519_PRIVATE_KEY_LENGTH = 32;
 const ED25519_PKCS8_PREFIX = Buffer.from('302e020100300506032b657004220420', 'hex');

package/build/src/lib/apple-tv/encryption/hkdf.js

@@ -1,8 +1,8 @@
-import { logger } from '@appium/support';
 import { createHmac } from 'node:crypto';
+import { getLogger } from '../../logger.js';
 import { HKDF_HASH_ALGORITHM, HKDF_HASH_LENGTH } from '../constants.js';
 import { CryptographyError } from '../errors.js';
-const log = logger.getLogger('HKDF');
+const log = getLogger('HKDF');
 const MAX_OUTPUT_LENGTH = 255 * HKDF_HASH_LENGTH;
 /**
  * HMAC-based Key Derivation Function (HKDF) as defined in RFC 5869

package/build/src/lib/apple-tv/index.d.ts

@@ -6,4 +6,9 @@ export * from './deviceInfo/index.js';
 export * from './encryption/index.js';
 export * from './tlv/index.js';
 export * from './srp/index.js';
+export * from './network/index.js';
+export * from './pairing-protocol/index.js';
+export * from './storage/index.js';
+export * from './discovery/index.js';
+export * from './pairing/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/apple-tv/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,aAAa,EACb,QAAQ,EACR,6BAA6B,EAC7B,WAAW,EACX,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/apple-tv/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,aAAa,EACb,QAAQ,EACR,6BAA6B,EAC7B,WAAW,EACX,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}

package/build/src/lib/apple-tv/index.js

@@ -5,3 +5,8 @@ export * from './deviceInfo/index.js';
 export * from './encryption/index.js';
 export * from './tlv/index.js';
 export * from './srp/index.js';
+export * from './network/index.js';
+export * from './pairing-protocol/index.js';
+export * from './storage/index.js';
+export * from './discovery/index.js';
+export * from './pairing/index.js';

package/build/src/lib/apple-tv/network/constants.d.ts

@@ -0,0 +1,10 @@
+/** Constants for network protocol */
+export declare const NETWORK_CONSTANTS: {
+    readonly MAGIC: "RPPairing";
+    readonly MAGIC_LENGTH: 9;
+    readonly HEADER_LENGTH: 11;
+    readonly LENGTH_FIELD_SIZE: 2;
+    readonly MAX_TLV_FRAGMENT_SIZE: 255;
+    readonly PIN_INPUT_TIMEOUT_MS: 30000;
+};
+//# sourceMappingURL=constants.d.ts.map

package/build/src/lib/apple-tv/network/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/network/constants.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,eAAO,MAAM,iBAAiB;;;;;;;CAOpB,CAAC"}

package/build/src/lib/apple-tv/network/constants.js

@@ -0,0 +1,9 @@
+/** Constants for network protocol */
+export const NETWORK_CONSTANTS = {
+    MAGIC: 'RPPairing',
+    MAGIC_LENGTH: 9,
+    HEADER_LENGTH: 11,
+    LENGTH_FIELD_SIZE: 2,
+    MAX_TLV_FRAGMENT_SIZE: 255,
+    PIN_INPUT_TIMEOUT_MS: 30000,
+};

package/build/src/lib/apple-tv/network/index.d.ts

@@ -0,0 +1,4 @@
+export { NetworkClient } from './network-client.js';
+export { NETWORK_CONSTANTS } from './constants.js';
+export type { NetworkClientInterface } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/build/src/lib/apple-tv/network/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/network/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}

package/build/src/lib/apple-tv/network/index.js

@@ -0,0 +1,2 @@
+export { NetworkClient } from './network-client.js';
+export { NETWORK_CONSTANTS } from './constants.js';

package/build/src/lib/apple-tv/network/network-client.d.ts

@@ -0,0 +1,16 @@
+import type { PairingConfig } from '../types.js';
+import type { NetworkClientInterface } from './types.js';
+/** Handles TCP socket communication with Apple TV devices */
+export declare class NetworkClient implements NetworkClientInterface {
+    private readonly config;
+    private socket;
+    private connectionTimeoutId;
+    constructor(config: PairingConfig);
+    connect(ip: string, port: number): Promise<void>;
+    sendPacket(data: any): Promise<void>;
+    receiveResponse(): Promise<any>;
+    disconnect(): void;
+    private createRPPairingPacket;
+    private cleanup;
+}
+//# sourceMappingURL=network-client.d.ts.map

package/build/src/lib/apple-tv/network/network-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-client.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/network/network-client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAIzD,6DAA6D;AAC7D,qBAAa,aAAc,YAAW,sBAAsB;IAI9C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,mBAAmB,CAA+B;gBAE7B,MAAM,EAAE,aAAa;IAE5C,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgDhD,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBpC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC;IAmGrC,UAAU,IAAI,IAAI;IAIlB,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,OAAO;CAWhB"}

package/build/src/lib/apple-tv/network/network-client.js

@@ -0,0 +1,169 @@
+import { logger } from '@appium/support';
+import * as net from 'node:net';
+import { NetworkError } from '../errors.js';
+import { NETWORK_CONSTANTS } from './constants.js';
+const log = logger.getLogger('NetworkClient');
+/** Handles TCP socket communication with Apple TV devices */
+export class NetworkClient {
+    config;
+    socket = null;
+    connectionTimeoutId = null;
+    constructor(config) {
+        this.config = config;
+    }
+    async connect(ip, port) {
+        log.debug(`Connecting to ${ip}:${port}`);
+        return new Promise((resolve, reject) => {
+            const cancelTimeout = () => {
+                if (this.connectionTimeoutId) {
+                    clearTimeout(this.connectionTimeoutId);
+                    this.connectionTimeoutId = null;
+                }
+            };
+            this.socket = new net.Socket();
+            this.socket.setTimeout(this.config.timeout);
+            this.socket.once('connect', () => {
+                log.debug('Connected successfully');
+                cancelTimeout();
+                resolve();
+            });
+            this.socket.once('error', (error) => {
+                log.error('Connection error:', error);
+                cancelTimeout();
+                reject(new NetworkError(`Connection failed: ${error.message}`));
+            });
+            this.socket.once('timeout', () => {
+                log.error('Socket timeout');
+                cancelTimeout();
+                reject(new NetworkError('Socket timeout'));
+            });
+            this.socket.once('close', () => {
+                cancelTimeout();
+            });
+            this.connectionTimeoutId = setTimeout(() => {
+                log.error('Connection attempt timeout');
+                this.cleanup();
+                reject(new NetworkError(`Connection timeout after ${this.config.timeout}ms`));
+            }, this.config.timeout);
+            this.socket.connect(port, ip);
+        });
+    }
+    async sendPacket(data) {
+        if (!this.socket) {
+            throw new NetworkError('Socket not connected');
+        }
+        const packet = this.createRPPairingPacket(data);
+        log.debug('Sending packet:', { size: packet.length });
+        return new Promise((resolve, reject) => {
+            if (!this.socket) {
+                reject(new NetworkError('Socket disconnected during send'));
+                return;
+            }
+            this.socket.write(packet, (error) => {
+                if (error) {
+                    log.error('Send packet error:', error);
+                    reject(new NetworkError('Failed to send packet'));
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    async receiveResponse() {
+        if (!this.socket) {
+            throw new NetworkError('Socket not connected');
+        }
+        return new Promise((resolve, reject) => {
+            let buffer = Buffer.alloc(0);
+            let expectedLength = null;
+            let headerRead = false;
+            let timeoutId = null;
+            const cleanup = () => {
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                    timeoutId = null;
+                }
+                if (this.socket) {
+                    this.socket.removeListener('data', onData);
+                    this.socket.removeListener('error', onError);
+                }
+            };
+            const onData = (chunk) => {
+                try {
+                    buffer = Buffer.concat([buffer, chunk]);
+                    if (!headerRead && buffer.length >= NETWORK_CONSTANTS.HEADER_LENGTH) {
+                        const magic = buffer
+                            .slice(0, NETWORK_CONSTANTS.MAGIC_LENGTH)
+                            .toString('ascii');
+                        if (magic !== NETWORK_CONSTANTS.MAGIC) {
+                            throw new NetworkError(`Invalid protocol magic: expected '${NETWORK_CONSTANTS.MAGIC}', got '${magic}'`);
+                        }
+                        expectedLength = buffer.readUInt16BE(NETWORK_CONSTANTS.MAGIC_LENGTH);
+                        headerRead = true;
+                        log.debug(`Response header parsed: expecting ${expectedLength} bytes`);
+                    }
+                    if (headerRead &&
+                        expectedLength !== null &&
+                        buffer.length >= NETWORK_CONSTANTS.HEADER_LENGTH + expectedLength) {
+                        const bodyBytes = buffer.slice(NETWORK_CONSTANTS.HEADER_LENGTH, NETWORK_CONSTANTS.HEADER_LENGTH + expectedLength);
+                        const response = JSON.parse(bodyBytes.toString('utf8'));
+                        log.debug('Response received and parsed successfully');
+                        cleanup();
+                        resolve(response);
+                    }
+                }
+                catch (error) {
+                    log.error('Parse response error:', error);
+                    cleanup();
+                    reject(new NetworkError(`Failed to parse response: ${error.message}`));
+                }
+            };
+            const onError = (error) => {
+                log.error('Socket error during receive:', error);
+                cleanup();
+                reject(new NetworkError(`Socket error: ${error.message}`));
+            };
+            const onClose = () => {
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                }
+            };
+            if (this.socket) {
+                this.socket.once('data', onData);
+                this.socket.once('error', onError);
+                this.socket.once('close', onClose);
+                timeoutId = setTimeout(() => {
+                    log.error(`Response timeout after ${this.config.timeout}ms`);
+                    cleanup();
+                    reject(new NetworkError(`Response timeout after ${this.config.timeout}ms`));
+                }, this.config.timeout);
+            }
+            else {
+                reject(new NetworkError('Socket not available'));
+            }
+        });
+    }
+    disconnect() {
+        this.cleanup();
+    }
+    createRPPairingPacket(jsonData) {
+        const jsonString = JSON.stringify(jsonData);
+        const bodyBytes = Buffer.from(jsonString, 'utf8');
+        const magic = Buffer.from(NETWORK_CONSTANTS.MAGIC, 'ascii');
+        const length = Buffer.alloc(NETWORK_CONSTANTS.LENGTH_FIELD_SIZE);
+        length.writeUInt16BE(bodyBytes.length, 0);
+        return Buffer.concat([magic, length, bodyBytes]);
+    }
+    cleanup() {
+        if (this.connectionTimeoutId) {
+            clearTimeout(this.connectionTimeoutId);
+            this.connectionTimeoutId = null;
+        }
+        if (this.socket) {
+            this.socket.removeAllListeners();
+            this.socket.destroy();
+            this.socket = null;
+        }
+    }
+}

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

@@ -0,0 +1,8 @@
+/** Interface for network communication with Apple TV devices */
+export interface NetworkClientInterface {
+    connect(ip: string, port: number): Promise<void>;
+    sendPacket(data: any): Promise<void>;
+    receiveResponse(): Promise<any>;
+    disconnect(): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/network/types.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,UAAU,IAAI,IAAI,CAAC;CACpB"}

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

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

package/build/src/lib/apple-tv/pairing/index.d.ts

@@ -0,0 +1,3 @@
+export { UserInputService } from './user-input-service.js';
+export { AppleTVPairingService } from './pairing-service.js';
+//# sourceMappingURL=index.d.ts.map

package/build/src/lib/apple-tv/pairing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/pairing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}

package/build/src/lib/apple-tv/pairing/index.js

@@ -0,0 +1,2 @@
+export { UserInputService } from './user-input-service.js';
+export { AppleTVPairingService } from './pairing-service.js';

package/build/src/lib/apple-tv/pairing/pairing-service.d.ts

@@ -0,0 +1,15 @@
+import type { AppleTVDevice } from '../../bonjour/bonjour-discovery.js';
+import type { UserInputInterface } from '../pairing-protocol/types.js';
+import type { PairingConfig, PairingResult } from '../types.js';
+/** Main service orchestrating Apple TV device discovery and pairing */
+export declare class AppleTVPairingService {
+    private readonly networkClient;
+    private readonly discoveryService;
+    private readonly userInput;
+    private readonly pairingProtocol;
+    constructor(userInput: UserInputInterface, config?: PairingConfig);
+    discoverAndPair(deviceSelector?: string): Promise<PairingResult>;
+    pairWithDevice(device: AppleTVDevice): Promise<string>;
+    private selectDevice;
+}
+//# sourceMappingURL=pairing-service.d.ts.map

package/build/src/lib/apple-tv/pairing/pairing-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing-service.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/pairing/pairing-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAOxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIhE,uEAAuE;AACvE,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAGhD,SAAS,EAAE,kBAAkB,EAC7B,MAAM,GAAE,aAAsC;IAW1C,eAAe,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA6BhE,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;YAyB9C,YAAY;CAwF3B"}

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

@@ -0,0 +1,112 @@
+import { getLogger } from '../../logger.js';
+import { DEFAULT_PAIRING_CONFIG } from '../constants.js';
+import { DeviceDiscoveryService } from '../discovery/index.js';
+import { PairingError } from '../errors.js';
+import { NetworkClient } from '../network/index.js';
+import { PairingProtocol } from '../pairing-protocol/index.js';
+const log = getLogger('AppleTVPairingService');
+/** Main service orchestrating Apple TV device discovery and pairing */
+export class AppleTVPairingService {
+    networkClient;
+    discoveryService;
+    userInput;
+    pairingProtocol;
+    constructor(userInput, config = DEFAULT_PAIRING_CONFIG) {
+        this.networkClient = new NetworkClient(config);
+        this.discoveryService = new DeviceDiscoveryService(config);
+        this.userInput = userInput;
+        this.pairingProtocol = new PairingProtocol(this.networkClient, this.userInput);
+    }
+    async discoverAndPair(deviceSelector) {
+        try {
+            const devices = await this.discoveryService.discoverDevices();
+            if (devices.length === 0) {
+                const errorMessage = 'No Apple TV pairing devices found. Please ensure your Apple TV is on the same network and in pairing mode.';
+                log.error(errorMessage);
+                throw new PairingError(errorMessage, 'NO_DEVICES');
+            }
+            const device = await this.selectDevice(devices, deviceSelector);
+            const pairingFile = await this.pairWithDevice(device);
+            return {
+                success: true,
+                deviceId: device.identifier,
+                pairingFile,
+            };
+        }
+        catch (error) {
+            log.error('Pairing failed:', error);
+            return {
+                success: false,
+                deviceId: 'unknown',
+                error: error instanceof Error ? error : new Error(String(error)),
+            };
+        }
+    }
+    async pairWithDevice(device) {
+        try {
+            // Use IP if available, otherwise fall back to hostname
+            const connectionTarget = device.ip ?? device.hostname;
+            if (!connectionTarget) {
+                throw new PairingError('Neither IP address nor hostname available for device', 'NO_CONNECTION_TARGET');
+            }
+            log.info(`Connecting to device ${device.name} at ${connectionTarget}:${device.port}`);
+            await this.networkClient.connect(connectionTarget, device.port);
+            return await this.pairingProtocol.executePairingFlow(device);
+        }
+        catch (error) {
+            log.error(`Pairing with device ${device.name} failed:`, error);
+            throw error;
+        }
+        finally {
+            this.networkClient.disconnect();
+        }
+    }
+    async selectDevice(devices, deviceSelector) {
+        // If no selector provided, always prompt user to choose (even for single device)
+        if (!deviceSelector) {
+            log.info(`Found ${devices.length} device(s):`);
+            devices.forEach((device, index) => {
+                log.info(`  [${index}] ${device.name} (${device.identifier}) - ${device.model} v${device.version}`);
+            });
+            const prompt = devices.length === 1
+                ? 'Press Enter to select device [0], or enter index: '
+                : `Select device by index (0-${devices.length - 1}): `;
+            const indexStr = await this.userInput.promptForInput(prompt);
+            const trimmed = indexStr.trim();
+            // If user just presses Enter and there's only one device, select it
+            if (trimmed === '' && devices.length === 1) {
+                log.info(`Selected device: ${devices[0].name} (${devices[0].identifier})`);
+                return devices[0];
+            }
+            const index = parseInt(trimmed, 10);
+            if (isNaN(index) || index < 0 || index >= devices.length) {
+                throw new PairingError(`Invalid device index: ${trimmed}. Must be between 0 and ${devices.length - 1}`, 'INVALID_DEVICE_SELECTION');
+            }
+            log.info(`Selected device: ${devices[index].name} (${devices[index].identifier})`);
+            return devices[index];
+        }
+        // Try to match by index first
+        const indexMatch = parseInt(deviceSelector, 10);
+        if (!isNaN(indexMatch) && indexMatch >= 0 && indexMatch < devices.length) {
+            log.info(`Selected device by index ${indexMatch}: ${devices[indexMatch].name}`);
+            return devices[indexMatch];
+        }
+        // Try to match by name (case-insensitive)
+        const nameMatch = devices.find((device) => device.name.toLowerCase() === deviceSelector.toLowerCase());
+        if (nameMatch) {
+            log.info(`Selected device by name: ${nameMatch.name} (${nameMatch.identifier})`);
+            return nameMatch;
+        }
+        // Try to match by identifier (case-insensitive)
+        const identifierMatch = devices.find((device) => device.identifier.toLowerCase() === deviceSelector.toLowerCase());
+        if (identifierMatch) {
+            log.info(`Selected device by identifier: ${identifierMatch.name} (${identifierMatch.identifier})`);
+            return identifierMatch;
+        }
+        // No match found
+        const availableDevices = devices
+            .map((device, index) => `  [${index}] ${device.name} (${device.identifier})`)
+            .join('\n');
+        throw new PairingError(`Device '${deviceSelector}' not found. Available devices:\n${availableDevices}`, 'DEVICE_NOT_FOUND');
+    }
+}