@angular/fire 7.5.0 → 7.6.0-canary.34e89a4

package/README.md

@@ -3,7 +3,13 @@ The official [Angular](https://angular.io/) library for [Firebase](https://fireb
 
 <strong><pre>ng add @angular/fire</pre></strong>
 
-AngularFire smooths over the rough edges an Angular developer might encounter when implementing the framework-agnostic [Firebase JS SDK](https://github.com/firebase/firebase-js-sdk) & aims to provide a more natural developer experience by conforming to Angular conventions.
+_Note: If you want to ng add AngularFire and will be using Hosting/Cloud Functions, you need to configure the 
+Firebase CLI first so that you are logged in for the schematics that are run as part of `ng add @angular/fire`.
+Follow [this guide](docs/install-firebase-tools.md) to have the Firebase CLI walk you through the setup._
+
+AngularFire smooths over the rough edges an Angular developer might encounter when implementing the framework-agnostic 
+[Firebase JS SDK](https://github.com/firebase/firebase-js-sdk) & aims to provide a more natural developer experience 
+by conforming to Angular conventions.
 
 - **Dependency injection** - Provide and Inject Firebase services in your components
 - **Zone.js wrappers** - Stable zones allow proper functionality of service workers, forms, SSR, and pre-rendering
@@ -31,6 +37,7 @@ export class AppModule { }
 ```
 
 ```ts
+import { inject } from '@angular/core';
 import { Firestore, collectionData, collection } from '@angular/fire/firestore';
 import { Observable } from 'rxjs';
 
@@ -51,9 +58,11 @@ interface Item {
 })
 export class AppComponent {
   item$: Observable<Item[]>;
-  constructor(firestore: Firestore) {
-    const collection = collection(firestore, 'items');
-    this.item$ = collectionData(collection);
+  firestore: Firestore = inject(Firestore);
+
+  constructor() {
+    const itemCollection = collection(this.firestore, 'items');
+    this.item$ = collectionData(itemCollection);
   }
 }
 ```
@@ -66,6 +75,7 @@ AngularFire doesn't follow Angular's versioning as Firebase also has breaking ch
 
 | Angular | Firebase | AngularFire  |
 | --------|----------|--------------|
+| 16      | 9        | ^7.6         |
 | 15      | 9        | ^7.5         |
 | 14      | 9        | ^7.4         |
 | 13      | 9        | ^7.2         |
@@ -81,7 +91,7 @@ AngularFire doesn't follow Angular's versioning as Firebase also has breaking ch
 
 ### Polyfills
 
-Neither AngularFire or Firebase ship with polyfills. To have compatability across as wide-range of environments we suggest the following polyfills be added to your application:
+Neither AngularFire or Firebase ship with polyfills. To have compatibility across as wide-range of environments we suggest the following polyfills be added to your application:
 
 | API | Environments | Suggested Polyfill | License |
 |-----|--------------|--------------------|---------|
@@ -104,7 +114,7 @@ Neither AngularFire or Firebase ship with polyfills. To have compatability acros
 
 We have three sample apps in this repository:
 
-1. [`samples/compat`](samples/compat) a kitchen sink application that demonstrates use of the "compatability" API
+1. [`samples/compat`](samples/compat) a kitchen sink application that demonstrates use of the "compatibility" API
 1. [`samples/modular`](samples/modular) a kitchen sink application that demonstrates the new tree-shakable API
 1. [`samples/advanced`](samples/advanced) the same app as `samples/modular` but demonstrates more advanced concepts such as Angular Universal state-transfer, dynamically importing Firebase feature modules, and Firestore data bundling.
 
@@ -116,86 +126,97 @@ Get help on our [Q&A board](https://github.com/angular/angularfire/discussions?d
 
 ## Developer Guide
 
-AngularFire has a new tree-shakable API, however this is still under active development and documentation is in the works, so we suggest most developers stick with the Compatiability API for the time being. [See the v7 upgrade guide for more information.](docs/version-7-upgrade.md). 
-
-This developer guide assumes you're using the Compatiability API (`@angular/fire/compat/*`).
-
-### Monitor usage of your application in production
-
-> `AngularFireAnalytics` provides a convenient method of interacting with Google Analytics in your Angular application. The provided `ScreenTrackingService` and `UserTrackingService` automatically log events when you're using the Angular Router or Firebase Authentication respectively. [Learn more about Google Analytics](https://firebase.google.com/docs/analytics).
-
-- [Getting started with Google Analytics](docs/analytics/getting-started.md)
-
-### Interacting with your database(s)
-
-Firebase offers two cloud-based, client-accessible database solutions that support realtime data syncing. [Learn about the differences between them in the Firebase Documentation](https://firebase.google.com/docs/firestore/rtdb-vs-firestore).
-
-#### Cloud Firestore
-
-> `AngularFirestore` allows you to work with Cloud Firestore, the new flagship database for mobile app development. It improves on the successes of Realtime Database with a new, more intuitive data model. Cloud Firestore also features richer, faster queries and scales better than Realtime Database.
-
-- [Documents](docs/firestore/documents.md)
-- [Collections](docs/firestore/collections.md)
-- [Querying Collections](docs/firestore/querying-collections.md)
-- [Offline data](docs/firestore/offline-data.md)
-
-#### Realtime Database
-
-> `AngularFireDatabase` allows you to work with the Realtime Database, Firebase's original database. It's an efficient, low-latency solution for mobile apps that require synced states across clients in realtime.
-
-- [Objects](docs/rtdb/objects.md)
-- [Lists](docs/rtdb/lists.md)
-- [Querying lists](docs/rtdb/querying-lists.md)
-
-### Authenticate users
-
-- [Getting started with Firebase Authentication](docs/auth/getting-started.md)
-- [Route users with AngularFire guards](docs/auth/router-guards.md)
-
-### Local Emulator Suite
-
-- [Getting started with Firebase Emulator Suite](docs/emulators/emulators.md)
-
-### Upload files
-
-- [Getting started with Cloud Storage](docs/storage/storage.md)
-
-### Receive push notifications
-
-- [Getting started with Firebase Messaging](docs/messaging/messaging.md)
+This developer guide assimes you're using the new tree-shakable AngularFire API, [if you're looking for the compatability API you can find the documentation here](docs/compat.md).
 
-### **BETA:** Change behavior and appearance of your application without deploying
+[See the v7 upgrade guide for more information on this change.](docs/version-7-upgrade.md).
 
-> Firebase Remote Config is a cloud service that lets you change the behavior and appearance of your app without requiring users to download an app update. [Learn more about Remote Config](https://firebase.google.com/docs/remote-config).
+### Firebase product integrations
 
-- [Getting started with Remote Config](docs/remote-config/getting-started.md)
+<table>
+  <tr>
+    <td>
 
-### Monitor your application performance in production
-
-> Firebase Performance Monitoring is a service that helps you to gain insight into the performance characteristics of your iOS, Android, and web apps. [Learn more about Performance Monitoring](https://firebase.google.com/docs/perf-mon).
+#### [Analytics](docs/analytics.md#analytics)
+```ts
+import { } from '@angular/fire/analytics';
+```
+</td>
+    <td>
 
-- [Getting started with Performance Monitoring](docs/performance/getting-started.md)
+#### [Authentication](docs/auth.md#authentication)
+```ts
+import { } from '@angular/fire/auth';
+```
+</td>
+  </tr>
+  <tr>
+    <td>
 
-### Directly call Cloud Functions
+#### [Cloud Firestore](docs/firestore.md#cloud-firestore)
+```ts
+import { } from '@angular/fire/firestore';
+```
+</td>
+    <td>
 
-- [Getting started with Callable Functions](docs/functions/functions.md)
+#### [Cloud Functions](docs/functions.md#cloud-functions)
+```ts
+import { } from '@angular/fire/functions';
+```
+</td>
+  </tr>
+  <tr>
+    <td>
 
-### Deploying your application
+#### [Cloud Messaging](docs/messaging.md#cloud-messaging)
+```ts
+import { } from '@angular/fire/messaging';
+```
+</td>
+    <td>
 
-> Firebase Hosting is production-grade web content hosting for developers. With Hosting, you can quickly and easily deploy web apps and static content to a global content delivery network (CDN) with a single command.
+#### [Cloud Storage](docs/storage.md#cloud-storage)
+```ts
+import { } from '@angular/fire/storage';
+```
+</td>
+  </tr>
+  <tr>
+    <td>
 
-- [Deploy your application on Firebase Hosting](docs/deploy/getting-started.md)
+#### [Performance Monitoring](docs/performance.md#performance-monitoring)
+```ts
+import { } from '@angular/fire/performance';
+```
+</td>
+    <td>
 
-#### Server-side rendering
+#### [Realtime Database](docs/database.md#realtime-database)
+```ts
+import { } from '@angular/fire/database';
+```
+</td>
+  </tr>
+  <tr>
+    <td>
 
-> Angular Universal is a technology that allows you to run your Angular application on a server. This allows you to generate your HTML in a process called server-side rendering (SSR). AngularFire is compatible with server-side rendering; allowing you to take advantage of the Search Engine Optimization, link previews, the performance gains granted by the technology, and more. [Learn more about Angular Universal](https://angular.io/guide/universal).
+#### [Remote Config](docs/remote-config.md#remote-config)
+```ts
+import { } from '@angular/fire/remote-config';
+```
+</td>
+    <td>
 
-- [Getting started with Angular Universal](docs/universal/getting-started.md)
-- [Deploying your Universal application on Cloud Functions for Firebase](docs/universal/cloud-functions.md)
-- [Prerendering your Universal application](docs/universal/prerendering.md)
+#### [App Check](docs/app-check.md#app-check)
+```ts
+import { } from '@angular/fire/app-check';
+```
+</td>
+  </tr>
+</table>
 
-### Ionic
+### Deploying your site
 
-- [Installation and Setup with Ionic CLI](docs/ionic/cli.md)
-- [Using AngularFire with Ionic 2](docs/ionic/v2.md)
-- [Using AngularFire with Ionic 3](docs/ionic/v3.md)
+* Deploy to Firebase Hosting
+* Angular Universal: Deploy to Cloud Functions
+* Angular Universal: Deploy to Cloud Run

package/analytics/is-analytics-supported-factory.d.ts

@@ -0,0 +1,4 @@
+export declare const isAnalyticsSupportedFactory: {
+    async: () => any;
+    sync: () => any;
+};

package/bundles/angular-fire-analytics.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@angular/fire'), require('rxjs'), require('rxjs/operators'), require('@angular/core'), require('@angular/fire/app'), require('firebase/app'), require('@angular/router'), require('firebase/analytics'), require('@angular/platform-browser'), require('@angular/fire/auth')) :
-    typeof define === 'function' && define.amd ? define('@angular/fire/analytics', ['exports', '@angular/fire', 'rxjs', 'rxjs/operators', '@angular/core', '@angular/fire/app', 'firebase/app', '@angular/router', 'firebase/analytics', '@angular/platform-browser', '@angular/fire/auth'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory((global.angular = global.angular || {}, global.angular.fire = global.angular.fire || {}, global.angular.fire.analytics = {}), global.angular.fire, global.rxjs, global.rxjs.operators, global.ng.core, global.angular.fire.app, global.app, global.ng.router, global['firebase-analytics'], global.ng.platformBrowser, global.angular.fire.auth));
-}(this, (function (exports, fire, rxjs, operators, i0, app$1, app, i1$1, analytics, i2, i1) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@angular/fire'), require('rxjs'), require('rxjs/operators'), require('@angular/core'), require('@angular/fire/app'), require('firebase/app'), require('firebase/analytics'), require('@angular/router'), require('@angular/platform-browser'), require('@angular/fire/auth')) :
+    typeof define === 'function' && define.amd ? define('@angular/fire/analytics', ['exports', '@angular/fire', 'rxjs', 'rxjs/operators', '@angular/core', '@angular/fire/app', 'firebase/app', 'firebase/analytics', '@angular/router', '@angular/platform-browser', '@angular/fire/auth'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory((global.angular = global.angular || {}, global.angular.fire = global.angular.fire || {}, global.angular.fire.analytics = {}), global.angular.fire, global.rxjs, global.rxjs.operators, global.ng.core, global.angular.fire.app, global.app, global["firebase-analytics"], global.ng.router, global.ng.platformBrowser, global.angular.fire.auth));
+})(this, (function (exports, fire, rxjs, operators, i0, app$1, app, analytics, i1$1, i2, i1) { 'use strict';
 
     function _interopNamespace(e) {
         if (e && e.__esModule) return e;
@@ -13,14 +13,12 @@
                     var d = Object.getOwnPropertyDescriptor(e, k);
                     Object.defineProperty(n, k, d.get ? d : {
                         enumerable: true,
-                        get: function () {
-                            return e[k];
-                        }
+                        get: function () { return e[k]; }
                     });
                 }
             });
         }
-        n['default'] = e;
+        n["default"] = e;
         return Object.freeze(n);
     }
 
@@ -38,11 +36,11 @@
     var ANALYTICS_PROVIDER_NAME = 'analytics';
     var AnalyticsInstances = /** @class */ (function () {
         function AnalyticsInstances() {
-            return fire.ɵgetAllInstancesOf(ANALYTICS_PROVIDER_NAME);
+            return fire["ɵgetAllInstancesOf"](ANALYTICS_PROVIDER_NAME);
         }
         return AnalyticsInstances;
     }());
-    var analyticInstance$ = rxjs.timer(0, 300).pipe(operators.concatMap(function () { return rxjs.from(fire.ɵgetAllInstancesOf(ANALYTICS_PROVIDER_NAME)); }), operators.distinct());
+    var analyticInstance$ = rxjs.timer(0, 300).pipe(operators.concatMap(function () { return rxjs.from(fire["ɵgetAllInstancesOf"](ANALYTICS_PROVIDER_NAME)); }), operators.distinct());
 
     /*! *****************************************************************************
     Copyright (c) Microsoft Corporation.
@@ -356,17 +354,31 @@
         return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
     }
 
-    var isSupported = fire.ɵisAnalyticsSupportedFactory.async;
+    var isAnalyticsSupportedValueSymbol = '__angularfire_symbol__analyticsIsSupportedValue';
+    var isAnalyticsSupportedPromiseSymbol = '__angularfire_symbol__analyticsIsSupported';
+    globalThis[isAnalyticsSupportedPromiseSymbol] || (globalThis[isAnalyticsSupportedPromiseSymbol] = analytics.isSupported().then(function (it) { return globalThis[isAnalyticsSupportedValueSymbol] = it; }).catch(function () { return globalThis[isAnalyticsSupportedValueSymbol] = false; }));
+    var isAnalyticsSupportedFactory = {
+        async: function () { return globalThis[isAnalyticsSupportedPromiseSymbol]; },
+        sync: function () {
+            var ret = globalThis[isAnalyticsSupportedValueSymbol];
+            if (ret === undefined) {
+                throw new Error(fire["ɵisSupportedError"]('Analytics'));
+            }
+            return ret;
+        }
+    };
+
+    var isSupported = isAnalyticsSupportedFactory.async;
 
     // DO NOT MODIFY, this file is autogenerated by tools/build.ts
-    var getAnalytics = fire.ɵzoneWrap(analytics.getAnalytics, true);
-    var initializeAnalytics = fire.ɵzoneWrap(analytics.initializeAnalytics, true);
-    var logEvent = fire.ɵzoneWrap(analytics.logEvent, true);
-    var setAnalyticsCollectionEnabled = fire.ɵzoneWrap(analytics.setAnalyticsCollectionEnabled, true);
-    var setCurrentScreen = fire.ɵzoneWrap(analytics.setCurrentScreen, true);
-    var settings = fire.ɵzoneWrap(analytics.settings, true);
-    var setUserId = fire.ɵzoneWrap(analytics.setUserId, true);
-    var setUserProperties = fire.ɵzoneWrap(analytics.setUserProperties, true);
+    var getAnalytics = fire["ɵzoneWrap"](analytics.getAnalytics, true);
+    var initializeAnalytics = fire["ɵzoneWrap"](analytics.initializeAnalytics, true);
+    var logEvent = fire["ɵzoneWrap"](analytics.logEvent, true);
+    var setAnalyticsCollectionEnabled = fire["ɵzoneWrap"](analytics.setAnalyticsCollectionEnabled, true);
+    var setCurrentScreen = fire["ɵzoneWrap"](analytics.setCurrentScreen, true);
+    var settings = fire["ɵzoneWrap"](analytics.settings, true);
+    var setUserId = fire["ɵzoneWrap"](analytics.setUserId, true);
+    var setUserProperties = fire["ɵzoneWrap"](analytics.setUserProperties, true);
 
     var UserTrackingService = /** @class */ (function () {
         function UserTrackingService(auth, zone, injector) {
@@ -468,7 +480,7 @@
             }
             var component = actualSnapshot.component;
             if (component) {
-                if (component === i1$1.ɵEmptyOutletComponent) {
+                if (component === i1$1["ɵEmptyOutletComponent"]) {
                     var deepSnapshot = activationEnd.snapshot;
                     // TODO when might there be mutple children, different outlets? explore
                     while (deepSnapshot.firstChild) {
@@ -550,15 +562,15 @@
 
     var PROVIDED_ANALYTICS_INSTANCES = new i0.InjectionToken('angularfire2.analytics-instances');
     function defaultAnalyticsInstanceFactory(provided, defaultApp) {
-        if (!fire.ɵisAnalyticsSupportedFactory.sync()) {
+        if (!isAnalyticsSupportedFactory.sync()) {
             return null;
         }
-        var defaultAnalytics = fire.ɵgetDefaultInstanceOf(ANALYTICS_PROVIDER_NAME, provided, defaultApp);
+        var defaultAnalytics = fire["ɵgetDefaultInstanceOf"](ANALYTICS_PROVIDER_NAME, provided, defaultApp);
         return defaultAnalytics && new Analytics(defaultAnalytics);
     }
     function analyticsInstanceFactory(fn) {
         return function (zone, injector) {
-            if (!fire.ɵisAnalyticsSupportedFactory.sync()) {
+            if (!isAnalyticsSupportedFactory.sync()) {
                 return null;
             }
             var analytics = zone.runOutsideAngular(function () { return fn(injector); });
@@ -592,7 +604,7 @@
             ANALYTICS_INSTANCES_PROVIDER,
             {
                 provide: i0.APP_INITIALIZER,
-                useValue: fire.ɵisAnalyticsSupportedFactory.async,
+                useValue: isAnalyticsSupportedFactory.async,
                 multi: true,
             }
         ] });
@@ -604,7 +616,7 @@
                             ANALYTICS_INSTANCES_PROVIDER,
                             {
                                 provide: i0.APP_INITIALIZER,
-                                useValue: fire.ɵisAnalyticsSupportedFactory.async,
+                                useValue: isAnalyticsSupportedFactory.async,
                                 multi: true,
                             }
                         ]
@@ -630,7 +642,7 @@
                     deps: __spreadArray([
                         i0.NgZone,
                         i0.Injector,
-                        fire.ɵAngularFireSchedulers,
+                        fire["ɵAngularFireSchedulers"],
                         app$1.FirebaseApps
                     ], __read(deps))
                 }]
@@ -657,17 +669,15 @@
     exports.setUserId = setUserId;
     exports.setUserProperties = setUserProperties;
     exports.settings = settings;
-    exports.ɵscreenViewEvent = ɵscreenViewEvent;
+    exports["ɵscreenViewEvent"] = ɵscreenViewEvent;
     Object.keys(analytics).forEach(function (k) {
         if (k !== 'default' && !exports.hasOwnProperty(k)) Object.defineProperty(exports, k, {
             enumerable: true,
-            get: function () {
-                return analytics[k];
-            }
+            get: function () { return analytics[k]; }
         });
     });
 
     Object.defineProperty(exports, '__esModule', { value: true });
 
-})));
+}));
 //# sourceMappingURL=angular-fire-analytics.umd.js.map