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

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+import { HarnessError } from '@react-native-harness/tools';
+export declare class NoRunnerSpecifiedError extends HarnessError {
+    constructor();
+}
+export declare class RunnerNotFoundError extends HarnessError {
+    readonly runnerName: string;
+    constructor(runnerName: string);
+}
+export declare class InitializationTimeoutError extends HarnessError {
+    constructor();
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,qBAAa,sBAAuB,SAAQ,YAAY;;CAKvD;AAED,qBAAa,mBAAoB,SAAQ,YAAY;aACvB,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAI/C;AAED,qBAAa,0BAA2B,SAAQ,YAAY;;CAK3D"}

package/dist/errors.js

@@ -0,0 +1,21 @@
+import { HarnessError } from '@react-native-harness/tools';
+export class NoRunnerSpecifiedError extends HarnessError {
+    constructor() {
+        super('No runner specified');
+        this.name = 'NoRunnerSpecifiedError';
+    }
+}
+export class RunnerNotFoundError extends HarnessError {
+    runnerName;
+    constructor(runnerName) {
+        super(`Runner "${runnerName}" not found`);
+        this.runnerName = runnerName;
+        this.name = 'RunnerNotFoundError';
+    }
+}
+export class InitializationTimeoutError extends HarnessError {
+    constructor() {
+        super('The Harness did not become ready within the timeout period.');
+        this.name = 'InitializationTimeoutError';
+    }
+}

package/dist/harness.d.ts

@@ -0,0 +1,10 @@
+import { BridgeClientFunctions } from '@react-native-harness/bridge';
+import { HarnessPlatform } from '@react-native-harness/platforms';
+import { Config as HarnessConfig } from '@react-native-harness/config';
+export type Harness = {
+    runTests: BridgeClientFunctions['runTests'];
+    restart: () => Promise<void>;
+    dispose: () => Promise<void>;
+};
+export declare const getHarness: (config: HarnessConfig, platform: HarnessPlatform) => Promise<Harness>;
+//# sourceMappingURL=harness.d.ts.map

package/dist/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAKvE,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC5C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AA0EF,eAAO,MAAM,UAAU,GACrB,QAAQ,aAAa,EACrB,UAAU,eAAe,KACxB,OAAO,CAAC,OAAO,CAajB,CAAC"}

package/dist/harness.js

@@ -0,0 +1,72 @@
+import { getBridgeServer } from '@react-native-harness/bridge/server';
+import { getMetroInstance } from '@react-native-harness/bundler-metro';
+import { InitializationTimeoutError } from './errors.js';
+import pRetry from 'p-retry';
+const BRIDGE_READY_TIMEOUT = 10000;
+const getHarnessInternal = async (config, platform, signal) => {
+    const [metroInstance, platformInstance, serverBridge] = await Promise.all([
+        getMetroInstance(),
+        platform.getInstance(),
+        getBridgeServer({
+            port: 3001,
+            timeout: config.bridgeTimeout,
+        }),
+    ]);
+    const dispose = async () => {
+        await Promise.all([
+            serverBridge.dispose(),
+            platformInstance.dispose(),
+            metroInstance.dispose(),
+        ]);
+    };
+    if (signal.aborted) {
+        await dispose();
+        throw new DOMException('The operation was aborted', 'AbortError');
+    }
+    try {
+        await pRetry(() => new Promise((resolve, reject) => {
+            signal.addEventListener('abort', () => {
+                reject(new DOMException('The operation was aborted', 'AbortError'));
+            });
+            serverBridge.once('ready', () => resolve());
+            platformInstance.restartApp().catch(reject);
+        }), {
+            minTimeout: BRIDGE_READY_TIMEOUT,
+            maxTimeout: BRIDGE_READY_TIMEOUT,
+            retries: Infinity,
+            signal,
+        });
+    }
+    catch (error) {
+        await dispose();
+        throw error;
+    }
+    const restart = () => new Promise((resolve, reject) => {
+        serverBridge.once('ready', () => resolve());
+        platformInstance.restartApp().catch(reject);
+    });
+    return {
+        runTests: async (path, options) => {
+            const client = serverBridge.rpc.clients.at(-1);
+            if (!client) {
+                throw new Error('No client found');
+            }
+            return await client.runTests(path, options);
+        },
+        restart,
+        dispose,
+    };
+};
+export const getHarness = async (config, platform) => {
+    const abortSignal = AbortSignal.timeout(config.bridgeTimeout);
+    try {
+        const harness = await getHarnessInternal(config, platform, abortSignal);
+        return harness;
+    }
+    catch (error) {
+        if (error instanceof DOMException && error.name === 'AbortError') {
+            throw new InitializationTimeoutError();
+        }
+        throw error;
+    }
+};

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import type { CallbackTestRunnerInterface, Config, OnTestFailure, OnTestStart, OnTestSuccess, Test, TestRunnerOptions, TestWatcher } from 'jest-runner';
 import { Config as HarnessConfig } from '@react-native-harness/config';
-import { type Harness } from '@react-native-harness/cli/external';
+import { type Harness } from './harness.js';
 export default class JestHarness implements CallbackTestRunnerInterface {
     #private;
     readonly isSerial = true;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,MAAM,EACN,aAAa,EACb,WAAW,EACX,aAAa,EACb,IAAI,EACJ,iBAAiB,EACjB,WAAW,EACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAW/E,MAAM,CAAC,OAAO,OAAO,WAAY,YAAW,2BAA2B;;IACrE,QAAQ,CAAC,QAAQ,QAAQ;gBAIb,YAAY,EAAE,MAAM,CAAC,YAAY;IAIvC,QAAQ,CACZ,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC;IA8BV,oBAAoB,CACxB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,aAAa,GACvB,OAAO,CAAC,IAAI,CAAC;CAuCjB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,MAAM,EACN,aAAa,EACb,WAAW,EACX,aAAa,EACb,IAAI,EACJ,iBAAiB,EACjB,WAAW,EACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAc5C,MAAM,CAAC,OAAO,OAAO,WAAY,YAAW,2BAA2B;;IACrE,QAAQ,CAAC,QAAQ,QAAQ;gBAIb,YAAY,EAAE,MAAM,CAAC,YAAY;IAIvC,QAAQ,CACZ,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC;IAkCV,oBAAoB,CACxB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,aAAa,GACvB,OAAO,CAAC,IAAI,CAAC;CA+CjB"}

package/dist/index.js

@@ -1,8 +1,10 @@
 import pLimit from 'p-limit';
 import { runHarnessTestFile } from './run.js';
-import { formatError } from '@react-native-harness/cli/external';
 import { setup } from './setup.js';
 import { teardown } from './teardown.js';
+import { HarnessError } from '@react-native-harness/tools';
+import { getErrorMessage } from './logs.js';
+import { DeviceNotRespondingError } from '@react-native-harness/bridge';
 class CancelRun extends Error {
     constructor(message) {
         super(message);
@@ -27,8 +29,11 @@ export default class JestHarness {
             return await this._createInBandTestRun(tests, watcher, harness, harnessConfig, onStart, onResult, onFailure);
         }
         catch (error) {
-            // Jest will print strings as they are, without processing them further.
-            throw formatError(error);
+            if (error instanceof HarnessError) {
+                // Jest will print strings as they are, without processing them further.
+                throw getErrorMessage(error);
+            }
+            throw error;
         }
         finally {
             // This is necessary as Harness may throw and we want to catch it and display a helpful error message.
@@ -45,10 +50,7 @@ export default class JestHarness {
             }
             if (harnessConfig.resetEnvironmentBetweenTestFiles &&
                 !isFirstTest) {
-                await new Promise((resolve) => {
-                    harness.bridge.once('ready', resolve);
-                    harness.environment.restart();
-                });
+                await harness.restart();
             }
             isFirstTest = false;
             return onStart(test).then(() => runHarnessTestFile({
@@ -59,6 +61,15 @@ export default class JestHarness {
             }));
         })
             .then((result) => onResult(test, result))
-            .catch((err) => onFailure(test, err))), Promise.resolve());
+            .catch((err) => {
+            if (err instanceof DeviceNotRespondingError) {
+                onFailure(test, {
+                    message: err.message,
+                    stack: '',
+                });
+                return;
+            }
+            onFailure(test, err);
+        })), Promise.resolve());
     }
 }

