@react-native-harness/jest 1.0.0 → 1.1.0-rc.1

package/dist/harness.d.ts

@@ -1,24 +1,24 @@
 import { BridgeServer } from '@react-native-harness/bridge/server';
 import { HarnessContext, TestExecutionOptions, TestSuiteResult } from '@react-native-harness/bridge';
-import { HarnessPlatform, HarnessPlatformRunner } from '@react-native-harness/platforms';
-import { Reporter } from '@react-native-harness/bundler-metro';
+import { type AppLaunchOptions, HarnessPlatform, HarnessPlatformRunner } from '@react-native-harness/platforms';
 import { Config as HarnessConfig } from '@react-native-harness/config';
-import { CrashMonitor } from './crash-monitor.js';
+import { type CrashSupervisor } from './crash-supervisor.js';
 export type HarnessRunTestsOptions = Exclude<TestExecutionOptions, 'platform'>;
 export type Harness = {
     context: HarnessContext;
     runTests: (path: string, options: HarnessRunTestsOptions) => Promise<TestSuiteResult>;
-    restart: () => Promise<void>;
+    ensureAppReady: (testFilePath: string) => Promise<void>;
+    restart: (testFilePath?: string) => Promise<void>;
     dispose: () => Promise<void>;
-    crashMonitor: CrashMonitor;
+    crashSupervisor: CrashSupervisor;
 };
 export declare const waitForAppReady: (options: {
-    metroEvents: Reporter;
     serverBridge: BridgeServer;
     platformInstance: HarnessPlatformRunner;
-    bundleStartTimeout: number;
-    maxRestarts: number;
-    signal: AbortSignal;
+    bridgeTimeout: number;
+    testFilePath: string;
+    crashSupervisor: CrashSupervisor;
+    appLaunchOptions?: AppLaunchOptions;
 }) => Promise<void>;
 export declare const getHarness: (config: HarnessConfig, platform: HarnessPlatform, projectRoot: string) => Promise<Harness>;
 //# sourceMappingURL=harness.d.ts.map

package/dist/harness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EACb,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,eAAe,EAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,eAAe,EACf,qBAAqB,EACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAGL,QAAQ,EAET,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAsB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAItE,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;AAE/E,MAAM,MAAM,OAAO,GAAG;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,sBAAsB,KAC5B,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,eAAe,GAAU,SAAS;IAC7C,WAAW,EAAE,QAAQ,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;CACrB,KAAG,OAAO,CAAC,IAAI,CAgFf,CAAC;AA4GF,eAAO,MAAM,UAAU,GACrB,QAAQ,aAAa,EACrB,UAAU,eAAe,EACzB,aAAa,MAAM,KAClB,OAAO,CAAC,OAAO,CAkBjB,CAAC"}
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EACb,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,eAAe,EAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,gBAAgB,EACrB,eAAe,EACf,qBAAqB,EACtB,MAAM,iCAAiC,CAAC;AAOzC,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAI/B,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;AAE/E,MAAM,MAAM,OAAO,GAAG;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,sBAAsB,KAC5B,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9B,cAAc,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,eAAe,EAAE,eAAe,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,eAAe,GAAU,SAAS;IAC7C,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;IACjC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC,KAAG,OAAO,CAAC,IAAI,CA+Cf,CAAC;AAyIF,eAAO,MAAM,UAAU,GACrB,QAAQ,aAAa,EACrB,UAAU,eAAe,EACzB,aAAa,MAAM,KAClB,OAAO,CAAC,OAAO,CAkBjB,CAAC"}

package/dist/harness.js

@@ -1,70 +1,42 @@
 import { getBridgeServer, } from '@react-native-harness/bridge/server';
 import { getMetroInstance, prewarmMetroBundle, } from '@react-native-harness/bundler-metro';
