Skip to content

Bridge FirebaseAuthException to an iOS-shaped NSError - #99

Merged
marcprux merged 1 commit into
skiptools:mainfrom
vincentborko:pr/auth-error-codes
Jul 25, 2026
Merged

Bridge FirebaseAuthException to an iOS-shaped NSError#99
marcprux merged 1 commit into
skiptools:mainfrom
vincentborko:pr/auth-error-codes

Conversation

@vincentborko

Copy link
Copy Markdown
Contributor

Android auth failures currently reach Swift as a bare ErrorException. Its localizedDescription is the generic bridge text (The operation could not be completed. (SwiftJNI.ThrowableError error 1.)), so a caller cannot tell "wrong password" from "email already in use" — and any message it derives from the error is wrong. On iOS the same failures carry FIRAuthErrorDomain plus a FIRAuthErrorCode, which is what cross-platform callers key off.

  • mapAuthNSError resolves FirebaseAuthException.getErrorCode() to the matching FIRAuthErrorCode raw value and keeps the Android message in NSLocalizedDescriptionKey, falling back to the exception class for unknown codes.
  • FirebaseNetworkException (not a FirebaseAuthException, no error code) maps to .networkError.
  • AuthErrorCode grows from one case to the resolvable set.
  • The mapping was only applied on the completion-handler paths; the async throws ones threw straight through. signIn(withEmail:), createUser(withEmail:), sendPasswordReset(withEmail:), User.sendEmailVerification(), User.reauthenticate(with:) and User.delete() now go through it too.

Mirrors asNSError(functionsException:) in SkipFirebaseFunctions (#95) and asNSError(firestoreException:) in SkipFirebaseFirestore.

Verified on an Android 16 emulator against a real Firebase project: sign-in with a wrong password, registration with an address already in use, and re-authentication with a wrong password each now arrive as FIRAuthErrorDomain with the code iOS reports for the same case. Nothing in the iOS path changes (the file is #elseif SKIP).

Android auth failures reached Swift as a bare `ErrorException`. Its
`localizedDescription` is the generic bridge text ("The operation could not
be completed. (SwiftJNI.ThrowableError error 1.)"), so a caller could not
tell "wrong password" from "email already in use" — and any message it
derived from the error was wrong. On iOS the same failures carry
`FIRAuthErrorDomain` plus a `FIRAuthErrorCode`, which is what cross-platform
callers key off.

`mapAuthNSError` now resolves `FirebaseAuthException.getErrorCode()` to the
matching `FIRAuthErrorCode` raw value and keeps the Android message in
`NSLocalizedDescriptionKey`, with a fallback on the exception class for
unknown codes. `FirebaseNetworkException` (not a FirebaseAuthException, no
error code) maps to `.networkError`. `AuthErrorCode` grows from one case to
the resolvable set.

The mapping was previously only applied on the completion-handler paths; the
`async throws` ones threw straight through. signIn(withEmail:),
createUser(withEmail:), sendPasswordReset(withEmail:),
User.sendEmailVerification(), User.reauthenticate(with:) and User.delete()
now go through it too.

Mirrors `asNSError(functionsException:)` in SkipFirebaseFunctions (skiptools#95) and
`asNSError(firestoreException:)` in SkipFirebaseFirestore.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MxxbQFDQyDkNvFMZaV5Aij
@cla-bot cla-bot Bot added the cla-signed label Jul 24, 2026
@marcprux
marcprux merged commit 5d3892d into skiptools:main Jul 25, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants