feat(app): migrate app modules to TurboModules incl general migration infra

Migrate RNFBAppModule and RNFBUtilsModule to Codegen TurboModules with
unified resolver, lazy Proxy wrapper, and committed generated artifacts.
Includes functions codegenConfig rename (NewArch-AD-7), test harness
overrides, architecture decisions, and validation workflow hardening.

Author: mikehardy

.gitignore

@@ -547,6 +547,8 @@ tests/ios/resetXcode.sh
 google-services.json
 GoogleService-Info.plist
 
+tests/harness.overrides.js
+
 # generated files
 RNFBVersion.m
 ReactNativeFirebaseVersion.java

jest.setup.ts

@@ -32,6 +32,12 @@ jest.doMock('react-native', () => {
         OS: 'android',
         select: () => {},
       },
+      TurboModuleRegistry: {
+        get: jest.fn(() => undefined),
+        getEnforcing: jest.fn(() => {
+          throw new Error('TurboModuleRegistry.getEnforcing: module not found');
+        }),
+      },
       AppRegistry: {
         registerHeadlessTask: jest.fn(),
       },
@@ -54,6 +60,73 @@ jest.doMock('react-native', () => {
           initiateOnDeviceConversionMeasurementWithPhoneNumber: jest.fn(),
           initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: jest.fn(),
         },
+        NativeRNFBTurboApp: {
+          getConstants: () => ({
+            NATIVE_FIREBASE_APPS: [
+              {
+                appConfig: {
+                  name: '[DEFAULT]',
+                },
+                options: {},
+              },
+              {
+                appConfig: {
+                  name: 'secondaryFromNative',
+                },
+                options: {},
+              },
+            ],
+            FIREBASE_RAW_JSON: '{}',
+          }),
+          NATIVE_FIREBASE_APPS: [
+            {
+              appConfig: {
+                name: '[DEFAULT]',
+              },
+              options: {},
+            },
+
+            {
+              appConfig: {
+                name: 'secondaryFromNative',
+              },
+              options: {},
+            },
+          ],
+          FIREBASE_RAW_JSON: '{}',
+          addListener: jest.fn(),
+          eventsAddListener: jest.fn(),
+          eventsNotifyReady: jest.fn(),
+          removeListeners: jest.fn(),
+        },
+        NativeRNFBTurboUtils: {
+          getConstants: () => ({
+            isRunningInTestLab: false,
+            MAIN_BUNDLE: '/',
+            CACHES_DIRECTORY: '/cache',
+            DOCUMENT_DIRECTORY: '/documents',
+            TEMP_DIRECTORY: '/tmp',
+            LIBRARY_DIRECTORY: '/library',
+            PICTURES_DIRECTORY: '/pictures',
+            MOVIES_DIRECTORY: '/movies',
+          }),
+          isRunningInTestLab: false,
+          MAIN_BUNDLE: '/',
+          CACHES_DIRECTORY: '/cache',
+          DOCUMENT_DIRECTORY: '/documents',
+          TEMP_DIRECTORY: '/tmp',
+          LIBRARY_DIRECTORY: '/library',
+          PICTURES_DIRECTORY: '/pictures',
+          MOVIES_DIRECTORY: '/movies',
+          androidGetPlayServicesStatus: jest.fn(() =>
+            Promise.resolve({
+              isAvailable: true,
+              status: 0,
+              hasResolution: false,
+              isUserResolvableError: false,
+            }),
+          ),
+        },
         RNFBAppModule: {
           NATIVE_FIREBASE_APPS: [
             {

okf-bundle/ci-workflows/ios.md

@@ -150,6 +150,8 @@ Long `datamigrator` activity with no `com.invertase.testing` means migration/pre
 
 Device type comes from `tests/.detoxrc.js`; boot script and Detox use it. No hard-coded UDID.
 
+**Missing Detox framework cache** — if iOS `:test-cover` fails before tests with `Detox.framework could not be found`, rebuild the local cache: [running e2e § iOS Detox framework cache](../testing/running-e2e.md#ios-detox-framework-cache-blocking) (`yarn tests:ios:detox-framework-cache:rebuild`). CI restores `~/Library/Detox/ios` from Actions cache keyed by Xcode version.
+
 ### Codecov (debug matrix only)
 
 Debug leg: `yarn tests:ios:test:process-coverage` + Codecov flags `e2e-ts-ios`, `ios-native`; `codecov/project/ios-native` blocks on missing native upload. Release skips coverage.

okf-bundle/namespace-api-removal-work-queue.md

@@ -40,7 +40,7 @@ Ephemeral tracker; see [OKF policy](documentation-policy.md). Work types / tiers
 
 Gate prerequisites before any `:test-cover` ([host rule](testing/change-authoring-workflow.md#host-rule)):
 
-1. [Pre-flight](testing/running-e2e.md#pre-flight-is-the-host-clear-to-start): [host-clear probes](testing/running-e2e.md#host-clear-probes), [services ready](testing/running-e2e.md#2-services-ready), [harness matches validation tier](testing/running-e2e.md#3-harness-matches-validation-tier) — [area harness: both platform blocks](testing/running-e2e.md#tests-app-js-area-harness); [narrowing gate](testing/running-e2e.md#harness-narrowing-gate-blocking) — **unit-focused** and **area-focused** only); [serial `:test-cover`](testing/running-e2e.md#serialized-e2e-dispatch); [frozen tree](testing/change-authoring-workflow.md#frozen-tree) for `independent-review`.
+1. [Pre-flight](testing/running-e2e.md#pre-flight-is-the-host-clear-to-start): [host-clear probes](testing/running-e2e.md#host-clear-probes), [services ready](testing/running-e2e.md#2-services-ready), [harness matches validation tier](testing/running-e2e.md#3-harness-matches-validation-tier) — [local harness overrides](testing/running-e2e.md#local-harness-overrides-harnessoverridesjs); [narrowing gate](testing/running-e2e.md#harness-narrowing-gate-blocking) — **unit-focused** and **area-focused** only); [serial `:test-cover`](testing/running-e2e.md#serialized-e2e-dispatch); [frozen tree](testing/change-authoring-workflow.md#frozen-tree) for `independent-review`.
 2. Per-module checklist and removal greps: [namespace-api-removal-workflow.md](namespace-api-removal-workflow.md). User-facing namespace removal: [Migrating to v26](/migrating-to-v26).
 
 ---

okf-bundle/namespace-api-removal-workflow.md

@@ -94,7 +94,7 @@ On a **frozen tree** — [change authoring § independent-review](testing/change
 
 ## Module area harness
 
-Extends [change authoring § harness narrowing](testing/change-authoring-workflow.md#harness-narrowing). **Mechanics:** [running e2e § area harness — two platform blocks](testing/running-e2e.md#tests-app-js-area-harness).
+Extends [change authoring § harness narrowing](testing/change-authoring-workflow.md#harness-narrowing). **Mechanics:** [running e2e § local harness overrides](testing/running-e2e.md#local-harness-overrides-harnessoverridesjs).
 
 When native e2e runs: load **only** the target package's e2e spec(s) in `tests/app.js`. Narrow **`platformSupportedModules` on both** `if (Platform.other)` and `if (!Platform.other)` (recommended: Pattern A — initial array + `if (false && …)` on **both** blocks). Set **`RNFBDebug = true`** locally per [running e2e § fail-fast](testing/running-e2e.md#fail-fast-rnfbdebug-and-sub-suite-narrowing) — **never commit** (`false` is the committed default). Revert **both** blocks before `commit` or **full** tier. Pass counts must match loaded scope — not full-app totals ([running e2e § gate](testing/running-e2e.md#harness-narrowing-gate-blocking), [platform coverage gate](testing/running-e2e.md#platform-coverage-gate-blocking)).