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

BREAKING CHANGE: App/Core modules native bridge requires New Architecture.

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)).