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

package/README.md

@@ -1,7 +1,26 @@
-# cli
+![harness-banner](https://react-native-harness.dev/harness-banner.jpg)
 
-This library was generated with [Nx](https://nx.dev).
+### Command Line Interface for React Native Harness
 
-## Building
+[![mit licence][license-badge]][license]
+[![npm downloads][npm-downloads-badge]][npm-downloads]
+[![Chat][chat-badge]][chat]
+[![PRs Welcome][prs-welcome-badge]][prs-welcome]
 
-Run `nx build cli` to build the library.
+Command-line interface that orchestrates test execution across iOS simulators and Android emulators, managing the entire testing workflow from bundling to result reporting.
+
+## Made with ❤️ at Callstack
+
+`@react-native-harness/cli` is an open source project and will always remain free to use. If you think it's cool, please star it 🌟. [Callstack][callstack-readme-with-love] is a group of React and React Native geeks, contact us at [hello@callstack.com](mailto:hello@callstack.com) if you need any help with these or just want to say hi!
+
+Like the project? ⚛️ [Join the team](https://callstack.com/careers/?utm_campaign=Senior_RN&utm_source=github&utm_medium=readme) who does amazing stuff for clients and drives React Native Open Source! 🔥
+
+[callstack-readme-with-love]: https://callstack.com/?utm_source=github.com&utm_medium=referral&utm_campaign=react-native-harness&utm_term=readme-with-love
+[license-badge]: https://img.shields.io/npm/l/@react-native-harness/cli?style=for-the-badge
+[license]: https://github.com/callstackincubator/react-native-harness/blob/main/LICENSE
+[npm-downloads-badge]: https://img.shields.io/npm/dm/@react-native-harness/cli?style=for-the-badge
+[npm-downloads]: https://www.npmjs.com/package/@react-native-harness/cli
+[prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge
+[prs-welcome]: ../../CONTRIBUTING.md
+[chat-badge]: https://img.shields.io/discord/426714625279524876.svg?style=for-the-badge
+[chat]: https://discord.gg/xgGt7KAjxv

package/dist/bundlers/metro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metro.d.ts","sourceRoot":"","sources":["../../src/bundlers/metro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAWvD,eAAO,MAAM,QAAQ,GAAU,gBAAc,KAAG,OAAO,CAAC,YAAY,CAuCnE,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,aAAW,EACX,mBAAe,EACf,mBAAiB,KAChB,OAAO,CAAC,IAAI,CA4Bd,CAAC;AAEF,eAAO,MAAM,SAAS,QAAa,OAAO,CAAC,IAAI,CAE9C,CAAC"}
+{"version":3,"file":"metro.d.ts","sourceRoot":"","sources":["../../src/bundlers/metro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAcvD,eAAO,MAAM,QAAQ,GAAU,gBAAc,KAAG,OAAO,CAAC,YAAY,CAiDnE,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,aAAW,EACX,mBAAe,EACf,mBAAiB,KAChB,OAAO,CAAC,IAAI,CA4Bd,CAAC;AAEF,eAAO,MAAM,SAAS,QAAa,OAAO,CAAC,IAAI,CAE9C,CAAC"}

package/dist/bundlers/metro.js

@@ -1,4 +1,6 @@
-import { getReactNativeCliPath, getExpoCliPath, getTimeoutSignal, spawn, SubprocessError, } from '@react-native-harness/tools';
+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) => {
     const metro = spawn('node', [
@@ -13,13 +15,17 @@ export const runMetro = async (isExpo = false) => {
             ...(isExpo && { EXPO_NO_METRO_WORKSPACE_ROOT: 'true' }),
         },
     });
-    // Forward metro output to CLI output
+    // Forward metro output to logger
     metro.nodeChildProcess.then((childProcess) => {
         if (childProcess.stdout) {
-            childProcess.stdout.pipe(process.stdout);
+            childProcess.stdout.on('data', (data) => {
+                logger.debug(data.toString().trim());
+            });
         }
         if (childProcess.stderr) {
-            childProcess.stderr.pipe(process.stderr);
+            childProcess.stderr.on('data', (data) => {
+                logger.debug(data.toString().trim());
+            });
         }
     });
     metro.catch((error) => {
@@ -27,8 +33,12 @@ export const runMetro = async (isExpo = false) => {
         if (error instanceof SubprocessError && error.signalName === 'SIGTERM') {
             return;
         }
-        throw error;
+        logger.error('Metro crashed unexpectedly', error);
     });
+    const isDefaultPortAvailable = await isPortAvailable(METRO_PORT);
+    if (!isDefaultPortAvailable) {
+        throw new MetroPortUnavailableError(METRO_PORT);
+    }
     await waitForMetro();
     return metro.nodeChildProcess;
 };

package/dist/commands/test.d.ts

@@ -1,2 +1,3 @@
-export declare const testCommand: (runnerName?: string, pattern?: string) => Promise<void>;
+import { type TestFilterOptions } from '../discovery/index.js';
+export declare const testCommand: (runnerName?: string, options?: TestFilterOptions) => Promise<void>;
 //# sourceMappingURL=test.d.ts.map

package/dist/commands/test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"AA4KA,eAAO,MAAM,WAAW,GACtB,aAAa,MAAM,EACnB,UAAU,MAAM,KACf,OAAO,CAAC,IAAI,CA0Cd,CAAC"}
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"AAsBA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAiK/B,eAAO,MAAM,WAAW,GACtB,aAAa,MAAM,EACnB,UAAS,iBAAsB,KAC9B,OAAO,CAAC,IAAI,CA0Cd,CAAC"}

package/dist/commands/test.js

@@ -1,11 +1,11 @@
 import { getBridgeServer, } from '@react-native-harness/bridge/server';
 import { getConfig, } 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 { intro, logger, outro, spinner } from '@react-native-harness/tools';
 import { BridgeTimeoutError } from '../errors/errors.js';
 import { assert } from '../utils.js';
 import { EnvironmentInitializationError, NoRunnerSpecifiedError, RpcClientError, RunnerNotFoundError, } from '../errors/errors.js';
+import { discoverTestFiles, } from '../discovery/index.js';
 const setupEnvironment = async (context) => {
     const startSpinner = spinner();
     const platform = context.runner.platform;
@@ -33,28 +33,24 @@ const setupEnvironment = async (context) => {
     }
     startSpinner.stop(`"${context.runner.name}" (${platform}) runner started`);
 };
-const findTestFiles = async (context, pattern) => {
+const findTestFiles = async (context, options = {}) => {
     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();
+    context.testFiles = await discoverTestFiles(context.projectRoot, context.config.include, options);
     discoverSpinner.stop(`Found ${context.testFiles.length} test files`);
 };
-const runTests = async (context) => {
-    const { bridge, environment, testFiles } = context;
+const runTests = async (context, options = {}) => {
+    const { bridge, environment, testFiles, config } = 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' });
+    let runSpinner = spinner();
     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`);
+            runSpinner = spinner();
+            runSpinner.start(`Restarting environment for next test file`);
             await new Promise((resolve) => {
                 bridge.once('ready', resolve);
                 environment.restart();
@@ -65,14 +61,22 @@ const runTests = async (context) => {
         if (!client) {
             throw new RpcClientError('No RPC client available', 3001, 'No clients connected');
         }
-        const result = await client.runTests(testFile);
+        // Pass only testNamePattern to runtime (file filtering already done)
+        const executionOptions = {
+            testNamePattern: options.testNamePattern,
+        };
+        const result = await client.runTests(testFile, executionOptions);
         context.results = [...(context.results ?? []), ...result.suites];
-        shouldRestart = true;
+        if (config.resetEnvironmentBetweenTestFiles) {
+            shouldRestart = true;
+        }
+        runSpinner.stop(`Test file ${testFile} completed`);
     }
+    runSpinner.stop('Tests completed');
 };
 const cleanUp = async (context) => {
     if (context.bridge) {
-        context.bridge.ws.close();
+        context.bridge.dispose();
     }
     if (context.environment) {
         await context.environment.dispose();
@@ -97,7 +101,7 @@ const hasFailedTests = (results) => {
     }
     return false;
 };
-export const testCommand = async (runnerName, pattern) => {
+export const testCommand = async (runnerName, options = {}) => {
     intro('React Native Test Harness');
     const { config, projectRoot } = await getConfig(process.cwd());
     const selectedRunnerName = runnerName ?? config.defaultRunner;
@@ -117,8 +121,8 @@ export const testCommand = async (runnerName, pattern) => {
     };
     try {
         await setupEnvironment(context);
-        await findTestFiles(context, pattern);
-        await runTests(context);
+        await findTestFiles(context, options);
+        await runTests(context, options);
         assert(context.results != null, 'Results not initialized');
         config.reporter?.report(context.results);
     }

package/dist/discovery/index.d.ts

@@ -0,0 +1,3 @@
+export { discoverTestFiles } from './testDiscovery.js';
+export type { TestFilterOptions } from './testDiscovery.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/discovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/discovery/index.js

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

package/dist/discovery/testDiscovery.d.ts

@@ -0,0 +1,11 @@
+export type TestFilterOptions = {
+    testNamePattern?: string;
+    testPathPattern?: string;
+    testPathIgnorePatterns?: string[];
+    testMatch?: string[];
+};
+/**
+ * Discovers test files based on patterns and filtering options
+ */
+export declare const discoverTestFiles: (projectRoot: string, configInclude: string | string[], options?: TestFilterOptions) => Promise<string[]>;
+//# sourceMappingURL=testDiscovery.d.ts.map

package/dist/discovery/testDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testDiscovery.d.ts","sourceRoot":"","sources":["../../src/discovery/testDiscovery.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,aAAa,MAAM,EACnB,eAAe,MAAM,GAAG,MAAM,EAAE,EAChC,UAAS,iBAAsB,KAC9B,OAAO,CAAC,MAAM,EAAE,CAiClB,CAAC"}

package/dist/discovery/testDiscovery.js

@@ -0,0 +1,29 @@
+import { Glob } from 'glob';
+/**
+ * Discovers test files based on patterns and filtering options
+ */
+export const discoverTestFiles = async (projectRoot, configInclude, options = {}) => {
+    // Priority: testMatch > configInclude
+    const patterns = options.testMatch || configInclude;
+    const patternArray = Array.isArray(patterns) ? patterns : [patterns];
+    // Glob discovery
+    const allFiles = [];
+    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/dist/errors/errorHandler.d.ts

@@ -1,2 +1,2 @@
-export declare const handleError: (error: unknown) => void;
+export declare const formatError: (error: unknown) => string;
 //# sourceMappingURL=errorHandler.d.ts.map

package/dist/errors/errorHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/errors/errorHandler.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,IAkL5C,CAAC"}
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/errors/errorHandler.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,MAqK5C,CAAC"}

package/dist/errors/errorHandler.js

@@ -1,150 +1,152 @@
 import { ConfigLoadError, ConfigNotFoundError, ConfigValidationError, } from '@react-native-harness/config';
 import { AssertionError } from '../utils.js';
-import { NoRunnerSpecifiedError, RunnerNotFoundError, EnvironmentInitializationError, TestExecutionError, RpcClientError, AppNotInstalledError, BridgeTimeoutError, BundlingFailedError, } from './errors.js';
-export const handleError = (error) => {
+import { NoRunnerSpecifiedError, RunnerNotFoundError, EnvironmentInitializationError, TestExecutionError, RpcClientError, BridgeTimeoutError, BundlingFailedError, MetroPortUnavailableError, } from './errors.js';
+export const formatError = (error) => {
+    const lines = [];
     if (error instanceof AssertionError) {
-        console.error(`\n❌ Assertion Error`);
-        console.error(`\nError: ${error.message}`);
-        console.error(`\nPlease check your configuration and try again.`);
+        lines.push(`\n❌ Assertion Error`);
+        lines.push(`\nError: ${error.message}`);
+        lines.push(`\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:`);
+        lines.push(`\n❌ Configuration Error`);
+        lines.push(`\nFile: ${error.filePath}`);
+        lines.push(`\nValidation errors:`);
         error.validationErrors.forEach((err) => {
-            console.error(`  • ${err}`);
+            lines.push(`  • ${err}`);
         });
-        console.error(`\nPlease fix the configuration errors and try again.`);
+        lines.push(`\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.`);
+        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) {
-        console.error(`\n❌ Configuration Load Error`);
-        console.error(`\nFile: ${error.filePath}`);
-        console.error(`Error: ${error.message}`);
+        lines.push(`\n❌ Configuration Load Error`);
+        lines.push(`\nFile: ${error.filePath}`);
+        lines.push(`Error: ${error.message}`);
         if (error.cause) {
-            console.error(`\nCause: ${error.cause.message}`);
+            lines.push(`\nCause: ${error.cause.message}`);
         }
-        console.error(`\nPlease check your configuration file syntax and try again.`);
+        lines.push(`\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:');
+        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) => {
-            console.error(`  • ${r.name} (${r.platform})`);
+            lines.push(`  • ${r.name} (${r.platform})`);
         });
-        console.error('\nTo set a default runner, add "defaultRunner" to your config:');
-        console.error('  { "defaultRunner": "your-runner-name" }');
+        lines.push('\nTo set a default runner, add "defaultRunner" to your config:');
+        lines.push('  { "defaultRunner": "your-runner-name" }');
     }
     else if (error instanceof RunnerNotFoundError) {
-        console.error(`\n❌ Runner "${error.runnerName}" not found`);
-        console.error('\nAvailable runners:');
+        lines.push(`\n❌ Runner "${error.runnerName}" not found`);
+        lines.push('\nAvailable runners:');
         error.availableRunners.forEach((r) => {
-            console.error(`  • ${r.name} (${r.platform})`);
+            lines.push(`  • ${r.name} (${r.platform})`);
         });
-        console.error('\nTo add a new runner, update your rn-harness.config file.');
+        lines.push('\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}`);
+        lines.push(`\n❌ Environment Initialization Error`);
+        lines.push(`\nRunner: ${error.runnerName} (${error.platform})`);
+        lines.push(`\nError: ${error.message}`);
         if (error.details) {
-            console.error(`\nDetails: ${error.details}`);
+            lines.push(`\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`);
+        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') {
-            console.error(`  • Verify Xcode and iOS Simulator are working correctly`);
+            lines.push(`  • Verify Xcode and iOS Simulator are working correctly`);
         }
         else if (error.platform === 'android') {
-            console.error(`  • Verify Android SDK and emulator are working correctly`);
+            lines.push(`  • Verify Android SDK and emulator are working correctly`);
         }
-        console.error(`\nPlease check your environment configuration and try again.`);
+        lines.push(`\nPlease check your environment configuration and try again.`);
     }
     else if (error instanceof TestExecutionError) {
-        console.error(`\n❌ Test Execution Error`);
-        console.error(`\nFile: ${error.testFile}`);
+        lines.push(`\n❌ Test Execution Error`);
+        lines.push(`\nFile: ${error.testFile}`);
         if (error.testSuite) {
-            console.error(`\nSuite: ${error.testSuite}`);
+            lines.push(`\nSuite: ${error.testSuite}`);
         }
         if (error.testName) {
-            console.error(`\nTest: ${error.testName}`);
+            lines.push(`\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.`);
+        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) {
-        console.error(`\n❌ RPC Client Error`);
-        console.error(`\nError: ${error.message}`);
+        lines.push(`\n❌ RPC Client Error`);
+        lines.push(`\nError: ${error.message}`);
         if (error.bridgePort) {
-            console.error(`\nBridge Port: ${error.bridgePort}`);
+            lines.push(`\nBridge Port: ${error.bridgePort}`);
         }
         if (error.connectionStatus) {
-            console.error(`\nConnection Status: ${error.connectionStatus}`);
+            lines.push(`\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.`);
+        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 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.`);
+        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) {
-        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.`);
+        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 {
-        console.error(`\n❌ Unexpected Error`);
-        console.error(error);
+        // Re-throw the error to be handled by the caller
+        throw error;
     }
+    return lines.join('');
 };

package/dist/errors/errors.d.ts

@@ -1,4 +1,4 @@
-import { TestRunnerConfig } from '@react-native-harness/config';
+type TestRunnerConfig = any;
 export declare class NoRunnerSpecifiedError extends Error {
     constructor(availableRunners: TestRunnerConfig[]);
     availableRunners: TestRunnerConfig[];
@@ -32,15 +32,14 @@ export declare class BridgeTimeoutError extends Error {
     readonly platform: string;
     constructor(timeout: number, runnerName: string, platform: string);
 }
-export declare class AppNotInstalledError extends Error {
-    readonly deviceName: string;
-    readonly bundleId: string;
-    readonly platform: 'ios' | 'android';
-    constructor(deviceName: string, bundleId: string, platform: 'ios' | 'android');
-}
 export declare class BundlingFailedError extends Error {
     readonly modulePath: string;
     readonly reason: string;
     constructor(modulePath: string, reason: string);
 }
+export declare class MetroPortUnavailableError extends Error {
+    readonly port: number;
+    constructor(port: number);
+}
+export {};
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,gBAAgB,EAAE,gBAAgB,EAAE;IAKhD,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;CACtC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE;IAMpE,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;CACtC;AAED,qBAAa,8BAA+B,SAAQ,KAAK;gBAErD,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM;IAUlB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAEzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM;IAenB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM;IAS3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,OAAO,EAAE,MAAM;aACf,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;gBAFhB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM;CAOnC;AAED,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;aAChB,QAAQ,EAAE,KAAK,GAAG,SAAS;gBAF3B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,KAAK,GAAG,SAAS;CAS9C;AAED,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,UAAU,EAAE,MAAM;aAClB,MAAM,EAAE,MAAM;gBADd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM;CAKjC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,KAAK,gBAAgB,GAAG,GAAG,CAAC;AAE5B,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,gBAAgB,EAAE,gBAAgB,EAAE;IAKhD,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;CACtC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE;IAMpE,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;CACtC;AAED,qBAAa,8BAA+B,SAAQ,KAAK;gBAErD,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM;IAUlB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAEzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM;IAenB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM;IAS3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,OAAO,EAAE,MAAM;aACf,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;gBAFhB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM;CAOnC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,UAAU,EAAE,MAAM;aAClB,MAAM,EAAE,MAAM;gBADd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM;CAKjC;AAED,qBAAa,yBAA0B,SAAQ,KAAK;aACtB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIzC"}

package/dist/errors/errors.js

@@ -69,18 +69,6 @@ export class BridgeTimeoutError extends Error {
         this.name = 'BridgeTimeoutError';
     }
 }
-export class AppNotInstalledError extends Error {
-    deviceName;
-    bundleId;
-    platform;
-    constructor(deviceName, bundleId, platform) {
-        super(`App "${bundleId}" is not installed on ${platform === 'ios' ? 'simulator' : 'emulator'} "${deviceName}"`);
-        this.deviceName = deviceName;
-        this.bundleId = bundleId;
-        this.platform = platform;
-        this.name = 'AppNotInstalledError';
-    }
-}
 export class BundlingFailedError extends Error {
     modulePath;
     reason;
@@ -91,3 +79,11 @@ export class BundlingFailedError extends Error {
         this.name = 'BundlingFailedError';
     }
 }
+export class MetroPortUnavailableError extends Error {
+    port;
+    constructor(port) {
+        super(`Metro port ${port} is not available`);
+        this.port = port;
+        this.name = 'MetroPortUnavailableError';
+    }
+}

package/dist/external.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=external.d.ts.map

package/dist/external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../src/external.ts"],"names":[],"mappings":""}

package/dist/external.js

@@ -0,0 +1 @@
+export {};