@react-native-harness/cli 1.0.0-alpha.9 → 1.0.0-canary.1761729829908

package/dist/utils/status-formatter.d.ts

@@ -0,0 +1,27 @@
+import type { BridgeEvents } from '@react-native-harness/bridge';
+/**
+ * Type-safe status line formatter for bridge events.
+ * This ensures every event type has a corresponding status message.
+ *
+ * When adding new events to BridgeEvents:
+ * 1. Add the event type to the appropriate events file in packages/bridge/src/shared/
+ * 2. Add a formatter function to the statusFormatter object below
+ * 3. TypeScript will enforce that all event types are covered
+ * 4. The formatter function receives the full event data for type safety
+ */
+export type StatusFormatter = {
+    [K in BridgeEvents['type']]: (event: Extract<BridgeEvents, {
+        type: K;
+    }>) => string;
+};
+/**
+ * Maps every bridge event to a concise, informative status line.
+ * Each formatter receives the full event data for type safety.
+ */
+export declare const statusFormatter: StatusFormatter;
+/**
+ * Formats a bridge event into a status line.
+ * This function is type-safe and ensures all event types are handled.
+ */
+export declare const formatEventStatus: (event: BridgeEvents) => string;
+//# sourceMappingURL=status-formatter.d.ts.map

package/dist/utils/status-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/status-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG;KAC3B,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,GAAG,CAC3B,KAAK,EAAE,OAAO,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,KACtC,MAAM;CACZ,CAAC;AAcF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,eAkD7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,YAAY,KAAG,MAGvD,CAAC"}

package/dist/utils/status-formatter.js

@@ -0,0 +1,54 @@
+const formatDuration = (duration) => {
+    if (duration < 1000) {
+        return `${duration}ms`;
+    }
+    return `${(duration / 1000).toFixed(2)}s`;
+};
+const formatFileName = (file) => {
+    // Extract just the filename from the path for cleaner display
+    return file.split('/').pop() || file;
+};
+/**
+ * Maps every bridge event to a concise, informative status line.
+ * Each formatter receives the full event data for type safety.
+ */
+export const statusFormatter = {
+    // Test Collection Events
+    'collection-started': (event) => `📋 Collecting tests from ${formatFileName(event.file)}`,
+    'collection-finished': (event) => `✅ Collected tests from ${formatFileName(event.file)} (${formatDuration(event.duration)})`,
+    // Test Runner Events
+    'file-started': (event) => `🧪 Running tests in ${formatFileName(event.file)}`,
+    'file-finished': (event) => `✅ Finished ${formatFileName(event.file)} (${formatDuration(event.duration)})`,
+    'suite-started': (event) => `📦 ${event.name}`,
+    'suite-finished': (event) => {
+        const icon = event.status === 'failed'
+            ? '❌'
+            : event.status === 'skipped'
+                ? '⏭️'
+                : '✅';
+        return `${icon} ${event.name} (${formatDuration(event.duration)})`;
+    },
+    'test-started': (event) => `  🔄 ${event.name}`,
+    'test-finished': (event) => {
+        const icon = event.status === 'failed'
+            ? '❌'
+            : event.status === 'skipped'
+                ? '⏭️'
+                : event.status === 'todo'
+                    ? '📝'
+                    : '✅';
+        return `  ${icon} ${event.name} (${formatDuration(event.duration)})`;
+    },
+    // Bundler Events
+    'module-bundling-started': (event) => `📦 Bundling ${formatFileName(event.file)}`,
+    'module-bundling-finished': (event) => `✅ Bundled ${formatFileName(event.file)} (${formatDuration(event.duration)})`,
+    'module-bundling-failed': (event) => `❌ Failed to bundle ${formatFileName(event.file)} (${formatDuration(event.duration)})`,
+};
+/**
+ * Formats a bridge event into a status line.
+ * This function is type-safe and ensures all event types are handled.
+ */
+export const formatEventStatus = (event) => {
+    // TypeScript ensures this covers all event types
+    return statusFormatter[event.type](event);
+};

package/dist/utils.d.ts

@@ -2,4 +2,5 @@ export declare function assert(condition: boolean, message: string): asserts con
 export declare class AssertionError extends Error {
     constructor(message: string);
 }
+export declare const isPortAvailable: (port: number) => Promise<boolean>;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,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;AAED,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,OAAO,CAAC,OAAO,CAa7D,CAAC"}

package/dist/utils.js

@@ -1,3 +1,4 @@
+import net from 'node:net';
 export function assert(condition, message) {
     if (!condition) {
         throw new AssertionError(message);
@@ -9,3 +10,17 @@ export class AssertionError extends Error {
         this.name = 'AssertionError';
     }
 }
+export const isPortAvailable = (port) => {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', () => {
+            server.close();
+            resolve(false);
+        });
+        server.once('listening', () => {
+            server.close();
+            resolve(true);
+        });
+        server.listen(port);
+    });
+};

package/eslint.config.mjs

@@ -9,6 +9,7 @@ export default [
         'error',
         {
           ignoredFiles: ['{projectRoot}/eslint.config.{js,cjs,mjs,ts,cts,mts}'],
+          ignoredDependencies: ['@react-native-harness/bridge'],
         },
       ],
     },

package/package.json

@@ -1,20 +1,36 @@
 {
   "name": "@react-native-harness/cli",
-  "version": "1.0.0-alpha.9",
+  "version": "1.0.0-canary.1761729829908",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./external": {
+      "development": "./src/external.ts",
+      "types": "./dist/external.d.ts",
+      "import": "./dist/external.js",
+      "default": "./dist/external.js"
+    }
+  },
   "dependencies": {
-    "commander": "^14.0.0",
-    "glob": "^11.0.0",
-    "playwright": "^1.53.2",
     "tslib": "^2.3.0",
-    "@react-native-harness/bridge": "1.0.0-alpha.9",
-    "@react-native-harness/tools": "1.0.0-alpha.9",
-    "@react-native-harness/config": "1.0.0-alpha.9"
+    "@react-native-harness/bridge": "1.0.0-canary.1761729829908",
+    "@react-native-harness/config": "1.0.0-canary.1761729829908"
   },
   "devDependencies": {
-    "@types/node": "18.16.9"
-  }
+    "@types/node": "18.16.9",
+    "jest-cli": "^30.2.0"
+  },
+  "peerDependencies": {
+    "jest-cli": "*"
+  },
+  "license": "MIT"
 }

package/src/index.ts

