@react-native-harness/jest 1.5.0 → 1.6.0

package/dist/crash-supervisor.d.ts

@@ -0,0 +1,21 @@
+import { type AppMonitor, type HarnessPlatformRunner } from '@react-native-harness/platforms';
+export type CrashSupervisorState = 'idle' | 'launching' | 'ready' | 'running' | 'disposing';
+export type CrashSupervisor = {
+    setActiveTestFile: (testFilePath: string | null) => void;
+    beginLaunch: (testFilePath: string) => void;
+    markReady: () => void;
+    beginTestRun: (testFilePath: string) => void;
+    stop: () => Promise<void>;
+    start: () => Promise<void>;
+    waitForCrash: (testFilePath: string) => Promise<never>;
+    isReady: () => boolean;
+    cancelCrashWaiters: () => void;
+    reset: () => void;
+    dispose: () => Promise<void>;
+};
+export type CrashSupervisorOptions = {
+    appMonitor: AppMonitor;
+    platformRunner: HarnessPlatformRunner;
+};
+export declare const createCrashSupervisor: ({ appMonitor, platformRunner, }: CrashSupervisorOptions) => CrashSupervisor;
+//# sourceMappingURL=crash-supervisor.d.ts.map

package/dist/crash-supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crash-supervisor.d.ts","sourceRoot":"","sources":["../src/crash-supervisor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EAIf,KAAK,qBAAqB,EAC3B,MAAM,iCAAiC,CAAC;AAUzC,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,WAAW,GACX,OAAO,GACP,SAAS,GACT,WAAW,CAAC;AAEhB,MAAM,MAAM,eAAe,GAAG;IAC5B,iBAAiB,EAAE,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACzD,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IACvD,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,qBAAqB,CAAC;CACvC,CAAC;AAmCF,eAAO,MAAM,qBAAqB,GAAI,iCAGnC,sBAAsB,KAAG,eAkP3B,CAAC"}

package/dist/crash-supervisor.js

