Flutter Firebase Auth integration compatibility
This page tracks an integration contract: unchanged Firebase code run through a Pyric runtime seam, so there is no separate Firebase public API to measure. The rows below are its signed behavior inventory.
Status legend
Conforming — containerized Dart test matches platform interface under replay
FirebaseAuthPlatform — instance & lifecycle
FirebaseAuthPlatform.instanceReturns the default platform instance registered via PlatformInterface.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#1.FirebaseAuthPlatform.instanceFor(app: app)Returns a platform instance associated with a specific FirebaseApp.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#2.FirebaseAuthPlatform.delegateFor(app: app)Creates an isolated platform instance sharing the bridge client for non-default apps.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#3.PyricFirebaseAuthPlatform.registerWith({bridgeClient})Registers PyricFirebaseAuthPlatform as the active platform interface singleton.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#4.FirebaseAuthPlatform.dispose()Disposes platform resources, canceling bridge subscriptions and closing reactive stream controllers.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#5.FirebaseAuthPlatform — user authentication
FirebaseAuthPlatform.signInWithEmailAndPassword(email, password)Authenticates user via bridge auth.signInEmail RPC and updates currentUser.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#6.FirebaseAuthPlatform.createUserWithEmailAndPassword(email, password)Registers user via bridge auth.createUser RPC and returns UserCredential with isNewUser: true.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#7.FirebaseAuthPlatform.signInAnonymously()Creates an anonymous session via bridge auth.signInAnonymously RPC.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#8.FirebaseAuthPlatform.signOut()Signs out active session via bridge auth.signOut RPC, clearing currentUser and emitting null on streams.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#9.FirebaseAuthPlatform.currentUserAccesses cached UserPlatform instance or null when unauthenticated.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#10.GoogleAuthProvider.credential({idToken, accessToken})Constructs an OAuthCredential for google.com with idToken and accessToken.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#49.OAuthProvider(providerId).credential({idToken, accessToken, rawNonce})Constructs a generic OAuthCredential with custom providerId, idToken, accessToken, and rawNonce.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#50.FirebaseAuthPlatform.signInWithCredential(credential)Authenticates user with an OAuthCredential via bridge auth.signInWithCredential RPC, updating currentUser and providerData.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#51.FirebaseAuthPlatform — reactive state streams
FirebaseAuthPlatform.authStateChanges()Broadcast Stream emitting UserPlatform upon sign-in/sign-out with immediate replay of current state.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#11.FirebaseAuthPlatform.idTokenChanges()Broadcast Stream emitting UserPlatform upon sign-in, sign-out, or token refresh with immediate replay.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#12.FirebaseAuthPlatform.userChanges()Broadcast Stream emitting UserPlatform upon user profile, claims, or auth transitions.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#13.FirebaseAuthPlatform.sendAuthChangesEvent(appName, userPlatform)Dispatches synthetic auth state updates across all stream controllers.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#14.Multi-tenancy & AuthLens integration
PyricAuthCredentialsProvider.currentAuthLensDerives active AuthLens (asUser with uid, tenant, and custom claims, or anon).
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#15.PyricAuthCredentialsProvider.authLensChangesEmits distinct AuthLens transitions driving Firestore operation stamping and listener re-subscription.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#16.AuthLens.asUser tenant claim isolationPropagates tenant ID to request.auth.token.firebase.tenant for multi-tenant Security Rules evaluation.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#17.AuthLens deep equality semanticsCompares token claims and tenant attributes by deep collection equality to avoid spurious re-subscriptions.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#18.Firestore snapshot re-subscription supervisorAutomatically re-subscribes active Firestore snapshot listeners under the new AuthLens upon auth transition.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#19.UserPlatform — identity properties & metadata
UserPlatform.uidReturns unique identifier string for the authenticated user.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#20.UserPlatform.emailReturns primary email address or null for anonymous users.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#21.UserPlatform.displayNameReturns profile display name string or null if unset.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#22.UserPlatform.photoURLReturns profile photo URL string or null if unset.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#23.UserPlatform.phoneNumberReturns associated phone number or null if unset.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#24.UserPlatform.isAnonymousReports true if user signed in anonymously, false otherwise.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#25.UserPlatform.emailVerifiedIndicates whether user email address has been verified.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#26.UserPlatform.tenantIdExposes Google Cloud Identity Platform tenant ID associated with user.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#27.UserPlatform.providerDataProvides List<UserInfo> detailing linked authentication providers.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#28.UserPlatform.metadataProvides creationTimestamp and lastSignInTimestamp wrapped in UserMetadata.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#29.UserPlatform — tokens & security context
UserPlatform.getIdToken([forceRefresh])Retrieves valid JWT ID token string from bridge, forcing refresh when requested.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#30.UserPlatform.getIdTokenResult([forceRefresh])Returns structured IdTokenResult containing decoded claims, expiration, and auth timestamps.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#31.UserPlatform.customClaimsExposes decoded custom claims map attached to user token identity.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#32.UserPlatform forced token refresh event dispatchDispatches auth change events across platform streams when token claims change upon forced refresh.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#33.UserPlatform — profile & account mutations
UserPlatform.updateProfile(profile)Updates displayName and photoURL via bridge RPC, refreshing cached currentUser and notifying listeners.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#34.UserPlatform.reload()Fetches latest user profile from bridge and updates active currentUser.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#35.UserPlatform.delete()Deletes authenticated user account via bridge RPC and clears currentUser.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#36.UserPlatform.updateEmail(newEmail)Updates user account email address via bridge RPC.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#37.UserPlatform.updatePassword(newPassword)Updates user account password via bridge RPC.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#38.UserCredentialPlatform & supporting models
UserCredentialPlatform.userExposes UserPlatform instance resulting from successful authentication.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#39.UserCredentialPlatform.additionalUserInfoProvides AdditionalUserInfo indicating whether authenticated user is a new user.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#40.InternalUserDetails wire deserializerDeserializes bridge user wire payload into InternalUserDetails and provider structures.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#41.Advanced auth & platform extensions
MultiFactorPlatform interface contractExposes stub MultiFactorPlatform for enrolled multi-factor inspection.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#42.FirebaseAuthPlatform.setLanguageCode(languageCode)Configures locale language code for out-of-band auth communications.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#43.FirebaseAuthPlatform.useAuthEmulator(host, port)Directs client auth operations to designated host and port emulator endpoint.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#44.FirebaseAuthPlatform.setPersistence(persistence)Configures session persistence mode across local storage or in-memory sessions.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#45.Error handling & wire codecs
FirebaseAuthException translationTranslates bridge RPC errors to typed FirebaseAuthException with normalized error codes.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#46.Bridge auth operation codecsEncodes and decodes auth.* RPC operations and subscription frames across WebSocket bridge.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#47.Remote client session isolationIsolates client auth state and token subscriptions to clientSessionId without mutating browser session.
firebase_auth_platform_interface specification. Container test:
packages/flutter-client/test/auth/conformance_test.dart assertion set auth-flutter#48.