appsprint-react-native 0.2.0 → 1.0.4

package/README.md

@@ -1,22 +1,41 @@
-# appsprint-react-native
+# AppSprint for React Native
 
-AppSprint mobile attribution SDK for React Native. It tracks installs, attribution, lifecycle events, custom events, and revenue events, with local event queueing for transient failures.
+Mobile attribution and event tracking for React Native, with native iOS and Android SDKs bundled inside. Works with bare React Native and Expo. The JS bridge is thin: it forwards calls to the same native engines as our standalone iOS and Android SDKs.
 
-## Installation
+## Requirements
+
+- React Native 0.71 or later
+- React 18 or later
+- iOS 14.0 or later
+- Android 7.0 (API 24) or later
+
+## Install
 
 ```bash
 npm install appsprint-react-native
 ```
 
+or
+
+```bash
+yarn add appsprint-react-native
+```
+
 ### iOS
 
 ```bash
 cd ios && pod install
 ```
 
-## Expo config plugin
+The native pod is vendored inside the package, so no extra repository setup is needed.
+
+### Android
+
+Auto-linking handles the Android side. The package's manifest declares `INTERNET` and `com.google.android.gms.permission.AD_ID`, which merge into your app at build time.
+
+### Expo
 
-If you use Expo prebuild, add the plugin to your app config:
+If you use Expo prebuild, add the config plugin to `app.json` or `app.config.js`:
 
 ```json
 {
@@ -24,23 +43,23 @@ If you use Expo prebuild, add the plugin to your app config:
     [
       "appsprint-react-native",
       {
-        "trackingDescription": "This identifier will be used to deliver personalized ads to you."
+        "trackingDescription": "This identifier helps us deliver personalized ads."
       }
     ]
   ]
 }
 ```
 
-Plugin options:
+The plugin injects `NSUserTrackingUsageDescription` on iOS and the Android permissions during prebuild.
 
-| Option | Type | Description | Default |
+| Plugin option | Type | Description | Default |
 |---|---|---|---|
-| `trackingDescription` | `string` | ATT permission dialog text for `NSUserTrackingUsageDescription` | `"This identifier will be used to deliver personalized ads to you."` |
-| `advertisingAttributionEndpoint` | `string` | Sets `NSAdvertisingAttributionReportEndpoint` | — |
+| `trackingDescription` | `string` | Text for the ATT permission prompt. | `"This identifier will be used to deliver personalized ads to you."` |
+| `advertisingAttributionEndpoint` | `string` | Sets `NSAdvertisingAttributionReportEndpoint`. | none |
 
-## Quick start
+## Configure
 
-Initialize the SDK as early as possible in app startup:
+Call `configure` once at app startup. It returns a promise that resolves after local state is restored; install registration runs in the background:
 
 ```tsx
 import { AppSprint } from "appsprint-react-native";
@@ -50,28 +69,48 @@ await AppSprint.configure({
 });
 ```
 
-### Configuration
+A typical app calls this from `App.tsx` (or `app/_layout.tsx` on Expo Router):
 
-| Option | Type | Required | Default |
-|---|---|---|---|
-| `apiKey` | `string` | Yes | — |
-| `apiUrl` | `string` | No | `https://api.appsprint.app` |
-| `enableAppleAdsAttribution` | `boolean` | No | `true` |
-| `isDebug` | `boolean` | No | `false` |
-| `logLevel` | `0 \| 1 \| 2 \| 3` | No | `2` |
-| `customerUserId` | `string \| null` | No | `null` |
+```tsx
+import { useEffect } from "react";
+import { AppSprint, NativeAppSprint } from "appsprint-react-native";
+
+export default function App() {
+  useEffect(() => {
+    (async () => {
+      await AppSprint.configure({ apiKey: "YOUR_API_KEY" });
+
+      // iOS only. Skipped at runtime on Android.
+      await NativeAppSprint.requestTrackingAuthorization();
+    })();
+  }, []);
 
-Log levels:
+  return <RootNavigator />;
+}
+```
 
-`0 = debug`, `1 = info`, `2 = warn`, `3 = error`
+### Configuration options
 