@@ -0,0 +1,210 @@
+import { NativeCrashError, } from './errors.js';
+import { logger } from '@react-native-harness/tools';
+const crashLogger = logger.child('crash');
+const getCrashPhase = (state) => state === 'running' ? 'execution' : 'startup';
+const mergeCrashDetails = (phase, initialDetails, enrichedDetails, fallbackSummary) => ({
+    phase,
+    source: enrichedDetails?.source ?? initialDetails?.source,
+    summary: enrichedDetails?.summary ?? initialDetails?.summary ?? fallbackSummary,
+    signal: enrichedDetails?.signal ?? initialDetails?.signal,
+    exceptionType: enrichedDetails?.exceptionType ?? initialDetails?.exceptionType,
+    processName: enrichedDetails?.processName ?? initialDetails?.processName,
+    pid: enrichedDetails?.pid ?? initialDetails?.pid,
+    stackTrace: enrichedDetails?.stackTrace ?? initialDetails?.stackTrace,
+    rawLines: enrichedDetails?.rawLines ?? initialDetails?.rawLines,
+    artifactType: enrichedDetails?.artifactType ?? initialDetails?.artifactType,
+    artifactPath: enrichedDetails?.artifactPath ?? initialDetails?.artifactPath,
+});
+export const createCrashSupervisor = ({ appMonitor, platformRunner, }) => {
+    let state = 'idle';
+    let activeTestFilePath = null;
+    let crashRejectors = new Set();
+    let disposed = false;
+    let monitoring = true;
+    let isResolvingCrash = false;
+    const getCrashDetailsProvider = () => {
+        if ('getCrashDetails' in appMonitor) {
+            return appMonitor;
+        }
+        if (platformRunner.getCrashDetails) {
+            return platformRunner;
+        }
+        return null;
+    };
+    const rejectCrashWaiters = (testFilePath, details) => {
+        const error = new NativeCrashError(testFilePath, details);
+        for (const reject of crashRejectors) {
+            reject(error);
+        }
+        crashRejectors = new Set();
+    };
+    const handleCrash = async (reason, details) => {
+        if (isResolvingCrash ||
+            (state !== 'launching' && state !== 'running' && state !== 'ready')) {
+            return;
+        }
+        if (!activeTestFilePath) {
+            crashLogger.debug('ignoring crash signal without active test: %s', reason);
+            return;
+        }
+        isResolvingCrash = true;
+        crashLogger.debug('native crash detected during %s (state=%s reason=%s)', activeTestFilePath, state, reason || '(none)');
+        for (const line of details?.rawLines ?? []) {
+            crashLogger.debug('%s', line);
+        }
+        const phase = getCrashPhase(state);
+        const testFilePath = activeTestFilePath;
+        state = 'idle';
+        try {
+            const enrichedDetails = await getCrashDetailsProvider()?.getCrashDetails?.({
+                processName: details?.processName,
+                pid: details?.pid,
+                occurredAt: Date.now(),
+            });
+            const mergedDetails = mergeCrashDetails(phase, details, enrichedDetails, reason);
+            crashLogger.debug('crash details: %o', {
+                phase: mergedDetails.phase,
+                source: mergedDetails.source,
+                summary: mergedDetails.summary,
+                signal: mergedDetails.signal,
+                exceptionType: mergedDetails.exceptionType,
+                processName: mergedDetails.processName,
+                pid: mergedDetails.pid,
+            });
+            rejectCrashWaiters(testFilePath, mergedDetails);
+        }
+        finally {
+            isResolvingCrash = false;
+        }
+    };
+    const confirmCrash = async (reason, details) => {
+        if (disposed || !monitoring || state === 'disposing') {
+            return;
+        }
+        try {
+            const isRunning = await platformRunner.isAppRunning();
+            if (!isRunning) {
+                void handleCrash(reason, details);
+            }
+        }
+        catch (error) {
+            crashLogger.debug('crash confirmation failed', error);
+        }
+    };
+    const appMonitorListener = (event) => {
+        if (disposed || !monitoring) {
+            return;
+        }
+        if (event.type === 'app_started') {
+            return;
+        }
+        if (event.type === 'app_exited') {
+            const details = {
+                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),
+            };
+            if (event.isConfirmed ?? event.source === 'polling') {
+                void handleCrash('', details);
+            }
+            else {
+                void confirmCrash('', details);
+            }
+            return;
+        }
+        if (event.type === 'possible_crash') {
+            const details = {
+                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),
+            };
+            if (event.isConfirmed) {
+                void handleCrash(`possible crash signal (${event.source ?? 'unknown'})`, details);
+            }
+            else {
+                void confirmCrash(`possible crash signal (${event.source ?? 'unknown'})`, details);
+            }
+        }
+    };
+    appMonitor.addListener(appMonitorListener);
+    const setActiveTestFile = (testFilePath) => {
+        activeTestFilePath = testFilePath;
+    };
+    const beginLaunch = (testFilePath) => {
+        activeTestFilePath = testFilePath;
+        state = 'launching';
+    };
+    const markReady = () => {
+        if (state !== 'disposing') {
+            state = 'ready';
+        }
+    };
+    const beginTestRun = (testFilePath) => {
+        activeTestFilePath = testFilePath;
+        state = 'running';
+    };
+    const stop = async () => {
+        monitoring = false;
+        await appMonitor.stop();
+    };
+    const start = async () => {
+        monitoring = true;
+        await appMonitor.start();
+    };
+    const waitForCrash = (testFilePath) => new Promise((_, reject) => {
+        if (disposed) {
+            reject(new NativeCrashError(testFilePath, {
+                phase: 'startup',
+                source: 'polling',
+                summary: 'Crash supervisor disposed while waiting for app startup.',
+            }));
+            return;
+        }
+        crashRejectors.add(reject);
+    });
+    const isReady = () => state === 'ready' || state === 'running';
+    const cancelCrashWaiters = () => {
+        crashRejectors = new Set();
+    };
+    const reset = () => {
+        cancelCrashWaiters();
+        isResolvingCrash = false;
+        if (state !== 'disposing') {
+            state = 'idle';
+        }
+    };
+    const dispose = async () => {
+        disposed = true;
+        monitoring = false;
+        state = 'disposing';
+        crashRejectors = new Set();
+        isResolvingCrash = false;
+        appMonitor.removeListener(appMonitorListener);
+        await appMonitor.dispose();
+    };
+    return {
+        setActiveTestFile,
+        beginLaunch,
+        markReady,
+        beginTestRun,
+        stop,
+        start,
+        waitForCrash,
+        isReady,
+        cancelCrashWaiters,
+        reset,
+        dispose,
+    };
+};

