mimz-react-native-tracker 1.0.0 → 1.0.1

package/bin/mimz-setup.js

@@ -84,20 +84,13 @@ const getTrackingInitCode = (cId, bUrl, appName) => {
           asyncStorage: AsyncStorage,
           appName: '${appName}',
           appVersion: '1.0.0',
+          autoTrack: true, // Automatically captures UTMs from deep links and handles background sync
         });
       } catch (error) {
         console.warn('Mimz tracking init failed:', error.message);
       }
     };
     initMimzTracking();
-
-    // Flush tracking data when app goes to background
-    const subscription = require('react-native').AppState.addEventListener('change', (state) => {
-      if (state === 'background' || state === 'inactive') {
-        MimzTracker.flush();
-      }
-    });
-    return () => subscription.remove();
   }, []);
   // ── End Mimz Tracking ──────────────────────────────────────────────────`;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mimz-react-native-tracker",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Mimz Analytics Tracking SDK for React Native apps. Track visitors, UTM parameters, conversions, contacts, and user engagement in native mobile apps.",
   "main": "src/index.js",
   "types": "src/index.d.ts",
@@ -44,4 +44,4 @@
     "type": "git",
     "url": ""
   }
-}
+}

package/src/index.d.ts

@@ -13,6 +13,8 @@ export interface MimzConfig {
   appName?: string;
   /** Your app's version */
   appVersion?: string;
+  /** Optional custom user ID / visitor ID */
+  userId?: string;
 }
 
 export interface ConversionData {
@@ -105,6 +107,11 @@ export function identify(userData?: UserData): Promise<void>;
  */
 export function setUtmParams(utms?: UtmParams): Promise<void>;
 
+/**
+ * Set a custom user ID (visitorId) manually
+ */
+export function setUserId(newUserId: string): Promise<void>;
+
 /**
  * Get the current visitor ID
  */

package/src/tracker.js

@@ -69,6 +69,7 @@ const API_ENDPOINTS = {
  * @param {object} config.asyncStorage - The AsyncStorage module (REQUIRED - from @react-native-async-storage/async-storage)
  * @param {string} [config.appName] - Your app's name (for tracking context)
  * @param {string} [config.appVersion] - Your app's version (for tracking context)
+ * @param {string} [config.userId] - Optional custom user ID / visitor ID (to keep it consistent with other tracking like push notifications)
  *
  * @example
  * import AsyncStorage from '@react-native-async-storage/async-storage';
@@ -76,6 +77,7 @@ const API_ENDPOINTS = {
  *
  * await MimzTracker.init({
  *   clientId: '68b58625949a81fd08330b38',
+ *   userId: 'your_custom_user_id', // Optional
  *   backendUrl: 'https://mimz-backend.onrender.com',
  *   asyncStorage: AsyncStorage,
  *   appName: 'MyApp',
@@ -88,7 +90,7 @@ const init = async (config = {}) => {
     return;
   }
 
-  const { clientId: cId, backendUrl, asyncStorage, appName: an, appVersion: av } = config;
+  const { clientId: cId, backendUrl, asyncStorage, appName: an, appVersion: av, userId: customUserId } = config;
 
   // Validate required fields
   if (!cId) {
@@ -114,12 +116,17 @@ const init = async (config = {}) => {
   sessionStartTime = Date.now();
 
   // ── Restore or create visitor ID ────────────────────────────────────────
-  const storedVisitorId = await storage.get('visitorId');
-  if (storedVisitorId) {
-    visitorId = storedVisitorId;
-  } else {
-    visitorId = generateUniqueId();
+  if (customUserId) {
+    visitorId = customUserId;
     await storage.set('visitorId', visitorId);
+  } else {
+    const storedVisitorId = await storage.get('visitorId');
+    if (storedVisitorId) {
+      visitorId = storedVisitorId;
+    } else {
+      visitorId = generateUniqueId();
+      await storage.set('visitorId', visitorId);
+    }
   }
 
   // ── Create a new visit ID for this session ────────────────────────────
@@ -173,12 +180,56 @@ const init = async (config = {}) => {
   const trackingData = await _buildTrackingPayload();
   await _postVisitorData(trackingData);
 
+  // ── Auto-Tracking (Deep Links & App State) ────────────────────────────
+  if (config.autoTrack !== false) {
+    _setupAutoTracking();
+  }
+
   console.log('[MimzTracker] ✅ Initialized successfully');
   console.log(`[MimzTracker] visitorId: ${visitorId}`);
   console.log(`[MimzTracker] visitId: ${visitId}`);
   console.log(`[MimzTracker] sessionCount: ${sessionCount}`);
 };
 
+/**
+ * Automatically sets up listeners for deep links and app lifecycle
+ */
+const _setupAutoTracking = () => {
+  try {
+    const { AppState, Linking } = require('react-native');
+
+    // 1. Flush data when app goes to background
+    if (AppState) {
+      AppState.addEventListener('change', (state) => {
+        if (state === 'background' || state === 'inactive') {
+          flush();
+        }
+      });
+      console.log('[MimzTracker] 🔄 Auto-flush on background enabled');
+    }
+
+    // 2. Automatically capture UTMs from deep links
+    if (Linking) {
+      // Handle app opened from background via deep link
+      Linking.addEventListener('url', (event) => {
+        if (event.url) {
+          trackDeepLink(event.url, 'auto_linking');
+        }
+      });
+
+      // Handle app started cold via deep link
+      Linking.getInitialURL().then((url) => {
+        if (url) {
+          trackDeepLink(url, 'auto_initial_url');
+        }
+      });
+      console.log('[MimzTracker] 🔗 Auto-deep-link UTM tracking enabled');
+    }
+  } catch (error) {
+    console.warn('[MimzTracker] ⚠️ Could not setup auto-tracking. Are you in a React Native environment?');
+  }
+};
+
 /**
  * Track a deep link URL — extracts and stores UTM parameters
  * Call this whenever your app receives a deep link / universal link
@@ -447,6 +498,25 @@ const setUtmParams = async (utms = {}) => {
   console.log('[MimzTracker] 🏷️ UTM params set:', utms);
 };
 
+/**
+ * Set a custom user ID (visitorId) manually
+ * Use this when the user logs in or when you receive a push notification ID
+ * 
+ * @param {string} newUserId 
+ */
+const setUserId = async (newUserId) => {
+  if (!newUserId) return;
+  visitorId = newUserId;
+  await storage.set('visitorId', visitorId);
+  console.log(`[MimzTracker] 🆔 User ID set to: ${newUserId}`);
+  
+  if (isInitialized) {
+    // Re-post visitor data with updated user info
+    const trackingData = await _buildTrackingPayload();
+    await _postVisitorData(trackingData);
+  }
+};
+
 /**
  * Get the current visitor ID
  * @returns {string|null}
@@ -639,6 +709,7 @@ module.exports = {
   trackContact,
   identify,
   setUtmParams,
+  setUserId,
   getVisitorId,
   getVisitId,
   getSessionDuration,