-## Sending events
+| Option | Type | Default | What it does |
+|---|---|---|---|
+| `apiKey` | `string` | required | Your AppSprint app key. |
+| `apiUrl` | `string` | `https://api.appsprint.app` | Override for staging or self-hosted environments. |
+| `endpointBaseUrl` | `string` | alias for `apiUrl` | Accepted for compatibility. |
+| `enableAppleAdsAttribution` | `boolean` | `true` | iOS only. Fetches Apple AdServices at install time. |
+| `customerUserId` | `string \| null` | `null` | Your internal user ID. Persists across launches and replays if the first send fails. |
+| `autoTrackSessions` | `boolean` | `true` | Fires `session_start` on `configure()` and on foreground, debounced to one event per 30 minutes. |
+| `autoRefreshAttribution` | `boolean` | `true` | Refreshes attribution from the backend on `configure()` and on foreground. |
+| `isDebug` | `boolean` | `false` | Forces debug-level logging on the native side. |
+| `logLevel` | `0 \| 1 \| 2 \| 3` | `2` | `0 = debug`, `1 = info`, `2 = warn`, `3 = error`. |
+
+## Track events
 
 ```tsx
 import { AppSprint } from "appsprint-react-native";
 
 await AppSprint.sendEvent("login");
 await AppSprint.sendEvent("sign_up");
+
 await AppSprint.sendEvent("purchase", null, {
   revenue: 9.99,
   currency: "USD",
@@ -83,52 +122,65 @@ await AppSprint.sendEvent("custom", "onboarding_step", {
 });
 ```
 
-Supported `eventType` values:
+`sendEvent` resolves once the native side has queued the event locally. The actual HTTP send happens on the next flush trigger (foreground, background, or another `sendEvent`).
 
-`login` | `sign_up` | `register` | `purchase` | `subscribe` | `start_trial` | `add_to_cart` | `add_to_wishlist` | `initiate_checkout` | `view_content` | `view_item` | `search` | `share` | `tutorial_complete` | `level_start` | `level_complete` | `custom`
+### Built-in event types
 
-Notes:
+`session_start`, `login`, `sign_up`, `register`, `purchase`, `subscribe`, `start_trial`, `add_payment_info`, `add_to_cart`, `add_to_wishlist`, `initiate_checkout`, `view_content`, `view_item`, `search`, `share`, `tutorial_complete`, `achieve_level`, `level_start`, `level_complete`, `custom`.
 
-- Use `eventType: "custom"` together with the optional `name` argument for custom event names.
-- Revenue fields are accepted through `params.revenue` and `params.currency`.
-- If an event cannot be delivered, it is queued locally and retried on the next initialization or explicit flush.
+### Revenue events
 
-## Public API
+Pass `revenue` (or `price` as an alias) plus `currency`. Currency must be a 3-letter ISO code; anything else is dropped on the native side before the request goes out.
 
-### `AppSprint`
+```tsx
+await AppSprint.sendEvent("subscribe", null, {
+  revenue: 4.99,
+  currency: "EUR",
+  plan: "monthly",
+});
+```
+
+### Custom events
 
 ```tsx
-import { AppSprint } from "appsprint-react-native";
+await AppSprint.sendEvent("custom", "level_skip", { level: 12 });
 ```
 
-Available methods:
+Use the second argument (`name`) to label the event. Keep it stable so your dashboard groups it correctly.
 
-- `configure(config)` initializes the SDK and performs install tracking when needed.
-- `sendEvent(eventType, name?, params?)` sends or queues an event.
-- `sendTestEvent()` sends a diagnostic event and returns `{ success, message }`.
-- `flush()` retries queued events immediately.
-- `clearData()` clears cached SDK state and the local event queue.
-- `isSdkDisabled()` returns whether the SDK has been disabled because the API key was rejected.
-- `setCustomerUserId(userId)` updates the customer user id locally and remotely when possible.
-- `getAppSprintId()` returns the cached AppSprint install identifier, if available.
-- `getAttribution()` returns the last cached attribution result, if available.
-- `enableAppleAdsAttribution()` re-enables Apple Ads attribution in the current runtime config.
-- `isInitialized()` reports whether `configure()` completed.
-- `destroy()` removes SDK listeners.
+## Read attribution
 