package/dist/event-mapper.d.ts

@@ -0,0 +1,16 @@
+import type { TestEvents } from '@jest/test-result';
+import type { Test } from 'jest-runner';
+import type { BridgeEvents } from '@react-native-harness/bridge';
+import type { TestCaseResult } from '@jest/test-result';
+export type EventMapperState = {
+    currentTest?: Test;
+    suiteHierarchy: string[];
+    testResults: Map<string, TestCaseResult>;
+    fileStartTime: number;
+};
+export type HarnessEventMapper = {
+    handleBridgeEvent: (event: BridgeEvents, test: Test) => void;
+    reset: () => void;
+};
+export declare const getHarnessEventMapper: (emit: <T extends keyof TestEvents>(eventName: T, eventData: TestEvents[T]) => void) => HarnessEventMapper;
+//# sourceMappingURL=event-mapper.d.ts.map

package/dist/event-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-mapper.d.ts","sourceRoot":"","sources":["../src/event-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EASV,YAAY,EACb,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,iBAAiB,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAC7D,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,MAAM,CAAC,CAAC,SAAS,MAAM,UAAU,EAC/B,SAAS,EAAE,CAAC,EACZ,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,KACrB,IAAI,KACR,kBA8JF,CAAC"}

package/dist/event-mapper.js

