chore: update lockfile

Author: V3RON

.changeset/configurable-metro-port.md

@@ -0,0 +1,7 @@
+---
+'@react-native-harness/jest': patch
+'@react-native-harness/platform-android': patch
+'@react-native-harness/platform-apple': patch
+---
+
+Adds support for configuring the Metro port in Harness, including CLI overrides via `--metroPort`. Harness now also restores Android and iOS simulator Metro connection settings on cleanup so normal dev-mode launches keep working after a test run.

.nx/version-plans/restore-startup-stall-recovery.md

@@ -0,0 +1,5 @@
+---
+__default__: patch
+---
+
+Harness now restores app startup stall recovery for RN-ready launches, including restart-between-files. Apps are retried when startup stalls without a crash, while confirmed native crashes still fail immediately with crash diagnostics.

actions/android/action.yml

@@ -22,6 +22,11 @@ inputs:
     required: false
     type: string
     default: ''
+  cacheAvd:
+    description: Whether to cache the AVD
+    required: false
+    type: boolean
+    default: 'true'
 runs:
   using: 'composite'
   steps:
@@ -68,6 +73,7 @@ runs:
         sudo udevadm trigger --name-match=kvm
         ls /dev/kvm
     - name: Compute AVD cache key
+      if: ${{ fromJSON(inputs.cacheAvd) }}
       id: avd-key
       shell: bash
       run: |
@@ -78,6 +84,7 @@ runs:
         CACHE_KEY="avd-$ARCH-$AVD_CONFIG_HASH"
         echo "key=$CACHE_KEY" >> $GITHUB_OUTPUT
     - name: Restore AVD cache
+      if: ${{ fromJSON(inputs.cacheAvd) }}
       uses: actions/cache/restore@v4
       id: avd-cache
       with:
@@ -86,7 +93,7 @@ runs:
           ~/.android/adb*
         key: ${{ steps.avd-key.outputs.key }}
     - name: Create AVD and generate snapshot for caching
-      if: steps.avd-cache.outputs.cache-hit != 'true'
+      if: ${{ fromJSON(inputs.cacheAvd) && steps.avd-cache.outputs.cache-hit != 'true' }}
       uses: reactivecircus/android-emulator-runner@v2
       with:
         api-level: ${{ fromJson(steps.load-config.outputs.config).config.device.avd.apiLevel }}
@@ -100,7 +107,7 @@ runs:
         emulator-options: -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none
         script: echo "Generated AVD snapshot for caching."
     - name: Save AVD cache
-      if: steps.avd-cache.outputs.cache-hit != 'true'
+      if: ${{ fromJSON(inputs.cacheAvd) && steps.avd-cache.outputs.cache-hit != 'true' }}
       uses: actions/cache/save@v4
       with:
         path: |

actions/shared/index.cjs

