Releases

This page summarizes the stable package release history for Firebase Dart Admin Auth SDK and keeps the public docs aligned with the published SDK versions. '''

1. v0.1.1

1.1. Overview

This release prepares the package for the next publish with sample-app cleanup, a new desktop admin example, and a compatible dependency refresh for the publishable package.

1.2. Highlights

  • Added a maintained Flutter desktop admin sample

  • Kept the maintained Flutter web sample building cleanly

  • Refreshed core package dependencies to newer compatible versions

1.3. Improvements

  • Added example/firebase-dart-admin-auth-sdk-flutter-desktop-app as a local desktop admin tool sample using initializeAppWithServiceAccount(…​).

  • Trimmed the sample matrix so only fitting backend/admin examples remain documented as maintained.

  • Updated googleapis_auth and jwt_generator to newer compatible releases in the publishable package.

1.4. Fixes

  • Restored sample compatibility with the legacy FirebaseApp.firebaseAuth accessor used by the maintained Flutter web sample.

  • Cleaned up the desktop sample shell so it analyzes and tests cleanly with responsive layout behavior.

2. v0.1.0

2.1. Overview

This release resets the package around a cleaner backend-first contract with keyless server credentials as the preferred initialization model.

2.2. Highlights

  • Added a preferred backend initializer for server credentials

  • Standardized keyless runtime identity and impersonation guidance

  • Tightened workload identity semantics so GCP-only setup remains explicit

2.3. Improvements

  • Added FirebaseApp.initializeAppWithServerCredentials(…​) as the recommended backend entry point.

  • Kept direct runtime identity and target service account impersonation under one server-side contract.

  • Updated auth and storage caching to be instance-scoped instead of relying on one shared static auth and storage object.

  • Reframed the README and package guidance around backend and admin use, not privileged client distribution.

2.4. Fixes

  • FirebaseApp.getStorage() now fails explicitly for unsupported server-credentials storage usage instead of crashing on a null API key.

  • Reduced cross-project and cross-app reuse risk by keeping cached SDK objects on the FirebaseApp instance.

  • Kept initializeAppWithWorkloadIdentity(…​) strict to metadata-backed GCP environments instead of silently expanding into generic ADC behavior.

3. v0.0.13

3.1. Overview

This release adds admin and server-side Firebase user lookup by UID for flows that need canonical user profile data after ID token verification.

3.2. Highlights

  • Added backend-safe lookup of Firebase users by UID

  • Supports admin SSO and similar flows when an ID token omits the email claim

3.3. Improvements

  • Added getUserByUid(String uid) on FirebaseAuth.

  • Returns a parsed User model when a matching Firebase Auth user exists.

  • Preserves existing behavior for session-bound and UID-based mutation helpers.

3.4. Fixes

  • Added unit coverage for UID-based lookup behavior and empty-result handling.

4. v0.0.12

4.1. Overview

This release adds explicit admin and server-side UID-based user mutation helpers for stateless backend flows.

4.2. Highlights

  • Added backend-safe UID-based delete support

  • Added backend-safe UID-based password update support

  • Kept client and session-bound mutation flows clearly separated

4.3. Improvements

  • Added deleteUserByUid(String uid) for admin and server flows that do not rely on a currentUser session.

  • Added updateUserPasswordByUid(String uid, String newPassword) for direct backend password rotation by UID.

  • Preserved the existing session-bound methods so frontend and authenticated-user flows continue to behave as before.

4.4. Fixes

  • Added unit coverage for the new UID-based delete and password update helpers.

5. v0.0.11

5.1. Overview

This release expands client MFA and 2FA support with real challenge handling, resolver completion, and enrollment helpers.

5.2. Highlights

  • Client MFA and 2FA sign-in challenge support

  • Real resolver completion backed by Identity Toolkit MFA endpoints

  • SMS and TOTP enrollment wrappers on FirebaseAuth

5.3. Improvements

  • Added structured MultiFactorError parsing for MFA-required sign-in flows.

  • Added MultiFactorResolver.startSignInChallenge() and real resolveSignIn() handling.

  • Added FirebaseAuth.startMfaEnrollment() and FirebaseAuth.finalizeMfaEnrollment() for SMS and TOTP enrollment.

  • Improved MFA enrollment parsing to preserve mfaEnrollmentId and infer factor type from mfaInfo.

5.4. Fixes

  • Replaced the previous MFA resolver stubbed sign-in flow with real finalize requests.

  • Restored executable MFA unit tests and a valid skipped integration placeholder.

  • Removed duplicate internal MFA type definitions in favor of a consolidated implementation.

6. v0.0.10

6.1. Overview

This release strengthens server-side Firebase authentication support with Workload Identity guidance, admin MFA helpers, and project-scoped admin API routing improvements.

6.2. Highlights

  • Workload Identity and Workforce Identity Federation documentation

  • Admin MFA inspection and enforcement helpers

  • Better routing for bearer-token admin API flows

6.3. Improvements

  • Added README guidance for Workload Identity on GKE, Cloud Run, and GCE.

  • Added Workforce Identity Federation setup guidance for external identity providers.

  • Added getMfaEnrollments, isMfaEnrolled, verifyIdTokenMfa, and enforceMfa.

  • Added an example showing admin API usage with Workload Identity.

6.4. Fixes

  • performRequest now uses project-scoped admin endpoints for server flows using bearer tokens without an API key.

  • Access token refresh now also works for Workload Identity flows when firebaseApp is present.

7. v0.0.9

7.1. Overview

This release aligns the SDK and sample app with the modern Dart toolchain and refreshed internal dependency versions.

7.2. Highlights

  • Dart SDK requirement bumped to ^3.11.0

  • Internal package dependency refresh

  • Example app dependency cleanup

7.3. Improvements

  • Updated the main package and example app to the newer Dart SDK baseline.

  • Upgraded ds_standard_features and ds_tools_testing.

  • Simplified example dependency declarations to reduce version drift.

8. v0.0.8

8.1. Overview

This release refines the internal create-user flow so account creation is more consistent with the shared request pipeline.

8.2. Highlights

  • Cleaner CreateUserWithEmailAndPasswordService internals

  • Better validation and logging

  • Expanded test and documentation support

8.3. Improvements

  • Simplified parameter handling and aligned response parsing with performRequest.

  • Improved validation and exception clarity for malformed credentials and Firebase API failures.

  • Added integration coverage and inline request and response documentation.

8.4. Fixes

  • Removed obsolete helper logic and leftover debug paths superseded by the shared request abstraction.

9. v0.0.7

9.1. Overview

This release continues the account-creation refactor by routing the signup flow through the shared request mechanism and improving internal construction of the returned user model.

9.2. Highlights

  • Signup flow now uses performRequest

  • Cleaner internal constructor usage

  • Improved debugging support during account creation

9.3. Improvements

  • Replaced manual HTTP request building with authInstance.performRequest('signUp', …​).

  • Improved internal User object construction and token assignment.

  • Added clearer debug logging around email, API key, and token handling.

10. v0.0.6

10.1. Overview

This release raises the package baseline for newer Dart versions and refreshes installation and example guidance.

10.2. Highlights

  • Updated Dart version guidance

  • Refreshed example package configuration

  • Updated public installation documentation

10.3. Improvements

  • Raised the minimum documented Dart version and aligned examples with the newer SDK baseline.

  • Simplified the example dependency declaration.

  • Updated the README installation snippet to the current package version at the time of release.

11. v0.0.5

11.1. Overview

This release focuses on dependency maintenance for the core SDK and testing toolchain.

11.2. Highlights

  • Refreshed standard dependency versions

  • Refreshed testing dependency versions

11.3. Improvements

  • Updated ds_standard_features to ^0.1.0.

  • Updated ds_tools_testing to ^0.0.9.

12. v0.0.4

12.1. Overview

This release continues dependency maintenance and adds the lints package to tighten local development quality checks.

12.2. Highlights

  • Core dependency updates

  • Testing dependency updates

  • Added lints

12.3. Improvements

  • Updated ds_standard_features to ^0.0.8.

  • Updated ds_tools_testing to ^0.0.5.

  • Added lints: ^6.0.0 to support stricter quality checks.

13. v0.0.3

13.1. Overview

This release refreshes internal HTTP utility dependencies and cleans up the example application layout.

13.2. Highlights

  • Updated HTTP utility dependency

  • Split example apps by platform

  • Removed generated example build artifacts

13.3. Improvements

  • Bumped ds_standard_features to a newer version.

  • Split the sample app into dedicated web and mobile example directories.

  • Removed generated build output from examples to keep the package leaner.

14. v0.0.2

14.1. Overview

This release stabilizes the first versioned package line with a Dart version bump, formatter cleanup, and license updates.

14.2. Highlights

  • Dart version bump

  • Formatting cleanup

  • License update

14.3. Improvements

  • Bumped the Dart baseline to 3.9.0.

  • Applied formatting cleanup to satisfy the Dart formatter.

  • Updated the BSD-3 license materials.

15. v0.0.1

15.1. Overview

This release establishes the first stable package version with the core authentication and credential-linking foundation for the SDK.

15.2. Highlights

  • Initial stable package baseline

  • Early credential-linking and sign-in flow refactors

  • Initial supporting UI and model cleanup

15.3. Improvements

  • Refactored unused code and comments in link_with_credientials.dart.

  • Introduced a dedicated sign-in with credential view model for improved separation of concerns.

  • Added a sign-in with popup screen and related auth flow groundwork.

  • Refined core FirebaseAuth and multi-factor related internals.

16. Pre-release History

16.1. Overview

Earlier pre-stable package builds are part of the SDK history and remain documented in the changelog while the stable sections above track the published 0.0.x line.

16.2. Included Pre-release Tags

  • 0.0.3-pre

  • 0.0.2-pre

  • 0.0.1-pre+22

  • 0.0.1-pre+21

  • 0.0.1-pre+20

  • 0.0.1-pre+19

  • 0.0.1-pre+18

  • 0.0.1-pre+17

  • 0.0.1-pre+16

  • 0.0.1-pre+15

  • 0.0.1-pre+14

  • 0.0.1-pre+13

  • 0.0.1-pre+12

  • 0.0.1-pre+10

  • 0.0.1-pre+9

  • 0.0.1-pre+8

  • 0.0.1-pre+7

  • 0.0.1-pre+6

  • 0.0.1-pre+5

  • 0.0.1-pre+4

  • 0.0.1-pre+3

  • 0.0.1-pre+2

  • 0.0.1-pre+1

  • 0.0.1-pre

16.3. Notes

  • Keep this page aligned with the version declared in pubspec.yaml.

  • Use CHANGELOG.md as the source of truth for exhaustive historical change notes, especially for the pre-release series.