@ebowwa/ios-devices 1.0.0

package/src/sim-ctl.ts

@@ -0,0 +1,502 @@
+/**
+ * SimCtl - Wrapper for xcrun simctl
+ * iOS Simulator control
+ */
+
+import { execSimCtl, type ExecOptions } from './utils.js';
+import {
+  type CommandResult,
+  type SimulatorDevice,
+  type SimulatorRuntime,
+  type SimulatorDeviceType,
+} from './types.js';
+
+export interface SimCtlOptions {
+  timeout?: number;
+}
+
+export class SimCtl {
+  private options: SimCtlOptions;
+
+  constructor(options: SimCtlOptions = {}) {
+    this.options = options;
+  }
+
+  // ==========================================================================
+  // Device Management
+  // ==========================================================================
+
+  /**
+   * List simulators
+   */
+  async list(options?: {
+    devices?: boolean;
+    deviceTypes?: boolean;
+    runtimes?: boolean;
+    pairs?: boolean;
+    search?: string;
+    available?: boolean;
+  }): Promise<CommandResult> {
+    const args = ['list'];
+
+    if (options?.devices) args.push('devices');
+    else if (options?.deviceTypes) args.push('devicetypes');
+    else if (options?.runtimes) args.push('runtimes');
+    else if (options?.pairs) args.push('pairs');
+
+    if (options?.search) args.push(options.search);
+    if (options?.available) args.push('--available');
+
+    return execSimCtl(args, this.options);
+  }
+
+  /**
+   * Create a new simulator
+   */
+  async create(name: string, deviceTypeId: string, runtimeId: string): Promise<CommandResult> {
+    return execSimCtl(['create', name, deviceTypeId, runtimeId], this.options);
+  }
+
+  /**
+   * Clone a simulator
+   */
+  async clone(sourceUdid: string, name: string): Promise<CommandResult> {
+    return execSimCtl(['clone', sourceUdid, name], this.options);
+  }
+
+  /**
+   * Delete simulators
+   */
+  async delete(udids: string | string[]): Promise<CommandResult> {
+    const ids = Array.isArray(udids) ? udids : [udids];
+    return execSimCtl(['delete', ...ids], this.options);
+  }
+
+  /**
+   * Delete unavailable simulators
+   */
+  async deleteUnavailable(): Promise<CommandResult> {
+    return execSimCtl(['delete', 'unavailable'], this.options);
+  }
+
+  /**
+   * Erase simulator
+   */
+  async erase(udid: string): Promise<CommandResult> {
+    return execSimCtl(['erase', udid], this.options);
+  }
+
+  /**
+   * Rename simulator
+   */
+  async rename(udid: string, name: string): Promise<CommandResult> {
+    return execSimCtl(['rename', udid, name], this.options);
+  }
+
+  // ==========================================================================
+  // Boot/Shutdown
+  // ==========================================================================
+
+  /**
+   * Boot simulator
+   */
+  async boot(udid: string): Promise<CommandResult> {
+    return execSimCtl(['boot', udid], this.options);
+  }
+
+  /**
+   * Shutdown simulator
+   */
+  async shutdown(udid: string): Promise<CommandResult> {
+    return execSimCtl(['shutdown', udid], this.options);
+  }
+
+  /**
+   * Shutdown all simulators
+   */
+  async shutdownAll(): Promise<CommandResult> {
+    return execSimCtl(['shutdown', 'all'], this.options);
+  }
+
+  // ==========================================================================
+  // App Management
+  // ==========================================================================
+
+  /**
+   * Install app
+   */
+  async install(udid: string, appPath: string): Promise<CommandResult> {
+    return execSimCtl(['install', udid, appPath], this.options);
+  }
+
+  /**
+   * Uninstall app
+   */
+  async uninstall(udid: string, bundleId: string): Promise<CommandResult> {
+    return execSimCtl(['uninstall', udid, bundleId], this.options);
+  }
+
+  /**
+   * Get app container path
+   */
+  async getAppContainer(udid: string, bundleId: string, containerType?: string): Promise<CommandResult> {
+    const args = ['get_app_container', udid, bundleId];
+    if (containerType) args.push(containerType);
+    return execSimCtl(args, this.options);
+  }
+
+  /**
+   * Install app data
+   */
+  async installAppData(udid: string, xcappdataPath: string): Promise<CommandResult> {
+    return execSimCtl(['install_app_data', udid, xcappdataPath], this.options);
+  }
+
+  // ==========================================================================
+  // App Execution
+  // ==========================================================================
+
+  /**
+   * Launch app
+   */
+  async launch(udid: string, bundleId: string, options?: {
+    waitForDebugger?: boolean;
+    console?: boolean;
+    env?: Record<string, string>;
+    args?: string[];
+  }): Promise<CommandResult> {
+    const args = ['launch'];
+
+    if (options?.waitForDebugger) args.push('--wait-for-debugger');
+    if (options?.console) args.push('--console');
+
+    if (options?.env) {
+      for (const [key, value] of Object.entries(options.env)) {
+        args.push('--env', `${key}=${value}`);
+      }
+    }
+
+    args.push(udid, bundleId);
+
+    if (options?.args) {
+      args.push(...options.args);
+    }
+
+    return execSimCtl(args, this.options);
+  }
+
+  /**
+   * Terminate app
+   */
+  async terminate(udid: string, bundleId: string): Promise<CommandResult> {
+    return execSimCtl(['terminate', udid, bundleId], this.options);
+  }
+
+  /**
+   * Spawn process
+   */
+  async spawn(udid: string, executable: string, args?: string[]): Promise<CommandResult> {
+    const spawnArgs = ['spawn', udid, executable];
+    if (args) spawnArgs.push(...args);
+    return execSimCtl(spawnArgs, this.options);
+  }
+
+  // ==========================================================================
+  // IO Operations
+  // ==========================================================================
+
+  /**
+   * Take screenshot
+   */
+  async screenshot(udid: string, outputPath: string, options?: {
+    type?: 'png' | 'jpeg' | 'tiff';
+    display?: string;
+    mask?: string;
+  }): Promise<CommandResult> {
+    const args = ['io', udid, 'screenshot'];
+
+    if (options?.type) args.push('--type', options.type);
+    if (options?.display) args.push('--display', options.display);
+    if (options?.mask) args.push('--mask', options.mask);
+
+    args.push(outputPath);
+
+    return execSimCtl(args, this.options);
+  }
+
+  /**
+   * Record video
+   */
+  async recordVideo(udid: string, outputPath: string, options?: {
+    codec?: 'h264' | 'hevc';
+    display?: string;
+    mask?: string;
+    force?: boolean;
+  }): Promise<CommandResult> {
+    const args = ['io', udid, 'recordVideo'];
+
+    if (options?.codec) args.push('--codec', options.codec);
+    if (options?.display) args.push('--display', options.display);
+    if (options?.mask) args.push('--mask', options.mask);
+    if (options?.force) args.push('--force');
+
+    args.push(outputPath);
+
+    return execSimCtl(args, this.options);
+  }
+
+  // ==========================================================================
+  // Location
+  // ==========================================================================
+
+  /**
+   * Set location
+   */
+  async setLocation(udid: string, latitude: number, longitude: number): Promise<CommandResult> {
+    return execSimCtl(['location', udid, 'set', String(latitude), String(longitude)], this.options);
+  }
+
+  /**
+   * Reset location
+   */
+  async resetLocation(udid: string): Promise<CommandResult> {
+    return execSimCtl(['location', udid, 'reset'], this.options);
+  }
+
+  // ==========================================================================
+  // Status Bar
+  // ==========================================================================
+
+  /**
+   * Override status bar
+   */
+  async statusBar(udid: string, overrides: {
+    time?: string;
+    dataNetwork?: string;
+    wifiMode?: 'active' | 'searching' | 'failed';
+    cellularMode?: 'active' | 'searching' | 'failed';
+    operatorName?: string;
+    batteryLevel?: number;
+    batteryState?: 'charging' | 'charged' | 'discharging';
+  }): Promise<CommandResult> {
+    const args = ['status_bar', udid, 'override'];
+
+    if (overrides.time) args.push('--time', overrides.time);
+    if (overrides.dataNetwork) args.push('--dataNetwork', overrides.dataNetwork);
+    if (overrides.wifiMode) args.push('--wifiMode', overrides.wifiMode);
+    if (overrides.cellularMode) args.push('--cellularMode', overrides.cellularMode);
+    if (overrides.operatorName) args.push('--operatorName', overrides.operatorName);
+    if (overrides.batteryLevel !== undefined) args.push('--batteryLevel', String(overrides.batteryLevel));
+    if (overrides.batteryState) args.push('--batteryState', overrides.batteryState);
+
+    return execSimCtl(args, this.options);
+  }
+
+  /**
+   * Clear status bar overrides
+   */
+  async clearStatusBar(udid: string): Promise<CommandResult> {
+    return execSimCtl(['status_bar', udid, 'clear'], this.options);
+  }
+
+  // ==========================================================================
+  // URL & Notifications
+  // ==========================================================================
+
+  /**
+   * Open URL
+   */
+  async openURL(udid: string, url: string): Promise<CommandResult> {
+    return execSimCtl(['openurl', udid, url], this.options);
+  }
+
+  /**
+   * Send push notification
+   */
+  async push(udid: string, bundleId: string, jsonPayload: object): Promise<CommandResult> {
+    return execSimCtl(['push', udid, bundleId, JSON.stringify(jsonPayload)], this.options);
+  }
+
+  // ==========================================================================
+  // Privacy
+  // ==========================================================================
+
+  /**
+   * Grant privacy permission
+   */
+  async grantPrivacy(udid: string, bundleId: string, service: string): Promise<CommandResult> {
+    return execSimCtl(['privacy', udid, 'grant', bundleId, service], this.options);
+  }
+
+  /**
+   * Revoke privacy permission
+   */
+  async revokePrivacy(udid: string, bundleId: string, service: string): Promise<CommandResult> {
+    return execSimCtl(['privacy', udid, 'revoke', bundleId, service], this.options);
+  }
+
+  /**
+   * Reset privacy permissions
+   */
+  async resetPrivacy(udid: string, bundleId: string, service: string): Promise<CommandResult> {
+    return execSimCtl(['privacy', udid, 'reset', bundleId, service], this.options);
+  }
+
+  // ==========================================================================
+  // Pasteboard
+  // ==========================================================================
+
+  /**
+   * Copy to pasteboard
+   */
+  async pbcopy(udid: string, data: string): Promise<CommandResult> {
+    // Note: pbcopy reads from stdin
+    const result = await execSimCtl(['pbcopy', udid], {
+      ...this.options,
+      // This would need stdin support, simplified here
+    });
+    return result;
+  }
+
+  /**
+   * Paste from pasteboard
+   */
+  async pbpaste(udid: string): Promise<CommandResult> {
+    return execSimCtl(['pbpaste', udid], this.options);
+  }
+
+  // ==========================================================================
+  // Keychain
+  // ==========================================================================
+
+  /**
+   * Add keychain item
+   */
+  async keychainAdd(udid: string, service: string, account: string, password: string, options?: {
+    accessGroup?: string;
+    accessible?: 'always' | 'unlocked' | 'first-unlock';
+  }): Promise<CommandResult> {
+    const args = ['keychain', udid, 'add', service, account, password];
+    if (options?.accessGroup) args.push('--accessGroup', options.accessGroup);
+    if (options?.accessible) args.push('--accessible', options.accessible);
+    return execSimCtl(args, this.options);
+  }
+
+  /**
+   * Reset keychain
+   */
+  async keychainReset(udid: string): Promise<CommandResult> {
+    return execSimCtl(['keychain', udid, 'reset'], this.options);
+  }
+
+  // ==========================================================================
+  // Environment
+  // ==========================================================================
+
+  /**
+   * Get environment variable
+   */
+  async getenv(udid: string, variable?: string): Promise<CommandResult> {
+    const args = ['getenv', udid];
+    if (variable) args.push(variable);
+    return execSimCtl(args, this.options);
+  }
+
+  // ==========================================================================
+  // Diagnostics
+  // ==========================================================================
+
+  /**
+   * Collect diagnostics
+   */
+  async diagnose(outputPath?: string): Promise<CommandResult> {
+    const args = ['diagnose'];
+    if (outputPath) args.push('--output', outputPath);
+    return execSimCtl(args, { ...this.options, timeout: 120000 });
+  }
+
+  // ==========================================================================
+  // iCloud
+  // ==========================================================================
+
+  /**
+   * Trigger iCloud sync
+   */
+  async icloudSync(udid: string): Promise<CommandResult> {
+    return execSimCtl(['icloud_sync', udid], this.options);
+  }
+
+  // ==========================================================================
+  // Media
+  // ==========================================================================
+
+  /**
+   * Add media (photos, videos, contacts)
+   */
+  async addMedia(udid: string, mediaPaths: string | string[]): Promise<CommandResult> {
+    const paths = Array.isArray(mediaPaths) ? mediaPaths : [mediaPaths];
+    return execSimCtl(['addmedia', udid, ...paths], this.options);
+  }
+
+  // ==========================================================================
+  // Runtime
+  // ==========================================================================
+
+  /**
+   * Upgrade simulator runtime
+   */
+  async upgrade(udid: string, runtimeId: string): Promise<CommandResult> {
+    return execSimCtl(['upgrade', udid, runtimeId], { ...this.options, timeout: 300000 });
+  }
+
+  // ==========================================================================
+  // Pairs (Watch)
+  // ==========================================================================
+
+  /**
+   * Create watch/phone pair
+   */
+  async pair(watchUdid: string, phoneUdid: string): Promise<CommandResult> {
+    return execSimCtl(['pair', watchUdid, phoneUdid], this.options);
+  }
+
+  /**
+   * Unpair watch/phone
+   */
+  async unpair(watchUdid: string, phoneUdid: string): Promise<CommandResult> {
+    return execSimCtl(['unpair', watchUdid, phoneUdid], this.options);
+  }
+
+  /**
+   * Activate pair
+   */
+  async pairActivate(watchUdid: string, phoneUdid: string): Promise<CommandResult> {
+    return execSimCtl(['pair_activate', watchUdid, phoneUdid], this.options);
+  }
+
+  // ==========================================================================
+  // UI Options
+  // ==========================================================================
+
+  /**
+   * Get UI options
+   */
+  async getUI(udid: string): Promise<CommandResult> {
+    return execSimCtl(['ui', udid, 'appearance'], this.options);
+  }
+
+  /**
+   * Set UI appearance
+   */
+  async setUI(udid: string, options: {
+    appearance?: 'light' | 'dark';
+    contentSize?: 'extra-small' | 'small' | 'medium' | 'large' | 'extra-large' | 'accessibility-medium' | 'accessibility-large' | 'accessibility-extra-large';
+  }): Promise<CommandResult> {
+    const args = ['ui', udid, 'appearance'];
+
+    if (options.appearance) args.push('--appearance', options.appearance);
+    if (options.contentSize) args.push('--content-size', options.contentSize);
+
+    return execSimCtl(args, this.options);
+  }
+}