@react-native-harness/cli 1.0.0-alpha.17 → 1.0.0-alpha.18

package/src/bundlers/metro.ts

@@ -1,102 +0,0 @@
-import { type ChildProcess } from 'node:child_process';
-import {
-  getReactNativeCliPath,
-  getExpoCliPath,
-  getTimeoutSignal,
-  spawn,
-  logger,
-  SubprocessError,
-} from '@react-native-harness/tools';
-import { isPortAvailable } from '../utils.js';
-import { MetroPortUnavailableError } from '../errors/errors.js';
-
-const METRO_PORT = 8081;
-
-export const runMetro = async (isExpo = false): Promise<ChildProcess> => {
-  const metro = spawn(
-    'node',
-    [
-      isExpo ? getExpoCliPath() : getReactNativeCliPath(),
-      'start',
-      '--port',
-      METRO_PORT.toString(),
-    ],
-    {
-      env: {
-        ...process.env,
-        RN_HARNESS: 'true',
-        ...(isExpo && { EXPO_NO_METRO_WORKSPACE_ROOT: 'true' }),
-      },
-    }
-  );
-
-  // Forward metro output to logger
-  metro.nodeChildProcess.then((childProcess) => {
-    if (childProcess.stdout) {
-      childProcess.stdout.on('data', (data) => {
-        logger.debug(data.toString().trim());
-      });
-    }
-    if (childProcess.stderr) {
-      childProcess.stderr.on('data', (data) => {
-        logger.debug(data.toString().trim());
-      });
-    }
-  });
-
-  metro.catch((error) => {
-    // This process is going to be killed by us, so we don't need to throw an error
-    if (error instanceof SubprocessError && error.signalName === 'SIGTERM') {
-      return;
-    }
-
-    logger.error('Metro crashed unexpectedly', error);
-  });
-
-  const isDefaultPortAvailable = await isPortAvailable(METRO_PORT);
-
-  if (!isDefaultPortAvailable) {
-    throw new MetroPortUnavailableError(METRO_PORT);
-  }
-
-  await waitForMetro();
-  return metro.nodeChildProcess;
-};
-
-export const waitForMetro = async (
-  port = 8081,
-  maxRetries = 20,
-  retryDelay = 1000
-): Promise<void> => {
-  let attempts = 0;
-
-  while (attempts < maxRetries) {
-    attempts++;
-
-    try {
-      const response = await fetch(`http://localhost:${port}/status`, {
-        signal: getTimeoutSignal(100),
-      });
-
-      if (response.ok) {
-        const body = await response.text();
-
-        if (body === 'packager-status:running') {
-          return;
-        }
-      }
-    } catch {
-      // Errors are expected here, we're just waiting for the process to be ready
-    }
-
-    if (attempts < maxRetries) {
-      await new Promise((resolve) => setTimeout(resolve, retryDelay));
-    }
-  }
-
-  throw new Error(`Metro bundler is not ready after ${maxRetries} attempts`);
-};
-
-export const reloadApp = async (): Promise<void> => {
-  await fetch(`http://localhost:${METRO_PORT}/reload`);
-};

package/src/errors/errorHandler.ts

