Function determineSimulatorUuid

src/utils/simulator-utils.ts:43–121

(
  params: { simulatorUuid?: string; simulatorId?: string; simulatorName?: string },
  executor: CommandExecutor,
)

}

export async function determineSimulatorUuid(
  params: { simulatorUuid?: string; simulatorId?: string; simulatorName?: string },
  executor: CommandExecutor,
): Promise<{ uuid?: string; warning?: string; error?: string }> {
  const directUuid = params.simulatorUuid ?? params.simulatorId;

  if (directUuid) {
    log('info', `Using provided simulator UUID: ${directUuid}`);
    return { uuid: directUuid };
  }

  if (params.simulatorName) {
    if (UUID_REGEX.test(params.simulatorName)) {
      log(
        'info',
        `Simulator name '${params.simulatorName}' appears to be a UUID, using it directly`,
      );
      return {
        uuid: params.simulatorName,
        warning: `The simulatorName '${params.simulatorName}' appears to be a UUID. Consider using simulatorUuid parameter instead.`,
      };
    }

    log('info', `Looking up simulator UUID for name: ${params.simulatorName}`);

    const listResult = await executor(
      ['xcrun', 'simctl', 'list', 'devices', 'available', '-j'],
      'List available simulators',
    );

    if (!listResult.success) {
      return {
        error: `Failed to list simulators: ${listResult.error ?? 'Unknown error'}`,
      };
    }

    try {
      interface SimulatorDevice {
        udid: string;
        name: string;
        isAvailable: boolean;
      }

      interface DevicesData {
        devices: Record<string, SimulatorDevice[]>;
      }

      const devicesData = JSON.parse(listResult.output ?? '{}') as DevicesData;

      const allDevices = Object.values(devicesData.devices).filter(Array.isArray).flat();

      const namedDevices = allDevices.filter((d) => d.name === params.simulatorName);

      const availableDevice = namedDevices.find((d) => d.isAvailable);
      if (availableDevice) {
        log('info', `Found simulator '${params.simulatorName}' with UUID: ${availableDevice.udid}`);
        return { uuid: availableDevice.udid };
      }