@@ -0,0 +1,120 @@
+export const getHarnessEventMapper = (emit) => {
+    const state = {
+        suiteHierarchy: [],
+        testResults: new Map(),
+        fileStartTime: 0,
+    };
+    const handleBridgeEvent = (event, test) => {
+        // Filter to only process test runner events
+        if (event.type.startsWith('test-') ||
+            event.type.startsWith('suite-') ||
+            event.type.startsWith('file-')) {
+            switch (event.type) {
+                case 'file-started':
+                    handleFileStarted(event, test);
+                    break;
+                case 'file-finished':
+                    handleFileFinished(event, test);
+                    break;
+                case 'suite-started':
+                    handleSuiteStarted(event);
+                    break;
+                case 'suite-finished':
+                    handleSuiteFinished(event);
+                    break;
+                case 'test-started':
+                    handleTestStarted(event, test);
+                    break;
+                case 'test-finished':
+                    handleTestFinished(event, test);
+                    break;
+            }
+        }
+    };
+    const handleFileStarted = (event, test) => {
+        state.currentTest = test;
+        state.fileStartTime = Date.now();
+        state.suiteHierarchy = [];
+        state.testResults.clear();
+        // Don't emit test-file-start here - that should be handled by the Jest runner
+        // when it actually starts running the test file
+    };
+    const handleFileFinished = (_event, _test) => {
+        // File finished - all test results should already be emitted
+        // The final TestResult will be handled by the runHarnessTestFile function
+    };
+    const handleSuiteStarted = (event) => {
+        state.suiteHierarchy.push(event.name);
+    };
+    const handleSuiteFinished = (event) => {
+        // Remove the suite from hierarchy when it finishes
+        const index = state.suiteHierarchy.lastIndexOf(event.name);
+        if (index !== -1) {
+            state.suiteHierarchy.splice(index, 1);
+        }
+    };
+    const handleTestStarted = (event, test) => {
+        const testCaseStartInfo = {
+            ancestorTitles: [...state.suiteHierarchy],
+            fullName: `${state.suiteHierarchy.join(' ')} ${event.name}`.trim(),
+            title: event.name,
+            mode: 'skip', // Default mode, will be updated based on test status
+        };
+        emit('test-case-start', [test.path, testCaseStartInfo]);
+    };
+    const handleTestFinished = (event, test) => {
+        const testCaseResult = {
+            ancestorTitles: [...state.suiteHierarchy],
+            duration: event.duration,
+            failureDetails: [],
+            failureMessages: event.error ? [formatError(event.error)] : [],
+            fullName: `${state.suiteHierarchy.join(' ')} ${event.name}`.trim(),
+            numPassingAsserts: event.status === 'passed' ? 1 : 0,
+            status: mapStatus(event.status),
+            title: event.name,
+            startedAt: Date.now() - event.duration,
+        };
+        state.testResults.set(event.name, testCaseResult);
+        emit('test-case-result', [test.path, testCaseResult]);
+    };
+    const mapStatus = (status) => {
+        return status;
+    };
+    const formatError = (error) => {
+        let errorMessage = `${error.name}: ${error.message}`;
+        if (error.codeFrame) {
+            errorMessage += '\n\n' + formatCodeFrame(error.codeFrame);
+        }
+        return errorMessage;
+    };
+    const formatCodeFrame = (codeFrame) => {
+        const lines = codeFrame.content.split('\n');
+        const lineNumber = codeFrame.location?.row || 1;
+        const column = codeFrame.location?.column || 1;
+        let formatted = `\n${codeFrame.fileName}:${lineNumber}:${column}\n`;
+        // Add context lines around the error
+        const startLine = Math.max(0, lineNumber - 3);
+        const endLine = Math.min(lines.length, lineNumber + 2);
+        for (let i = startLine; i < endLine; i++) {
+            const lineNum = i + 1;
+            const line = lines[i];
+            const isErrorLine = lineNum === lineNumber;
+            formatted += `${lineNum.toString().padStart(3)} | ${line}\n`;
+            if (isErrorLine && column > 0) {
+                const pointer = ' '.repeat(column + 5) + '^';
+                formatted += pointer + '\n';
+            }
+        }
+        return formatted;
+    };
+    const reset = () => {
+        state.suiteHierarchy = [];
+        state.testResults.clear();
+        state.fileStartTime = 0;
+        state.currentTest = undefined;
+    };
+    return {
+        handleBridgeEvent,
+        reset,
+    };
+};

package/dist/global-setup.d.ts

@@ -0,0 +1,3 @@
+import type { Config as JestConfig } from 'jest-runner';
+export default function (globalConfig: JestConfig.GlobalConfig): Promise<void>;
+//# sourceMappingURL=global-setup.d.ts.map

package/dist/global-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-setup.d.ts","sourceRoot":"","sources":["../src/global-setup.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AA4CxD,yBAA+B,YAAY,EAAE,UAAU,CAAC,YAAY,iBA4CnE"}

package/dist/global-setup.js

@@ -0,0 +1,60 @@
+import { getConfig, } from '@react-native-harness/config';
+import { getHarness as getHarnessExternal, NoRunnerSpecifiedError, RunnerNotFoundError, } from '@react-native-harness/cli/external';
+import { preRunMessage } from 'jest-util';
+import { getAdditionalCliArgs } from './cli-args.js';
+import { logTestEnvironmentReady, logTestRunHeader } from './logs.js';
+const getHarnessConfig = async (globalConfig) => {
+    const projectRoot = globalConfig.rootDir;
+    const { config: harnessConfig } = await getConfig(projectRoot);
+    return harnessConfig;
+};
+const getHarnessRunner = (config, cliArgs) => {
+    const selectedRunnerName = cliArgs.harnessRunner ?? config.defaultRunner;
+    if (!selectedRunnerName) {
+        throw new NoRunnerSpecifiedError(config.runners);
+    }
+    const runner = config.runners.find((runner) => runner.name === selectedRunnerName);
+    if (!runner) {
+        throw new RunnerNotFoundError(selectedRunnerName, config.runners);
+    }
+    return runner;
+};
+const getHarness = async (runner) => {
+    return await getHarnessExternal(runner);
+};
+export default async function (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();
+            });
+        }
+        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();
+        });
+    }
+    const cliArgs = getAdditionalCliArgs();
+    const selectedRunner = getHarnessRunner(harnessConfig, cliArgs);
+    if (globalConfig.collectCoverage) {
+        // This is going to be used by @react-native-harness/babel-preset
+        // to enable instrumentation of test files.
+        process.env.RN_HARNESS_COLLECT_COVERAGE = 'true';
+    }
+    logTestRunHeader(selectedRunner);
+    const harness = await getHarness(selectedRunner);
+    logTestEnvironmentReady(selectedRunner);
+    global.HARNESS_CONFIG = harnessConfig;
+    global.HARNESS = harness;
+}

