build: require firebase ^12.18.0 and wrap the functions it adds

The generated src/<module>/firebase.ts files are written from the type
declarations of whatever firebase is installed, so the set of functions
AngularFire wraps is decided by the version the build resolves. That was
12.4.0 while npm latest reached 12.18.0, leaving newly added functions
reaching callers through the star export with no zone integration and no
pending-task registration.

Raising the required version wraps them. Everything the override entries
in #3759 classified as unwrapped stays out.

getImagenModel loses its entry because firebase removed the symbol in
12.18.0, so the generator no longer sees it. The exemption list it sat in
is empty now and stays as the place the next unclassified name goes.

Fixes #3756

Author: armando-navarro

docs/messaging.md

@@ -56,10 +56,11 @@ There are two parts to Firebase Messaging, a Service Worker and the DOM API. Ang
 It may be wise to use file replacements or environments here for different environments
 
 ```
-// This sample application is using 12.4.0, make sure you are importing the same version
+/* Replace <firebase-version> with the firebase version in your package.json. The service
+ * worker and your application have to load the same version. */
 
-import { initializeApp } from "https://www.gstatic.com/firebasejs/12.4.0/firebase-app.js";
-import { getMessaging } from "https://www.gstatic.com/firebasejs/12.4.0/firebase-messaging-sw.js";
+import { initializeApp } from "https://www.gstatic.com/firebasejs/<firebase-version>/firebase-app.js";
+import { getMessaging } from "https://www.gstatic.com/firebasejs/<firebase-version>/firebase-messaging-sw.js";
 
 const firebaseApp = initializeApp({
   apiKey: "",

docs/version-21-upgrade.md

@@ -11,7 +11,7 @@ ng update @angular/fire                 # then AngularFire 21
 
 `ng update @angular/fire` runs a migration that:
 
-- **Aligns your `firebase` dependency to `^12.4.0`.** AngularFire 21 requires Firebase JS SDK 12. If your app still requested `firebase` 11, npm would install both 11 and 12 side by side, and the two copies reject each other's objects at runtime. The migration updates the dependency and reinstalls so you end up with a single copy. Verify with `npm ls firebase`.
+- **Aligns your `firebase` dependency to `^12.18.0`.** AngularFire 21 requires Firebase JS SDK 12, at 12.18 or later. If your app requested an older `firebase`, whether that is 11 or an earlier 12, npm would install both that copy and the one AngularFire needs side by side, and the two copies reject each other's objects at runtime. The migration updates the dependency and reinstalls so you end up with a single copy. Verify with `npm ls firebase`.
 - **Rewrites Vertex AI imports to AI Logic** (see below).
 
 ## Vertex AI is now Firebase AI Logic

package-lock.json

@@ -62,7 +62,7 @@
     "@angular/router": "^21.0.0",
     "@schematics/angular": "^21.0.0",
     "esbuild": "^0.24.0",
-    "firebase": "^12.4.0",
+    "firebase": "^12.18.0",
     "firebase-admin": "^13.0.0",
     "firebase-functions": "^6.1.1",
     "fs-extra": "^8.0.1",

package.json

@@ -22,7 +22,7 @@
     "@angular/ssr": "^21.0.0",
     "cookie-parser": "^1.4.7",
     "express": "^5.1.0",
-    "firebase": "^12.4.0",
+    "firebase": "^12.18.0",
     "firebase-admin": "^13.0.1",
     "js-cookie": "^3.0.5",
     "rxjs": "~7.8.0",

sample/package-lock.json

@@ -41,7 +41,7 @@
     "typescript": { "optional": true }
   },
   "dependencies": {
-    "firebase": "^12.4.0",
+    "firebase": "^12.18.0",
     "rxfire": "^6.2.0",
     "@angular-devkit/architect": ">= 0.2100.0 < 0.2200.0",
     "@angular-devkit/core": "^21.0.0",

sample/package.json

@@ -1,18 +1,26 @@
 import { readFileSync } from 'fs';
 import { logging } from '@angular-devkit/core';
 import { HostTree, SchematicContext } from '@angular-devkit/schematics';
+import { minVersion as semverMinVersion } from 'semver';
 import { alignFirebaseVersion, firebaseVersionRange, pinInstalledPrereleaseVersion } from './common.js';
 import 'jasmine';
 
 const context = { logger: new logging.Logger('test') } as unknown as SchematicContext;
 
+// The version a workspace already declares, written into the test package.json below.
+const lowestRequiredVersion = semverMinVersion(firebaseVersionRange);
+if (!lowestRequiredVersion) {
+  throw new Error(`firebaseVersionRange ${firebaseVersionRange} matches no version`);
+}
+const alreadySupportedRange = `~${lowestRequiredVersion.version}`;
+
 const treeWithAngularFire = (declaredVersion: string, section = 'dependencies') => {
   const tree = new HostTree();
   tree.create('package.json', JSON.stringify({
     name: 'test-app',
     [section]: {
       '@angular/fire': declaredVersion,
-      firebase: '^12.4.0',
+      firebase: firebaseVersionRange,
     },
   }, null, 2));
   return tree;
@@ -40,7 +48,7 @@ describe('pinInstalledPrereleaseVersion', () => {
   it('leaves other dependencies untouched when pinning', () => {
     const tree = treeWithAngularFire('^21.0.0-rc.0');
     pinInstalledPrereleaseVersion(tree, context, '21.0.0-rc.0');
-    expect(dependenciesIn(tree).firebase).toBe('^12.4.0');
+    expect(dependenciesIn(tree).firebase).toBe(firebaseVersionRange);
   });
 
   it('leaves a stable caret range untouched', () => {
@@ -148,9 +156,9 @@ describe('alignFirebaseVersion', () => {
   });
 
   it('leaves a compatible range untouched', () => {
-    const tree = treeWithFirebase('^12.6.0');
+    const tree = treeWithFirebase(alreadySupportedRange);
     expect(alignFirebaseVersion(tree, context)).toBeFalse();
-    expect(dependenciesIn(tree).firebase).toBe('^12.6.0');
+    expect(dependenciesIn(tree).firebase).toBe(alreadySupportedRange);
   });
 
   it('adds firebase when the workspace has none', () => {
@@ -198,11 +206,11 @@ describe('alignFirebaseVersion', () => {
     const tree = new HostTree();
     tree.create('package.json', JSON.stringify({
       name: 'test-app',
-      dependencies: { firebase: '^12.6.0' },
+      dependencies: { firebase: alreadySupportedRange },
       devDependencies: { firebase: '^11.0.0' },
     }, null, 2));
     expect(alignFirebaseVersion(tree, context)).toBeTrue();
-    expect(dependenciesIn(tree).firebase).toBe('^12.6.0');
+    expect(dependenciesIn(tree).firebase).toBe(alreadySupportedRange);
     expect(sectionIn(tree, 'devDependencies').firebase).toBe(firebaseVersionRange);
   });
 

src/messaging/firebase.ts

@@ -72,10 +72,10 @@ export const addDependencies = (
   overwriteIfExists(host, 'package.json', stringifyFormatted(packageJson));
 };
 
-// Must stay identical to `dependencies.firebase` in `src/package.json`: if the two drift, the
-// alignment below can pin workspaces outside the range the library actually installs against,
-// re-creating the duplicate-SDK trees it exists to prevent.
-export const firebaseVersionRange = '^12.4.0';
+/* Must stay identical to `dependencies.firebase` in `src/package.json`: if the two drift, the
+ * alignment below can pin workspaces outside the range the library actually installs against,
+ * re-creating duplicate-SDK trees. */
+export const firebaseVersionRange = '^12.18.0';
 
 /**
  * Aligns the workspace's `firebase` entry with the range `@angular/fire` requires.