@@ -4209,6 +4209,7 @@ var coerce = {
 var NEVER = INVALID;
 
 // ../config/dist/types.js
+var DEFAULT_METRO_PORT = 8081;
 var RunnerSchema = external_exports.object({
   name: external_exports.string().min(1, "Runner name is required").regex(/^[a-zA-Z0-9._-]+$/, "Runner name can only contain alphanumeric characters, dots, underscores, and hyphens"),
   config: external_exports.record(external_exports.any()),
@@ -4221,12 +4222,11 @@ var ConfigSchema = external_exports.object({
   runners: external_exports.array(RunnerSchema).min(1, "At least one runner is required"),
   defaultRunner: external_exports.string().optional(),
   host: external_exports.string().min(1, "Host is required").optional(),
+  metroPort: external_exports.number().int("Metro port must be an integer").min(1, "Metro port must be at least 1").max(65535, "Metro port must be at most 65535").optional().default(DEFAULT_METRO_PORT),
   webSocketPort: external_exports.number().optional().default(3001),
   bridgeTimeout: external_exports.number().min(1e3, "Bridge timeout must be at least 1 second").default(6e4),
-  /** @deprecated Removed in favor of crash supervisor. Accepted for backwards compatibility. */
-  bundleStartTimeout: external_exports.number().optional(),
-  /** @deprecated Removed in favor of crash supervisor. Accepted for backwards compatibility. */
-  maxAppRestarts: external_exports.number().optional(),
+  bundleStartTimeout: external_exports.number().min(1e3, "Bundle start timeout must be at least 1 second").default(15e3),
+  maxAppRestarts: external_exports.number().min(0, "Max app restarts must be at least 0").default(2),
   resetEnvironmentBetweenTestFiles: external_exports.boolean().optional().default(true),
   unstable__skipAlreadyIncludedModules: external_exports.boolean().optional().default(false),
   unstable__enableMetroCache: external_exports.boolean().optional().default(false),
@@ -4413,20 +4413,6 @@ var import_node_path5 = __toESM(require("path"), 1);
 var import_node_fs5 = __toESM(require("fs"), 1);
 var import_node_module2 = require("module");
 var import_meta = {};
-var DEPRECATED_PROPERTIES = {
-  bundleStartTimeout: '"bundleStartTimeout" is no longer used and can be removed from your config. Startup crash detection is now handled automatically by the crash supervisor.',
-  maxAppRestarts: '"maxAppRestarts" is no longer used and can be removed from your config. Startup crash detection is now handled automatically by the crash supervisor.'
-};
-var warnDeprecatedProperties = (rawConfig) => {
-  if (typeof rawConfig !== "object" || rawConfig === null) {
-    return;
-  }
-  for (const [key, message] of Object.entries(DEPRECATED_PROPERTIES)) {
-    if (key in rawConfig) {
-      console.warn(`[react-native-harness] Deprecation warning: ${message}`);
-    }
-  }
-};
 var extensions = [".js", ".mjs", ".cjs", ".json"];
 var importUp = async (dir, name) => {
   const filePath = import_node_path5.default.join(dir, name);
@@ -4445,7 +4431,6 @@ var importUp = async (dir, name) => {
         throw new ConfigLoadError(filePathWithExt, error instanceof Error ? error : void 0);
       }
       try {
-        warnDeprecatedProperties(rawConfig);
         const config = ConfigSchema.parse(rawConfig);
         return { config, filePathWithExt, configDir: dir };
       } catch (error) {

packages/bundler-metro/src/constants.ts

@@ -5,7 +5,6 @@ import connect from 'connect';
 import nocache from 'nocache';
 import { isPortAvailable, getMetroPackage } from './utils.js';
 import { MetroPortUnavailableError } from './errors.js';
-import { METRO_PORT } from './constants.js';
 import type { MetroInstance, MetroOptions } from './types.js';
 import {
   type Reporter,
@@ -41,18 +40,19 @@ export const getMetroInstance = async (
   abortSignal: AbortSignal
 ): Promise<MetroInstance> => {
   const { projectRoot, harnessConfig } = options;
-  const isDefaultPortAvailable = await isPortAvailable(METRO_PORT);
+  const metroPort = harnessConfig.metroPort;
+  const isMetroPortAvailable = await isPortAvailable(metroPort);
 
-  if (!isDefaultPortAvailable) {
-    throw new MetroPortUnavailableError(METRO_PORT);
+  if (!isMetroPortAvailable) {
+    throw new MetroPortUnavailableError(metroPort);
   }
 
   const Metro = getMetroPackage(projectRoot);
 
   process.env.RN_HARNESS = 'true';
 
   const projectMetroConfig = await Metro.loadConfig({
-    port: METRO_PORT,
+    port: metroPort,
     projectRoot,
   });
   const config = await withRnHarness(projectMetroConfig, true)();
@@ -62,7 +62,7 @@ export const getMetroInstance = async (
 
   const middleware = connect()
     .use(nocache())
-    .use('/', getExpoMiddleware(projectRoot, harnessConfig.entryPoint))
+    .use('/', getExpoMiddleware(projectRoot, harnessConfig))
     .use('/status', getStatusMiddleware(projectRoot));
 
   const ready = waitForBundler(reporter, abortSignal);

packages/bundler-metro/src/factory.ts

@@ -1,10 +1,11 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
 import type { NextFunction } from 'connect';
+import type { Config as HarnessConfig } from '@react-native-harness/config';
 import crypto from 'node:crypto';
 import { getResolvedEntryPointWithoutExtension } from '../entry-point-utils.js';
 
 export const getExpoMiddleware =
-  (projectRoot: string, entryPoint: string) =>
+  (projectRoot: string, harnessConfig: HarnessConfig) =>
   (req: IncomingMessage, res: ServerResponse, next: NextFunction) => {
     if (req.url !== '/') {
       next();
@@ -14,7 +15,7 @@ export const getExpoMiddleware =
     const platform = req.headers['expo-platform'] as string;
     const resolvedEntryPoint = getResolvedEntryPointWithoutExtension(
       projectRoot,
-      entryPoint
+      harnessConfig.entryPoint
     );
 
     const manifestJson = JSON.stringify({
@@ -24,7 +25,7 @@ export const getExpoMiddleware =
       launchAsset: {
         key: 'bundle',
         contentType: 'application/javascript',
-        url: `http://localhost:8081/${resolvedEntryPoint}.bundle?platform=${platform}&dev=true&hot=false&lazy=true&transform.engine=hermes&transform.bytecode=1&transform.routerRoot=app&transform.reactCompiler=true&unstable_transformProfile=hermes-stable`,
+        url: `http://localhost:${harnessConfig.metroPort}/${resolvedEntryPoint}.bundle?platform=${platform}&dev=true&hot=false&lazy=true&transform.engine=hermes&transform.bytecode=1&transform.routerRoot=app&transform.reactCompiler=true&unstable_transformProfile=hermes-stable`,
       },
       assets: [],
       metadata: {},
@@ -35,7 +36,7 @@ export const getExpoMiddleware =
           version: '1.0.0',
         },
         expoGo: {
-          debuggerHost: 'localhost:8081',
+          debuggerHost: `localhost:${harnessConfig.metroPort}`,
           developer: {
             tool: 'expo-cli',
             projectRoot,

packages/bundler-metro/src/middlewares/expo-middleware.ts

@@ -1,9 +1,9 @@
-import { METRO_PORT } from './constants.js';
 import { getResolvedEntryPointWithoutExtension } from './entry-point-utils.js';
 
 type PrewarmOptions = {
   projectRoot: string;
   entryPoint: string;
+  port: number;
   platform: string;
   dev: boolean;
   minify: boolean;
@@ -13,7 +13,8 @@ type PrewarmOptions = {
 export const prewarmMetroBundle = async (
   options: PrewarmOptions
 ): Promise<void> => {
-  const { projectRoot, entryPoint, platform, dev, minify, signal } = options;
+  const { projectRoot, entryPoint, port, platform, dev, minify, signal } =
+    options;
   const resolvedEntryPoint = getResolvedEntryPointWithoutExtension(
     projectRoot,
     entryPoint
@@ -23,7 +24,7 @@ export const prewarmMetroBundle = async (
     dev: String(dev),
     minify: String(minify),
   });
-  const url = `http://localhost:${METRO_PORT}/${resolvedEntryPoint}.bundle?${searchParams.toString()}`;
+  const url = `http://localhost:${port}/${resolvedEntryPoint}.bundle?${searchParams.toString()}`;
 
   const response = await fetch(url, { signal });
 

packages/bundler-metro/src/prewarm.ts

@@ -1,5 +1,6 @@
 export { getConfig } from './reader.js';
 export type { Config } from './types.js';
+export { ConfigSchema, DEFAULT_METRO_PORT } from './types.js';
 export {
   ConfigValidationError,
   ConfigNotFoundError,

packages/config/src/index.ts

@@ -9,25 +9,6 @@ import fs from 'node:fs';
 import { createRequire } from 'node:module';
 import { ZodError } from 'zod';
 
-const DEPRECATED_PROPERTIES: Record<string, string> = {
-  bundleStartTimeout:
-    '"bundleStartTimeout" is no longer used and can be removed from your config. Startup crash detection is now handled automatically by the crash supervisor.',
-  maxAppRestarts:
-    '"maxAppRestarts" is no longer used and can be removed from your config. Startup crash detection is now handled automatically by the crash supervisor.',
-};
-
-const warnDeprecatedProperties = (rawConfig: unknown) => {
-  if (typeof rawConfig !== 'object' || rawConfig === null) {
-    return;
-  }
-
-  for (const [key, message] of Object.entries(DEPRECATED_PROPERTIES)) {
-    if (key in rawConfig) {
-      console.warn(`[react-native-harness] Deprecation warning: ${message}`);
-    }
-  }
-};
-
 const extensions = ['.js', '.mjs', '.cjs', '.json'];
 
 const importUp = async (
@@ -62,7 +43,6 @@ const importUp = async (
       }
 
       try {
-        warnDeprecatedProperties(rawConfig);
         const config = ConfigSchema.parse(rawConfig);
         return { config, filePathWithExt, configDir: dir };
       } catch (error) {