package/dist/global-teardown.d.ts

@@ -0,0 +1,3 @@
+import type { Config as JestConfig } from 'jest-runner';
+export default function (globalConfig: JestConfig.GlobalConfig): Promise<void>;
+//# sourceMappingURL=global-teardown.d.ts.map

package/dist/global-teardown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-teardown.d.ts","sourceRoot":"","sources":["../src/global-teardown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAExD,yBAA+B,YAAY,EAAE,UAAU,CAAC,YAAY,iBAYnE"}

package/dist/global-teardown.js

@@ -0,0 +1,11 @@
+export default async function (globalConfig) {
+    const isWatchMode = globalConfig.watch || globalConfig.watchAll;
+    if (isWatchMode) {
+        // In watch mode, we don't want to dispose the Harness.
+        return;
+    }
+    if (global.HARNESS) {
+        await global.HARNESS.bridge.dispose();
+        await global.HARNESS.environment.dispose();
+    }
+}

package/dist/harness-reporter.d.ts

@@ -0,0 +1,8 @@
+import { BaseReporter } from '@jest/reporters';
+import { Config } from '@jest/types';
+export default class HarnessReporter extends BaseReporter {
+    #private;
+    constructor(globalConfig: Config.GlobalConfig);
+    onRunStart(): void;
+}
+//# sourceMappingURL=harness-reporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness-reporter.d.ts","sourceRoot":"","sources":["../src/harness-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,YAAY;;gBAE3C,YAAY,EAAE,MAAM,CAAC,YAAY;IAKpC,UAAU,IAAI,IAAI;CAM5B"}

package/dist/harness-reporter.js

