@firebase/analytics 0.7.10 → 0.7.11-canary.13550089f

package/dist/esm/src/types.d.ts

@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { ControlParams, EventParams, CustomParams } from './public-types';
+import { ControlParams, EventParams, CustomParams, ConsentSettings } from './public-types';
 /**
  * Encapsulates metadata concerning throttled fetch requests.
  */
@@ -48,5 +48,6 @@ export interface Gtag {
     (command: 'config', targetId: string, config?: ControlParams | EventParams | CustomParams): void;
     (command: 'set', config: CustomParams): void;
     (command: 'event', eventName: string, eventParams?: ControlParams | EventParams | CustomParams): void;
+    (command: 'consent', subCommand: 'default' | 'update', consentSettings: ConsentSettings): void;
 }
 export declare type DataLayer = IArguments[];

package/dist/index.cjs.js

@@ -281,8 +281,14 @@ measurementIdToAppId) {
                         _a.sent();
                         return [3 /*break*/, 5];
                     case 4:
-                        // If SET, second arg must be params.
-                        gtagCore("set" /* SET */, idOrNameOrParams);
+                        if (command === "consent" /* CONSENT */) {
+                            // If CONFIG, second arg must be measurementId.
+                            gtagCore("consent" /* CONSENT */, 'update', gtagParams);
+                        }
+                        else {
+                            // If SET, second arg must be params.
+                            gtagCore("set" /* SET */, idOrNameOrParams);
+                        }
                         _a.label = 5;
                     case 5: return [3 /*break*/, 7];
                     case 6:
@@ -540,53 +546,55 @@ retryData, timeoutMillis) {
  */
 function attemptFetchDynamicConfigWithRetry(appFields, _a, signal, retryData // for testing
 ) {
+    var _b, _c;
     var throttleEndTimeMillis = _a.throttleEndTimeMillis, backoffCount = _a.backoffCount;
     if (retryData === void 0) { retryData = defaultRetryData; }
     return tslib.__awaiter(this, void 0, void 0, function () {
-        var appId, measurementId, e_1, response, e_2, backoffMillis, throttleMetadata;
-        return tslib.__generator(this, function (_b) {
-            switch (_b.label) {
+        var appId, measurementId, e_1, response, e_2, error, backoffMillis, throttleMetadata;
+        return tslib.__generator(this, function (_d) {
+            switch (_d.label) {
                 case 0:
                     appId = appFields.appId, measurementId = appFields.measurementId;
-                    _b.label = 1;
+                    _d.label = 1;
                 case 1:
-                    _b.trys.push([1, 3, , 4]);
+                    _d.trys.push([1, 3, , 4]);
                     return [4 /*yield*/, setAbortableTimeout(signal, throttleEndTimeMillis)];
                 case 2:
-                    _b.sent();
+                    _d.sent();
                     return [3 /*break*/, 4];
                 case 3:
-                    e_1 = _b.sent();
+                    e_1 = _d.sent();
                     if (measurementId) {
                         logger.warn("Timed out fetching this Firebase app's measurement ID from the server." +
                             (" Falling back to the measurement ID " + measurementId) +
-                            (" provided in the \"measurementId\" field in the local Firebase config. [" + e_1.message + "]"));
+                            (" provided in the \"measurementId\" field in the local Firebase config. [" + ((_b = e_1) === null || _b === void 0 ? void 0 : _b.message) + "]"));
                         return [2 /*return*/, { appId: appId, measurementId: measurementId }];
                     }
                     throw e_1;
                 case 4:
-                    _b.trys.push([4, 6, , 7]);
+                    _d.trys.push([4, 6, , 7]);
                     return [4 /*yield*/, fetchDynamicConfig(appFields)];
                 case 5:
-                    response = _b.sent();
+                    response = _d.sent();
                     // Note the SDK only clears throttle state if response is success or non-retriable.
                     retryData.deleteThrottleMetadata(appId);
                     return [2 /*return*/, response];
                 case 6:
-                    e_2 = _b.sent();
-                    if (!isRetriableError(e_2)) {
+                    e_2 = _d.sent();
+                    error = e_2;
+                    if (!isRetriableError(error)) {
                         retryData.deleteThrottleMetadata(appId);
                         if (measurementId) {
                             logger.warn("Failed to fetch this Firebase app's measurement ID from the server." +
                                 (" Falling back to the measurement ID " + measurementId) +
-                                (" provided in the \"measurementId\" field in the local Firebase config. [" + e_2.message + "]"));
+                                (" provided in the \"measurementId\" field in the local Firebase config. [" + (error === null || error === void 0 ? void 0 : error.message) + "]"));
                             return [2 /*return*/, { appId: appId, measurementId: measurementId }];
                         }
                         else {
                             throw e_2;
                         }
                     }
-                    backoffMillis = Number(e_2.customData.httpStatus) === 503
+                    backoffMillis = Number((_c = error === null || error === void 0 ? void 0 : error.customData) === null || _c === void 0 ? void 0 : _c.httpStatus) === 503
                         ? util.calculateBackoffMillis(backoffCount, retryData.intervalMillis, LONG_RETRY_FACTOR)
                         : util.calculateBackoffMillis(backoffCount, retryData.intervalMillis);
                     throttleMetadata = {
@@ -664,6 +672,188 @@ var AnalyticsAbortSignal = /** @class */ (function () {
     return AnalyticsAbortSignal;
 }());
 
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Event parameters to set on 'gtag' during initialization.
+ */
+var defaultEventParametersForInit;
+/**
+ * Logs an analytics event through the Firebase SDK.
+ *
+ * @param gtagFunction Wrapped gtag function that waits for fid to be set before sending an event
+ * @param eventName Google Analytics event name, choose from standard list or use a custom string.
+ * @param eventParams Analytics event parameters.
+ */
+function logEvent$1(gtagFunction, initializationPromise, eventName, eventParams, options) {
+    return tslib.__awaiter(this, void 0, void 0, function () {
+        var measurementId, params;
+        return tslib.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!(options && options.global)) return [3 /*break*/, 1];
+                    gtagFunction("event" /* EVENT */, eventName, eventParams);
+                    return [2 /*return*/];
+                case 1: return [4 /*yield*/, initializationPromise];
+                case 2:
+                    measurementId = _a.sent();
+                    params = tslib.__assign(tslib.__assign({}, eventParams), { 'send_to': measurementId });
+                    gtagFunction("event" /* EVENT */, eventName, params);
+                    _a.label = 3;
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Set screen_name parameter for this Google Analytics ID.
+ *
+ * @deprecated Use {@link logEvent} with `eventName` as 'screen_view' and add relevant `eventParams`.
+ * See {@link https://firebase.google.com/docs/analytics/screenviews | Track Screenviews}.
+ *
+ * @param gtagFunction Wrapped gtag function that waits for fid to be set before sending an event
+ * @param screenName Screen name string to set.
+ */
+function setCurrentScreen$1(gtagFunction, initializationPromise, screenName, options) {
+    return tslib.__awaiter(this, void 0, void 0, function () {
+        var measurementId;
+        return tslib.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!(options && options.global)) return [3 /*break*/, 1];
+                    gtagFunction("set" /* SET */, { 'screen_name': screenName });
+                    return [2 /*return*/, Promise.resolve()];
+                case 1: return [4 /*yield*/, initializationPromise];
+                case 2:
+                    measurementId = _a.sent();
+                    gtagFunction("config" /* CONFIG */, measurementId, {
+                        update: true,
+                        'screen_name': screenName
+                    });
+                    _a.label = 3;
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Set user_id parameter for this Google Analytics ID.
+ *
+ * @param gtagFunction Wrapped gtag function that waits for fid to be set before sending an event
+ * @param id User ID string to set
+ */
+function setUserId$1(gtagFunction, initializationPromise, id, options) {
+    return tslib.__awaiter(this, void 0, void 0, function () {
+        var measurementId;
+        return tslib.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!(options && options.global)) return [3 /*break*/, 1];
+                    gtagFunction("set" /* SET */, { 'user_id': id });
+                    return [2 /*return*/, Promise.resolve()];
+                case 1: return [4 /*yield*/, initializationPromise];
+                case 2:
+                    measurementId = _a.sent();
+                    gtagFunction("config" /* CONFIG */, measurementId, {
+                        update: true,
+                        'user_id': id
+                    });
+                    _a.label = 3;
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Set all other user properties other than user_id and screen_name.
+ *
+ * @param gtagFunction Wrapped gtag function that waits for fid to be set before sending an event
+ * @param properties Map of user properties to set
+ */
+function setUserProperties$1(gtagFunction, initializationPromise, properties, options) {
+    return tslib.__awaiter(this, void 0, void 0, function () {
+        var flatProperties, _i, _a, key, measurementId;
+        return tslib.__generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    if (!(options && options.global)) return [3 /*break*/, 1];
+                    flatProperties = {};
+                    for (_i = 0, _a = Object.keys(properties); _i < _a.length; _i++) {
+                        key = _a[_i];
+                        // use dot notation for merge behavior in gtag.js
+                        flatProperties["user_properties." + key] = properties[key];
+                    }
+                    gtagFunction("set" /* SET */, flatProperties);
+                    return [2 /*return*/, Promise.resolve()];
+                case 1: return [4 /*yield*/, initializationPromise];
+                case 2:
+                    measurementId = _b.sent();
+                    gtagFunction("config" /* CONFIG */, measurementId, {
+                        update: true,
+                        'user_properties': properties
+                    });
+                    _b.label = 3;
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Set whether collection is enabled for this ID.
+ *
+ * @param enabled If true, collection is enabled for this ID.
+ */
+function setAnalyticsCollectionEnabled$1(initializationPromise, enabled) {
+    return tslib.__awaiter(this, void 0, void 0, function () {
+        var measurementId;
+        return tslib.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, initializationPromise];
+                case 1:
+                    measurementId = _a.sent();
+                    window["ga-disable-" + measurementId] = !enabled;
+                    return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Consent parameters to default to during 'gtag' initialization.
+ */
+var defaultConsentSettingsForInit;
+/**
+ * Sets the variable {@link defaultConsentSettingsForInit} for use in the initialization of
+ * analytics.
+ *
+ * @param consentSettings Maps the applicable end user consent state for gtag.js.
+ */
+function _setConsentDefaultForInit(consentSettings) {
+    defaultConsentSettingsForInit = consentSettings;
+}
+/**
+ * Sets the variable `defaultEventParametersForInit` for use in the initialization of
+ * analytics.
+ *
+ * @param customParams Any custom params the user may pass to gtag.js.
+ */
+function _setDefaultEventParametersForInit(customParams) {
+    defaultEventParametersForInit = customParams;
+}
+
 /**
  * @license
  * Copyright 2020 Google LLC
@@ -681,10 +871,11 @@ var AnalyticsAbortSignal = /** @class */ (function () {
  * limitations under the License.
  */
 function validateIndexedDB() {
+    var _a;
     return tslib.__awaiter(this, void 0, void 0, function () {
         var e_1;
-        return tslib.__generator(this, function (_a) {
-            switch (_a.label) {
+        return tslib.__generator(this, function (_b) {
+            switch (_b.label) {
                 case 0:
                     if (!!util.isIndexedDBAvailable()) return [3 /*break*/, 1];
                     logger.warn(ERROR_FACTORY.create("indexeddb-unavailable" /* INDEXEDDB_UNAVAILABLE */, {
@@ -692,15 +883,15 @@ function validateIndexedDB() {
                     }).message);
                     return [2 /*return*/, false];
                 case 1:
-                    _a.trys.push([1, 3, , 4]);
+                    _b.trys.push([1, 3, , 4]);
                     return [4 /*yield*/, util.validateIndexedDBOpenable()];
                 case 2:
-                    _a.sent();
+                    _b.sent();
                     return [3 /*break*/, 4];
                 case 3:
-                    e_1 = _a.sent();
+                    e_1 = _b.sent();
                     logger.warn(ERROR_FACTORY.create("indexeddb-unavailable" /* INDEXEDDB_UNAVAILABLE */, {
-                        errorInfo: e_1
+                        errorInfo: (_a = e_1) === null || _a === void 0 ? void 0 : _a.toString()
                     }).message);
                     return [2 /*return*/, false];
                 case 4: return [2 /*return*/, true];
@@ -763,6 +954,11 @@ function _initializeAnalytics(app, dynamicConfigPromisesList, measurementIdToApp
                     if (!findGtagScriptOnPage()) {
                         insertScriptTag(dataLayerName, dynamicConfig.measurementId);
                     }
+                    // Detects if there are consent settings that need to be configured.
+                    if (defaultConsentSettingsForInit) {
+                        gtagCore("consent" /* CONSENT */, 'default', defaultConsentSettingsForInit);
+                        _setConsentDefaultForInit(undefined);
+                    }
                     // This command initializes gtag.js and only needs to be called once for the entire web app,
                     // but since it is idempotent, we can call it multiple times.
                     // We keep it together with other initialization logic for better code structure.
@@ -780,6 +976,11 @@ function _initializeAnalytics(app, dynamicConfigPromisesList, measurementIdToApp
                     // Note: This will trigger a page_view event unless 'send_page_view' is set to false in
                     // `configProperties`.
                     gtagCore("config" /* CONFIG */, dynamicConfig.measurementId, configProperties);
+                    // Detects if there is data that will be set on every event logged from the SDK.
+                    if (defaultEventParametersForInit) {
+                        gtagCore("set" /* SET */, defaultEventParametersForInit);
+                        _setDefaultEventParametersForInit(undefined);
+                    }
                     return [2 /*return*/, dynamicConfig.measurementId];
             }
         });
@@ -944,162 +1145,6 @@ function factory(app, installations, options) {
     return analyticsInstance;
 }
 
-/**
- * @license
- * Copyright 2019 Google LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-/**
- * Logs an analytics event through the Firebase SDK.
- *
- * @param gtagFunction Wrapped gtag function that waits for fid to be set before sending an event
- * @param eventName Google Analytics event name, choose from standard list or use a custom string.
- * @param eventParams Analytics event parameters.
- */
-function logEvent$1(gtagFunction, initializationPromise, eventName, eventParams, options) {
-    return tslib.__awaiter(this, void 0, void 0, function () {
-        var measurementId, params;
-        return tslib.__generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    if (!(options && options.global)) return [3 /*break*/, 1];
-                    gtagFunction("event" /* EVENT */, eventName, eventParams);
-                    return [2 /*return*/];
-                case 1: return [4 /*yield*/, initializationPromise];
-                case 2:
-                    measurementId = _a.sent();
-                    params = tslib.__assign(tslib.__assign({}, eventParams), { 'send_to': measurementId });
-                    gtagFunction("event" /* EVENT */, eventName, params);
-                    _a.label = 3;
-                case 3: return [2 /*return*/];
-            }
-        });
-    });
-}
-/**
- * Set screen_name parameter for this Google Analytics ID.
- *
- * @deprecated Use {@link logEvent} with `eventName` as 'screen_view' and add relevant `eventParams`.
- * See {@link https://firebase.google.com/docs/analytics/screenviews | Track Screenviews}.
- *
- * @param gtagFunction Wrapped gtag function that waits for fid to be set before sending an event
- * @param screenName Screen name string to set.
- */
-function setCurrentScreen$1(gtagFunction, initializationPromise, screenName, options) {
-    return tslib.__awaiter(this, void 0, void 0, function () {
-        var measurementId;
-        return tslib.__generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    if (!(options && options.global)) return [3 /*break*/, 1];
-                    gtagFunction("set" /* SET */, { 'screen_name': screenName });
-                    return [2 /*return*/, Promise.resolve()];
-                case 1: return [4 /*yield*/, initializationPromise];
-                case 2:
-                    measurementId = _a.sent();
-                    gtagFunction("config" /* CONFIG */, measurementId, {
-                        update: true,
-                        'screen_name': screenName
-                    });
-                    _a.label = 3;
-                case 3: return [2 /*return*/];
-            }
-        });
-    });
-}
-/**
- * Set user_id parameter for this Google Analytics ID.
- *
- * @param gtagFunction Wrapped gtag function that waits for fid to be set before sending an event
- * @param id User ID string to set
- */
-function setUserId$1(gtagFunction, initializationPromise, id, options) {
-    return tslib.__awaiter(this, void 0, void 0, function () {
-        var measurementId;
-        return tslib.__generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    if (!(options && options.global)) return [3 /*break*/, 1];
-                    gtagFunction("set" /* SET */, { 'user_id': id });
-                    return [2 /*return*/, Promise.resolve()];
-                case 1: return [4 /*yield*/, initializationPromise];
-                case 2:
-                    measurementId = _a.sent();
-                    gtagFunction("config" /* CONFIG */, measurementId, {
-                        update: true,
-                        'user_id': id
-                    });
-                    _a.label = 3;
-                case 3: return [2 /*return*/];
-            }
-        });
-    });
-}
-/**
- * Set all other user properties other than user_id and screen_name.
- *
- * @param gtagFunction Wrapped gtag function that waits for fid to be set before sending an event
- * @param properties Map of user properties to set
- */
-function setUserProperties$1(gtagFunction, initializationPromise, properties, options) {
-    return tslib.__awaiter(this, void 0, void 0, function () {
-        var flatProperties, _i, _a, key, measurementId;
-        return tslib.__generator(this, function (_b) {
-            switch (_b.label) {
-                case 0:
-                    if (!(options && options.global)) return [3 /*break*/, 1];
-                    flatProperties = {};
-                    for (_i = 0, _a = Object.keys(properties); _i < _a.length; _i++) {
-                        key = _a[_i];
-                        // use dot notation for merge behavior in gtag.js
-                        flatProperties["user_properties." + key] = properties[key];
-                    }
-                    gtagFunction("set" /* SET */, flatProperties);
-                    return [2 /*return*/, Promise.resolve()];
-                case 1: return [4 /*yield*/, initializationPromise];
-                case 2:
-                    measurementId = _b.sent();
-                    gtagFunction("config" /* CONFIG */, measurementId, {
-                        update: true,
-                        'user_properties': properties
-                    });
-                    _b.label = 3;
-                case 3: return [2 /*return*/];
-            }
-        });
-    });
-}
-/**
- * Set whether collection is enabled for this ID.
- *
- * @param enabled If true, collection is enabled for this ID.
- */
-function setAnalyticsCollectionEnabled$1(initializationPromise, enabled) {
-    return tslib.__awaiter(this, void 0, void 0, function () {
-        var measurementId;
-        return tslib.__generator(this, function (_a) {
-            switch (_a.label) {
-                case 0: return [4 /*yield*/, initializationPromise];
-                case 1:
-                    measurementId = _a.sent();
-                    window["ga-disable-" + measurementId] = !enabled;
-                    return [2 /*return*/];
-            }
-        });
-    });
-}
-
 /* eslint-disable @typescript-eslint/no-explicit-any */
 /**
  * Returns an {@link Analytics} instance for the given app.
@@ -1231,6 +1276,22 @@ function setAnalyticsCollectionEnabled(analyticsInstance, enabled) {
     analyticsInstance = util.getModularInstance(analyticsInstance);
     setAnalyticsCollectionEnabled$1(initializationPromisesMap[analyticsInstance.app.options.appId], enabled).catch(function (e) { return logger.error(e); });
 }
+/**
+ * Adds data that will be set on every event logged from the SDK, including automatic ones.
+ * With gtag's "set" command, the values passed persist on the current page and are passed with
+ * all subsequent events.
+ * @public
+ * @param customParams - Any custom params the user may pass to gtag.js.
+ */
+function setDefaultEventParameters(customParams) {
+    // Check if reference to existing gtag function on window object exists
+    if (wrappedGtagFunction) {
+        wrappedGtagFunction("set" /* SET */, customParams);
+    }
+    else {
+        _setDefaultEventParametersForInit(customParams);
+    }
+}
 /**
  * Sends a Google Analytics event with given `eventParams`. This method
  * automatically associates this logged event with this Firebase web
@@ -1245,10 +1306,28 @@ function setAnalyticsCollectionEnabled(analyticsInstance, enabled) {
 function logEvent(analyticsInstance, eventName, eventParams, options) {
     analyticsInstance = util.getModularInstance(analyticsInstance);
     logEvent$1(wrappedGtagFunction, initializationPromisesMap[analyticsInstance.app.options.appId], eventName, eventParams, options).catch(function (e) { return logger.error(e); });
+}
+/**
+ * Sets the applicable end user consent state for this web app across all gtag references once
+ * Firebase Analytics is initialized.
+ *
+ * Use the {@link ConsentSettings} to specify individual consent type values. By default consent
+ * types are set to "granted".
+ * @public
+ * @param consentSettings - Maps the applicable end user consent state for gtag.js.
+ */
+function setConsent(consentSettings) {
+    // Check if reference to existing gtag function on window object exists
+    if (wrappedGtagFunction) {
+        wrappedGtagFunction("consent" /* CONSENT */, 'update', consentSettings);
+    }
+    else {
+        _setConsentDefaultForInit(consentSettings);
+    }
 }
 
 var name = "@firebase/analytics";
-var version = "0.7.10";
+var version = "0.7.11-canary.13550089f";
 
 /**
  * Firebase Analytics
@@ -1290,7 +1369,9 @@ exports.initializeAnalytics = initializeAnalytics;
 exports.isSupported = isSupported;
 exports.logEvent = logEvent;
 exports.setAnalyticsCollectionEnabled = setAnalyticsCollectionEnabled;
+exports.setConsent = setConsent;
 exports.setCurrentScreen = setCurrentScreen;
+exports.setDefaultEventParameters = setDefaultEventParameters;
 exports.setUserId = setUserId;
 exports.setUserProperties = setUserProperties;
 exports.settings = settings;