fix: wrap Firebase Analytics in isSupported check to prevent Node.js warnings

- Add isSupported() check before initializing Firebase Analytics
- Create safeLogEvent helper that handles analytics gracefully in all environments
- Prevents "Analytics not supported in this environment" warnings in Node.js

This allows the package to work seamlessly in both browser and Node.js
environments without throwing analytics-related warnings.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: kevmo314

api/src/index.ts

@@ -1,4 +1,9 @@
-import { getAnalytics, logEvent } from "firebase/analytics";
+import {
+  Analytics,
+  getAnalytics,
+  isSupported,
+  logEvent,
+} from "firebase/analytics";
 import { FirebaseApp, initializeApp } from "firebase/app";
 import { child, getDatabase, onValue, ref } from "firebase/database";
 
@@ -13,99 +18,98 @@ type UUID = string;
 
 export function addLocationListener(
   pullKey: string,
-  callback: (location: Location) => void
+  callback: (location: Location) => void,
 ) {
   return forPullKey(pullKey).addLocationListener(callback);
 }
 
 export function addSpeedListener(
   pullKey: string,
-  callback: (speed: MetersPerSecond) => void
+  callback: (speed: MetersPerSecond) => void,
 ) {
   return forPullKey(pullKey).addSpeedListener(callback);
 }
 
 export function addHeadingListener(
   pullKey: string,
-  callback: (heading: Degrees) => void
+  callback: (heading: Degrees) => void,
 ) {
   return forPullKey(pullKey).addHeadingListener(callback);
 }
 
 export function addAltitudeListener(
   pullKey: string,
-  callback: (altitude: Meters) => void
+  callback: (altitude: Meters) => void,
 ) {
   return forPullKey(pullKey).addAltitudeListener(callback);
 }
 
 export function addSessionIdListener(
   pullKey: string,
-  callback: (sessionId: UUID | null) => void
+  callback: (sessionId: UUID | null) => void,
 ) {
   return forPullKey(pullKey).addSessionIdListener(callback);
 }
 
 /** Creates a listener source for a streamer's private data with a pull key. */
 export function forPullKey(pullKey: string) {
   const db = getDatabase(getApp());
-  const analytics = getAnalytics(getApp());
   const reference = child(ref(db, "pullables"), pullKey);
   return {
     addLocationListener(callback: (location: Location) => void) {
-      logEvent(analytics, "listener", { type: "location", pullKey });
+      safeLogEvent("listener", { type: "location", pullKey });
       return onValue(child(reference, "location"), (snapshot) => {
         callback(snapshot.val());
-        logEvent(analytics, "data", { type: "sessionId", pullKey });
+        safeLogEvent("data", { type: "sessionId", pullKey });
       });
     },
     addSpeedListener(callback: (speed: MetersPerSecond) => void) {
-      logEvent(analytics, "listener", { type: "speed", pullKey });
+      safeLogEvent("listener", { type: "speed", pullKey });
       return onValue(child(reference, "speed"), (snapshot) => {
         callback(snapshot.val());
-        logEvent(analytics, "data", { type: "sessionId", pullKey });
+        safeLogEvent("data", { type: "sessionId", pullKey });
       });
     },
     addHeadingListener(callback: (heading: Degrees) => void) {
-      logEvent(analytics, "listener", { type: "heading", pullKey });
+      safeLogEvent("listener", { type: "heading", pullKey });
       return onValue(child(reference, "heading"), (snapshot) => {
         callback(snapshot.val());
-        logEvent(analytics, "data", { type: "sessionId", pullKey });
+        safeLogEvent("data", { type: "sessionId", pullKey });
       });
     },
     addAltitudeListener(callback: (altitude: Meters) => void) {
-      logEvent(analytics, "listener", { type: "altitude", pullKey });
+      safeLogEvent("listener", { type: "altitude", pullKey });
       return onValue(child(reference, "altitude"), (snapshot) => {
         callback(snapshot.val());
-        logEvent(analytics, "data", { type: "sessionId", pullKey });
+        safeLogEvent("data", { type: "sessionId", pullKey });
       });
     },
     addHeartRateListener(callback: (altitude: BeatsPerMinute) => void) {
-      logEvent(analytics, "listener", { type: "heartRate", pullKey });
+      safeLogEvent("listener", { type: "heartRate", pullKey });
       return onValue(child(reference, "heartRate"), (snapshot) => {
         callback(snapshot.val());
-        logEvent(analytics, "data", { type: "sessionId", pullKey });
+        safeLogEvent("data", { type: "sessionId", pullKey });
       });
     },
     addCyclingPowerListener(callback: (power: Watts) => void) {
-      logEvent(analytics, "listener", { type: "cyclingPower", pullKey });
+      safeLogEvent("listener", { type: "cyclingPower", pullKey });
       return onValue(child(reference, "cyclingPower"), (snapshot) => {
         callback(snapshot.val());
-        logEvent(analytics, "data", { type: "sessionId", pullKey });
+        safeLogEvent("data", { type: "sessionId", pullKey });
       });
     },
     addCyclingCrankListener(callback: (power: Watts) => void) {
-      logEvent(analytics, "listener", { type: "cyclingCrank", pullKey });
+      safeLogEvent("listener", { type: "cyclingCrank", pullKey });
       return onValue(child(reference, "cyclingCrank"), (snapshot) => {
         callback(snapshot.val());
-        logEvent(analytics, "data", { type: "sessionId", pullKey });
+        safeLogEvent("data", { type: "sessionId", pullKey });
       });
     },
     addCyclingWheelListener(callback: (power: Watts) => void) {
-      logEvent(analytics, "listener", { type: "cyclingWheel", pullKey });
+      safeLogEvent("listener", { type: "cyclingWheel", pullKey });
       return onValue(child(reference, "cyclingWheel"), (snapshot) => {
         callback(snapshot.val());
-        logEvent(analytics, "data", { type: "sessionId", pullKey });
+        safeLogEvent("data", { type: "sessionId", pullKey });
       });
     },
     /**
@@ -117,10 +121,10 @@ export function forPullKey(pullKey: string) {
      * for a given session id.
      */
     addPedometerStepsListener(callback: (steps: Steps) => void) {
-      logEvent(analytics, "listener", { type: "pedometerSteps", pullKey });
+      safeLogEvent("listener", { type: "pedometerSteps", pullKey });
       return onValue(child(reference, "pedometerSteps"), (snapshot) => {
         callback(snapshot.val());
-        logEvent(analytics, "data", { type: "sessionId", pullKey });
+        safeLogEvent("data", { type: "sessionId", pullKey });
       });
     },
     /**
@@ -129,10 +133,10 @@ export function forPullKey(pullKey: string) {
      * as bluetooth heart rate or telemetry data.
      */
     addListener(callback: (data: any) => void) {
-      logEvent(analytics, "listener", { type: "root", pullKey });
+      safeLogEvent("listener", { type: "root", pullKey });
       return onValue(reference, (snapshot) => {
         callback(snapshot.val());
-        logEvent(analytics, "data", { type: "root", pullKey });
+        safeLogEvent("data", { type: "root", pullKey });
       });
     },
     /**
@@ -142,10 +146,10 @@ export function forPullKey(pullKey: string) {
      * possible for two sequential non-null sessionIds to be sent.
      */
     addSessionIdListener(callback: (sessionId: UUID | null) => void) {
-      logEvent(analytics, "listener", { type: "sessionId", pullKey });
+      safeLogEvent("listener", { type: "sessionId", pullKey });
       return onValue(child(reference, "sessionId"), (snapshot) => {
         callback(snapshot.val());
-        logEvent(analytics, "data", { type: "sessionId", pullKey });
+        safeLogEvent("data", { type: "sessionId", pullKey });
       });
     },
   };
@@ -154,21 +158,22 @@ export function forPullKey(pullKey: string) {
 /** Creates a listener source for a streamer's public data. */
 export function forStreamer(provider: "twitch", userId: string) {
   const db = getDatabase(getApp());
-  const analytics = getAnalytics(getApp());
   const reference = child(ref(db, "streamers"), `${provider}:${userId}`);
   return {
     /** If the public location is hidden (eg streamer is offline), null is passed. */
     addLocationListener(callback: (location: Location | null) => void) {
-      logEvent(analytics, "listener", { type: "location", provider, userId });
+      safeLogEvent("listener", { type: "location", provider, userId });
       return onValue(child(reference, "location"), (snapshot) => {
         callback(snapshot.val());
-        logEvent(analytics, "data", { type: "location", provider, userId });
+        safeLogEvent("data", { type: "location", provider, userId });
       });
     },
   };
 }
 
 let app: FirebaseApp | null = null;
+let analyticsInstance: Analytics | null = null;
+let analyticsChecked = false;
 
 function getApp() {
   if (!app) {
@@ -180,8 +185,32 @@ function getApp() {
         appId: "1:684852107701:web:d77a8ed0ee5095279a61fc",
         measurementId: "G-TR97D81LT3",
       },
-      "rtirl-api"
+      "rtirl-api",
     );
   }
   return app;
 }
+
+async function getAnalyticsIfSupported(): Promise<Analytics | null> {
+  if (analyticsChecked) {
+    return analyticsInstance;
+  }
+
+  analyticsChecked = true;
+  if (await isSupported()) {
+    analyticsInstance = getAnalytics(getApp());
+  }
+  return analyticsInstance;
+}
+
+function safeLogEvent(eventName: string, eventParams?: any) {
+  getAnalyticsIfSupported()
+    .then((analytics) => {
+      if (analytics) {
+        logEvent(analytics, eventName, eventParams);
+      }
+    })
+    .catch(() => {
+      // Silently ignore analytics errors
+    });
+}