@@ -0,0 +1,12 @@
+import { BaseReporter } from '@jest/reporters';
+export default class HarnessReporter extends BaseReporter {
+    #globalConfig;
+    constructor(globalConfig) {
+        super();
+        this.#globalConfig = globalConfig;
+    }
+    onRunStart() {
+        super.onRunStart();
+        this.log(`Selected runner: ${this.#globalConfig.selectedRunner.name}`);
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"harness-session.d.ts","sourceRoot":"","sources":["../src/harness-session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"harness-session.d.ts","sourceRoot":"","sources":["../src/harness-session.ts"],"names":[],"mappings":"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"}

package/dist/harness-session.js

@@ -257,6 +257,9 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
     preRunMessage.remove(process.stderr);
     const setupStartedAt = Date.now();
     const { harnessConfig, platform, projectRoot, configProjectRoot } = await loadConfig(globalConfig);
+    // Metro platform for prewarm and startup detection. Vega apps request
+    // "kepler" bundles while the harness platform id stays "vega".
+    const bundlePlatform = platform.bundlePlatform ?? platform.platformId;
     applyEnvVars(harnessConfig, globalConfig);
     const diagnostics = createDiagnostics({
         enabled: isDiagnosticsEnabled(harnessConfig),
@@ -394,7 +397,7 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
                         const prewarmSpan = diagnostics.start('metro.prewarm');
                         instance
                             .prewarm({
-                            platform: platform.platformId,
+                            platform: bundlePlatform,
                             signal: sessionController.signal,
                         })
                             .then((completed) => prewarmSpan.end({ completed }))
@@ -462,7 +465,7 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
         const appReadyBaseOptions = {
             metroInstance,
             bridge,
-            platformId: platform.platformId,
+            platformId: bundlePlatform,
             bundleStartTimeout: runtimeConfig.bundleStartTimeout ?? 60000,
             readyTimeout: runtimeConfig.bridgeTimeout,
             maxAppRestarts: runtimeConfig.maxAppRestarts ?? 2,

package/dist/harness.d.ts

@@ -0,0 +1,47 @@
+import { BridgeServer } from '@react-native-harness/bridge/server';
+import { HarnessContext, TestExecutionOptions, TestSuiteResult } from '@react-native-harness/bridge';
+import { type AppLaunchOptions, HarnessPlatform, HarnessPlatformRunner } from '@react-native-harness/platforms';
+import { type MetroInstance } from '@react-native-harness/bundler-metro';
+import { type HarnessPluginManager, type HarnessRunStatus, type HarnessRunSummary } from '@react-native-harness/plugins';
+import { Config as HarnessConfig } from '@react-native-harness/config';
+import { type CrashSupervisor } from './crash-supervisor.js';
+export type HarnessRunTestsOptions = Exclude<TestExecutionOptions, 'platform'>;
+export type HarnessRunState = {
+    runId: string;
+    startTime: number;
+    testFiles: string[];
+    watchMode: boolean;
+    coverageEnabled: boolean;
+    summary?: HarnessRunSummary;
+    status?: HarnessRunStatus;
+    error?: unknown;
+};
+export type Harness = {
+    context: HarnessContext;
+    config: HarnessConfig;
+    runTests: (path: string, options: HarnessRunTestsOptions) => Promise<TestSuiteResult>;
+    ensureAppReady: (testFilePath: string) => Promise<void>;
+    restart: (testFilePath?: string) => Promise<void>;
+    dispose: () => Promise<void>;
+    crashSupervisor: CrashSupervisor;
+    callHook: HarnessPluginManager<HarnessConfig, HarnessPlatform>['callHook'];
+    setRunState: (runState: HarnessRunState | null) => void;
+    getRunState: () => HarnessRunState | null;
+};
+export declare const maybeLogMetroCacheReuse: (config: HarnessConfig, platform: HarnessPlatform, projectRoot: string) => void;
+export declare const waitForAppReady: (options: {
+    metroInstance: MetroInstance;
+    serverBridge: BridgeServer;
+    platformInstance: HarnessPlatformRunner;
+    platformId: string;
+    bundleStartTimeout: number;
+    readyTimeout: number;
+    maxAppRestarts: number;
+    testFilePath: string;
+    crashSupervisor: CrashSupervisor;
+    signal?: AbortSignal;
+    appLaunchOptions?: AppLaunchOptions;
+    launchApp?: () => Promise<void>;
+}) => 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

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EACb,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAEL,cAAc,EAGd,oBAAoB,EACpB,eAAe,EAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,gBAAgB,EACrB,eAAe,EAEf,qBAAqB,EACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAIL,KAAK,aAAa,EAGnB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAQvC,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAgB/B,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;AAE/E,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,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;IACjC,QAAQ,EAAE,oBAAoB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,UAAU,CAAC,CAAC;IAC3E,WAAW,EAAE,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;IACxD,WAAW,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;CAC3C,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,aAAa,EACrB,UAAU,eAAe,EACzB,aAAa,MAAM,KAClB,IAIF,CAAC;AAgDF,eAAO,MAAM,eAAe,GAAU,SAAS;IAC7C,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC,KAAG,OAAO,CAAC,IAAI,CA2Ef,CAAC;AA0mBF,eAAO,MAAM,UAAU,GACrB,QAAQ,aAAa,EACrB,UAAU,eAAe,EACzB,aAAa,MAAM,KAClB,OAAO,CAAC,OAAO,CAYjB,CAAC"}