@react-native-harness/cli 1.0.0-alpha.15 → 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/commands/test.ts

@@ -1,228 +0,0 @@
-import {
-  getBridgeServer,
-  type BridgeServer,
-} from '@react-native-harness/bridge/server';
-import { TestExecutionOptions } from '@react-native-harness/bridge';
-import {
-  Config,
-  getConfig,
-  TestRunnerConfig,
-} from '@react-native-harness/config';
-import { getPlatformAdapter } from '../platforms/platform-registry.js';
-import { intro, logger, outro, spinner } from '@react-native-harness/tools';
-import { type Environment } from '../platforms/platform-adapter.js';
-import { BridgeTimeoutError } from '../errors/errors.js';
-import { assert } from '../utils.js';
-import {
-  EnvironmentInitializationError,
-  NoRunnerSpecifiedError,
-  RpcClientError,
-  RunnerNotFoundError,
-} from '../errors/errors.js';
-import { TestSuiteResult } from '@react-native-harness/bridge';
-import {
-  discoverTestFiles,
-  type TestFilterOptions,
-} from '../discovery/index.js';
-
-type TestRunContext = {
-  config: Config;
-  runner: TestRunnerConfig;
-  bridge?: BridgeServer;
-  environment?: Environment;
-  testFiles?: string[];
-  results?: TestSuiteResult[];
-  projectRoot: string;
-};
-
-const setupEnvironment = async (context: TestRunContext): Promise<void> => {
-  const startSpinner = spinner();
-  const platform = context.runner.platform;
-
-  startSpinner.start(`Starting "${context.runner.name}" (${platform}) runner`);
-
-  const platformAdapter = await getPlatformAdapter(platform);
-  const serverBridge = await getBridgeServer({
-    port: 3001,
-  });
-
-  context.bridge = serverBridge;
-
-  const readyPromise = new Promise<void>((resolve, reject) => {
-    const timeout = setTimeout(() => {
-      reject(
-        new BridgeTimeoutError(
-          context.config.bridgeTimeout,
-          context.runner.name,
-          platform
-        )
-      );
-    }, context.config.bridgeTimeout);
-
-    serverBridge.once('ready', () => {
-      clearTimeout(timeout);
-      resolve();
-    });
-  });
-
-  context.environment = await platformAdapter.getEnvironment(context.runner);
-
-  logger.debug('Waiting for bridge to be ready');
-  await readyPromise;
-  logger.debug('Bridge is ready');
-
-  if (!context.environment) {
-    throw new EnvironmentInitializationError(
-      'Failed to initialize environment',
-      context.runner.name,
-      platform,
-      'Platform adapter returned null environment'
-    );
-  }
-
-  startSpinner.stop(`"${context.runner.name}" (${platform}) runner started`);
-};
-
-const findTestFiles = async (
-  context: TestRunContext,
-  options: TestFilterOptions = {}
-): Promise<void> => {
-  const discoverSpinner = spinner();
-  discoverSpinner.start('Discovering tests');
-
-  context.testFiles = await discoverTestFiles(
-    context.projectRoot,
-    context.config.include,
-    options
-  );
-
-  discoverSpinner.stop(`Found ${context.testFiles.length} test files`);
-};
-
-const runTests = async (
-  context: TestRunContext,
-  options: TestFilterOptions = {}
-): Promise<void> => {
-  const { bridge, environment, testFiles } = context;
-  assert(bridge != null, 'Bridge not initialized');
-  assert(environment != null, 'Environment not initialized');
-  assert(testFiles != null, 'Test files not initialized');
-
-  let runSpinner = spinner();
-  runSpinner.start('Running tests');
-
-  let shouldRestart = false;
-
-  for (const testFile of testFiles) {
-    if (shouldRestart) {
-      runSpinner = spinner();
-      runSpinner.start(`Restarting environment for next test file`);
-
-      await new Promise((resolve) => {
-        bridge.once('ready', resolve);
-        environment.restart();
-      });
-    }
-
-    runSpinner.message(`Running tests in ${testFile}`);
-    const client = bridge.rpc.clients.at(-1);
-    if (!client) {
-      throw new RpcClientError(
-        'No RPC client available',
-        3001,
-        'No clients connected'
-      );
-    }
-
-    // Pass only testNamePattern to runtime (file filtering already done)
-    const executionOptions: TestExecutionOptions = {
-      testNamePattern: options.testNamePattern,
-    };
-
-    const result = await client.runTests(testFile, executionOptions);
-    context.results = [...(context.results ?? []), ...result.suites];
-    shouldRestart = true;
-    runSpinner.stop(`Test file ${testFile} completed`);
-  }
-
-  runSpinner.stop('Tests completed');
-};
-
-const cleanUp = async (context: TestRunContext): Promise<void> => {
-  if (context.bridge) {
-    context.bridge.dispose();
-  }
-  if (context.environment) {
-    await context.environment.dispose();
-  }
-};
-
-const hasFailedTests = (results: TestSuiteResult[]): boolean => {
-  for (const suite of results) {
-    // Check if the suite itself failed
-    if (suite.status === 'failed') {
-      return true;
-    }
-
-    // Check individual tests in the suite
-    for (const test of suite.tests) {
-      if (test.status === 'failed') {
-        return true;
-      }
-    }
-
-    // Recursively check nested suites
-    if (suite.suites && hasFailedTests(suite.suites)) {
-      return true;
-    }
-  }
-
-  return false;
-};
-
-export const testCommand = async (
-  runnerName?: string,
-  options: TestFilterOptions = {}
-): Promise<void> => {
-  intro('React Native Test Harness');
-
-  const { config, projectRoot } = await getConfig(process.cwd());
-  const selectedRunnerName = runnerName ?? config.defaultRunner;
-
-  if (!selectedRunnerName) {
-    throw new NoRunnerSpecifiedError(config.runners);
-  }
-
-  const runner = config.runners.find((r) => r.name === selectedRunnerName);
-
-  if (!runner) {
-    throw new RunnerNotFoundError(selectedRunnerName, config.runners);
-  }
-
-  const context: TestRunContext = {
-    config,
-    runner,
-    testFiles: [],
-    results: [],
-    projectRoot,
-  };
-
-  try {
-    await setupEnvironment(context);
-    await findTestFiles(context, options);
-    await runTests(context, options);
-
-    assert(context.results != null, 'Results not initialized');
-    config.reporter?.report(context.results);
-  } finally {
-    await cleanUp(context);
-  }
-
-  // Check if any tests failed and exit with appropriate code
-  if (hasFailedTests(context.results)) {
-    outro('Test run completed with failures');
-    process.exit(1);
-  } else {
-    outro('Test run completed successfully');
-  }
-};

