@datalyr/react-native 1.3.0 → 1.4.0

package/src/datalyr-sdk.ts

@@ -33,6 +33,7 @@ import { ConversionValueEncoder, ConversionTemplates } from './ConversionValueEn
 import { SKAdNetworkBridge } from './native/SKAdNetworkBridge';
 import { metaIntegration, tiktokIntegration, appleSearchAdsIntegration, playInstallReferrerIntegration } from './integrations';
 import { AppleSearchAdsAttribution } from './native/DatalyrNativeBridge';
+import { networkStatusManager } from './network-status';
 
 export class DatalyrSDK {
   private state: SDKState;
@@ -40,6 +41,7 @@ export class DatalyrSDK {
   private eventQueue: EventQueue;
   private autoEventsManager: AutoEventsManager | null = null;
   private appStateSubscription: any = null;
+  private networkStatusUnsubscribe: (() => void) | null = null;
   private static conversionEncoder?: ConversionValueEncoder;
   private static debugEnabled = false;
 
@@ -112,21 +114,21 @@ export class DatalyrSDK {
         maxRetryCount: this.state.config.maxRetries || 3,
       });
 
-      // Initialize visitor ID, anonymous ID and session
-      this.state.visitorId = await getOrCreateVisitorId();
-      this.state.anonymousId = await getOrCreateAnonymousId();
-      this.state.sessionId = await getOrCreateSessionId();
-
-      // Load persisted user data
-      await this.loadPersistedUserData();
-
-      // Initialize attribution manager
-      if (this.state.config.enableAttribution) {
-        await attributionManager.initialize();
-      }
+      // PARALLEL INITIALIZATION: IDs and core managers
+      // Run ID creation and core manager initialization in parallel for faster startup
+      const [visitorId, anonymousId, sessionId] = await Promise.all([
+        getOrCreateVisitorId(),
+        getOrCreateAnonymousId(),
+        getOrCreateSessionId(),
+        // These run concurrently but don't return values we need to capture
+        this.loadPersistedUserData(),
+        this.state.config.enableAttribution ? attributionManager.initialize() : Promise.resolve(),
+        journeyManager.initialize(),
+      ]);
 
-      // Initialize journey tracking (for first-touch, last-touch, touchpoints)
-      await journeyManager.initialize();
+      this.state.visitorId = visitorId;
+      this.state.anonymousId = anonymousId;
+      this.state.sessionId = sessionId;
 
       // Record initial attribution to journey if this is a new session with attribution
       const initialAttribution = attributionManager.getAttributionData();
@@ -169,7 +171,7 @@ export class DatalyrSDK {
         }
       }, 50);
 
