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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rtirl/api",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "main": "lib/index.js",
   "browser": "lib/index.min.js",
   "types": "lib/index.d.ts",

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,15 +158,14 @@ 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 });
       });
     },
   };
@@ -180,8 +183,28 @@ function getApp() {
         appId: "1:684852107701:web:d77a8ed0ee5095279a61fc",
         measurementId: "G-TR97D81LT3",
       },
-      "rtirl-api"
+      "rtirl-api",
     );
   }
   return app;
 }
+
+const safeLogEvent = (() => {
+  let analyticsInstance: Analytics | null = null;
+
+  return (eventName: string, eventParams?: any) => {
+    if (analyticsInstance) {
+      logEvent(analyticsInstance, eventName, eventParams);
+      return;
+    }
+
+    isSupported()
+      .then((supported) => {
+        if (supported) {
+          analyticsInstance = getAnalytics(getApp());
+          logEvent(analyticsInstance, eventName, eventParams);
+        }
+      })
+      .catch(() => {});
+  };
+})();