Skip to content

feat: Upgrade Auth0.swift to v3.0.2 - #909

Open
NandanPrabhu wants to merge 6 commits into
develop/v3.0from
feat/auth0-swift-v3.0
Open

feat: Upgrade Auth0.swift to v3.0.2#909
NandanPrabhu wants to merge 6 commits into
develop/v3.0from
feat/auth0-swift-v3.0

Conversation

@NandanPrabhu

@NandanPrabhu NandanPrabhu commented Jul 28, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Summary

  • Upgraded Auth0.swift dependency from v2.x to v3.0.1 for iOS, macOS, tvOS, and watchOS
  • Updated all Darwin plugin method handlers to handle Auth0 v3 API changes
  • Updated test suite to match new Auth0.swift v3.0.1 signatures
  • Removed deprecated APIs and adapted to new error handling patterns

Key Changes

Dependency Updates

  • Updated podspec files to use Auth0.swift 3.0.2
  • Updated Swift Package Manager dependencies

API Migration

  • Error Handling: Migrated from .webAuthError() to .authenticationError() for WebAuth errors
  • Credentials Manager: Updated credential manager API calls for v3 signatures
  • Auth API: Adapted authentication API method handlers for new response types
  • MFA API: Updated multifactor authentication handlers
  • Passkey Support: Updated passkey credential exchange methods

Test Suite Updates

  • Updated test mocks and spies to match Auth0.swift v3.0.1 signatures
  • Fixed error handling assertions in test cases
  • Updated method signatures across all test files

Test Plan

  • All existing unit tests pass
  • iOS example app runs successfully
  • Login/logout flow works
  • Credentials manager operations work
  • MFA flows work correctly
  • Passkey authentication works

@coderabbitai

coderabbitai Bot commented Jul 28, 2026 •
edited
Loading

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

🗂️ Base branches to auto review (3)
  • main
  • beta-release/.*
  • release/.*

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 4afb484c-e36f-45d9-bd58-bfd5651a4214

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/auth0-swift-v3.0

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@NandanPrabhu NandanPrabhu changed the title feat: Upgrade Auth0.swift to v3.0.1 feat: Upgrade Auth0.swift to v3.0.2 Jul 30, 2026
@NandanPrabhu
NandanPrabhu marked this pull request as ready for review August 3, 2026 05:56
@NandanPrabhu
NandanPrabhu requested a review from a team as a code owner August 3, 2026 05:56
NandanPrabhu
NandanPrabhu commented Aug 3, 2026
View reviewed changes
Comment thread auth0_flutter/darwin/auth0_flutter/Sources/auth0_flutter/AuthAPI/AuthAPIHandler.swift Outdated
@NandanPrabhu
feat: upgrade Auth0.swift dependency to v3.0.1
01dfe0e 
Bumps the native iOS/macOS SDK dependency from 2.23.0 to 3.0.1 across
the podspecs, Package.swift, and Package.resolved lockfiles, and
updates every native call site for the v3 breaking changes: the
Authentication -> MFAClient split for OTP login/MFA challenge,
WebAuth.clearSession -> logout, CredentialsManager.store/clear
becoming throwing calls, CredentialsManager.user -> userProfile(),
UserInfo -> UserProfile, and Credentials.expiresIn -> expiresAt.

Also updates the Dart-facing multifactorChallenge API: authenticatorId
is now required and the types parameter is removed, since Auth0.swift
v3's MFAClient.challenge(with:mfaToken:) has no equivalent for
challenge-type filtering.
@NandanPrabhu
fix: complete Auth0.swift v3 migration for the darwin plugin and its …
1d577f9 
…test suite

Fixes a remaining compile error in WebAuthLoginMethodHandler.swift:
Auth0.swift v3 made WebAuthentication.safariProvider @MainActor-isolated,
which broke the default-argument closure and its call site. Also adds
UIScene support (SceneDelegate.swift + Info.plist manifest) and bumps
the example app's CocoaPods deployment target to 15.0, both needed to
actually launch the example app on current Xcode/iOS Simulator versions.