-### `NativeAppSprint`
+Once an install registers, attribution is cached on the native side. You can read it any time:
 
 ```tsx
-import { NativeAppSprint } from "appsprint-react-native";
+const attribution = await AppSprint.getAttribution();
+const appsprintId = await AppSprint.getAppSprintId();
+const params = await AppSprint.getAttributionParams();
+```
+
+`AttributionResult.source` is one of `apple_ads`, `tracking_link`, or `organic`.
+
+### Forward to RevenueCat or Superwall
+
+`getAttributionParams()` returns a flat `Record<string, string>` shaped for partner SDKs:
+
+```tsx
+import Purchases from "react-native-purchases";
+
+const params = await AppSprint.getAttributionParams();
+Purchases.setAttributes(params);
 ```
 
-Available methods:
+### Manual refresh
 
-- `getDeviceInfo()`
-- `getAdServicesToken()`
-- `requestTrackingAuthorization()`
+If you need the latest server-side resolution (for example after granting ATT mid-session), call `refreshAttribution()`:
 
-Example ATT request on iOS:
+```tsx
+const updated = await AppSprint.refreshAttribution();
+console.log("source =", updated?.source);
+```
+
+## App Tracking Transparency (iOS only)
 
 ```tsx
 import { NativeAppSprint } from "appsprint-react-native";
@@ -136,38 +188,91 @@ import { NativeAppSprint } from "appsprint-react-native";
 const authorized = await NativeAppSprint.requestTrackingAuthorization();
 ```
 
-## Attribution
+The helper waits internally for the app to reach foreground-active before showing the system prompt. If you call it during initial mount, it will queue and run when the user gets to your first screen.
 
-The SDK tracks install attribution once an install is registered. You can read the cached values at any time:
+For bare React Native apps, add `NSUserTrackingUsageDescription` to `ios/<App>/Info.plist`. Expo users get this through the config plugin's `trackingDescription` option.
 
