[firebase-analytics] Add DebugView support on Expo client (#7796)

* [firebase-analytics] Add FirebaseAnalyticsJS export

* [firebase-analytics] Add sessionId required for DebugView

* [firebase-analytics] Add DebugView support for JS analytics

* [firebase-analytics] update build files

* [firebase-analytics] Add debug-mode for Expo client

* [docs] Add firebase-analytics `setDebugModeEnabled` option

* [fireabse-analytics] Add debug-mode test

* [firebase-analytics] Update JS build files

* [firebase-analytics] Better error message when setDebugModeEnabled is not supported

* [fireabse-analytics] Update js build files

* [firebase-analytics] Fix failing test on setDebugModeEnabled

* [firebase-analytics] Fix not all events visible in cloud

Fixes the timestamps (deltas) in the send events

* [firebase-analytics] Update JS build files

* [fireabse-analytics] Update headers to closer match JS SDK

* [firebase-analytics] Add initial sending of session start

* [firebase-analytics] Add session-number support

* [firebase-analytics] Log to console when debug-mode is enabled

* [firebase-analytics] Fix typing

* [firebase-analytics] Update js build files

* [firebase-analytics] Fix test-suite

* [firebase-analytics] Update changelog

apps/test-suite/tests/FirebaseAnalytics.js

@@ -6,6 +6,8 @@ export const name = 'FirebaseAnalytics';
 
 export async function test({ describe, beforeAll, afterAll, it, xit, expect }) {
   const isConfigured = !!FirebaseCore.DEFAULT_APP_OPTIONS;
+  const isWebConfigured = !!FirebaseCore.DEFAULT_WEB_APP_OPTIONS;
+  const isExpoClient = FirebaseCore.DEFAULT_APP_NAME !== '[DEFAULT]';
   const itWhenConfigured = isConfigured ? it : xit;
   const itWhenNotConfigured = isConfigured ? xit : it;
 
@@ -163,5 +165,25 @@ export async function test({ describe, beforeAll, afterAll, it, xit, expect }) {
         expect(error).toBeNull();
       });
     });
+    describe('setDebugModeEnabled()', async () => {
+      it(
+        isExpoClient && isConfigured && isWebConfigured
+          ? `runs on client with web-config`
+          : `fails when not on client or without web-config`,
+        async () => {
+          let error = null;
+          try {
+            await Analytics.setDebugModeEnabled(true);
+          } catch (e) {
+            error = e;
+          }
+          if (isExpoClient && isConfigured && isWebConfigured) {
+            expect(error).toBeNull();
+          } else {
+            expect(error).not.toBeNull();
+          }
+        }
+      );
+    });
   });
 }

docs/pages/versions/unversioned/sdk/firebase-analytics.md

@@ -300,6 +300,16 @@ on the Expo client.
 Analytics.setUnavailabilityLogging(false);
 ```
 
+### setDebugModeEnabled
+
+```tsx
+setDebugModeEnabled(isEnabled: boolean): Promise<void>
+```
+
+Enables debug mode *(Expo client only)* so events can be tracked using the [DebugView in the Analytics dashboard](https://firebase.google.com/docs/analytics/debugview#reporting).
+
+This option is **only available on the standard Expo client**. When using a standalone build, the bare workflow or web, use the [natively available options](https://firebase.google.com/docs/analytics/debugview).
+
 # Examples
 
 ## How do people use my app?

docs/pages/versions/v37.0.0/sdk/firebase-analytics.md

@@ -300,6 +300,16 @@ on the Expo client.
 Analytics.setUnavailabilityLogging(false);
 ```
 
+### setDebugModeEnabled
+
+```tsx
+setDebugModeEnabled(isEnabled: boolean): Promise<void>
+```
+
+Enables debug mode *(Expo client only)* so events can be tracked using the [DebugView in the Analytics dashboard](https://firebase.google.com/docs/analytics/debugview#reporting).
+
+This option is **only available on the standard Expo client**. When using a standalone build, the bare workflow or web, use the [natively available options](https://firebase.google.com/docs/analytics/debugview).
+
 # Examples
 
 ## How do people use my app?

packages/expo-firebase-analytics/CHANGELOG.md

@@ -6,7 +6,10 @@
 
 ### 🎉 New features
 
+- Add `setDebugModeEnabled` for enabling DebugView on the Expo client. ([#7796](https://github.com/expo/expo/pull/7796) by [@IjzerenHein](https://github.com/IjzerenHein))
+
 ### 🐛 Bug fixes
 
-- Fix `expo-firebase-analytics` not recording events on the Expo client running on certain Android devices. ([#7192](https://github.com/expo/expo/pull/7679) by [@IjzerenHein](https://github.com/IjzerenHein))
+- Fix no events recorded on the Expo client when running on certain Android devices. ([#7679](https://github.com/expo/expo/pull/7679) by [@IjzerenHein](https://github.com/IjzerenHein))
 - Fix `setAnalyticsCollectionEnabled` throwing an error.
+- Fixes & improvements to the pure JS analytics client. ([#7796](https://github.com/expo/expo/pull/7796) by [@IjzerenHein](https://github.com/IjzerenHein))