@@ -1,218 +0,0 @@
-import {
-  ConfigLoadError,
-  ConfigNotFoundError,
-  ConfigValidationError,
-} from '@react-native-harness/config';
-import { AssertionError } from '../utils.js';
-import {
-  NoRunnerSpecifiedError,
-  RunnerNotFoundError,
-  EnvironmentInitializationError,
-  TestExecutionError,
-  RpcClientError,
-  AppNotInstalledError,
-  BridgeTimeoutError,
-  BundlingFailedError,
-  MetroPortUnavailableError,
-} from './errors.js';
-
-export const formatError = (error: unknown): string => {
-  const lines: string[] = [];
-
-  if (error instanceof AssertionError) {
-    lines.push(`\n❌ Assertion Error`);
-    lines.push(`\nError: ${error.message}`);
-    lines.push(`\nPlease check your configuration and try again.`);
-  } else if (error instanceof ConfigValidationError) {
-    lines.push(`\n❌ Configuration Error`);
-    lines.push(`\nFile: ${error.filePath}`);
-    lines.push(`\nValidation errors:`);
-    error.validationErrors.forEach((err) => {
-      lines.push(`  • ${err}`);
-    });
-    lines.push(`\nPlease fix the configuration errors and try again.`);
-  } else if (error instanceof ConfigNotFoundError) {
-    lines.push(`\n❌ Configuration Not Found`);
-    lines.push(
-      `\nCould not find 'rn-harness.config' in '${error.searchPath}' or any parent directories.`
-    );
-    lines.push(`\nSupported file extensions: .js, .mjs, .cjs, .json`);
-    lines.push(
-      `\nPlease create a configuration file or run from a directory that contains one.`
-    );
-  } else if (error instanceof ConfigLoadError) {
-    lines.push(`\n❌ Configuration Load Error`);
-    lines.push(`\nFile: ${error.filePath}`);
-    lines.push(`Error: ${error.message}`);
-    if (error.cause) {
-      lines.push(`\nCause: ${error.cause.message}`);
-    }
-    lines.push(`\nPlease check your configuration file syntax and try again.`);
-  } else if (error instanceof NoRunnerSpecifiedError) {
-    lines.push('\n❌ No runner specified');
-    lines.push(
-      '\nPlease specify a runner name or set a defaultRunner in your config.'
-    );
-    lines.push('\nUsage: react-native-harness test [runner-name] [pattern]');
-    lines.push('\nAvailable runners:');
-    error.availableRunners.forEach((r) => {
-      lines.push(`  • ${r.name} (${r.platform})`);
-    });
-    lines.push(
-      '\nTo set a default runner, add "defaultRunner" to your config:'
-    );
-    lines.push('  { "defaultRunner": "your-runner-name" }');
-  } else if (error instanceof RunnerNotFoundError) {
-    lines.push(`\n❌ Runner "${error.runnerName}" not found`);
-    lines.push('\nAvailable runners:');
-    error.availableRunners.forEach((r) => {
-      lines.push(`  • ${r.name} (${r.platform})`);
-    });
-    lines.push('\nTo add a new runner, update your rn-harness.config file.');
-  } else if (error instanceof EnvironmentInitializationError) {
-    lines.push(`\n❌ Environment Initialization Error`);
-    lines.push(`\nRunner: ${error.runnerName} (${error.platform})`);
-    lines.push(`\nError: ${error.message}`);
-    if (error.details) {
-      lines.push(`\nDetails: ${error.details}`);
-    }
-    lines.push(`\nTroubleshooting steps:`);
-    lines.push(
-      `  • Verify that ${error.platform} development environment is properly set up`
-    );
-    lines.push(`  • Check that the app is built and ready for testing`);
-    lines.push(`  • Ensure all required dependencies are installed`);
-    if (error.platform === 'ios') {
-      lines.push(`  • Verify Xcode and iOS Simulator are working correctly`);
-    } else if (error.platform === 'android') {
-      lines.push(`  • Verify Android SDK and emulator are working correctly`);
-    }
-    lines.push(`\nPlease check your environment configuration and try again.`);
-  } else if (error instanceof TestExecutionError) {
-    lines.push(`\n❌ Test Execution Error`);
-    lines.push(`\nFile: ${error.testFile}`);
-    if (error.testSuite) {
-      lines.push(`\nSuite: ${error.testSuite}`);
-    }
-    if (error.testName) {
-      lines.push(`\nTest: ${error.testName}`);
-    }
-    lines.push(`\nError: ${error.message}`);
-    lines.push(`\nTroubleshooting steps:`);
-    lines.push(`  • Check the test file syntax and logic`);
-    lines.push(`  • Verify all test dependencies are available`);
-    lines.push(`  • Ensure the app is in the expected state for the test`);
-    lines.push(`  • Check device/emulator logs for additional error details`);
-    lines.push(`\nPlease check your test file and try again.`);
-  } else if (error instanceof RpcClientError) {
-    lines.push(`\n❌ RPC Client Error`);
-    lines.push(`\nError: ${error.message}`);
-    if (error.bridgePort) {
-      lines.push(`\nBridge Port: ${error.bridgePort}`);
-    }
-    if (error.connectionStatus) {
-      lines.push(`\nConnection Status: ${error.connectionStatus}`);
-    }
-    lines.push(`\nTroubleshooting steps:`);
-    lines.push(`  • Verify the React Native app is running and connected`);
-    lines.push(`  • Check that the bridge port is not blocked by firewall`);
-    lines.push(
-      `  • Ensure the app has the React Native Harness runtime integrated`
-    );
-    lines.push(`  • Try restarting the app and test harness`);
-    lines.push(`\nPlease check your bridge connection and try again.`);
-  } else if (error instanceof AppNotInstalledError) {
-    lines.push(`\n❌ App Not Installed`);
-    const deviceType =
-      error.platform === 'ios'
-        ? 'simulator'
-        : error.platform === 'android'
-        ? 'emulator'
-        : 'virtual device';
-    lines.push(
-      `\nThe app "${error.bundleId}" is not installed on ${deviceType} "${error.deviceName}".`
-    );
-    lines.push(`\nTo resolve this issue:`);
-    if (error.platform === 'ios') {
-      lines.push(
-        `  • Build and install the app: npx react-native run-ios --simulator="${error.deviceName}"`
-      );
-      lines.push(
-        `  • Or install from Xcode: Open ios/*.xcworkspace and run the project`
-      );
-    } else if (error.platform === 'android') {
-      lines.push(`  • Build and install the app: npx react-native run-android`);
-      lines.push(
-        `  • Or build manually: ./gradlew assembleDebug && adb install android/app/build/outputs/apk/debug/app-debug.apk`
-      );
-    } else if (error.platform === 'vega') {
-      lines.push(`  • Build the Vega app: npm run build:app`);
-      lines.push(
-        `  • Install the app: kepler device install-app -p <path-to-vpkg> --device "${error.deviceName}"`
-      );
-      lines.push(
-        `  • Or use the combined command: kepler run-kepler <path-to-vpkg> "${error.bundleId}" -d "${error.deviceName}"`
-      );
-    }
-    lines.push(`\nPlease install the app and try running the tests again.`);
-  } else if (error instanceof BundlingFailedError) {
-    lines.push(`\n❌ Test File Bundling Error`);
-    lines.push(`\nFile: ${error.modulePath}`);
-    lines.push(`\nError: ${error.reason}`);
-    lines.push(`\nTroubleshooting steps:`);
-    lines.push(`  • Check the test file syntax and imports`);
-    lines.push(`  • Verify all imported modules exist and are accessible`);
-    lines.push(`  • Ensure the Metro bundler configuration is correct`);
-    lines.push(`  • Check for any circular dependencies in the test file`);
-    lines.push(`  • Verify that all required packages are installed`);
-    lines.push(`\nPlease fix the bundling issues and try again.`);
-  } else if (error instanceof BridgeTimeoutError) {
-    lines.push(`\n❌ Bridge Connection Timeout`);
-    lines.push(
-      `\nThe bridge connection timed out after ${error.timeout}ms while waiting for the "${error.runnerName}" (${error.platform}) runner to be ready.`
-    );
-    lines.push(`\nThis usually indicates that:`);
-    lines.push(
-      `  • The React Native app failed to load or connect to the bridge`
-    );
-    lines.push(`  • The app crashed during startup`);
-    lines.push(
-      `  • Network connectivity issues between the app and the test harness`
-    );
-    lines.push(`  • The app is taking longer than expected to initialize`);
-    lines.push(`\nTo resolve this issue:`);
-    lines.push(
-      `  • Check that the app is properly installed and can start normally`
-    );
-    lines.push(
-      `  • Verify that the app has the React Native Harness runtime integrated`
-    );
-    lines.push(`  • Check device/emulator logs for any startup errors`);
-    lines.push(`  • Ensure the test harness bridge port (3001) is not blocked`);
-    lines.push(
-      `\nIf the app needs more time to start, consider increasing the timeout in the configuration.`
-    );
-  } else if (error instanceof MetroPortUnavailableError) {
-    lines.push(`\n❌ Metro Port Unavailable`);
-    lines.push(`\nPort ${error.port} is already in use or unavailable.`);
-    lines.push(`\nThis usually indicates that:`);
-    lines.push(`  • Another Metro bundler instance is already running`);
-    lines.push(`  • Another application is using port ${error.port}`);
-    lines.push(`  • The port is blocked by a firewall or security software`);
-    lines.push(`\nTo resolve this issue:`);
-    lines.push(`  • Stop any running Metro bundler instances`);
-    lines.push(
-      `  • Check for other applications using port ${error.port}: lsof -i :${error.port}`
-    );
-    lines.push(`  • Kill the process using the port: kill -9 <PID>`);
-    lines.push(
-      `  • Or use a different port by updating your Metro configuration`
-    );
-    lines.push(`\nPlease free up the port and try again.`);
-  } else {
-    // Re-throw the error to be handled by the caller
-    throw error;
-  }
-
-  return lines.join('');
-};