-import { InitializationTimeoutError, MaxAppRestartsError } from './errors.js';
-import { createCrashMonitor } from './crash-monitor.js';
+import { createCrashArtifactWriter } from '@react-native-harness/tools';
+import { InitializationTimeoutError } from './errors.js';
+import { createCrashSupervisor, } from './crash-supervisor.js';
 import { createClientLogListener } from './client-log-handler.js';
 import { logMetroPrewarmCompleted } from './logs.js';
 export const waitForAppReady = async (options) => {
-    const { metroEvents, serverBridge, platformInstance, bundleStartTimeout, maxRestarts, signal, } = options;
-    let restartCount = 0;
-    let isBundling = false;
-    let bundleTimeoutId = null;
-    const clearBundleTimeout = () => {
-        if (bundleTimeoutId) {
-            clearTimeout(bundleTimeoutId);
-            bundleTimeoutId = null;
-        }
-    };
+    const { serverBridge, platformInstance, bridgeTimeout, testFilePath, crashSupervisor, appLaunchOptions, } = options;
+    const signal = AbortSignal.timeout(bridgeTimeout);
     return new Promise((resolve, reject) => {
-        // Handle abort signal
-        signal.addEventListener('abort', () => {
-            clearBundleTimeout();
-            reject(new DOMException('The operation was aborted', 'AbortError'));
-        });
-        // Start/restart the bundle timeout
-        const startBundleTimeout = () => {
-            clearBundleTimeout();
-            bundleTimeoutId = setTimeout(() => {
-                if (isBundling)
-                    return; // Don't restart while bundling
-                if (restartCount >= maxRestarts) {
-                    cleanup();
-                    reject(new MaxAppRestartsError(restartCount + 1));
-                    return;
-                }
-                restartCount++;
-                platformInstance.restartApp().catch(reject);
-                startBundleTimeout(); // Reset timer for next attempt
-            }, bundleStartTimeout);
+        const launchApp = async () => {
+            crashSupervisor.beginLaunch(testFilePath);
+            await platformInstance.restartApp(appLaunchOptions);
         };
-        // Metro event listener
-        const onMetroEvent = (event) => {
-            if (event.type === 'bundle_build_started') {
-                isBundling = true;
-                clearBundleTimeout(); // Cancel restart timer while bundling
-            }
-            else if (event.type === 'bundle_build_done' ||
-                event.type === 'bundle_build_failed') {
-                isBundling = false;
-                startBundleTimeout(); // Reset timer after bundle completes
-            }
-        };
-        // Bridge ready listener
         const onReady = () => {
+            crashSupervisor.markReady();
             cleanup();
             resolve();
         };
+        const onAbort = () => {
+            cleanup();
+            reject(new DOMException('The operation was aborted', 'AbortError'));
+        };
         const cleanup = () => {
-            clearBundleTimeout();
-            metroEvents.removeListener(onMetroEvent);
             serverBridge.off('ready', onReady);
+            signal.removeEventListener('abort', onAbort);
+            crashSupervisor.cancelCrashWaiters();
         };
-        // Setup listeners
-        metroEvents.addListener(onMetroEvent);
+        signal.addEventListener('abort', onAbort);
         serverBridge.once('ready', onReady);
-        // Start the app and timeout
-        platformInstance.restartApp().catch(reject);
-        startBundleTimeout();
+        void crashSupervisor.waitForCrash(testFilePath).catch((error) => {
+            cleanup();
+            reject(error);
+        });
+        void launchApp().catch((error) => {
+            cleanup();
+            reject(error);
+        });
     });
 };
 const getHarnessInternal = async (config, platform, projectRoot, signal) => {
@@ -80,8 +52,20 @@ const getHarnessInternal = async (config, platform, projectRoot, signal) => {
             context,
         }),
     ]);
-    // Forward client logs to console if enabled
+    const crashArtifactWriter = createCrashArtifactWriter({
+        runnerName: platform.name,
+        platformId: platform.platformId,
+    });
+    const appMonitor = platformInstance.createAppMonitor({
+        crashArtifactWriter,
+    });
+    const appLaunchOptions = platform.config.appLaunchOptions;
     const clientLogListener = createClientLogListener();
+    const crashSupervisor = createCrashSupervisor({
+        appMonitor,
+        platformRunner: platformInstance,
+    });
+    serverBridge.on('ready', crashSupervisor.markReady);
     if (config.forwardClientLogs) {
         metroInstance.events.addListener(clientLogListener);
     }
@@ -89,17 +73,14 @@ const getHarnessInternal = async (config, platform, projectRoot, signal) => {
         if (config.forwardClientLogs) {
             metroInstance.events.removeListener(clientLogListener);
         }
+        serverBridge.off('ready', crashSupervisor.markReady);
         await Promise.all([
+            crashSupervisor.dispose(),
             serverBridge.dispose(),
             platformInstance.dispose(),
             metroInstance.dispose(),
         ]);
     };
