●Change8

Migrating to Firebase SDK firebase@12.0.0

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

Released: 7/17/2025

6
Breaking Changes
4
Migration Steps
5
Affected Symbols

⚠️ Check Your Code

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

VertexAIGroundingAttributioninitializeServerAppfunctionDeclaration.parametersvertexai

Breaking Changes

●Issue #1

Removed VertexAI APIs from @firebase/ai; users must migrate to alternative AI modules.

●Issue #2

Removed vertexai import path from the main firebase package.

●Issue #3

Removed GroundingAttribution from @firebase/ai.

●Issue #4

Converted TypeScript enum exports in @firebase/ai into const variables, which may affect projects relying on enum-specific behavior like reverse mapping.

●Issue #5

Minimum Node.js version requirement increased to Node 20.

●Issue #6

Build targets updated to ES2020, which may break compatibility with older browsers or environments.

Migration Steps

  1. 1
    Update code to replace removed VertexAI APIs and the vertexai import path.
  2. 2
    Update any references to GroundingAttribution as it has been removed.
  3. 3
    Check TypeScript code for usage of @firebase/ai enums, as they are now const variables.
  4. 4
    Ensure deployment environments support ES2020 syntax.

Release Summary

Firebase JS SDK v12 introduces breaking changes to the AI module, including the removal of VertexAI APIs and GroundingAttribution, while adding support for Google Search grounding and Node 20.

Need More Details?

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

View Full Changelog