@reservamos/browser-analytics 1.1.2-alpha.0 → 1.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reservamos/browser-analytics",
-  "version": "1.1.2-alpha.0",
+  "version": "1.1.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/reservamos/reservamos-browser-analytics.git"

package/src/services/geolocation.test.ts

@@ -103,9 +103,11 @@ describe('geolocationService', () => {
       'Geolocation Accuracy': 12,
       latitude: 19.4326,
       longitude: -99.1332,
+      geolocation_source: 'browser',
     };
 
     expect(coordinates).toEqual({ lat: 19.4326, long: -99.1332 });
+    expect(geolocationService.getGeolocationSource()).toBe('browser');
     expect(trackCustomEventMock).toHaveBeenCalledWith(
       'Geolocation Requested',
       expectedProperties,
@@ -115,6 +117,7 @@ describe('geolocationService', () => {
       'Geolocation Status': 'granted',
       latitude: 19.4326,
       longitude: -99.1332,
+      geolocation_source: 'browser',
     });
 
     vi.useRealTimers();
@@ -142,6 +145,7 @@ describe('geolocationService', () => {
     };
 
     expect(coordinates).toBeNull();
+    expect(geolocationService.getGeolocationSource()).toBeNull();
     expect(trackCustomEventMock).toHaveBeenCalledWith(
       'Geolocation Requested',
       expectedProperties,
@@ -219,6 +223,7 @@ describe('geolocationService', () => {
       'Geolocation Accuracy': 25,
       latitude: 19.4326,
       longitude: -99.1332,
+      geolocation_source: 'browser',
     };
 
     expect(coordinates).toEqual({ lat: 19.4326, long: -99.1332 });
@@ -231,6 +236,7 @@ describe('geolocationService', () => {
       'Geolocation Status': 'skipped_cache',
       latitude: 19.4326,
       longitude: -99.1332,
+      geolocation_source: 'browser',
     });
   });
 
@@ -286,6 +292,7 @@ describe('geolocationService', () => {
         'Geolocation Accuracy': 15,
         latitude: 19.4326,
         longitude: -99.1332,
+        geolocation_source: 'browser',
       },
     );
 
@@ -331,6 +338,7 @@ describe('geolocationService', () => {
         'Geolocation Accuracy': 8,
         latitude: 20.9674,
         longitude: -89.5926,
+        geolocation_source: 'browser',
       },
     );
 

package/src/services/geolocation.ts

@@ -14,6 +14,12 @@ interface GeolocationCache {
   accuracy?: number;
 }
 
+/**
+ * Origin of the coordinates attached to geolocation events and profiles.
+ * - `browser` — Coordinates from the Geolocation API or a prior browser session cache.
+ */
+type GeolocationSource = 'browser';
+
 interface GeolocationTrackingData {
   status: GeolocationStatus;
   updatedAt: string;
@@ -21,6 +27,7 @@ interface GeolocationTrackingData {
   long?: number;
   accuracy?: number;
   errorCode?: number;
+  source?: GeolocationSource;
 }
 
 /**
@@ -35,6 +42,7 @@ interface GeolocationTrackingData {
 type GeolocationStatus = 'granted' | 'denied' | 'error' | 'skipped_cache';
 
 let currentCoordinates: Coordinates | null = null;
+let currentSource: GeolocationSource | null = null;
 
 const GEOLOCATION_PERMISSION_KEY = 'geolocationPermissionTimestamp';
 const GEOLOCATION_CACHE_KEY = 'geolocationCache';
@@ -164,6 +172,7 @@ function restoreCoordinatesFromStorage(): void {
 
   if (cache) {
     currentCoordinates = { lat: cache.lat, long: cache.long };
+    currentSource = 'browser';
   }
 }
 
@@ -245,6 +254,10 @@ function buildGeolocationEventProperties(
     properties.longitude = data.long;
   }
 
+  if (data.source !== undefined) {
+    properties.geolocation_source = data.source;
+  }
+
   return properties;
 }
 
@@ -271,6 +284,10 @@ function buildGeolocationProfileProperties(
     properties.longitude = data.long;
   }
 
+  if (data.source !== undefined) {
+    properties.geolocation_source = data.source;
+  }
+
   return properties;
 }
 
@@ -311,6 +328,7 @@ function init(): Promise<Coordinates | null> {
           lat: cache.lat,
           long: cache.long,
           accuracy: cache.accuracy,
+          source: 'browser',
         });
         resolve(currentCoordinates);
         return;
@@ -330,6 +348,7 @@ function init(): Promise<Coordinates | null> {
       (geolocation) => {
         const { latitude: lat, longitude: long, accuracy } = geolocation.coords;
         currentCoordinates = { lat, long };
+        currentSource = 'browser';
         saveCoordinatesToStorage(currentCoordinates, updatedAt, accuracy);
         updatePermissionTimestamp(now);
 
@@ -339,6 +358,7 @@ function init(): Promise<Coordinates | null> {
           lat,
           long,
           accuracy,
+          source: 'browser',
         });
         resolve(currentCoordinates);
       },
@@ -365,6 +385,14 @@ function getCoordinates(): Coordinates | null {
   return currentCoordinates;
 }
 
+/**
+ * Returns the source of the currently cached coordinates, or null when unavailable.
+ * @returns {GeolocationSource | null} The geolocation source or null if no coordinates are cached.
+ */
+function getGeolocationSource(): GeolocationSource | null {
+  return currentSource;
+}
+
 /**
  * Geolocation service for tracking user location with caching support.
  * Handles permission requests, coordinate retrieval, and analytics sync to Mixpanel.
@@ -372,6 +400,7 @@ function getCoordinates(): Coordinates | null {
 const geolocationService = {
   init,
   getCoordinates,
+  getGeolocationSource,
 };
 
 export default geolocationService;

package/src/track.ts

@@ -125,10 +125,14 @@ export async function trackEvent(
     const fingerprint = await fingerprintService.getFingerprint(cacheOnly);
     const defaultCoordinates: Record<string, string | number> = {};
     const coordinates = geolocationService.getCoordinates();
+    const geolocationSource = geolocationService.getGeolocationSource();
     if (coordinates) {
       defaultCoordinates.latitude = coordinates.lat;
       defaultCoordinates.longitude = coordinates.long;
     }
+    if (geolocationSource) {
+      defaultCoordinates.geolocation_source = geolocationSource;
+    }
     const defaultProperties = {
       'User Fingerprint': fingerprint,
     };