Skip to content

Tags

Tags

22.0.0-rc.1

Toggle 22.0.0-rc.1's commit message

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
docs: document the 22.0.0-rc.1 changes (#3835)

* docs: say which wrapped calls do not hold the app unstable

docs/zones.md says callback APIs hold the app unstable until an initial
value, so a server render waits for data. #3827 makes a set of calls
exceptions because their first callback may never come. Waiting on a
callback that never comes would keep the app from ever becoming stable.

List those calls in docs/zones.md, and point at onValue, object, list,
listVal and fromRef with the value event as the calls that still make a
server render wait.

In docs/database.md, say the same under stateChanges, auditTrail and
fromRef.

Refs #3826

* docs: describe firebase 13 support in the v22 upgrade guide

#3831 lets AngularFire 22 accept firebase 12 or 13, and the ng update
migration now writes the range of the firebase major already installed.
The upgrade guide still said the migration writes ^12.18.0 and quoted
peer warnings that name only that range.

State the supported range and what the migration writes, update the
Yarn 1 and pnpm 9/10 warnings to their current wording, and add a
section on moving to firebase 13: VertexAIBackend is removed and its
packages declare Node 24.12 or later.

Refs #3830

* docs: describe microtask delivery in the v22 upgrade guide

#3833 moves every Observable read from a setInterval timer to the next
microtask checkpoint. As a breaking change it needs a section in the
upgrade guide: which tests now see a value they used to wait for, the
setTimeout ordering flip, and the zoneless server render case for
hand-written TransferState entries.

Refs #3832

* docs: describe the callback pending-task change in the v22 upgrade guide

#3837 removes a callback read's pending task right after the callback
instead of one setTimeout(fn, 0) delay later. As a breaking change it
needs a section in the upgrade guide: what moves sooner, and which
tests notice.

Refs #3836

* docs: say a handler passed as an observer object is wrapped too

#3829 wraps a handler passed as an observer object, such as { next, error }, the way it wraps a function, so the injection context reaches both forms.

Refs #3828

* docs(compat): add a setup section in NgModule and standalone form

The compat API's setup steps left docs/install-and-setup.md when #3236
rewrote it for the modular API, and nothing replaced them. docs/compat.md
had no setup at all, the Realtime Database pages pointed at an
"Installation guide" that no longer covered compat, and no page showed
the standalone form. A standalone app with only the modular providers
then fails its first compat injection with NG0201 for
angularfire2.app.options (#3683).

The new section on docs/compat.md gives both forms, says when the modular
providers may stay, states the error the missing module produces, and
lists the compat module of each product. The twelve compat pages that had
an NgModule-only snippet or no setup at all now point at it.

Fixes #3683

* docs: say which package managers refuse an incompatible firebase

The v22 upgrade guide said an incompatible firebase is refused at
install time. Only npm refuses it, and only when package.json requests
the incompatible version. Yarn and pnpm install it with a warning.

* docs: say which Firestore functions are not zone wrapped

#3842 re-exports Firestore's query and reference builders, field
values, comparators and setLogLevel without the zone wrapper. In
docs/zones.md, add a paragraph listing them, change the switchMap
example to a read, since building the query no longer warns, and say
the Verbose log level covers only wrapped calls.

Refs #3842

* docs(auth): build the server app with initializeBrowserOrServerApp

The server-rendering guide's step 4 becomes the one call, the five
details become three, the App Check token gets a relay section, the
response gets a Cache-Control header, and the manual callback stays in
a "Building the app yourself" section that step 4 points at, for apps
that prefer it or whose AngularFire version has no such function. The
release modes say what a throwing ngOnDestroy does to a timed release.

* docs(auth): describe the sample as an example of the one-call server app

The sample app now has one provideFirebaseApp with
initializeBrowserOrServerApp in its shared app.config.ts (#3845), so
the sentence about its split client and server files no longer holds.

Refs #3843

* docs: say how to move from 22.0.0-rc.0 in the v22 upgrade guide

The guide covered upgrades from 21, a 21 release candidate and a 22
canary build, but not from the first 22 release candidate. ng add saves
a prerelease as an exact version, so an app on 22.0.0-rc.0 stays there
until ng update @angular/fire@next moves it. That command also runs
migration-v22 again, which reports "No changes made" for a firebase
entry already inside the supported range.

Refs #3834

* docs(auth): say which hooks stop a releaseAfterRender release

The caveat on releaseAfterRender said a throwing ngOnDestroy "stops that
teardown". It now says the release is a DestroyRef.onDestroy callback,
that Angular runs it after every service's and component's ngOnDestroy,
and that an ngOnDestroy method or an ApplicationRef.onDestroy listener
that throws keeps it from running. The default release, which does not
run during the injector's destroy, is unaffected either way.

A new paragraph says to call initializeBrowserOrServerApp in
app.config.ts rather than a route's providers: a route's child injector
is not destroyed with the request, so a release registered there never
runs.

Refs #3844

* docs(auth): say the default release still happens from a route's providers

Tyler asked on #3844 whether the default release, now tied to a root
service, releases a server app built in a lazy route's providers. It
does: the request's root injector is destroyed, the route's child
injector is not, so only a releaseAfterRender release registered there
is lost. Checked with a child environment injector that is never
destroyed, in both modes.

Refs #3844

* docs: add onConfigUpdate to the calls that do not hold the app unstable

#3829 set onConfigUpdate to blockUntilFirst: false in tools/build.ts,
because its observer runs only when a fetched template differs from
the active one. The list in docs/zones.md left it out. Found in the
#3835 review.

Refs #3829

* docs(auth): say a second provideFirebaseApp can render signed out

The bullet said a second registration makes a signed-in render fail
on a freshly started server. With more than one registration,
FirebaseApp resolves to the default app. Run on fresh servers, a
second plain initializeApp(config) registration creates that app on
the first request, so signed-in pages render signed out with no
error. Only when no registration creates the default app, as with
two initializeBrowserOrServerApp registrations, does the render
fail, and only until a signed-out request creates it. Found in the
#3835 review.

Refs #3844

22.0.0-rc.0

Toggle 22.0.0-rc.0's commit message

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
docs(compat): state the compatibility API's support status (#3810)

* docs(compat): state the compatibility API's support status

docs/compat.md had no statement of whether @angular/fire/compat is
supported, and the v7 upgrade guide still told readers to stop at the
compatibility API because the modular API was not feature complete,
a sentence written for the 7.0 release.

The new section records the decision for 22: the compatibility API is
supported and kept working, its specs run in the same suite, it
receives bug fixes and no new features, and no removal is planned.
The v7 guide line now points at that section.

* docs(compat): mention the turned-off compat tests

The support section said the compatibility API is kept working, but
CI skips the tests for AngularFirestoreCollection,
AngularFirestoreCollectionGroup, AngularFirestoreDocument and one
Cloud Storage upload. The section now says so and links the issue
that tracks turning them back on.

21.0.0

Toggle 21.0.0's commit message

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
docs: describe AngularFire 21 as released, not as a release candidate (…

…#3813)

The docs on 21.0.x still install with @angular/fire@next, call 21 a
release candidate, and carry the AI-agent note for the firebase-tools
15.26 crash that #3769 fixed on this branch. The 21.0.0 tag is cut from
this branch, so its docs should describe the release.

The upgrade command keeps @angular/fire unversioned: only the first
@angular/ package in an ng update command picks the CLI that runs it.
The Node.js note gives the versioned form for updating AngularFire alone.

21.0.0-rc.2

Toggle 21.0.0-rc.2's commit message

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
docs(app-check): explain App Check during server rendering (#3775)

* docs(app-check): explain App Check during server rendering

The App Check guide said nothing about server-rendered apps. #3773
stops AngularFire from creating an App Check instance during server
rendering, so the new section explains that inject(AppCheck) is null
there, that Firebase requests made while rendering carry no App Check
token, and how to opt back in with APP_CHECK_ON_SERVER. It also shows
a browser-only config for 21.0.0-rc.1 and earlier, where the guide's
setup fails with "document is not defined".

* docs(app-check): use the dev-mode warning's wording in the SSR section

The warning AngularFire prints during server rendering says it skips App Check there. The section now opens with the same words, so a reader arriving from the console finds them.

20.1.1

Toggle 20.1.1's commit message
fix(auth): stop beforeAuthStateChanged from holding the app unstable (#…

…3770)

AngularFire wrapped beforeAuthStateChanged so that registering the
hook added a pending task, cleared only when the callback first runs.
Firebase runs that callback only on a sign-in or sign-out, so for a
visitor who does neither the app never became stable. Registered on
the server, it failed ng build during route extraction and left
server-rendered requests without a response.

This restores the blockUntilFirst: false override from #3590, which
#3613 dropped without comment while adding log-level overrides next
to it. The callback still runs inside Angular's zone and injection
context, and its returned promise still reaches Firebase, so a
rejection still cancels the sign-in. A call outside an injection
context now logs its per-call warning only at the verbose level, as
onMessage does.

Fixes #3748

docs(auth): scope the beforeAuthStateChanged note to rc.1 and earlier

Merging this change closes #3748, so the section's present-tense note
would point at a closed issue. Also removed the false claim that the
@angular/fire/auth import makes ng build hang: the guide registers the
hook only in the browser, so its own build succeeds.

The docs/auth.md change is left out, since it edits a section of the
guide that 20.1.x does not have.

(cherry picked from commit f182972)

20.1.0

Toggle 20.1.0's commit message
build: configure Google npm publishing service and pin CI actions for…

… v20.1.0 release

21.0.0-rc.1

Toggle 21.0.0-rc.1's commit message

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
chore: bump version to 21.0.0-rc.1 (#3751)

The publish job reads this literal at tag time. The sample's file:
tarball dependency path and its README install example carry the
same version, so they move together.

The root lockfile records the same version in its two version fields.
The sample's lockfile deliberately keeps the rc.0 tarball name, because
it also records that tarball's integrity hash.

20.0.3

Toggle 20.0.3's commit message
chore(release): 20.0.3

21.0.0-rc.0

Toggle 21.0.0-rc.0's commit message

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
Prep for AngularFire v21 (#3674)

- Bump all Angular dependencies to `^21.0.0` build to `~0.2100.0`
- Bump firebase to next major
- Drop vertexai
- Lots of lint and tsconfig drama
- Unbork Github Actions

20.0.1

Toggle 20.0.1's commit message

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
fix: Avoid handling promise rejections twice in stability helper (#3657)

`PendingTasks.run` reports rejections of the promise to the
`ErrorHandler`. This function already returns a promise that is meant to
be handled in the developer's application. If there _is_ handling there,
the rejection is handled both in the `PendingTasks.run` and in the
developer callsite.

This change updates the code to use `PendingTasks.add` instead, which
has no built in error handling mechanisms.

fixes angular/angular#61932