package/dist/logs.d.ts

@@ -1,5 +1,7 @@
-import { TestRunnerConfig } from '@react-native-harness/config';
+import { HarnessPlatform } from '@react-native-harness/platforms';
+import { HarnessError } from '@react-native-harness/tools';
 export declare const log: (message: string) => void;
-export declare const logTestRunHeader: (runner: TestRunnerConfig) => void;
-export declare const logTestEnvironmentReady: (runner: TestRunnerConfig) => void;
+export declare const logTestRunHeader: (runner: HarnessPlatform) => void;
+export declare const logTestEnvironmentReady: (runner: HarnessPlatform) => void;
+export declare const getErrorMessage: (error: HarnessError) => string;
 //# sourceMappingURL=logs.d.ts.map

package/dist/logs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAQhE,eAAO,MAAM,GAAG,GAAI,SAAS,MAAM,KAAG,IAErC,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,gBAAgB,KAAG,IAI3D,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,QAAQ,gBAAgB,KAAG,IAElE,CAAC"}
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAY3D,eAAO,MAAM,GAAG,GAAI,SAAS,MAAM,KAAG,IAErC,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,eAAe,KAAG,IAI1D,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,QAAQ,eAAe,KAAG,IAEjE,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,YAAY,KAAG,MAErD,CAAC"}

