@firebase/analytics 0.9.5 → 0.10.0-canary.9c317277f

package/dist/esm/index.esm2017.js

@@ -90,6 +90,7 @@ const ERRORS = {
         'contain a valid API key.',
     ["no-app-id" /* AnalyticsError.NO_APP_ID */]: 'The "appId" field is empty in the local Firebase config. Firebase Analytics requires this field to' +
         'contain a valid app ID.',
+    ["no-client-id" /* AnalyticsError.NO_CLIENT_ID */]: 'The "client_id" field is empty.',
     ["invalid-gtag-resource" /* AnalyticsError.INVALID_GTAG_RESOURCE */]: 'Trusted Types detected an invalid gtag resource: {$gtagURL}.'
 };
 const ERROR_FACTORY = new ErrorFactory('analytics', 'Analytics', ERRORS);
@@ -303,24 +304,34 @@ measurementIdToAppId) {
      * @param idOrNameOrParams Measurement ID if command is EVENT/CONFIG, params if command is SET.
      * @param gtagParams Params if event is EVENT/CONFIG.
      */
-    async function gtagWrapper(command, idOrNameOrParams, gtagParams) {
+    async function gtagWrapper(command, ...args) {
         try {
             // If event, check that relevant initialization promises have completed.
             if (command === "event" /* GtagCommand.EVENT */) {
+                const [measurementId, gtagParams] = args;
                 // If EVENT, second arg must be measurementId.
-                await gtagOnEvent(gtagCore, initializationPromisesMap, dynamicConfigPromisesList, idOrNameOrParams, gtagParams);
+                await gtagOnEvent(gtagCore, initializationPromisesMap, dynamicConfigPromisesList, measurementId, gtagParams);
             }
             else if (command === "config" /* GtagCommand.CONFIG */) {
+                const [measurementId, gtagParams] = args;
                 // If CONFIG, second arg must be measurementId.
-                await gtagOnConfig(gtagCore, initializationPromisesMap, dynamicConfigPromisesList, measurementIdToAppId, idOrNameOrParams, gtagParams);
+                await gtagOnConfig(gtagCore, initializationPromisesMap, dynamicConfigPromisesList, measurementIdToAppId, measurementId, gtagParams);
             }
             else if (command === "consent" /* GtagCommand.CONSENT */) {
-                // If CONFIG, second arg must be measurementId.
+                const [gtagParams] = args;
                 gtagCore("consent" /* GtagCommand.CONSENT */, 'update', gtagParams);
             }
-            else {
+            else if (command === "get" /* GtagCommand.GET */) {
+                const [measurementId, fieldName, callback] = args;
+                gtagCore("get" /* GtagCommand.GET */, measurementId, fieldName, callback);
+            }
+            else if (command === "set" /* GtagCommand.SET */) {
+                const [customParams] = args;
                 // If SET, second arg must be params.
-                gtagCore("set" /* GtagCommand.SET */, idOrNameOrParams);
+                gtagCore("set" /* GtagCommand.SET */, customParams);
+            }
+            else {
+                gtagCore(command, ...args);
             }
         }
         catch (e) {
@@ -714,6 +725,23 @@ async function setUserProperties$1(gtagFunction, initializationPromise, properti
         });
     }
 }
+/**
+ * Retrieves a unique Google Analytics identifier for the web client.
+ * See {@link https://developers.google.com/analytics/devguides/collection/ga4/reference/config#client_id | client_id}.
+ *
+ * @param gtagFunction Wrapped gtag function that waits for fid to be set before sending an event
+ */
+async function internalGetGoogleAnalyticsClientId(gtagFunction, initializationPromise) {
+    const measurementId = await initializationPromise;
+    return new Promise((resolve, reject) => {
+        gtagFunction("get" /* GtagCommand.GET */, measurementId, 'client_id', (clientId) => {
+            if (!clientId) {
+                reject(ERROR_FACTORY.create("no-client-id" /* AnalyticsError.NO_CLIENT_ID */));
+            }
+            resolve(clientId);
+        });
+    });
+}
 /**
  * Set whether collection is enabled for this ID.
  *
@@ -1103,6 +1131,18 @@ function setCurrentScreen(analyticsInstance, screenName, options) {
     analyticsInstance = getModularInstance(analyticsInstance);
     setCurrentScreen$1(wrappedGtagFunction, initializationPromisesMap[analyticsInstance.app.options.appId], screenName, options).catch(e => logger.error(e));
 }
+/**
+ * Retrieves a unique Google Analytics identifier for the web client.
+ * See {@link https://developers.google.com/analytics/devguides/collection/ga4/reference/config#client_id | client_id}.
+ *
+ * @public
+ *
+ * @param app - The {@link @firebase/app#FirebaseApp} to use.
+ */
+async function getGoogleAnalyticsClientId(analyticsInstance) {
+    analyticsInstance = getModularInstance(analyticsInstance);
+    return internalGetGoogleAnalyticsClientId(wrappedGtagFunction, initializationPromisesMap[analyticsInstance.app.options.appId]);
+}
 /**
  * Use gtag `config` command to set `user_id`.
  *
@@ -1188,7 +1228,7 @@ function setConsent(consentSettings) {
 }
 
 const name = "@firebase/analytics";
-const version = "0.9.5";
+const version = "0.10.0-canary.9c317277f";
 
 /**
  * Firebase Analytics
@@ -1224,5 +1264,5 @@ function registerAnalytics() {
 }
 registerAnalytics();
 
-export { getAnalytics, initializeAnalytics, isSupported, logEvent, setAnalyticsCollectionEnabled, setConsent, setCurrentScreen, setDefaultEventParameters, setUserId, setUserProperties, settings };
+export { getAnalytics, getGoogleAnalyticsClientId, initializeAnalytics, isSupported, logEvent, setAnalyticsCollectionEnabled, setConsent, setCurrentScreen, setDefaultEventParameters, setUserId, setUserProperties, settings };
 //# sourceMappingURL=index.esm2017.js.map