react-native-harness 1.0.0-alpha.1 → 1.0.0-alpha.11

package/dist/test-reporter-demo.js

@@ -1,95 +0,0 @@
-import { defaultReporter } from './src/reporters/default-reporter.js';
-// Sample test results to demonstrate the new styling
-const sampleResults = [
-    {
-        name: 'User Authentication Tests',
-        status: 'passed',
-        duration: 1250,
-        tests: [
-            {
-                name: 'should login with valid credentials',
-                status: 'passed',
-                duration: 450,
-            },
-            {
-                name: 'should show error with invalid credentials',
-                status: 'passed',
-                duration: 320,
-            },
-            {
-                name: 'should handle network errors gracefully',
-                status: 'failed',
-                duration: 180,
-                error: {
-                    name: 'NetworkError',
-                    message: 'Connection timeout after 30 seconds',
-                    stack: 'NetworkError: Connection timeout after 30 seconds\n    at fetch (native)\n    at login (auth.js:15:10)',
-                },
-            },
-        ],
-        suites: [],
-    },
-    {
-        name: 'Navigation Tests',
-        status: 'passed',
-        duration: 890,
-        tests: [
-            {
-                name: 'should navigate to home screen',
-                status: 'passed',
-                duration: 210,
-            },
-            {
-                name: 'should navigate to profile screen',
-                status: 'skipped',
-                duration: 0,
-            },
-            {
-                name: 'should handle deep linking',
-                status: 'todo',
-                duration: 0,
-            },
-        ],
-        suites: [],
-    },
-    {
-        name: 'Component Tests',
-        status: 'failed',
-        duration: 650,
-        tests: [
-            {
-                name: 'should render button correctly',
-                status: 'passed',
-                duration: 120,
-            },
-            {
-                name: 'should handle button press',
-                status: 'failed',
-                duration: 95,
-                error: {
-                    name: 'AssertionError',
-                    message: 'Expected element to be visible but it was not found',
-                    stack: 'AssertionError: Expected element to be visible but it was not found\n    at expect (test-utils.js:25:10)',
-                },
-            },
-        ],
-        suites: [
-            {
-                name: 'Nested Component Tests',
-                status: 'passed',
-                duration: 280,
-                tests: [
-                    {
-                        name: 'should render nested component',
-                        status: 'passed',
-                        duration: 150,
-                    },
-                ],
-                suites: [],
-            },
-        ],
-    },
-];
-// Run the demo
-console.log('🧪 Testing Updated Default Reporter\n');
-await defaultReporter.report(sampleResults);

package/dist/utils.d.ts

@@ -1,5 +0,0 @@
-export declare function assert(condition: boolean, message: string): asserts condition;
-export declare class AssertionError extends Error {
-    constructor(message: string);
-}
-//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAI7E;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/utils.js

@@ -1,11 +0,0 @@
-export function assert(condition, message) {
-    if (!condition) {
-        throw new AssertionError(message);
-    }
-}
-export class AssertionError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'AssertionError';
-    }
-}

package/src/bundlers/metro.ts

@@ -1,79 +0,0 @@
-import { type ChildProcess } from 'node:child_process';
-import {
-  getReactNativeCliPath,
-  getExpoCliPath,
-  getTimeoutSignal,
-  spawn,
-  SubprocessError,
-} from '@react-native-harness/tools';
-
-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' }),
-      },
-    }
-  );
-
-  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;
-    }
-
-    throw error;
-  });
-
-  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,189 +0,0 @@
-import {
-  getBridgeServer,
-  type BridgeServer,
-} from '@react-native-harness/bridge/server';
-import {
-  Config,
-  getConfig,
-  TestRunnerConfig,
-} from '@react-native-harness/config';
-import { getPlatformAdapter } from '../platforms/platform-registry.js';
-import { Glob } from 'glob';
-import { defaultReporter } from '../reporters/default-reporter.js';
-import {
-  intro,
-  logger,
-  outro,
-  spinner,
-  progress,
-} 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 { TestResult } from '@react-native-harness/bridge';
-
-type TestRunContext = {
-  config: Config;
-  runner: TestRunnerConfig;
-  bridge?: BridgeServer;
-  environment?: Environment;
-  testFiles?: string[];
-  results?: TestResult[];
-};
-
-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,
-  pattern?: string
-): Promise<void> => {
-  const discoverSpinner = spinner();
-  discoverSpinner.start('Discovering tests');
-
-  const globPattern = pattern || context.config.include;
-  const glob = new Glob(globPattern, {
-    cwd: process.cwd(),
-  });
-  context.testFiles = await glob.walk();
-  discoverSpinner.stop(`Found ${context.testFiles.length} test files`);
-};
-
-const runTests = async (context: TestRunContext): 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 = progress({ style: 'block' });
-  runSpinner.start('Running tests');
-
-  let shouldRestart = false;
-
-  for (const testFile of testFiles) {
-    if (shouldRestart) {
-      runSpinner = progress({ style: 'block' });
-      runSpinner.message(`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'
-      );
-    }
-
-    const result = await client.runTests(testFile);
-    context.results = [...(context.results ?? []), ...result.suites];
-    shouldRestart = true;
-  }
-};
-
-const cleanUp = async (context: TestRunContext): Promise<void> => {
-  if (context.bridge) {
-    context.bridge.ws.close();
-  }
-  if (context.environment) {
-    await context.environment.dispose();
-  }
-};
-
-export const testCommand = async (
-  runnerName?: string,
-  pattern?: string
-): Promise<void> => {
-  intro('React Native Test Harness');
-
-  const config = await getConfig(process.cwd());
-  config.reporter = defaultReporter;
-
-  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: [],
-  };
-
-  try {
-    await setupEnvironment(context);
-    await findTestFiles(context, pattern);
-    await runTests(context);
-
-    assert(context.results != null, 'Results not initialized');
-    config.reporter?.report(context.results);
-    outro('Test run completed successfully');
-  } finally {
-    await cleanUp(context);
-  }
-};

package/src/errors/errorHandler.ts

@@ -1,184 +0,0 @@
-import {
-  ConfigLoadError,
-  ConfigNotFoundError,
-  ConfigValidationError,
-} from '@react-native-harness/config';
-import { AssertionError } from '../utils.js';
-import {
-  NoRunnerSpecifiedError,
-  RunnerNotFoundError,
-  EnvironmentInitializationError,
-  TestExecutionError,
-  RpcClientError,
-  AppNotInstalledError,
-  BridgeTimeoutError,
-} 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`);
-    console.error(
-      `\nThe app "${error.bundleId}" is not installed on ${
-        error.platform === 'ios' ? 'simulator' : 'emulator'
-      } "${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 {
-      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`
-      );
-    }
-    console.error(`\nPlease install the app and try running the tests 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 {
-    console.error(`\n❌ Unexpected Error`);
-    console.error(error);
-  }
-};

package/src/errors/errors.ts

@@ -1,109 +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'
-  ) {
-    super(
-      `App "${bundleId}" is not installed on ${
-        platform === 'ios' ? 'simulator' : 'emulator'
-      } "${deviceName}"`
-    );
-    this.name = 'AppNotInstalledError';
-  }
-}