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

package/dist/__tests__/crash-monitor.test.js

@@ -1,166 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import path from 'node:path';
-import { createCrashMonitor, CrashWatchCancelledError, } from '../crash-monitor.js';
-import { NativeCrashError, RuntimeDisconnectError } from '../errors.js';
-const noop = () => undefined;
-const waitForClassification = () => new Promise((resolve) => setTimeout(resolve, 1600));
-const createAppSessionMock = (initialState = { status: 'running' }, logs = [], getCrashDetails) => {
-    let state = initialState;
-    let listener = null;
-    const session = {
-        dispose: vi.fn(async () => undefined),
-        getState: vi.fn(async () => state),
-        getLogs: vi.fn(() => logs),
-        addListener: vi.fn((l) => {
-            listener = l;
-        }),
-        removeListener: vi.fn((l) => {
-            if (listener === l)
-                listener = null;
-        }),
-    };
-    if (getCrashDetails) {
-        session.getCrashDetails = getCrashDetails;
-    }
-    return {
-        session,
-        setState: (nextState) => {
-            state = nextState;
-        },
-        emit: (event) => listener?.(event),
-    };
-};
-describe('createCrashMonitor', () => {
-    it('starts not alive and becomes alive when an app session is attached', () => {
-        const cm = createCrashMonitor();
-        const { session } = createAppSessionMock();
-        expect(cm.isAlive()).toBe(false);
-        cm.setAppSession(session);
-        expect(cm.isAlive()).toBe(true);
-    });
-    it('rejects a watch with NativeCrashError when the app session exits', async () => {
-        const { session, emit } = createAppSessionMock({
-            status: 'exited',
-            occurredAt: Date.now(),
-            reason: 'observed-exit',
-        });
-        const cm = createCrashMonitor({ appSession: session });
-        const watch = cm.watch('/test/example.ts', 'execution');
-        watch.promise.catch(noop);
-        emit({ type: 'app_exited' });
-        const error = await watch.promise.catch((err) => err);
-        expect(error).toBeInstanceOf(NativeCrashError);
-        expect(error.testFilePath).toBe('/test/example.ts');
-        expect(error.details.phase).toBe('execution');
-        expect(cm.isAlive()).toBe(false);
-    });
-    it('classifies bridge disconnect plus exited app as NativeCrashError', async () => {
-        const { session, setState } = createAppSessionMock();
-        const cm = createCrashMonitor({ appSession: session });
-        const watch = cm.watch('test.ts', 'execution');
-        watch.promise.catch(noop);
-        cm.handleBridgeDisconnect();
-        setState({
-            status: 'exited',
-            occurredAt: Date.now(),
-            reason: 'process-gone',
-        });
-        await expect(watch.promise).rejects.toBeInstanceOf(NativeCrashError);
-    });
-    it('classifies bridge disconnect plus running app as RuntimeDisconnectError', async () => {
-        const { session } = createAppSessionMock({ status: 'running' });
-        const cm = createCrashMonitor({ appSession: session });
-        const watch = cm.watch('test.ts', 'execution');
-        watch.promise.catch(noop);
-        cm.handleBridgeDisconnect();
-        await expect(watch.promise).rejects.toBeInstanceOf(RuntimeDisconnectError);
-    });
-    it('attaches matching session log evidence to native crash details', async () => {
-        const occurredAt = Date.now();
-        const logs = [
-            { line: 'ordinary app log', occurredAt },
-            { line: 'MyApp[123] fatal error: boom', occurredAt },
-        ];
-        const { session, setState } = createAppSessionMock({ status: 'running' }, logs);
-        const cm = createCrashMonitor({ appSession: session });
-        const watch = cm.watch('test.ts', 'execution');
-        watch.promise.catch(noop);
-        cm.handleBridgeDisconnect();
-        setState({ status: 'exited', occurredAt, reason: 'process-gone' });
-        const error = await watch.promise.catch((err) => err);
-        expect(error).toBeInstanceOf(NativeCrashError);
-        expect(error.details.rawLines).toEqual(['MyApp[123] fatal error: boom']);
-    });
-    it('asks the app session to extract native crash details for the current test', async () => {
-        const occurredAt = Date.now();
-        const getCrashDetails = vi.fn(async () => ({
-            artifactType: 'logcat',
-            artifactPath: '/tmp/.harness/crash-reports/crash-logcat.txt',
-            processName: 'com.harnessplayground',
-            pid: 7777,
-        }));
-        const { session, setState } = createAppSessionMock({ status: 'running' }, [], getCrashDetails);
-        const cm = createCrashMonitor({ appSession: session });
-        const watch = cm.watch('/test/example.ts', 'execution');
-        watch.promise.catch(noop);
-        cm.handleBridgeDisconnect();
-        setState({
-            status: 'exited',
-            occurredAt,
-            pid: 7777,
-            reason: 'process-gone',
-        });
-        const error = await watch.promise.catch((err) => err);
-        expect(getCrashDetails).toHaveBeenCalledWith({
-            occurredAt: expect.any(Number),
-            pid: 7777,
-            processName: undefined,
-            testFilePath: '/test/example.ts',
-        });
-        expect(error.details.artifactPath).toBe('/tmp/.harness/crash-reports/crash-logcat.txt');
-        expect(error.message).toContain(`Harness extracted the crash log: ${path.relative(process.cwd(), '/tmp/.harness/crash-reports/crash-logcat.txt')}`);
-    });
-    it('falls back to log details when native crash extraction fails', async () => {
-        const occurredAt = Date.now();
-        const getCrashDetails = vi.fn(async () => {
-            throw new Error('copy failed');
-        });
-        const { session, setState } = createAppSessionMock({ status: 'running' }, [{ line: 'MyApp[123] fatal error: boom', occurredAt }], getCrashDetails);
-        const cm = createCrashMonitor({ appSession: session });
-        const watch = cm.watch('/test/example.ts', 'execution');
-        watch.promise.catch(noop);
-        cm.handleBridgeDisconnect();
-        setState({ status: 'exited', occurredAt, reason: 'process-gone' });
-        const error = await watch.promise.catch((err) => err);
-        expect(error.details.rawLines).toEqual(['MyApp[123] fatal error: boom']);
-        expect(error.message).toContain("Harness couldn't extract the crash log.");
-    });
-    it('settles the promise with CrashWatchCancelledError on cancel()', async () => {
-        const cm = createCrashMonitor();
-        const watch = cm.watch('test.ts', 'execution');
-        watch.cancel();
-        await expect(watch.promise).rejects.toBeInstanceOf(CrashWatchCancelledError);
-    });
-    it('ignores session events while stopped', async () => {
-        const { session, emit } = createAppSessionMock({
-            status: 'exited',
-            occurredAt: Date.now(),
-        });
-        const cm = createCrashMonitor({ appSession: session });
-        await cm.stop();
-        const watch = cm.watch('test.ts', 'execution');
-        const settled = vi.fn();
-        watch.promise.then(settled, settled);
-        emit({ type: 'app_exited' });
-        await waitForClassification();
-        expect(settled).not.toHaveBeenCalled();
-        watch.cancel();
-    });
-    it('removes the app session listener on dispose', async () => {
-        const { session } = createAppSessionMock();
-        const cm = createCrashMonitor({ appSession: session });
-        await cm.dispose();
-        expect(session.removeListener).toHaveBeenCalledOnce();
-        expect(cm.isAlive()).toBe(false);
-    });
-});