-```tsx
-const attribution = await AppSprint.getAttribution();
-const appsprintId = await AppSprint.getAppSprintId();
+`NativeAppSprint.requestTrackingAuthorization()` resolves `true` on Android without prompting; ATT is iOS-only.
+
+## Google Advertising ID (Android only)
+
+The native Android SDK reads GAID during install registration, off the main thread, honoring Limit Ad Tracking and dropping the all-zero ID. If your app cannot collect advertising IDs (children's apps, regional policies), remove the permission in your host app manifest:
+
+```xml
+<manifest xmlns:tools="http://schemas.android.com/tools" ...>
+    <uses-permission
+        android:name="com.google.android.gms.permission.AD_ID"
+        tools:node="remove" />
+</manifest>
 ```
 
-`AttributionResult.source` can be:
+## What happens behind the scenes
 
-`apple_ads` | `fingerprint` | `organic`
+- `configure()` resolves after local-state restore. Install registration runs in the background and retries with backoff on transient failures.
+- Events queue locally on native storage and survive app restarts.
+- iOS uses connectivity-aware networking, so transient offline windows queue inside the OS rather than failing fast.
+- A rejected API key (`401` or `403`) disables the SDK on the native side. Future events drop until `clearData()` is called.
+- Late identity updates (`setCustomerUserId`, iOS Apple Ads opt-in) retry automatically on the next `configure()` or foreground.
 
-## Offline and retry behavior
+## Privacy
 
-- The SDK keeps up to `100` queued events in local storage.
-- Queued events are flushed after `configure()` and when the app moves to the background.
-- Failed flushes keep the unsent events queued for a later retry.
-- A rejected API key (`401` or `403`) disables the SDK and drops future events until cached data is cleared.
+The vendored iOS framework ships a `PrivacyInfo.xcprivacy` manifest declaring `UserDefaults` access plus `DeviceID`, `ProductInteraction`, `UserID`, `CoarseLocation`, and `OtherDataTypes` collection, all marked `Tracking: true`, with `api.appsprint.app` listed as a tracking domain.
 
-## Local development
+For Android, include advertising ID collection, device IDs, app activity, and (if you set `customerUserId`) user ID in your Play Console Data safety answers.
 
-Point the SDK at a non-production backend during development:
+Don't pass raw PII through `params` or `customerUserId`. Both persist to native storage for retry durability. Use hashed or opaque identifiers instead (SHA-256 of an email, RevenueCat or Superwall `app_user_id`, your internal user UUID).
+
+## Local development
 
 ```tsx
 await AppSprint.configure({
-  apiKey: "YOUR_API_KEY",
+  apiKey: "YOUR_DEV_KEY",
   apiUrl: "http://localhost:3000",
   isDebug: true,
 });
 ```
 
+On Android emulator, use `http://10.0.2.2:3000` to reach the host machine's localhost.
+
+`isDebug: true` raises native log level to `debug`. iOS logs flow into Console.app; Android logs flow into `logcat` under the `AppSprint` tag.
+
+## Public API reference
+
+### `AppSprint`
+
+```tsx
+import { AppSprint } from "appsprint-react-native";
+```
+
+- `configure(config)` initializes the SDK.
+- `sendEvent(eventType, name?, params?)` enqueues an event.
+- `flush()` drains the queue immediately.
+- `refreshAttribution()` fetches the latest attribution from the backend.
+- `setCustomerUserId(userId)` updates the customer user ID.
+- `getAttribution()` returns the cached attribution.
+- `getAttributionParams()` returns the partner-ready payload.
+- `getAppSprintId()` returns the SDK install identifier.
+- `enableAppleAdsAttribution()` re-enables Apple Ads at runtime on iOS; returns `false` on Android.
+- `sendTestEvent()` posts a diagnostic event and resolves to `{ success, message }`.
+- `isInitialized()` reports whether `configure()` resolved.
+- `isSdkDisabled()` reports whether a rejected API key disabled the SDK.
+- `clearData()` wipes local state.
+- `destroy()` removes native lifecycle observers.
+
+### `NativeAppSprint`
+
+```tsx
+import { NativeAppSprint } from "appsprint-react-native";
+```
+
+- `getDeviceInfo()` returns the device fingerprint payload.
+- `getAdServicesToken()` returns Apple's AdServices token on iOS; `null` on Android.
+- `requestTrackingAuthorization()` shows the ATT prompt on iOS; resolves `true` on Android.
+
+## Support
+
+Issues and feature requests on the [GitHub repo](https://github.com/getappsprint/appsprint-react-native). Direct support at support@appsprint.app.
+
 ## License
 
 MIT

package/android/build.gradle

@@ -9,7 +9,7 @@ apply plugin: 'kotlin-android'
 
 android {
   namespace "com.appsprint"
-  compileSdkVersion safeExtGet('compileSdkVersion', 35)
+  compileSdkVersion safeExtGet('compileSdkVersion', 36)
 
   defaultConfig {
     minSdkVersion safeExtGet('minSdkVersion', 24)
@@ -35,5 +35,7 @@ android {
 dependencies {
   implementation "com.facebook.react:react-android:+"
   implementation files('libs/appsprint-sdk.aar')
-  implementation "androidx.lifecycle:lifecycle-process:2.8.7"
+  implementation "androidx.lifecycle:lifecycle-process:2.10.0"
+  implementation "com.google.android.gms:play-services-ads-identifier:18.3.0"
+  implementation "com.android.installreferrer:installreferrer:2.2"
 }

package/android/src/main/AndroidManifest.xml

@@ -1,3 +1,5 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.appsprint">
+  <uses-permission android:name="android.permission.INTERNET" />
+  <uses-permission android:name="com.google.android.gms.permission.AD_ID" />
 </manifest>

package/android/src/main/kotlin/com/appsprint/AppSprintBridgeModule.kt

@@ -3,14 +3,31 @@ package com.appsprint
 import com.appsprint.sdk.AppSprint
 import com.appsprint.sdk.AppSprintConfig
 import com.appsprint.sdk.AppSprintEventType
+import com.appsprint.sdk.AppSprintNative
+import com.appsprint.sdk.AttributionResult
+import com.appsprint.sdk.GoogleAdsConsent
+import com.appsprint.sdk.GoogleAdsConsentStatus
 import com.facebook.react.bridge.*
-import kotlin.concurrent.thread
+import java.util.concurrent.ExecutorService
+import java.util.concurrent.Executors
 
 class AppSprintBridgeModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaModule(reactContext) {
 
     override fun getName(): String = "AppSprintModule"
 
+    @Volatile private var cachedSdk: AppSprint? = null
+    private val bridgeExecutor: ExecutorService = Executors.newSingleThreadExecutor { runnable ->
+        Thread(runnable, "AppSprintRNBridge").apply { isDaemon = true }
+    }
+
     private fun sdk(): AppSprint {
+        cachedSdk?.let { return it }
+        return synchronized(this) {
+            cachedSdk ?: resolveSdk().also { cachedSdk = it }
+        }
+    }
+
+    private fun resolveSdk(): AppSprint {
         val sdkClass = AppSprint::class.java
 
         runCatching {
@@ -24,15 +41,23 @@ class AppSprintBridgeModule(reactContext: ReactApplicationContext) : ReactContex
     }
 
     private fun runAsync(code: String, promise: Promise, block: () -> Unit) {
-        thread(start = true) {
+        bridgeExecutor.execute {
             try {
                 block()
-            } catch (e: Exception) {
-                promise.reject(code, e.message, e)
+            } catch (t: Throwable) {
+                promise.reject(code, t.message, t)
             }
         }
     }
 
+    private fun resolveSync(code: String, promise: Promise, block: () -> Any?) {
+        try {
+            promise.resolve(block())
+        } catch (t: Throwable) {
+            promise.reject(code, t.message, t)
+        }
+    }
+
     // Core SDK
 
     @ReactMethod
@@ -46,14 +71,21 @@ class AppSprintBridgeModule(reactContext: ReactApplicationContext) : ReactContex
         runAsync("CONFIGURE_ERROR", promise) {
             val sdkConfig = AppSprintConfig(
                 apiKey = apiKey,
-                apiUrl = if (config.hasKey("apiUrl")) config.getString("apiUrl") ?: "https://api.appsprint.app" else "https://api.appsprint.app",
+                apiUrl = when {
+                    config.hasKey("apiUrl") -> config.getString("apiUrl") ?: "https://api.appsprint.app"
+                    config.hasKey("endpointBaseUrl") -> config.getString("endpointBaseUrl") ?: "https://api.appsprint.app"
+                    else -> "https://api.appsprint.app"
+                },
                 enableAppleAdsAttribution = if (config.hasKey("enableAppleAdsAttribution")) config.getBoolean("enableAppleAdsAttribution") else true,
                 isDebug = if (config.hasKey("isDebug")) config.getBoolean("isDebug") else false,
                 logLevel = if (config.hasKey("logLevel")) config.getInt("logLevel") else if (config.hasKey("isDebug") && config.getBoolean("isDebug")) 0 else 2,
                 customerUserId = if (config.hasKey("customerUserId")) config.getString("customerUserId") else null,
+                autoTrackSessions = if (config.hasKey("autoTrackSessions")) config.getBoolean("autoTrackSessions") else true,
+                autoRefreshAttribution = if (config.hasKey("autoRefreshAttribution")) config.getBoolean("autoRefreshAttribution") else true,
+                googleAdsConsent = googleAdsConsentFrom(config),
             )
             sdk().configure(sdkConfig)
-            promise.resolve(null)
+            promise.resolve(true)
         }
     }
 
@@ -63,10 +95,10 @@ class AppSprintBridgeModule(reactContext: ReactApplicationContext) : ReactContex
             val type = AppSprintEventType.entries.find { it.wireValue == eventType } ?: AppSprintEventType.CUSTOM
             val params = mutableMapOf<String, Any?>()
             parameters?.toHashMap()?.forEach { (key, value) -> params[key] = value }
-            if (revenue != null && revenue != 0.0) params["revenue"] = revenue
+            if (revenue != null) params["revenue"] = revenue
             if (currency != null) params["currency"] = currency
             sdk().sendEvent(type, name, if (params.isNotEmpty()) params else null)
-            promise.resolve(null)
+            promise.resolve(true)
         }
     }
 
@@ -105,42 +137,101 @@ class AppSprintBridgeModule(reactContext: ReactApplicationContext) : ReactContex
         }
     }
 
+    @ReactMethod
+    fun refreshAttribution(promise: Promise) {
+        runAsync("REFRESH_ATTRIBUTION_ERROR", promise) {
+            promise.resolve(sdk().refreshAttribution()?.let { attributionToMap(it) })
+        }
+    }
+
     @ReactMethod
     fun enableAppleAdsAttribution(promise: Promise) {
-        sdk().enableAppleAdsAttribution()
-        promise.resolve(null)
+        runAsync("APPLE_ADS_ERROR", promise) {
+            promise.resolve(sdk().enableAppleAdsAttribution())
+        }
     }
 
     @ReactMethod
     fun getAppSprintId(promise: Promise) {
-        promise.resolve(sdk().getAppSprintId())
+        resolveSync("GET_APPSPRINT_ID_ERROR", promise) { sdk().getAppSprintId() }
     }
 
     @ReactMethod
     fun getAttribution(promise: Promise) {
-        val attr = sdk().getAttribution()
-        if (attr == null) {
-            promise.resolve(null)
-            return
+        resolveSync("GET_ATTRIBUTION_ERROR", promise) {
+            sdk().getAttribution()?.let { attributionToMap(it) }
         }
+    }
+
+    @ReactMethod
+    fun getAttributionParams(promise: Promise) {
+        resolveSync("GET_ATTRIBUTION_PARAMS_ERROR", promise) {
+            val map = Arguments.createMap()
+            sdk().getAttributionParams().forEach { (key, value) -> map.putString(key, value) }
+            map
+        }
+    }
+
+    private fun attributionToMap(attr: AttributionResult): WritableMap {
         val map = Arguments.createMap()
+        map.putBoolean("isAttributed", attr.isAttributed)
         map.putString("source", attr.source)
         map.putDouble("confidence", attr.confidence)
+        attr.matchType?.let { map.putString("matchType", it) }
         attr.campaignName?.let { map.putString("campaignName", it) }
+        attr.link?.let {
+            val link = Arguments.createMap()
+            link.putString("id", it.id)
+            link.putString("name", it.name)
+            map.putMap("link", link)
+        }
+        attr.appleAds?.let {
+            val appleAds = Arguments.createMap()
+            appleAds.putString("campaignId", it.campaignId)
+            it.orgId?.let { value -> appleAds.putString("orgId", value) }
+            it.adGroupId?.let { value -> appleAds.putString("adGroupId", value) }
+            it.keywordId?.let { value -> appleAds.putString("keywordId", value) }
+            it.adId?.let { value -> appleAds.putString("adId", value) }
+            it.countryOrRegion?.let { value -> appleAds.putString("countryOrRegion", value) }
+            it.claimType?.let { value -> appleAds.putString("claimType", value) }
+            it.clickDate?.let { value -> appleAds.putString("clickDate", value) }
+            it.impressionDate?.let { value -> appleAds.putString("impressionDate", value) }
+            it.conversionType?.let { value -> appleAds.putString("conversionType", value) }
+            it.supplyPlacement?.let { value -> appleAds.putString("supplyPlacement", value) }
+            map.putMap("appleAds", appleAds)
+        }
         attr.utmSource?.let { map.putString("utmSource", it) }
         attr.utmMedium?.let { map.putString("utmMedium", it) }
         attr.utmCampaign?.let { map.putString("utmCampaign", it) }
-        promise.resolve(map)
+        attr.utmContent?.let { map.putString("utmContent", it) }
+        attr.utmTerm?.let { map.putString("utmTerm", it) }
+        return map
+    }
+
+    private fun googleAdsConsentFrom(config: ReadableMap): GoogleAdsConsent? {
+        if (!config.hasKey("googleAdsConsent") || config.isNull("googleAdsConsent")) return null
+        val consent = config.getMap("googleAdsConsent") ?: return null
+        if (!consent.hasKey("adUserData") || consent.isNull("adUserData")) return null
+        if (consent.getType("adUserData") != ReadableType.String) return null
+        return googleAdsConsentStatus(consent.getString("adUserData"))
+            ?.let { GoogleAdsConsent(it) }
+    }
+
+    private fun googleAdsConsentStatus(value: String?): GoogleAdsConsentStatus? {
+        val normalized = value?.trim()?.uppercase(java.util.Locale.US) ?: return null
+        return GoogleAdsConsentStatus.entries.firstOrNull {
+            it.wireValue == normalized || it.name == normalized
+        }
     }
 
     @ReactMethod
     fun isInitialized(promise: Promise) {
-        promise.resolve(sdk().isInitialized())
+        resolveSync("IS_INITIALIZED_ERROR", promise) { sdk().isInitialized() }
     }
 
     @ReactMethod
     fun isSdkDisabled(promise: Promise) {
-        promise.resolve(sdk().isSdkDisabled())
+        resolveSync("SDK_DISABLED_ERROR", promise) { sdk().isSdkDisabled() }
     }
 
     @ReactMethod
@@ -155,18 +246,18 @@ class AppSprintBridgeModule(reactContext: ReactApplicationContext) : ReactContex
 
     @ReactMethod
     fun getDeviceInfo(promise: Promise) {
-        try {
+        runAsync("DEVICE_INFO_ERROR", promise) {
+            val deviceInfo = AppSprintNative(reactApplicationContext).getDeviceInfo(includeAdvertisingId = true)
             val info = Arguments.createMap()
-            info.putString("deviceModel", android.os.Build.MODEL)
-            val metrics = reactApplicationContext.resources.displayMetrics
-            info.putInt("screenWidth", metrics.widthPixels)
-            info.putInt("screenHeight", metrics.heightPixels)
-            info.putString("locale", java.util.Locale.getDefault().toLanguageTag())
-            info.putString("timezone", java.util.TimeZone.getDefault().id)
-            info.putString("osVersion", android.os.Build.VERSION.RELEASE)
+            deviceInfo.deviceModel?.let { info.putString("deviceModel", it) }
+            deviceInfo.screenWidth?.let { info.putInt("screenWidth", it) }
+            deviceInfo.screenHeight?.let { info.putInt("screenHeight", it) }
+            deviceInfo.locale?.let { info.putString("locale", it) }
+            deviceInfo.timezone?.let { info.putString("timezone", it) }
+            deviceInfo.osVersion?.let { info.putString("osVersion", it) }
+            deviceInfo.appVersion?.let { info.putString("appVersion", it) }
+            deviceInfo.gaid?.let { info.putString("gaid", it) }
             promise.resolve(info)
-        } catch (e: Exception) {
-            promise.reject("DEVICE_INFO_ERROR", e.message, e)
         }
     }
 
@@ -177,6 +268,11 @@ class AppSprintBridgeModule(reactContext: ReactApplicationContext) : ReactContex
 
     @ReactMethod
     fun requestTrackingAuthorization(promise: Promise) {
-        promise.resolve(false) // iOS only
+        promise.resolve(AppSprintNative(reactApplicationContext).requestTrackingAuthorization())
+    }
+
+    override fun invalidate() {
+        bridgeExecutor.shutdown()
+        super.invalidate()
     }
 }

package/appsprint-react-native.podspec

@@ -1,6 +1,11 @@
 require "json"
 
 package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+repository = package["repository"]
+repository_url = repository.is_a?(Hash) ? repository["url"] : repository
+repository_url = repository_url&.sub(/^git\+/, "")
+
+raise "package.json repository.url must be set" if repository_url.nil? || repository_url.empty?
 
 Pod::Spec.new do |s|
   s.name         = "appsprint-react-native"
@@ -11,7 +16,7 @@ Pod::Spec.new do |s|
   s.authors      = package["author"]
 
   s.platforms    = { :ios => "14.0" }
-  s.source       = { :git => package["repository"], :tag => "#{s.version}" }
+  s.source       = { :git => repository_url, :tag => "v#{s.version}" }
 
   s.source_files = "ios/AppSprintBridge.{swift,m}"
   s.swift_version = "5.0"

package/ios/AppSprintBridge.m

@@ -28,6 +28,9 @@ RCT_EXTERN_METHOD(setCustomerUserId:(NSString *)userId
                   resolve:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 
+RCT_EXTERN_METHOD(refreshAttribution:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
 RCT_EXTERN_METHOD(enableAppleAdsAttribution:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 
@@ -37,6 +40,9 @@ RCT_EXTERN_METHOD(getAppSprintId:(RCTPromiseResolveBlock)resolve
 RCT_EXTERN_METHOD(getAttribution:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 
+RCT_EXTERN_METHOD(getAttributionParams:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
 RCT_EXTERN_METHOD(isInitialized:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)