user-analytics-tracker 2.0.0 → 2.2.0

package/dist/index.cjs.js

@@ -553,6 +553,277 @@ function checkAndSetLocationConsent(msisdn) {
     return false;
 }
 
+/**
+ * IP Geolocation Service
+ * Fetches location data (country, region, city) from user's IP address
+ * Uses ipwho.is API (no API key required)
+ *
+ * Stores all keys dynamically from the API response, including nested objects
+ * This ensures we capture all available data and any new fields added by the API
+ */
+/**
+ * Get complete IP location data from ipwho.is API (HIGH PRIORITY)
+ * This is the primary method - gets IP, location, connection, and all data in one call
+ * No API key required
+ *
+ * @returns Promise<IPLocation | null> - Complete IP location data, or null if unavailable
+ *
+ * @example
+ * ```typescript
+ * const location = await getCompleteIPLocation();
+ * console.log('IP:', location?.ip);
+ * console.log('Country:', location?.country);
+ * console.log('ISP:', location?.connection?.isp);
+ * ```
+ */
+async function getCompleteIPLocation() {
+    // Skip if we're in an environment without fetch (SSR)
+    if (typeof fetch === 'undefined') {
+        return null;
+    }
+    try {
+        // Call ipwho.is without IP parameter - it auto-detects user's IP and returns everything
+        // This is the HIGH PRIORITY source - gets IP, location, connection, timezone, flag, etc. in one call
+        const response = await fetch('https://ipwho.is/', {
+            method: 'GET',
+            headers: {
+                Accept: 'application/json',
+            },
+            // Add timeout to prevent hanging
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const data = await response.json();
+        // ipwho.is returns success field
+        if (data.success === false) {
+            return null;
+        }
+        // Store all keys dynamically from the response
+        // This ensures we capture all fields, including nested objects and any new fields
+        const locationData = {
+            ip: data.ip,
+            // Map all fields from the API response dynamically
+            ...Object.keys(data).reduce((acc, key) => {
+                // Store all keys and their values, preserving nested objects
+                acc[key] = data[key];
+                return acc;
+            }, {}),
+        };
+        // Add backward compatibility mappings for existing code
+        if (data.latitude !== undefined) {
+            locationData.lat = data.latitude;
+        }
+        if (data.longitude !== undefined) {
+            locationData.lon = data.longitude;
+        }
+        if (data.country_code !== undefined) {
+            locationData.countryCode = data.country_code;
+        }
+        if (data.region !== undefined) {
+            locationData.regionName = data.region;
+        }
+        if (data.connection?.isp !== undefined) {
+            locationData.isp = data.connection.isp;
+        }
+        if (data.connection?.org !== undefined) {
+            locationData.org = data.connection.org;
+        }
+        if (data.connection?.asn !== undefined) {
+            locationData.as = `AS${data.connection.asn}`;
+        }
+        if (data.timezone?.id !== undefined) {
+            locationData.timezone = data.timezone.id;
+        }
+        locationData.query = data.ip;
+        return locationData;
+    }
+    catch (error) {
+        // Silently fail - don't break user experience
+        if (error.name !== 'AbortError') {
+            console.warn('[IP Geolocation] Error fetching complete IP location from ipwho.is:', error.message);
+        }
+        return null;
+    }
+}
+/**
+ * Get public IP address using ipwho.is API (FALLBACK - lower priority)
+ * This is kept for backward compatibility and as a fallback
+ * Prefer getCompleteIPLocation() which gets everything in one call
+ *
+ * @returns Promise<string | null> - The public IP address, or null if unavailable
+ *
+ * @example
+ * ```typescript
+ * const ip = await getPublicIP();
+ * console.log('Your IP:', ip); // e.g., "203.0.113.42"
+ * ```
+ */
+async function getPublicIP() {
+    // Try to get complete location first (includes IP)
+    const completeLocation = await getCompleteIPLocation();
+    if (completeLocation?.ip) {
+        return completeLocation.ip;
+    }
+    // Fallback: try direct IP fetch (less efficient, lower priority)
+    try {
+        const response = await fetch('https://ipwho.is/', {
+            method: 'GET',
+            headers: {
+                Accept: 'application/json',
+            },
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const data = await response.json();
+        if (data.success === false) {
+            return null;
+        }
+        return data.ip || null;
+    }
+    catch (error) {
+        if (error.name !== 'AbortError') {
+            console.warn('[IP Geolocation] Error fetching public IP (fallback):', error.message);
+        }
+        return null;
+    }
+}
+/**
+ * Get location from IP address using ipwho.is API (HIGH PRIORITY)
+ * Free tier: No API key required
+ *
+ * Stores all keys dynamically from the API response, including nested objects
+ * This ensures we capture all available data and any new fields added by the API
+ *
+ * Note: If you don't have an IP yet, use getCompleteIPLocation() which gets everything in one call
+ */
+async function getIPLocation(ip) {
+    // Skip localhost/private IPs (these can't be geolocated)
+    if (!ip ||
+        ip === '0.0.0.0' ||
+        ip === '::1' ||
+        ip.startsWith('127.') ||
+        ip.startsWith('192.168.') ||
+        ip.startsWith('10.') ||
+        ip.startsWith('172.') ||
+        ip.startsWith('::ffff:127.')) {
+        console.log(`[IP Geolocation] Skipping localhost/private IP: ${ip} (geolocation not available for local IPs)`);
+        return null;
+    }
+    try {
+        // Using ipwho.is API (no API key required)
+        const response = await fetch(`https://ipwho.is/${ip}`, {
+            method: 'GET',
+            headers: {
+                Accept: 'application/json',
+            },
+            // Add timeout to prevent hanging
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!response.ok) {
+            console.warn(`[IP Geolocation] Failed to fetch location for IP ${ip}: ${response.status}`);
+            return null;
+        }
+        const data = await response.json();
+        // ipwho.is returns success field
+        if (data.success === false) {
+            console.warn(`[IP Geolocation] API error for IP ${ip}: ${data.message || 'Unknown error'}`);
+            return null;
+        }
+        // Store all keys dynamically from the response
+        // This ensures we capture all fields, including nested objects and any new fields
+        const locationData = {
+            ip: data.ip || ip,
+            // Map all fields from the API response dynamically
+            ...Object.keys(data).reduce((acc, key) => {
+                // Store all keys and their values, preserving nested objects
+                acc[key] = data[key];
+                return acc;
+            }, {}),
+        };
+        // Add backward compatibility mappings for existing code
+        if (data.latitude !== undefined) {
+            locationData.lat = data.latitude;
+        }
+        if (data.longitude !== undefined) {
+            locationData.lon = data.longitude;
+        }
+        if (data.country_code !== undefined) {
+            locationData.countryCode = data.country_code;
+        }
+        if (data.region !== undefined) {
+            locationData.regionName = data.region;
+        }
+        if (data.connection?.isp !== undefined) {
+            locationData.isp = data.connection.isp;
+        }
+        if (data.connection?.org !== undefined) {
+            locationData.org = data.connection.org;
+        }
+        if (data.connection?.asn !== undefined) {
+            locationData.as = `AS${data.connection.asn}`;
+        }
+        if (data.timezone?.id !== undefined) {
+            locationData.timezone = data.timezone.id;
+        }
+        locationData.query = data.ip || ip;
+        return locationData;
+    }
+    catch (error) {
+        // Silently fail - don't break user experience
+        if (error.name !== 'AbortError') {
+            console.warn(`[IP Geolocation] Error fetching location for IP ${ip}:`, error.message);
+        }
+        return null;
+    }
+}
+/**
+ * Get IP address from request headers
+ * Handles various proxy headers (x-forwarded-for, x-real-ip, etc.)
+ */
+function getIPFromRequest(req) {
+    // Try various headers that proxies/load balancers use
+    const forwardedFor = req.headers?.get?.('x-forwarded-for') ||
+        req.headers?.['x-forwarded-for'] ||
+        req.headers?.['X-Forwarded-For'];
+    if (forwardedFor) {
+        // x-forwarded-for can contain multiple IPs, take the first one
+        const ips = forwardedFor.split(',').map((ip) => ip.trim());
+        const ip = ips[0];
+        if (ip && ip !== '0.0.0.0') {
+            return ip;
+        }
+    }
+    const realIP = req.headers?.get?.('x-real-ip') ||
+        req.headers?.['x-real-ip'] ||
+        req.headers?.['X-Real-IP'];
+    if (realIP && realIP !== '0.0.0.0') {
+        return realIP.trim();
+    }
+    // Try req.ip (from Express/Next.js)
+    if (req.ip && req.ip !== '0.0.0.0') {
+        return req.ip;
+    }
+    // For localhost, detect if we're running locally
+    if (typeof window === 'undefined') {
+        const hostname = req.headers?.get?.('host') || req.headers?.['host'];
+        if (hostname &&
+            (hostname.includes('localhost') ||
+                hostname.includes('127.0.0.1') ||
+                hostname.startsWith('192.168.'))) {
+            return '127.0.0.1'; // Localhost IP
+        }
+    }
+    // If no IP found and we're in development, return localhost
+    if (typeof process !== 'undefined' && process.env?.NODE_ENV === 'development') {
+        return '127.0.0.1'; // Localhost for development
+    }
+    return '0.0.0.0';
+}
+
 /**
  * Location Detector
  * Detects GPS location with consent management, falls back to IP-based location API
@@ -817,7 +1088,8 @@ class LocationDetector {
     /**
      * Get location from IP-based public API (client-side)
      * Works without user permission, good fallback when GPS is unavailable
-     * Uses ip-api.com free tier (no API key required, 45 requests/minute)
+     * Uses ipwho.is API (no API key required)
+     * Stores all keys dynamically from the API response
      */
     static async getIPBasedLocation() {
         // Return cached IP location if available
@@ -853,51 +1125,55 @@ class LocationDetector {
         }
         this.ipLocationFetchingRef.current = true;
         try {
-            // Call ip-api.com without IP parameter - it auto-detects user's IP
-            // Using HTTPS endpoint for better security
-            const response = await fetch('https://ip-api.com/json/?fields=status,message,country,countryCode,region,regionName,city,lat,lon,timezone,query', {
-                method: 'GET',
-                headers: {
-                    Accept: 'application/json',
-                },
-                // Add timeout to prevent hanging
-                signal: AbortSignal.timeout(5000),
-            });
-            if (!response.ok) {
-                throw new Error(`HTTP ${response.status}`);
+            // HIGH PRIORITY: Get complete IP location data from ipwho.is in one call
+            // This gets IP, location, connection, timezone, flag, and all other data at once
+            // More efficient than making separate calls
+            let ipLocation = await getCompleteIPLocation();
+            // If complete location fetch failed, try fallback: get IP first, then location
+            if (!ipLocation) {
+                console.log('[Location] Primary ipwho.is call failed, trying fallback...');
+                const publicIP = await getPublicIP();
+                if (publicIP) {
+                    // Fallback: Get location from IP using ipwho.is API
+                    ipLocation = await getIPLocation(publicIP);
+                }
             }
-            const data = await response.json();
-            // ip-api.com returns status field
-            if (data.status === 'fail') {
-                console.warn(`[Location] IP API error: ${data.message}`);
-                const fallback = {
-                    source: 'unknown',
-                    permission: 'granted',
-                };
-                this.lastIPLocationRef.current = fallback;
-                return fallback;
+            if (!ipLocation) {
+                throw new Error('Could not fetch location data from ipwho.is');
             }
             // Convert IP location to LocationInfo format
+            // Map all available fields from the IP location response
+            // Handle timezone which can be either a string or an object
+            const timezoneValue = typeof ipLocation.timezone === 'string'
+                ? ipLocation.timezone
+                : ipLocation.timezone?.id || undefined;
             const locationResult = {
-                lat: data.lat || null,
-                lon: data.lon || null,
+                lat: ipLocation.latitude ?? ipLocation.lat ?? null,
+                lon: ipLocation.longitude ?? ipLocation.lon ?? null,
                 accuracy: null, // IP-based location has no accuracy metric
                 permission: 'granted', // IP location doesn't require permission
                 source: 'ip',
                 ts: new Date().toISOString(),
-                ip: data.query || null, // Public IP address
-                country: data.country || undefined,
-                countryCode: data.countryCode || undefined,
-                city: data.city || undefined,
-                region: data.regionName || data.region || undefined,
-                timezone: data.timezone || undefined,
+                ip: ipLocation.ip || undefined,
+                country: ipLocation.country || undefined,
+                countryCode: ipLocation.country_code || ipLocation.countryCode || undefined,
+                city: ipLocation.city || undefined,
+                region: ipLocation.region || ipLocation.regionName || undefined,
+                timezone: timezoneValue,
             };
-            console.log('[Location] IP-based location obtained:', {
+            // Store the full IP location data in a custom field for access to all keys
+            // This preserves all dynamic keys from the API response
+            locationResult.ipLocationData = ipLocation;
+            console.log('[Location] IP-based location obtained from ipwho.is:', {
                 ip: locationResult.ip,
                 lat: locationResult.lat,
                 lon: locationResult.lon,
                 city: locationResult.city,
                 country: locationResult.country,
+                continent: ipLocation.continent,
+                timezone: locationResult.timezone,
+                isp: ipLocation.connection?.isp,
+                connection: ipLocation.connection,
             });
             this.lastIPLocationRef.current = locationResult;
             return locationResult;
@@ -1734,6 +2010,73 @@ class MetricsCollector {
 // Global metrics collector instance
 const metricsCollector = new MetricsCollector();
 
+/**
+ * Transform IP location data from API format (snake_case) to backend-expected format (camelCase)
+ * This ensures compatibility with the analytics backend integration
+ *
+ * @param ipLocation - Raw IP location data from ipwho.is API
+ * @returns Transformed IP location data matching backend schema
+ */
+function transformIPLocationForBackend(ipLocation) {
+    if (!ipLocation) {
+        return null;
+    }
+    // Transform to match backend expected format (camelCase)
+    const transformed = {
+        // Basic fields
+        ip: ipLocation.ip,
+        country: ipLocation.country,
+        countryCode: ipLocation.country_code || ipLocation.countryCode,
+        region: ipLocation.region || ipLocation.regionName,
+        city: ipLocation.city,
+        postal: ipLocation.postal,
+        capital: ipLocation.capital,
+        callingCode: ipLocation.calling_code || ipLocation.callingCode,
+        // Geographic fields
+        continent: ipLocation.continent,
+        continentCode: ipLocation.continent_code || ipLocation.continentCode,
+        lat: ipLocation.latitude ?? ipLocation.lat,
+        lon: ipLocation.longitude ?? ipLocation.lon,
+        borders: ipLocation.borders,
+        // Network fields
+        type: ipLocation.type,
+        isEu: ipLocation.is_eu ?? ipLocation.isEu,
+        // ISP/Connection - preserve connection object and also add top-level isp
+        isp: ipLocation.connection?.isp || ipLocation.isp,
+        connection: ipLocation.connection ? {
+            asn: ipLocation.connection.asn,
+            org: ipLocation.connection.org,
+            isp: ipLocation.connection.isp,
+            domain: ipLocation.connection.domain,
+        } : undefined,
+        // Timezone - store both simple string and full details object
+        timezone: typeof ipLocation.timezone === 'string'
+            ? ipLocation.timezone
+            : ipLocation.timezone?.id,
+        timezoneDetails: ipLocation.timezone && typeof ipLocation.timezone === 'object' ? {
+            id: ipLocation.timezone.id,
+            abbr: ipLocation.timezone.abbr,
+            isDst: ipLocation.timezone.is_dst,
+            offset: ipLocation.timezone.offset,
+            utc: ipLocation.timezone.utc,
+            currentTime: ipLocation.timezone.current_time,
+        } : undefined,
+        // Flag - transform to camelCase
+        flag: ipLocation.flag ? {
+            img: ipLocation.flag.img,
+            emoji: ipLocation.flag.emoji,
+            emojiUnicode: ipLocation.flag.emoji_unicode,
+        } : undefined,
+    };
+    // Remove undefined values to keep the payload clean
+    Object.keys(transformed).forEach(key => {
+        if (transformed[key] === undefined) {
+            delete transformed[key];
+        }
+    });
+    return transformed;
+}
+
 /**
  * Analytics Service
  * Sends analytics events to your backend API
@@ -1997,6 +2340,8 @@ class AnalyticsService {
      * Track user journey with full context
      */
     static async trackUserJourney({ sessionId, pageUrl, networkInfo, deviceInfo, location, attribution, ipLocation, userId, customData, pageVisits = 1, interactions = 0, }) {
+        // Transform IP location data to match backend expected format (camelCase)
+        const transformedIPLocation = transformIPLocationForBackend(ipLocation);
         await this.trackEvent({
             sessionId,
             pageUrl,
@@ -2008,7 +2353,8 @@ class AnalyticsService {
             userId: userId ?? sessionId,
             customData: {
                 ...customData,
-                ...(ipLocation && { ipLocation }),
+                // Store transformed IP location in customData for backend integration
+                ...(transformedIPLocation && { ipLocation: transformedIPLocation }),
             },
             eventName: 'page_view', // Auto-tracked as page view
         });
@@ -2079,6 +2425,13 @@ class AnalyticsService {
         }
         const finalSessionId = context?.sessionId || autoContext?.sessionId || 'unknown';
         const finalPageUrl = context?.pageUrl || autoContext?.pageUrl || '';
+        // Extract IP location from location object if available
+        const locationData = context?.location || autoContext?.location;
+        const ipLocationData = locationData && typeof locationData === 'object'
+            ? locationData?.ipLocationData
+            : undefined;
+        // Transform IP location data to match backend expected format
+        const transformedIPLocation = transformIPLocationForBackend(ipLocationData);
         await this.trackEvent({
             sessionId: finalSessionId,
             pageUrl: finalPageUrl,
@@ -2089,7 +2442,11 @@ class AnalyticsService {
             userId: context?.userId || finalSessionId,
             eventName,
             eventParameters: parameters || {},
-            customData: parameters || {},
+            customData: {
+                ...(parameters || {}),
+                // Store transformed IP location in customData for backend integration
+                ...(transformedIPLocation && { ipLocation: transformedIPLocation }),
+            },
         });
     }
     /**
@@ -2380,6 +2737,8 @@ function useAnalytics(options = {}) {
             if (autoSend) {
                 // Send after idle to not block paint
                 const send = async () => {
+                    // Extract IP location data if available (stored in ipLocationData field)
+                    const ipLocationData = loc?.ipLocationData;
                     await AnalyticsService.trackUserJourney({
                         sessionId: getOrCreateUserId(),
                         pageUrl: typeof window !== 'undefined' ? window.location.href : '',
@@ -2387,6 +2746,7 @@ function useAnalytics(options = {}) {
                         deviceInfo: dev,
                         location: loc,
                         attribution: attr,
+                        ipLocation: ipLocationData,
                         customData: config?.enableLocation ? { locationEnabled: true } : undefined,
                     });
                 };
@@ -2402,6 +2762,8 @@ function useAnalytics(options = {}) {
     const logEvent = react.useCallback(async (customData) => {
         if (!sessionId || !networkInfo || !deviceInfo)
             return;
+        // Extract IP location data if available (stored in ipLocationData field)
+        const ipLocationData = location ? location?.ipLocationData : undefined;
         await AnalyticsService.trackUserJourney({
             sessionId,
             pageUrl: typeof window !== 'undefined' ? window.location.href : '',
@@ -2409,6 +2771,7 @@ function useAnalytics(options = {}) {
             deviceInfo,
             location: location ?? undefined,
             attribution: attribution ?? undefined,
+            ipLocation: ipLocationData,
             userId: sessionId,
             customData,
         });
@@ -2546,167 +2909,6 @@ function useAnalytics(options = {}) {
     ]);
 }
 
-/**
- * IP Geolocation Service
- * Fetches location data (country, region, city) from user's IP address
- * Uses free tier of ip-api.com (no API key required, 45 requests/minute)
- */
-/**
- * Get public IP address using ip-api.com
- * Free tier: 45 requests/minute, no API key required
- *
- * @returns Promise<string | null> - The public IP address, or null if unavailable
- *
- * @example
- * ```typescript
- * const ip = await getPublicIP();
- * console.log('Your IP:', ip); // e.g., "203.0.113.42"
- * ```
- */
-async function getPublicIP() {
-    // Skip if we're in an environment without fetch (SSR)
-    if (typeof fetch === 'undefined') {
-        return null;
-    }
-    try {
-        // Call ip-api.com without IP parameter - it auto-detects user's IP
-        // Using HTTPS endpoint for better security
-        const response = await fetch('https://ip-api.com/json/?fields=status,message,query', {
-            method: 'GET',
-            headers: {
-                Accept: 'application/json',
-            },
-            // Add timeout to prevent hanging
-            signal: AbortSignal.timeout(5000),
-        });
-        if (!response.ok) {
-            return null;
-        }
-        const data = await response.json();
-        // ip-api.com returns status field
-        if (data.status === 'fail') {
-            return null;
-        }
-        return data.query || null;
-    }
-    catch (error) {
-        // Silently fail - don't break user experience
-        if (error.name !== 'AbortError') {
-            console.warn('[IP Geolocation] Error fetching public IP:', error.message);
-        }
-        return null;
-    }
-}
-/**
- * Get location from IP address using ip-api.com
- * Free tier: 45 requests/minute, no API key required
- *
- * Alternative services:
- * - ipapi.co (requires API key for production)
- * - ipgeolocation.io (requires API key)
- * - ip-api.com (free tier available)
- */
-async function getIPLocation(ip) {
-    // Skip localhost/private IPs (these can't be geolocated)
-    if (!ip ||
-        ip === '0.0.0.0' ||
-        ip === '::1' ||
-        ip.startsWith('127.') ||
-        ip.startsWith('192.168.') ||
-        ip.startsWith('10.') ||
-        ip.startsWith('172.') ||
-        ip.startsWith('::ffff:127.')) {
-        console.log(`[IP Geolocation] Skipping localhost/private IP: ${ip} (geolocation not available for local IPs)`);
-        return null;
-    }
-    try {
-        // Using ip-api.com free tier (JSON format)
-        const response = await fetch(`http://ip-api.com/json/${ip}?fields=status,message,country,countryCode,region,regionName,city,lat,lon,timezone,isp,org,as,query`, {
-            method: 'GET',
-            headers: {
-                Accept: 'application/json',
-            },
-            // Add timeout to prevent hanging
-            signal: AbortSignal.timeout(3000),
-        });
-        if (!response.ok) {
-            console.warn(`[IP Geolocation] Failed to fetch location for IP ${ip}: ${response.status}`);
-            return null;
-        }
-        const data = await response.json();
-        // ip-api.com returns status field
-        if (data.status === 'fail') {
-            console.warn(`[IP Geolocation] API error for IP ${ip}: ${data.message}`);
-            return null;
-        }
-        return {
-            ip: data.query || ip,
-            country: data.country || undefined,
-            countryCode: data.countryCode || undefined,
-            region: data.region || undefined,
-            regionName: data.regionName || undefined,
-            city: data.city || undefined,
-            lat: data.lat || undefined,
-            lon: data.lon || undefined,
-            timezone: data.timezone || undefined,
-            isp: data.isp || undefined,
-            org: data.org || undefined,
-            as: data.as || undefined,
-            query: data.query || ip,
-        };
-    }
-    catch (error) {
-        // Silently fail - don't break user experience
-        if (error.name !== 'AbortError') {
-            console.warn(`[IP Geolocation] Error fetching location for IP ${ip}:`, error.message);
-        }
-        return null;
-    }
-}
-/**
- * Get IP address from request headers
- * Handles various proxy headers (x-forwarded-for, x-real-ip, etc.)
- */
-function getIPFromRequest(req) {
-    // Try various headers that proxies/load balancers use
-    const forwardedFor = req.headers?.get?.('x-forwarded-for') ||
-        req.headers?.['x-forwarded-for'] ||
-        req.headers?.['X-Forwarded-For'];
-    if (forwardedFor) {
-        // x-forwarded-for can contain multiple IPs, take the first one
-        const ips = forwardedFor.split(',').map((ip) => ip.trim());
-        const ip = ips[0];
-        if (ip && ip !== '0.0.0.0') {
-            return ip;
-        }
-    }
-    const realIP = req.headers?.get?.('x-real-ip') ||
-        req.headers?.['x-real-ip'] ||
-        req.headers?.['X-Real-IP'];
-    if (realIP && realIP !== '0.0.0.0') {
-        return realIP.trim();
-    }
-    // Try req.ip (from Express/Next.js)
-    if (req.ip && req.ip !== '0.0.0.0') {
-        return req.ip;
-    }
-    // For localhost, detect if we're running locally
-    if (typeof window === 'undefined') {
-        const hostname = req.headers?.get?.('host') || req.headers?.['host'];
-        if (hostname &&
-            (hostname.includes('localhost') ||
-                hostname.includes('127.0.0.1') ||
-                hostname.startsWith('192.168.'))) {
-            return '127.0.0.1'; // Localhost IP
-        }
-    }
-    // If no IP found and we're in development, return localhost
-    if (typeof process !== 'undefined' && process.env?.NODE_ENV === 'development') {
-        return '127.0.0.1'; // Localhost for development
-    }
-    return '0.0.0.0';
-}
-
 exports.AnalyticsService = AnalyticsService;
 exports.AttributionDetector = AttributionDetector;
 exports.DeviceDetector = DeviceDetector;
@@ -2717,6 +2919,7 @@ exports.checkAndSetLocationConsent = checkAndSetLocationConsent;
 exports.clearLocationConsent = clearLocationConsent;
 exports.clearSession = clearSession;
 exports.default = useAnalytics;
+exports.getCompleteIPLocation = getCompleteIPLocation;
 exports.getIPFromRequest = getIPFromRequest;
 exports.getIPLocation = getIPLocation;
 exports.getLocationConsentTimestamp = getLocationConsentTimestamp;
@@ -2733,6 +2936,7 @@ exports.saveJSON = saveJSON;
 exports.saveSessionJSON = saveSessionJSON;
 exports.setLocationConsentGranted = setLocationConsentGranted;
 exports.trackPageVisit = trackPageVisit;
+exports.transformIPLocationForBackend = transformIPLocationForBackend;
 exports.updateSessionActivity = updateSessionActivity;
 exports.useAnalytics = useAnalytics;
 //# sourceMappingURL=index.cjs.js.map