package/dist/__tests__/crash-supervisor.test.d.ts

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

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

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

package/dist/__tests__/crash-supervisor.test.js

@@ -1,151 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { createCrashSupervisor } from '../crash-supervisor.js';
-const createMockAppMonitor = (options) => {
-    const listeners = new Set();
-    const noop = async () => undefined;
-    const appMonitor = {
-        start: noop,
-        stop: noop,
-        dispose: noop,
-        addListener: (listener) => {
-            listeners.add(listener);
-        },
-        removeListener: (listener) => {
-            listeners.delete(listener);
-        },
-    };
-    if (options?.getCrashDetails) {
-        appMonitor.getCrashDetails = options.getCrashDetails;
-    }
-    const emit = (event) => {
-        for (const listener of listeners) {
-            listener(event);
-        }
-    };
-    return {
-        appMonitor,
-        emit,
-    };
-};
-const createPlatformRunner = ({ isAppRunning, getCrashDetails, }) => ({
-    startApp: async () => undefined,
-    restartApp: async () => undefined,
-    stopApp: async () => undefined,
-    dispose: async () => undefined,
-    isAppRunning,
-    createAppMonitor: () => {
-        throw new Error('Not used in unit tests');
-    },
-    getCrashDetails,
-});
-describe('crash-supervisor', () => {
-    it('rejects the active test when the app exits during launch', async () => {
-        const monitor = createMockAppMonitor();
-        const supervisor = createCrashSupervisor({
-            appMonitor: monitor.appMonitor,
-            platformRunner: createPlatformRunner({
-                isAppRunning: vi.fn().mockResolvedValue(false),
-            }),
-        });
-        supervisor.beginLaunch('/tmp/startup.harness.ts');
-        const crashPromise = supervisor.waitForCrash('/tmp/startup.harness.ts');
-        const expectation = expect(crashPromise).rejects.toMatchObject({
-            name: 'NativeCrashError',
-            phase: 'startup',
-            details: {
-                signal: 'SIGSEGV',
-                processName: 'com.harnessplayground',
-            },
-        });
-        monitor.emit({
-            type: 'app_exited',
-            source: 'logs',
-            crashDetails: {
-                source: 'logs',
-                signal: 'SIGSEGV',
-                processName: 'com.harnessplayground',
-                rawLines: ['Fatal signal 11 (SIGSEGV)'],
-            },
-        });
-        await expectation;
-        await supervisor.dispose();
-    });
-    it('treats polling exit events as immediately confirmed crashes', async () => {
-        const monitor = createMockAppMonitor();
-        const isAppRunning = vi.fn().mockResolvedValue(true);
-        const supervisor = createCrashSupervisor({
-            appMonitor: monitor.appMonitor,
-            platformRunner: createPlatformRunner({
-                isAppRunning,
-            }),
-        });
-        supervisor.beginLaunch('/tmp/polling-exit.harness.ts');
-        const crashPromise = supervisor.waitForCrash('/tmp/polling-exit.harness.ts');
-        monitor.emit({ type: 'app_exited', source: 'polling' });
-        await expect(crashPromise).rejects.toMatchObject({
-            name: 'NativeCrashError',
-            phase: 'startup',
-        });
-        expect(isAppRunning).not.toHaveBeenCalled();
-        await supervisor.dispose();
-    });
-    it('does not reject when monitoring is stopped', async () => {
-        const monitor = createMockAppMonitor();
-        const supervisor = createCrashSupervisor({
-            appMonitor: monitor.appMonitor,
-            platformRunner: createPlatformRunner({
-                isAppRunning: vi.fn().mockResolvedValue(false),
-            }),
-        });
-        supervisor.beginTestRun('/tmp/restart.harness.ts');
-        await supervisor.stop();
-        const reject = vi.fn();
-        void supervisor.waitForCrash('/tmp/restart.harness.ts').catch(reject);
-        monitor.emit({ type: 'app_exited', source: 'polling' });
-        await Promise.resolve();
-        expect(reject).not.toHaveBeenCalled();
-        await supervisor.dispose();
-    });
-    it('prefers crash details from the started app monitor over the runner', async () => {
-        const monitorGetCrashDetails = vi.fn().mockResolvedValue({
-            source: 'logs',
-            summary: 'full crash block',
-            rawLines: ['full crash block'],
-        });
-        const runnerGetCrashDetails = vi.fn().mockResolvedValue({
-            source: 'logs',
-            summary: 'runner details',
-            rawLines: ['runner details'],
-        });
-        const monitor = createMockAppMonitor({
-            getCrashDetails: monitorGetCrashDetails,
-        });
-        const supervisor = createCrashSupervisor({
-            appMonitor: monitor.appMonitor,
-            platformRunner: createPlatformRunner({
-                isAppRunning: vi.fn().mockResolvedValue(false),
-                getCrashDetails: runnerGetCrashDetails,
-            }),
-        });
-        supervisor.beginTestRun('/tmp/monitor-details.harness.ts');
-        const crashPromise = supervisor.waitForCrash('/tmp/monitor-details.harness.ts');
-        monitor.emit({
-            type: 'possible_crash',
-            source: 'logs',
-            crashDetails: {
-                source: 'logs',
-                processName: 'com.harnessplayground',
-                pid: 1234,
-                rawLines: ['partial line'],
-            },
-        });
-        await expect(crashPromise).rejects.toMatchObject({
-            details: {
-                summary: 'full crash block',
-            },
-        });
-        expect(monitorGetCrashDetails).toHaveBeenCalled();
-        expect(runnerGetCrashDetails).not.toHaveBeenCalled();
-        await supervisor.dispose();
-    });
-});

