feat(android): add support for Firebase Phone Number Verification (PNV) by just1and0 · Pull Request #9045 · invertase/react-native-firebase

just1and0 · 2026-06-10T13:31:51Z

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

…r Verification (PNV) ## Summary 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 (`import { getVerifiedPhoneNumber } from '@react-native-firebase/phone-number-verification'`) APIs are supported. iOS gracefully rejects all calls with an "only supported on Android" error. Closes #9013

CLAassistant · 2026-06-10T13:32:06Z

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

…nvertase/react-native-firebase into feat/phone-number-verification

gemini-code-assist · 2026-06-10T13:53:47Z

Warning

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

Java formatting: the CI runs a formatter (google-java-format). Keep `rejectPromiseWithCodeAndMessage` calls on a single line — don't break across lines even if it's long.

e2e tests must NOT call `firebase.app()` directly — it triggers `Deprecated API usage detected while in strict mode`. Use the modular `getApp()` or module-specific getters (e.g., `getPhoneNumberVerification()`) instead.

- Remove namespaced API (lib/namespaced.ts, types/namespaced.ts, types/internal.ts) - Remove iOS native stubs (ios/, RNFBPnv.podspec) - Remove web fallback stubs (lib/web/) - Add react-native.config.js with ios: null to disable iOS autolinking - Rewrite modular.ts to call native module directly via getReactNativeModule - Add Platform.OS guard with clear error for non-Android - Remove phoneNumberVerification from KNOWN_NAMESPACES - Update e2e and local tests for standalone modular API

Adds documentation and discoverability for the phone-number-verification package per review feedback. - Add typedoc.json with entry points for API reference generation - Add package to root typedoc.json so `yarn reference:api` includes it - Add sidebar entry in docs.json for docs site navigation - Add docs page with installation, usage examples, testing, and platform handling - Update navigation chain (perf -> pnv -> vertexai) - Add README.md with standard badges and package description - Add CHANGELOG.md with initial entry

mikehardy

Really quick turn and handled all the code feedback, awesome

Bit more of a thought on constraining the API to modular-only
Augment API to expose all native SDK items
Augment docs to discuss geographic restrictions, error handling, and dev token setup
Looks like CLA is still blocked
results from testing on an emulator (showing error unsupported, then test mode success)
PR description no longer matches the implementation

- Remove getPhoneNumberVerification() convenience wrapper per modular-only API guidance - Remove PhoneNumberVerification interface from types - Rename e2e "iOS unsupported" to "only Android supported" and add Other platform test - Remove YouTube embed from docs (invalid video ID) - Add consent info to docs for getVerifiedPhoneNumber() - Remove convenience object section from docs - Clear CHANGELOG.md to stub for release automation

Bridge all fields from the native Firebase PNV SDK that were previously omitted. VerificationSupportResult now exposes simSlot, carrierId, and reason (mapped to VerificationSupportStatus strings). VerifiedPhoneNumberTokenResult now exposes expirationTimestamp, issuedAtTimestamp, nonce, and claims. Error handling extracts structured error codes from FirebasePhoneNumberVerificationException (9 SDK codes). Added getVerificationSupportInfo(simSlot) overload for querying specific SIM slots. Updated TypeScript types, e2e tests, local test app, and docs with error handling table, fallback examples, test-mode setup, and region/carrier limitations.

fix failing action

just1and0 requested review from InvertaseBot and mikehardy and removed request for InvertaseBot June 10, 2026 13:31

just1and0 changed the title ~~feat(phone-number-verification): add support for Firebase Phone Numbe…~~ feat(android): add support for Firebase Phone Numbe… Jun 10, 2026

just1and0 changed the title ~~feat(android): add support for Firebase Phone Numbe…~~ feat(android): add support for Firebase Phone Number Verification (PNV) Jun 10, 2026

just1and0 added 2 commits June 10, 2026 14:51

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

17a2ff5

Merge branch 'feat/phone-number-verification' of https://github.com/i…

cabc294

…nvertase/react-native-firebase into feat/phone-number-verification

just1and0 added 3 commits June 10, 2026 15:01

fix lint error

5efc577

fix Java formatting:

6ed8e44

Java formatting: the CI runs a formatter (google-java-format). Keep `rejectPromiseWithCodeAndMessage` calls on a single line — don't break across lines even if it's long.

This comment was marked as resolved.

Sign in to view

mikehardy removed the request for review from InvertaseBot June 10, 2026 22:25

mikehardy added Workflow: Waiting for User Response Blocked waiting for user response. type: enhancement Implements a new Feature plugin: phone-number-verification labels Jun 10, 2026

This comment was marked as resolved.

Sign in to view

mikehardy added the Blocked: Missing CLA label Jun 10, 2026

just1and0 added 2 commits June 11, 2026 12:08

mikehardy requested changes Jun 11, 2026

View reviewed changes

This comment was marked as resolved.

Sign in to view

github-actions Bot added the Needs Attention label Jun 11, 2026

just1and0 added 3 commits June 11, 2026 19:00

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

7e9957b

fix failing action

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

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

feat(android): add support for Firebase Phone Number Verification (PNV)#9045
just1and0 wants to merge 11 commits into
mainfrom
feat/phone-number-verification

just1and0 commented Jun 10, 2026 •

edited by mikehardy

Loading

Uh oh!

CLAassistant commented Jun 10, 2026

Uh oh!

gemini-code-assist Bot commented Jun 10, 2026

Uh oh!

This comment was marked as resolved.

Uh oh!

This comment was marked as resolved.

mikehardy left a comment •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as resolved.

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

just1and0 commented Jun 10, 2026 • edited by mikehardy Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Related issues

Release Summary

Checklist

Test Plan

Uh oh!

CLAassistant commented Jun 10, 2026

Uh oh!

gemini-code-assist Bot commented Jun 10, 2026

Uh oh!

This comment was marked as resolved.

Uh oh!

This comment was marked as resolved.

mikehardy left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as resolved.

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

just1and0 commented Jun 10, 2026 •

edited by mikehardy

Loading

mikehardy left a comment •

edited

Loading