@react-native-harness/jest 1.4.0 → 1.5.0

package/dist/crash-supervisor.js

@@ -1,210 +0,0 @@
-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/diagnostics/__tests__/derivers.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=derivers.test.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"derivers.test.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/__tests__/derivers.test.ts"],"names":[],"mappings":""}

package/dist/diagnostics/__tests__/derivers.test.js

@@ -1,248 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { createDiagnostics, getEmitter } from '@react-native-harness/tools';
-import { observeBridgeEvents, observeMetroEvents } from '../derivers.js';
-const createFakeBridge = () => {
-    const listeners = {
-        connected: new Set(),
-        disconnected: new Set(),
-        event: new Set(),
-    };
-    return {
-        on: (event, listener) => {
-            listeners[event].add(listener);
-        },
-        off: (event, listener) => {
-            listeners[event].delete(listener);
-        },
-        emitConnected: () => listeners.connected.forEach((l) => l({})),
-        emitDisconnected: () => listeners.disconnected.forEach((l) => l()),
-        emitEvent: (event) => listeners.event.forEach((l) => l(event)),
-        listenerCounts: () => ({
-            connected: listeners.connected.size,
-            disconnected: listeners.disconnected.size,
-            event: listeners.event.size,
-        }),
-    };
-};
-describe('observeMetroEvents', () => {
-    it('is a no-op and does not subscribe when diagnostics is disabled', () => {
-        const events = getEmitter();
-        const diagnostics = createDiagnostics({ enabled: false });
-        const dispose = observeMetroEvents(events, diagnostics);
-        events.emit({
-            type: 'bundle_build_started',
-            buildID: '1',
-            bundleDetails: {
-                bundleType: 'bundle',
-                dev: true,
-                entryFile: 'index.js',
-                minify: false,
-                platform: 'ios',
-            },
-        });
-        expect(diagnostics.flush()).toEqual([]);
-        dispose();
-    });
-    it('correlates bundle_build_started/done via buildID into a span', () => {
-        const events = getEmitter();
-        const diagnostics = createDiagnostics({ enabled: true });
-        observeMetroEvents(events, diagnostics);
-        events.emit({
-            type: 'bundle_build_started',
-            buildID: 'build-1',
-            bundleDetails: {
-                bundleType: 'bundle',
-                dev: true,
-                entryFile: 'index.js',
-                minify: false,
-                platform: 'ios',
-            },
-        });
-        events.emit({ type: 'bundle_build_done', buildID: 'build-1' });
-        const entries = diagnostics.flush();
-        expect(entries).toHaveLength(1);
-        expect(entries[0]?.label).toBe('metro.bundle.build');
-        expect(entries[0]?.status).toBe('ok');
-        expect(entries[0]?.attrs).toMatchObject({
-            buildID: 'build-1',
-            platform: 'ios',
-            entryFile: 'index.js',
-        });
-    });
-    it('records a failed span for bundle_build_failed', () => {
-        const events = getEmitter();
-        const diagnostics = createDiagnostics({ enabled: true });
-        observeMetroEvents(events, diagnostics);
-        events.emit({
-            type: 'bundle_build_started',
-            buildID: 'build-2',
-            bundleDetails: {
-                bundleType: 'bundle',
-                dev: true,
-                entryFile: 'index.js',
-                minify: false,
-                platform: 'android',
-            },
-        });
-        events.emit({ type: 'bundle_build_failed', buildID: 'build-2' });
-        const entries = diagnostics.flush();
-        expect(entries).toHaveLength(1);
-        expect(entries[0]?.status).toBe('error');
-    });
-    it('records a bundle_request_observed mark', () => {
-        const events = getEmitter();
-        const diagnostics = createDiagnostics({ enabled: true });
-        observeMetroEvents(events, diagnostics);
-        events.emit({
-            type: 'bundle_request_observed',
-            platform: 'ios',
-            requestKind: 'app',
-            timestamp: new Date().toISOString(),
-            url: '/index.bundle',
-        });
-        const entries = diagnostics.flush();
-        expect(entries).toHaveLength(1);
-        expect(entries[0]?.label).toBe('metro.bundle.request');
-        expect(entries[0]?.kind).toBe('mark');
-        expect(entries[0]?.attrs).toEqual({ requestKind: 'app', platform: 'ios' });
-    });
-    it('dispose() unsubscribes the listener', () => {
-        const events = getEmitter();
-        const diagnostics = createDiagnostics({ enabled: true });
-        const dispose = observeMetroEvents(events, diagnostics);
-        dispose();
-        events.emit({
-            type: 'bundle_request_observed',
-            platform: 'ios',
-            requestKind: 'app',
-            timestamp: new Date().toISOString(),
-            url: '/index.bundle',
-        });
-        expect(diagnostics.flush()).toEqual([]);
-    });
-});
-describe('observeBridgeEvents', () => {
-    it('is a no-op and does not subscribe when diagnostics is disabled', () => {
-        const bridge = createFakeBridge();
-        const diagnostics = createDiagnostics({ enabled: false });
-        observeBridgeEvents(bridge, diagnostics);
-        expect(bridge.listenerCounts()).toEqual({ connected: 0, disconnected: 0, event: 0 });
-    });
-    it('marks bridge.connected and bridge.disconnected', () => {
-        const bridge = createFakeBridge();
-        const diagnostics = createDiagnostics({ enabled: true });
-        observeBridgeEvents(bridge, diagnostics);
-        bridge.emitConnected();
-        bridge.emitDisconnected();
-        const entries = diagnostics.flush();
-        expect(entries.map((e) => e.label)).toEqual(['bridge.connected', 'bridge.disconnected']);
-        expect(entries.every((e) => e.kind === 'mark')).toBe(true);
-    });
-    it('records client.bundle.module for module bundling events', () => {
-        const bridge = createFakeBridge();
-        const diagnostics = createDiagnostics({ enabled: true });
-        observeBridgeEvents(bridge, diagnostics);
-        bridge.emitEvent({ type: 'module-bundling-finished', file: 'a.ts', duration: 12 });
-        bridge.emitEvent({
-            type: 'module-bundling-failed',
-            file: 'b.ts',
-            duration: 5,
-            error: 'boom',
-        });
-        const entries = diagnostics.flush();
-        expect(entries).toHaveLength(2);
-        expect(entries[0]).toMatchObject({
-            label: 'client.bundle.module',
-            duration: 12,
-            status: 'ok',
-            attrs: { file: 'a.ts' },
-        });
-        expect(entries[1]).toMatchObject({
-            label: 'client.bundle.module',
-            duration: 5,
-            status: 'error',
-            attrs: { file: 'b.ts' },
-        });
-    });
-    it('records client.setup-file for setup file bundling events', () => {
-        const bridge = createFakeBridge();
-        const diagnostics = createDiagnostics({ enabled: true });
-        observeBridgeEvents(bridge, diagnostics);
-        bridge.emitEvent({
-            type: 'setup-file-bundling-finished',
-            file: 'setup.ts',
-            setupType: 'setupFiles',
-            duration: 20,
-        });
-        const entries = diagnostics.flush();
-        expect(entries).toHaveLength(1);
-        expect(entries[0]).toMatchObject({
-            label: 'client.setup-file',
-            duration: 20,
-            attrs: { file: 'setup.ts', setupType: 'setupFiles' },
-        });
-    });
-    it('records client.collect for collection-finished', () => {
-        const bridge = createFakeBridge();
-        const diagnostics = createDiagnostics({ enabled: true });
-        observeBridgeEvents(bridge, diagnostics);
-        bridge.emitEvent({
-            type: 'collection-finished',
-            file: 'a.test.ts',
-            duration: 8,
-            totalTests: 3,
-        });
-        const entries = diagnostics.flush();
-        expect(entries[0]).toMatchObject({
-            label: 'client.collect',
-            duration: 8,
-            attrs: { file: 'a.test.ts', totalTests: 3 },
-        });
-    });
-    it('records client.suite and client.test with status', () => {
-        const bridge = createFakeBridge();
-        const diagnostics = createDiagnostics({ enabled: true });
-        observeBridgeEvents(bridge, diagnostics);
-        bridge.emitEvent({
-            type: 'suite-finished',
-            file: 'a.test.ts',
-            name: 'my suite',
-            duration: 100,
-            status: 'failed',
-        });
-        bridge.emitEvent({
-            type: 'test-finished',
-            file: 'a.test.ts',
-            suite: 'my suite',
-            name: 'my test',
-            ancestorTitles: [],
-            fullName: 'my suite my test',
-            startedAt: Date.now(),
-            duration: 15,
-            status: 'passed',
-        });
-        const entries = diagnostics.flush();
-        expect(entries[0]).toMatchObject({ label: 'client.suite', status: 'error' });
-        expect(entries[1]).toMatchObject({ label: 'client.test', status: 'ok' });
-    });
-    it('anchors recorded entries near "now - duration" using the host clock', () => {
-        const bridge = createFakeBridge();
-        const diagnostics = createDiagnostics({ enabled: true });
-        observeBridgeEvents(bridge, diagnostics);
-        const before = Date.now();
-        bridge.emitEvent({ type: 'module-bundling-finished', file: 'a.ts', duration: 50 });
-        const after = Date.now();
-        const [entry] = diagnostics.flush();
-        expect(entry?.startTime).toBeGreaterThanOrEqual(before - 50 - 5);
-        expect(entry?.startTime).toBeLessThanOrEqual(after - 50 + 5);
-    });
-    it('dispose() unsubscribes all listeners', () => {
-        const bridge = createFakeBridge();
-        const diagnostics = createDiagnostics({ enabled: true });
-        const dispose = observeBridgeEvents(bridge, diagnostics);
-        dispose();
-        expect(bridge.listenerCounts()).toEqual({ connected: 0, disconnected: 0, event: 0 });
-        bridge.emitConnected();
-        expect(diagnostics.flush()).toEqual([]);
-    });
-});

