Author: Firebase (https://firebase.google.com)
Description: Caches publicly available documents in Cloud Firestore data bundles that are served from either Firebase Hosting CDN or from Firebase storage
Details: Firestore data bundles can make certain types of Firestore applications much faster and/or less expensive. Data bundles are serialized groups of documents -- either individual documents, or a number of documents that you've retrieved using a specific query.
Bundles are useful when you want to cache publicly available documents that are read by all users of your app. Some common use cases include:
Kara’s Coffee, an online coffee shop built with Firebase Extensions, uses a Firestore bundle to cache its catalog of coffee offerings.
This extension simplifies the process of adding Cloud Firestore data bundles to your application. Once this extension is configured, you can generate bundles on demand via HTTP requests.
The extension serves these data bundles from either Firebase Hosting CDN (preferred) or from Firebase storage. You can load these bundles from your app and interact with the bundle data just like other data loaded from Firestore.
With bundles, you avoid making extra calls against the Firestore database. If your application has a substantial number of users, this can lead to cost savings and improved querying speeds.
Learn more about how this extension works and how to integrate it into your application by reading the official Firebase documentation for this extension.
Before installing this extension, you'll need to set up these services in your Firebase project:
To install an extension, your project must be on the Blaze (pay as you go) plan
Configuration Parameters:
Collection to store bundle specification documents: Path to the Firestore collection whose documents are specifications of bundles the extension will build.
Google Cloud Storage bucket to save the built bundle files: The Cloud Storage bucket to save the built bundle files. This applies when the bundle specification has fileCache
enabled.
Prefix to use for bundle files saved in Google Cloud Storage.: The prefix for all the bundle files built and saved in Cloud Storage. This applies when the bundle specification has fileCache
enabled.
Cloud Functions:
Access Required:
This extension will operate with the following project IAM roles:
datastore.user (Reason: Allows the extension to read configuration and build bundles from Firestore.)
storage.objectAdmin (Reason: Allows the extension to save built bundles in Cloud Storage)