package/src/discovery/index.ts

@@ -1,2 +0,0 @@
-export { discoverTestFiles } from './testDiscovery.js';
-export type { TestFilterOptions } from './testDiscovery.js';

package/src/discovery/testDiscovery.ts

@@ -1,50 +0,0 @@
-import { Glob } from 'glob';
-
-export type TestFilterOptions = {
-  testNamePattern?: string;
-  testPathPattern?: string;
-  testPathIgnorePatterns?: string[];
-  testMatch?: string[];
-};
-
-/**
- * Discovers test files based on patterns and filtering options
- */
-export const discoverTestFiles = async (
-  projectRoot: string,
-  configInclude: string | string[],
-  options: TestFilterOptions = {}
-): Promise<string[]> => {
-  // Priority: testMatch > configInclude
-  const patterns = options.testMatch || configInclude;
-  const patternArray = Array.isArray(patterns) ? patterns : [patterns];
-
-  // Glob discovery
-  const allFiles: string[] = [];
-  for (const pattern of patternArray) {
-    const glob = new Glob(pattern, { cwd: projectRoot, nodir: true });
-    const files = await glob.walk();
-    allFiles.push(...files);
-  }
-
-  // Remove duplicates
-  let uniqueFiles = [...new Set(allFiles)];
-
-  // Apply testPathPattern filtering
-  if (options.testPathPattern) {
-    const regex = new RegExp(options.testPathPattern);
-    uniqueFiles = uniqueFiles.filter((file) => regex.test(file));
-  }
-
-  // Apply testPathIgnorePatterns filtering
-  if (options.testPathIgnorePatterns?.length) {
-    const ignoreRegexes = options.testPathIgnorePatterns.map(
-      (p) => new RegExp(p)
-    );
-    uniqueFiles = uniqueFiles.filter(
-      (file) => !ignoreRegexes.some((regex) => regex.test(file))
-    );
-  }
-
-  return uniqueFiles;
-};

package/src/errors/errorHandler.ts

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