refactor(app-check)!: match AppCheck type with firebase-js-sdk

[russellwheatley]

Description

Updates to match firebase-js-sdk:

• breaking modular AppCheck now matches firebase-js-sdk (no instance methods); use modular functions like initializeAppCheck, getToken, getLimitedUseToken, setTokenAutoRefreshEnabled, onTokenChanged instead, matching firebase-js-sdk. See commit 423b3e915.
• breaking modular onTokenChanged callback result type changed from AppCheckListenerResult to AppCheckTokenResult. See commit 86982934a.
• breaking FirebaseApp is no longer exported from @react-native-firebase/app-check; import FirebaseApp from @react-native-firebase/app. See commit 423b3e915.
• breaking modular type exports no longer include the old statics-based surface (e.g. AppCheckStatics), aligning closer to firebase-js-sdk. See commit f5de6b89b.
• breaking FirebaseAppCheckTypes is now a type-only export (no runtime export); update any value imports to import type. See commit 540ee789f.
• Fix AI package required a tweak so app check type still showed as having getToken() method. See commit.
• chore provider classes were moved into lib/providers.ts (exports updated). See commit 76ab3a848.

Related issues

Release Summary

Checklist

• I read the Contributor Guide and followed the process outlined there for submitting PRs.
  • Yes
• My change supports the following platforms;
  • Android
  • iOS
  • Other (macOS, web)
• My change includes tests;
  • e2e tests added or updated in packages/\*\*/e2e
  • jest tests added or updated in packages/\*\*/__tests__
• I have updated TypeScript types that are affected by my change.
• This is a breaking change;
  • Yes
  • No

Test Plan

---

Think react-native-firebase is great? Please consider supporting the project with any of the below:

• 👉 Star this repo on GitHub ⭐️
• 👉 Follow React Native Firebase and Invertase on Twitter

---

Note

Medium Risk
Breaking API surface/type changes for App Check modular consumers (instance methods removed, listener callback type changed, exports moved), plus refactors to provider exports and internal typings; risk is mainly ecosystem breakage rather than runtime behavior.

Overview
Aligns @react-native-firebase/app-check modular API with the Firebase JS SDK by making modular AppCheck a lightweight handle (no instance methods) and requiring use of modular functions like initializeAppCheck, getToken, getLimitedUseToken, setTokenAutoRefreshEnabled, and onTokenChanged.

Updates App Check typing/exports: onTokenChanged modular callback now yields AppCheckTokenResult (not AppCheckListenerResult), FirebaseAppCheckTypes becomes a type-only export moved into types/namespaced, provider classes move to lib/providers.ts, and FirebaseApp is no longer exported from app-check (use @react-native-firebase/app). Documentation and migration guides are updated for v25, a new type-drift compare config is added for app-check, and the AI package’s App Check token hookup is adjusted to match the new type surface.

^{Reviewed by Cursor Bugbot for commit 28b725e. Bugbot is set up for automated code reviews on this repo. Configure here.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
react-native-firebase	Error		Apr 9, 2026 4:04pm

[mikehardy]

Code looks good - but the docs (migrating to v24 + AppCheck docs with our custom provider config info example etc) definitely need an update for this one or the support load in the area will stay high vs immediately going to zero

[github-actions]

Hello 👋, this PR has been opened for more than 14 days with no activity on it.

If you think this is a mistake please comment and ping a maintainer to get this merged ASAP! Thanks for contributing!

You have 7 days until this gets closed automatically

[codecov]

Codecov Report

❌ Patch coverage is 75.75758% with 8 lines in your changes missing coverage. Please review.
✅ Project coverage is 71.22%. Comparing base (96fad37) to head (540ee78).
⚠️ Report is 21 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #8889      +/-   ##
==========================================
- Coverage   74.84%   71.22%   -3.62%     
==========================================
  Files         213      264      +51     
  Lines        8966    13521    +4555     
  Branches     2081     3396    +1315     
==========================================
+ Hits         6710     9629    +2919     
- Misses       2185     3814    +1629     
- Partials       71       78       +7     

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.