@react-native-harness/jest 1.1.0-rc.3 → 1.1.0-rc.4

package/dist/__tests__/harness.test.js

@@ -1,6 +1,7 @@
 import { EventEmitter } from 'node:events';
 import { HARNESS_BRIDGE_PATH } from '@react-native-harness/bridge';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { MetroPortRangeExhaustedError } from '../errors.js';
 import { definePlugin } from '@react-native-harness/plugins';
 import { createCrashSupervisor } from '../crash-supervisor.js';
 const mocks = vi.hoisted(() => ({
@@ -9,16 +10,19 @@ const mocks = vi.hoisted(() => ({
     getMetroInstance: vi.fn(),
     isMetroCacheReusable: vi.fn(() => false),
     logMetroCacheReused: vi.fn(),
+    logMetroPortFallback: vi.fn(),
     logRunnerStarting: vi.fn(),
     logRunnerStillWaitingInQueue: vi.fn(),
     logRunnerWaitingInQueue: vi.fn(),
     waitForMetroBackedAppReady: vi.fn(),
+    isPortAvailable: vi.fn(async () => true),
 }));
 vi.mock('@react-native-harness/bundler-metro', async () => {
     const actual = await vi.importActual('@react-native-harness/bundler-metro');
     return {
         ...actual,
         getMetroInstance: mocks.getMetroInstance,
+        isPortAvailable: mocks.isPortAvailable,
         isMetroCacheReusable: mocks.isMetroCacheReusable,
         waitForMetroBackedAppReady: mocks.waitForMetroBackedAppReady,
     };
@@ -28,6 +32,7 @@ vi.mock('@react-native-harness/bridge/server', () => ({
 }));
 vi.mock('../logs.js', () => ({
     logMetroCacheReused: mocks.logMetroCacheReused,
+    logMetroPortFallback: mocks.logMetroPortFallback,
     logRunnerStarting: mocks.logRunnerStarting,
     logRunnerStillWaitingInQueue: mocks.logRunnerStillWaitingInQueue,
     logRunnerWaitingInQueue: mocks.logRunnerWaitingInQueue,
@@ -148,6 +153,8 @@ const createHarnessConfig = (overrides = {}) => ({
 });
 beforeEach(() => {
     vi.clearAllMocks();
+    mocks.isPortAvailable.mockReset();
+    mocks.isPortAvailable.mockResolvedValue(true);
 });
 afterEach(() => {
     delete globalThis.__HARNESS_PLATFORM_RUNNER__;
@@ -271,11 +278,62 @@ describe('getHarness', () => {
             runner: `data:text/javascript,${encodeURIComponent('export default (...args) => globalThis.__HARNESS_PLATFORM_RUNNER__(...args);')}`,
         };
         const harness = await getHarness(createHarnessConfig(), platform, '/tmp/project');
-        expect(runner).toHaveBeenCalledWith(platform.config, expect.any(Object), expect.objectContaining({
+        expect(runner).toHaveBeenCalledWith(platform.config, expect.objectContaining({
+            metroPort: 8081,
+        }), expect.objectContaining({
             signal: expect.any(AbortSignal),
         }));
         await harness.dispose();
     });
+    it('resolves and exposes a fallback Metro port before platform init', async () => {
+        const { serverBridge } = createBridgeServer();
+        const appMonitor = createAppMonitor();
+        const platformInstance = createPlatformRunner({
+            createAppMonitor: () => appMonitor.appMonitor,
+        });
+        const metroInstance = createMetroInstance();
+        mocks.getBridgeServer.mockResolvedValue(serverBridge);
+        mocks.getMetroInstance.mockResolvedValue(metroInstance);
+        mocks.isPortAvailable
+            .mockResolvedValueOnce(false)
+            .mockResolvedValueOnce(true);
+        const runner = vi.fn(async () => platformInstance);
+        globalThis.__HARNESS_PLATFORM_RUNNER__ = runner;
+        const platform = {
+            config: {},
+            getResourceLockKey: () => 'android:emulator:Pixel_8_API_35',
+            name: 'android',
+            platformId: 'android',
+            runner: `data:text/javascript,${encodeURIComponent('export default (...args) => globalThis.__HARNESS_PLATFORM_RUNNER__(...args);')}`,
+        };
+        const harness = await getHarness(createHarnessConfig(), platform, '/tmp/project');
+        expect(harness.config.metroPort).toBe(8082);
+        expect(mocks.getMetroInstance).toHaveBeenCalledWith(expect.objectContaining({
+            harnessConfig: expect.objectContaining({
+                metroPort: 8082,
+            }),
+        }), expect.any(AbortSignal));
+        expect(runner).toHaveBeenCalledWith(platform.config, expect.objectContaining({
+            metroPort: 8082,
+        }), expect.objectContaining({
+            signal: expect.any(AbortSignal),
+        }));
+        expect(mocks.logMetroPortFallback).toHaveBeenCalledWith(8081, 8082);
+        await harness.dispose();
+    });
+    it('fails when no Metro port is available in the retry window', async () => {
+        mocks.isPortAvailable.mockResolvedValue(false);
+        const platform = {
+            config: {},
+            getResourceLockKey: () => 'android:emulator:Pixel_8_API_35',
+            name: 'android',
+            platformId: 'android',
+            runner: 'data:text/javascript,export default async () => ({})',
+        };
+        await expect(getHarness(createHarnessConfig(), platform, '/tmp/project')).rejects.toBeInstanceOf(MetroPortRangeExhaustedError);
+        expect(mocks.getBridgeServer).not.toHaveBeenCalled();
+        expect(mocks.getMetroInstance).not.toHaveBeenCalled();
+    });
     it('falls back to a default resource lock key for platforms without getResourceLockKey', async () => {
         const { serverBridge } = createBridgeServer();
         const appMonitor = createAppMonitor();

package/dist/__tests__/metro-port.test.d.ts

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

package/dist/__tests__/metro-port.test.d.ts.map

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

package/dist/__tests__/metro-port.test.js

@@ -0,0 +1,52 @@
+import { describe, expect, it, vi } from 'vitest';
+import { resolveHarnessMetroPort } from '../metro-port.js';
+const mocks = vi.hoisted(() => ({
+    isPortAvailable: vi.fn(async () => true),
+}));
+vi.mock('@react-native-harness/bundler-metro', () => ({
+    isPortAvailable: mocks.isPortAvailable,
+}));
+const createConfig = (overrides = {}) => ({
+    appRegistryComponentName: 'App',
+    bridgeTimeout: 60_000,
+    bundleStartTimeout: 60_000,
+    crashDetectionInterval: 500,
+    defaultRunner: 'ios-device',
+    detectNativeCrashes: true,
+    disableViewFlattening: false,
+    entryPoint: 'index.js',
+    forwardClientLogs: false,
+    maxAppRestarts: 2,
+    metroPort: 8081,
+    platformReadyTimeout: 300_000,
+    resetEnvironmentBetweenTestFiles: true,
+    runners: [],
+    unstable__enableMetroCache: false,
+    unstable__skipAlreadyIncludedModules: false,
+    ...overrides,
+});
+describe('resolveHarnessMetroPort', () => {
+    it('skips fallback allocation for iOS physical device runners', async () => {
+        const acquire = vi.fn();
+        const config = createConfig();
+        const platform = {
+            config: {},
+            name: 'ios-device',
+            platformId: 'ios',
+            runner: 'unused',
+        };
+        const result = await resolveHarnessMetroPort({
+            config,
+            platform,
+            resourceLockManager: {
+                acquire,
+            },
+            signal: new AbortController().signal,
+        });
+        expect(result.config).toBe(config);
+        expect(result.metroPortLease).toBeNull();
+        expect(result.didFallback).toBe(false);
+        expect(acquire).not.toHaveBeenCalled();
+        expect(mocks.isPortAvailable).not.toHaveBeenCalled();
+    });
+});

package/dist/__tests__/resource-lock.test.js

@@ -1,7 +1,7 @@
 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 { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { createResourceLockManager, hashResourceLockKey, } from '../resource-lock.js';
 describe('resource lock manager', () => {
     let rootDir;
@@ -100,4 +100,39 @@ describe('resource lock manager', () => {
         expect(owner.ticketId).not.toBe('stale-owner');
         await lease.release();
     });
+    it('keeps owner metadata valid when heartbeat writes overlap', async () => {
+        const manager = createResourceLockManager({
+            rootDir,
+            pollIntervalMs: 5,
+            heartbeatIntervalMs: 10,
+            staleLockTimeoutMs: 200,
+        });
+        const key = 'ios:simulator:iPhone 17 Pro:26.2';
+        const ownerFilePath = path.join(rootDir, hashResourceLockKey(key), 'owner.json');
+        const actualWriteFile = fs.writeFile.bind(fs);
+        const writeFileSpy = vi
+            .spyOn(fs, 'writeFile')
+            .mockImplementation(async (file, data, options) => {
+            if (typeof file === 'string' &&
+                file.startsWith(ownerFilePath) &&
+                file !== ownerFilePath) {
+                await new Promise((resolve) => setTimeout(resolve, 25));
+            }
+            return await actualWriteFile(file, data, options);
+        });
+        try {
+            const lease = await manager.acquire(key);
+            const initialOwner = JSON.parse(await fs.readFile(ownerFilePath, 'utf8'));
+            await new Promise((resolve) => setTimeout(resolve, 80));
+            for (let index = 0; index < 5; index += 1) {
+                const owner = JSON.parse(await fs.readFile(ownerFilePath, 'utf8'));
+                expect(owner.ticketId).toBe(initialOwner.ticketId);
+                await new Promise((resolve) => setTimeout(resolve, 10));
+            }
+            await lease.release();
+        }
+        finally {
+            writeFileSpy.mockRestore();
+        }
+    });
 });

package/dist/errors.d.ts

@@ -15,6 +15,11 @@ export declare class PlatformReadyTimeoutError extends HarnessError {
     readonly timeout: number;
     constructor(timeout: number);
 }
+export declare class MetroPortRangeExhaustedError extends HarnessError {
+    readonly initialPort: number;
+    readonly attempts: number;
+    constructor(initialPort: number, attempts: number);
+}
 export type NativeCrashPhase = 'startup' | 'execution';
 export type NativeCrashDetails = AppCrashDetails & {
     phase: NativeCrashPhase;

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,qCAAqC,CAAC;AAE7C,qBAAa,sBAAuB,SAAQ,YAAY;;CAKvD;AAED,qBAAa,mBAAoB,SAAQ,YAAY;aACvB,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAI/C;AAED,qBAAa,0BAA2B,SAAQ,YAAY;;CAK3D;AAED,qBAAa,yBAA0B,SAAQ,YAAY;aAC7B,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM;CAM5C;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,CAAC;AAEvD,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG;IACjD,KAAK,EAAE,gBAAgB,CAAC;CACzB,CAAC;AAmDF,qBAAa,gBAAiB,SAAQ,YAAY;aAE9B,YAAY,EAAE,MAAM;aACpB,OAAO,EAAE,kBAAkB;aAC3B,aAAa,CAAC,EAAE,MAAM;gBAFtB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,EAC3B,aAAa,CAAC,EAAE,MAAM,YAAA;IAOxC,IAAI,KAAK,qBAER;CACF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,qCAAqC,CAAC;AAE7C,qBAAa,sBAAuB,SAAQ,YAAY;;CAKvD;AAED,qBAAa,mBAAoB,SAAQ,YAAY;aACvB,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAI/C;AAED,qBAAa,0BAA2B,SAAQ,YAAY;;CAK3D;AAED,qBAAa,yBAA0B,SAAQ,YAAY;aAC7B,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM;CAM5C;AAED,qBAAa,4BAA6B,SAAQ,YAAY;aAE1C,WAAW,EAAE,MAAM;aACnB,QAAQ,EAAE,MAAM;gBADhB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM;CAQnC;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,CAAC;AAEvD,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG;IACjD,KAAK,EAAE,gBAAgB,CAAC;CACzB,CAAC;AAmDF,qBAAa,gBAAiB,SAAQ,YAAY;aAE9B,YAAY,EAAE,MAAM;aACpB,OAAO,EAAE,kBAAkB;aAC3B,aAAa,CAAC,EAAE,MAAM;gBAFtB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,EAC3B,aAAa,CAAC,EAAE,MAAM,YAAA;IAOxC,IAAI,KAAK,qBAER;CACF"}

package/dist/errors.js

@@ -28,6 +28,17 @@ export class PlatformReadyTimeoutError extends HarnessError {
         this.name = 'PlatformReadyTimeoutError';
     }
 }
+export class MetroPortRangeExhaustedError extends HarnessError {
+    initialPort;
+    attempts;
+    constructor(initialPort, attempts) {
+        const finalPort = initialPort + attempts - 1;
+        super(`Harness could not find an available Metro port in the range ${initialPort}-${finalPort}.`);
+        this.initialPort = initialPort;
+        this.attempts = attempts;
+        this.name = 'MetroPortRangeExhaustedError';
+    }
+}
 const buildNativeCrashMessage = ({ phase, summary, signal, exceptionType, processName, pid, stackTrace, artifactType, }) => {
     const lines = [
         phase === 'startup'

package/dist/harness.d.ts

@@ -18,6 +18,7 @@ export type HarnessRunState = {
 };
 export type Harness = {
     context: HarnessContext;
+    config: HarnessConfig;
     runTests: (path: string, options: HarnessRunTestsOptions) => Promise<TestSuiteResult>;
     ensureAppReady: (testFilePath: string) => Promise<void>;
     restart: (testFilePath?: string) => Promise<void>;

package/dist/harness.d.ts.map

@@ -1 +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;AAc/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,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;AAilBF,eAAO,MAAM,UAAU,GACrB,QAAQ,aAAa,EACrB,UAAU,eAAe,EACzB,aAAa,MAAM,KAClB,OAAO,CAAC,OAAO,CAYjB,CAAC"}
+{"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;AAomBF,eAAO,MAAM,UAAU,GACrB,QAAQ,aAAa,EACrB,UAAU,eAAe,EACzB,aAAa,MAAM,KAClB,OAAO,CAAC,OAAO,CAYjB,CAAC"}

package/dist/harness.js

@@ -7,8 +7,9 @@ import { PlatformReadyTimeoutError } from './errors.js';
 import { createCrashSupervisor, } from './crash-supervisor.js';
 import { createClientLogListener } from './client-log-handler.js';
 import path from 'node:path';
-import { logMetroCacheReused, logRunnerStarting, logRunnerStillWaitingInQueue, logRunnerWaitingInQueue, } from './logs.js';
+import { logMetroCacheReused, logMetroPortFallback, logRunnerStarting, logRunnerStillWaitingInQueue, logRunnerWaitingInQueue, } from './logs.js';
 import { createResourceLockManager } from './resource-lock.js';
+import { resolveHarnessMetroPort } from './metro-port.js';
 const harnessLogger = logger.child('runtime');
 const resourceLockManager = createResourceLockManager();
 export const maybeLogMetroCacheReuse = (config, platform, projectRoot) => {
@@ -137,12 +138,21 @@ const getHarnessInternal = async (config, platform, projectRoot, signal) => {
     }
     harnessLogger.debug('resource lock acquired for runner=%s key=%s', platform.name, resourceLockKey);
     try {
-        maybeLogMetroCacheReuse(config, platform, projectRoot);
+        const { config: runtimeConfig, metroPortLease, initialMetroPort, didFallback, } = await resolveHarnessMetroPort({
+            config,
+            platform,
+            resourceLockManager,
+            signal,
+        });
+        if (didFallback) {
+            logMetroPortFallback(initialMetroPort, runtimeConfig.metroPort);
+        }
+        maybeLogMetroCacheReuse(runtimeConfig, platform, projectRoot);
         const pluginAbortController = new AbortController();
         const pluginManager = createHarnessPluginManager({
-            plugins: (config.plugins ?? []),
+            plugins: (runtimeConfig.plugins ?? []),
             projectRoot,
-            config,
+            config: runtimeConfig,
             runner: platform,
             abortSignal: pluginAbortController.signal,
         });
@@ -182,7 +192,7 @@ const getHarnessInternal = async (config, platform, projectRoot, signal) => {
         };
         const serverBridge = await getBridgeServer({
             noServer: true,
-            timeout: config.bridgeTimeout,
+            timeout: runtimeConfig.bridgeTimeout,
             context,
         });
         harnessLogger.debug('starting Metro, platform runner, and bridge initialization');
@@ -192,7 +202,7 @@ const getHarnessInternal = async (config, platform, projectRoot, signal) => {
                 return await Promise.all([
                     getMetroInstance({
                         projectRoot,
-                        harnessConfig: config,
+                        harnessConfig: runtimeConfig,
                         websocketEndpoints: {
                             [HARNESS_BRIDGE_PATH]: serverBridge.ws,
                         },
@@ -201,11 +211,11 @@ const getHarnessInternal = async (config, platform, projectRoot, signal) => {
                         return instance;
                     }),
                     withPlatformReadyTimeout({
-                        timeout: config.platformReadyTimeout,
+                        timeout: runtimeConfig.platformReadyTimeout,
                         signal,
                         work: async () => {
                             return await import(platform.runner)
-                                .then((module) => module.default(platform.config, config, {
+                                .then((module) => module.default(platform.config, runtimeConfig, {
                                 signal,
                             }))
                                 .then((instance) => {
@@ -219,6 +229,7 @@ const getHarnessInternal = async (config, platform, projectRoot, signal) => {
             catch (error) {
                 await Promise.allSettled([
                     resourceLease.release(),
+                    metroPortLease?.release(),
                     serverBridge.dispose(),
                 ]);
                 throw error;
@@ -422,7 +433,7 @@ const getHarnessInternal = async (config, platform, projectRoot, signal) => {
         metroInstance.events.addListener(onMetroEvent);
         appMonitor.addListener(onAppMonitorEvent);
         harnessLogger.debug('registered runtime, bridge, and Metro listeners');
-        if (config.forwardClientLogs) {
+        if (runtimeConfig.forwardClientLogs) {
             metroInstance.events.addListener(clientLogListener);
             harnessLogger.debug('client log forwarding enabled');
         }
@@ -451,7 +462,7 @@ const getHarnessInternal = async (config, platform, projectRoot, signal) => {
             catch (error) {
                 hookError = error;
             }
-            if (config.forwardClientLogs) {
+            if (runtimeConfig.forwardClientLogs) {
                 metroInstance.events.removeListener(clientLogListener);
             }
             metroInstance.events.removeListener(onMetroEvent);
@@ -466,6 +477,7 @@ const getHarnessInternal = async (config, platform, projectRoot, signal) => {
                     serverBridge.dispose(),
                     platformInstance.dispose(),
                     metroInstance.dispose(),
+                    metroPortLease?.release(),
                 ]);
             }
             catch (error) {
@@ -527,9 +539,9 @@ const getHarnessInternal = async (config, platform, projectRoot, signal) => {
                 serverBridge,
                 platformInstance: platformInstance,
                 platformId: platform.platformId,
-                bundleStartTimeout: config.bundleStartTimeout ?? 60000,
-                readyTimeout: config.bridgeTimeout,
-                maxAppRestarts: config.maxAppRestarts ?? 2,
+                bundleStartTimeout: runtimeConfig.bundleStartTimeout ?? 60000,
+                readyTimeout: runtimeConfig.bridgeTimeout,
+                maxAppRestarts: runtimeConfig.maxAppRestarts ?? 2,
                 testFilePath,
                 crashSupervisor,
                 appLaunchOptions,
@@ -560,6 +572,7 @@ const getHarnessInternal = async (config, platform, projectRoot, signal) => {
         };
         return {
             context,
+            config: runtimeConfig,
             runTests: async (path, options) => {
                 await flushPendingHooks();
                 activeTestFilePath = path;

package/dist/logs.d.ts

@@ -8,5 +8,6 @@ export declare const logRunnerStillWaitingInQueue: (runner: HarnessPlatform) =>
 export declare const logRunnerStarting: (runner: HarnessPlatform) => void;
 export declare const logMetroPrewarmCompleted: (runner: HarnessPlatform) => void;
 export declare const logMetroCacheReused: (runner: HarnessPlatform) => void;
+export declare const logMetroPortFallback: (initialPort: number, selectedPort: number) => void;
 export declare const getErrorMessage: (error: HarnessError) => string;
 //# sourceMappingURL=logs.d.ts.map

package/dist/logs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAY3D,eAAO,MAAM,GAAG,GAAI,SAAS,MAAM,KAAG,IAErC,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,eAAe,KAAG,IAI1D,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,QAAQ,eAAe,KAAG,IAEjE,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,QAAQ,eAAe,KAAG,IAEjE,CAAC;AAEF,eAAO,MAAM,4BAA4B,GAAI,QAAQ,eAAe,KAAG,IAEtE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,eAAe,KAAG,IAE3D,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,QAAQ,eAAe,KAAG,IAElE,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,QAAQ,eAAe,KAAG,IAE7D,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,YAAY,KAAG,MAErD,CAAC"}
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAY3D,eAAO,MAAM,GAAG,GAAI,SAAS,MAAM,KAAG,IAErC,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,eAAe,KAAG,IAI1D,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,QAAQ,eAAe,KAAG,IAEjE,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,QAAQ,eAAe,KAAG,IAEjE,CAAC;AAEF,eAAO,MAAM,4BAA4B,GAAI,QAAQ,eAAe,KAAG,IAEtE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,eAAe,KAAG,IAE3D,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,QAAQ,eAAe,KAAG,IAElE,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,QAAQ,eAAe,KAAG,IAE7D,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,aAAa,MAAM,EACnB,cAAc,MAAM,KACnB,IAMF,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,YAAY,KAAG,MAErD,CAAC"}

package/dist/logs.js

@@ -30,6 +30,9 @@ export const logMetroPrewarmCompleted = (runner) => {
 export const logMetroCacheReused = (runner) => {
     log(`${TAG} Reusing Metro cache for ${chalk.bold(runner.name)}\n`);
 };
+export const logMetroPortFallback = (initialPort, selectedPort) => {
+    log(`${TAG} Harness could not use Metro port ${chalk.bold(String(initialPort))} and is using ${chalk.bold(String(selectedPort))} instead.\n`);
+};
 export const getErrorMessage = (error) => {
     return `${ERROR_TAG} ${error.message}\n`;
 };

package/dist/metro-port.d.ts

@@ -0,0 +1,16 @@
+import type { Config as HarnessConfig } from '@react-native-harness/config';
+import type { HarnessPlatform } from '@react-native-harness/platforms';
+import type { ResourceLease, ResourceLockManager } from './resource-lock.js';
+export declare const METRO_PORT_SCAN_ATTEMPTS = 10;
+export declare const resolveHarnessMetroPort: (options: {
+    config: HarnessConfig;
+    platform: HarnessPlatform;
+    resourceLockManager: ResourceLockManager;
+    signal: AbortSignal;
+}) => Promise<{
+    config: HarnessConfig;
+    metroPortLease: ResourceLease | null;
+    initialMetroPort: number;
+    didFallback: boolean;
+}>;
+//# sourceMappingURL=metro-port.d.ts.map

package/dist/metro-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metro-port.d.ts","sourceRoot":"","sources":["../src/metro-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAU3C,eAAO,MAAM,uBAAuB,GAAU,SAAS;IACrD,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;IAC1B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,MAAM,EAAE,WAAW,CAAC;CACrB,KAAG,OAAO,CAAC;IACV,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACtB,CAiDA,CAAC"}

package/dist/metro-port.js

@@ -0,0 +1,48 @@
+import { isPortAvailable } from '@react-native-harness/bundler-metro';
+import { MetroPortRangeExhaustedError } from './errors.js';
+export const METRO_PORT_SCAN_ATTEMPTS = 10;
+const getPortLockKey = (host, port) => {
+    return `metro-port:${host?.trim() || '*'}:${port}`;
+};
+const isIosPhysicalRunner = (platform) => {
+    return platform.platformId === 'ios' && platform.name.includes('device');
+};
+export const resolveHarnessMetroPort = async (options) => {
+    const { config, platform, resourceLockManager, signal } = options;
+    const initialMetroPort = config.metroPort;
+    const host = config.host?.trim();
+    if (isIosPhysicalRunner(platform)) {
+        return {
+            config,
+            metroPortLease: null,
+            initialMetroPort,
+            didFallback: false,
+        };
+    }
+    for (let attempt = 0; attempt < METRO_PORT_SCAN_ATTEMPTS; attempt += 1) {
+        const candidatePort = initialMetroPort + attempt;
+        const metroPortLease = await resourceLockManager.acquire(getPortLockKey(host, candidatePort), { signal });
+        try {
+            if (!(await isPortAvailable(candidatePort, host))) {
+                await metroPortLease.release();
+                continue;
+            }
+            return {
+                config: candidatePort === initialMetroPort
+                    ? config
+                    : {
+                        ...config,
+                        metroPort: candidatePort,
+                    },
+                metroPortLease,
+                initialMetroPort,
+                didFallback: candidatePort !== initialMetroPort,
+            };
+        }
+        catch (error) {
+            await metroPortLease.release();
+            throw error;
+        }
+    }
+    throw new MetroPortRangeExhaustedError(initialMetroPort, METRO_PORT_SCAN_ATTEMPTS);
+};

package/dist/resource-lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-lock.d.ts","sourceRoot":"","sources":["../src/resource-lock.ts"],"names":[],"mappings":"AAIA,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAiBzE,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,CACP,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,0BAA0B,KACjC,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7B,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C,CAAC;AAgBF,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,MAEjD,CAAC;AAoOF,eAAO,MAAM,yBAAyB,GACpC,UAAS,0BAA+B,KACvC,mBA2JF,CAAC"}
+{"version":3,"file":"resource-lock.d.ts","sourceRoot":"","sources":["../src/resource-lock.ts"],"names":[],"mappings":"AAIA,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAiBzE,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,CACP,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,0BAA0B,KACjC,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7B,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C,CAAC;AAgBF,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,MAEjD,CAAC;AAmPF,eAAO,MAAM,yBAAyB,GACpC,UAAS,0BAA+B,KACvC,mBAkKF,CAAC"}

package/dist/resource-lock.js

@@ -56,6 +56,17 @@ const readJsonFile = async (filePath) => {
         throw error;
     }
 };
+const writeJsonFileAtomic = async (filePath, value) => {
+    const tempPath = `${filePath}.${process.pid}.${crypto.randomUUID()}.tmp`;
+    try {
+        await fs.writeFile(tempPath, JSON.stringify(value), 'utf8');
+        await fs.rename(tempPath, filePath);
+    }
+    catch (error) {
+        await removeFileIfPresent(tempPath);
+        throw error;
+    }
+};
 const removeFileIfPresent = async (filePath) => {
     try {
         await fs.rm(filePath, { force: true });
@@ -189,6 +200,7 @@ export const createResourceLockManager = (options = {}) => {
             await fs.writeFile(ticketPath, JSON.stringify(metadata), 'utf8');
             scopedLogger.debug('queued ticket %s for key %s', ticketId, key);
             let heartbeatTimer = null;
+            let heartbeatInFlight = false;
             let released = false;
             let didNotifyWait = false;
             const waitStartedAt = Date.now();
@@ -210,20 +222,29 @@ export const createResourceLockManager = (options = {}) => {
             };
             const startHeartbeat = () => {
                 heartbeatTimer = setInterval(async () => {
-                    const nextHeartbeatAt = Date.now();
-                    const owner = await readJsonFile(paths.ownerFilePath);
-                    if (released || owner?.ticketId !== ticketId) {
+                    if (heartbeatInFlight) {
                         return;
                     }
-                    const nextMetadata = {
-                        ...owner,
-                        heartbeatAt: nextHeartbeatAt,
-                    };
-                    if (released) {
-                        return;
+                    heartbeatInFlight = true;
+                    try {
+                        const nextHeartbeatAt = Date.now();
+                        const owner = await readJsonFile(paths.ownerFilePath);
+                        if (released || owner?.ticketId !== ticketId) {
+                            return;
+                        }
+                        const nextMetadata = {
+                            ...owner,
+                            heartbeatAt: nextHeartbeatAt,
+                        };
+                        if (released) {
+                            return;
+                        }
+                        await writeJsonFileAtomic(paths.ownerFilePath, nextMetadata);
+                        scopedLogger.debug('refreshed heartbeat for ticket %s', ticketId);
+                    }
+                    finally {
+                        heartbeatInFlight = false;
                     }
-                    await fs.writeFile(paths.ownerFilePath, JSON.stringify(nextMetadata), 'utf8');
-                    scopedLogger.debug('refreshed heartbeat for ticket %s', ticketId);
                 }, heartbeatIntervalMs);
                 heartbeatTimer.unref?.();
             };

package/dist/setup.js

@@ -75,6 +75,6 @@ export const setup = async (globalConfig) => {
     const harness = await getHarness(harnessConfig, selectedRunner, globalConfig.rootDir);
     logTestEnvironmentReady(selectedRunner);
     setupLogger.debug('Harness instance is ready');
-    global.HARNESS_CONFIG = harnessConfig;
+    global.HARNESS_CONFIG = harness.config;
     global.HARNESS = harness;
 };