change(firestore): close Firestore instance more gracefully when "Clear Site Data" button pressed in browser

[dconeybe]

This PR is the 2nd in a chain of PRs (previous PR: #9087) that unify the logic that handles unexpected IndexedDB database deletion.

This PR enhances the robustness and user experience when the Firestore SDK's IndexedDB database is unexpectedly deleted, such as by a user clicking 'Clear Site Data' in their browser or another tab clearing persistence. It introduces a more granular event system for database deletion notifications, enabling the SDK to provide more informative error messages and ensure a more graceful termination process.

Highlights

• Improved IndexedDB Deletion Handling: Introduced specific event types (ClearSiteDataDatabaseDeletedEvent, VersionChangeDatabaseDeletedEvent) to differentiate between various IndexedDB database deletion scenarios, providing more context to the DatabaseDeletedListener.
• Enhanced Firestore Termination: Modified the setDatabaseDeletedListener to receive detailed event information, allowing for more specific logging and error handling during Firestore termination.
• Specific Error for 'Clear Site Data': When a 'Clear Site Data' event is detected, a FirestoreError of type failed-precondition is now thrown. This error provides a clear message to the user about potential IndexedDB corruption and suggests a page reload, and is thrown after attempting to terminate Firestore.
• Robust IndexedDB Open Logic: Refactored SimpleDb.open() to defer handling of 'Clear Site Data' detection from the onupgradeneeded event to the onsuccess event. This change prevents generic errors and allows for more precise and actionable error reporting to the databaseDeletedListener.

[changeset-bot]

🦋 Changeset detected

Latest commit: 51a279d

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages

Name	Type
@firebase/firestore	Patch
firebase	Patch
@firebase/firestore-compat	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[google-oss-bot]

Size Report ¹

Affected Products

• @firebase/firestore

  Type	Base (86155b3)	Merge (f682044)	Diff
  browser	395 kB	396 kB	+569 B (+0.1%)
  main	616 kB	617 kB	+733 B (+0.1%)
  module	395 kB	396 kB	+569 B (+0.1%)
  react-native	395 kB	396 kB	+563 B (+0.1%)

• bundle

  Type	Base (86155b3)	Merge (f682044)	Diff
  firestore (CSI Auto Indexing Disable and Delete)	291 kB	291 kB	+368 B (+0.1%)
  firestore (CSI Auto Indexing Enable)	291 kB	291 kB	+368 B (+0.1%)
  firestore (Persistence)	322 kB	322 kB	-33 B (-0.0%)
  firestore (Query Cursors)	260 kB	261 kB	+401 B (+0.2%)
  firestore (Query)	258 kB	258 kB	+401 B (+0.2%)
  firestore (Read data once)	248 kB	248 kB	+401 B (+0.2%)
  firestore (Read Write w Persistence)	342 kB	342 kB	+368 B (+0.1%)
  firestore (Realtime updates)	248 kB	249 kB	+401 B (+0.2%)
  firestore (Transaction)	227 kB	227 kB	+401 B (+0.2%)
  firestore (Write data)	228 kB	228 kB	+401 B (+0.2%)

• firebase

  Type	Base (86155b3)	Merge (f682044)	Diff
  firebase-compat.js	807 kB	807 kB	+348 B (+0.0%)
  firebase-firestore-compat.js	351 kB	352 kB	+348 B (+0.1%)
  firebase-firestore.js	459 kB	459 kB	+562 B (+0.1%)

Test Logs

• Base (86155b3): https://github.com/firebase/firebase-js-sdk/actions/runs/15859962192
• Merge (f682044): https://github.com/firebase/firebase-js-sdk/actions/runs/15879498755

1. https://storage.googleapis.com/firebase-sdk-metric-reports/ji2rTOxgBE.html

[google-oss-bot]

Size Analysis Report ¹

This report is too large (207,898 characters) to be displayed here in a GitHub comment. Please use the below link to see the full report on Google Cloud Storage.

Test Logs

• Base (86155b3): https://github.com/firebase/firebase-js-sdk/actions/runs/15859962192
• Merge (f682044): https://github.com/firebase/firebase-js-sdk/actions/runs/15879498755

1. https://storage.googleapis.com/firebase-sdk-metric-reports/dwtmKeTj5G.html