mimz-react-native-tracker 1.0.0

package/src/utils.js

@@ -0,0 +1,180 @@
+/**
+ * MimzUtils - Utility helpers for the Mimz React Native SDK
+ * Replaces browser-specific utilities (URL parsing, device info, etc.)
+ */
+
+const { Platform, Dimensions } = require('react-native');
+
+/**
+ * Generate a unique ID (replaces browser Date.now().toString(36) + random)
+ * @returns {string}
+ */
+const generateUniqueId = () => {
+  return Date.now().toString(36) + Math.random().toString(36).substring(2);
+};
+
+/**
+ * Parse UTM parameters from a URL string (e.g., a deep link)
+ * In native apps, UTMs come from deep links, not the current URL bar
+ * @param {string} url - The deep link URL to parse
+ * @returns {object} - Object containing all found UTM and tracking params
+ */
+const parseUtmFromUrl = (url) => {
+  const utmParams = {};
+
+  if (!url || typeof url !== 'string') return utmParams;
+
+  try {
+    // Handle both full URLs and query strings
+    let queryString = '';
+    if (url.includes('?')) {
+      queryString = url.split('?')[1];
+    } else if (url.includes('&') || url.includes('=')) {
+      queryString = url;
+    }
+
+    if (!queryString) return utmParams;
+
+    // Standard UTM parameters
+    const trackedFields = [
+      'utm_source',
+      'utm_medium',
+      'utm_campaign',
+      'utm_term',
+      'utm_content',
+      'utm_device',
+      'utm_devicemodel',
+      // Additional tracking parameters
+      'fbclid',
+      'msclkid',
+      'gclid',
+    ];
+
+    // Parse query string manually (no URLSearchParams in some RN environments)
+    const pairs = queryString.split('&');
+    pairs.forEach((pair) => {
+      const [key, value] = pair.split('=');
+      if (key && value) {
+        const decodedKey = decodeURIComponent(key.trim());
+        const decodedValue = decodeURIComponent(value.trim());
+        if (trackedFields.includes(decodedKey)) {
+          utmParams[decodedKey] = decodedValue;
+        }
+      }
+    });
+  } catch (error) {
+    console.warn('[MimzTracker] Error parsing UTM from URL:', error.message);
+  }
+
+  return utmParams;
+};
+
+/**
+ * Get device information (replaces browser userAgent-based detection)
+ * @returns {object} - Device info object
+ */
+const getDeviceInfo = () => {
+  const { width, height } = Dimensions.get('window');
+  const pixelRatio = require('react-native').PixelRatio?.get() || 1;
+
+  return {
+    screenWidth: width,
+    screenHeight: height,
+    deviceType: Platform.isPad ? 'Tablet' : 'Mobile',
+    deviceModel: Platform.constants?.Model || Platform.constants?.Brand || 'Unknown',
+    os: Platform.OS === 'ios' ? 'iOS' : Platform.OS === 'android' ? 'Android' : Platform.OS,
+    osVersion: Platform.Version ? String(Platform.Version) : 'Unknown',
+    browser: 'Native App',
+    language: 'en', // Can be overridden via react-native-localize
+    colorDepth: 24,
+    pixelRatio: pixelRatio,
+    touchScreen: true,
+    userAgent: `MimzSDK/1.0 (${Platform.OS}; ${Platform.Version})`,
+    platform: 'react-native',
+  };
+};
+
+/**
+ * Determine traffic source from a referral URL (deep link referrer)
+ * @param {string} referrerUrl - The referrer/deep link source URL
+ * @returns {object} - Traffic source details
+ */
+const getTrafficSource = (referrerUrl) => {
+  let source = 'Direct';
+  let trafficSource = 'Direct';
+
+  if (!referrerUrl || typeof referrerUrl !== 'string') {
+    return { trafficSource, source, organicSource: null, organicSourceStr: null };
+  }
+
+  const lowerUrl = referrerUrl.toLowerCase();
+
+  // Detect source from the referrer URL
+  if (lowerUrl.includes('google')) source = 'Google';
+  else if (lowerUrl.includes('facebook') || lowerUrl.includes('fb.com')) source = 'Facebook';
+  else if (lowerUrl.includes('instagram')) source = 'Instagram';
+  else if (lowerUrl.includes('twitter') || lowerUrl.includes('t.co')) source = 'Twitter';
+  else if (lowerUrl.includes('linkedin')) source = 'LinkedIn';
+  else if (lowerUrl.includes('youtube')) source = 'YouTube';
+  else if (lowerUrl.includes('snapchat')) source = 'Snapchat';
+  else if (lowerUrl.includes('pinterest')) source = 'Pinterest';
+  else if (lowerUrl.includes('bing')) source = 'Bing';
+  else if (lowerUrl.includes('yahoo')) source = 'Yahoo';
+  else if (lowerUrl.includes('duckduckgo')) source = 'Duckduckgo';
+  else if (lowerUrl.includes('tumblr')) source = 'Tumblr';
+  else source = 'Other';
+
+  // Classify traffic type
+  const searchEngines = ['Google', 'Bing', 'Yahoo', 'Duckduckgo'];
+  const socialPlatforms = ['Facebook', 'Twitter', 'Instagram', 'Snapchat', 'YouTube', 'Pinterest', 'LinkedIn', 'Tumblr'];
+
+  if (searchEngines.includes(source)) {
+    trafficSource = 'Organic';
+  } else if (socialPlatforms.includes(source)) {
+    trafficSource = 'Social';
+  } else if (source === 'Direct') {
+    trafficSource = 'Direct';
+  } else {
+    trafficSource = 'Referral';
+  }
+
+  return {
+    trafficSource,
+    source,
+    organicSource: trafficSource === 'Organic' ? referrerUrl : null,
+    organicSourceStr: trafficSource === 'Organic' ? source : null,
+  };
+};
+
+/**
+ * Get the user's IP address using an external service
+ * @returns {Promise<string>}
+ */
+const getUserIp = async () => {
+  try {
+    const controller = typeof AbortController !== 'undefined' ? new AbortController() : null;
+    const timeoutId = controller ? setTimeout(() => controller.abort(), 2000) : null;
+
+    const response = await fetch('https://api.ipify.org?format=json', {
+      signal: controller?.signal,
+    });
+
+    if (timeoutId) clearTimeout(timeoutId);
+
+    if (response.ok) {
+      const data = await response.json();
+      return data?.ip || '0.0.0.0';
+    }
+    return '0.0.0.0';
+  } catch (error) {
+    return '0.0.0.0';
+  }
+};
+
+module.exports = {
+  generateUniqueId,
+  parseUtmFromUrl,
+  getDeviceInfo,
+  getTrafficSource,
+  getUserIp,
+};