package/dist/logs.js

@@ -2,6 +2,9 @@ import chalk from 'chalk';
 const TAG = chalk.supportsColor
     ? chalk.reset.inverse.bold.magenta(` HARNESS `)
     : 'HARNESS';
+const ERROR_TAG = chalk.supportsColor
+    ? chalk.reset.inverse.bold.red(` HARNESS `)
+    : 'HARNESS';
 // @see https://github.com/jestjs/jest/blob/main/packages/jest-reporters/src/BaseReporter.ts#L25
 export const log = (message) => {
     process.stderr.write(`${message}\n`);
@@ -12,3 +15,6 @@ export const logTestRunHeader = (runner) => {
 export const logTestEnvironmentReady = (runner) => {
     log(`${TAG} Runner ${chalk.bold(runner.name)} ready\n`);
 };
+export const getErrorMessage = (error) => {
+    return `${ERROR_TAG} ${error.message}\n`;
+};

package/dist/run.d.ts

@@ -1,6 +1,6 @@
 import type { Config as JestConfig } from 'jest-runner';
 import { TestResult as JestTestResult } from '@jest/test-result';
-import type { Harness } from '@react-native-harness/cli/external';
+import type { Harness } from './harness.js';
 export type RunHarnessTestFile = (options: {
     testPath: string;
     harness: Harness;

package/dist/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAuDlE,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC;IACxC,YAAY,EAAE,UAAU,CAAC,YAAY,CAAC;CACvC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAE9B,eAAO,MAAM,kBAAkB,EAAE,kBA6EhC,CAAC"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAuD5C,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC;IACxC,YAAY,EAAE,UAAU,CAAC,YAAY,CAAC;CACvC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAE9B,eAAO,MAAM,kBAAkB,EAAE,kBA4EhC,CAAC"}

package/dist/run.js

@@ -48,8 +48,7 @@ export const runHarnessTestFile = async ({ testPath, globalConfig, projectConfig
     // Extract setup files from Jest config and convert to relative paths
     const setupFiles = projectConfig.setupFiles?.map((setupFile) => path.relative(globalConfig.rootDir, setupFile));
     const setupFilesAfterEnv = projectConfig.setupFilesAfterEnv?.map((setupFile) => path.relative(globalConfig.rootDir, setupFile));
-    const client = harness.bridge.rpc.clients.at(-1);
-    const results = await client.runTests(relativeTestPath, {
+    const results = await harness.runTests(relativeTestPath, {
         testNamePattern: globalConfig.testNamePattern,
         setupFiles,
         setupFilesAfterEnv,

package/dist/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AA4CxD,eAAO,MAAM,KAAK,GAAU,cAAc,UAAU,CAAC,YAAY,kBA4ChE,CAAC"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAqCxD,eAAO,MAAM,KAAK,GAAU,cAAc,UAAU,CAAC,YAAY,kBAqChE,CAAC"}

package/dist/setup.js

@@ -1,8 +1,9 @@
 import { getConfig, } from '@react-native-harness/config';
-import { getHarness as getHarnessExternal, NoRunnerSpecifiedError, RunnerNotFoundError, } from '@react-native-harness/cli/external';
+import { getHarness } from './harness.js';
 import { preRunMessage } from 'jest-util';
 import { getAdditionalCliArgs } from './cli-args.js';
 import { logTestEnvironmentReady, logTestRunHeader } from './logs.js';
+import { NoRunnerSpecifiedError, RunnerNotFoundError } from './errors.js';
 const getHarnessConfig = async (globalConfig) => {
     const projectRoot = globalConfig.rootDir;
     const { config: harnessConfig } = await getConfig(projectRoot);
@@ -11,40 +12,30 @@ const getHarnessConfig = async (globalConfig) => {
 const getHarnessRunner = (config, cliArgs) => {
     const selectedRunnerName = cliArgs.harnessRunner ?? config.defaultRunner;
     if (!selectedRunnerName) {
-        throw new NoRunnerSpecifiedError(config.runners);
+        throw new NoRunnerSpecifiedError();
     }
     const runner = config.runners.find((runner) => runner.name === selectedRunnerName);
     if (!runner) {
-        throw new RunnerNotFoundError(selectedRunnerName, config.runners);
+        throw new RunnerNotFoundError(selectedRunnerName);
     }
     return runner;
 };
-const getHarness = async (runner) => {
-    return await getHarnessExternal(runner);
-};
 export const setup = async (globalConfig) => {
     preRunMessage.remove(process.stderr);
     const harnessConfig = global.HARNESS_CONFIG ?? (await getHarnessConfig(globalConfig));
-    const isWatchMode = globalConfig.watch || globalConfig.watchAll;
     if (global.HARNESS) {
         // Do not setup again if HARNESS is already initialized
         // This is useful when running tests in watch mode
         if (harnessConfig.resetEnvironmentBetweenTestFiles) {
             // In watch mode, we want to restart the environment before each test run
-            await new Promise((resolve) => {
-                global.HARNESS.bridge.once('ready', resolve);
-                global.HARNESS.environment.restart();
-            });
+            await global.HARNESS.restart();
         }
         return;
     }
-    if (isWatchMode) {
-        // In watch mode, we want to dispose the Harness when the process exits.
-        process.on('exit', async () => {
-            await global.HARNESS.bridge.dispose();
-            await global.HARNESS.environment.dispose();
-        });
-    }
+    // Gracefully dispose the Harness when the process exits.
+    process.on('exit', async () => {
+        await global.HARNESS.dispose();
+    });
     const cliArgs = getAdditionalCliArgs();
     const selectedRunner = getHarnessRunner(harnessConfig, cliArgs);
     if (globalConfig.collectCoverage) {
@@ -53,7 +44,7 @@ export const setup = async (globalConfig) => {
         process.env.RN_HARNESS_COLLECT_COVERAGE = 'true';
     }
     logTestRunHeader(selectedRunner);
-    const harness = await getHarness(selectedRunner);
+    const harness = await getHarness(harnessConfig, selectedRunner);
     logTestEnvironmentReady(selectedRunner);
     global.HARNESS_CONFIG = harnessConfig;
     global.HARNESS = harness;

package/dist/teardown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"teardown.d.ts","sourceRoot":"","sources":["../src/teardown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAExD,eAAO,MAAM,QAAQ,GAAU,cAAc,UAAU,CAAC,YAAY,kBAYnE,CAAC"}
+{"version":3,"file":"teardown.d.ts","sourceRoot":"","sources":["../src/teardown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAExD,eAAO,MAAM,QAAQ,GAAU,cAAc,UAAU,CAAC,YAAY,kBAWnE,CAAC"}

package/dist/teardown.js

@@ -5,7 +5,6 @@ export const teardown = async (globalConfig) => {
         return;
     }
     if (global.HARNESS) {
-        await global.HARNESS.bridge.dispose();
-        await global.HARNESS.environment.dispose();
+        await global.HARNESS.dispose();
     }
 };