package/src/errors/errors.ts

@@ -1,131 +0,0 @@
-import { TestRunnerConfig } from '@react-native-harness/config';
-
-export class NoRunnerSpecifiedError extends Error {
-  constructor(availableRunners: TestRunnerConfig[]) {
-    super('No runner specified');
-    this.name = 'NoRunnerSpecifiedError';
-    this.availableRunners = availableRunners;
-  }
-  availableRunners: TestRunnerConfig[];
-}
-
-export class RunnerNotFoundError extends Error {
-  constructor(runnerName: string, availableRunners: TestRunnerConfig[]) {
-    super(`Runner "${runnerName}" not found`);
-    this.name = 'RunnerNotFoundError';
-    this.runnerName = runnerName;
-    this.availableRunners = availableRunners;
-  }
-  runnerName: string;
-  availableRunners: TestRunnerConfig[];
-}
-
-export class EnvironmentInitializationError extends Error {
-  constructor(
-    message: string,
-    runnerName: string,
-    platform: string,
-    details?: string
-  ) {
-    super(
-      `Failed to initialize environment for "${runnerName}" (${platform}): ${message}`
-    );
-    this.name = 'EnvironmentInitializationError';
-    this.runnerName = runnerName;
-    this.platform = platform;
-    this.details = details;
-  }
-  runnerName: string;
-  platform: string;
-  details?: string;
-}
-
-export class TestExecutionError extends Error {
-  constructor(
-    testFile: string,
-    error: unknown,
-    testSuite?: string,
-    testName?: string
-  ) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    const suiteInfo = testSuite ? ` in suite "${testSuite}"` : '';
-    const testInfo = testName ? ` test "${testName}"` : '';
-
-    super(
-      `Test execution failed for ${testFile}${suiteInfo}${testInfo}: ${errorMessage}`
-    );
-    this.name = 'TestExecutionError';
-    this.testFile = testFile;
-    this.testSuite = testSuite;
-    this.testName = testName;
-    this.originalError = error;
-  }
-  testFile: string;
-  testSuite?: string;
-  testName?: string;
-  originalError: unknown;
-}
-
-export class RpcClientError extends Error {
-  constructor(message: string, bridgePort?: number, connectionStatus?: string) {
-    const portInfo = bridgePort ? ` (port ${bridgePort})` : '';
-    const statusInfo = connectionStatus ? ` - Status: ${connectionStatus}` : '';
-
-    super(`RPC client error${portInfo}: ${message}${statusInfo}`);
-    this.name = 'RpcClientError';
-    this.bridgePort = bridgePort;
-    this.connectionStatus = connectionStatus;
-  }
-  bridgePort?: number;
-  connectionStatus?: string;
-}
-
-export class BridgeTimeoutError extends Error {
-  constructor(
-    public readonly timeout: number,
-    public readonly runnerName: string,
-    public readonly platform: string
-  ) {
-    super(
-      `Bridge connection timed out after ${timeout}ms while waiting for "${runnerName}" (${platform}) runner to be ready`
-    );
-    this.name = 'BridgeTimeoutError';
-  }
-}
-
-export class AppNotInstalledError extends Error {
-  constructor(
-    public readonly deviceName: string,
-    public readonly bundleId: string,
-    public readonly platform: 'ios' | 'android' | 'vega'
-  ) {
-    const deviceType =
-      platform === 'ios'
-        ? 'simulator'
-        : platform === 'android'
-        ? 'emulator'
-        : 'virtual device';
-
-    super(
-      `App "${bundleId}" is not installed on ${deviceType} "${deviceName}"`
-    );
-    this.name = 'AppNotInstalledError';
-  }
-}
-
-export class BundlingFailedError extends Error {
-  constructor(
-    public readonly modulePath: string,
-    public readonly reason: string
-  ) {
-    super(`Bundling of ${modulePath} failed: ${reason}`);
-    this.name = 'BundlingFailedError';
-  }
-}
-
-export class MetroPortUnavailableError extends Error {
-  constructor(public readonly port: number) {
-    super(`Metro port ${port} is not available`);
-    this.name = 'MetroPortUnavailableError';
-  }
-}