package/dist/__tests__/errors.test.d.ts

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

package/dist/__tests__/errors.test.d.ts.map

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

package/dist/__tests__/errors.test.js

@@ -1,98 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import path from 'node:path';
-import { AppBridgeDisconnectedError } from '@react-native-harness/bridge/server';
-import { NativeCrashError, PlatformReadyTimeoutError } from '../errors.js';
-describe('PlatformReadyTimeoutError', () => {
-    it('includes the configured timeout and config hint', () => {
-        expect(new PlatformReadyTimeoutError(300000).message).toBe('The platform did not become ready within 300000ms. Increase "platformReadyTimeout" if your device, simulator, or emulator needs more time to start.');
-    });
-});
-describe('NativeCrashError', () => {
-    it('reports the extracted crash log path when available', () => {
-        const error = new NativeCrashError('/tmp/crash.harness.ts', {
-            phase: 'execution',
-            artifactPath: path.join(process.cwd(), '.harness', 'crash-reports', 'crash.ips'),
-        });
-        expect(error.message).toContain(`Harness extracted the crash log: ${path.join('.harness', 'crash-reports', 'crash.ips')}`);
-    });
-    it('lists enrichment artifact paths when available', () => {
-        const error = new NativeCrashError('/tmp/crash.harness.ts', {
-            phase: 'execution',
-            artifactPath: path.join(process.cwd(), '.harness', 'crash-reports', 'logcat.txt'),
-            enrichmentArtifacts: [
-                {
-                    artifactType: 'dropbox-native-crash',
-                    artifactPath: path.join(process.cwd(), '.harness', 'crash-reports', 'dropbox-native-crash.txt'),
-                },
-            ],
-        });
-        expect(error.message).toContain('Additional crash artifacts:');
-        expect(error.message).toContain(path.join('.harness', 'crash-reports', 'dropbox-native-crash.txt'));
-    });
-    it('reports crash log extraction failure when no artifact was pulled', () => {
-        const error = new NativeCrashError('/tmp/crash.harness.ts', {
-            phase: 'execution',
-        });
-        expect(error.message).toContain("Harness couldn't extract the crash log.");
-    });
-    it('formats the extracted stack trace in the error message', () => {
-        const error = new NativeCrashError('/tmp/crash.harness.ts', {
-            phase: 'execution',
-            processName: 'HarnessPlayground',
-            pid: 1234,
-            signal: 'SIGTRAP',
-            exceptionType: 'EXC_BREAKPOINT',
-            stackTrace: [
-                '0 AppDelegate.crashIfRequested() (AppDelegate.swift:31)',
-                '1 AppDelegate.application(_:didFinishLaunchingWithOptions:) (AppDelegate.swift:56)',
-            ],
-        });
-        expect(error.message).toContain('  0 AppDelegate.crashIfRequested() (AppDelegate.swift:31)');
-        expect(error.message).toContain('  1 AppDelegate.application(_:didFinishLaunchingWithOptions:) (AppDelegate.swift:56)');
-    });
-    it('omits single-line iOS summaries from the rendered error message', () => {
-        const error = new NativeCrashError('/tmp/crash.harness.ts', {
-            phase: 'startup',
-            artifactType: 'ios-crash-report',
-            summary: '2026-03-12 13:46:18.154 Df HarnessPlayground[18007:65e716] [com.apple.dt.xctest:Default] notify_get_state check indicated test daemon not ready.',
-            processName: 'HarnessPlayground',
-            pid: 18007,
-            signal: 'SIGABRT',
-            exceptionType: 'EXC_CRASH',
-        });
-        expect(error.message).not.toContain('notify_get_state check indicated test daemon not ready');
-        expect(error.message).toContain('Signal: SIGABRT');
-        expect(error.message).toContain('Exception: EXC_CRASH');
-        expect(error.message).toContain('Process: HarnessPlayground (pid 18007)');
-    });
-    it('does not duplicate stack frames when the summary already contains a crash block', () => {
-        const frame = '03-13 07:59:44.943 20373 20373 E AndroidRuntime: \tat com.harnessplayground.MainActivity.onCreate(MainActivity.kt:38)';
-        const error = new NativeCrashError('/tmp/crash.harness.ts', {
-            phase: 'startup',
-            summary: [
-                '--------- beginning of crash',
-                '03-13 07:59:44.943 20373 20373 E AndroidRuntime: FATAL EXCEPTION: main',
-                frame,
-            ].join('\n'),
-            stackTrace: [frame],
-        });
-        expect(error.message.match(/MainActivity\.onCreate\(MainActivity\.kt:38\)/g)).toHaveLength(1);
-    });
-    it('collapses the native crash stack header so jest does not reprint multiline messages', () => {
-        const error = new NativeCrashError('/tmp/crash.harness.ts', {
-            phase: 'startup',
-            summary: ['line one', 'line two'].join('\n'),
-        });
-        expect(error.stack).toBe('NativeCrashError: The native app crashed while preparing to run this test file.');
-    });
-});
-describe('AppBridgeDisconnectedError', () => {
-    it('explains likely causes without exposing an internal stack', () => {
-        const error = new AppBridgeDisconnectedError('app-disconnected');
-        expect(error.message).toBe('The app bridge disconnected during test execution. This can happen if the app was killed, crashed, reloaded, or restarted while the test file was running.');
-        expect(error.stack).toBe(`AppBridgeDisconnectedError: ${error.message}`);
-    });
-    it('uses a reconnection-specific message when a newer app connection replaces the old one', () => {
-        expect(new AppBridgeDisconnectedError('app-replaced').message).toBe('The app bridge was replaced by a newer app connection. This can happen when the app reloads, restarts, or reconnects while a test file is still running.');
-    });
-});

package/dist/__tests__/execute-run.test.d.ts

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

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

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