@ebowwa/ios-devices 1.0.0

package/src/lib-imobiledevice.ts

@@ -0,0 +1,404 @@
+/**
+ * LibIMobileDevice - Wrapper for idevice* tools
+ * Cross-platform iOS device communication (works with iOS 4+)
+ */
+
+import { exec, execILDevice, type ExecOptions } from './utils.js';
+import {
+  type CommandResult,
+  type LogEntry,
+  type LogFilter,
+  type BackupInfo,
+  type ProvisioningProfile,
+  type Location,
+  type DiagnosticsType,
+} from './types.js';
+
+export interface LibIMobileDeviceOptions {
+  udid?: string;
+  timeout?: number;
+}
+
+export class LibIMobileDevice {
+  private options: LibIMobileDeviceOptions;
+
+  constructor(options: LibIMobileDeviceOptions = {}) {
+    this.options = options;
+  }
+
+  private buildArgs(extra: string[] = []): string[] {
+    const args: string[] = [];
+    if (this.options.udid) {
+      args.push('--udid', this.options.udid);
+    }
+    return [...args, ...extra];
+  }
+
+  // ==========================================================================
+  // Device Information
+  // ==========================================================================
+
+  /**
+   * List connected devices
+   */
+  async listDevices(): Promise<CommandResult> {
+    return execILDevice('idevice_id', ['-l']);
+  }
+
+  /**
+   * Get device info
+   */
+  async getDeviceInfo(): Promise<CommandResult> {
+    return execILDevice('ideviceinfo', this.buildArgs());
+  }
+
+  /**
+   * Get device name
+   */
+  async getDeviceName(): Promise<CommandResult> {
+    return execILDevice('idevicename', this.buildArgs());
+  }
+
+  /**
+   * Set device name
+   */
+  async setDeviceName(name: string): Promise<CommandResult> {
+    return execILDevice('idevicename', this.buildArgs([name]));
+  }
+
+  /**
+   * Get device date/time
+   */
+  async getDeviceDate(): Promise<CommandResult> {
+    return execILDevice('idevicedate', this.buildArgs());
+  }
+
+  // ==========================================================================
+  // Syslog
+  // ==========================================================================
+
+  /**
+   * Stream syslog (returns immediately, use for real-time monitoring)
+   */
+  async streamSyslog(filter?: LogFilter): Promise<CommandResult> {
+    const args = this.buildArgs();
+
+    if (filter?.match) args.push('--match', filter.match);
+    if (filter?.unmatch) args.push('--unmatch', filter.unmatch);
+    if (filter?.process) args.push('--process', filter.process);
+    if (filter?.exclude) args.push('--exclude', filter.exclude);
+    if (filter?.kernel) args.push('--kernel');
+    if (filter?.trigger) args.push('--trigger', filter.trigger);
+    if (filter?.untrigger) args.push('--untrigger', filter.untrigger);
+
+    return execILDevice('idevicesyslog', args, { timeout: 0 }); // No timeout for streaming
+  }
+
+  /**
+   * Get syslog archive
+   */
+  async getSyslogArchive(outputPath: string, options?: {
+    startTime?: number;
+    ageLimit?: string;
+    sizeLimit?: string;
+  }): Promise<CommandResult> {
+    const args = this.buildArgs(['archive', outputPath]);
+
+    if (options?.startTime) {
+      args.push('--start-time', String(options.startTime));
+    }
+    if (options?.ageLimit) {
+      args.push('--age-limit', options.ageLimit);
+    }
+    if (options?.sizeLimit) {
+      args.push('--size-limit', options.sizeLimit);
+    }
+
+    return execILDevice('idevicesyslog', args, { timeout: 120000 });
+  }
+
+  /**
+   * Get process list from syslog
+   */
+  async getProcessList(): Promise<CommandResult> {
+    return execILDevice('idevicesyslog', this.buildArgs(['pidlist']));
+  }
+
+  // ==========================================================================
+  // Screenshot
+  // ==========================================================================
+
+  /**
+   * Take screenshot
+   */
+  async takeScreenshot(outputPath?: string): Promise<CommandResult> {
+    const args = this.buildArgs();
+    if (outputPath) {
+      args.push('--output', outputPath);
+    }
+    return execILDevice('idevicescreenshot', args);
+  }
+
+  // ==========================================================================
+  // Location
+  // ==========================================================================
+
+  /**
+   * Set simulated location
+   */
+  async setLocation(latitude: number, longitude: number): Promise<CommandResult> {
+    return execILDevice('idevicesetlocation', this.buildArgs([String(latitude), String(longitude)]));
+  }
+
+  /**
+   * Reset location (stop simulation)
+   */
+  async resetLocation(): Promise<CommandResult> {
+    return execILDevice('idevicesetlocation', this.buildArgs(['reset']));
+  }
+
+  // ==========================================================================
+  // Diagnostics
+  // ==========================================================================
+
+  /**
+   * Get diagnostics info
+   */
+  async getDiagnostics(type: DiagnosticsType = 'All'): Promise<CommandResult> {
+    return execILDevice('idevicediagnostics', this.buildArgs(['diagnostics', type]));
+  }
+
+  /**
+   * Get IO Registry
+   */
+  async getIORegistry(plane?: 'IODeviceTree' | 'IOPower' | 'IOService'): Promise<CommandResult> {
+    const args = this.buildArgs(['ioreg']);
+    if (plane) {
+      args.push(plane);
+    }
+    return execILDevice('idevicediagnostics', args);
+  }
+
+  /**
+   * Get IO Registry entry
+   */
+  async getIORegistryEntry(key: string): Promise<CommandResult> {
+    return execILDevice('idevicediagnostics', this.buildArgs(['ioregentry', key]));
+  }
+
+  /**
+   * Get MobileGestalt values
+   */
+  async getMobileGestalt(...keys: string[]): Promise<CommandResult> {
+    return execILDevice('idevicediagnostics', this.buildArgs(['mobilegestalt', ...keys]));
+  }
+
+  /**
+   * Shutdown device
+   */
+  async shutdown(): Promise<CommandResult> {
+    return execILDevice('idevicediagnostics', this.buildArgs(['shutdown']));
+  }
+
+  /**
+   * Restart device
+   */
+  async restart(): Promise<CommandResult> {
+    return execILDevice('idevicediagnostics', this.buildArgs(['restart']));
+  }
+
+  /**
+   * Sleep device
+   */
+  async sleep(): Promise<CommandResult> {
+    return execILDevice('idevicediagnostics', this.buildArgs(['sleep']));
+  }
+
+  // ==========================================================================
+  // Pairing
+  // ==========================================================================
+
+  /**
+   * Pair with device
+   */
+  async pair(): Promise<CommandResult> {
+    return execILDevice('idevicepair', this.buildArgs());
+  }
+
+  /**
+   * Validate pairing
+   */
+  async validatePair(): Promise<CommandResult> {
+    return execILDevice('idevicepair', this.buildArgs(['validate']));
+  }
+
+  // ==========================================================================
+  // Backup
+  // ==========================================================================
+
+  /**
+   * Create backup
+   */
+  async createBackup(directory: string, encrypt?: boolean, password?: string): Promise<CommandResult> {
+    const args = this.buildArgs(['backup', directory]);
+    if (encrypt) {
+      args.push('--encryption');
+      if (password) {
+        args.push('--password', password);
+      }
+    }
+    return execILDevice('idevicebackup2', args, { timeout: 600000 }); // 10 min
+  }
+
+  /**
+   * Restore backup
+   */
+  async restoreBackup(directory: string, password?: string): Promise<CommandResult> {
+    const args = this.buildArgs(['restore', directory]);
+    if (password) {
+      args.push('--password', password);
+    }
+    return execILDevice('idevicebackup2', args, { timeout: 600000 });
+  }
+
+  /**
+   * Get backup info
+   */
+  async getBackupInfo(directory: string): Promise<CommandResult> {
+    return execILDevice('idevicebackup2', this.buildArgs(['info', directory]));
+  }
+
+  /**
+   * List backups
+   */
+  async listBackups(): Promise<CommandResult> {
+    return execILDevice('idevicebackup2', this.buildArgs(['list']));
+  }
+
+  /**
+   * Unpack backup
+   */
+  async unpackBackup(directory: string): Promise<CommandResult> {
+    return execILDevice('idevicebackup2', this.buildArgs(['unback', directory]), { timeout: 300000 });
+  }
+
+  // ==========================================================================
+  // Provisioning Profiles
+  // ==========================================================================
+
+  /**
+   * List provisioning profiles
+   */
+  async listProfiles(): Promise<CommandResult> {
+    return execILDevice('ideviceprovision', this.buildArgs(['list']));
+  }
+
+  /**
+   * Install provisioning profile
+   */
+  async installProfile(profilePath: string): Promise<CommandResult> {
+    return execILDevice('ideviceprovision', this.buildArgs(['install', profilePath]));
+  }
+
+  /**
+   * Remove provisioning profile
+   */
+  async removeProfile(uuid: string): Promise<CommandResult> {
+    return execILDevice('ideviceprovision', this.buildArgs(['remove', uuid]));
+  }
+
+  // ==========================================================================
+  // Crash Reports
+  // ==========================================================================
+
+  /**
+   * Download crash reports
+   */
+  async downloadCrashReports(outputDirectory: string, options?: {
+    extract?: boolean;
+    keep?: boolean;
+  }): Promise<CommandResult> {
+    const args = this.buildArgs([outputDirectory]);
+    if (options?.extract) {
+      args.push('--extract');
+    }
+    if (options?.keep) {
+      args.push('--keep');
+    }
+    return execILDevice('idevicecrashreport', args);
+  }
+
+  // ==========================================================================
+  // Developer Mode
+  // ==========================================================================
+
+  /**
+   * List developer mode status
+   */
+  async listDevMode(): Promise<CommandResult> {
+    return execILDevice('idevicedevmodectl', ['list']);
+  }
+
+  // ==========================================================================
+  // Image Mounting
+  // ==========================================================================
+
+  /**
+   * Mount developer disk image
+   */
+  async mountImage(imagePath: string, signaturePath?: string): Promise<CommandResult> {
+    const args = this.buildArgs([imagePath]);
+    if (signaturePath) {
+      args.push('--signature', signaturePath);
+    }
+    return execILDevice('ideviceimagemounter', args);
+  }
+
+  // ==========================================================================
+  // Recovery Mode
+  // ==========================================================================
+
+  /**
+   * Enter recovery mode
+   */
+  async enterRecovery(): Promise<CommandResult> {
+    return execILDevice('ideviceenterrecovery', this.buildArgs());
+  }
+
+  // ==========================================================================
+  // Bluetooth Logging
+  // ==========================================================================
+
+  /**
+   * Start Bluetooth packet logging
+   */
+  async startBluetoothLogging(outputPath?: string): Promise<CommandResult> {
+    const args = this.buildArgs();
+    if (outputPath) {
+      args.push('--output', outputPath);
+    }
+    return execILDevice('idevicebtlogger', args, { timeout: 0 });
+  }
+
+  // ==========================================================================
+  // Debug Server
+  // ==========================================================================
+
+  /**
+   * Start debug server proxy
+   */
+  async startDebugServerProxy(port: number = 6666): Promise<CommandResult> {
+    return execILDevice('idevicedebugserverproxy', this.buildArgs([String(port)]), { timeout: 0 });
+  }
+
+  // ==========================================================================
+  // AFC Client (File System)
+  // ==========================================================================
+
+  /**
+   * Start AFC shell
+   */
+  async startAFCShell(): Promise<CommandResult> {
+    return execILDevice('afcclient', this.buildArgs(), { timeout: 0 });
+  }
+}

package/src/shell-quote.d.ts

@@ -0,0 +1,5 @@
+declare module 'shell-quote' {
+  export function parse(str: string): Array<string | { op: string }>;
+  export function parse(str: string, env?: Record<string, string>): Array<string | { op: string }>;
+  export function quote(args: string[]): string;
+}