package/src/platforms/android/build.ts

@@ -1,49 +0,0 @@
-import path from 'node:path';
-import { spawn } from '@react-native-harness/tools';
-
-export const buildAndroidApp = async (): Promise<void> => {
-  await spawn('react-native', ['build-android', '--tasks', 'assembleDebug']);
-};
-
-export const installApp = async (deviceId: string): Promise<void> => {
-  await spawn('adb', [
-    '-s',
-    deviceId,
-    'install',
-    '-r',
-    path.join(
-      process.cwd(),
-      'android',
-      'app',
-      'build',
-      'outputs',
-      'apk',
-      'debug',
-      'app-debug.apk'
-    ),
-  ]);
-};
-
-export const killApp = async (
-  deviceId: string,
-  bundleId: string
-): Promise<void> => {
-  await spawn('adb', ['-s', deviceId, 'shell', 'am', 'force-stop', bundleId]);
-};
-
-export const runApp = async (
-  deviceId: string,
-  bundleId: string,
-  activityName: string
-): Promise<void> => {
-  await killApp(deviceId, bundleId);
-  await spawn('adb', [
-    '-s',
-    deviceId,
-    'shell',
-    'am',
-    'start',
-    '-n',
-    `${bundleId}/${activityName}`,
-  ]);
-};

