@affiliateo/react-native 0.1.0 → 1.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@affiliateo/react-native",
-  "version": "0.1.0",
+  "version": "1.0.1",
   "description": "Affiliateo SDK for React Native — mobile affiliate attribution and screen tracking",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -15,6 +15,15 @@
   "peerDependenciesMeta": {
     "react-native-purchases": {
       "optional": true
+    },
+    "expo-application": {
+      "optional": true
+    },
+    "react-native-device-info": {
+      "optional": true
+    },
+    "@react-native-async-storage/async-storage": {
+      "optional": true
     }
   },
   "keywords": ["affiliateo", "affiliate", "attribution", "react-native", "mobile"],

package/src/provider.tsx

@@ -1,119 +1,174 @@
-import React, { createContext, useContext, useEffect, useRef, useState } from 'react'
-import { AppState, Platform } from 'react-native'
-import type { AffiliateoConfig, AffiliateoContextValue } from './types'
-import { AffiliateoClient } from './client'
-import { getDeviceInfo } from './device'
-
-// Generate a simple device ID using platform info + random values
-// Persists for the app session, regenerates on reinstall
-let cachedDeviceId: string | null = null
-
-function getDeviceId(): string {
-  if (cachedDeviceId) return cachedDeviceId
-  const random = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
-    const r = (Math.random() * 16) | 0
-    const v = c === 'x' ? r : (r & 0x3) | 0x8
-    return v.toString(16)
-  })
-  cachedDeviceId = `${Platform.OS}-${random}`
-  return cachedDeviceId
-}
-
-export const AffiliateoContext = createContext<AffiliateoContextValue>({
-  refCode: null,
-  isMatched: false,
-  isLoading: true,
-  visitorId: null,
-})
-
-/**
- * Returns the affiliate ref code and match status.
- */
-export function useAffiliateRef(): AffiliateoContextValue {
-  return useContext(AffiliateoContext)
-}
-
-export function AffiliateoProvider({
-  campaignId,
-  apiUrl,
-  children,
-}: AffiliateoConfig & { children: React.ReactNode }) {
-  const [state, setState] = useState<AffiliateoContextValue>({
-    refCode: null,
-    isMatched: false,
-    isLoading: true,
-    visitorId: null,
-  })
-
-  const clientRef = useRef(new AffiliateoClient(apiUrl))
-  const deviceIdRef = useRef(getDeviceId())
-
-  useEffect(() => {
-    let cancelled = false
-    const client = clientRef.current
-    const deviceId = deviceIdRef.current
-
-    async function init() {
-      // Send session_start immediately
-      client.sendEvents(campaignId, deviceId, [
-        { type: 'session_start', timestamp: new Date().toISOString() },
-      ]).catch(() => {})
-
-      // Identify
-      try {
-        const deviceInfo = getDeviceInfo()
-        const result = await client.identify(campaignId, deviceId, deviceInfo)
-
-        if (cancelled) return
-
-        setState({
-          refCode: result.ref_code,
-          isMatched: result.matched,
-          isLoading: false,
-          visitorId: result.visitor_id,
-        })
-
-        // Auto-set RevenueCat attribute if available
-        if (result.ref_code) {
-          try {
-            const Purchases = require('react-native-purchases').default
-            if (Purchases?.setAttributes) {
-              await Purchases.setAttributes({ affiliateo_ref: result.ref_code })
-            }
-          } catch {
-            // react-native-purchases not installed — that's fine
-          }
-        }
-      } catch {
-        if (cancelled) return
-        setState((s) => ({ ...s, isLoading: false }))
-      }
-    }
-
-    init()
-
-    // AppState listener — send session events immediately
-    const subscription = AppState.addEventListener('change', (nextState) => {
-      if (nextState === 'active') {
-        client.sendEvents(campaignId, deviceId, [
-          { type: 'session_start', timestamp: new Date().toISOString() },
-        ]).catch(() => {})
-      } else if (nextState === 'background' || nextState === 'inactive') {
-        client.sendEvents(campaignId, deviceId, [
-          { type: 'session_end', timestamp: new Date().toISOString() },
-        ]).catch(() => {})
-      }
-    })
-
-    return () => {
-      cancelled = true
-      subscription.remove()
-    }
-  }, [campaignId, apiUrl])
-
-  return (
-    <AffiliateoContext.Provider value={state}>
-      {children}
-    </AffiliateoContext.Provider>
-  )
-}
+import React, { createContext, useContext, useEffect, useRef, useState } from 'react'
+import { AppState, Platform } from 'react-native'
+import type { AffiliateoConfig, AffiliateoContextValue } from './types'
+import { AffiliateoClient } from './client'
+import { getDeviceInfo } from './device'
+
+// Get a stable device ID that persists across app launches.
+// Tries expo-application first (IDFV on iOS, androidId on Android),
+// then falls back to a random UUID saved via AsyncStorage.
+let cachedDeviceId: string | null = null
+
+async function getStableDeviceId(): Promise<string> {
+  if (cachedDeviceId) return cachedDeviceId
+
+  // Try expo-application (built into Expo, no extra install needed)
+  try {
+    const ExpoApp = require('expo-application')
+    if (Platform.OS === 'ios' && ExpoApp.getIosIdForVendorAsync) {
+      const idfv = await ExpoApp.getIosIdForVendorAsync()
+      if (idfv) {
+        cachedDeviceId = `ios-${idfv}`
+        return cachedDeviceId
+      }
+    } else if (Platform.OS === 'android' && ExpoApp.androidId) {
+      cachedDeviceId = `android-${ExpoApp.androidId}`
+      return cachedDeviceId
+    }
+  } catch {
+    // expo-application not available
+  }
+
+  // Try react-native-device-info (for bare RN apps)
+  try {
+    const DeviceInfo = require('react-native-device-info')
+    const uniqueId = await DeviceInfo.getUniqueId()
+    if (uniqueId) {
+      cachedDeviceId = `${Platform.OS}-${uniqueId}`
+      return cachedDeviceId
+    }
+  } catch {
+    // react-native-device-info not available
+  }
+
+  // Fallback: generate a UUID and persist it via AsyncStorage
+  try {
+    const AsyncStorage = require('@react-native-async-storage/async-storage').default
+    const stored = await AsyncStorage.getItem('@affiliateo_device_id')
+    if (stored) {
+      cachedDeviceId = stored
+      return cachedDeviceId
+    }
+
+    const random = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c: string) => {
+      const r = (Math.random() * 16) | 0
+      const v = c === 'x' ? r : (r & 0x3) | 0x8
+      return v.toString(16)
+    })
+    const newId = `${Platform.OS}-${random}`
+    await AsyncStorage.setItem('@affiliateo_device_id', newId)
+    cachedDeviceId = newId
+    return cachedDeviceId
+  } catch {
+    // AsyncStorage not available
+  }
+
+  // Last resort: in-memory random (not ideal — changes on each app restart)
+  const random = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c: string) => {
+    const r = (Math.random() * 16) | 0
+    const v = c === 'x' ? r : (r & 0x3) | 0x8
+    return v.toString(16)
+  })
+  cachedDeviceId = `${Platform.OS}-${random}`
+  return cachedDeviceId
+}
+
+export const AffiliateoContext = createContext<AffiliateoContextValue>({
+  refCode: null,
+  isMatched: false,
+  isLoading: true,
+  visitorId: null,
+})
+
+/**
+ * Returns the affiliate ref code and match status.
+ */
+export function useAffiliateRef(): AffiliateoContextValue {
+  return useContext(AffiliateoContext)
+}
+
+export function AffiliateoProvider({
+  campaignId,
+  apiUrl,
+  children,
+}: AffiliateoConfig & { children: React.ReactNode }) {
+  const [state, setState] = useState<AffiliateoContextValue>({
+    refCode: null,
+    isMatched: false,
+    isLoading: true,
+    visitorId: null,
+  })
+
+  const clientRef = useRef(new AffiliateoClient(apiUrl))
+  const deviceIdRef = useRef<string | null>(null)
+
+  useEffect(() => {
+    let cancelled = false
+    const client = clientRef.current
+
+    async function init() {
+      // Get stable device ID (persists across app launches)
+      const deviceId = await getStableDeviceId()
+      deviceIdRef.current = deviceId
+
+      // Identify (also inserts session_start on the backend)
+      try {
+        const deviceInfo = getDeviceInfo()
+        const result = await client.identify(campaignId, deviceId, deviceInfo)
+
+        if (cancelled) return
+
+        setState({
+          refCode: result.ref_code,
+          isMatched: result.matched,
+          isLoading: false,
+          visitorId: result.visitor_id,
+        })
+
+        // Auto-set RevenueCat attribute if available
+        if (result.ref_code) {
+          try {
+            const Purchases = require('react-native-purchases').default
+            if (Purchases?.setAttributes) {
+              await Purchases.setAttributes({ affiliateo_ref: result.ref_code })
+            }
+          } catch {
+            // react-native-purchases not installed — that's fine
+          }
+        }
+      } catch {
+        if (cancelled) return
+        setState((s) => ({ ...s, isLoading: false }))
+      }
+    }
+
+    init()
+
+    // AppState listener — send session events
+    const subscription = AppState.addEventListener('change', (nextState) => {
+      const deviceId = deviceIdRef.current
+      if (!deviceId) return
+
+      if (nextState === 'active') {
+        client.sendEvents(campaignId, deviceId, [
+          { type: 'session_start', timestamp: new Date().toISOString() },
+        ]).catch(() => {})
+      } else if (nextState === 'background' || nextState === 'inactive') {
+        client.sendEvents(campaignId, deviceId, [
+          { type: 'session_end', timestamp: new Date().toISOString() },
+        ]).catch(() => {})
+      }
+    })
+
+    return () => {
+      cancelled = true
+      subscription.remove()
+    }
+  }, [campaignId, apiUrl])
+
+  return (
+    <AffiliateoContext.Provider value={state}>
+      {children}
+    </AffiliateoContext.Provider>
+  )
+}