appium-ios-remotexpc 0.12.0 → 0.13.1

package/src/lib/apple-tv/pairing/user-input-service.ts

@@ -0,0 +1,71 @@
+import { logger } from '@appium/support';
+import { createInterface } from 'node:readline';
+
+import { PairingError } from '../errors.js';
+import { NETWORK_CONSTANTS } from '../network/constants.js';
+import type { UserInputInterface } from '../pairing-protocol/types.js';
+
+/** Handles user interaction for PIN input during pairing */
+export class UserInputService implements UserInputInterface {
+  private readonly log = logger.getLogger('UserInputService');
+
+  async promptForPIN(): Promise<string> {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    let timeoutId: NodeJS.Timeout | null = null;
+
+    try {
+      const pin = await new Promise<string>((resolve, reject) => {
+        timeoutId = setTimeout(() => {
+          reject(new PairingError('PIN input timeout', 'INPUT_TIMEOUT'));
+        }, NETWORK_CONSTANTS.PIN_INPUT_TIMEOUT_MS);
+
+        rl.question('Enter PIN from Apple TV screen: ', (answer) => {
+          // Clear timeout since we got the PIN
+          if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+          }
+          resolve(answer);
+        });
+      });
+
+      const cleanPin = pin.trim();
+      if (!/^\d+$/.test(cleanPin)) {
+        this.log.error('Invalid PIN format');
+        throw new PairingError('PIN must contain only digits', 'INVALID_PIN');
+      }
+
+      this.log.debug('PIN received successfully');
+      return cleanPin;
+    } finally {
+      // Clean up timeout if error occurred before clearing
+      if (timeoutId) {
+        clearTimeout(timeoutId);
+      }
+      rl.close();
+    }
+  }
+
+  async promptForInput(prompt: string): Promise<string> {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    try {
+      const input = await new Promise<string>((resolve) => {
+        rl.question(prompt, (answer) => {
+          resolve(answer);
+        });
+      });
+
+      return input.trim();
+    } finally {
+      rl.close();
+    }
+  }
+}

package/src/lib/apple-tv/pairing-protocol/constants.ts

@@ -0,0 +1,19 @@
+/** Constants for pairing protocol states */
+export const PAIRING_STATES = {
+  M3: 0x03,
+  M5: 0x05,
+  M6: 0x06,
+} as const;
+
+/** Constants for pairing protocol messages */
+export const PAIRING_MESSAGES = {
+  ENCRYPT_SALT: 'Pair-Setup-Encrypt-Salt',
+  ENCRYPT_INFO: 'Pair-Setup-Encrypt-Info',
+  SIGN_SALT: 'Pair-Setup-Controller-Sign-Salt',
+  SIGN_INFO: 'Pair-Setup-Controller-Sign-Info',
+  M5_NONCE: 'PS-Msg05',
+  M6_NONCE: 'PS-Msg06',
+} as const;
+
+/** TLV type for device info */
+export const INFO_TYPE = 0x11;

package/src/lib/apple-tv/pairing-protocol/index.ts

@@ -0,0 +1,8 @@
+export { PairingProtocol } from './pairing-protocol.js';
+export { PAIRING_STATES, PAIRING_MESSAGES, INFO_TYPE } from './constants.js';
+export type {
+  EncryptionKeys,
+  PairingRequest,
+  UserInputInterface,
+  PairingProtocolInterface,
+} from './types.js';