-    const crashMonitor = createCrashMonitor({
-        interval: config.crashDetectionInterval,
-        platformRunner: platformInstance,
-        bridgeServer: serverBridge,
-    });
     if (signal.aborted) {
         await dispose();
         throw new DOMException('The operation was aborted', 'AbortError');
@@ -114,27 +95,41 @@ const getHarnessInternal = async (config, platform, projectRoot, signal) => {
             signal,
         });
         logMetroPrewarmCompleted(platform);
-        await waitForAppReady({
-            metroEvents: metroInstance.events,
-            serverBridge,
-            platformInstance: platformInstance,
-            bundleStartTimeout: config.bundleStartTimeout,
-            maxRestarts: config.maxAppRestarts,
-            signal,
-        });
+        await appMonitor.start();
     }
     catch (error) {
         await dispose();
         throw error;
     }
-    const restart = () => new Promise((resolve, reject) => {
-        crashMonitor.markIntentionalRestart();
-        serverBridge.once('ready', () => {
-            crashMonitor.clearIntentionalRestart();
-            resolve();
+    const ensureAppReady = async (testFilePath) => {
+        crashSupervisor.setActiveTestFile(testFilePath);
+        if (crashSupervisor.isReady() && (await platformInstance.isAppRunning())) {
+            return;
+        }
+        crashSupervisor.reset();
+        await waitForAppReady({
+            serverBridge,
+            platformInstance: platformInstance,
+            bridgeTimeout: config.bridgeTimeout,
+            testFilePath,
+            crashSupervisor,
+            appLaunchOptions,
         });
-        platformInstance.restartApp().catch(reject);
-    });
+    };
+    const restart = async (testFilePath) => {
+        await crashSupervisor.stop();
+        if (testFilePath) {
+            await platformInstance.stopApp();
+        }
+        else {
+            await platformInstance.restartApp(appLaunchOptions);
+        }
+        crashSupervisor.reset();
+        await crashSupervisor.start();
+        if (testFilePath) {
+            await ensureAppReady(testFilePath);
+        }
+    };
     return {
         context,
         runTests: async (path, options) => {
@@ -147,9 +142,10 @@ const getHarnessInternal = async (config, platform, projectRoot, signal) => {
                 runner: platform.runner,
             });
         },
+        ensureAppReady,
         restart,
         dispose,
-        crashMonitor,
+        crashSupervisor,
     };
 };
 export const getHarness = async (config, platform, projectRoot) => {

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,cAAc,CAAC;AAe5C,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;CAkFjB"}
+{"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;AAe5C,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;CAgFjB"}

package/dist/index.js

@@ -51,11 +51,12 @@ export default class JestHarness {
             }
             if (harnessConfig.resetEnvironmentBetweenTestFiles &&
                 !isFirstTest) {
-                await harness.restart();
+                await harness.restart(test.path);
             }
             isFirstTest = false;
             return onStart(test).then(async () => {
                 if (!harnessConfig.detectNativeCrashes) {
+                    await harness.ensureAppReady(test.path);
                     return runHarnessTestFile({
                         testPath: test.path,
                         harness,
@@ -63,8 +64,9 @@ export default class JestHarness {
                         projectConfig: test.context.config,
                     });
                 }
-                // Start crash monitoring
-                const crashPromise = harness.crashMonitor.startMonitoring(test.path);
+                await harness.ensureAppReady(test.path);
+                harness.crashSupervisor.beginTestRun(test.path);
+                const crashPromise = harness.crashSupervisor.waitForCrash(test.path);
                 try {
                     const result = await Promise.race([
                         runHarnessTestFile({
@@ -78,19 +80,18 @@ export default class JestHarness {
                     return result;
                 }
                 finally {
-                    harness.crashMonitor.stopMonitoring();
+                    harness.crashSupervisor.cancelCrashWaiters();
                 }
             });
         })
             .then((result) => onResult(test, result))
             .catch(async (err) => {
             if (err instanceof NativeCrashError) {
+                harness.crashSupervisor.reset();
                 onFailure(test, {
                     message: err.message,
                     stack: '',
                 });
-                // Restart the app for the next test file
-                await harness.restart();
                 return;
             }
             if (err instanceof DeviceNotRespondingError) {

package/dist/setup.d.ts.map

@@ -1 +1 @@
-{"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,kBAiDhE,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,kBA4ChE,CAAC"}

package/dist/setup.js

@@ -26,10 +26,6 @@ export const setup = async (globalConfig) => {
     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 global.HARNESS.restart();
-        }
         return;
     }
     // Gracefully dispose the Harness when the process exits.