-      // Initialize SKAdNetwork conversion encoder
+      // Initialize SKAdNetwork conversion encoder (synchronous, no await needed)
       if (config.skadTemplate) {
         const template = ConversionTemplates[config.skadTemplate];
         if (template) {
@@ -183,29 +185,41 @@ export class DatalyrSDK {
         }
       }
 
-      // Initialize Meta SDK if configured
+      // PARALLEL INITIALIZATION: Network monitoring and platform integrations
+      // These are independent and can run concurrently for faster startup
+      const platformInitPromises: Promise<void>[] = [
+        // Network monitoring
+        this.initializeNetworkMonitoring(),
+        // Apple Search Ads (iOS only)
+        appleSearchAdsIntegration.initialize(config.debug),
+        // Google Play Install Referrer (Android only)
+        playInstallReferrerIntegration.initialize(),
+      ];
+
+      // Add Meta initialization if configured
       if (config.meta?.appId) {
-        await metaIntegration.initialize(config.meta, config.debug);
-
-        // Fetch deferred deep link and merge with attribution
-        if (config.enableAttribution !== false) {
-          const deferredLink = await metaIntegration.fetchDeferredDeepLink();
-          if (deferredLink) {
-            await this.handleDeferredDeepLink(deferredLink);
-          }
-        }
+        platformInitPromises.push(
+          metaIntegration.initialize(config.meta, config.debug).then(async () => {
+            // After Meta initializes, fetch deferred deep link
+            if (config.enableAttribution !== false) {
+              const deferredLink = await metaIntegration.fetchDeferredDeepLink();
+              if (deferredLink) {
+                await this.handleDeferredDeepLink(deferredLink);
+              }
+            }
+          })
+        );
       }
 
-      // Initialize TikTok SDK if configured
+      // Add TikTok initialization if configured
       if (config.tiktok?.appId && config.tiktok?.tiktokAppId) {
-        await tiktokIntegration.initialize(config.tiktok, config.debug);
+        platformInitPromises.push(
+          tiktokIntegration.initialize(config.tiktok, config.debug)
+        );
       }
 
-      // Initialize Apple Search Ads attribution (iOS only, auto-fetches on init)
-      await appleSearchAdsIntegration.initialize(config.debug);
-
-      // Initialize Google Play Install Referrer (Android only)
-      await playInstallReferrerIntegration.initialize();
+      // Wait for all platform integrations to complete
+      await Promise.all(platformInitPromises);
 
       debugLog('Platform integrations initialized', {
         meta: metaIntegration.isAvailable(),
@@ -1094,6 +1108,45 @@ export class DatalyrSDK {
     }
   }
 
+  /**
+   * Initialize network status monitoring
+   * Automatically updates event queue when network status changes
+   */
+  private async initializeNetworkMonitoring(): Promise<void> {
+    try {
+      await networkStatusManager.initialize();
+
+      // Update event queue with current network status
+      this.state.isOnline = networkStatusManager.isOnline();
+      this.eventQueue.setOnlineStatus(this.state.isOnline);
+
+      // Subscribe to network changes
+      this.networkStatusUnsubscribe = networkStatusManager.subscribe((state) => {
+        const isOnline = state.isConnected && (state.isInternetReachable !== false);
+        this.state.isOnline = isOnline;
+        this.eventQueue.setOnlineStatus(isOnline);
+
+        // Track network status change event (only if SDK is fully initialized)
+        if (this.state.initialized) {
+          this.track('$network_status_change', {
+            is_online: isOnline,
+            network_type: state.type,
+            is_internet_reachable: state.isInternetReachable,
+          }).catch(() => {
+            // Ignore errors for network status events
+          });
+        }
+      });
+
+      debugLog(`Network monitoring initialized, online: ${this.state.isOnline}`);
+    } catch (error) {
+      errorLog('Error initializing network monitoring (non-blocking):', error as Error);
+      // Default to online if monitoring fails
+      this.state.isOnline = true;
+      this.eventQueue.setOnlineStatus(true);
+    }
+  }
+
   /**
    * Set up app state monitoring for lifecycle events (optimized)
    */
@@ -1114,6 +1167,8 @@ export class DatalyrSDK {
         } else if (nextAppState === 'active') {
           // App became active, ensure we have fresh session if needed
           this.refreshSession();
+          // Refresh network status when coming back from background
+          networkStatusManager.refresh();
           // Notify auto-events manager for session handling
           if (this.autoEventsManager) {
             this.autoEventsManager.handleAppForeground();
@@ -1154,6 +1209,15 @@ export class DatalyrSDK {
         this.appStateSubscription = null;
       }
 
+      // Remove network status listener
+      if (this.networkStatusUnsubscribe) {
+        this.networkStatusUnsubscribe();
+        this.networkStatusUnsubscribe = null;
+      }
+
+      // Destroy network status manager
+      networkStatusManager.destroy();
+
       // Destroy event queue
       this.eventQueue.destroy();
 

package/src/index.ts

@@ -29,7 +29,11 @@ export { ConversionValueEncoder, ConversionTemplates } from './ConversionValueEn
 export { SKAdNetworkBridge } from './native/SKAdNetworkBridge';
 
 // Export platform integrations
-export { metaIntegration, tiktokIntegration, appleSearchAdsIntegration } from './integrations';
+export { metaIntegration, tiktokIntegration, appleSearchAdsIntegration, playInstallReferrerIntegration } from './integrations';
+
+// Export network status manager
+export { networkStatusManager } from './network-status';
+export type { NetworkState, NetworkStateListener } from './network-status';
 
 // Export native bridge types
 export type { AppleSearchAdsAttribution } from './native/DatalyrNativeBridge';

package/src/integrations/play-install-referrer.ts

@@ -19,7 +19,9 @@
  * - referrer_url: Full referrer URL from Play Store
  * - referrer_click_timestamp: When the referrer link was clicked
  * - install_begin_timestamp: When the install began
- * - gclid: Google Ads click ID (if present)
+ * - gclid: Google Ads click ID (standard)
+ * - gbraid: Google Ads privacy-safe click ID (iOS App campaigns)
+ * - wbraid: Google Ads privacy-safe click ID (Web-to-App campaigns)
  * - utm_source, utm_medium, utm_campaign, etc.
  */
 
@@ -37,6 +39,10 @@ export interface PlayInstallReferrer {
   installCompleteTimestamp?: number;
   // Google Ads click ID
   gclid?: string;
+  // Google Ads privacy-safe click IDs (iOS App campaigns)
+  gbraid?: string;
+  // Google Ads privacy-safe click IDs (Web-to-App campaigns)
+  wbraid?: string;
   // UTM Parameters
   utmSource?: string;
   utmMedium?: string;
@@ -94,6 +100,8 @@ class PlayInstallReferrerIntegration {
           utmSource: this.referrerData.utmSource,
           utmMedium: this.referrerData.utmMedium,
           hasGclid: !!this.referrerData.gclid,
+          hasGbraid: !!this.referrerData.gbraid,
+          hasWbraid: !!this.referrerData.wbraid,
         });
       }
     } catch (error) {
@@ -149,12 +157,15 @@ class PlayInstallReferrerIntegration {
       params.utmTerm = searchParams.get('utm_term') || undefined;
       params.utmContent = searchParams.get('utm_content') || undefined;
 
-      // Extract click IDs
+      // Extract click IDs (gclid, gbraid, wbraid)
       params.gclid = searchParams.get('gclid') || undefined;
+      params.gbraid = searchParams.get('gbraid') || undefined;
+      params.wbraid = searchParams.get('wbraid') || undefined;
 
       // Store any additional parameters
+      const knownParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'gclid', 'gbraid', 'wbraid'];
       searchParams.forEach((value, key) => {
-        if (!key.startsWith('utm_') && key !== 'gclid') {
+        if (!knownParams.includes(key) && !key.startsWith('utm_')) {
           params[key] = value;
         }
       });
@@ -186,8 +197,12 @@ class PlayInstallReferrerIntegration {
       referrer_click_timestamp: this.referrerData.referrerClickTimestamp,
       install_begin_timestamp: this.referrerData.installBeginTimestamp,
 
-      // Standard attribution fields
+      // Google Ads click IDs (gclid is standard, gbraid/wbraid are privacy-safe alternatives)
       gclid: this.referrerData.gclid,
+      gbraid: this.referrerData.gbraid,
+      wbraid: this.referrerData.wbraid,
+
+      // UTM parameters
       utm_source: this.referrerData.utmSource,
       utm_medium: this.referrerData.utmMedium,
       utm_campaign: this.referrerData.utmCampaign,

package/src/native/DatalyrNativeBridge.ts

@@ -8,6 +8,7 @@
  */
 
 import { NativeModules, Platform } from 'react-native';
+import { requireNativeModule } from 'expo-modules-core';
 
 /**
  * Apple Search Ads attribution data returned from AdServices API (iOS only)
@@ -107,11 +108,23 @@ interface PlayInstallReferrerModule {
 }
 
 // Native modules - available on both iOS and Android
-const DatalyrNative: DatalyrNativeModule | null = NativeModules.DatalyrNative ?? null;
+// iOS uses Expo Modules (new arch compatible), Android uses NativeModules (interop layer)
+let DatalyrNative: DatalyrNativeModule | null = null;
+if (Platform.OS === 'ios') {
+  try {
+    DatalyrNative = requireNativeModule<DatalyrNativeModule>('DatalyrNative');
+  } catch {
+    // Native module not available
+  }
+} else if (Platform.OS === 'android') {
+  DatalyrNative = NativeModules.DatalyrNative ?? null;
+}
 
-// Play Install Referrer - Android only
-const DatalyrPlayInstallReferrer: PlayInstallReferrerModule | null =
-  Platform.OS === 'android' ? NativeModules.DatalyrPlayInstallReferrer : null;
+// Play Install Referrer - Android only (stays on NativeModules)
+let DatalyrPlayInstallReferrer: PlayInstallReferrerModule | null = null;
+if (Platform.OS === 'android') {
+  DatalyrPlayInstallReferrer = NativeModules.DatalyrPlayInstallReferrer ?? null;
+}
 
 /**
  * Check if native module is available