Migrates the darwin plugin's XCTest suite (previously untouched by the
v3 dependency bump) to the new SDK shape: Telemetry -> Auth0ClientInfo,
UserInfo -> UserProfile, expiresIn -> expiresAt, throwing
CredentialsStorage, Request<T,E> -> any Requestable/TokenRequestable
(via new MockRequest/MockTokenRequest test doubles), the Authentication
-> MFAClient split for OTP login and MFA challenge, and the new
WebAuthError cases. All 358 RunnerTests unit tests pass.
@NandanPrabhu
fix(macos): add missing MFA test files to macOS test target
dae61a6 
The macOS test target was missing 8 MFA-related test files that are
referenced by other test files. This caused compilation errors in
GitHub Actions when building macOS tests, specifically:
- SpyMFAClient not found (defined in MfaSpies.swift)
- Other MFA test infrastructure missing

Added the following test files to the macOS RunnerTests target:
- MfaSpies.swift
- MfaGetAuthenticatorsMethodHandlerTests.swift
- MfaEnrollTotpMethodHandlerTests.swift
- MfaEnrollPhoneMethodHandlerTests.swift
- MfaEnrollEmailMethodHandlerTests.swift
- MfaEnrollPushMethodHandlerTests.swift
- MfaChallengeMethodHandlerTests.swift
- MfaVerifyMethodHandlerTests.swift

These files already existed in the iOS test target and are shared
via relative path (../ios/Tests/Mfa/).
@NandanPrabhu
Fixes macOS unit tests
b78b3a2
@NandanPrabhu
NandanPrabhu force-pushed the feat/auth0-swift-v3.0 branch from 9c259b3 to b78b3a2 Compare August 3, 2026 08:33
utkrishtsahu
utkrishtsahu reviewed Aug 3, 2026
View reviewed changes
Comment thread auth0_flutter/darwin/auth0_flutter/Sources/auth0_flutter/AuthAPI/AuthAPIHandler.swift Outdated
utkrishtsahu
utkrishtsahu reviewed Aug 3, 2026
View reviewed changes
Comment thread auth0_flutter_platform_interface/lib/src/auth/auth_multifactor_challenge_options.dart Outdated
final String mfaToken;
final List<ChallengeType>? types;
final String? authenticatorId;
final String authenticatorId;

@utkrishtsahu utkrishtsahu Aug 3, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

authenticatorId is now required and types removed on the shared platform-interface, but only the Swift native side is updated to match. Android's MultifactorChallengeApiRequestHandler.kt still reads request.data["types"] and treats authenticatorId as optional — after this merges, every Android multifactorChallenge call receives types == null and a shape it doesn't expect. The Dart signature change and the Android handler need to move together.

@NandanPrabhu NandanPrabhu Aug 4, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is used in deprecated mfa present in authenticationclient which was removed in auth0.android v4. Will revert the change on dart side but this will go away when we will removed authclient mfa apis altogether as part of v3

utkrishtsahu
utkrishtsahu reviewed Aug 3, 2026
View reviewed changes
Comment thread auth0_flutter/darwin/auth0_flutter/Package.swift Outdated
utkrishtsahu
utkrishtsahu reviewed Aug 3, 2026
View reviewed changes
Comment thread auth0_flutter/darwin/auth0_flutter.podspec Outdated
@NandanPrabhu
Removes existing mfa flow from auth api handler. credential manager h…
88922ca 
…andlers now return flutter result on storing and clearing
@NandanPrabhu NandanPrabhu added v3.0 label for all the PR associated with v3.0 major release review:large Large review labels Aug 4, 2026
@NandanPrabhu
NandanPrabhu marked this pull request as draft August 4, 2026 03:15
@NandanPrabhu
NandanPrabhu marked this pull request as ready for review August 4, 2026 05:33
@NandanPrabhu
NandanPrabhu force-pushed the feat/auth0-swift-v3.0 branch from 4bfffce to 8d62a3c Compare August 4, 2026 06:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@utkrishtsahu utkrishtsahu Awaiting requested review from utkrishtsahu

Requested changes must be addressed to merge this pull request.

Assignees

No one assigned

Labels

review:large Large review v3.0 label for all the PR associated with v3.0 major release

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@NandanPrabhu @utkrishtsahu