package/src/platforms/android/device.ts

@@ -1,48 +0,0 @@
-import { spawn } from '@react-native-harness/tools';
-
-export const killApp = async (
-  deviceId: string,
-  bundleId: string
-): Promise<void> => {
-  await spawn('adb', ['-s', deviceId, 'shell', 'am', 'force-stop', bundleId]);
-};
-
-export const runApp = async (
-  deviceId: string,
-  bundleId: string
-): Promise<void> => {
-  await killApp(deviceId, bundleId);
-  await spawn('adb', [
-    '-s',
-    deviceId,
-    'shell',
-    'am',
-    'start',
-    '-n',
-    `${bundleId}/.MainActivity`,
-  ]);
-};
-
-export const isAppInstalled = async (
-  deviceId: string,
-  bundleId: string
-): Promise<boolean> => {
-  try {
-    const { stdout } = await spawn('adb', [
-      '-s',
-      deviceId,
-      'shell',
-      'pm',
-      'list',
-      'packages',
-      bundleId,
-    ]);
-    return stdout.trim() !== '';
-  } catch {
-    return false;
-  }
-};
-
-export const reversePort = async (port: number): Promise<void> => {
-  await spawn('adb', ['reverse', `tcp:${port}`, `tcp:${port}`]);
-};

package/src/platforms/android/emulator.ts