package/dist/diagnostics/__tests__/report.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=report.test.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"report.test.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/__tests__/report.test.ts"],"names":[],"mappings":""}

package/dist/diagnostics/__tests__/report.test.js

@@ -1,97 +0,0 @@
-import fs from 'node:fs/promises';
-import os from 'node:os';
-import path from 'node:path';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
-import { printSummary, writeTraceFile } from '../report.js';
-const makeSpanEntry = (overrides = {}) => ({
-    label: 'metro.bundle.build',
-    startTime: 1_000,
-    duration: 250,
-    status: 'ok',
-    kind: 'span',
-    ...overrides,
-});
-describe('writeTraceFile', () => {
-    let projectRoot;
-    beforeEach(async () => {
-        projectRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'react-native-harness-report-test-'));
-    });
-    afterEach(async () => {
-        await fs.rm(projectRoot, { recursive: true, force: true });
-    });
-    it('writes a Chrome Trace Event JSON file under .harness/diagnostics', async () => {
-        const entries = [
-            makeSpanEntry({ attrs: { file: 'a.test.ts' } }),
-            makeSpanEntry({
-                label: 'bridge.connected',
-                duration: 0,
-                kind: 'mark',
-            }),
-        ];
-        const filePath = await writeTraceFile(entries, {
-            projectRoot,
-            runId: 'run-123',
-        });
-        expect(filePath).toBe(path.join(projectRoot, '.harness', 'diagnostics', 'run-123.json'));
-        const raw = await fs.readFile(filePath, 'utf-8');
-        const parsed = JSON.parse(raw);
-        expect(parsed.traceEvents).toHaveLength(2);
-        expect(parsed.traceEvents[0]).toMatchObject({
-            name: 'metro.bundle.build',
-            ph: 'X',
-            ts: 1_000 * 1000,
-            dur: 250 * 1000,
-            pid: 1,
-            tid: 1,
-            args: { file: 'a.test.ts' },
-        });
-        expect(parsed.traceEvents[1]).toMatchObject({
-            name: 'bridge.connected',
-            ph: 'i',
-            s: 'g',
-        });
-    });
-    it('creates the diagnostics directory recursively when missing', async () => {
-        const filePath = await writeTraceFile([makeSpanEntry()], {
-            projectRoot,
-            runId: 'run-456',
-        });
-        const stat = await fs.stat(filePath);
-        expect(stat.isFile()).toBe(true);
-    });
-});
-describe('printSummary', () => {
-    it('does nothing when there are no entries', () => {
-        const lines = [];
-        printSummary([], (line) => lines.push(line));
-        expect(lines).toEqual([]);
-    });
-    it('groups by top-level namespace and sorts labels by total duration desc', () => {
-        const lines = [];
-        printSummary([
-            makeSpanEntry({ label: 'metro.bundle.build', duration: 100 }),
-            makeSpanEntry({ label: 'metro.bundle.build', duration: 200 }),
-            makeSpanEntry({ label: 'metro.init', duration: 50 }),
-            makeSpanEntry({ label: 'client.test', duration: 5000 }),
-        ], (line) => lines.push(line));
-        const metroHeaderIndex = lines.indexOf('  metro');
-        const clientHeaderIndex = lines.indexOf('  client');
-        expect(metroHeaderIndex).toBeGreaterThanOrEqual(0);
-        expect(clientHeaderIndex).toBeGreaterThanOrEqual(0);
-        const bundleLine = lines.find((l) => l.includes('metro.bundle.build'));
-        expect(bundleLine).toContain('count=2');
-        expect(bundleLine).toContain('total=300ms');
-        expect(bundleLine).toContain('max=200ms');
-        const clientLine = lines.find((l) => l.includes('client.test'));
-        expect(clientLine).toContain('total=5.0s');
-    });
-    it('formats sub-second durations in ms and second+ durations in s', () => {
-        const lines = [];
-        printSummary([
-            makeSpanEntry({ label: 'a.b', duration: 999 }),
-            makeSpanEntry({ label: 'a.c', duration: 1500 }),
-        ], (line) => lines.push(line));
-        expect(lines.find((l) => l.includes('a.b'))).toContain('999ms');
-        expect(lines.find((l) => l.includes('a.c'))).toContain('1.5s');
-    });
-});

package/dist/event-mapper.d.ts

@@ -1,16 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}