@react-native-harness/jest 1.2.0 → 1.4.0-rc.1

package/dist/crash-monitor.js

@@ -1,136 +1,143 @@
-import { NativeCrashError, } from './errors.js';
+import { NativeCrashError, RuntimeDisconnectError, } from './errors.js';
 import { logger } from '@react-native-harness/tools';
 const crashLogger = logger.child('crash');
+const CRASH_CLASSIFICATION_SETTLE_MS = 1500;
+const CRASH_LOG_WINDOW_MS = 3000;
 export class CrashWatchCancelledError extends Error {
     constructor() {
         super('Crash watch was cancelled');
         this.name = 'CrashWatchCancelledError';
     }
 }
-const mergeCrashDetails = (phase, initial, enriched, fallbackSummary) => ({
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const isCrashIndicator = (line) => /uncaught exception|terminating app due to|fatal error|EXC_[A-Z_]+|termination reason|crash|abort/i.test(line) || /\bSIG[A-Z]{2,}\b/.test(line);
+const getMatchingCrashLines = (logs, occurredAt) => logs
+    .filter((log) => Math.abs(log.occurredAt - occurredAt) <= CRASH_LOG_WINDOW_MS)
+    .map((log) => log.line)
+    .filter(isCrashIndicator);
+const buildNativeCrashDetails = (phase, rawLines, summary) => ({
     phase,
-    source: enriched?.source ?? initial?.source,
-    summary: enriched?.summary ?? initial?.summary ?? fallbackSummary,
-    signal: enriched?.signal ?? initial?.signal,
-    exceptionType: enriched?.exceptionType ?? initial?.exceptionType,
-    processName: enriched?.processName ?? initial?.processName,
-    pid: enriched?.pid ?? initial?.pid,
-    stackTrace: enriched?.stackTrace ?? initial?.stackTrace,
-    rawLines: enriched?.rawLines ?? initial?.rawLines,
-    artifactType: enriched?.artifactType ?? initial?.artifactType,
-    artifactPath: enriched?.artifactPath ?? initial?.artifactPath,
+    source: rawLines.length > 0 ? 'logs' : 'bridge',
+    summary: rawLines.length > 0 ? rawLines.join('\n') : summary,
+    rawLines: rawLines.length > 0 ? rawLines : undefined,
 });
-export const createCrashMonitor = ({ appMonitor, platformRunner, }) => {
+const getStatePid = (state) => {
+    if (state && 'pid' in state) {
+        return state.pid;
+    }
+    return undefined;
+};
+const mergeCrashDetails = (fallback, extracted) => {
+    if (!extracted) {
+        return fallback;
+    }
+    return {
+        ...fallback,
+        ...extracted,
+        phase: fallback.phase,
+        source: extracted.source ?? fallback.source,
+        summary: extracted.summary ?? fallback.summary,
+        rawLines: extracted.rawLines ?? fallback.rawLines,
+    };
+};
+const buildRuntimeDisconnectDetails = (phase, rawLines) => ({
+    phase,
+    source: 'bridge',
+    summary: 'The runtime bridge disconnected, but the app session still appears to be running.',
+    rawLines: rawLines.length > 0 ? rawLines : undefined,
+});
+export const createCrashMonitor = ({ appSession: initialAppSession = null, } = {}) => {
     let alive = false;
     let monitoring = true;
     let isResolvingCrash = false;
     let disposed = false;
-    // Both updated when watch() is called so crashes are attributed to the
-    // correct test file and lifecycle phase.
+    let appSession = null;
+    let pendingTimer = null;
     let currentTestFilePath = '';
     let currentPhase = 'startup';
     const watchers = new Set();
-    const getCrashDetailsProvider = () => {
-        if ('getCrashDetails' in appMonitor) {
-            return appMonitor;
-        }
-        if (platformRunner.getCrashDetails) {
-            return platformRunner;
-        }
-        return null;
-    };
-    const notifyCrash = (err) => {
+    const notifyFailure = (err) => {
         const pending = [...watchers];
         watchers.clear();
         for (const fn of pending)
             fn(err);
     };
-    const handleCrash = async (phase, details, fallbackSummary) => {
-        if (isResolvingCrash)
+    const clearPendingTimer = () => {
+        if (pendingTimer) {
+            clearTimeout(pendingTimer);
+            pendingTimer = null;
+        }
+    };
+    const classify = async (pending, trigger) => {
+        if (disposed || !monitoring || isResolvingCrash) {
             return;
-        isResolvingCrash = true;
-        alive = false;
-        crashLogger.debug('native crash detected (phase=%s)', phase);
-        for (const line of details?.rawLines ?? []) {
-            crashLogger.debug('%s', line);
         }
+        isResolvingCrash = true;
         try {
-            const enriched = await getCrashDetailsProvider()?.getCrashDetails?.({
-                processName: details?.processName,
-                pid: details?.pid,
-                occurredAt: Date.now(),
-            });
-            const merged = mergeCrashDetails(phase, details, enriched, fallbackSummary);
-            crashLogger.debug('crash details: %o', {
-                phase: merged.phase,
-                source: merged.source,
-                summary: merged.summary,
-                signal: merged.signal,
-                exceptionType: merged.exceptionType,
-                processName: merged.processName,
-                pid: merged.pid,
-            });
-            notifyCrash(new NativeCrashError(currentTestFilePath, merged));
+            const session = appSession;
+            const state = await session?.getState();
+            const logs = session?.getLogs() ?? [];
+            const rawLines = getMatchingCrashLines(logs, pending.occurredAt);
+            if (state?.status === 'running' && trigger === 'bridge-disconnect') {
+                crashLogger.debug('runtime bridge disconnected without confirmed app death');
+                notifyFailure(new RuntimeDisconnectError(pending.testFilePath, buildRuntimeDisconnectDetails(pending.phase, rawLines)));
+                return;
+            }
+            alive = false;
+            crashLogger.debug('native crash detected (phase=%s)', pending.phase);
+            for (const line of rawLines) {
+                crashLogger.debug('%s', line);
+            }
+            const fallbackSummary = trigger === 'bridge-disconnect'
+                ? 'The app process exited after the runtime bridge disconnected, but no crash log lines were found.'
+                : 'The app process exited, but no crash log lines were found.';
+            const details = buildNativeCrashDetails(pending.phase, rawLines, fallbackSummary);
+            const extractedDetails = session?.getCrashDetails
+                ? await session
+                    .getCrashDetails({
+                    occurredAt: pending.occurredAt,
+                    pid: getStatePid(state),
+                    processName: details.processName,
+                    testFilePath: pending.testFilePath,
+                })
+                    .catch((error) => {
+                    crashLogger.warn('failed to extract native crash details: %s', error);
+                    return null;
+                })
+                : null;
+            notifyFailure(new NativeCrashError(pending.testFilePath, mergeCrashDetails(details, extractedDetails)));
         }
         finally {
             isResolvingCrash = false;
+            pendingTimer = null;
         }
     };
-    const confirmAndHandleCrash = async (phase, details, fallbackSummary) => {
-        if (disposed || !monitoring)
+    const startCrashResolution = (trigger) => {
+        if (disposed || !monitoring || isResolvingCrash) {
             return;
-        try {
-            const isRunning = await platformRunner.isAppRunning();
-            if (!isRunning) {
-                void handleCrash(phase, details, fallbackSummary);
-            }
-        }
-        catch (error) {
-            crashLogger.debug('crash confirmation failed', error);
         }
+        clearPendingTimer();
+        const pending = {
+            testFilePath: currentTestFilePath,
+            phase: currentPhase,
+            occurredAt: Date.now(),
+        };
+        pendingTimer = setTimeout(() => {
+            void classify(pending, trigger);
+        }, trigger === 'bridge-disconnect' ? CRASH_CLASSIFICATION_SETTLE_MS : 0);
     };
-    const extractCrashDetails = (event) => event.crashDetails
-        ? {
-            source: event.crashDetails.source ?? event.source,
-            summary: event.crashDetails.summary,
-            signal: event.crashDetails.signal,
-            exceptionType: event.crashDetails.exceptionType,
-            processName: event.crashDetails.processName,
-            pid: event.crashDetails.pid ?? event.pid,
-            stackTrace: event.crashDetails.stackTrace,
-            rawLines: event.crashDetails.rawLines ??
-                (event.line ? [event.line] : undefined),
-        }
-        : undefined;
-    const appMonitorListener = (event) => {
-        if (disposed || !monitoring)
-            return;
-        if (event.type === 'app_started') {
-            alive = true;
-            return;
-        }
+    const appSessionListener = (event) => {
         if (event.type === 'app_exited') {
-            const details = extractCrashDetails(event);
-            if (event.isConfirmed ?? event.source === 'polling') {
-                void handleCrash(currentPhase, details);
-            }
-            else {
-                void confirmAndHandleCrash(currentPhase, details);
-            }
-            return;
-        }
-        if (event.type === 'possible_crash') {
-            const details = extractCrashDetails(event);
-            const fallback = `possible crash signal (${event.source ?? 'unknown'})`;
-            if (event.isConfirmed) {
-                void handleCrash(currentPhase, details, fallback);
-            }
-            else {
-                void confirmAndHandleCrash(currentPhase, details, fallback);
-            }
+            startCrashResolution('app-exit');
         }
     };
-    appMonitor.addListener(appMonitorListener);
+    const setAppSession = (session) => {
+        appSession?.removeListener(appSessionListener);
+        appSession = session;
+        alive = Boolean(session);
+        session?.addListener(appSessionListener);
+    };
+    setAppSession(initialAppSession);
     const watch = (testFilePath, phase) => {
         currentTestFilePath = testFilePath;
         currentPhase = phase;
@@ -152,25 +159,32 @@ export const createCrashMonitor = ({ appMonitor, platformRunner, }) => {
         isAlive: () => alive,
         stop: async () => {
             monitoring = false;
-            await appMonitor.stop();
+            clearPendingTimer();
+            await sleep(0);
         },
         start: async () => {
             monitoring = true;
-            await appMonitor.start();
         },
         reset: () => {
-            alive = false;
+            alive = Boolean(appSession);
             watchers.clear();
             isResolvingCrash = false;
             currentTestFilePath = '';
+            clearPendingTimer();
+        },
+        setAppSession,
+        handleBridgeDisconnect: () => {
+            startCrashResolution('bridge-disconnect');
         },
         dispose: async () => {
             disposed = true;
             monitoring = false;
             watchers.clear();
             isResolvingCrash = false;
-            appMonitor.removeListener(appMonitorListener);
-            await appMonitor.dispose();
+            clearPendingTimer();
+            appSession?.removeListener(appSessionListener);
+            appSession = null;
+            alive = false;
         },
     };
 };

package/dist/errors.d.ts

@@ -24,6 +24,9 @@ export type NativeCrashPhase = 'startup' | 'execution';
 export type NativeCrashDetails = AppCrashDetails & {
     phase: NativeCrashPhase;
 };
+export type RuntimeDisconnectDetails = AppCrashDetails & {
+    phase: NativeCrashPhase;
+};
 export declare class NativeCrashError extends HarnessError {
     readonly testFilePath: string;
     readonly details: NativeCrashDetails;
@@ -31,4 +34,11 @@ export declare class NativeCrashError extends HarnessError {
     constructor(testFilePath: string, details: NativeCrashDetails, lastKnownTest?: string | undefined);
     get phase(): NativeCrashPhase;
 }
+export declare class RuntimeDisconnectError extends HarnessError {
+    readonly testFilePath: string;
+    readonly details: RuntimeDisconnectDetails;
+    constructor(testFilePath: string, details: RuntimeDisconnectDetails);
+    get phase(): NativeCrashPhase;
+}
+export type HarnessRuntimeFailure = NativeCrashError | RuntimeDisconnectError;
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,qCAAqC,CAAC;AAE7C,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;AAED,qBAAa,yBAA0B,SAAQ,YAAY;aAC7B,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM;CAM5C;AAED,qBAAa,4BAA6B,SAAQ,YAAY;aAE1C,WAAW,EAAE,MAAM;aACnB,QAAQ,EAAE,MAAM;gBADhB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM;CAQnC;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,CAAC;AAEvD,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG;IACjD,KAAK,EAAE,gBAAgB,CAAC;CACzB,CAAC;AAmDF,qBAAa,gBAAiB,SAAQ,YAAY;aAE9B,YAAY,EAAE,MAAM;aACpB,OAAO,EAAE,kBAAkB;aAC3B,aAAa,CAAC,EAAE,MAAM;gBAFtB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,EAC3B,aAAa,CAAC,EAAE,MAAM,YAAA;IAOxC,IAAI,KAAK,qBAER;CACF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,qCAAqC,CAAC;AAE7C,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;AAED,qBAAa,yBAA0B,SAAQ,YAAY;aAC7B,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM;CAM5C;AAED,qBAAa,4BAA6B,SAAQ,YAAY;aAE1C,WAAW,EAAE,MAAM;aACnB,QAAQ,EAAE,MAAM;gBADhB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM;CAQnC;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,CAAC;AAEvD,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG;IACjD,KAAK,EAAE,gBAAgB,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,eAAe,GAAG;IACvD,KAAK,EAAE,gBAAgB,CAAC;CACzB,CAAC;AAmEF,qBAAa,gBAAiB,SAAQ,YAAY;aAE9B,YAAY,EAAE,MAAM;aACpB,OAAO,EAAE,kBAAkB;aAC3B,aAAa,CAAC,EAAE,MAAM;gBAFtB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,EAC3B,aAAa,CAAC,EAAE,MAAM,YAAA;IAOxC,IAAI,KAAK,qBAER;CACF;AA0BD,qBAAa,sBAAuB,SAAQ,YAAY;aAEpC,YAAY,EAAE,MAAM;aACpB,OAAO,EAAE,wBAAwB;gBADjC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,wBAAwB;IAOnD,IAAI,KAAK,qBAER;CACF;AAED,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,sBAAsB,CAAC"}

package/dist/errors.js

@@ -1,4 +1,4 @@
-import { HarnessError } from '@react-native-harness/tools';
+import { formatPath, HarnessError } from '@react-native-harness/tools';
 export { StartupStallError, } from '@react-native-harness/bundler-metro';
 export class NoRunnerSpecifiedError extends HarnessError {
     constructor() {
@@ -39,12 +39,21 @@ export class MetroPortRangeExhaustedError extends HarnessError {
         this.name = 'MetroPortRangeExhaustedError';
     }
 }
-const buildNativeCrashMessage = ({ phase, summary, signal, exceptionType, processName, pid, stackTrace, artifactType, }) => {
+const buildNativeCrashMessage = ({ phase, summary, signal, exceptionType, processName, pid, stackTrace, artifactType, artifactPath, enrichmentArtifacts, }) => {
     const lines = [
         phase === 'startup'
             ? 'The native app crashed while preparing to run this test file.'
             : 'The native app crashed during test execution.',
     ];
+    lines.push(artifactPath
+        ? `Harness extracted the crash log: ${formatPath(artifactPath)}`
+        : "Harness couldn't extract the crash log.");
+    if (enrichmentArtifacts && enrichmentArtifacts.length > 0) {
+        lines.push('Additional crash artifacts:');
+        for (const artifact of enrichmentArtifacts) {
+            lines.push(`  - ${formatPath(artifact.artifactPath)}`);
+        }
+    }
     const hasCrashBlock = summary?.includes('\n') ?? false;
     const shouldRenderSummary = Boolean(summary) &&
         !(!hasCrashBlock && artifactType === 'ios-crash-report');
@@ -89,3 +98,33 @@ export class NativeCrashError extends HarnessError {
         return this.details.phase;
     }
 }
+const buildRuntimeDisconnectMessage = ({ phase, summary, rawLines, }) => {
+    const lines = [
+        phase === 'startup'
+            ? 'The native runtime disconnected while preparing to run this test file.'
+            : 'The native runtime disconnected during test execution.',
+    ];
+    if (summary) {
+        lines.push('');
+        lines.push(summary);
+    }
+    if (rawLines && rawLines.length > 0 && summary !== rawLines.join('\n')) {
+        lines.push('');
+        lines.push(...rawLines);
+    }
+    return lines.join('\n');
+};
+export class RuntimeDisconnectError extends HarnessError {
+    testFilePath;
+    details;
+    constructor(testFilePath, details) {
+        super(buildRuntimeDisconnectMessage(details));
+        this.testFilePath = testFilePath;
+        this.details = details;
+        this.name = 'RuntimeDisconnectError';
+        this.stack = `${this.name}: ${this.message.split('\n')[0]}`;
+    }
+    get phase() {
+        return this.details.phase;
+    }
+}

package/dist/execute-run.d.ts

@@ -1,4 +1,6 @@
-import type { OnTestFailure, OnTestStart, OnTestSuccess, Test, TestWatcher, Config } from 'jest-runner';
+import type { Test, TestWatcher, Config, TestEvents } from 'jest-runner';
 import { type HarnessSession } from './harness-session.js';
-export declare const executeRun: (session: HarnessSession, tests: Array<Test>, watcher: TestWatcher, onStart: OnTestStart, onResult: OnTestSuccess, onFailure: OnTestFailure, globalConfig: Config.GlobalConfig) => Promise<void>;
+type EmitTestEvent = <Name extends keyof TestEvents>(eventName: Name, ...eventData: TestEvents[Name]) => Promise<void>;
+export declare const executeRun: (session: HarnessSession, tests: Array<Test>, watcher: TestWatcher, emitEvent: EmitTestEvent, globalConfig: Config.GlobalConfig) => Promise<void>;
+export {};
 //# sourceMappingURL=execute-run.d.ts.map

package/dist/execute-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute-run.d.ts","sourceRoot":"","sources":["../src/execute-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,aAAa,EACb,IAAI,EACJ,WAAW,EACX,MAAM,EACP,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,KAAK,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AAsCjF,eAAO,MAAM,UAAU,GACrB,SAAS,cAAc,EACvB,OAAO,KAAK,CAAC,IAAI,CAAC,EAClB,SAAS,WAAW,EACpB,SAAS,WAAW,EACpB,UAAU,aAAa,EACvB,WAAW,aAAa,EACxB,cAAc,MAAM,CAAC,YAAY,KAChC,OAAO,CAAC,IAAI,CA8Id,CAAC"}
+{"version":3,"file":"execute-run.d.ts","sourceRoot":"","sources":["../src/execute-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EACX,MAAM,EACN,UAAU,EACX,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,KAAK,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AAsBjF,KAAK,aAAa,GAAG,CAAC,IAAI,SAAS,MAAM,UAAU,EACjD,SAAS,EAAE,IAAI,EACf,GAAG,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;AAmFnB,eAAO,MAAM,UAAU,GACrB,SAAS,cAAc,EACvB,OAAO,KAAK,CAAC,IAAI,CAAC,EAClB,SAAS,WAAW,EACpB,WAAW,aAAa,EACxB,cAAc,MAAM,CAAC,YAAY,KAChC,OAAO,CAAC,IAAI,CA8Ld,CAAC"}

package/dist/execute-run.js

@@ -1,8 +1,9 @@
 import { randomUUID } from 'node:crypto';
 import path from 'node:path';
 import { runHarnessTestFile } from './run.js';
-import { NativeCrashError, StartupStallError, } from './errors.js';
-import { DeviceNotRespondingError } from '@react-native-harness/bridge/server';
+import { NativeCrashError, RuntimeDisconnectError, StartupStallError, } from './errors.js';
+import { AppBridgeDisconnectedError, DeviceNotRespondingError, } from '@react-native-harness/bridge/server';
+import { createPlatformSkippedTestResult, shouldRunHarnessTestFile, } from './test-file-platform-filter.js';
 const createRunSummary = () => ({ passed: 0, failed: 0, skipped: 0, todo: 0 });
 const applyJestResultToSummary = (summary, result) => {
     summary.passed += result.numPassingTests;
@@ -18,19 +19,62 @@ class CancelRun extends Error {
 }
 const buildTestFailure = (err) => {
     if (err instanceof NativeCrashError ||
+        err instanceof RuntimeDisconnectError ||
         err instanceof StartupStallError ||
+        err instanceof AppBridgeDisconnectedError ||
         err instanceof DeviceNotRespondingError) {
         return { message: err.message, stack: '' };
     }
     return err;
 };
-export const executeRun = async (session, tests, watcher, onStart, onResult, onFailure, globalConfig) => {
+const toJestMode = (declarationMode) => declarationMode;
+const emitHarnessTestStarted = async (emitEvent, event) => {
+    await emitEvent('test-case-start', event.file, {
+        ancestorTitles: event.ancestorTitles,
+        fullName: event.fullName,
+        mode: toJestMode(event.declarationMode),
+        title: event.name,
+        startedAt: event.startedAt,
+    });
+};
+const emitHarnessTestFinished = async (emitEvent, event) => {
+    const failureMessage = event.error?.message;
+    const codeFrame = event.error?.codeFrame;
+    const location = codeFrame?.location
+        ? { column: codeFrame.location.column, line: codeFrame.location.row }
+        : null;
+    const testCaseResult = {
+        ancestorTitles: event.ancestorTitles,
+        duration: event.duration,
+        failureDetails: [],
+        failureMessages: failureMessage
+            ? [`${failureMessage}${codeFrame ? `\n\n${codeFrame.content}` : ''}`]
+            : [],
+        fullName: event.fullName,
+        location,
+        numPassingAsserts: event.status === 'passed' ? 1 : 0,
+        startedAt: event.startedAt,
+        status: event.status,
+        title: event.name,
+    };
+    await emitEvent('test-case-result', event.file, testCaseResult);
+};
+const isHarnessCaseEvent = (event) => event.type === 'test-started' || event.type === 'test-finished';
+export const executeRun = async (session, tests, watcher, emitEvent, globalConfig) => {
     const runId = randomUUID();
     const startTime = Date.now();
     const watchMode = globalConfig.watch || globalConfig.watchAll;
     const rootDir = globalConfig.rootDir ?? process.cwd();
     const testFiles = tests.map((t) => path.relative(rootDir, t.path));
     const summary = createRunSummary();
+    let caseEventChain = Promise.resolve();
+    const unsubscribe = session.onTestRunnerEvent((event) => {
+        if (isHarnessCaseEvent(event)) {
+            caseEventChain = caseEventChain.then(() => event.type === 'test-started'
+                ? emitHarnessTestStarted(emitEvent, event)
+                : emitHarnessTestFinished(emitEvent, event));
+        }
+    });
     const updateRunState = (overrides = {}) => {
         const state = {
             runId,
@@ -59,6 +103,8 @@ export const executeRun = async (session, tests, watcher, onStart, onResult, onF
         host: session.config.host?.trim() || undefined,
     });
     const shouldResetEnv = session.config.resetEnvironmentBetweenTestFiles;
+    const platformId = session.context.platform.platformId;
+    const knownPlatformIds = new Set(session.config.runners.map((runner) => runner.platformId));
     let isFirstTest = true;
     let runError;
     try {
@@ -79,13 +125,39 @@ export const executeRun = async (session, tests, watcher, onStart, onResult, onF
                 });
             };
             await session.callHook('test-file:started', { runId, file: relativeTestPath });
+            if (!shouldRunHarnessTestFile(test.path, platformId, knownPlatformIds)) {
+                try {
+                    await emitEvent('test-file-start', test);
+                    const skippedResult = createPlatformSkippedTestResult(test.path);
+                    applyJestResultToSummary(summary, skippedResult);
+                    updateRunState();
+                    await emitTestFileFinished({
+                        status: 'skipped',
+                        duration: Date.now() - fileStartedAt,
+                        result: null,
+                    });
+                    await emitEvent('test-file-success', test, skippedResult);
+                }
+                catch (err) {
+                    if (!emittedTestFileFinished) {
+                        await emitTestFileFinished({
+                            status: 'failed',
+                            duration: Date.now() - fileStartedAt,
+                            result: null,
+                        });
+                    }
+                    updateRunState({ error: err });
+                    await emitEvent('test-file-failure', test, buildTestFailure(err));
+                }
+                continue;
+            }
             try {
                 if (shouldResetEnv && !isFirstTest) {
                     await session.restartApp(test.path);
                 }
                 isFirstTest = false;
                 session.flushClientLogs();
-                await onStart(test);
+                await emitEvent('test-file-start', test);
                 await session.ensureAppReady(test.path);
                 // Crash detection is handled inside session.runTestFile; NativeCrashError
                 // propagates here if a crash wins the race.
@@ -106,7 +178,8 @@ export const executeRun = async (session, tests, watcher, onStart, onResult, onF
                     duration: result.duration,
                     result: result.harnessResult,
                 });
-                await onResult(test, result.jestResult);
+                await caseEventChain;
+                await emitEvent('test-file-success', test, result.jestResult);
             }
             catch (err) {
                 if (!emittedTestFileFinished) {
@@ -117,17 +190,20 @@ export const executeRun = async (session, tests, watcher, onStart, onResult, onF
                     });
                 }
                 const isRuntimeFailure = err instanceof NativeCrashError ||
+                    err instanceof RuntimeDisconnectError ||
                     err instanceof StartupStallError ||
+                    err instanceof AppBridgeDisconnectedError ||
                     err instanceof DeviceNotRespondingError;
                 if (isRuntimeFailure) {
                     summary.failed += 1;
                     updateRunState();
                 }
-                if (err instanceof NativeCrashError) {
+                if (err instanceof NativeCrashError || err instanceof RuntimeDisconnectError) {
                     session.resetCrashState();
                 }
                 updateRunState({ error: isRuntimeFailure ? undefined : err });
-                onFailure(test, buildTestFailure(err));
+                await caseEventChain;
+                await emitEvent('test-file-failure', test, buildTestFailure(err));
             }
         }
     }
@@ -147,5 +223,7 @@ export const executeRun = async (session, tests, watcher, onStart, onResult, onF
             status: runState.status ?? (runError != null ? 'failed' : 'passed'),
             ...(runError != null ? { error: runError } : {}),
         });
+        await caseEventChain;
+        unsubscribe();
     }
 };

package/dist/harness-session.d.ts

@@ -1,10 +1,22 @@
-import { type HarnessContext, type TestExecutionOptions, type TestSuiteResult } from '@react-native-harness/bridge';
+import { type AppConnection } from '@react-native-harness/bridge/server';
+import { type HarnessContext, type TestRunnerEvents, type TestExecutionOptions, type TestSuiteResult } from '@react-native-harness/bridge';
 import { type HarnessPlatform } from '@react-native-harness/platforms';
 import { type HarnessPluginManager, type HarnessRunStatus, type HarnessRunSummary } from '@react-native-harness/plugins';
 import { type Config as HarnessConfig } from '@react-native-harness/config';
 import type { Config as JestConfig } from 'jest-runner';
+import { type CrashMonitor } from './crash-monitor.js';
 import { type ClientLogBuffer } from './client-log-handler.js';
 import { type ResourceLockManager } from './resource-lock.js';
+type DisconnectObservableBridge = {
+    readonly connection: AppConnection | null;
+    on: (event: 'disconnected', listener: () => void) => void;
+    off: (event: 'disconnected', listener: () => void) => void;
+};
+export declare const waitForBridgeDisconnectOrTimeout: ({ bridge, connection, timeoutMs, }: {
+    bridge: DisconnectObservableBridge;
+    connection: AppConnection;
+    timeoutMs: number;
+}) => Promise<boolean>;
 export type HarnessRunState = {
     readonly runId: string;
     readonly startTime: number;
@@ -19,6 +31,7 @@ export type HarnessRunTestsOptions = Exclude<TestExecutionOptions, 'platform'>;
 export type HarnessSession = {
     readonly config: HarnessConfig;
     readonly context: HarnessContext;
+    onTestRunnerEvent: (listener: (event: TestRunnerEvents) => void) => () => void;
     runTestFile: (path: string, options: HarnessRunTestsOptions) => Promise<TestSuiteResult>;
     ensureAppReady: (testFilePath: string) => Promise<void>;
     restartApp: (testFilePath?: string) => Promise<void>;
@@ -28,7 +41,14 @@ export type HarnessSession = {
     setRunState: (state: HarnessRunState | null) => void;
     dispose: (reason?: 'normal' | 'abort' | 'error') => Promise<void>;
 };
+export declare const waitForStartupCrash: ({ crashMonitor, detectNativeCrashes, testFilePath, signal, }: {
+    crashMonitor: CrashMonitor;
+    detectNativeCrashes: boolean;
+    testFilePath: string;
+    signal: AbortSignal;
+}) => Promise<never>;
 export declare const createHarnessSession: (globalConfig: JestConfig.GlobalConfig, { lockManager }?: {
     lockManager?: ResourceLockManager;
 }) => Promise<HarnessSession>;
+export {};
 //# sourceMappingURL=harness-session.d.ts.map

package/dist/harness-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"harness-session.d.ts","sourceRoot":"","sources":["../src/harness-session.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,eAAe,EAGrB,MAAM,iCAAiC,CAAC;AASzC,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAOvC,OAAO,EAEL,KAAK,MAAM,IAAI,aAAa,EAE7B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAMxD,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,oBAAoB,CAAC;AAkB5B,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;AAE/E,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACzF,cAAc,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,UAAU,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,eAAe,CAAC;IACvC,QAAQ,EAAE,oBAAoB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,UAAU,CAAC,CAAC;IAC3E,WAAW,EAAE,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE,CAAC;AAuOF,eAAO,MAAM,oBAAoB,GAC/B,cAAc,UAAU,CAAC,YAAY,EACrC,kBAA8C;IAAE,WAAW,CAAC,EAAE,mBAAmB,CAAA;CAAO,KACvF,OAAO,CAAC,cAAc,CA6YxB,CAAC"}
+{"version":3,"file":"harness-session.d.ts","sourceRoot":"","sources":["../src/harness-session.ts"],"names":[],"mappings":"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"}