@@ -1,137 +0,0 @@
-import { spawn } from '@react-native-harness/tools';
-import { ChildProcess } from 'node:child_process';
-
-export type AndroidEmulatorStatus = 'running' | 'loading' | 'stopped';
-
-export const getEmulatorNameFromId = async (
-  emulatorId: string
-): Promise<string | null> => {
-  try {
-    const { stdout } = await spawn('adb', [
-      '-s',
-      emulatorId,
-      'emu',
-      'avd',
-      'name',
-    ]);
-    const avdName = stdout.split('\n')[0].trim();
-    return avdName || null;
-  } catch {
-    return null;
-  }
-};
-
-export const getEmulatorDeviceId = async (
-  avdName: string
-): Promise<string | null> => {
-  try {
-    const { stdout } = await spawn('adb', ['devices']);
-    const lines = stdout.split('\n');
-
-    for (const line of lines) {
-      const parts = line.trim().split('\t');
-      if (parts.length === 2 && parts[0].startsWith('emulator-')) {
-        const emulatorId = parts[0].trim();
-        const name = await getEmulatorNameFromId(emulatorId);
-        if (name === avdName) {
-          return emulatorId;
-        }
-      }
-    }
-    return null;
-  } catch {
-    return null;
-  }
-};
-
-export const getEmulatorStatus = async (
-  avdName: string
-): Promise<AndroidEmulatorStatus> => {
-  const emulatorId = await getEmulatorDeviceId(avdName);
-  if (!emulatorId) {
-    return 'stopped';
-  }
-
-  try {
-    // Check if device is fully booted by checking boot completion
-    const { stdout } = await spawn('adb', [
-      '-s',
-      emulatorId,
-      'shell',
-      'getprop',
-      'sys.boot_completed',
-    ]);
-    const bootCompleted = stdout.trim() === '1';
-    return bootCompleted ? 'running' : 'loading';
-  } catch {
-    return 'loading';
-  }
-};
-
-export const runEmulator = async (name: string): Promise<ChildProcess> => {
-  // Start the emulator
-  const process = spawn('emulator', ['-avd', name]);
-  const nodeChildProcess = await process.nodeChildProcess;
-
-  // Poll for emulator status until it's fully running
-  const checkStatus = async (): Promise<void> => {
-    const status = await getEmulatorStatus(name);
-
-    if (status === 'running') {
-      return;
-    } else if (status === 'loading') {
-      // Check again in 2 seconds
-      await new Promise((resolve) => setTimeout(resolve, 2000));
-      await checkStatus();
-    } else {
-      // Still stopped, check again in 1 second
-      await new Promise((resolve) => setTimeout(resolve, 1000));
-      await checkStatus();
-    }
-  };
-
-  // Start checking status after a brief delay to allow emulator to start
-  await new Promise((resolve) => setTimeout(resolve, 3000));
-  await checkStatus();
-
-  return nodeChildProcess;
-};
-
-export const stopEmulator = async (avdName: string): Promise<void> => {
-  // First, get the emulator device ID
-  const emulatorId = await getEmulatorDeviceId(avdName);
-  if (!emulatorId) {
-    return; // No emulator running, nothing to stop
-  }
-
-  await stopEmulatorById(emulatorId);
-};
-
-const stopEmulatorById = async (emulatorId: string): Promise<void> => {
-  // Stop the emulator using the found ID
-  await spawn('adb', ['-s', emulatorId, 'emu', 'kill']);
-};
-
-export const isAppInstalled = async (
-  emulatorId: string,
-  bundleId: string
-): Promise<boolean> => {
-  try {
-    const { stdout } = await spawn('adb', [
-      '-s',
-      emulatorId,
-      'shell',
-      'pm',
-      'list',
-      'packages',
-      bundleId,
-    ]);
-    return stdout.trim() !== '';
-  } catch {
-    return false;
-  }
-};
-
-export const reversePort = async (port: number): Promise<void> => {
-  await spawn('adb', ['reverse', `tcp:${port}`, `tcp:${port}`]);
-};