feat(android): add support for Firebase Phone Number Verification (PNV)

[just1and0]

Description

Adds a new @react-native-firebase/phone-number-verification package implementing the Firebase Phone Number Verification (PNV) SDK, which is now Generally Available.

PNV enables carrier-level phone number verification directly from the device's SIM — no SMS required. This is Android-only as the Firebase PNV SDK (com.google.firebase:firebase-pnv) has no iOS counterpart.

API:

• enableTestSession(token) — enable SIM-less testing with a Firebase Console token
• getVerificationSupportInfo() — check if the device's SIM supports PNV
• getVerifiedPhoneNumber() — full verification flow (consent UI + carrier check)
• getDigitalCredentialPayload(nonce) — for custom flows using Android Credential Manager
• exchangeCredentialResponseForPhoneNumber(dcApiResponse) — exchange a Credential Manager JWT for a verified phone number

Both namespaced (firebase.phoneNumberVerification()) and modular APIs are supported. iOS gracefully rejects all calls with an "only supported on Android" error.

Related issues

• Fixes Support for Firebase Phone Number Verification as it is generally available now #9013

Release Summary

Added @react-native-firebase/phone-number-verification — a new package for Firebase's Phone Number Verification (PNV) SDK. Supports carrier-level phone number verification on Android without SMS.

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

Tested on Android emulator via the manual test component at tests/local-tests/pnv/pnv-test.jsx:

• App launches without crash
• PNV test component renders with all three action buttons
• getVerificationSupportInfo() returns successfully with [{"isSupported": false}] (expected on emulator with no SIM)
• JS → Native bridge confirmed working end-to-end via logcat (fpnvgms: [FpnvImpl] FpnvImpl created)

Screen.Recording.2026-06-10.at.14.29.33.mov

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[gemini-code-assist]

Warning

Gemini encountered an error creating the summary. You can try again by commenting /gemini summary.

[mikehardy]

solid start - main things I see:

• should be modular only
• eliminate platforms that don't have implementations entirely, error at JS/TS layer
• no typedoc config for the package, so yarn reference:api won't build these types out into the reference API, looking at the generated reference docs to make sure they look good should be part of the implementation loop
• no docs.json entry for this new package, so it won't be discoverable, and no docs for it in general (README and CHANGELOG in the package itself, docs for it in the main docs tree. Should at least be a one-pager linking to the main upstream docs, embed their youtube, and show an example of how to use it from start to finish in a similar way to the upstream docs show android
• • looks like there may be a good icon for PNV (e.g. https://www.gstatic.com/mobilesdk/251124_mobilesdk/fpnv-image.png - this one is close but I bet they have one without the mobile on bottom right - we have been referencing the docs from static.invertase.io which probably doesn't have one, but a sidequest to update the icons there with fresh svgs and then reference the PNV one would be more professional if it were possible - you can see google has a suite of icons on this page https://firebase.google.com/products-build)

[mikehardy]

Two other notes

• Looks like you need to sign the CLA with a user that has the same email associated with it in github as was used in your commits
• Can you run the test app on a real phone? I don't think there is any proper way to test this except with a real phone - the test app should be connected to a project where PNV will work...I think

[mikehardy]

Really quick turn and handled all the code feedback, awesome

• Bit more of a thought on constraining the API to modular-only
• Thought on augmenting the doc just a touch
• Looks like CLA is still blocked
• Any results from an attempt to run the e2e app on real device? or are you iOS only locally? I can use a phone I have as a test sled if needed - I have an android with valid SIM
• PR description no longer matches the implementation

[just1and0]

I actually don't have a physical Android device to test it, I planned on popping out in a bit to go buy a small Android device to test. I'd be happy if you can help on this one so not to delay the work.

Thanks in advance 😁

Really quick turn and handled all the code feedback, awesome

• Bit more of a thought on constraining the API to modular-only

• Thought on augmenting the doc just a touch

• Looks like CLA is still blocked

• Any results from an attempt to run the e2e app on real device? or are you iOS only locally? I can use a phone I have as a test sled if needed - I have an android with valid SIM

• PR description no longer matches the implementation