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

package/dist/crash-monitor.d.ts

@@ -15,6 +15,13 @@ export type CrashMonitor = {
     reset: () => void;
     setAppSession: (session: AppSession | null) => void;
     handleBridgeDisconnect: () => void;
+    /**
+     * Opens a window during which handleBridgeDisconnect() is suppressed,
+     * for use around operations (like a runtime reset) that intentionally
+     * disconnect the bridge without the app process dying. Returns a closer
+     * that ends the window; safe to call multiple times or nest.
+     */
+    expectDisconnect: () => () => void;
     dispose: () => Promise<void>;
 };
 export type CrashMonitorOptions = {

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

@@ -1 +1 @@
-{"version":3,"file":"crash-monitor.d.ts","sourceRoot":"","sources":["../src/crash-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EAKhB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAKL,KAAK,gBAAgB,EAEtB,MAAM,aAAa,CAAC;AAOrB,qBAAa,wBAAyB,SAAQ,KAAK;;CAKlD;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,KAAK,UAAU,CAAC;IACrE,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,aAAa,EAAE,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;IACpD,sBAAsB,EAAE,MAAM,IAAI,CAAC;IACnC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAChC,CAAC;AA0EF,eAAO,MAAM,kBAAkB,GAAI,qCAEhC,mBAAwB,KAAG,YAyL7B,CAAC"}
+{"version":3,"file":"crash-monitor.d.ts","sourceRoot":"","sources":["../src/crash-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EAKhB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAKL,KAAK,gBAAgB,EAEtB,MAAM,aAAa,CAAC;AAOrB,qBAAa,wBAAyB,SAAQ,KAAK;;CAKlD;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,KAAK,UAAU,CAAC;IACrE,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,aAAa,EAAE,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;IACpD,sBAAsB,EAAE,MAAM,IAAI,CAAC;IACnC;;;;;OAKG;IACH,gBAAgB,EAAE,MAAM,MAAM,IAAI,CAAC;IACnC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAChC,CAAC;AA0EF,eAAO,MAAM,kBAAkB,GAAI,qCAEhC,mBAAwB,KAAG,YA8M7B,CAAC"}

package/dist/crash-monitor.js

@@ -55,6 +55,7 @@ export const createCrashMonitor = ({ appSession: initialAppSession = null, } = {
     let pendingTimer = null;
     let currentTestFilePath = '';
     let currentPhase = 'startup';
+    let expectedDisconnectDepth = 0;
     const watchers = new Set();
     const notifyFailure = (err) => {
         const pending = [...watchers];
@@ -154,6 +155,17 @@ export const createCrashMonitor = ({ appSession: initialAppSession = null, } = {
         };
         return { promise, cancel };
     };
+    const expectDisconnect = () => {
+        expectedDisconnectDepth += 1;
+        let closed = false;
+        return () => {
+            if (closed) {
+                return;
+            }
+            closed = true;
+            expectedDisconnectDepth = Math.max(0, expectedDisconnectDepth - 1);
+        };
+    };
     return {
         watch,
         isAlive: () => alive,
@@ -170,15 +182,22 @@ export const createCrashMonitor = ({ appSession: initialAppSession = null, } = {
             watchers.clear();
             isResolvingCrash = false;
             currentTestFilePath = '';
+            expectedDisconnectDepth = 0;
             clearPendingTimer();
         },
         setAppSession,
         handleBridgeDisconnect: () => {
+            if (expectedDisconnectDepth > 0) {
+                crashLogger.debug('ignoring expected bridge disconnect');
+                return;
+            }
             startCrashResolution('bridge-disconnect');
         },
+        expectDisconnect,
         dispose: async () => {
             disposed = true;
             monitoring = false;
+            expectedDisconnectDepth = 0;
             watchers.clear();
             isResolvingCrash = false;
             clearPendingTimer();

package/dist/diagnostics/derivers.d.ts

@@ -0,0 +1,24 @@
+import type { Diagnostics } from '@react-native-harness/tools';
+import type { HarnessBridge } from '@react-native-harness/bridge/server';
+import type { MetroInstance } from '@react-native-harness/bundler-metro';
+/**
+ * Observes Metro's reporter event stream and derives:
+ * - `metro.bundle.build` spans, correlated by `buildID` across
+ *   bundle_build_started -> bundle_build_done|bundle_build_failed.
+ * - `metro.bundle.request` marks from bundle_request_observed events.
+ */
+export declare const observeMetroEvents: (events: MetroInstance["events"], diagnostics: Diagnostics) => (() => void);
+type MinimalBridge = Pick<HarnessBridge, 'on' | 'off'>;
+/**
+ * Observes bridge connection lifecycle and device-reported bridge events and
+ * derives:
+ * - `bridge.connected` / `bridge.disconnected` marks.
+ * - `client.bundle.module`, `client.setup-file`, `client.collect`,
+ *   `client.suite`, `client.test` completed spans, recorded via
+ *   diagnostics.record() since these events arrive with a `duration` already
+ *   measured on the (unsynced) device clock; we anchor them at host receipt
+ *   time instead of trusting the device's absolute clock.
+ */
+export declare const observeBridgeEvents: (bridge: MinimalBridge, diagnostics: Diagnostics) => (() => void);
+export {};
+//# sourceMappingURL=derivers.d.ts.map

package/dist/diagnostics/derivers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derivers.d.ts","sourceRoot":"","sources":["../../src/diagnostics/derivers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,6BAA6B,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,qCAAqC,CAAC;AAW1F;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,aAAa,CAAC,QAAQ,CAAC,EAC/B,aAAa,WAAW,KACvB,CAAC,MAAM,IAAI,CA+Cb,CAAC;AAEF,KAAK,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;AAEvD;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,aAAa,EACrB,aAAa,WAAW,KACvB,CAAC,MAAM,IAAI,CAkFb,CAAC"}

package/dist/diagnostics/derivers.js

@@ -0,0 +1,146 @@
+/**
+ * Span/mark derivers translate existing domain event streams (Metro build
+ * events, bridge/device events) into diagnostics entries. This is the only
+ * place in the jest package that maps event shapes to diagnostic labels -
+ * business logic elsewhere stays free of diagnostics calls.
+ */
+const noopDispose = () => undefined;
+/**
+ * Observes Metro's reporter event stream and derives:
+ * - `metro.bundle.build` spans, correlated by `buildID` across
+ *   bundle_build_started -> bundle_build_done|bundle_build_failed.
+ * - `metro.bundle.request` marks from bundle_request_observed events.
+ */
+export const observeMetroEvents = (events, diagnostics) => {
+    if (!diagnostics.enabled) {
+        return noopDispose;
+    }
+    const inflightBuilds = new Map();
+    const listener = (event) => {
+        switch (event.type) {
+            case 'bundle_build_started': {
+                const span = diagnostics.start('metro.bundle.build', {
+                    buildID: event.buildID,
+                    platform: event.bundleDetails.platform,
+                    entryFile: event.bundleDetails.entryFile,
+                    dev: event.bundleDetails.dev,
+                });
+                inflightBuilds.set(event.buildID, span);
+                return;
+            }
+            case 'bundle_build_done': {
+                const span = inflightBuilds.get(event.buildID);
+                inflightBuilds.delete(event.buildID);
+                span?.end();
+                return;
+            }
+            case 'bundle_build_failed': {
+                const span = inflightBuilds.get(event.buildID);
+                inflightBuilds.delete(event.buildID);
+                span?.fail(new Error(`Metro bundle build ${event.buildID} failed`));
+                return;
+            }
+            case 'bundle_request_observed': {
+                diagnostics.mark('metro.bundle.request', {
+                    requestKind: event.requestKind,
+                    platform: event.platform,
+                });
+                return;
+            }
+            default:
+                return;
+        }
+    };
+    events.addListener(listener);
+    return () => {
+        events.removeListener(listener);
+    };
+};
+/**
+ * Observes bridge connection lifecycle and device-reported bridge events and
+ * derives:
+ * - `bridge.connected` / `bridge.disconnected` marks.
+ * - `client.bundle.module`, `client.setup-file`, `client.collect`,
+ *   `client.suite`, `client.test` completed spans, recorded via
+ *   diagnostics.record() since these events arrive with a `duration` already
+ *   measured on the (unsynced) device clock; we anchor them at host receipt
+ *   time instead of trusting the device's absolute clock.
+ */
+export const observeBridgeEvents = (bridge, diagnostics) => {
+    if (!diagnostics.enabled) {
+        return noopDispose;
+    }
+    const onConnected = () => {
+        diagnostics.mark('bridge.connected');
+    };
+    const onDisconnected = () => {
+        diagnostics.mark('bridge.disconnected');
+    };
+    const onEvent = (event) => {
+        switch (event.type) {
+            case 'module-bundling-finished':
+                diagnostics.record({
+                    label: 'client.bundle.module',
+                    duration: event.duration,
+                    attrs: { file: event.file },
+                });
+                return;
+            case 'module-bundling-failed':
+                diagnostics.record({
+                    label: 'client.bundle.module',
+                    duration: event.duration,
+                    attrs: { file: event.file },
+                    status: 'error',
+                });
+                return;
+            case 'setup-file-bundling-finished':
+                diagnostics.record({
+                    label: 'client.setup-file',
+                    duration: event.duration,
+                    attrs: { file: event.file, setupType: event.setupType },
+                });
+                return;
+            case 'setup-file-bundling-failed':
+                diagnostics.record({
+                    label: 'client.setup-file',
+                    duration: event.duration,
+                    attrs: { file: event.file, setupType: event.setupType },
+                    status: 'error',
+                });
+                return;
+            case 'collection-finished':
+                diagnostics.record({
+                    label: 'client.collect',
+                    duration: event.duration,
+                    attrs: { file: event.file, totalTests: event.totalTests },
+                });
+                return;
+            case 'suite-finished':
+                diagnostics.record({
+                    label: 'client.suite',
+                    duration: event.duration,
+                    attrs: { file: event.file, name: event.name, status: event.status },
+                    status: event.status === 'failed' ? 'error' : 'ok',
+                });
+                return;
+            case 'test-finished':
+                diagnostics.record({
+                    label: 'client.test',
+                    duration: event.duration,
+                    attrs: { file: event.file, name: event.name, status: event.status },
+                    status: event.status === 'failed' ? 'error' : 'ok',
+                });
+                return;
+            default:
+                return;
+        }
+    };
+    bridge.on('connected', onConnected);
+    bridge.on('disconnected', onDisconnected);
+    bridge.on('event', onEvent);
+    return () => {
+        bridge.off('connected', onConnected);
+        bridge.off('disconnected', onDisconnected);
+        bridge.off('event', onEvent);
+    };
+};

package/dist/diagnostics/index.d.ts

@@ -0,0 +1,3 @@
+export { observeMetroEvents, observeBridgeEvents } from './derivers.js';
+export { writeTraceFile, printSummary } from './report.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/diagnostics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/diagnostics/index.js

@@ -0,0 +1,2 @@
+export { observeMetroEvents, observeBridgeEvents } from './derivers.js';
+export { writeTraceFile, printSummary } from './report.js';

package/dist/diagnostics/report.d.ts

@@ -0,0 +1,7 @@
+import type { DiagnosticEntry } from '@react-native-harness/tools';
+export declare const writeTraceFile: (entries: DiagnosticEntry[], options: {
+    projectRoot: string;
+    runId: string;
+}) => Promise<string>;
+export declare const printSummary: (entries: DiagnosticEntry[], log: (line: string) => void) => void;
+//# sourceMappingURL=report.d.ts.map

package/dist/diagnostics/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/diagnostics/report.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAyCnE,eAAO,MAAM,cAAc,GACzB,SAAS,eAAe,EAAE,EAC1B,SAAS;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAC9C,OAAO,CAAC,MAAM,CAUhB,CAAC;AAkBF,eAAO,MAAM,YAAY,GACvB,SAAS,eAAe,EAAE,EAC1B,KAAK,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAC1B,IA8CF,CAAC"}

package/dist/diagnostics/report.js

@@ -0,0 +1,84 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { getHarnessRootPath } from '@react-native-harness/tools';
+const TRACE_PID = 1;
+const TRACE_TID = 1;
+const toTraceEvent = (entry) => {
+    if (entry.kind === 'mark') {
+        return {
+            name: entry.label,
+            ph: 'i',
+            s: 'g',
+            ts: entry.startTime * 1000,
+            pid: TRACE_PID,
+            tid: TRACE_TID,
+            args: entry.attrs,
+        };
+    }
+    return {
+        name: entry.label,
+        ph: 'X',
+        ts: entry.startTime * 1000,
+        dur: entry.duration * 1000,
+        pid: TRACE_PID,
+        tid: TRACE_TID,
+        args: entry.attrs,
+    };
+};
+export const writeTraceFile = async (entries, options) => {
+    const dir = path.join(getHarnessRootPath(options.projectRoot), 'diagnostics');
+    await fs.mkdir(dir, { recursive: true });
+    const filePath = path.join(dir, `${options.runId}.json`);
+    const trace = { traceEvents: entries.map(toTraceEvent) };
+    await fs.writeFile(filePath, JSON.stringify(trace), 'utf-8');
+    return filePath;
+};
+const formatDuration = (ms) => {
+    if (ms >= 1000) {
+        return `${(ms / 1000).toFixed(1)}s`;
+    }
+    return `${Math.round(ms)}ms`;
+};
+const getNamespace = (label) => label.split('.')[0] ?? label;
+export const printSummary = (entries, log) => {
+    if (entries.length === 0) {
+        return;
+    }
+    const statsByLabel = new Map();
+    for (const entry of entries) {
+        const existing = statsByLabel.get(entry.label);
+        if (existing) {
+            existing.count += 1;
+            existing.totalMs += entry.duration;
+            existing.maxMs = Math.max(existing.maxMs, entry.duration);
+        }
+        else {
+            statsByLabel.set(entry.label, {
+                label: entry.label,
+                count: 1,
+                totalMs: entry.duration,
+                maxMs: entry.duration,
+            });
+        }
+    }
+    const byNamespace = new Map();
+    for (const stats of statsByLabel.values()) {
+        const namespace = getNamespace(stats.label);
+        const group = byNamespace.get(namespace);
+        if (group) {
+            group.push(stats);
+        }
+        else {
+            byNamespace.set(namespace, [stats]);
+        }
+    }
+    log('Diagnostics summary:');
+    const sortedNamespaces = [...byNamespace.entries()].sort(([a], [b]) => a.localeCompare(b));
+    for (const [namespace, group] of sortedNamespaces) {
+        log(`  ${namespace}`);
+        group.sort((a, b) => b.totalMs - a.totalMs);
+        for (const stats of group) {
+            log(`    ${stats.label}: count=${stats.count} total=${formatDuration(stats.totalMs)} max=${formatDuration(stats.maxMs)}`);
+        }
+    }
+};

package/dist/environment-reset.d.ts

@@ -0,0 +1,51 @@
+import type { Config as HarnessConfig } from '@react-native-harness/config';
+export type ResetStrategyKind = 'process' | 'runtime';
+export type EnvironmentResetStrategy = {
+    readonly kind: ResetStrategyKind;
+    reset(ctx: {
+        testFilePath: string;
+    }): Promise<void>;
+};
+/**
+ * Normalizes the `resetEnvironmentBetweenTestFiles` config value into a
+ * strategy kind, or `null` when no reset should happen between test files
+ * (i.e. the value is `false`).
+ */
+export declare const resolveResetStrategyKind: (value: HarnessConfig["resetEnvironmentBetweenTestFiles"]) => ResetStrategyKind | null;
+export type ProcessResetStrategyDeps = {
+    restart: (testFilePath: string) => Promise<void>;
+};
+/**
+ * The 'process' strategy: kill and cold-restart the app process. This is
+ * the same implementation `restartApp` uses for crash/timeout recovery.
+ */
+export declare const createProcessResetStrategy: (deps: ProcessResetStrategyDeps) => EnvironmentResetStrategy;
+export type RuntimeResetConnection = {
+    resetEnvironment: () => Promise<void>;
+};
+export type RuntimeResetStrategyDeps = {
+    getConnection: () => RuntimeResetConnection | null;
+    expectDisconnect: () => () => void;
+    waitForReconnect: (signal: AbortSignal) => Promise<void>;
+    isDisconnectError: (error: unknown) => boolean;
+    timeoutMs: number;
+};
+/**
+ * The 'runtime' strategy: reload the JS runtime in place (DevSettings.reload()
+ * on native, window.location.reload() on web) via the resetEnvironment RPC,
+ * and wait for the bridge to reconnect. The app process stays alive
+ * throughout, so the crash monitor's expected-disconnect window is used to
+ * avoid misclassifying the intentional disconnect as a runtime failure.
+ */
+export declare const createRuntimeResetStrategy: (deps: RuntimeResetStrategyDeps) => EnvironmentResetStrategy;
+export type EscalationOptions = {
+    onEscalate?: (error: unknown) => void;
+};
+/**
+ * Wraps a primary strategy so that any failure (no active connection, RPC
+ * error, reconnect timeout, ...) falls back to running `fallback` instead of
+ * propagating the error. The composite reports the primary's `kind`, since
+ * that's the strategy that was requested.
+ */
+export declare const withEscalation: (primary: EnvironmentResetStrategy, fallback: EnvironmentResetStrategy, options?: EscalationOptions) => EnvironmentResetStrategy;
+//# sourceMappingURL=environment-reset.d.ts.map

package/dist/environment-reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-reset.d.ts","sourceRoot":"","sources":["../src/environment-reset.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAI5E,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtD,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAEjC,KAAK,CAAC,GAAG,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,aAAa,CAAC,kCAAkC,CAAC,KACvD,iBAAiB,GAAG,IAQtB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IAErC,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GACrC,MAAM,wBAAwB,KAC7B,wBAGD,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG;IACnC,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IAErC,aAAa,EAAE,MAAM,sBAAsB,GAAG,IAAI,CAAC;IAGnD,gBAAgB,EAAE,MAAM,MAAM,IAAI,CAAC;IAGnC,gBAAgB,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAIzD,iBAAiB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAE/C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACrC,MAAM,wBAAwB,KAC7B,wBAkCD,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAE9B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,SAAS,wBAAwB,EACjC,UAAU,wBAAwB,EAClC,UAAS,iBAAsB,KAC9B,wBAUD,CAAC"}

package/dist/environment-reset.js

@@ -0,0 +1,83 @@
+import { getTimeoutSignal } from '@react-native-harness/tools';
+const ignorePromiseRejection = () => undefined;
+/**
+ * Normalizes the `resetEnvironmentBetweenTestFiles` config value into a
+ * strategy kind, or `null` when no reset should happen between test files
+ * (i.e. the value is `false`).
+ */
+export const resolveResetStrategyKind = (value) => {
+    if (value === false) {
+        return null;
+    }
+    if (value === true) {
+        return 'process';
+    }
+    return value;
+};
+/**
+ * The 'process' strategy: kill and cold-restart the app process. This is
+ * the same implementation `restartApp` uses for crash/timeout recovery.
+ */
+export const createProcessResetStrategy = (deps) => ({
+    kind: 'process',
+    reset: ({ testFilePath }) => deps.restart(testFilePath),
+});
+/**
+ * The 'runtime' strategy: reload the JS runtime in place (DevSettings.reload()
+ * on native, window.location.reload() on web) via the resetEnvironment RPC,
+ * and wait for the bridge to reconnect. The app process stays alive
+ * throughout, so the crash monitor's expected-disconnect window is used to
+ * avoid misclassifying the intentional disconnect as a runtime failure.
+ */
+export const createRuntimeResetStrategy = (deps) => ({
+    kind: 'runtime',
+    reset: async () => {
+        const connection = deps.getConnection();
+        if (!connection) {
+            throw new Error('No active app connection to reset the runtime on');
+        }
+        const closeWindow = deps.expectDisconnect();
+        try {
+            // Start listening for the reconnect before firing the RPC, so a fast
+            // reload can't reconnect before we're watching for it.
+            const reconnected = deps.waitForReconnect(getTimeoutSignal(deps.timeoutMs));
+            // Observe the rejection even when the RPC throws first, so the timeout
+            // abort firing later can't become an unhandled rejection. (.catch()
+            // returns a new promise; the original is what gets awaited below.)
+            reconnected.catch(ignorePromiseRejection);
+            try {
+                await connection.resetEnvironment();
+            }
+            catch (error) {
+                // The reload can tear the runtime down before the RPC ack flushes.
+                // A disconnect-flavored rejection means the reload is in flight, so
+                // keep waiting for the reconnect; anything else is a real failure.
+                if (!deps.isDisconnectError(error)) {
+                    throw error;
+                }
+            }
+            await reconnected;
+        }
+        finally {
+            closeWindow();
+        }
+    },
+});
+/**
+ * Wraps a primary strategy so that any failure (no active connection, RPC
+ * error, reconnect timeout, ...) falls back to running `fallback` instead of
+ * propagating the error. The composite reports the primary's `kind`, since
+ * that's the strategy that was requested.
+ */
+export const withEscalation = (primary, fallback, options = {}) => ({
+    kind: primary.kind,
+    reset: async (ctx) => {
+        try {
+            await primary.reset(ctx);
+        }
+        catch (error) {
+            options.onEscalate?.(error);
+            await fallback.reset(ctx);
+        }
+    },
+});

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,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"}
+{"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;AA6BjF,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;AA+FnB,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,CAsOd,CAAC"}