GeezerVison

Checklist

• Issue number for this PR: Raise the firebase version AngularFire is built against, so functions added since 12.4.0 are wrapped #3756 (required)
• Docs included?: yes (docs/zones.md)
• Test units included?: no, see Testing below
• In a clean directory, yarn install, yarn test run successfully? yes, via the npm equivalents

Description

@angular/fire does not hand-write its wrapper files. tools/build.ts regenerates src/<module>/firebase.ts from the type declarations of whatever firebase is installed, wrapping every exported function whose name starts with a lowercase letter. Raising the installed version therefore wraps every function Firebase has added in between, all at once, whether or not wrapping does anything useful for a given one. #3756 has the background.

One of them does not merely gain nothing, it breaks. The auth persistence exports are classes, and Firebase constructs whichever one it is given with new. Wrapping replaces the class with an ordinary function, and calling it without new throws. #3550 is a user hitting exactly that on browserLocalPersistence, which is why that one and its three neighbors already carry an entry. browserCookiePersistence is the fifth, and it becomes visible when the version rises.

This PR settles the classification while the installed version is still 12.4.0, so the version raise stays a small change rather than a behavior change bundled with it. Nothing here alters generated output, because the generator builds its export list from the installed declarations, so an entry naming a symbol that version does not have is never consulted.

What each entry decides:

• maximum, minimum, getTemplateGenerativeModel and makeMemoryCacheProvider stay unwrapped. Each is synchronous, takes no callback and returns a plain value, so wrapping only adds an out-of-injection-context warning to a call that cannot destabilize anything.
• browserCookiePersistence stays unwrapped, for the new reason above.
• onRegistered and onUnregistered are wrapped with blockUntilFirst off, matching onMessage. With it on, subscribing registers a pending task that clears only when the callback fires or the caller unsubscribes, and these fire on a Cloud Messaging registration change that may never happen.
• unregister is quieted to match deleteToken. register keeps the default, matching its counterpart getToken.

Two supporting changes:

• tools/build.ts no longer runs itself on import, and exports the generator, so npm run generate can regenerate the files without ng build. That is what makes a regenerate-and-compare check runnable in CI.
• The generator now fails on an override key its entry point does not declare. Overrides are matched by name, so a misspelled or misfiled key is otherwise ignored in silence and the symbol quietly keeps the default. That had already happened once, and is fixed here.

Two smaller items ride along:

• ngPostUpdate, an ng update migration that took a Tree and returned it unchanged, is removed. It was registered in four places, one of which spelled it ng-post-upgate.
• docs/zones.md gains a section on what AngularFire asks Angular for when you call a wrapped API, and what is lost when that call happens outside an injection context. Firebase API called outside injection context - missing details on how to fix this #3629 asked for that detail.

Testing

No unit tests, because nothing here changes runtime behavior: the generated files are byte-identical before and after. The check that matters is that regenerating produces no diff, which is what shows the entries are inert against firebase 12.4.0.

npm run generate && git status --porcelain -- src/

That is empty on this branch. Two further results:

• Adding an entry that does change output produces the expected diff, so the check is capable of failing.
• Regenerating against firebase 12.18.0 in a scratch checkout changes only src/messaging/firebase.ts, and every entry lands as described above.

If any of this reads wrong to you, particularly the four I am leaving unwrapped, say so and I will revisit before the version raise goes up.

Refs #3756