fix(ramps): show login-with-email action in unified buy v2 BasicInfo

[amitabh94]

Description

Unified Buy v2 (NativeFlow/BasicInfo) submits personal details via @metamask/ramps-controller, which throws TransakApiError with top-level errorCode and apiMessage. The screen was still checking a legacy Axios response shape, so Transak error code 2020 (phone already registered) was never detected and the Log in with email logout CTA stayed hidden.

This PR:

1. Detects phone-already-registered errors with isTransakPhoneRegisteredError and reads the user-facing message via getTransakApiMessage from @metamask/ramps-controller (MetaMask/core#9135).
2. Preserves quote context when routing back to Enter Email after logout so re-auth can resume the buy flow.
3. Bumps @metamask/ramps-controller to ^14.3.0 (core chore: Update dependabot.yml to use new team label #9135 shipped in 14.3.0).

Deposit v1 already handled 2020 via the legacy SDK/Axios path (#22183); this aligns UB2 with the controller error model.

Changelog

CHANGELOG entry: null

Related issues

Fixes: TRAM-3654

Manual testing steps

Feature: Unified Buy v2 phone already registered logout

  Scenario: user sees login-with-email when phone is registered to another account
    Given unified buy v2 is enabled and user is authenticated with email A
    And user reaches NativeFlow BasicInfo with a valid buy quote

    When user submits BasicInfo with a phone number already registered to email B
    Then an error banner is shown with localized phone-already-registered copy
    And a "Log in with email" action is visible

    When user taps "Log in with email"
    Then user is logged out of the Transak session
    And user is navigated to Enter Email with quote context preserved
    And user can authenticate with email B and continue the buy flow

Unit tests: yarn jest app/components/UI/Ramp/Views/NativeFlow/BasicInfo.test.tsx

RC QA: TestFlight build 5530 from fix/ub2-transak-phone-registered-logout (RC workflow run 27652822118).

Screenshots/Recordings

N/A — pending QA on RC TestFlight build 5530. Will attach before/after recordings once verified.

Before

ScreenRecording_06-15-2026.15-54-19_1.MP4

N/A

After

ScreenRecording_06-18-2026.14-10-51_1.MP4

N/A

Pre-merge author checklist

• I've followed MetaMask Contributor Docs and MetaMask Mobile Coding Standards.
• I've completed the PR template to the best of my ability
• I've included tests if applicable
• I've documented my code using JSDoc format if applicable
• I've applied the right labels on the PR (see labeling guidelines). Not required for external contributors.

Performance checks (if applicable)

• I've tested on Android
  • Ideally on a mid-range device; emulator is acceptable
• I've tested with a power user scenario
  • Use these power-user SRPs to import wallets with many accounts and tokens
• I've instrumented key operations with Sentry traces for production performance metrics
  • See trace() for usage and addToken for an example

For performance guidelines and tooling, see the Performance Guide.

Pre-merge reviewer checklist

• I've manually tested the PR (e.g. pull and build branch, run the app, test code being changed).
• I confirm that this PR addresses all acceptance criteria described in the ticket it closes and includes the necessary testing evidence such as recordings and or screenshots.

---

Note

Medium Risk
Changes buy-flow error handling and post-logout navigation in ramps KYC; scoped to one screen but affects recovery when phone conflicts with another Transak account.

Overview
Unified Buy v2 BasicInfo now treats Transak failures from @metamask/ramps-controller correctly instead of reading a legacy Axios response.data.error shape. Phone already registered (error 2020) is detected with isTransakPhoneRegisteredError, and copy comes from getTransakApiMessage, so the Log in with email banner action can appear when the phone is tied to another account.

After logout, navigation always goes through createV2EnterEmailNavDetails with quote fields (amount, currency, assetId, optional headlessSessionId) so users can re-auth and continue the buy. @metamask/ramps-controller is bumped to ^14.3.0; unit tests use TransakApiError and assert the logout button and post-logout navigation.

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

[github-actions]

CLA Signature Action: All authors have signed the CLA. You may need to manually re-run the blocking PR check if it doesn't pass in a few minutes.

[mm-token-exchange-service]

PR template — items to address before "Ready for review"

Warnings — informational, address before merging:

• Pre-merge author checklist has unchecked items (e.g. "I've documented my code using JSDoc format if applicable"). Every box must be consciously checked — see docs/readme/ready-for-review.md.

See docs/readme/ready-for-review.md for the full Definition of Ready for Review.

[amitabh94]

Tracks TRAM-3654 — Unified Buy v2: show login-with-email action for Transak phone-already-registered error.

[amitabh94]

Coordination

• Depends on core: MetaMask/core#9135 for TRANSAK_ERROR_CODES, isTransakPhoneRegisteredError, and related Transak error helpers.
• Jira: TRAM-3654
• Follow-up: After core is released and bumped in mobile, refactor to use controller exports instead of local parseTransakApiError.

[amitabh94]

Pushed preview wiring: @metamask-previews/ramps-controller@14.2.0-preview-69b6829ad (core #9135). Triggered main-rc build from this branch via Build Mobile App workflow.

[amitabh94]

@copilot resolve the merge conflicts in this pull request

[Copilot]

@copilot resolve the merge conflicts in this pull request

Resolved. The conflicts were in package.json and yarn.lock:

• package.json: kept ramps-controller: ^14.3.0 (our bump) and took profile-sync-controller: ^28.2.0 from main (the higher version).
• yarn.lock: resolved both profile-sync-controller and ramps-controller lockfile entries consistently with the above package versions — both still resolve to their same pinned versions (28.2.0 and 14.3.0 respectively).

All 26 BasicInfo unit tests continue to pass.

[codecov-commenter]

Codecov Report

❌ Patch coverage is 57.14286% with 3 lines in your changes missing coverage. Please review.
✅ Project coverage is 83.27%. Comparing base (981e9a2) to head (8c57e51).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
.../components/UI/Ramp/Views/NativeFlow/BasicInfo.tsx	57.14%	0 Missing and 3 partials ⚠️

Additional details and impacted files

@@           Coverage Diff           @@
##             main   #31580   +/-   ##
=======================================
  Coverage   83.27%   83.27%           
=======================================
  Files        5842     5843    +1     
  Lines      153510   153510           
  Branches    36220    36220           
=======================================
+ Hits       127829   127832    +3     
+ Misses      16916    16909    -7     
- Partials     8765     8769    +4     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

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

[github-actions]

🔍 Smart E2E Test Selection

• Selected E2E tags: SmokeAccounts, SmokeConfirmations, SmokeIdentity, SmokeNetworkAbstractions, SmokeNetworkExpansion, SmokeSwap, SmokeStake, SmokeWalletPlatform, SmokeMoney, SmokePerps, SmokeMultiChainAPI, SmokePredictions, SmokeSeedlessOnboarding, SmokeBrowser, SmokeSnaps
• Selected Performance tags: None (no tests recommended)
• Risk Level: high
• AI Confidence: 100%

click to see 🤖 AI reasoning details

E2E Test Selection:
Hard rule (controller-version-update): @MetaMask controller package version updated in package.json: @metamask/ramps-controller. Running all tests.

Performance Test Selection:
The changes are limited to error handling logic and navigation in the Transak KYC BasicInfo form, plus a minor ramps-controller package bump. These changes do not affect app launch, login, onboarding, asset loading, account list rendering, swaps, perps, or predictions performance. No performance-sensitive code paths are modified.

View GitHub Actions results

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

Measures
0 Security Hotspots
78.6% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud