fix(runtime): avoid HMRClient.disable startup race

React Native may throw "Expected HMRClient.setup()" if disable() runs before setup().

Retry disable() briefly on that specific invariant so harness startup stays stable.

Add a unit test for the retry helper.

Author: bheemreddy-samsara

packages/runtime/src/__tests__/initialize.test.ts

@@ -0,0 +1,23 @@
+import { describe, expect, it, vi } from 'vitest';
+
+import { disableHMRWhenReady } from '../disableHMRWhenReady.js';
+
+describe('initialize', () => {
+  it('retries HMRClient.disable until setup is ready', async () => {
+    vi.useFakeTimers();
+
+    const disable = vi
+      .fn()
+      .mockImplementationOnce(() => {
+        throw new Error('Expected HMRClient.setup() call at startup.');
+      })
+      .mockImplementationOnce(() => {
+        // ok
+      });
+
+    disableHMRWhenReady(disable, 50);
+    await vi.runAllTimersAsync();
+
+    expect(disable).toHaveBeenCalledTimes(2);
+  });
+});

packages/runtime/src/disableHMRWhenReady.ts

@@ -0,0 +1,20 @@
+export function disableHMRWhenReady(
+  disable: () => void,
+  retriesLeft: number,
+  schedule: (cb: () => void) => void = (cb) => setTimeout(cb, 0),
+) {
+  try {
+    disable();
+  } catch (error) {
+    if (
+      retriesLeft > 0 &&
+      error instanceof Error &&
+      error.message.includes('Expected HMRClient.setup() call at startup.')
+    ) {
+      schedule(() => disableHMRWhenReady(disable, retriesLeft - 1, schedule));
+      return;
+    }
+
+    throw error;
+  }
+}

packages/runtime/src/initialize.ts

@@ -1,5 +1,6 @@
 import { getDeviceDescriptor } from './client/getDeviceDescriptor.js';
 import { getClient } from './client/index.js';
+import { disableHMRWhenReady } from './disableHMRWhenReady.js';
 import { setupJestMock } from './jest-mock.js';
 
 // Polyfill for EventTarget
@@ -21,7 +22,7 @@ const HMRClient =
 
 // Wait for HMRClient to be initialized
 setTimeout(() => {
-  HMRClient.disable();
+  disableHMRWhenReady(() => HMRClient.disable(), 50);
 
   // Initialize the React Native Harness
   void getClient().then((client) =>