feat(messaging)!: migrate messaging to TurboModules

Convert the messaging native module to a Codegen TurboModule shell while
keeping the legacy event-emitter path in place per NewArch-AD-4. Method
calls now route through NativeRNFBTurboMessaging (iOS .mm shell, Android
spec-backed shell); event delivery continues over the app-module proxy so
foreground, background, and headless message handling are unchanged.

Add committed codegen artifacts, register messaging in codegen:verify and
the spec-native parity list, and remove the legacy Android module.

BREAKING CHANGE: messaging requires the React Native New Architecture.

Author: mikehardy

jest.setup.ts

@@ -401,12 +401,16 @@ jest.doMock('react-native', () => {
           getToken: jest.fn(),
           deleteInstallations: jest.fn(),
         },
-        RNFBMessagingModule: {
+        NativeRNFBTurboMessaging: {
+          getConstants: () => ({
+            isAutoInitEnabled: true,
+            isDeliveryMetricsExportToBigQueryEnabled: false,
+            isRegisteredForRemoteNotifications: false,
+            isNotificationDelegationEnabled: false,
+          }),
           isAutoInitEnabled: true,
           isDeliveryMetricsExportToBigQueryEnabled: false,
           isRegisteredForRemoteNotifications: false,
-          isNotificationDelegationEnabled: false,
-          onMessage: jest.fn(),
           completeNotificationProcessing: jest.fn(),
           setAutoInitEnabled: jest.fn(),
           getInitialNotification: jest.fn(() => Promise.resolve(null)),
@@ -425,6 +429,7 @@ jest.doMock('react-native', () => {
           subscribeToTopic: jest.fn(),
           unsubscribeFromTopic: jest.fn(),
           setDeliveryMetricsExportToBigQuery: jest.fn(),
+          isNotificationDelegationEnabled: jest.fn(() => Promise.resolve(false)),
           setNotificationDelegationEnabled: jest.fn(),
         },
         NativeRNFBTurboPerf: {

okf-bundle/new-architecture/migration-work-queue.md

@@ -8,7 +8,7 @@ timestamp: 2026-06-26T00:00:00Z
 
 # TurboModule migration — work queue
 
-> **IN PROGRESS (2026-07-02):** Phase **4** `messaging` TurboModule migration. P4a: **defer** events to Phase C ([ADR-4](architecture-decisions.md#newarch-ad-4--events-deferred-to-phase-c--accepted)).
+> **IN PROGRESS (2026-07-02):** Phase **4** — **next pickup:** `database` + remaining Tier A/B. P4m committed; P4a events deferred to Phase C ([ADR-4](architecture-decisions.md#newarch-ad-4--events-deferred-to-phase-c--accepted)).
 > **Goal/order:** app foundation → hard probe → easy wins → remaining complex → sync conversion → coordinated break → cleanup (events, shared-state encapsulation). Decisions: [architecture-decisions.md](architecture-decisions.md). Links: [implementation workflow](turbomodule-implementation-workflow.md), [change authoring](../testing/change-authoring-workflow.md), [functions reference](../../../packages/functions/) ([PR #8603](https://github.com/invertase/react-native-firebase/pull/8603)).
 
 Ephemeral tracker; see [OKF policy](../documentation-policy.md).
@@ -88,6 +88,8 @@ Follow-on **after** Phases 0–5 and coordinated break. Not in scope unless test
 
 **Deferral discriminator:** if **area-focused** e2e or device testing shows TurboModule migration **cannot** work with the legacy event proxy, escalate that package's event path into the active migration PR — do not wait for Phase C.
 
+**Messaging event-delivery e2e (Phase C — investigate before enabling):** `packages/messaging/e2e/messaging.e2e.js` foreground `onMessage()` delivery test stays **`xit`** (disabled since modular e2e consolidation, 2023). Un-skipping without a harness audit risks intermittent Android failures (`TestsAPI.messaging().sendToDevice` / FCM data payload; see [#8736](https://github.com/invertase/react-native-firebase/issues/8736), [#8670](https://github.com/invertase/react-native-firebase/issues/8670), [#8392](https://github.com/invertase/react-native-firebase/issues/8392)). Phase C must define stable pass criteria (device vs emulator, data-only vs notification+data, delegation settings) and broader event coverage (token refresh, notification-opened, iOS background timing vs `signalBackgroundMessageHandlerSet`) before re-enabling as a CI gate — per [NewArch-AD-4 § messaging testing requirement](architecture-decisions.md#messaging--defer-eventemitter-cutover-migrate-shell-only-in-phase-4).
+
 ---
 
 ## Package inventory
@@ -324,7 +326,7 @@ Skip steps 1–2 when spec shape is known (most Tier D packages).
 
 **Next item:** Phase **4** `messaging` TurboModule migration
 
-**Current gates:** P4m `implementation` — shell only per [ADR-4 § messaging](architecture-decisions.md#messaging--defer-eventemitter-cutover-migrate-shell-only-in-phase-4).
+**Current gates:** P4m committed. **Next:** Phase 4 `database` (or next Tier A/B item).
 
 **Host rule:** one `:test-cover` at a time — never parallel subagents with e2e.
 
@@ -354,7 +356,7 @@ Skip steps 1–2 when spec shape is known (most Tier D packages).
 | Phase S0 compare-types registration | S0 | **closed** | **closed** | **closed** | done | `none` (`compare:types`) | `chore(compare-types): register remaining migrated packages` | Committed 2026-07-01. 8 pkgs registered; compare:types 19/19 green. |
 | Phase 3.5 guardrails | P3.5 | **closed** | **closed** | **closed** | done | `full` | `fix: add codegen verify and spec-native parity tests` | Committed `64f99c53d` 2026-07-02. |
 | Phase 4a messaging event decision | P4a | n/a | n/a | n/a | done | `none` | none | **Defer** events to Phase C — [NewArch-AD-4 § messaging](architecture-decisions.md#messaging--defer-eventemitter-cutover-migrate-shell-only-in-phase-4). |
-| Phase 4 `messaging` TurboModules | P4m | **open** | open | open | **implementation** | `area-focused` | `feat(messaging)!: migrate messaging to TurboModules` | Shell only (P4a); area-focused e2e per ADR-4 testing requirement. |
+| Phase 4 `messaging` TurboModules | P4m | **closed** | **closed** | **closed** | done | `area-focused` | `feat(messaging)!: migrate messaging to TurboModules` | Turbo shell only (AD-4 event path preserved). Jest 38/38 + parity 32/32; codegen:verify incl messaging; legacy Java removed. iOS/Android area e2e green on method-call + listener-registration scope. Foreground `onMessage` delivery test **left `xit`** — flaky FCM harness; re-enable in [Phase C](#deferred-cleanup-phase-eventemitter). |
 | Phase Docs — NA reqs + consolidation | PDoc | open | open | open | documentation | `none` | `docs: new-architecture requirements + migration consolidation` | Opportunistic; does not gate 4. |
 | Phase PD — platform divergence | PPD | open | open | open | documentation | `none` | `docs(<pkg>): …` per package | Opportunistic; gap-analysis first. |
 | Phase R — remove `NativeModules` fallback | PR-fallback | open | open | open | pre-merge-validation | `full` | (Phase R) | Decision B. Jest + `app` e2e "unknown module throws". |

packages/app/__tests__/specNativeParityHelper.ts

@@ -21,6 +21,7 @@ export const MIGRATED_TURBO_PACKAGES = [
   'crashlytics',
   'storage',
   'functions',
+  'messaging',
 ] as const;
 
 export type MigratedTurboPackage = (typeof MIGRATED_TURBO_PACKAGES)[number];

packages/messaging/RNFBMessaging.podspec

@@ -10,6 +10,7 @@ if coreVersionDetected != coreVersionRequired
 end
 firebase_ios_target = appPackage['sdkVersions']['ios']['iosTarget']
 firebase_macos_target = appPackage['sdkVersions']['ios']['macosTarget']
+firebase_tvos_target = appPackage['sdkVersions']['ios']['tvosTarget']
 
 Pod::Spec.new do |s|
   s.name                = "RNFBMessaging"
@@ -25,15 +26,16 @@ Pod::Spec.new do |s|
   s.social_media_url    = 'http://twitter.com/invertaseio'
   s.ios.deployment_target = firebase_ios_target
   s.macos.deployment_target = firebase_macos_target
-  s.source_files        = 'ios/**/*.{h,m}'
+  s.tvos.deployment_target = firebase_tvos_target
+  s.source_files        = 'ios/**/*.{h,m,mm,cpp,swift}'
+  s.exclude_files       = 'ios/generated/RCTThirdPartyComponentsProvider.*', 'ios/generated/RCTAppDependencyProvider.*', 'ios/generated/RCTModuleProviders.*', 'ios/generated/RCTModulesConformingToProtocolsProvider.*', 'ios/generated/RCTUnstableModulesRequiringMainQueueSetupProvider.*'
 
   s.dependency          'RNFBApp'
 
-  # React Native dependencies
-  if defined?(install_modules_dependencies()) != nil
-    install_modules_dependencies(s);
-  else
-    s.dependency "React-Core"
+  install_modules_dependencies(s);
+
+  if defined?(ENV["RCT_NEW_ARCH_ENABLED"]) != nil && (ENV["RCT_NEW_ARCH_ENABLED"] == '0')
+     raise "#{s.name} requires New Architecture. Enable New Architecture to use this module"
   end
 
   if defined?($FirebaseSDKVersion)

packages/messaging/android/build.gradle

@@ -130,6 +130,12 @@ android {
       targetCompatibility = JavaVersion.VERSION_11
     }
   }
+
+  sourceSets {
+    main {
+      java.excludes = ['**/generated/jni/**']
+    }
+  }
 }
 
 repositories {
@@ -147,3 +153,21 @@ ReactNative.shared.applyPackageVersion()
 ReactNative.shared.applyDefaultExcludes()
 ReactNative.module.applyAndroidVersions()
 ReactNative.module.applyReactNativeDependency("api")
+
+def isNewArchitectureDisabled() {
+  return project.hasProperty("newArchEnabled") && project.newArchEnabled != "true"
+}
+
+if (isNewArchitectureDisabled()) {
+  def ANSI_RED = "\u001B[31m";
+  def ANSI_RESET = "\u001B[0m";
+
+  println("\n\n\n")
+  println(ANSI_RED + "**************************************************************************************************************")
+  println("\n\n\n")
+  println("New Architecture support is required for @react-native-firebase/messaging")
+  println("\n\n\n")
+  println("**************************************************************************************************************" + ANSI_RESET)
+  println("\n\n\n")
+  System.exit(1)
+}