@ebowwa/ios-devices 1.0.0

package/src/utils.ts

@@ -0,0 +1,174 @@
+/**
+ * Command execution utilities
+ */
+
+import { spawn } from 'child_process';
+import { parse as parseArgs } from 'shell-quote';
+import { CommandResultSchema, type CommandResult } from './types.js';
+
+export interface ExecOptions {
+  timeout?: number;
+  jsonOutput?: boolean;
+  cwd?: string;
+  env?: Record<string, string>;
+}
+
+/**
+ * Execute a command and return structured result
+ */
+export async function exec(
+  command: string,
+  args: string[] = [],
+  options: ExecOptions = {}
+): Promise<CommandResult> {
+  const { timeout = 60000, cwd, env } = options;
+
+  return new Promise((resolve) => {
+    const proc = spawn(command, args, {
+      cwd,
+      env: { ...process.env, ...env },
+      stdio: ['ignore', 'pipe', 'pipe'],
+    });
+
+    let stdout = '';
+    let stderr = '';
+
+    proc.stdout?.on('data', (data) => {
+      stdout += data.toString();
+    });
+
+    proc.stderr?.on('data', (data) => {
+      stderr += data.toString();
+    });
+
+    const timer = setTimeout(() => {
+      proc.kill('SIGTERM');
+      stderr += '\nCommand timed out';
+    }, timeout);
+
+    proc.on('close', (code) => {
+      clearTimeout(timer);
+      const result: CommandResult = {
+        success: code === 0,
+        stdout,
+        stderr,
+        exitCode: code ?? 1,
+      };
+
+      // Try to parse JSON if output looks like JSON
+      const trimmed = stdout.trim();
+      if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        try {
+          result.json = JSON.parse(trimmed);
+        } catch {
+          // Not valid JSON
+        }
+      }
+
+      resolve(CommandResultSchema.parse(result));
+    });
+
+    proc.on('error', (err) => {
+      clearTimeout(timer);
+      resolve({
+        success: false,
+        stdout,
+        stderr: err.message,
+        exitCode: 1,
+      });
+    });
+  });
+}
+
+/**
+ * Execute xcrun devicectl with JSON output
+ */
+export async function execDeviceCtl(
+  subcommand: string[],
+  options: ExecOptions = {}
+): Promise<CommandResult> {
+  const args = ['devicectl', ...subcommand];
+
+  // Add JSON output for stable parsing
+  if (!args.includes('--json-output')) {
+    args.push('--json-output', '-');
+  }
+
+  const result = await exec('xcrun', args, options);
+
+  // devicectl writes JSON to stderr when using --json-output -
+  // but also check stdout
+  if (result.stderr && result.stderr.startsWith('{')) {
+    try {
+      result.json = JSON.parse(result.stderr);
+    } catch {
+      // Not valid JSON
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Execute libimobiledevice tool
+ */
+export async function execILDevice(
+  tool: string,
+  args: string[] = [],
+  options: ExecOptions = {}
+): Promise<CommandResult> {
+  return exec(tool, args, options);
+}
+
+/**
+ * Execute xcrun simctl
+ */
+export async function execSimCtl(
+  subcommand: string[],
+  options: ExecOptions = {}
+): Promise<CommandResult> {
+  return exec('xcrun', ['simctl', ...subcommand], options);
+}
+
+/**
+ * Parse command string into args
+ */
+export function parseCommand(command: string): string[] {
+  return parseArgs(command).filter((arg): arg is string => typeof arg === 'string');
+}
+
+/**
+ * Build device identifier argument
+ */
+export function buildDeviceArg(identifier: string): string[] {
+  return ['--device', identifier];
+}
+
+/**
+ * Check if a command exists
+ */
+export async function commandExists(command: string): Promise<boolean> {
+  const result = await exec('which', [command], { timeout: 5000 });
+  return result.success && result.stdout.trim().length > 0;
+}
+
+/**
+ * Check available tools
+ */
+export async function checkAvailableTools(): Promise<{
+  devicectl: boolean;
+  simctl: boolean;
+  libimobiledevice: boolean;
+}> {
+  const [devicectl, simctl, libimobiledevice] = await Promise.all([
+    commandExists('xcrun').then((exists) => exists && exec('xcrun', ['devicectl', '--version'], { timeout: 5000 }).then((r) => r.success)),
+    commandExists('xcrun').then((exists) => exists && exec('xcrun', ['simctl', 'help'], { timeout: 5000 }).then((r) => r.success)),
+    commandExists('idevicesyslog'),
+  ]);
+
+  return {
+    devicectl,
+    simctl,
+    libimobiledevice,
+  };
+}