●Change8

Migrating to Firebase Auth firebase@12.0.0

Version firebase@12.0.0 introduces 4 breaking changes. This guide details how to update your code.

Released: 7/17/2025

4
Breaking Changes
5
Migration Steps
6
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

@firebase/aiVertexAIGroundingAttributionvertexaifunctionDeclaration.parametersinitializeServerApp

Breaking Changes

●Issue #1

The `VertexAI` APIs have been removed from @firebase/ai and firebase packages.

✓Solution

Users relying on the removed `VertexAI` APIs must find alternative implementations or update their logic.

●Issue #2

The `GroundingAttribution` class/export has been removed from @firebase/ai and firebase packages.

✓Solution

Update code that references `GroundingAttribution`.

●Issue #3

TS enums exports in Firebase AI have been converted into const variables.

✓Solution

If you were importing enums from Firebase AI, update imports to use the new const variable exports.

●Issue #4

The `vertexai` import path has been removed from the main `firebase` package.

✓Solution

If you were importing from `firebase/vertexai`, update your imports.

Migration Steps

  1. 1
    Review and remove any usage of the removed `VertexAI` APIs.
  2. 2
    Review and remove any usage of the removed `GroundingAttribution`.
  3. 3
    If using Firebase AI, update imports to use const variables instead of TS enums exports.
  4. 4
    If using Vertex AI imports from the main `firebase` package, remove the `vertexai` import path.
  5. 5
    Ensure your Node.js environment is version 20 or higher, as the minimum required version has been updated.

Release Summary

This major release (v12.0.0 for firebase, v2.0.0 for @firebase/ai) removes deprecated VertexAI APIs and GroundingAttribution, introduces support for anyOf schemas, and raises the minimum required Node.js version to 20.

Need More Details?

View the full release notes and all changes for Firebase Auth firebase@12.0.0.

View Full Changelog