@@ -1,50 +1,71 @@
-import { Command } from 'commander';
-import { readFileSync } from 'fs';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-import { testCommand } from './commands/test.js';
-import { handleError } from './errors/errorHandler.js';
-import { logger } from '@react-native-harness/tools';
+import { run, yargsOptions } from 'jest-cli';
+import { getConfig } from '@react-native-harness/config';
 
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const packageJsonPath = join(__dirname, '../package.json');
-const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+const checkForOldConfig = async () => {
+  try {
+    const { config } = await getConfig(process.cwd());
 
-const program = new Command();
-
-logger.setVerbose(true);
-
-program
-  .name('react-native-harness')
-  .description(
-    'React Native Test Harness - A comprehensive testing framework for React Native applications'
-  )
-  .version(packageJson.version);
-
-program
-  .command('test')
-  .description('Run tests using the specified runner')
-  .argument(
-    '[runner]',
-    'test runner name (uses defaultRunner from config if not specified)'
-  )
-  .argument(
-    '[pattern]',
-    'glob pattern to match test files (uses config.include if not specified)'
-  )
-  .action(async (runner, pattern) => {
-    try {
-      await testCommand(runner, pattern);
-    } catch (error) {
-      handleError(error);
+    if (config.include) {
+      console.error('\n❌ Migration Required\n');
+      console.error('React Native Harness has migrated to the Jest CLI.');
+      console.error(
+        'The "include" property in your rn-harness.config file is no longer supported.\n'
+      );
+      console.error(
+        'Please follow the migration guide to update your configuration:'
+      );
+      console.error(
+        'https://react-native-harness.dev/docs/guides/migration-guide\n'
+      );
       process.exit(1);
     }
-  });
+  } catch {
+    // Swallow the error - if we can't load the config, let Jest CLI handle it
+  }
+};
+
+const patchYargsOptions = () => {
+  yargsOptions.harnessRunner = {
+    type: 'string',
+    description: 'Specify which Harness runner to use',
+    requiresArg: true,
+  };
 
-process.on('uncaughtException', (error) => {
-  handleError(error);
-  process.exit(1);
-});
+  // Remove all options that are not supported by Harness
+  delete yargsOptions.runner;
+  delete yargsOptions.testRunner;
+  delete yargsOptions.testEnvironment;
+  delete yargsOptions.testEnvironmentOptions;
+  delete yargsOptions.transform;
+  delete yargsOptions.transformIgnorePatterns;
+  delete yargsOptions.updateSnapshot;
+  delete yargsOptions.workerThreads;
+  delete yargsOptions.snapshotSerializers;
+  delete yargsOptions.shard;
+  delete yargsOptions.runInBand;
+  delete yargsOptions.resolver;
+  delete yargsOptions.resetMocks;
+  delete yargsOptions.resetModules;
+  delete yargsOptions.restoreMocks;
+  delete yargsOptions.preset;
+  delete yargsOptions.prettierPath;
+  delete yargsOptions.maxWorkers;
+  delete yargsOptions.moduleDirectories;
+  delete yargsOptions.moduleFileExtensions;
+  delete yargsOptions.moduleNameMapper;
+  delete yargsOptions.modulePathIgnorePatterns;
+  delete yargsOptions.modulePaths;
+  delete yargsOptions.maxConcurrency;
+  delete yargsOptions.injectGlobals;
+  delete yargsOptions.globalSetup;
+  delete yargsOptions.globalTeardown;
+  delete yargsOptions.clearMocks;
+  delete yargsOptions.globals;
+  delete yargsOptions.haste;
+  delete yargsOptions.automock;
+  delete yargsOptions.coverageProvider;
+  delete yargsOptions.logHeapUsage;
+};
 
-program.parse();
+patchYargsOptions();
+checkForOldConfig().then(() => run());

package/tsconfig.lib.json

@@ -10,19 +10,8 @@
     "types": ["node"],
     "lib": ["DOM"]
   },
-  "include": [
-    "src/**/*.ts",
-    "../tools/src/abort.ts",
-    "../tools/src/color.ts",
-    "../tools/src/isInteractive.ts",
-    "../tools/src/logger.ts",
-    "../tools/src/prompts.ts",
-    "../tools/src/spawn.ts"
-  ],
+  "include": ["src/**/*.ts"],
   "references": [
-    {
-      "path": "../tools/tsconfig.lib.json"
-    },
     {
       "path": "../config/tsconfig.lib.json"
     },

package/src/bundlers/metro.ts

@@ -1,89 +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' }),
-      },
-    }
-  );
-
-  // Forward metro output to CLI output
-  metro.nodeChildProcess.then((childProcess) => {
-    if (childProcess.stdout) {
-      childProcess.stdout.pipe(process.stdout);
-    }
-    if (childProcess.stderr) {
-      childProcess.stderr.pipe(process.stderr);
-    }
-  });
-
-  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,218 +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 {
-  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 { TestSuiteResult } from '@react-native-harness/bridge';
-
-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,
-  pattern?: string
-): Promise<void> => {
-  const discoverSpinner = spinner();
-  discoverSpinner.start('Discovering tests');
-
-  const globPattern = pattern || context.config.include;
-  const glob = new Glob(globPattern, {
-    cwd: context.projectRoot,
-  });
-  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();
-  }
-};
-
-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,
-  pattern?: string
-): 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, pattern);
-    await runTests(context);
-
-    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');
-  }
-};